submit_transaction_report
Submit transaction e-reporting flows for international B2B sales and purchases, as well as B2C individual and aggregated reports, to the French DGFiP platform.
Instructions
Submit a DGFiP Flux 10.1 / 10.3 transaction e-reporting flow.
Scope: Compatible Solution (CS) mode, no payload validation. See README "Scope" section.
Builds a FRR XML payload conforming to DGFiP Spécifications Externes v3.2 (transaction.xsd / ereporting.xsd) and submits it to the Approved Platform via POST /v1/flows with flowSyntax="FRR".
Use for:
International B2B outbound sales (processing_rule=B2BInt, flow_type=IndividualCustomerTransactionReport)
International B2B inbound purchases (processing_rule=B2BInt, flow_type=UnitarySupplierTransactionReport)
B2C individual transactions (processing_rule=B2C, flow_type=IndividualCustomerTransactionReport)
Aggregated B2C reports (processing_rule=B2C, flow_type=AggregatedCustomerTransactionReport)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| flow_type | Yes | XP Z12-013 FlowType for this e-reporting submission: IndividualCustomerTransactionReport — Flux 10.1 individual B2C or intl B2B AggregatedCustomerTransactionReport — Flux 10.3 aggregated B2C UnitarySupplierTransactionReport — Flux 10.1 intl B2B purchases MultiFlowReport — mixed flow types | |
| issuer_id | Yes | TT-13: SIREN or SIRET of the French taxable entity (déclarant). | |
| sender_id | Yes | TT-8: Identifier of the CS/PDP platform submitting the report. | |
| type_code | Yes | TT-4: Transmission type code, e.g. '380' (invoice report). | |
| period_end | Yes | TT-18: Report period end date in ISO 8601 format (e.g. '2025-01-31'). | |
| issuer_name | Yes | TT-14: Legal name of the declarant. | |
| sender_name | Yes | TT-9: Legal name of the sender platform. | |
| tracking_id | No | Optional external tracking identifier for this flow. | |
| period_start | Yes | TT-17: Report period start date in ISO 8601 format (e.g. '2025-01-01'). | |
| invoices_json | Yes | JSON array of invoice transaction records. Each invoice in the `invoices` JSON list must have: Required fields: id TT-19 Invoice number / identifier issue_date TT-20 Issue date (ISO 8601, e.g. "2025-01-15") type_code TT-21 Invoice type: "380" (invoice), "381" (credit note), "389" (self-billed) currency_code TT-22 ISO 4217 currency code (e.g. "EUR", "USD") business_process_id TT-28 Business process ID (e.g. "A1", "A2") business_process_type_id TT-29 Process type: "EREP" (e-reporting), "EINV" (e-invoicing) seller_company_id TT-33 Seller identifier (SIREN, SIRET, VAT number, etc.) seller_company_id_scheme TT-33-1 Scheme: "SIREN", "SIRET", "0088" (GLN), "TVA", etc. monetary_total_tax_amount TT-52 Total VAT amount (decimal string, e.g. "200.00") monetary_total_currency TT-202 Currency code for the tax amount (e.g. "EUR") tax_subtotals TT-54..59 List of VAT breakdown objects (see below) Optional fields: due_date TT-201 Payment due date (ISO 8601) tax_due_date_type_code TT-24 VAT due date code ("3" cash, "4" invoice date, "5" delivery) tax_exclusive_amount TT-51 Total amount excluding VAT seller_tax_registration_id TT-34 Seller VAT number (e.g. "FR12345678901") seller_tax_registration_id_qualifier TT-34-0 Qualifier (default "VA") seller_country TT-35 ISO 3166-1 alpha-2 country code buyer_company_id TT-36 Buyer identifier (for international B2B) buyer_company_id_scheme TT-37 Buyer ID scheme buyer_tax_registration_id TT-38 Buyer VAT number buyer_tax_registration_id_qualifier TT-38-0 Qualifier (default "VA") buyer_country TT-39 Buyer country code tax_subtotals list entries: taxable_amount TT-54 Tax base amount (decimal string) tax_amount TT-55 VAT amount for this category (decimal string) tax_percent TT-57 VAT rate (decimal, e.g. "20.0", "5.5", "0.0") code TT-56 (optional) VAT category code: "S" standard, "Z" zero, "E" exempt exemption_reason TT-58 (optional) Exemption reason text exemption_reason_code TT-59 (optional) Exemption reason code — free-form, not enforced by this server; see VATEX_CODES_EU and VATEX_CODES_FR (NF XP Z12-012 Annex A v1.4, June 2026) for the accepted code list | |
| issue_datetime | Yes | TT-3: Transmission creation timestamp, e.g. '20250115T120000+0100'. | |
| processing_rule | Yes | XP Z12-013 ProcessingRule: B2BInt — international B2B e-reporting B2C — B2C e-reporting | |
| transmission_id | Yes | TT-1: Unique identifier for this transmission (generated by sender). | |
| issuer_id_scheme | Yes | TT-12: ID scheme for issuer, typically 'SIREN' or 'SIRET'. | |
| issuer_role_code | Yes | TT-15: Issuer role code. Use 'MOA' (assujetti / declarant) or 'OD' (obligataire délégant). | |
| sender_id_scheme | Yes | TT-7: ID scheme for sender, e.g. 'SIREN', 'SIRET', 'TVA', '0088'. | |
| sender_role_code | Yes | TT-10: Sender role code. Use 'CS' (Compatible Solution), 'PDP', 'OD' (obligataire délégant), or 'MOA' (assujetti). | |
| transmission_name | No | TT-2: Optional human-readable name for the transmission. | |
| confirmation_token | No | Confirmation token returned by a prior pending response. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||