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ètreRequisDescription
numeroFactureSaisi
Type: string
RequisInvoice number.
dateFacture
Type: string
RequisInvoice date (YYYY-MM-DD).
cadreDeFacturation.codeCadreFacturation
Type: string
RequisInvoicing framework code (e.g., A1_FACTURE_FOURNISSEUR).
destinataire.codeDestinataire
Type: string
RequisRecipient SIRET.
fournisseur.idFournisseur
Type: number
RequisSupplier structure ID.
fournisseur.codeCoordonneesBancairesFournisseur
Type: number
RequisBank details code.
idUtilisateurCourant
Type: number
RequisCurrent user ID.
lignePoste
Type: array
RequisInvoice line items.
ligneTva
Type: array
RequisVAT lines.
modeDepot
Type: string
RequisDeposit mode (DEPOT_PDF_API, SAISIE_API).
montantTotal
Type: object
RequisTotal amounts.
pieceJointePrincipale
Type: array
OptionnelMain attached file (required for PDF mode).
references
Type: object
RequisInvoice 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êteRequisDescription
Content-Type
RequisContent type
Par défaut: application/json;charset=utf-8
Accept
RequisExpected response type
Par défaut: application/json;charset=utf-8

Réponses

Loading...