Set / Select Customer Identifier

General Information about Identifiers in France

information on : https://docs.billit.be/docs/identifiers-france-pa

Info and scenario's

Typical regular scenario for customer would be:

1 VAT number (For tax registration informatoin)
1 Siren Number (should be included, if not present, Billit will derive from VAT)
1 Siret Number (optional, especially when customer has multiple Siret numbers in annuaire)
- 1 Siret Number as an invoicing address
- (other Siret number serving as other location types such as delivery location are not relevant)
1 CTC number.
- CTC can have a specific structure per customer, this is leading.
- A customer can have multiple CTC numbers :
  - in that case you should specify which one to use.
  - check with the customer or check on the Purchase Order.

As Peppol Routing is concerned, below recommended behaviour

It is recommended that you include the correct CTC in your invoice content.
- Billit will use that CTC, if the CTC is in the annuaire and on Peppol
- When there exist multiple CTC's, specify the correct one for that invoice. Billit will use that one (if in annuare on Peppol)
- Mention only one CTC in identifiers per invoice, not multiplee
If you are not sure about the right CTC: (should be avoided)
- do not include a preference
- you can not include a CTC
- Billit will check the annuaire :
  - if only one CTC is published, this CTC will be used by Billit
  - if multiple CTC's exist for the Siren : Billit will return an error (see below)
Include identifier with "Preferred" : true
- This can be added,
- For Peppol routing B2B France Billit will have to use CTC anyhow
- So impact for France is limited

How to include your Customer Identifiers in API Content

Identifiers you should include:

If the company has a VAT number, it should always be included (not for Annuaire, but for tax compliance reasons).
If the customer has registered with a specific identifier, you should include this identifier(s).

Below examples in Json API when posting an invoice, for the customer segment. The last option is the best one.

    "Customer": {
        "Nr": "000700999",
        "Name": "BAUDIN TEST CHATEAUNEUF",
        "VATNumber": "FR25842499999", 
	"PartyType": "Customer",


        "Addresses": [
            {
                "AddressType": "InvoiceAddress",
                "Name": "BAUDIN TEST CHATEAUNEUF",
                "Street": "Rue de la Brosse 999",
                "Zipcode": "45110",
                "City": "CHATEAUNEUF SUR LOIRE",
                "CountryCode": "FR"
            }
        ],
  		 "Identifiers": [
        {
        "IdentifierType": "SIRET", 
        "Identifier": "84249114400999"
        }
]
}

    "Customer": {
        "Nr": "000700999",
        "Name": "BAUDIN TEST CHATEAUNEUF",
        "VATNumber": "FR25842499999", 
	"PartyType": "Customer",


        "Addresses": [
            {
                "AddressType": "InvoiceAddress",
                "Name": "BAUDIN TEST CHATEAUNEUF",
                "Street": "Rue de la Brosse 999",
                "Zipcode": "45110",
                "City": "CHATEAUNEUF SUR LOIRE",
                "CountryCode": "FR"
            }
        ],
  		 "Identifiers": [
        {
        "IdentifierType": "SIREN", 
        "Identifier": "842491144"
    }
]
}

    "Customer": {
        "Nr": "000700999",
        "Name": "BAUDIN TEST CHATEAUNEUF",
        "VATNumber": "FR25842499999", 
	"PartyType": "Customer",


        "Addresses": [
            {
                "AddressType": "InvoiceAddress",
                "Name": "BAUDIN TEST CHATEAUNEUF",
                "Street": "Rue de la Brosse 999",
                "Zipcode": "45110",
                "City": "CHATEAUNEUF SUR LOIRE",
                "CountryCode": "FR"
            }
        ],
  		 "Identifiers": [
        {
        "IdentifierType": "SIREN", 
        "Identifier": "842491144"
        },
				{
        "IdentifierType": "CTC",
        "Identifier": "842491144_12345"
        }
			]

	}

    "Customer": {
        "Nr": "000700999",
        "Name": "BAUDIN TEST CHATEAUNEUF",
        "VATNumber": "FR25842499999", 
	"PartyType": "Customer",


        "Addresses": [
            {
                "AddressType": "InvoiceAddress",
                "Name": "BAUDIN TEST CHATEAUNEUF",
                "Street": "Rue de la Brosse 999",
                "Zipcode": "45110",
                "City": "CHATEAUNEUF SUR LOIRE",
                "CountryCode": "FR"
            }
        ],
  		 "Identifiers": [
        {
        "IdentifierType": "SIREN", 
        "Identifier": "842491144",
        "Preferred": false
        },
				{
        "IdentifierType": "CTC",
        "Identifier": "842491144_12345",   
	"Preferred": true
        }
 			]
	}

Specific Billit Error Messages

Error Description	Extra Info
No preferred CTC selected on the customer	No CTC is provided, or data delivered is not in Annuaire, so Billit cannot use it. Billit cannot select a CTC because there are multiple for that customer.
Ctc 0225:227019999 is not active in the French directory	The CTC 0225:227019999 is submitted via API, but is not found in French directory/annuaire
The customer is not active on Peppol	The selected customer (identifier and schemeid) cannot be found on Peppol