API Documentation

Send to Customer with GLN Number

Why do Customers use GLN numbers ?

Certain organisations have specific reasons:

  • multiple independant structures with the same VAT or company number
  • special routing requirements

General info : https://www.billit.eu/en-int/help-page/income/invoices/what-is-a-gln-number/

How to send to a GLN receiver from the API

In the segment "Identifiers" the Identfier type GLN is used:

{
 "OrderType": "Invoice",
 "OrderDirection": "Income",
 "OrderNumber": "QS-001",
 "OrderDate": "2025-09-01",
 "ExpiryDate": "2025-10-30",
  "Customer": {
   "Name": "Billit",
   "VATNumber": "BE0563846944",
   "PartyType": "Customer",
   "Identifiers": [
        {
        "IdentifierType": "GLN",  //Additional Identifier GLN
        "Identifier": "5430003732007"
        }
    ],
   "Addresses": [
        {
        "AddressType": "InvoiceAddress",
        "Name": "Billit",
        "Street": "Oktrooiplein",
        "StreetNumber": "1",
        "City": "Ghent",
        "Zipcode" : "9001",
        "Box": "box1",  
      	"Email" : "[email protected]",  
        "Language" : "NL",  
        "CountryCode": "BE"
        }
   ]
   },
 "OrderLines": [
  {
   "Quantity": 1,
   "UnitPriceExcl": 10.0,
   "Description": "Box of cookies", 
   "DescriptionExtended": "Box of cookies 20 pieces, 200 g", 
   "Reference": "915025",
   "VATPercentage": 6
   }
 ]
}

As a result of this POST, the customer info in Billit will be updated with this GLN information. You can check this in the MyBillit user interface:

In case of Open/Peppol, what customer endpoint ID will be used:

  • if the customer is only registered on the network Peppol with the GLN number: the GLN number will be used
  • If the customer is registered with GLN + other identifiers such as VAT or company number : Billit will automatically select an identifier, typically first company number and if not available then VAT number.
    • If you want to force the use of GLN number : this can be done via the MyBillit User Interface, see screenshot below: