Identifiers DE

Customer Identifiers

Per customer, in the Json API content, the idenfier(s) can be defined:

Identifier	Accepted identifier	Use	Content in API Json	Identifier number
VAT-number	yes	Most common	field "VATNumber"	9930
Steuer number	no	Local German tax number. Not a Peppol identifier. For international trade in EU, VAT number is needed	Identifier section, IdentifierType "SteuerNr"	'-
GLN-number	yes	If specified by the customer	Identifier section, IdentifierType "GLN"	0088
GEBA-number	yes	New number for company, used on Peppol. Not used a lot for the moment, expected to become more important in the future.	Identifier section, IdentifierType "GEBA"	0246
LEITWEG ID	yes	When government organisation. Not linked to another number, so you get the number first.	Identifier section, IdentifierType "LEITWEGID"	0204

API Examples with customer identifier

Customer section in Json API:

 "Customer": {
   "Name": "Caompany name",
   "VATNumber": "DE321281999",  
   "Nr": "001261",  //customer number in ERP 
   "PartyType": "Customer",
   "Email": "[email protected]",  //Where to send email to
   "VATNumber": "",  //No VAT number available
   "Language": "DE",  //Determines language of the email
   "PartyType": "Customer",// fixed value for sales invoices	
   "VATLiable": true,  //when customer has VAT number
   "Addresses": [
        {
        "AddressType": "InvoiceAddress",
        "Name": "Customer Name",
        "Street": "Landstraße ",
        "StreetNumber": "99",
        "City": "Frankfurt am Main",
        "Zipcode": "60306 ",
        "CountryCode": "DE"
        }
        {
        "AddressType": "DeliveryAddress", //The delivery address, if not provided will be automatically the same as invoice address
        "Name": "Customer Name",
        "Street": "Landstraße",
        "StreetNumber": "98",
        "City": "Ghent",
	"Zipcode": "60306 ",
        "CountryCode": "DE"
        }
        ],    
      }

 "Customer": {
   "Name": "Gemeinde XYZ",
   //"VATNumber": "",  // no VAT number available
   "Nr": "001260",  //customer number in ERP 
   "PartyType": "Customer",
   "Email": "[email protected]",  //Where to send email to
   "VATNumber": "",  //No VAT number available
   "Language": "DE",  //Determines language of the email
   "PartyType": "Customer",// fixed value for sales invoices	
   "VATLiable": false,  //when customer has VAT number
   "Identifiers": [
        {
        "IdentifierType": "LEITWEGID",
        "Identifier": "13074099-k000-99"
        }
    ], 
	"Addresses": [
        {
        "AddressType": "InvoiceAddress",
        "Name": "Customer Name",
        "Street": "Landstraße ",
        "StreetNumber": "99",
        "City": "Frankfurt am Main",
        "CountryCode": "DE"
        }
        ],    
      }

Supplier Identifier

When you are a commercial company, adding the VAT-number in MyBillit / My Company is enough as identifier.