Send invoice via SDI

Quick recipe to issue an invoice to the SDI (Sistema di Interscambio) with the B2Brouter API: account → contact → invoice → status.

Full guide

This page is only a summary. For all the details (recipient identification, B2B/B2C/B2G, VAT nature codes, regime fiscale, autofattura, credit/debit notes, bollo, ritenuta, reception…), see the SDI (FatturaPA) guide.

1. Create the Italian company account

curl --request POST \
  --url https://api-staging.b2brouter.net/accounts \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'content-type: application/json' \
  --data '{
    "account": {
      "country": "it",
      "tin_value": "20339260422",
      "tin_scheme": 211,
      "name": "Test Sender Italy",
      "address": "Milano street, 1",
      "city": "Milano",
      "postalcode": "20019",
      "province": "MI",
      "tax_regime": "RF01"
    }
  }'

2. Create the customer contact

transport_type_code: it.sdi, document_type_code: xml.fatturapa.1.2, the Partita IVA with tin_scheme: 9906 (or the Codice Fiscale with cin_scheme: 9907), and the Codice Destinatario in recipient_code (if there is none, 0000000).

curl --request POST \
  --url https://api-staging.b2brouter.net/accounts/{ACCOUNT_ID}/contacts \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'content-type: application/json' \
  --data '{
    "contact": {
      "tin_scheme": "9906",
      "tin_value": "IT12345678901",
      "name": "Esempio S.r.l.",
      "address": "Via Inventata 88",
      "postalcode": "00184",
      "city": "Roma",
      "province": "RM",
      "country": "it",
      "transport_type_code": "it.sdi",
      "document_type_code": "xml.fatturapa.1.2",
      "recipient_code": "{CODICE_DESTINATARIO}"
    }
  }'

3. Create and send the invoice

With send_after_import: true the invoice is sent to the SDI directly.

curl --request POST \
  --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": true,
    "invoice": {
      "type": "IssuedInvoice",
      "number": "1",
      "date": "2025-01-22",
      "contact_id": {YOUR_CONTACT_ID},
      "invoice_lines_attributes": [
        {
          "quantity": 10,
          "price": 47,
          "description": "Test Item",
          "taxes_attributes": [{ "name": "IVA", "percent": 22 }]
        }
      ]
    }
  }'

4. Check the status

curl --request GET \
  --url 'https://api-staging.b2brouter.net/invoices/{INVOICE_ID}' \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'accept: application/json'

The invoice goes through sending → sent; if the SDI rejects it, it moves to error. See Checking the invoice status for the details and the acknowledge step.