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 API Json body, 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:

A Customer has 1 VAT-number and Multiple GLN-numbers

In this case the customer is using the same VAT and/or company number for all the registered GLN-numbers.

Actions:

Create the customers manually in My Billit
Each customer will have the the same VAT but a different GLN
Check in the Customer E-invoicing tab that the GLN-number is set as the preferred method
Find the partyID of each customer
Include the partyID in your API Body

How to get the PartyID of the customer:

The Json body must include the PartyID of the Customer:

{
 "OrderType": "Invoice",
 "OrderDirection": "Income",
 "OrderNumber": "QS-XGLNVK003",  
 "OrderDate": "2025-10-08",
  "Reference": "4573er6780", 
 "ExpiryDate": "2025-10-30",
  "Customer": {
   "Name": "AZ Voorkempen",
   "VATNumber": "BE0411515075",
   "PartyType": "Customer", 
    "PartyID": 822753,  // PartyID must be included in order to select the correct customer
    "Nr": "28",
   "Identifiers": [ 
                {
        "IdentifierType": "GLN",  // GLN must be included as identifier
        "Identifier": "5430001361018"
        }
    ],
   "Addresses": [
        {
        "AddressType": "InvoiceAddress",
        "Name": "AZ Voorkempen",
        "Street": "Oude Liersebaan",
        "StreetNumber": "4",
        "Zipcode": "2930",
        "City": "Ghent",
        "Box": "",
        "CountryCode": "BE"
        }
   ]
   },
 "OrderLines": [ 
  {
   "Quantity": 1.02, 
   "UnitPriceExcl": 10.03, 
   "Reference": "915025", 
   "Description": "Box of cookies",  
   "VATPercentage": 6.0
   },
    {
   "Quantity": 2,
   "UnitPriceExcl": 3.75,
   "Description": "Sticks",
   "VATPercentage": 21.0
   }
 ]
}

A Customer has 1 VAT-number 1 or more GLN-numbers, per invoice the selection is different

When a customer wants to receive certain invoices with GLN number, and other invoices with VAT number, then the solution is:

Create 2 customers manually in Billit.
- One has in the E-invoicing tab the VAT-number as preferred method, the other has GLN-number as preferred method
- Get the PartyID of each customer
When Posting your Invoice:
- Include the correct PartyID:
  - The preference of that PartyID will be used
  - How to include the PartyID in Json body : see example in "A Customer has 1 VAT-number and Multiple GLN-numbers"