Integrazione Zucchetti: dati da fatture, DDT e ordini scritti direttamente nel gestionale

Cerchi un'integrazione Zucchetti che porti i dati di fatture, DDT e ordini nel gestionale senza data entry manuale? Data Alchemy estrae i dati dai tuoi documenti con l'AI, li valida sull'anagrafica e li scrive in Zucchetti in circa 3 secondi tramite REST API, webhook e query SQL.

Metodi di integrazione Zucchetti supportati

I dati estratti raggiungono Zucchetti attraverso il canale più adatto alla tua installazione, senza dover sviluppare connettori da zero.

API Zucchetti: endpoint, payload JSON e mappatura dei campi

Il flusso è lo stesso dell'API di estrazione dati di Data Alchemy: invii il documento con una POST indicando erp_target=zucchetti e ricevi il JSON strutturato — via webhook o con una GET su /v1/documents/{id} — già validato sull'anagrafica di Zucchetti e pronto da scrivere nel gestionale.

curl -X POST https://api.data-alchemy.ai/v1/documents \
  -H "Authorization: Bearer $DATA_ALCHEMY_API_KEY" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@fattura.pdf" \
  -F "document_type=invoice" \
  -F "erp_target=zucchetti"

{
  "event": "document.processed",
  "id": "doc_8a7f2c91",
  "status": "completed",
  "erp_target": "zucchetti",
  "data": {
    "header": {
      "supplier": {
        "name": "Rossi Forniture S.r.l.",
        "vat_number": "IT01234567890"
      },
      "invoice_number": "2026/00417",
      "issue_date": "2026-05-28"
    },
    "line_items": [
      {
        "sku": "ART-0042",
        "quantity": 12,
        "unit_price": 8.50,
        "vat_rate": 22
      }
    ],
    "totals": { "net": 102.00, "vat": 22.44, "gross": 124.44 },
    "validation": { "status": "validated", "erp_match": true }
  }
}

Webhook: scrittura in Zucchetti senza polling

Registra il tuo endpoint con una POST su /v1/webhooks e riceverai l'evento document.processed appena l'estrazione è completa, senza interrogare l'API a intervalli. Ogni richiesta è firmata con HMAC SHA-256 nell'header X-Data-Alchemy-Signature: verifica la firma prima di scrivere il record in Zucchetti. Se il tuo endpoint è irraggiungibile, la consegna viene ritentata con backoff crescente, così nessun documento va perso.

Mappatura dei campi verso l'anagrafica Zucchetti

I campi del JSON estratto vengono mappati sui campi corrispondenti di Zucchetti. La validazione avviene prima della scrittura: se la partita IVA non trova riscontro nell'anagrafica fornitori o un codice articolo non esiste, il documento viene segnalato invece di generare un record incoerente.

Cosa cambia con l'integrazione Zucchetti di Data Alchemy

Domande frequenti sull'integrazione Zucchetti