Chorus Pro Guide

​

Introduction

1. Learn about Chorus Pro and its format requirements
2. Set up Invopop workflows:
   • Supplier registration workflow
   • Invoice submission workflow
3. Prepare the Chorus Pro platform and create credentials
4. Register a supplier with Chorus Pro
5. Send your first invoice to a French public institution

​

What is Chorus Pro?

​

Understanding Chorus Pro Format Requirements

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

​

Setup

1

Connect the required apps

1. Go to Configuration > Apps in the Console.
2. Find UN/CEFACT CII in the app list and click Connect to activate the app.
3. Find Chorus Pro in the app list and click Connect to activate the app.

After connecting, you’ll see both UN/CEFACT CII and Chorus Pro listed in the Enabled Apps section.

2

Configure the supplier registration workflow

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

• Template
• Code
• Build from scratch

Chorus Pro supplier registration workflow

This workflow will issue a registration request for a supplier to complete.

Add to my workspace

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

3

Configure invoice workflow

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

• Template
• Code
• Build from scratch

Chorus Pro invoice workflow

This workflow will issue an invoice through Chorus Pro.

Add to my workspace

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

​

Chorus Pro Credentials

1. Create a Chorus Pro account - Sign up for a Chorus Pro account if you don’t have one.

2. Navigate to API settings - Once logged in to your Chorus Pro account, navigate to the API configuration area:
   • Go to Domains > Connections in the main menu
     
   • Click Access Service in the Technical Account section (bottom left)
     
     This opens a new page where you can manage your technical accounts.
3. Create technical account - Set up the technical account credentials:
   • This opens a form to create a technical account:
     • Set the type of request to Creation of a technical account
     • Select your company in the company field
   • This creates a login and password - copy these credentials as you’ll need them when registering with Invopop
     
   • Click Submit to complete the setup

​

Running

​

Register a Supplier

1

Upload a Supplier

Use the Create an entry endpoint to upload a new supplier. Include a party object in the data field. For this step, you only need the VAT number.After successful upload, you’ll see the supplier in the Contacts section with status Empty.

2

Send the Supplier to the registration workflow

Send the supplier to the registration workflow using the Create a job endpoint. Use:

• The supplier’s silo entry UUID from the previous step
• The Supplier Registration workflow ID from the Setup section

This workflow generates a unique URL for the supplier to access and complete the registration process. The URL is stored in the supplier’s metadata.

3

Complete Chorus Pro Authentication

The workflow stays in progress until the supplier completes the registration process. The supplier must access the link and add the credentials they created previously.

The supplier’s status will change to Registered when authentication is complete.

You can fill the form via API by sending a PUT request to the registration link. The payload should be a JSON object with the following fields:

• username (string): The supplier’s Chorus Pro username.
• password (string): The supplier’s Chorus Pro password.

​

Send an Invoice

1

Create an Invoice

Use the Create an entry endpoint to create a new invoice. Include an invoice object in the data field.

Example B2G invoice

Review the example above. Notice that you need both the eu-en16931-v2017 and the fr-choruspro-v1 addon. These addons enable all the necessary validations in your GOBL invoice.

1

Send to Chorus Pro

Send the invoice to Chorus Pro using the Create a job endpoint. Use:

• The invoice’s silo entry UUID from the previous step
• The Chorus Pro Invoice workflow ID from the Setup section

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

2

Track Invoice Status

After submission, track your invoice in Chorus Pro using the invoice identifier (series plus code).

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.

​

FAQ