Extra Fields : Delivery Location

Including Delivery Location in the Customer Segment

The most simple solution is that delivery information is just put in the Customer Segment.

Below an example with the data that can be used for delivery location.

{
  "Customer": {
   "Name": "Billit",
   "VATNumber": "BE0563846944",
   "PartyType": "Customer",
   "Email" : "[email protected]",  
   "Language" : "NL",  
   "Identifiers": [
        {
        "IdentifierType": "GLN",  
        "Identifier": "5430003732007"
        }
    ],
   "Addresses": [
        {
        "AddressType": "InvoiceAddress",
        "Name": "Billit",
        "Street": "Oktrooiplein",
        "StreetNumber": "1",
        "City": "Ghent",
        "Zipcode" : "9001",
        "Box": "box1",  // Postal box in the building"
        "CountryCode": "BE"
        },
        {
        "AddressType": "DeliveryAddress", //The delivery address, if not provided will be automatically the same as invoice address
        "Name": "Billit",
        "Street": "Oktrooiplein",
        "StreetNumber": "1",
        "City": "Ghent",
				"Zipcode": "9001",
        "Box": "301",
        "CountryCode": "BE"
        }
   ]
   }

Including Delivery Location via Seperate Fields

Use of these specific fields:

More Advanced Delivery Information

Set a delivery location ID. This can be useful to give an specific numberic value known by the customer. In addition it can be a standardised value (GLN number for delivery location)
Set the Name of the delivery location and the address details, result :
- It will appear in a correct way in the output file (typically UBL)
- It will not appear on MyBillit Screen or on Billit Human Readable and in the customer info

Do not link with delivery information in customer data of Billit
1. When Posting invoice, the customer data in Billit will not be updated (keep customer data unchanged)
2. Avoid that when posting multiple invoices at the same time for the same customer, that delivery data are mixed.

Data structure:

Key (Header)	Linked Info When Peppol	Extra Information
Invoice.Delivery.DeliveryLocation.ID.Text	Link	A number or reference for the delivery location
Invoice.Delivery.DeliveryLocation.ID.SchemeID	Link	A structured value, for GLN number this is 0088
Invoice.Delivery.DeliveryLocation.PostalAddress.StreetName	Link	Street delivery location
Invoice.Delivery.DeliveryLocation.Address. AdditionalStreetName	Link	Second streed field
Invoice.Delivery.DeliveryLocation.Address.CityName	Link	Delivery City
Invoice.Delivery.DeliveryLocation.Address.PostalZone	Link	Delivery Zip
Invoice.Delivery.DeliveryLocation.Address.CountrySubentity	Link	Delivery country sub entity (e.g. province)
Invoice.Delivery.DeliveryLocation.Address.Country. IdentificationCode.Text	Link	Delivery Country code (e.g. BE, FR, NL. Remark : when using this section, country is mandatory !

Exemples with only Delivery location identification. The other delivery data can be put in the Customer Segment. Two scenario's : one with GLN number, one without.

"CustomFields"  : {
    "Invoice.Delivery.DeliveryLocation.ID.Text": "5430009861001", //(GLN number)
    "Invoice.Delivery.DeliveryLocation.ID.SchemeID": "0088" //0088 refers to GLN
    },

"CustomFields"  : {
    "Invoice.Delivery.DeliveryLocation.ID.Text": "96587452", //This is a specific delivery location number, not according to a standard such as GLN)
    },

Example with full delivery address:

 "CustomFields"  : {
    "Invoice.Delivery.DeliveryLocation.ID.Text": "543000985477", //Delivery Location Number (GLN number)
    "Invoice.Delivery.DeliveryLocation.ID.SchemeID": "0088", //0088 is referring to scheme ID of type GLN
    "Invoice.Delivery.DeliveryLocation.Address.Country.IdentificationCode.Text": "BE",
    "Invoice.Delivery.DeliveryLocation.Address.PostalZone": "9000",
    "Invoice.Delivery.DeliveryLocation.Address.StreetName": "Octrooiplein 1b",
    "Invoice.Delivery.DeliveryLocation.Address.AdditionalStreetName": "Extra info street",
    "Invoice.Delivery.DeliveryLocation.Address.CityName": "Gent",
    "Invoice.Delivery.DeliveryLocation.Address.CountrySubentity": "Oost-Vlaanderen",
    "Invoice.Delivery.DeliveryParty.PartyName.Name": "Billit Reception of Goods Gent"
    },