Skip to main content
Download OpenAPI

Send an invoice

The outbound invoicing module allows your system to transmit invoices to French customers (B2B and B2G) while simultaneously fulfilling state tax reporting requirements. The communication workflow is split into two distinct operational parts: an initial asynchronous submission followed by continuous status monitoring.

Submission and Detail Retrieval​

To send an invoice, you must forward the structured file content to A-Cube. The platform validates the payload synchronously and responds immediately with a unique identifier (uuid). This ID is a critical piece of data; it must be stored in your database to fetch the current invoice layout, details, and historic processing state.

  • Submit an Outbound Invoice: POST /invoices
  • Fetch Invoice Details: GET /invoices/{uuid}

Sample Submission Response (201 Created)​

{
  "uuid": "{uuid of the invoice}",
  "direction": "OUTBOUND",
  "status": "SUBMITTED",
  "invoiceTypeCode": "380",
  "invoiceNumber": "F202500001",
  "invoiceDate": "2025-02-01",
  "dueDate": "2025-03-03",
  "party": {
    "name": "LE VENDEUR",
    "siren": "324730001",
    "siret": null,
    "identifierScheme": "0225",
    "identifierValue": "324730001"
  },
  "counterparty": {
    "name": "LE CLIENT",
    "siren": "931536429",
    "siret": null,
    "identifierScheme": "0225",
    "identifierValue": "931536429"
  },
  "createdAt": "2026-06-17T07:40:15+00:00",
  "updatedAt": "2026-06-17T07:40:15+00:00"
}

Sample Lifecycle Webhook Payload​

{
  "eventId": "019ea765-da8a-70af-a037-b068ad1ff1ce",
  "eventType": "invoice.status",
  "status": "205",
  "invoiceUuid": "019ea760-dad8-70b9-9b23-f60ff4004509",
  "direction": "OUTBOUND",
  "statusLabel" : "{description of the new status}"
}

Configure your webhook handlers to catch these states automatically. This ensures your application's user interface can display when an invoice is accepted by the state, currently in dispute, or successfully settled without requiring manual calls.

Last updated on