Introduction

Good news for Cdiscount sellers: order invoice upload is now available via API.

Sellers can now submit invoice documents directly to Octopia/Cdiscount so they can be attached to customer orders and made available at order level. Invoices can be uploaded for a single order or in bulk for multiple orders.

What changed?

Sellers can now:

• upload invoice documents for a specific order
• upload multiple invoice files in bulk
• track invoice import processing through dedicated status endpoints
• replace an existing invoice by uploading a new one

The API supports:

• PDF files
• XML files in UBL 2.1 format
• ZIP archives containing supported invoice files

Invoice processing is asynchronous. A 201 Created response confirms that the upload request has been accepted, while the final processing result must be checked through the import status endpoints.

Example

A seller can now upload an invoice for a single order using the dedicated order endpoint:

POST /orders/{orderId}/invoice-documents

The API immediately returns an import report with an importId and a Running status, meaning the file has been accepted for asynchronous processing.

A seller can also upload several invoices at once using the bulk endpoint:

POST /order-invoice-imports

Once the upload is accepted, the seller can track processing results using:

• GET /order-invoice-imports
• GET /order-invoice-imports/{importId}

This allows sellers to check whether an import is still Running, fully Success, PartialSuccess, or Failure, and identify which files need to be corrected and resubmitted.

Why it matters

This new feature makes invoice submission easier to automate in seller systems such as ERP, OMS, or invoicing tools.

It also gives sellers better visibility on invoice processing and simplifies correction flows when an invoice needs to be re-uploaded.