France status flow

Overview

This page describes the France-specific behaviour of the external status endpoint. For the full endpoint reference, including request body fields and examples, see Document .

Under the French e-invoicing framework, external status transitions follow a defined lifecycle. The platform enforces the permitted paths, attempting a transition not listed below will result in a validation error.

France statuses are grouped into three categories:

Category	Statuses	Description
Neutral	`IN_HAND`, `APPROVED`, `PARTIALLY_APPROVED`, `COMPLETED`	Informational statuses indicating the document has been received, reviewed, or acknowledged.
Payment	`PAYMENT_SENT`, `PAYMENT_RECEIVED`	Statuses indicating a payment action has been initiated or completed.
Rejection	`DISPUTED`, `SUSPENDED`, `REFUSED`	Statuses indicating the document has been disputed, suspended, or refused by the counterparty.

Status lifecycle

Issued documents

Received documents

Rejection reasons

When submitting a DISPUTED, REFUSED, or SUSPENDED status, the rejectionDetail object is required and must include a valid reason code. The table below lists the available reasons and the statuses each one is valid for.

Reason	Allowed statuses
`LEGAL_INFORMATION_MISSING`	`REFUSED`, `DISPUTED`
`INCORRECT_RECIPIENT`	`REFUSED`, `DISPUTED`
`EINVOICING_ADDRESS_INCORRECT`	`REFUSED`, `DISPUTED`
`UNKNOWN_TRANSACTION`	`REFUSED`, `DISPUTED`
`PO_REFERENCE_INCORRECT_OR_MISSING`	`REFUSED`, `DISPUTED`, `SUSPENDED`
`CONTRACT_REFERENCE_MISSING`	`REFUSED`, `DISPUTED`, `SUSPENDED`
`VAT_RATE_INCORRECT`	`REFUSED`, `DISPUTED`
`TOTAL_AMOUNT_INCORRECT`	`REFUSED`, `DISPUTED`
`CALCULATION_ERROR`	`REFUSED`, `DISPUTED`
`DUPLICATE_INVOICE`	`REFUSED`, `DISPUTED`
`DOUBLE_INVOICING`	`REFUSED`, `DISPUTED`
`CONTRACT_TERMINATED`	`REFUSED`, `DISPUTED`
`UNKNOWN_ISSUER`	`REFUSED`, `DISPUTED`
`SIRET_INCORRECT_OR_MISSING`	`DISPUTED`, `SUSPENDED`
`ROUTING_CODE_INCORRECT`	`DISPUTED`, `SUSPENDED`
`REFERENCE_INCORRECT`	`DISPUTED`, `SUSPENDED`
`BANK_DETAILS_INCORRECT`	`DISPUTED`, `SUSPENDED`
`QUANTITY_INCORRECT`	`DISPUTED`
`ITEM_INCORRECT`	`DISPUTED`
`ITEM_QUALITY_INSUFFICIENT`	`DISPUTED`
`DELIVERY_ISSUE`	`DISPUTED`
`PAYMENT_TERMS_INCORRECT`	`DISPUTED`
`UNIT_PRICE_INCORRECT`	`DISPUTED`
`DISCOUNT_INCORRECT`	`DISPUTED`
`OTHER`	`DISPUTED`
`MISSING_DOCUMENTS`	`SUSPENDED`