API Documentation

Retrieve invoice information

When an invoice has been created a unique ID is returned. With this ID you can use retrieve all information stored in Billit for this specific invoice. You will be able to retrieve the PDF, E-invoice delivery details, full tax calculations, Original sent E-invoice XML....

Good news! The response you will receive is the same object as you used to create the invoice. Meaning no additional objects need to be created!

📘

Testable request in Postman: 03 - Retrieve invoice data

EndpointMethodResponse
/v1/orders/{UniqueID}GETOrder Object

To test the testable request in Postman you will have to provide the request with the Unique ID returned when creating the invoice.

Because of the response containing allot of information you will have a brief summary below of the most important fields.

PropertyValue TypeInfo
OrderIDUniqueIDSame ID as in request
CompanyIDUniqueIDCompany Ownder ID of the invoice
OrderPDFObjectContains the PDF generated or provided for the invoice
AttachmentsListContains the Attachments for the invoice and will always contain the original JSON used to created the invoivce through API.
OrderNumberIDThe Unique invoice ID provided or generated
CustomerObjectContains metadata for the invoice customer
SupplierObjectContains metadata for the Supplier (Sales invoices== self)
LastModifiedDateTimeLast datetime when the invoice was modified
CreatedDatetimeThe date when the api processed the invoice
OrderlinesListContains the Invoice items in a list with tax calculated on them
VatGroupsListContains the different vatgroups calculated for the Invoice
PaidBoolIf the invoice was paid or a payments was received in Billit this will be set to true
IsSentBoolIf the invoice was sent Manually, API, or job it will be set to true
PaymentLinksObjectContains the EPC QR code for payments
CurrentDocumentDeliveryDetailsObjectContains the information of the delivery of the document
MessagesListContains all messages for incoming and outgoing traffic for the invoice

Example output below

