# Autofatture (https://docs.getbeel.com/it/api/autofatture)

Leggi un'autofattura in reverse charge (TD17, TD18, TD19) e inviala allo SdI, esattamente come il pulsante Invia allo SdI.

Un'autofattura è il documento che invii allo SdI per un acquisto da un fornitore estero (reverse charge): **TD17** per servizi dall'estero, **TD18** per beni da un altro paese UE, **TD19** per beni già in Italia. getbeel le propone e le genera dai tuoi addebiti bancari, dall'import Autofatture e dalle fatture estere che ricevi. L'id è quello della pagina Autofatture (la transazione bancaria a cui appartiene).

La lettura richiede `invoices:read` (entrambe le modalità di chiave). L'invio richiede `invoices:write` e una **chiave live**: è un atto fiscale reale.

## Leggere un'autofattura [#leggere-unautofattura]

```bash
curl "https://www.getbeel.com/api/v1/autofatture/$AUTOFATTURA_ID" \
  -H "Authorization: Bearer $GETBEEL_API_KEY"
```

```json title="Risposta"
{
  "id": "9ea93ca3-fb8b-4ac3-b991-bdec63081696",
  "object": "autofattura",
  "date": "2026-11-02",
  "supplier": "Vercel Inc.",
  "supplier_country": "US",
  "supplier_invoice_number": "INV-1102",
  "amount": "-20.00",
  "currency": "USD",
  "tipo_documento": "TD17",
  "numero": "AF-2026-7",
  "status": "generated",
  "xml_ready": true,
  "sdi": { "status": null, "id": null, "error": null, "updated_at": null }
}
```

`status` è l'XML: `generated` vuol dire pronta da inviare. `sdi.status` è `null` finché non la invii, poi `queued`, `sending`, `sent_to_sdi` e la risposta dello SdI: `consegnata`, `non_consegnata`, `scartata` (con `sdi.error`).

## Inviarla allo SdI [#inviarla-allo-sdi]

```bash
curl -X POST "https://www.getbeel.com/api/v1/autofatture/$AUTOFATTURA_ID/send" \
  -H "Authorization: Bearer $GETBEEL_API_KEY"
```

Fa gli stessi passaggi del pulsante **Invia allo SdI** della pagina Autofatture:

- l'XML deve essere generato (altrimenti `409 autofattura_xml_missing` o `autofattura_not_generated`);
- l'invio si paga dal credito prepagato al prezzo dell'invio SdI (vedi [Prezzi](/it/api/pricing)). Se il credito non basta la risposta è `402 insufficient_balance` ([Errori](/it/api/errors#insufficient_balance)) e non viene inviato nulla;
- viene messa in coda: la risposta è l'autofattura con `sdi.status: "queued"`. Rileggila più tardi per la risposta dello SdI.

**Si può ripetere senza rischi.** Una seconda chiamata non invia e non addebita di nuovo: `409 autofattura_already_queued` mentre è in viaggio, `409 autofattura_already_sent` quando lo SdI l'ha presa. Un reinvio corretto dopo uno scarto non viene addebitato di nuovo. Altri rifiuti: `409 sdi_monthly_cap_reached` (il limite mensile degli invii live), `409 sdi_not_available` (un account ancora su un piano precedente senza il servizio SDI), `404 resource_missing`, `403 livemode_required` con una chiave di test.

I tool MCP `get_autofattura` e `send_autofattura_to_sdi` fanno lo stesso (vedi [MCP](/it/api/mcp)).
