Émettre une facture simplifiée (ticket)

Une facture simplifiée (ticket) est un document de vente léger généralement remis sous forme de PDF. Il n’existe pas de norme XML universelle pour les tickets ; pour les intégrations, l’approche recommandée consiste donc à travailler avec JSON et laisser B2Brouter générer le PDF.

Utilisez "type": "IssuedSimplifiedInvoice" pour créer une facture simplifiée.

Créer la facture simplifiée

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": "IssuedSimplifiedInvoice",
      "number": "T-2026-0001",
      "date": "2026-01-21",
      "currency": "EUR",
      "file_reference": "POS-ORDER-12345",
      "contact": {
        "name": "Final consumer",
        "country": "es"
      },
      "invoice_lines_attributes": [
        {
          "quantity": 1,
          "price": 10,
          "description": "Coffee",
          "taxes_attributes": [
            {
              "name": "VAT",
              "percent": 21,
              "category": "S"
            }
          ]
        }
      ]
    }
  }'

Exemple de réponse (extrait)

{
  "invoice": {
    "id": 123456,
    "type": "IssuedSimplifiedInvoice",
    "number": "T-2026-0001",
    "state": "new",
    "file_reference": "POS-ORDER-12345",
    "document_type_code": "pdf.invoice"
  }
}

Envoyer la facture simplifiée (générer le PDF)

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}'

Télécharger le PDF

curl --request GET \
  --url 'https://api-staging.b2brouter.net/invoices/{INVOICE_ID}/as/pdf.invoice?download=true' \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}'

Remarques

Utilisez file_reference pour stocker votre propre référence interne (ID de commande, ID de ticket, ID de transaction POS, etc.) et faciliter le rapprochement.
Si vous souhaitez que B2Brouter envoie le PDF par e-mail, définissez contact_email_override sur la facture avant de créer la facture ou d’appeler POST /invoices/send_invoice/{INVOICE_ID}.
Pour lister les factures simplifiées : GET /accounts/{ACCOUNT_ID}/invoices?type=IssuedSimplifiedInvoice