POST/cpro/factures/v1/soumettre

Submit PDF invoice

Submit an invoice with a PDF attachment. The invoice must reference a previously uploaded file.

Multiple Authentication Required

ALL REQUIRED

This endpoint requires all of the following authentication methods:

Bearer Token

OAuth2 Bearer token

Custom Header

Chorus Pro account credentials

Required Header

cpro-account: base64(login:password)

How to authenticate

Include your Bearer token in the Authorization header:

Authorization: Bearer YOUR_API_TOKEN

You can obtain your API token from your account dashboard.

How to authenticate

Include the custom header in your request:

cpro-account: base64(login:password)

Body Parameters

Parameter	Required	Description
numeroFactureSaisi Type: string	Required	Invoice number.
dateFacture Type: string	Required	Invoice date (YYYY-MM-DD).
cadreDeFacturation.codeCadreFacturation Type: string	Required	Invoicing framework code (e.g., A1_FACTURE_FOURNISSEUR).
destinataire.codeDestinataire Type: string	Required	Recipient SIRET.
fournisseur.idFournisseur Type: number	Required	Supplier structure ID.
fournisseur.codeCoordonneesBancairesFournisseur Type: number	Required	Bank details code.
idUtilisateurCourant Type: number	Required	Current user ID.
lignePoste Type: array	Required	Invoice line items.
ligneTva Type: array	Required	VAT lines.
modeDepot Type: string	Required	Deposit mode (DEPOT_PDF_API, SAISIE_API).
montantTotal Type: object	Required	Total amounts.
pieceJointePrincipale Type: array	Optional	Main attached file (required for PDF mode).
references Type: object	Required	Invoice references (currency, payment method, etc.).

Example Request Body

{
  "numeroFactureSaisi": "F333",
  "dateFacture": "2025-11-05",
  "cadreDeFacturation": {
    "codeCadreFacturation": "A1_FACTURE_FOURNISSEUR"
  },
  "destinataire": {
    "codeDestinataire": "19672337516762"
  },
  "fournisseur": {
    "codeCoordonneesBancairesFournisseur": 144050,
    "idFournisseur": 26262962
  },
  "idUtilisateurCourant": 65336344681929,
  "lignePoste": [
    {
      "lignePosteDenomination": "Licence",
      "lignePosteMontantRemiseHT": 0,
      "lignePosteMontantUnitaireHT": 16.6667,
      "lignePosteNumero": 1,
      "lignePosteQuantite": 1,
      "lignePosteReference": "votil_licence",
      "lignePosteTauxTvaManuel": 20,
      "lignePosteUnite": "licence"
    }
  ],
  "ligneTva": [
    {
      "ligneTvaMontantBaseHtParTaux": 16.6667,
      "ligneTvaMontantTvaParTaux": 3.3333,
      "ligneTvaTauxManuel": 20
    }
  ],
  "modeDepot": "DEPOT_PDF_API",
  "montantTotal": {
    "montantAPayer": 20,
    "montantHtTotal": 16.6667,
    "montantRemiseGlobaleTTC": 0,
    "montantTVA": 3.3333,
    "montantTtcTotal": 20
  },
  "pieceJointePrincipale": [
    {
      "pieceJointePrincipaleDesignation": "Facture",
      "pieceJointePrincipaleId": 10321512
    }
  ],
  "references": {
    "deviseFacture": "EUR",
    "modePaiement": "VIREMENT",
    "typeFacture": "FACTURE",
    "typeTva": "TVA_SUR_ENCAISSEMENT"
  }
}

Headers

Header	Required	Description
Content-Type	Required	Content type Default: application/json;charset=utf-8
Accept	Required	Expected response type Default: application/json;charset=utf-8

Responses

Loading code panel...