# Track your Chorus Pro invoices through an API

> Read your Factures émises, their statuts and each invoice's Suivi du traitement from Chorus Pro with one API call. Or have a workflow read the Synthèse tab every weekday morning and tell you which invoices were suspended or rejected overnight.

Page: https://fous.com/automate/chorus-pro
Updated: 2026-11-12

Works with your own Chorus Pro account. Fous is an independent product.

## What you can build on Chorus Pro

### Get invoices awaiting your action

Reads the Synthèse tab of Factures émises, which lists the invoices awaiting your action, such as those Suspendue or Rejetée, with each one's statut.

- Takes: Structure (optional)
- Returns: Invoice number, recipient, recipient SIRET, code service, statut, motif, amount

### Check the statut of your invoices

Searches the Rechercher tab of Factures émises and reads each invoice's current statut, from Déposée to Mise en paiement.

- Takes: Invoice numbers or a date range, structure (optional)
- Returns: Invoice number, invoice date, recipient, recipient SIRET, amount, statut

### Read an invoice's Suivi du traitement

Opens one invoice and reads its Suivi du traitement: the history of its statuts, the events and user actions, and when it reached Mise à disposition.

- Takes: Invoice number, structure (optional)
- Returns: Invoice number, statut history with dates, events and user actions, Mise à disposition date

### Deposit an invoice PDF

Uses Déposer facture in Factures émises: uploads the PDF, sets the cadre de facturation, the recipient and the references, and submits the invoice.

- Takes: Invoice PDF, cadre de facturation, recipient SIRET, code service, numéro d'engagement
- Returns: Invoice number, recipient, amount, statut

## Automate Chorus Pro with a workflow

A [workflow](/product/workflows) runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

### Suspended and rejected invoices, every morning

Starts: Every weekday at 8:00

1. Get the invoices awaiting your action from the Synthèse tab.
2. Keep the ones that were not there on the last run.
3. Email you each one with its recipient, statut, motif and amount.

### Invoice statuts posted to your accounting system

Starts: Every day at 18:00

1. For each open invoice number you list, check its statut in the Rechercher tab.
2. Keep the invoices whose statut changed since the last run.
3. Post invoice number, recipient, amount and new statut to your ERP webhook.

### Payment-delay start dates for last week's invoices

Starts: Every Monday at 9:00

1. Check the statut of the invoices you sent last week.
2. For each one, read the Suivi du traitement and keep the Mise à disposition date.
3. Email you the list with invoice number, recipient, amount and that date.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

## Once built, one call from your code

Once you have built a [method](/product/methods), it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get invoices awaiting your action” would look like.

Example request:

```
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "portail.chorus-pro.gouv.fr/get_invoices_awaiting_action",
    "input": {
      "structure": "Acme"
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "structure": "Acme",
    "invoices": [
      {
        "invoice_number": "FA-2026-0418",
        "recipient": "Ville de Northwind",
        "recipient_siret": "20000000000012",
        "code_service": "SERV-TECH",
        "statut": "Suspendue",
        "motif": "Pièce jointe manquante : bon de livraison",
        "amount": 4260,
        "currency": "EUR"
      }
    ],
    "count": 1
  }
}
```

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

## Chorus Pro’s own options

Chorus Pro offers a raccordement (connection) by API or by EDI for sending invoices and receiving their statuts. Both follow the spécifications externes and start with tests in the qualification environment before production. An API connection needs a PISTE application and a compte technique; EDI needs a certificate. Without one, you work in the portal.

| Option | What it covers | What it takes |
| --- | --- | --- |
| API through PISTE | Sending invoices and reading their cycle de vie (statuts) from your own software, on demand. | A PISTE application, a compte technique on your structure and a fiche de raccordement, in qualification then in production. |
| EDI | Invoice files and their statuts exchanged in bulk over PeSIT, SFTP or AS2. Recommended above 2,000 invoices a day. | A RGS* or eIDAS QWAC certificate from a recognised authority, one per connection and environment, and a fiche de raccordement. |
| Dépôt d'un lot de factures | Several invoices uploaded at once in the portal as a .zip or .tar.gz file. | Invoices in XML or PDF/A3 that follow the spécifications externes. |
| Chorus Pro by hand | Saisir facture, Déposer facture, and the Synthèse and Rechercher tabs of Factures émises, used by a person. | A user account attached to your structure, with the right profile, such as Factures émises modification. |

