Set / Select Customer Identifier

Customer Data when sending Sales Invoices in France

Info and scenario's

Typical regular scenario for customer would be:

  • 1 VAT number (For tax registration information)
  • 1 Siren Number
    • should be included,
    • if not present, Billit will generate it derived from VAT
      • Billit will check that that Siren has a valid structure
      • Billit will display the Siren in user interface in the customer section in the tab E-invoicing (virtual data), not in the tab company
  • 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 is needed for routing for each invoice:
    • Possible scenario's:
      • Customer has 1 Siren and 1 CTC (simple)
      • Customer has 1 Siren and multiple CTC
      • no valid CTC in annuaire and/or on Peppol
    • When a customer has 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 verify the correct CTC, as a customer with valid Siren can have multiple CTC's.
    • Each CTC at the customer level has a specific purpose. Sending to the wrong CTC may result in corrective actions afterwords.
  • 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 annuaire on Peppol)
    • Mention only one CTC in identifiers per invoice, not multiple
      Billit can derive the CTC based on following scenario:
    • do not include a preference or CTC in identifiers
    • Billit will check the annuaire : if only one CTC is published, this CTC will be used by Billit
    • Billit will then check the CTC as Peppol receiving capability
    • If one CTC present on annuaire and Peppol :
      • Billit will display the CTC on user interface (in the Customer section in the tab E-invoicing as virtual data, not in the tab Company)
      • Billit will be able to send
    • if multiple CTC's exist for the Siren : Billit will return an error (see below)
  • Billit will not send:
    • CTC derived by Billit from VAT or delivered by sender is not in annuaire or not on Peppol
    • no CTC delivered by sender, and multiple valid CTC numbers exist : Billit cannot choose
  • 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

More info and tools

General Information about Identifiers in France : https://docs.billit.be/docs/identifiers-france-pa

Get information about the Peppol registrations : https://docs.billit.be/docs/how-to-find-a-receiver-in-france

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": "FR25842491144", 
	"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 DescriptionExtra Info
No preferred CTC selected on the customerNo 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 directoryThe CTC 0225:227019999 is submitted via API, but is not found in French directory/annuaire
The customer is not active on PeppolThe selected customer (identifier and schemeid) cannot be found on Peppol



Did this page help you?