Service Provider Party

When do you need this?

Some platforms issue invoices on behalf of their sellers, under a billing mandate (French use case 19a).
French buyers can then require two extra things on the invoice:
the invoicing third party (the party that issued the invoice, French "Facturant"), and the DCL note: "Facture établie par A au nom et pour le compte de B".
You send the invoicing third party through custom fields on the invoice. Billit adds the DCL note automatically.

Custom fields for Service Provider Party

Field	Required	Key (after the prefix above)	Rules
Name	Yes	.Party.PartyName.Name	Without a name, the invoicing third party is not sent.
Role code	no	.ServiceTypeCode	A code from UNCL 3035, for example II (issuer of the invoice).
Additional identifier	No	.Party.PartyIdentification.ID.Text
Scheme of that identifier	No	.Party.PartyIdentification.ID.SchemeID	ID.SchemeID For example 0002 for a SIREN.
SIREN	No	.Party.PartyLegalEntity.CompanyID.Text	Exactly 9 digits. Billit always adds scheme 0002.
Registration name	No	.Party.PartyLegalEntity.RegistrationName	Default: the name.
VAT Number	No	.Party.PartyTaxScheme.CompanyID.Text	Billit adds the tax scheme VAT.
Street	No	.Party.PostalAddress.StreetName
City	No	.Party.PostalAddress.CityName
Postal code	No	.Party.PostalAddress.PostalZone
Country	No	.Party.PostalAddress.Country.IdentificationCode.Text	ISO country code, for example FR.

An invalid role code or SIREN stops the invoice from being sent, with an error that names the field.

Behaviour per Profile Type and per Country / Subject Code

The invoicing third party only exists in the French extended profile (CustomizationID urn:cen.eu:en16931:2017#conformant#urn.cpro.gouv.fr:1p0:extended-ctc-fr).
When the receiver supports the extended profile, Billit sends it with:
cac:ServiceProviderParty in the seller party (UBL), or ram:InvoicerTradeParty (CII), and
the note #DCL#Facture établie par au nom et pour le compte de
When the receiver only supports the base French profile (FR CIUS), the invoice goes out without the invoicing third party and without the DCL note.
On non-French document types (for example Peppol BIS v3), the custom fields are ignored.
Do you want your own DCL wording? Use the custom field SubjectNoteDCL

Example

"CustomFields": {
"Invoice.AccountingSupplierParty.Party.ServiceProviderParty.ServiceTypeCode": "II",
"Invoice.AccountingSupplierParty.Party.ServiceProviderParty.Party.PartyName.Name": "Example Platform SAS",
"Invoice.AccountingSupplierParty.Party.ServiceProviderParty.Party.PartyLegalEntity.CompanyID.Text": "987654321",
"Invoice.AccountingSupplierParty.Party.ServiceProviderParty.Party.PartyTaxScheme.CompanyID.Text": "FR98987654321",
 "Invoice.AccountingSupplierParty.Party.ServiceProviderParty.Party.PostalAddress.CityName": "Lyon",
"Invoice.AccountingSupplierParty.Party.ServiceProviderParty.Party.PostalAddress.Country.IdentificationCode.Text": "FR"
"SubjectNoteDCL": "Facture établie par <name> au nom et pour le compte de <seller name> + extra info" //Custom Subject Code
}

"CustomFields": {
"Invoice.AccountingSupplierParty.Party.ServiceProviderParty.ServiceTypeCode": "II",
"Invoice.AccountingSupplierParty.Party.ServiceProviderParty.Party.PartyName.Name": "Example Platform SAS",
"Invoice.AccountingSupplierParty.Party.ServiceProviderParty.Party.PartyLegalEntity.CompanyID.Text": "987654321",
"Invoice.AccountingSupplierParty.Party.ServiceProviderParty.Party.PartyTaxScheme.CompanyID.Text": "FR98987654321",
 "Invoice.AccountingSupplierParty.Party.ServiceProviderParty.Party.PostalAddress.CityName": "Lyon",
"Invoice.AccountingSupplierParty.Party.ServiceProviderParty.Party.PostalAddress.Country.IdentificationCode.Text": "FR"
"SubjectNoteDCL": "RCS PARIS 100 000 009" //Additional Subject Code
}

When you UBL an UBL in stead of working via API : When you upload a UBL invoice that already contains a cac:ServiceProviderParty in the seller party, Billit fills in these custom fields for you.