Read on November 12, 2026: [Se raccorder au Portail de Services pour la facturation électronique](https://portail.chorus-pro.gouv.fr/aife_documentation?id=kb_article_view&sys_kb_id=505c85d82b0413d0b4a3f6fbfe91bfd7), [Création d'un compte technique pour un accès API en production](https://portail.chorus-pro.gouv.fr/aife_documentation?id=kb_article_view&sys_kb_id=db51d9b23328ee9056688539bd5c7b97), [Saisir ou déposer des factures sur le Portail de Services Chorus Pro](https://portail.chorus-pro.gouv.fr/aife_documentation?id=kb_article_view&sys_kb_id=689c696197f7da108ec3b037f053afc2).

## Signing in to Chorus Pro

Chorus Pro signs you in with your email address and a password of at least 12 characters, then a 6-digit code at every sign-in, sent by default to your email. You can add an app or a security key in Mes facteurs d'authentification. With Fous you sign in once through Chorus Pro's own sign-in with your own account: the login is sealed with AES-256, the emailed code is handled, and an expired session is signed back in.

## Worth knowing

- **Mise à disposition starts the payment clock**: The délai global de paiement runs from the day an invoice reaches Mise à disposition. Its Suivi du traitement shows that date, and its Exporter button exports the whole history.
- **Rejected invoices need a new number**: A Rejetée invoice has to be issued again as a new invoice. A Suspendue one goes back with the missing pièces jointes and becomes Complétée. Public buyers can no longer apply A recycler since September 2026.
- **Seven days to acknowledge**: When an invoice is rejected or suspended, a window asks you to acknowledge it when you sign in. The acknowledgement period is 7 days; after that, acknowledging it is mandatory.
- **Some statuts are optional**: Recipients choose whether to send the optional statuts, so not every invoice shows them. Whether a recipient updates Mise en paiement is shown in its directory entry.

## More in Government: UK and Western Europe

- [Guichet unique des formalités d'entreprises](https://fous.com/automate/guichet-unique-des-formalites-d-entreprises.md)
- [Companies House WebFiling](https://fous.com/automate/companies-house-webfiling.md)
- [Planning Portal](https://fous.com/automate/planning-portal.md)
- [FCA RegData](https://fous.com/automate/fca-regdata.md)
- [net-entreprises.fr](https://fous.com/automate/net-entreprises-fr.md)
- [Urssaf compte employeur](https://fous.com/automate/urssaf-compte-employeur.md)
- [ePortal ESTV](https://fous.com/automate/eportal-estv.md)
- [FinanzOnline](https://fous.com/automate/finanzonline.md)
- [impots.gouv.fr espace professionnel](https://fous.com/automate/impots-gouv-fr-espace-professionnel.md)
- [MOT Testing Service](https://fous.com/automate/mot-testing-service.md)

Other industries: [Accela Citizen Access](/automate/accela-citizen-access), [Desktop Underwriter](/automate/desktop-underwriter), [USPS Business Customer Gateway](/automate/usps-business-customer-gateway), [Bonfire](/automate/bonfire), [Colorado Revenue Online](/automate/colorado-revenue-online), [DIR Public Works eCPR](/automate/dir-public-works-ecpr).

## Frequently asked questions

### Does Chorus Pro have an API?

Yes. Chorus Pro offers a raccordement by API through PISTE, which needs a PISTE application, a compte technique and a fiche de raccordement, tested in the qualification environment before production. EDI over PeSIT, SFTP or AS2 is the other route. Without either, you use the portal.

### How do I know when a Chorus Pro invoice has been paid?

Look for the statut Mise en paiement: the public accountant has sent the transfer order to the Banque de France, and the money follows a few days later. Not every recipient sends this statut. ClaudIA can also match a transfer you received to its invoice.

### What is the difference between Suspendue and Rejetée?

A Suspendue invoice is waiting for pièces jointes: you add them and it becomes Complétée. A Rejetée invoice cannot be sent again: you issue a new invoice with a new number.

### Can I send many invoices at once without an API?

Yes, with Dépôt d'un lot de factures in Factures émises: you upload a .zip or .tar.gz file of invoices. The invoices must be in XML or PDF/A3 following the spécifications externes. A plain PDF can only be deposited one invoice at a time.

### Is Fous affiliated with the AIFE?

No. Fous is an independent product. You use it with your own Chorus Pro account, and a method reads and does only what that account's profiles allow.

Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of Chorus Pro (Agence pour l'informatique financière de l'État (AIFE)). The name is used only to say which system this page is about. Something here wrong or out of date? Write to legal@fous.com.
