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

ParameterRequiredDescription
numeroFactureSaisi
Type: string
RequiredInvoice number.
dateFacture
Type: string
RequiredInvoice date (YYYY-MM-DD).
cadreDeFacturation.codeCadreFacturation
Type: string
RequiredInvoicing framework code (e.g., A1_FACTURE_FOURNISSEUR).
destinataire.codeDestinataire
Type: string
RequiredRecipient SIRET.
fournisseur.idFournisseur
Type: number
RequiredSupplier structure ID.
fournisseur.codeCoordonneesBancairesFournisseur
Type: number
RequiredBank details code.
idUtilisateurCourant
Type: number
RequiredCurrent user ID.
lignePoste
Type: array
RequiredInvoice line items.
ligneTva
Type: array
RequiredVAT lines.
modeDepot
Type: string
RequiredDeposit mode (DEPOT_PDF_API, SAISIE_API).
montantTotal
Type: object
RequiredTotal amounts.
pieceJointePrincipale
Type: array
OptionalMain attached file (required for PDF mode).
references
Type: object
RequiredInvoice 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

HeaderRequiredDescription
Content-Type
RequiredContent type
Default: application/json;charset=utf-8
Accept
RequiredExpected response type
Default: application/json;charset=utf-8

Responses

Loading...