Communauté gestion

Forum Discussion

Avatar de SupportSV
SupportSV
Icône pour le rang Première notePremière note
il y a 28 jours
Répondu

API et Chorus

Bonjour,

Les factures B2G étaient déposées directement sur Chorus Pro avant.
Que faut-il faire de particulier pour que le dépôt de facture Chorus pro fonctionne avec l'api

https://app.pennylane.com/api/external/v2/customer_invoices/import

Merci

 

 

  • Bonjour DavidB​ 

    Concrètement, à partir de cette date, l'intégration Chorus Pro via Pennylane Connect n'est plus mise à jour, mais elle reste disponible temporairement, le temps que l'ensemble des fonctionnalités concernées soit intégré nativement dans l'application Pennylane.

9 Réponses

  • Avatar de Sabrina_AB
    Sabrina_AB
    Icône pour le rang Batteur de mesureBatteur de mesure

    Bonjour,

    Je venais également m'enquérir de la marche à suivre suite à la mise en place de la facturation électronique. Quelles sont les possibilités ?
    - Directement depuis Pennylane (mais compliqué avec les multiples codes service) ?
    - Via Pennylane Connect / Billy (mais tous les profils n'y ont pas accès quand bien même ils sont habilités à facturer) ?
    - Sur Chorus ?

    Merci

  • 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.

    • Avatar de DavidB
      DavidB
      Icône pour le rang Parolier noviceParolier novice

      Bonjour Angélique_​ ,

      Qu'entends-tu par ta dernière phrase,
      "À 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" ?

      • Avatar de Angélique_
        Angélique_
        Icône pour le rang PennylaneurPennylaneur

        Bonjour DavidB​ 

        Concrètement, à partir de cette date, l'intégration Chorus Pro via Pennylane Connect n'est plus mise à jour, mais elle reste disponible temporairement, le temps que l'ensemble des fonctionnalités concernées soit intégré nativement dans l'application Pennylane.

  • Le client vient de créer son compte pennylane. Rien n'a été fait de particulier concernant chorus sur son compte (donc pas d'utilisation de Pennylane Connect) . Est-ce qu'il y a quelque chose à faire dans le paramétrage du compte ?

     

    Notre logiciel dépose ses factures au format Factur-X via l'API/

    Dans les fichiers PDF que nous déposons ,   les données service / engagement  / marché sont présent en respectant la règle suivante :

    numéro de marché
    BT-12
    ram:ContractReferencedDocument avec TypeCode = BC

    Code service / Service exécutant
    BT-10
    ram:BuyerReference

    N° engagement juridique / commande
    BT-13
    ram:BuyerOrderReferencedDocument
    /ram:IssuerAssignedID

    SIRET acheteur
    BT-47
    ram:SpecifiedLegalOrganization/ram:ID

    Identifiant d'adressage électrionique de l'acheteur
    BT-49
    ram:BuyerTradeParty
    /ram:URIUniversalCommunication/ram:URIID

    Donc si je comprends ce n'est pas suffisant puis que vous indiquez :

    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.

     

    Quels sont les noeuds Xml à renseigner  ?

     

    Merci

    • Avatar de Angélique_
      Angélique_
      Icône pour le rang PennylaneurPennylaneur

      Bonjour SupportSV​ 

      La nomenclature « SIRET : XXXXX », « Service : XXXXX », « N° engagement : XXXXX », « N° marché : XXXXX », « Mandataire : XXXXX » documentée par Pennylane est un texte libre à saisir sur la facture (mentions spéciales / champ de texte libre), que Pennylane détecte ensuite automatiquement pour en déduire les données Chorus Pro.

      Ce mécanisme repose sur l'analyse de ce champ de texte libre de la facture, et non sur des nœuds XML dédiés et distincts pour chacune des cinq données.

    • Avatar de DidL73
      DidL73
      Icône pour le rang Parolier noviceParolier novice

      le champ bt-13 BuyerOrderReferencedDocument est activable dans le modèle de facture dans contenu "n° de commande".