> ## Documentation Index
> Fetch the complete documentation index at: https://docs.invopop.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Chorus Pro issuing invoices guide

> Issue invoices to French public institutions with Chorus Pro.

## Introduction

> [!NOTE]
>
> This guide is for **foreign entities without a French SIREN**. If your company is French and registered in the Annuaire through Invopop, invoice public entities with the same workflow as your B2B invoices: see the [public sector guide](https://docs.invopop.com/guides/fr-pa-b2g.md).

In this guide, you'll learn how to issue invoices to French public institutions using [Chorus Pro](https://portail.chorus-pro.gouv.fr/). It will walk you through:

1. Understanding Chorus Pro and its format requirements
2. Setting up the invoice submission workflow
3. Submitting your first invoice to a French public institution

### What is Chorus Pro?

Chorus Pro is a mandatory service provided by the French government for invoicing French public institutions. The platform allows businesses to upload invoices in multiple e-invoicing formats and track them throughout the French public administration process. All invoices to French public sector entities must be submitted through Chorus Pro.

The platform supports various e-invoicing formats including [Cross Industry Invoice (CII)](https://unece.org/trade/uncefact/e-invoice), and implements the [European Norm 16931 (EN16931)](https://ec.europa.eu/digital-building-blocks/sites/display/DIGITAL/European+Standard+and+Specifications) European standard for electronic invoicing with additional French-specific requirements.

### Understanding Chorus Pro format requirements

Chorus Pro accepts invoices in CII format based on the EN16931 European standard. However, it adds specific French extensions and validation requirements:

**EN16931 Standard**
The EN16931 defines the semantic data model for electronic invoices. The standard ensures interoperability across European Union (EU) member states while allowing for country-specific extensions.

**Chorus Pro Extensions**
Chorus Pro extends the base EN16931 standard with additional French requirements:

* SIRET number validation for French entities
* Specific invoice types for different purposes
* Service codes for government departments

In GOBL, these formats are handled via addons that you must add to each invoice. You'll see examples of this further below.

## Prerequisites

To issue invoices through Chorus Pro, you will need:

* **A registered supplier**: follow the [Chorus Pro supplier registration guide](https://docs.invopop.com/guides/fr-chorus-pro-supplier.md) to connect the required apps, create the Chorus Pro credentials, and register the supplier before issuing.
* Customer details, including the SIRET number of the public institution being invoiced.

## Setup

Configure your Invopop Workspace for Chorus Pro invoicing.

> [!NOTE]
>
> These instructions apply to both the sandbox and live environments. The UN/CEFACT CII and Chorus Pro apps must already be connected and the supplier registered — this is covered in the [supplier registration guide](https://docs.invopop.com/guides/fr-chorus-pro-supplier.md).

**1. Configure invoice workflow**

Add a new workflow to your workspace for issuing invoices. You can start with the template below.

> [card] [Chorus Pro invoice workflow](https://console.invopop.com/redirect/workflows/new?template=chorus-pro-invoice)
>
> Add to my workspace →

> [tab] Workflow

> [tab] Code
>
> Copy and paste this code into a new [Empty Invoice workflow](https://console.invopop.com/redirect/workflows/new?template=empty-invoice) code view.
>
> ```json Chorus Pro issue invoice workflow theme={"system"}
> {
>     "name": "Chorus Pro issue invoice",
>     "description": "Issue a B2G invoice through Chorus Pro using CII",
>     "schema": "bill/invoice",
>     "steps": [
>         {
>             "id": "241c1b60-4cec-11f0-bcdc-61b84b5eeae8",
>             "name": "Set state",
>             "provider": "silo.state",
>             "summary": "Set state to `processing`{.state .processing}",
>             "config": {
>                 "state": "processing"
>             }
>         },
>         {
>             "id": "0dba81f0-4ba1-11f0-a0a5-bbd7c9d8117a",
>             "name": "Sign envelope",
>             "provider": "silo.close"
>         },
>         {
>             "id": "3d048690-4ba1-11f0-a0a5-bbd7c9d8117a",
>             "name": "Generate CII document",
>             "provider": "cii.generate",
>             "summary": "Chorus Pro v1",
>             "config": {
>                 "doc_type": "choruspro-v1"
>             }
>         },
>         {
>             "id": "2cd30490-4ba1-11f0-a0a5-bbd7c9d8117a",
>             "name": "Send invoice to Chorus Pro",
>             "provider": "chorus-pro.send"
>         },
>         {
>             "id": "282dac00-4cec-11f0-bcdc-61b84b5eeae8",
>             "name": "Set state",
>             "provider": "silo.state",
>             "summary": "Set state to `sent`{.state .sent}",
>             "config": {
>                 "state": "sent"
>             }
>         }
>     ],
>     "rescue": [
>         {
>             "id": "2b9c6cf0-4cec-11f0-bcdc-61b84b5eeae8",
>             "name": "Set state",
>             "provider": "silo.state",
>             "summary": "Set state to `error`{.state .error}",
>             "config": {
>                 "state": "error"
>             }
>         }
>     ]
> }
> ```

Keep the workflow ID at hand as you'll need it later.

## Send an invoice

Once a supplier is registered, you can send invoices to French public institutions through Chorus Pro.

**1. Create an Invoice**

Use the [Create an entry](https://docs.invopop.com/api-ref/silo/entries/create-an-entry-put.md) endpoint to create a new invoice. Include an [invoice](https://docs.gobl.org/draft-0/bill/invoice) object in the [data](https://docs.invopop.com/api-ref/silo/entries/create-an-entry-put.md#body-data) field.

> [accordion] Chorus Pro B2G Invoice
>
> In this example, we're issuing a Chorus Pro invoice for business-to-government transactions in France. Chorus Pro is the mandatory platform for submitting invoices to French public sector entities.
>
> Notice:
>
> * the minimal version in the first tab contains only the essential fields required to create the B2G invoice,
> * the [`fr-choruspro-v1`](https://docs.gobl.org/addons/fr-choruspro-v1) addon ensures the document will be validated using the Chorus Pro rules built into the [GOBL](https://docs.gobl.org) library,
> * the customer must be a French public sector entity with a valid SIRET number,
> * specific Chorus Pro extensions and identifiers are required for public procurement (such as service codes and commitment numbers),
> * there are no totals or calculations in the minimal version; all these will be calculated automatically when running `gobl build`,
> * the built version in the second tab shows the normalized document with calculated totals, line item sums, TVA breakdowns, and automatically generated fields,
> * the invoice will be formatted according to Chorus Pro requirements and submitted through the platform, and,
> * all invoices to French public entities must be submitted through Chorus Pro.
>
> ```json Chorus Pro B2G Invoice theme={"system"}
> {
>     "$schema": "https://gobl.org/draft-0/bill/invoice",
>     "$regime": "FR",
>     "$addons": [
>         "eu-en16931-v2017",
>         "fr-choruspro-v1"
>     ],
>     "uuid": "019783e7-33b1-7000-a1a5-6139e214b447",
>     "type": "standard",
>     "series": "SAMPLE",
>     "code": "2345",
>     "issue_date": "2025-06-18",
>     "currency": "EUR",
>     "supplier": {
>         "name": "Provide One Inc.",
>         "tax_id": {
>             "country": "FR",
>             "code": "43498927917"
>         },
>         "identities": [
>             {
>                 "type": "SIRET",
>                 "code": "49892791768734"
>             }
>         ],
>         "addresses": [
>             {
>                 "num": "42",
>                 "street": "Calle Pradillo",
>                 "locality": "Madrid",
>                 "region": "Madrid",
>                 "code": "28002",
>                 "country": "ES"
>             }
>         ],
>         "emails": [
>             {
>                 "addr": "billing@example.com"
>             }
>         ]
>     },
>     "customer": {
>         "name": "Sample Consumer",
>         "tax_id": {
>             "country": "FR",
>             "code": "39356000000"
>         },
>         "identities": [
>             {
>                 "type": "SIRET",
>                 "code": "35600000012345"
>             }
>         ],
>         "addresses": [
>             {
>                 "num": "1",
>                 "street": "Rue Sundacsakn",
>                 "locality": "Saint-Germain-En-Laye",
>                 "code": "75050",
>                 "country": "FR"
>             }
>         ],
>         "emails": [
>             {
>                 "addr": "email@sample.com"
>             }
>         ]
>     },
>     "lines": [
>         {
>             "i": 1,
>             "quantity": "20",
>             "item": {
>                 "name": "Development services",
>                 "price": "90.00",
>                 "unit": "h"
>             },
>             "sum": "1800.00",
>             "discounts": [
>                 {
>                     "reason": "Special discount",
>                     "percent": "10%",
>                     "amount": "180.00"
>                 }
>             ],
>             "taxes": [
>                 {
>                     "cat": "VAT",
>                     "rate": "standard"
>                 }
>             ],
>             "total": "1620.00"
>         }
>     ],
>     "payment": {
>         "advances": [
>             {
>                 "description": "Paid in full",
>                 "percent": "100%",
>                 "amount": "1944.00"
>             }
>         ],
>         "instructions": {
>             "key": "card"
>         }
>     }
> }
> ```
>
> ```json Built version theme={"system"}
> {
> 	"$schema": "https://gobl.org/draft-0/bill/invoice",
> 	"$regime": "FR",
> 	"$addons": [
> 		"eu-en16931-v2017",
> 		"fr-choruspro-v1"
> 	],
> 	"uuid": "019783e7-33b1-7000-a1a5-6139e214b447",
> 	"type": "standard",
> 	"series": "SAMPLE",
> 	"code": "2345",
> 	"issue_date": "2025-06-18",
> 	"currency": "EUR",
> 	"tax": {
> 		"ext": {
> 			"fr-choruspro-framework": "A1",
> 			"untdid-document-type": "380"
> 		}
> 	},
> 	"supplier": {
> 		"name": "Provide One Inc.",
> 		"tax_id": {
> 			"country": "FR",
> 			"code": "43498927917"
> 		},
> 		"identities": [
> 			{
> 				"type": "SIRET",
> 				"code": "49892791768734",
> 				"ext": {
> 					"iso-scheme-id": "0009"
> 				}
> 			}
> 		],
> 		"addresses": [
> 			{
> 				"num": "42",
> 				"street": "Calle Pradillo",
> 				"locality": "Madrid",
> 				"region": "Madrid",
> 				"code": "28002",
> 				"country": "ES"
> 			}
> 		],
> 		"emails": [
> 			{
> 				"addr": "billing@example.com"
> 			}
> 		],
> 		"ext": {
> 			"fr-choruspro-scheme": "1"
> 		}
> 	},
> 	"customer": {
> 		"name": "Sample Consumer",
> 		"tax_id": {
> 			"country": "FR",
> 			"code": "39356000000"
> 		},
> 		"identities": [
> 			{
> 				"type": "SIRET",
> 				"code": "35600000012345",
> 				"ext": {
> 					"iso-scheme-id": "0009"
> 				}
> 			}
> 		],
> 		"addresses": [
> 			{
> 				"num": "1",
> 				"street": "Rue Sundacsakn",
> 				"locality": "Saint-Germain-En-Laye",
> 				"code": "75050",
> 				"country": "FR"
> 			}
> 		],
> 		"emails": [
> 			{
> 				"addr": "email@sample.com"
> 			}
> 		],
> 		"ext": {
> 			"fr-choruspro-scheme": "1"
> 		}
> 	},
> 	"lines": [
> 		{
> 			"i": 1,
> 			"quantity": "20",
> 			"item": {
> 				"name": "Development services",
> 				"price": "90.00",
> 				"unit": "h"
> 			},
> 			"sum": "1800.00",
> 			"discounts": [
> 				{
> 					"reason": "Special discount",
> 					"percent": "10%",
> 					"amount": "180.00"
> 				}
> 			],
> 			"taxes": [
> 				{
> 					"cat": "VAT",
> 					"key": "standard",
> 					"rate": "general",
> 					"percent": "20%",
> 					"ext": {
> 						"untdid-tax-category": "S"
> 					}
> 				}
> 			],
> 			"total": "1620.00"
> 		}
> 	],
> 	"payment": {
> 		"advances": [
> 			{
> 				"description": "Paid in full",
> 				"percent": "100%",
> 				"amount": "1944.00"
> 			}
> 		],
> 		"instructions": {
> 			"key": "card",
> 			"ext": {
> 				"untdid-payment-means": "48"
> 			}
> 		}
> 	},
> 	"totals": {
> 		"sum": "1620.00",
> 		"total": "1620.00",
> 		"taxes": {
> 			"categories": [
> 				{
> 					"code": "VAT",
> 					"rates": [
> 						{
> 							"key": "standard",
> 							"ext": {
> 								"untdid-tax-category": "S"
> 							},
> 							"base": "1620.00",
> 							"percent": "20%",
> 							"amount": "324.00"
> 						}
> 					],
> 					"amount": "324.00"
> 				}
> 			],
> 			"sum": "324.00"
> 		},
> 		"tax": "324.00",
> 		"total_with_tax": "1944.00",
> 		"payable": "1944.00",
> 		"advance": "1944.00",
> 		"due": "0.00"
> 	}
> }
> ```

> [accordion] Chorus Pro cross-border invoice (DE → FR)
>
> A non-French supplier invoicing a French public sector entity through Chorus Pro. Chorus Pro accepts foreign suppliers — the customer's SIRET is what anchors the document to the right administration.
>
> Notice:
>
> * the supplier carries a DE tax ID and address, while the customer keeps its `SIRET` identity,
> * the `fr-choruspro-v1` add-on still applies — Chorus Pro routing rules are driven by the receiver, not the issuer,
> * VAT is reported as standard French VAT because the place of supply is France; cross-border reverse-charge cases would set the line tax accordingly.
>
> ```json Chorus Pro Cross-Border Invoice (DE → FR) theme={"system"}
> {
>     "$schema": "https://gobl.org/draft-0/bill/invoice",
>     "$regime": "FR",
>     "$addons": [
>         "fr-choruspro-v1"
>     ],
>     "type": "standard",
>     "series": "SAMPLE",
>     "code": "001",
>     "issue_date": "2022-02-01",
>     "currency": "EUR",
>     "supplier": {
>         "name": "Provide One Inc.",
>         "tax_id": {
>             "country": "DE",
>             "code": "111111125"
>         },
>         "addresses": [
>             {
>                 "num": "42",
>                 "street": "Berliner Strasse",
>                 "locality": "Berlin",
>                 "code": "10117",
>                 "country": "DE"
>             }
>         ],
>         "emails": [
>             {
>                 "addr": "billing@example.com"
>             }
>         ]
>     },
>     "customer": {
>         "name": "Sample Public Entity",
>         "tax_id": {
>             "country": "FR",
>             "code": "732829320"
>         },
>         "identities": [
>             {
>                 "type": "SIRET",
>                 "code": "73282932012345"
>             }
>         ],
>         "addresses": [
>             {
>                 "num": "1",
>                 "street": "Rue Sundacsakn",
>                 "locality": "Saint-Germain-En-Laye",
>                 "code": "75050",
>                 "country": "FR"
>             }
>         ],
>         "emails": [
>             {
>                 "addr": "email@sample.com"
>             }
>         ]
>     },
>     "lines": [
>         {
>             "quantity": "20",
>             "item": {
>                 "name": "Development services",
>                 "price": "90.00",
>                 "unit": "h"
>             },
>             "discounts": [
>                 {
>                     "percent": "10%",
>                     "reason": "Special discount"
>                 }
>             ],
>             "taxes": [
>                 {
>                     "cat": "VAT",
>                     "rate": "standard"
>                 }
>             ]
>         }
>     ],
>     "payment": {
>         "terms": {
>             "detail": "Please pay within 10 days"
>         }
>     }
> }
> ```
>
> ```json Built version theme={"system"}
> {
> 	"$schema": "https://gobl.org/draft-0/bill/invoice",
> 	"$regime": "FR",
> 	"$addons": [
> 		"eu-en16931-v2017",
> 		"fr-choruspro-v1"
> 	],
> 	"type": "standard",
> 	"series": "SAMPLE",
> 	"code": "001",
> 	"issue_date": "2022-02-01",
> 	"currency": "EUR",
> 	"tax": {
> 		"ext": {
> 			"fr-choruspro-framework": "A1",
> 			"untdid-document-type": "380"
> 		}
> 	},
> 	"supplier": {
> 		"name": "Provide One Inc.",
> 		"tax_id": {
> 			"country": "DE",
> 			"code": "111111125"
> 		},
> 		"addresses": [
> 			{
> 				"num": "42",
> 				"street": "Berliner Strasse",
> 				"locality": "Berlin",
> 				"code": "10117",
> 				"country": "DE"
> 			}
> 		],
> 		"emails": [
> 			{
> 				"addr": "billing@example.com"
> 			}
> 		],
> 		"ext": {
> 			"fr-choruspro-scheme": "2"
> 		}
> 	},
> 	"customer": {
> 		"name": "Sample Public Entity",
> 		"tax_id": {
> 			"country": "FR",
> 			"code": "44732829320"
> 		},
> 		"identities": [
> 			{
> 				"type": "SIRET",
> 				"code": "73282932012345",
> 				"ext": {
> 					"iso-scheme-id": "0009"
> 				}
> 			}
> 		],
> 		"addresses": [
> 			{
> 				"num": "1",
> 				"street": "Rue Sundacsakn",
> 				"locality": "Saint-Germain-En-Laye",
> 				"code": "75050",
> 				"country": "FR"
> 			}
> 		],
> 		"emails": [
> 			{
> 				"addr": "email@sample.com"
> 			}
> 		],
> 		"ext": {
> 			"fr-choruspro-scheme": "1"
> 		}
> 	},
> 	"lines": [
> 		{
> 			"i": 1,
> 			"quantity": "20",
> 			"item": {
> 				"name": "Development services",
> 				"price": "90.00",
> 				"unit": "h"
> 			},
> 			"sum": "1800.00",
> 			"discounts": [
> 				{
> 					"reason": "Special discount",
> 					"percent": "10%",
> 					"amount": "180.00"
> 				}
> 			],
> 			"taxes": [
> 				{
> 					"cat": "VAT",
> 					"key": "standard",
> 					"rate": "general",
> 					"percent": "20%",
> 					"ext": {
> 						"untdid-tax-category": "S"
> 					}
> 				}
> 			],
> 			"total": "1620.00"
> 		}
> 	],
> 	"payment": {
> 		"terms": {
> 			"notes": "Please pay within 10 days"
> 		}
> 	},
> 	"totals": {
> 		"sum": "1620.00",
> 		"total": "1620.00",
> 		"taxes": {
> 			"categories": [
> 				{
> 					"code": "VAT",
> 					"rates": [
> 						{
> 							"key": "standard",
> 							"ext": {
> 								"untdid-tax-category": "S"
> 							},
> 							"base": "1620.00",
> 							"percent": "20%",
> 							"amount": "324.00"
> 						}
> 					],
> 					"amount": "324.00"
> 				}
> 			],
> 			"sum": "324.00"
> 		},
> 		"tax": "324.00",
> 		"total_with_tax": "1944.00",
> 		"payable": "1944.00"
> 	}
> }
> ```

> [accordion] Chorus Pro Credit Note
>
> A credit note (avoir) reversing part of a previously submitted Chorus Pro invoice.
>
> Notice:
>
> * the `type` is set to `credit-note`, so the document is rendered with the UNTDID document type `381`,
> * the `preceding` array references the original invoice by `series`, `code`, and `issue_date`, with a `reason` for the correction — Chorus Pro links the avoir to the original submission through this reference,
> * both parties keep their `SIRET` identities, exactly as on the original invoice, and,
> * the lines describe only the amounts being credited; totals are calculated automatically when running `gobl build`.
>
> ```json Chorus Pro Credit Note theme={"system"}
> {
>     "$schema": "https://gobl.org/draft-0/bill/invoice",
>     "$regime": "FR",
>     "$addons": [
>         "eu-en16931-v2017",
>         "fr-choruspro-v1"
>     ],
>     "uuid": "019783e7-33b1-7000-a1a5-6139e214b448",
>     "type": "credit-note",
>     "series": "SAMPLE-CN",
>     "code": "2346",
>     "issue_date": "2025-06-25",
>     "currency": "EUR",
>     "preceding": [
>         {
>             "type": "standard",
>             "series": "SAMPLE",
>             "code": "2345",
>             "issue_date": "2025-06-18",
>             "reason": "Partial refund for undelivered services"
>         }
>     ],
>     "supplier": {
>         "name": "Provide One Inc.",
>         "tax_id": {
>             "country": "FR",
>             "code": "43498927917"
>         },
>         "identities": [
>             {
>                 "type": "SIRET",
>                 "code": "49892791768734"
>             }
>         ],
>         "addresses": [
>             {
>                 "num": "42",
>                 "street": "Calle Pradillo",
>                 "locality": "Madrid",
>                 "region": "Madrid",
>                 "code": "28002",
>                 "country": "ES"
>             }
>         ],
>         "emails": [
>             {
>                 "addr": "billing@example.com"
>             }
>         ]
>     },
>     "customer": {
>         "name": "Sample Consumer",
>         "tax_id": {
>             "country": "FR",
>             "code": "39356000000"
>         },
>         "identities": [
>             {
>                 "type": "SIRET",
>                 "code": "35600000012345"
>             }
>         ],
>         "addresses": [
>             {
>                 "num": "1",
>                 "street": "Rue Sundacsakn",
>                 "locality": "Saint-Germain-En-Laye",
>                 "code": "75050",
>                 "country": "FR"
>             }
>         ],
>         "emails": [
>             {
>                 "addr": "email@sample.com"
>             }
>         ]
>     },
>     "lines": [
>         {
>             "quantity": "5",
>             "item": {
>                 "name": "Development services",
>                 "price": "90.00",
>                 "unit": "h"
>             },
>             "taxes": [
>                 {
>                     "cat": "VAT",
>                     "rate": "standard"
>                 }
>             ]
>         }
>     ],
>     "payment": {
>         "instructions": {
>             "key": "card"
>         }
>     }
> }
> ```
>
> ```json Built version theme={"system"}
> {
> 	"$schema": "https://gobl.org/draft-0/bill/invoice",
> 	"$regime": "FR",
> 	"$addons": [
> 		"eu-en16931-v2017",
> 		"fr-choruspro-v1"
> 	],
> 	"uuid": "019783e7-33b1-7000-a1a5-6139e214b448",
> 	"type": "credit-note",
> 	"series": "SAMPLE-CN",
> 	"code": "2346",
> 	"issue_date": "2025-06-25",
> 	"currency": "EUR",
> 	"preceding": [
> 		{
> 			"type": "standard",
> 			"issue_date": "2025-06-18",
> 			"series": "SAMPLE",
> 			"code": "2345",
> 			"reason": "Partial refund for undelivered services"
> 		}
> 	],
> 	"tax": {
> 		"ext": {
> 			"fr-choruspro-framework": "A1",
> 			"untdid-document-type": "381"
> 		}
> 	},
> 	"supplier": {
> 		"name": "Provide One Inc.",
> 		"tax_id": {
> 			"country": "FR",
> 			"code": "43498927917"
> 		},
> 		"identities": [
> 			{
> 				"type": "SIRET",
> 				"code": "49892791768734",
> 				"ext": {
> 					"iso-scheme-id": "0009"
> 				}
> 			}
> 		],
> 		"addresses": [
> 			{
> 				"num": "42",
> 				"street": "Calle Pradillo",
> 				"locality": "Madrid",
> 				"region": "Madrid",
> 				"code": "28002",
> 				"country": "ES"
> 			}
> 		],
> 		"emails": [
> 			{
> 				"addr": "billing@example.com"
> 			}
> 		],
> 		"ext": {
> 			"fr-choruspro-scheme": "1"
> 		}
> 	},
> 	"customer": {
> 		"name": "Sample Consumer",
> 		"tax_id": {
> 			"country": "FR",
> 			"code": "39356000000"
> 		},
> 		"identities": [
> 			{
> 				"type": "SIRET",
> 				"code": "35600000012345",
> 				"ext": {
> 					"iso-scheme-id": "0009"
> 				}
> 			}
> 		],
> 		"addresses": [
> 			{
> 				"num": "1",
> 				"street": "Rue Sundacsakn",
> 				"locality": "Saint-Germain-En-Laye",
> 				"code": "75050",
> 				"country": "FR"
> 			}
> 		],
> 		"emails": [
> 			{
> 				"addr": "email@sample.com"
> 			}
> 		],
> 		"ext": {
> 			"fr-choruspro-scheme": "1"
> 		}
> 	},
> 	"lines": [
> 		{
> 			"i": 1,
> 			"quantity": "5",
> 			"item": {
> 				"name": "Development services",
> 				"price": "90.00",
> 				"unit": "h"
> 			},
> 			"sum": "450.00",
> 			"taxes": [
> 				{
> 					"cat": "VAT",
> 					"key": "standard",
> 					"rate": "general",
> 					"percent": "20%",
> 					"ext": {
> 						"untdid-tax-category": "S"
> 					}
> 				}
> 			],
> 			"total": "450.00"
> 		}
> 	],
> 	"payment": {
> 		"instructions": {
> 			"key": "card",
> 			"ext": {
> 				"untdid-payment-means": "48"
> 			}
> 		}
> 	},
> 	"totals": {
> 		"sum": "450.00",
> 		"total": "450.00",
> 		"taxes": {
> 			"categories": [
> 				{
> 					"code": "VAT",
> 					"rates": [
> 						{
> 							"key": "standard",
> 							"ext": {
> 								"untdid-tax-category": "S"
> 							},
> 							"base": "450.00",
> 							"percent": "20%",
> 							"amount": "90.00"
> 						}
> 					],
> 					"amount": "90.00"
> 				}
> 			],
> 			"sum": "90.00"
> 		},
> 		"tax": "90.00",
> 		"total_with_tax": "540.00",
> 		"payable": "540.00"
> 	}
> }
> ```

> [accordion] Convert a Chorus Pro test SIREN into a GOBL party
>
> SIRET (14 digits) or SIREN (9 digits)
>
> ```js JavaScript theme={"system"}
> const siret = "34724449635741"; // from the QAS test account CSV
> const siren = siret.slice(0, 9);
> const key = String((Number(siren) * 100 + 12) % 97).padStart(2, "0");
>
> const party = {
>   name: "Example Company",
>   tax_id: { country: "FR", code: key + siren },
>   identities: [{ type: "SIRET", code: siret }],
> };
> ```
>
> ```python Python theme={"system"}
> siret = "34724449635741"  # from the QAS test account CSV
> siren = siret[:9]
>
> party = {
>     "name": "Example Company",
>     "tax_id": {"country": "FR", "code": f"{(int(siren) * 100 + 12) % 97:02d}{siren}"},
>     "identities": [{"type": "SIRET", "code": siret}],
> }
> ```

Review the example above. Notice that you need both the [`eu-en16931-v2017`](https://docs.gobl.org/addons/eu-en16931-v2017) and the [`fr-choruspro-v1`](https://docs.gobl.org/addons/fr-choruspro-v1) addon. These addons enable all the necessary validations in your GOBL invoice.

**2. Send to Chorus Pro**

Send the invoice to Chorus Pro using the [Create a job](https://docs.invopop.com/api-ref/transform/jobs/create-a-job-post.md) endpoint. Use:

* The invoice's silo entry UUID from the previous step
* The Chorus Pro Invoice workflow ID from the [Setup](#setup) section

The system generates a CII XML file with Chorus Pro extensions and submits it to the platform.

![Invoice sent to Chorus Pro](https://mintcdn.com/invopop/-KQ2_uysex-mWyqz/assets/guides/fr-chorus-pro-xml.png?fit=max\&auto=format\&n=-KQ2_uysex-mWyqz\&q=85\&s=a0f7d3065f8b070e499da82c4fa84daf)

**3. Track Invoice Status**

After submission, track your invoice in [Chorus Pro](https://cpro.chorus-pro.gouv.fr/cpp/rechercheFacturesEmises) using the invoice identifier (series plus code).

> [!NOTE]
>
> Chorus Pro allows document modifications after submission. If a document is rejected or contains errors, update the GOBL details and resubmit to the same workflow until the document is accepted.
> Once accepted, do not modify the invoice.

> [!NOTE]
>
> The invoice identifier in Chorus Pro corresponds to your GOBL invoice series and code combined. This identifier helps you locate and track invoices across both systems.

## FAQ

> [accordion] How do I configure my workspace for French invoicing?
>
> Two channels depending on the recipient: B2G uses Chorus Pro (CII format); B2B from September 2026 uses the Plateforme Agréée model (UBL, CII, or Factur-X via Peppol). Invopop is an approved PA — install the France PA app for B2B and the Chorus Pro app for B2G.

> [accordion] How can I view an XML attached to a PDF?
>
> In Factur-X PDFs, the XML file is embedded within the PDF itself. To extract and view it, use the `Attachments` section in Adobe Acrobat Reader, or a tool like the [SysTools PDF Extractor](https://www.systoolsgroup.com/pdf/extractor/).

> [accordion] What invoice formats does Chorus Pro support?
>
> Chorus Pro primarily supports CII format based on EN16931. Invopop currently focuses on CII with plans to add additional formats in the future.

> [accordion] Do I need a SIRET number to use Chorus Pro?
>
> French businesses need a SIRET number. Foreign businesses can use their local tax identifier, but should verify acceptance with the receiving French institution.

> [accordion] Can I modify invoices after sending to Chorus Pro?
>
> Yes, you can modify and resubmit invoices until the receiving institution accepts them. Once accepted, invoices become locked and cannot be modified.

> [accordion] How do I find my invoice in Chorus Pro?
>
> Use your GOBL invoice series and code combined as the invoice identifier in the Chorus Pro portal to locate your submitted invoices.

> [accordion] Are there file size limits for Chorus Pro invoices?
>
> Chorus Pro has specific file size and format requirements. Invopop handles these automatically when generating CII XML files from your GOBL invoices.

> [accordion] What GOBL fields are required for Chorus Pro?
>
> The recipient's SIRET (or equivalent identifier) plus a Chorus Pro service code where applicable. Invopop generates EN 16931 CII XML by default — UBL is also accepted by Chorus Pro.

> [accordion] What should we do if the customer doesn't belong to the Peppol network?
>
> In countries where Peppol is the standard but not mandatory, you may still need to issue an e-invoice when the recipient isn't on the network. Both parties can agree on an alternative transfer method, but the invoice must still be EN16931 compliant.
>
> Recommended approach:
>
> * Set up a separate workflow that generates the XML without the send-Peppol-document step
> * Or reuse your existing workflow without the customer Peppol ID — the send step is automatically skipped
> * Fetch the generated XML and deliver it through the agreed channel, typically email

> [accordion] How do I handle B2C invoices in Peppol?
>
> B2C invoices typically lack the structured customer information required for Peppol delivery, and most consumers don't have inboxes. Use a conditional workflow:
>
> 1. Add an **If/Else** step that checks for a customer inbox using `count(customer.inboxes, true) > 0`.
> 2. On the `false` branch, generate a PDF and email it to the customer, then stop the flow.
>
> This routes B2B invoices through Peppol while keeping a smooth path for consumers.

> [accordion] How do I handle 'Receiver Not Found' errors?
>
> If a job fails with `KO` and `receiver not found in the peppol network`, treat it like an invalid email address — the recipient simply isn't reachable on Peppol. Add the **Lookup Participant ID** step (ideally in a separate validation workflow run against customer data) so you catch missing IDs before generating the invoice.

> [accordion] Should I set the `$regime` field when using Peppol?
>
> No. The regime is automatically derived from the supplier's settings, which is the recommended approach for Peppol — leave it unset on the document.

> [accordion] Where do I find Peppol GOBL documentation?
>
> See the [`eu-en16931-v2017`](https://docs.gobl.org/addons/eu-en16931-v2017) addon for the field and validation rules Peppol BIS Billing 3.0 builds on, and the [Peppol app reference](https://docs.invopop.com/apps/peppol.md) for supported document types and Participant ID schemes.

More available in our [France FAQ](https://docs.invopop.com/faq/france.md) section

***

> [accordion] 🇫🇷 Invopop resources for France
>
> | | |
> | - | - |
> | Compliance | [Invoicing compliance in France](https://docs.invopop.com/compliance/france.md)   [Compliance timeline](https://docs.invopop.com/timelines/france.md) |
> | Apps | [France](https://docs.invopop.com/apps/france.md)  [Peppol](https://docs.invopop.com/apps/peppol.md)  [Chorus Pro France](https://docs.invopop.com/apps/choruspro-france.md) |
> | Guides | Chorus Pro — [Supplier registration](https://docs.invopop.com/guides/fr-chorus-pro-supplier.md) · [Issuing invoices](https://docs.invopop.com/guides/fr-chorus-pro.md)  [PA Guide](https://docs.invopop.com/guides/fr-pa.md) — [Registration](https://docs.invopop.com/guides/fr-pa-registration.md) · [Invoicing](https://docs.invopop.com/guides/fr-pa-invoicing.md) · [Status](https://docs.invopop.com/guides/fr-pa-status.md) · [Reporting](https://docs.invopop.com/guides/fr-pa-reporting.md) · [Public sector](https://docs.invopop.com/guides/fr-pa-b2g.md) |
> | FAQ | [France FAQ](https://docs.invopop.com/faq/france.md) |
> | GOBL | [France Tax Regime](https://docs.gobl.org/regimes/fr)   [Chorus Pro Addon](https://docs.gobl.org/addons/fr-choruspro-v1)   [French Factur-X Addon](https://docs.gobl.org/addons/fr-facturx-v1) |
> | GitHub | [gobl.xinvoice](https://github.com/invopop/gobl.xinvoice) |

> [card] [Participate in our community](https://community.invopop.com)
>
> Ask and answer questions about invoicing in France →


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.