POST/cpro/factures/v1/soumettre

Soumettre une facture PDF

Soumettre une facture avec une pièce jointe PDF. La facture doit référencer un fichier préalablement téléchargé.

Authentification multiple requise

TOUTES REQUISES

Ce point de terminaison nécessite toutes les méthodes d'authentification suivantes :

Token Bearer

OAuth2 Bearer token

En-tête personnalisé

Chorus Pro account credentials

En-tête requis

cpro-account: base64(login:password)

Comment s'authentifier

Incluez votre token Bearer dans l'en-tête Authorization :

Authorization: Bearer YOUR_API_TOKEN

Vous pouvez obtenir votre token API depuis votre tableau de bord.

Comment s'authentifier

Incluez l'en-tête personnalisé dans votre requête :

cpro-account: base64(login:password)

Paramètres du corps

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

Exemple de corps de requête

{
  "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"
  }
}

En-têtes

En-tête	Requis	Description
Content-Type	Requis	Content type Par défaut: application/json;charset=utf-8
Accept	Requis	Expected response type Par défaut: application/json;charset=utf-8

Réponses

Loading code panel...