API et Chorus

Bonjour SupportSV​ 

L'endpoint /api/external/v2/customer_invoices/import sert à importer une facture déjà générée en PDF par un système tiers dans Pennylane. Aucun champ structuré de cet endpoint ne transporte de données Chorus Pro (SIRET destinataire, code service, numéro d'engagement, numéro de marché, mandataire) — ces informations ne font pas partie du payload JSON documenté.

Point important : les factures importées (via ce endpoint /import, PDF externe) ne sont prises en charge par l'intégration Chorus Pro que si elles respectent le format structuré Factur-X. Une facture PDF "classique" poussée par cette API ne pourra donc pas être automatiquement détectée/traitée pour un dépôt Chorus Pro tant qu'elle n'est pas au format Factur-X.

Même pour une facture prise en charge, les données Chorus Pro doivent être renseignées séparément :
• le numéro SIREN du client, sur la fiche client (sinon il faut le compléter manuellement via le champ "Identification fiscale" dans Pennylane Connect) ;
• les autres données (SIRET, service, engagement, marché, mandataire) dans les champs libres / mentions spéciales de la facture, avec une syntaxe précise pour permettre leur détection automatique : SIRET : XXXXX, Service : XXXXX, N° engagement : XXXXX, N° marché : XXXXX, Mandataire : XXXXX.

Enfin, la connexion Chorus Pro ne déclenche jamais de dépôt automatique, qu'il s'agisse d'une facture créée dans Pennylane ou importée via l'API : le dépôt doit être vérifié et validé manuellement depuis Pennylane Connect ("Vérifier & déposer"). À noter que cette intégration Chorus Pro via Pennylane Connect ne sera plus supportée à partir du 1er septembre 2026, dans le cadre de la réforme de la facturation électronique.