Intro

These endpoints allow third party developers to create invoices in Exact Online and test the connectivity. All requests (except the documentation) are verified with a bearer token and originator IP address. Set the Accept header to 'application/json'. Access can be requested using info@webparking.nl

GET /item

Fetch list of available items with their codes.

Request

(empty)

Response

Json array of items with their 'code' (required to create invoice lines):

200:

{
    "data": [
        {
            "code": "FOO_BAR_100",
            "description": "Foo Bar 100",
            "price": 24.5
        },
        ...
}

POST /invoice

Create a new invoice and get the status + UUID in return. For production provide 'dry_run' as 'false'.

Request

Field	Type	Value	Required
dry_run	String	false, true (default)	no
account_name	String	Invoiced organisation name	yes
account_address	String	Customer address	yes
account_postal_code	String	Customer postal code	yes
account_city	String	Customer city	yes
invoice_reference	String	Invoice reference ("Webshop order 100" for example)	yes
account_phone	String	Phone number	no
account_website	String	Website (if provided valid URL required)	no
lines	Array	-	yes
lines.*.code	String	Item code (see /item) for valid codes	yes
lines.*.quantity	Integer	Ordered quantity	yes
lines.*.description	String	Description of ordered item	yes

Response

403 with error message(s):

{
    "message": "The given data was invalid.",
    "errors": {
        "account_city": [
            "The account city field is required."
        ]
    }
}

200 (dry-run debug results):

{
    "dry_run": true,
    "data": {
        "account_name": "Testbedrijf BV",
        "account_phone": "0104772678",
        "account_address": "Cypresbaan 31a",
        "account_city": "Capelle aan den IJssel",
        "account_postal_code": "2908 LT",
        "lines": [
            {
                "code": "FOO_BAR_100",
                "quantity": "2"
            }
        ],
        "invoice_reference": "Test order 20001-001"
    }
}

200:

{
    "data": {
        "guid": "b7e3a7af-f094-483d-8ef8-9d87044381f1"
    }
}