API Documentation

Identifiers

How customers and suppliers are identified

What is the goal of Identifiers

Parties such as the suppliers and customers can de defined with one or more identifiers, such as VAT number, national company numbers. Depending on the country and the receiver one or more identifiers can be needed. When you fill the VAT-number tag, this identifier used directly by Billit in a correct way in the target network such as Peppol and others. Mentioning other identifiers can be useful or required.

Most identifiers have a country specific definition. A few identifiers such as GLN can be used in multiple countries.

Billit transforms the values you delivered into correct identifiers in the target network.


List of Identifiers

Below the overview for Sales Invoices:

IdentifierTypeCountry CodeEinvoice NetworkNetworkCodeExtra Info
VATADPeppol9922
VATAE
VATALPeppol9923
VATATPeppol9914
VATBAPeppol9924
VATBEPeppol9925VAT Belgium
CBEBEPeppol0208National Company Number Belgium
VATBGPeppol9926
CNPJBR
VATCHPeppol9927
VATCN
VATCV
VATCYPeppol9928
VATCZPeppol9929
LEITWEGIDDEPeppol0204Identification for German Government Organisations
VATDEPeppol9930
VATDK
ERSTDKPeppol0198ERSTORG : Danish companies based on VAT number
DIGSTDKPeppol0184DIGSTORG Danish Party identification
CVRDKPeppol9902Danish Chamber of Commerce Number
VATEEPeppol9931
VATELPeppol9933
VATESPeppol9920
NIEESInfo will be added soon
DNIESInfo will be added soon
NIFESInfo will be added soon
CIFESInfo will be added soon
VATFIPeppol0213
NOVTFIPeppol0216Finland OVT-code
SIRETFRChorus/Peppol/PDP0009Siret number + branch number
SIRENEFRChorus/Peppol/PDP0002Unique Company number without branch
Service CodeFRChorus
VATFRPeppol9957
FRCTCFRPeppol0225Elektronic address part of Continuous Transaction Control (CTC)
VATGBPeppol9932
GLNGlobalPeppol0088GLN number of GS/1, used in many countries.
DUNSGlobalPeppol0060
LEIGlobalPeppol0199
VATGlobal
VATGRPeppol9933
VATHRPeppol9934Croatia
OIBHRPeppol9934Croatia : the Personal Identification Number of a company is based on the VAT number
VATHUPeppol9910
VATID
VATIEPeppol9935
VATIL
SDICODDESTITSDIIT:CODDESTCode for Routing
SDICODFISITSDI0210Codice Fiscale for companies and people
SDIPECITSDIIT:PECcertified email address when not registered via SDICODEDEST
SDIB2GITSDIIT:CODDESTspecific identifier for Italian government organisations
VATITPeppol9906
VATJPPeppol0221
SSTJPPeppol0188Corporate Number of The Social Security and Tax Number System in JapanLI
VATKR
VATLIPeppol9936Liechtenstein
VATLTPeppol9937
LECLTPeppol0200Legal entity code (Lithuania)
VATLUPeppol9938
RPMLUPeppol9938"Registre de Commerce et des Sociétés" (RCS) – Section: RPM
VATLVPeppol9939
VATMA
VATMCPeppol9940
VATMEPeppol9941
VATMKPeppol9942
VATMTPeppol9943
TINMXSATTax Identification Number in Mexico
EIFMYPeppol0230
KvKNLPeppol0230Kamer van Koophandel number
OINNLPeppol0190Organisation Information Number used for government organisations
VATNLPeppol9944
VATNOPeppol0192
ORGNOPeppol0192Norwegian Organisation Number
VATNZPeppol0088New Zealand Business number is GLN based
ABNNZPeppol0151Australian Business Number is also used in New Zeeland
VATPLPeppol9945
VATPTPeppol9946
VATROPeppol9947
VATRSPeppol9948
MBRRS
VATSEPeppol9955
ORGNRSEPeppol0007Swedish "Organisationsnummer"
VATSGPeppol0195
VATSIPeppol9949
VATSKPeppol9950
VATSMPeppol9951San Marino
SDICODDESTSMSDISan Marino
SDICODFISSMSDISan Marino
SDIPECSMSDISan Marino
SDIB2GSMSDISan Marino
VATTRPeppol9952
EINUSPeppol9959Employer Identification Number
VATVAPeppol

Peppol overview of the used codelists : Peppol SchemeID's.

Examples via API

Below examples how to add additional customer identifiers via the API in the customer segment:

   "Identifiers": [
        {
        "IdentifierType": "GLN",
        "Identifier": "5430003732007"
        }
    ],
"Identifiers": [
        {
        "IdentifierType": "LEI", //Additional Identifier for Poland
        "Identifier": "0123456799"
        },

    ],
"Identifiers": [
    {
      "IdentifierType": "SDIPEC",
      "Identifier": "[email protected]"
    }
  ]
"Identifiers": [
  { "IdentifierType": "SDICODFIS", "Identifier": "" },
  { "IdentifierType": "SDICODDEST", "Identifier": "3PRL4IK" },
  { "IdentifierType": "SDIPEC", "Identifier": "[email protected]" }
]
   "Identifiers": [
        {
        "IdentifierType": "SIRET", //Mandatory Identifier for Chorus
        "Identifier": "84249114400015"
        },

    ],