submit_lifecycle_status
Emit lifecycle statuses (Refused, Approved, Cashed, etc.) on received invoices for French electronic invoicing compliance. Builds a CDAR document and requires user confirmation for execution.
Instructions
Emit a processing status on a received invoice: Refused, Approved, PartiallyApproved, Disputed, Suspended, Cashed, PaymentTransmitted, Cancelled. Refused and Cashed are mandatory transmissions to PPF. Reason is mandatory for Refused, Disputed, PartiallyApproved, and Suspended.
Builds a real CDAR (CrossDomainAcknowledgementAndResponse, XP Z12-014 v1.4) document — see mcp_facture_electronique_fr.clients.flow_client for the MDT-* field mapping this depends on.
HUMAN-IN-THE-LOOP: Requires user confirmation. Call without confirmation_token first, show the summary to the user, then call again with the token.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| reason | No | Status reason (CDAR MDT-114), mandatory per XP Z12-014 Annex A for Refused, Disputed, PartiallyApproved, and Suspended. Free text. | |
| currency | No | ISO 4217 currency code for payment_amount (default EUR). | EUR |
| invoice_id | Yes | BT-1 invoice number of the referenced invoice (CDAR MDT-87). | |
| reason_code | No | Coded reason (CDAR MDT-113) from the per-status motif list in XP Z12-014 Annex A 'Tableau des motifs de STATUTS' (e.g. TX_TVA_ERR, DOUBLON). Not validated against that list. | |
| status_code | Yes | Lifecycle status code to emit. Values defined in XP Z12-014 v1.4 (June 2026): Refused (transmitted to PPF), Approved, PartiallyApproved, Disputed, Suspended, Cashed (transmitted to PPF), PaymentTransmitted, Cancelled. Refused and Cashed are mandatory transmissions to PPF. | |
| payment_date | No | Payment date (ISO 8601 format: YYYY-MM-DD). Provided for Cashed and PaymentTransmitted statuses. | |
| included_note | No | Free-text note (CDAR IncludedNote/Content) per the bundled Rejetee worked example. | |
| recipient_uri | No | Counterparty's electronic address on the CEF network, if known (CDAR MDT-73). | |
| payment_amount | No | Payment amount (decimal string, e.g. '1250.00'). Provided for Cashed and PaymentTransmitted statuses. | |
| issuer_party_id | Yes | GlobalID (e.g. SIREN) of the party emitting this status — you or the counterparty, whichever this MCP server acts on behalf of (CDAR MDT-38). | |
| party_id_scheme | No | schemeID attribute shared by both party GlobalIDs (default '0002' = SIRENE, per every bundled AFNOR worked example). | 0002 |
| issuer_role_code | Yes | Role of the emitting party: SE (seller) or BY (buyer) (CDAR MDT-40). | |
| receipt_datetime | No | Original receipt timestamp of the referenced invoice, ISO 8601 (CDAR MDT-95). Defaults to the current time if omitted — supply the real value when known for an accurate audit trail. | |
| requested_action | No | Free-text requested action (CDAR MDT-122). | |
| invoice_type_code | No | BT-3 invoice type code (CDAR MDT-91, default '380' = Invoice). | 380 |
| issuer_party_name | Yes | Name of the emitting party (CDAR MDT-39). | |
| confirmation_token | No | Confirmation token from a previous call. Omit on the first call; supply on the second call to execute. | |
| invoice_issue_date | Yes | BT-2 invoice date, ISO 8601 (YYYY-MM-DD) (CDAR MDT-100). | |
| recipient_party_id | Yes | GlobalID of the counterparty receiving this status (CDAR MDT-57). | |
| referenced_flow_id | Yes | Identifier of the invoice flow to which this status applies (flowId returned upon receipt, maxLength 36). Used only for the platform's own flow tracking (flowInfo.trackingId) — not part of the CDAR document content. | |
| recipient_role_code | Yes | Role of the counterparty — opposite of issuer_role_code (CDAR MDT-59). | |
| recipient_party_name | Yes | Name of the counterparty (CDAR MDT-58). | |
| requested_action_code | No | Coded requested action (CDAR MDT-121), e.g. 'CNF' ('Créer un Avoir total') per the bundled En_litige worked example. Typically used with Disputed. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||