Einvoicing afnor api

De Wiki1000
Révision datée du 1 juillet 2026 à 13:29 par Flfay (discussion | contributions)
(diff) ← Version précédente | Voir la version actuelle (diff) | Version suivante → (diff)

Modèle:Version2026r1

Plateforme authentifiée

Menu d'accès :

Paramétrer une plateforme authentifiée (PA)

Renseigner l'url du endpoint api afnor.

Tip : Certaines implémentations positionnent la société dans l'endpoint, il est alors possible de surcharger la méthode TEInvoicingPDPAFNOR.getEndPoint pour contextualiser l'url.

Pour chaque société, on stocke la date du dernier flux récupéré, cette date est utilisée lors de la synchronisation pour obtenir seulement les flux non encore téléchargés.

Pour chaque société, il est possible de renseigner le champs OrganizationID, prévu par la norme AFNOR, qui sera placé dans les header http de chaque requête.

Il est également possible de surcharger la méthode TProcessusEinvoicingAFNOR.DSMOnCreateAFNORHttpClient(ahttpClient:THttpClient) afin d'ajouter d'autre headers spécifiques.


Paramétrer l'authentification

L'api AFNOR peut utiliser une authentification oAuth2. L'authentification est par utilisateur par défaut, mais il est possible de paramétrer un attribut de contexte d'authentification afin que le token soit propre à un contexte société (en plus de l'utilisateur).

Tip : Il est possible d'utiliser grant type oAuth2 "client_credentials" en laissant vide le champs EndPoint.
Attention : L'url cible doit être la même que cette paramétré dans la plateforme authentifiée.



Synchroniser les flux

Cet assistant permet de synchroniser les flux via l'api AFNOR (factures statuts, ereporting).

La synchronisation permet :

  • de mettre à jour l'état des flux envoyés
  • d'envoyer des flux
  • de recevoir des flux
  • de traiter les flux reçus
Attention : FRP1000 ne supporte que le format UBL. extrait de la norme : //Note 1 au 5.4.2 : le Fournisseur API peut permettre au Client API de configurer la règle suivante : l’ensemble des factures reçues en UBL sont converties en Factur-x, pour que ces conversions puissent être préparées en amont.


Tip : Par défaut, FRP1000 ne télécharge pas le lisible des factures, il est possible de le faire en surchargeant la méthode TProcessusTaskAFNOR.doGetReadable.



Tip : Cet assistant peut être planifié.

Consulter les flux

Types de flux

  • facture
  • statut
  • ereporting

Statuts

  • en attente : le flux est envoyé, son statut sera mis à jour lors de la synchronisation suivante
  • succès : le flux est bien reçu ou bien envoyé
  • erreur : le flux envoyé a été refusé par la PA ou bien le traitement du flux reçu a provoqué une erreur, un message d'erreur est lié au flux
  • non traité : le flux reçu n'a pas été traité (flux non reconnu ou bien la société de gère pas la réception de facture)