Aller au contenu

Documentation

Quatre interfaces. Un même contrat d’exécution.

Commencez dans le navigateur, passez à l’API pour les workflows serveur, puis automatisez avec la CLI ou GitHub Action.

Démarrage API

Authentifiez. Vérifiez. Lancez le run.

Commencez par une lecture autorisée avant toute création. Si une création reste incertaine, réconciliez l’historique avant de réessayer.

  1. 01

    Créer un identifiant machine

    Developer API · jeton CI / serveur

  2. 02

    Vérifier l’accès projet

    Bearer · organisation autorisée

  3. 03

    Créer un run

    Exécution versionnée · suivre run_id

Vérifier l’accès APIGET /projects
export INVOICERIG_API_ORIGIN='https://YOUR-INVOICERIG-APP-HOST'
export INVOICERIG_TOKEN='***secret manager***'
export INVOICERIG_ORGANIZATION_ID='00000000-0000-0000-0000-000000000000'

curl --fail-with-body \
  -H "Authorization: Bearer $INVOICERIG_TOKEN" \
  -H 'Accept: application/json' \
  "$INVOICERIG_API_ORIGIN/v1/organizations/$INVOICERIG_ORGANIZATION_ID/projects"
Conservez le jeton dans votre gestionnaire de secrets ; ne le placez jamais dans le dépôt.

Interfaces

Utilisez la surface adaptée au travail.

Le mode d’accès change. Le modèle d’exécution et la frontière de preuve restent les mêmes.

Navigateur hébergé

diagnostic interactif

Connectez-vous, choisissez organisation/projet, lancez une validation, consultez l’historique et exportez des preuves partageables.

API

workflows serveur bornés

Les jetons machine liés à l’organisation servent aux workflows serveur bornés. Réconciliez l’historique avant de rejouer une création incertaine.

CLI et GitHub Action

automatisation locale / dépôt

Utilisez les sorties locales normalisées et une automatisation sans fournisseur par défaut ; l’accès sandbox reste explicitement gardé.

Référence du contrat

Ce qui reste stable d’une interface à l’autre.

Formats
UBL, CII et Factur-X
L’exécution locale couvre les profils versionnés UBL 2.1, CII D16B et Factur-X 1.09.2 ; l’import hébergé apparaît seulement lorsque l’import chiffré est disponible.
Validation
EN 16931 et règles France
Syntaxe, EN 16931 et contrôles France restent des couches de validation ordonnées et versionnées.
Sandbox
Preuves de sandbox fournisseur
Les observations Iopole et WeInvoice restent séparées du résultat de conformité locale.

Étape suivante

Commencez dans le navigateur, automatisez ensuite.

Passez ensuite à Developer API pour vos workflows serveur ou CI.