{
    "OrderID": HIDDEN,
    "CompanyID": HIDDEN,
    "OrderPDF": {
        "FileID": "c1cd2bfa-XXXX-XXXX-XXXX-2f6d323bd2fc",
        "FileName": "Invoice_QS-001_Billit.pdf"
    },
    "Attachments": [
        {
            "FileID": "af3b583e-XXXX-XXXX-XXXX-2a7d8680a324",
            "FileName": "QS-001__10_03_2024 15_00_49.json"
        }
    ],
    "OrderNumber": "QS-001",
    "Customer": {
        "PartyID": HIDDEN,
        "Name": "Billit",
        "Addresses": [
            {
                "AddressType": "InvoiceAddress",
                "Name": "Billit",
                "Street": "Oktrooiplein",
                "StreetNumber": "1",
                "Box": "301",
                "City": "Ghent",
                "CountryCode": "BE"
            },
            {
                "AddressType": "DeliveryAddress",
                "Name": "Billit",
                "Street": "Oktrooiplein",
                "StreetNumber": "1",
                "Box": "301",
                "City": "Ghent",
                "CountryCode": "BE"
            }
        ],
        "Street": "Oktrooiplein",
        "StreetNumber": "1",
        "Box": "301",
        "City": "Ghent",
        "CountryCode": "BE",
        "Contact": "",
        "ContactLastName": "",
        "VATNumber": "BE0563846944",
        "LastModified": "2024-03-10T15:00:49.487",
        "Created": "2024-03-10T13:55:42.723",
        "PartyType": "Customer",
        "VATLiable": true,
        "Language": "EN",
        "VentilationCode": "4",
        "CustomFields": [],
        "BankAccounts": [],
        "DefaultPaid": false,
        "DisplayName": "Billit",
        "DefaultExpiryOffset": 30,
        "GLDefaultExpiryOffset": 30,
        "VATDeductable": true,
        "DefaultReductionPercentage": 0.00,
        "Identifiers": [
            {
                "IdentifierType": "GLN",
                "Identifier": "5430003732007",
                "SchemeID": "0088"
            }
        ],
        "SmallEnterprise": false,
        "DefaultCurrencyTC": "EUR"
    },
    "Supplier": {
        "PartyID": HIDDEN,
        "Name": "Billit Quickstart",
        "Addresses": [
            {
                "AddressType": "InvoiceAddress",
                "Name": "BILLIT",
                "Street": "Oktrooiplein",
                "StreetNumber": "1",
                "Box": "302",
                "Zipcode": "9000",
                "City": "Gent",
                "CountryCode": "BE"
            },
            {
                "AddressType": "DeliveryAddress",
                "Name": "BILLIT",
                "Street": "Oktrooiplein",
                "StreetNumber": "1",
                "Box": "302",
                "Zipcode": "9000",
                "City": "Gent",
                "CountryCode": "BE"
            }
        ],
        "Street": "Oktrooiplein",
        "StreetNumber": "1",
        "Box": "302",
        "Zipcode": "9000",
        "City": "Gent",
        "CountryCode": "BE",
        "IBAN": "HIDDEN",
        "BIC": "GKCCBEBB",
        "Phone": "HIDDEN",
        "Email": "[email protected]",
        "Contact": "Thibau Verberckmoes",
        "ContactFirstName": "Thibau",
        "ContactLastName": "Verberckmoes",
        "VATNumber": "BE0563846944",
        "LastModified": "2024-03-10T15:00:39.91",
        "Created": "2024-03-10T13:16:02.34",
        "PartyType": "Supplier",
        "VATLiable": true,
        "Language": "EN",
        "VentilationCode": "4",
        "CustomFields": [],
        "BankAccounts": [
            {
                "IBAN": "HIDDEN",
                "BIC": "GKCCBEBB",
                "Currency": "EUR",
                "Verified": false,
                "Saldo": 0.00
            }
        ],
        "DefaultPaid": false,
        "DisplayName": "Billit Quickstart",
        "FinancialReductionPercentageDefault": 2.00,
        "FinancialReductionDaysDefault": 8,
        "DefaultExpiryOffset": 30,
        "GLDefaultExpiryOffset": 30,
        "VATDeductable": true,
        "DefaultReductionPercentage": 0.00,
        "Identifiers": [],
        "SmallEnterprise": false,
        "DefaultCurrencyTC": "EUR"
    },
    "CounterParty": {
        "PartyID": HIDDEN,
        "Name": "Billit",
        "Addresses": [
            {
                "AddressType": "InvoiceAddress",
                "Name": "Billit",
                "Street": "Oktrooiplein",
                "StreetNumber": "1",
                "Box": "301",
                "City": "Ghent",
                "CountryCode": "BE"
            },
            {
                "AddressType": "DeliveryAddress",
                "Name": "Billit",
                "Street": "Oktrooiplein",
                "StreetNumber": "1",
                "Box": "301",
                "City": "Ghent",
                "CountryCode": "BE"
            }
        ],
        "Street": "Oktrooiplein",
        "StreetNumber": "1",
        "Box": "301",
        "City": "Ghent",
        "CountryCode": "BE",
        "Contact": "",
        "ContactLastName": "",
        "VATNumber": "HIDDEN",
        "LastModified": "2024-03-10T15:00:49.487",
        "Created": "2024-03-10T13:55:42.723",
        "VATLiable": true,
        "Language": "EN",
        "VentilationCode": "4",
        "CustomFields": [],
        "BankAccounts": [],
        "DefaultPaid": false,
        "DisplayName": "Billit",
        "DefaultExpiryOffset": 30,
        "GLDefaultExpiryOffset": 30,
        "VATDeductable": true,
        "DefaultReductionPercentage": 0.00,
        "Identifiers": [
            {
                "IdentifierType": "GLN",
                "Identifier": "5430003732007",
                "SchemeID": "0088"
            }
        ],
        "SmallEnterprise": false,
        "DefaultCurrencyTC": "EUR"
    },
    "OrderDate": "2024-01-01T00:00:00",
    "ExpiryDate": "2024-01-31T00:00:00",
    "OrderType": "Invoice",
    "LastModified": "2024-03-10T15:00:49.72",
    "Created": "2024-03-10T15:00:49.533",
    "OrderDirection": "Income",
    "OrderLines": [
        {
            "Quantity": 1.00000,
            "UnitPriceExcl": 10.00000,
            "Description": "Box of cookies",
            "TotalExcl": 10.00,
            "TotalVAT": 0.60,
            "VATPercentage": 6.00,
            "VentilationCode": "2",
            "CustomFields": {},
            "InclLeading": false,
            "TotalIncl": 10.60
        },
        {
            "Quantity": 2.00000,
            "UnitPriceExcl": 3.75000,
            "Description": "Sticks",
            "TotalExcl": 7.50,
            "TotalVAT": 1.58,
            "VATPercentage": 21.00,
            "VentilationCode": "4",
            "CustomFields": {},
            "InclLeading": false,
            "TotalIncl": 9.08
        }
    ],
    "PaymentDiscountPercentage": 0.00,
    "PaymentDiscountAmount": 0.00,
    "VatGroups": [
        {
            "VentilationCode": "2",
            "VATPercentage": 6.00,
            "TotalExcl": 10.00,
            "TotalVAT": 0.60,
            "TotalIncl": 10.60,
            "Mtvh": 10.00,
            "FinancialReductionAmount": 0.00
        },
        {
            "VentilationCode": "4",
            "VATPercentage": 21.00,
            "TotalExcl": 7.50,
            "TotalVAT": 1.58,
            "TotalIncl": 9.08,
            "Mtvh": 7.50,
            "FinancialReductionAmount": 0.00
        }
    ],
    "VentilationCode": "4",
    "TotalExcl": 17.50,
    "TotalIncl": 19.68,
    "TotalVAT": 2.18,
    "Tags": [],
    "PaymentReference": "+++001/1800/63503+++",
    "Paid": false,
    "ExternalProvider": "APIFeed",
    "ExternalProviderReferences": [],
    "Currency": "EUR",
    "IsSent": false,
    "Invoiced": false,
    "CustomFields": {},
    "RemindersSent": 0,
    "ToPay": 19.68,
    "OrderStatus": "ToSend",
    "Overdue": true,
    "DaysOverdue": 39,
    "FXRateToForeign": 1.00000,
    "DeliveryDate": "2024-01-01T00:00:00",
    "PaymentLinks": [
        {
            "ClickUrl": "",
            "QRImageUrl": "HIDDEN"
        }
    ],
    "AccountantVerificationNeeded": false,
    "CurrentDocumentDeliveryDetails": {
        "IsDocumentDelivered": false
    },
    "Messages": []
}