Réseau Peppol - Envoyer avec payload JSON

Lorsque votre connexion Peppol est activée, vous débloquez la capacité de transmettre des documents de manière fluide via ce réseau. Voyons le processus de création d’une facture à l’aide d’un payload JSON.

Créer une facture émise

Dans l’exemple ci-dessous, vous verrez comment générer une facture émise avec la méthode de livraison définie sur peppol.

Pour envoyer une facture via Peppol, assurez-vous que le Contact a transport_type_code défini sur peppol et fournissez pin_scheme et pin_value.

Exemple de requête

curl --request GET \
  --url https://api-staging.b2brouter.net/accounts/{ACCOUNT_ID}/invoices \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'Content-Type: application/json' \
  --data '{
     "send_after_import": false,
      "invoice": {
        "type": "IssuedInvoice",
        "number": "1",
        "date": "2024-01-21",
        "due_date": "2024-03-01",
        "terms": "custom",
        "buyer_reference": "071110000000-001-50",
        "payment_method": 58,
        "iban": "ES9815013231061668117743",
        "contact": {
            "name": "Voorbeeld B.V.",
            "address": "Kerkstraat 12", "postalcode": "1017 GM", "city": "Amsterdam",
            "country": "nl",
            "transport_type_code": "peppol",
            "pin_scheme": "{PIN_SCHEME}",   "pin_value": "{PIN_VALUE}"
          },
        "invoice_lines_attributes": [
          {
            "unit": 1,
            "quantity": 1,
            "price": 1,
            "description": "Description line",
            "taxes_attributes": [
              {
                "category": "S",
                "name": "VAT",
                "percent": 19
              }
            ]
          }
        ]
    }
  }'

En général, ces attributs sont les exigences minimales pour que Peppol puisse envoyer le document. Cependant, certains destinataires peuvent exiger des champs supplémentaires tels que buyer_reference, comme c’est le cas pour certaines mairies en Allemagne.

Lors de la génération de la facture, B2Brouter attribuera automatiquement le type de document le plus approprié pour le destinataire, si celui-ci a la capacité de recevoir des factures.

Créer une auto-facture

Pour créer une auto-facture (lorsque l’acheteur émet la facture au nom du fournisseur), définissez "type": "IssuedSelfInvoice" dans le payload de la facture. Consultez le guide Self-billing pour plus de détails.

Créer un avoir

Pour créer un avoir, utilisez les champs d’amendement ("is_credit_note": true, "amended_number", "amended_date", etc.) pour référencer la facture d’origine.

Pour les avoirs auto-facturés, combinez "type": "IssuedSelfInvoice" avec les champs d’amendement.

Envoyer la facture

L’étape suivante consiste à envoyer la facture. Avant l’envoi, en tant que Peppol Certified Service Provider, nous vérifions minutieusement la présence de toutes les données requises et la validité du document à l’aide des schématrons officiels avant transmission.

Si le document généré est valide, il est transmis via notre point d’accès.

Lien vers la référence API.

Exemple de requête :

curl --request POST \
  --url https://api-staging.b2brouter.net/invoices/send_invoice/{invoice-id} \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'Content-Type: application/json'

Suivre la facture

Enfin, vous pouvez vérifier les événements liés à la facture :

Exemple de requête :

curl --request GET \
  --url 'https://api-staging.b2brouter.net/accounts/{ACCOUNT_ID}/events?invoice_id={INVOICE_ID}' \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'Content-Type: application/json'