Expenses


expense.get

Requests the details of one or more expenses. When no filter is set, 10 expenses will be delivered. A LIMIT up to 100 expenses is possible. The RESPONSE contains a "list of expenses" and each of them with the following fields.


FILTER
TagsDescription
INVOICE_ID Invoice ID
INVOICE_NUMBER Invoice number
MONTH Deprecated Month
YEAR Deprecated Year
START_PAID_DATE Invoices with a payment from a specific date
END_PAID_DATE Invoices with a payment up to a specific date
START_DATE Invoices from a specific date
END_DATE Invoices until a specific date

RESPONSE
TagsDescription
INVOICE_ID Invoice ID
ORGANIZATION Company name
INVOICE_NUMBER Invoice number
INVOICE_DATE Invoice date
SERVICE_PERIOD_START NEW since 30.06.2020: Startdate of deliveryperiod
SERVICE_PERIOD_END NEW since 30.06.2020: Enddate of deliveryperiod
DUE_DATE Due date
PROJECT_ID A specific project ID
CUSTOMER_ID A specific customer ID
SUB_TOTAL Net amount
VAT_TOTAL Input VAT amount
TOTAL Total
NOTE Note
COMMENT Comment
VAT_ITEMS List of all articles for one entity
ITEMS List of items
PAID_DATE Date of received payment
CURRENCY_CODE Currency code
COMMENT Comment
CATEGORY Category
PAYMENT_INFO Information on payment
DOCUMENT_URL URL of a document

expense.create

Creation of a cost entry. A voucher can be attached optionally.

ATTENTION! - This action requires a POST-request of the type "multipart/form-data", if no data attachment is to be delivered. In this case the request body must contain the following parts:
  • document -> file, that is to be transfered
  • httpbody< -> XML- or JSON data block

Structure of POST-request in multipart format:

curl -v -X POST \
-u {e-mail address}:{API-Key} \
-H 'Content-Type: multipart/form-data, boundary=AaB03x' \
-d '{xml body}' \ https://my.fastbill.com/api/1.0/api.php

POST /api/1.0/api.php HTTP/1.0
Host: my.fastbill.com
Content-type: multipart/form-data, boundary=AaB03x
Content-Length: {size of content}

--AaB03x content-disposition: form-data; name="httpbody"
{XML- oder JSON-Daten}
--AaB03x
content-disposition: form-data; name="document"; filename{filename}"
Content-Type: {MIME Typ}
Content-Transfer-Encoding: binary
{file content}
--AaB03x--

DATA
TagsDescription
INVOICE_DATE Required Invoice date
SERVICE_PERIOD_START NEW since 30.06.2020: Startdate of deliveryperiod
SERVICE_PERIOD_END NEW since 30.06.2020: Enddate of deliveryperiod
DUE_DATE Due date
PROJECT_ID A specific project ID
CUSTOMER_ID A specific customer ID
ORGANIZATION Required Company name
INVOICE_NUMBER Invoice number
COMMENT Comment
SUB_TOTAL Required Net amount
VAT_TOTAL Input VAT amount
ITEMS List of items

RESPONSE
TagsDescription
STATUS Result of the action
INVOICE_ID Invoice ID
support@fastbill.com
© 2021 FastBill GmbH