Webhook

I Webhook permettono a WindDoc di comunicare automaticamente con applicazioni, siti web e servizi esterni quando si verifica un determinato evento.

A differenza delle API, che richiedono al sistema esterno di interrogare WindDoc per ottenere informazioni, i Webhook consentono a WindDoc di inviare autonomamente una notifica al sistema esterno nel momento in cui si verifica un evento.

Ad esempio, quando viene creata una nuova fattura, modificato un cliente o aggiornato un prodotto, WindDoc può inviare automaticamente i dati a un indirizzo URL (endpoint) precedentemente configurato.

In questo modo è possibile sincronizzare i dati e automatizzare i processi tra WindDoc e altri sistemi, senza dover effettuare continuamente richieste per verificare la presenza di aggiornamenti.

Esempi di utilizzo

  • Sincronizzazione contatti: aggiornare automaticamente i clienti presenti in un CRM esterno quando vengono aggiunti o modificati in WindDoc.
  • Gestione fatture: ricevere una notifica quando viene creata una nuova fattura e acquisirne automaticamente i dati.
  • Sincronizzazione prodotti: aggiornare un e-commerce quando vengono modificati prodotti o disponibilità di magazzino.
  • Automazione dei processi: avviare procedure, notifiche o operazioni su applicazioni esterne in seguito a specifici eventi.

Come attivare i Webhook

Per utilizzare i Webhook è necessario disporre di un account WindDoc o WindDoc NoProfit.

Se utilizzate una configurazione MultiAzienda, accedete alla gestione e selezionate l'azienda per la quale desiderate attivare i Webhook. La configurazione è infatti specifica per ciascuna azienda.

  1. 1

    Accedere alla sezione Applicazioni

    Dal menu laterale di sinistra, accedete alla sezione indicata qui sotto. In questa sezione trovate l'elenco delle applicazioni e delle integrazioni già collegate al vostro account.

    Impostazioni → Applicazioni

  2. 2

    Generare il Token Webhooks

    Per creare una nuova configurazione Webhook, cliccate sul pulsante Genera Token Webhooks. Una volta completata la generazione, nella lista delle applicazioni comparirà una nuova voce denominata Webhooks.

  3. 3

    Attivare e configurare i Webhook

    Attivate la voce Webhooks e cliccate sul pulsante Configura. Nella schermata di configurazione troverete il token utilizzato per la firma delle richieste, che permette al sistema ricevente di verificare l'autenticità delle notifiche inviate da WindDoc. Dalla stessa sezione potete configurare i singoli Webhook disponibili.

  4. 4

    Configurare gli URL di chiamata

    Per ogni Webhook che desiderate utilizzare, è necessario indicare un URL di destinazione (endpoint), ovvero l'indirizzo della pagina o del servizio esterno che dovrà ricevere le notifiche inviate da WindDoc. Dopo aver inserito l'URL, potete utilizzare il pulsante Test per verificare che l'indirizzo configurato sia raggiungibile e che la pagina risponda correttamente alla chiamata inviata da WindDoc.

Come funzionano

Per ogni evento elencato in questa pagina puoi configurare un URL dalla sezione Webhook della gestione. Quando l'evento si verifica, WindDoc invia una richiesta POST in formato application/json al tuo endpoint.

{ "model": "...", "event": "...", "data": { ... } }

Dettagli della chiamata

Metodo POST
Content-Type application/json
Accept application/json
User-Agent WindDoc-Webhooks/1.0

Ogni richiesta include i seguenti header, che puoi usare per identificare e verificare la chiamata:

Header Descrizione Esempio
X-Webhook-Id Identificativo del webhook configurato nella gestione. a34fd455....
X-Webhook-Event Evento che ha generato la chiamata, in forma model.event. fatture.aggiungi
X-Webhook-Signature Firma HMAC-SHA256 del body grezzo della richiesta, con chiave il token di firma dell'azienda. Formato: sha256=<hex>. sha256=3f9a…

Verifica della firma

La firma viene calcolata con hash_hmac('sha256', , ) dove è il body raw ricevuto (la stringa JSON esatta, prima di qualsiasi parsing). Confrontala con l'header X-Webhook-Signature usando un confronto a tempo costante.

Token di firma (per azienda): a34fd455•••• Lo trovi nella sezione Webhook della tua gestione.

Esempio di verifica:

$rawBody   = file_get_contents('php://input');   // body grezzo, NON json_decode
$expected  = 'sha256=' . hash_hmac('sha256', $rawBody, $token);
$received  = $_SERVER['HTTP_X_WEBHOOK_SIGNATURE'] ?? '';

if (!hash_equals($expected, $received)) {
    http_response_code(401);
    exit('Firma non valida');
}

$payload = json_decode($rawBody, true);          // ora puoi parsare
// $payload = ['model' => '...', 'event' => '...', 'data' => [...]]

http_response_code(200);                         // rispondi 2xx entro 10s

Attenzione: la firma è calcolata sui byte esatti del body. Se decodifichi e ri-codifichi il JSON, l'ordine delle chiavi, gli spazi e i caratteri Unicode possono cambiare, e la verifica fallirà. Usa sempre il body raw.

Generale 7

Rubrica contatti.aggiungi
Aggiunta di un contatto

Evento richiamato quando viene inserito un nuovo contatto.

Payload di esempio
{
    "model": "contatti",
    "event": "aggiungi",
    "data": {
        "id_contatto": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "nome": "Mario",
        "cognome": "Rossi",
        "ragione_sociale": "Rossi Consulting Srl",
        "partita_iva": "01234567890",
        "codice_fiscale": "RSSMRA80A01H501U",
        "indirizzo_via": "Via Roma 10",
        "indirizzo_citta": "Milano",
        "indirizzo_cap": "20121",
        "indirizzo_provincia": "MI",
        "indirizzo_nazione": "IT",
        "indirizzo_extra": "",
        "email": "mario.rossi@example.com",
        "email_pec": "rossi.consulting@pec.it",
        "telefono": "0212345678",
        "fax": "",
        "cellulare": "3331234567",
        "note": "",
        "iva": "1b006cf5-03b3-7935-2476-660eda88ca16",
        "giorni_pagamento": "0",
        "tipo_pagamento": "gg_data_fattura",
        "fattura_elettronica_pa": "0",
        "codice_pa": "M5UXCR1",
        "tipo_contatto": "1",
        "data_inserimento": "2025-10-17 09:15:00",
        "data_modifica": "2026-11-18 10:51:37",
        "id_social_link": null,
        "is_social": "0",
        "data_nascita": null,
        "id_categoria_acquisto": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "sconto": "0.0000",
        "codice_destinatario": "M5UXCR1",
        "id_pagamento_preferito": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "nazione_nascita": "IT",
        "citta_nascita": "Milano",
        "flagOpposizione": "0",
        "numero_cig": "",
        "id_prodotto_listino": "base",
        "id_regimefiscale": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "tags": "",
        "invia_notifiche": "1",
        "provincia_nascita": "MI",
        "id_agente": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "agente_tipo_provvigione": "0",
        "agente_provvigione": "23.0000",
        "iscrizione_newsletter": "1",
        "tipo_categoria_acquisto": null,
        "ddt_annotazioni": "",
        "ddt_casuale_trasporto": "",
        "ddt_trasporto_cura_di": "",
        "ddt_luogo_destinazione": "",
        "genere": "M",
        "campo1": null,
        "campo2": null,
        "campo3": null,
        "campo4": null,
        "campo5": null,
        "campo6": null,
        "campo7": null,
        "campo8": null,
        "campo9": null,
        "campo10": null,
        "campo11": null,
        "campo12": null,
        "campo13": null,
        "campo14": null,
        "campo15": null,
        "campo16": null,
        "campo17": null,
        "campo18": null,
        "campo19": null,
        "campo20": null,
        "sito_web": "https://www.sito.it",
        "id_users_groups": "",
        "codice_interno": "C0001",
        "iban": "IT60X0542811101000000123456",
        "giorni_pagamento_enable": "1"
    }
}
Rubrica contatti.modifica
Modifica di un contatto

Evento richiamato quando viene modificato un contatto.

Payload di esempio
{
    "model": "contatti",
    "event": "modifica",
    "data": {
        "id_contatto": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "nome": "Mario",
        "cognome": "Rossi",
        "ragione_sociale": "Rossi Consulting Srl",
        "partita_iva": "01234567890",
        "codice_fiscale": "RSSMRA80A01H501U",
        "indirizzo_via": "Via Roma 10",
        "indirizzo_citta": "Milano",
        "indirizzo_cap": "20121",
        "indirizzo_provincia": "MI",
        "indirizzo_nazione": "IT",
        "indirizzo_extra": "",
        "email": "mario.rossi@example.com",
        "email_pec": "rossi.consulting@pec.it",
        "telefono": "0212345678",
        "fax": "",
        "cellulare": "3331234567",
        "note": "",
        "iva": "1b006cf5-03b3-7935-2476-660eda88ca16",
        "giorni_pagamento": "0",
        "tipo_pagamento": "gg_data_fattura",
        "fattura_elettronica_pa": "0",
        "codice_pa": "M5UXCR1",
        "tipo_contatto": "1",
        "data_inserimento": "2025-10-17 09:15:00",
        "data_modifica": "2026-11-18 10:51:37",
        "id_social_link": null,
        "is_social": "0",
        "data_nascita": null,
        "id_categoria_acquisto": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "sconto": "0.0000",
        "codice_destinatario": "M5UXCR1",
        "id_pagamento_preferito": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "nazione_nascita": "IT",
        "citta_nascita": "Milano",
        "flagOpposizione": "0",
        "numero_cig": "",
        "id_prodotto_listino": "base",
        "id_regimefiscale": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "tags": "",
        "invia_notifiche": "1",
        "provincia_nascita": "MI",
        "id_agente": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "agente_tipo_provvigione": "0",
        "agente_provvigione": "23.0000",
        "iscrizione_newsletter": "1",
        "tipo_categoria_acquisto": null,
        "ddt_annotazioni": "",
        "ddt_casuale_trasporto": "",
        "ddt_trasporto_cura_di": "",
        "ddt_luogo_destinazione": "",
        "genere": "M",
        "campo1": null,
        "campo2": null,
        "campo3": null,
        "campo4": null,
        "campo5": null,
        "campo6": null,
        "campo7": null,
        "campo8": null,
        "campo9": null,
        "campo10": null,
        "campo11": null,
        "campo12": null,
        "campo13": null,
        "campo14": null,
        "campo15": null,
        "campo16": null,
        "campo17": null,
        "campo18": null,
        "campo19": null,
        "campo20": null,
        "sito_web": "https://www.sito.it",
        "id_users_groups": "",
        "codice_interno": "C0001",
        "iban": "IT60X0542811101000000123456",
        "giorni_pagamento_enable": "1"
    }
}
Rubrica contatti.elimina
Eliminazione di un contatto

Evento richiamato quando viene eliminato un contatto.

Payload di esempio
{
    "model": "contatti",
    "event": "elimina",
    "data": {
        "id_contatto": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
    }
}
Prodotti e Servizi prodotti.aggiungi
Aggiunta di un prodotto

Evento richiamato quando viene inserito un nuovo prodotto.

Payload di esempio
{
    "model": "prodotti",
    "event": "aggiungi",
    "data": {
        "id_prodotto": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "nome": "Monitor 24 Pollici",
        "codice": "AG1246LG",
        "unita_misura": "",
        "iva": "ea4eb735-64f1-fcbd-a671-5717c520169d",
        "prezzo": "100.000000",
        "prezzo_valuta": "e994378e-c24b-12e2-cb41-5717c48cdc99",
        "costo_netto": "10.000000",
        "costo_netto_valuta": "e994378e-c24b-12e2-cb41-5717c48cdc99",
        "tipo_prezzo": "lordo",
        "categoria": "Monitor",
        "descrizione": "",
        "note": "",
        "data_inserimento": "2026-09-03 18:05:03",
        "data_modifica": "2026-11-17 14:14:46",
        "magazzino_enable": "1",
        "magazzino_scorta_minima": "20.000000",
        "magazzino_ubicazione": "",
        "prodotto_group": "0",
        "id_contatto": "",
        "prodotto_finito": "0",
        "non_imponibile": "0",
        "codici_fornitori": "CODE01,CODE02,CODE03",
        "id_centro_costo": null,
        "tags": null,
        "barcode": ""
    }
}
Prodotti e Servizi prodotti.modifica
Modifica di un prodotto

Evento richiamato quando viene modificato un prodotto.

Payload di esempio
{
    "model": "prodotti",
    "event": "modifica",
    "data": {
        "id_prodotto": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "nome": "Monitor 24 Pollici",
        "codice": "AG1246LG",
        "unita_misura": "",
        "iva": "ea4eb735-64f1-fcbd-a671-5717c520169d",
        "prezzo": "100.000000",
        "prezzo_valuta": "e994378e-c24b-12e2-cb41-5717c48cdc99",
        "costo_netto": "10.000000",
        "costo_netto_valuta": "e994378e-c24b-12e2-cb41-5717c48cdc99",
        "tipo_prezzo": "lordo",
        "categoria": "Monitor",
        "descrizione": "",
        "note": "",
        "data_inserimento": "2026-09-03 18:05:03",
        "data_modifica": "2026-11-17 14:14:46",
        "magazzino_enable": "1",
        "magazzino_scorta_minima": "20.000000",
        "magazzino_ubicazione": "",
        "prodotto_group": "0",
        "id_contatto": "",
        "prodotto_finito": "0",
        "non_imponibile": "0",
        "codici_fornitori": "CODE01,CODE02,CODE03",
        "id_centro_costo": null,
        "tags": null,
        "barcode": ""
    }
}
Prodotti e Servizi prodotti.elimina
Eliminazione di un prodotto

Evento richiamato quando viene eliminato un prodotto.

Payload di esempio
{
    "model": "prodotti",
    "event": "elimina",
    "data": {
        "id_prodotto": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
    }
}
Prodotti e Servizi prodotti.magazzino
Movimentazione di Magazzino

Evento richiamato quando cambia la giacenza del magazzino di un prodotto.

Payload di esempio
{
    "model": "prodotti",
    "event": "magazzino",
    "data": {
        "id_prodotto": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "nome": "Nome Prodotto",
        "codice": "Codice Prodotto",
        "unita_misura": "Pz",
        "iva": "1b006cf5-03b3-7935-2476-660eda88ca16",
        "prezzo": "100.000000",
        "prezzo_valuta": "e994378e-c24b-12e2-cb41-5717c48cdc99",
        "costo_netto": "52.000000",
        "costo_netto_valuta": "e994378e-c24b-12e2-cb41-5717c48cdc99",
        "tipo_prezzo": "lordo",
        "categoria": "",
        "descrizione": "",
        "note": "",
        "data_inserimento": "2026-10-14 15:26:22",
        "data_modifica": "2026-11-18 13:52:42",
        "magazzino_enable": "1",
        "magazzino_scorta_minima": "0.000000",
        "magazzino_ubicazione": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "prodotto_group": "0",
        "id_prodotto_categoria": "",
        "id_categoria_vendita": "",
        "tipo_categoria_vendita": "0",
        "id_rsm_tipomerce": "",
        "id_contatto": "",
        "prodotto_finito": "0",
        "non_imponibile": "0",
        "codici_fornitori": "",
        "id_centro_costo": "",
        "tags": "",
        "barcode": "",
        "movimenti": [
            {
                "id_prodotto": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
                "id_lotto": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
                "id_ubicazione": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
                "data_inserimento": "2026-11-19 15:49:00",
                "data_modifica": "2026-11-19 15:49:00",
                "caricato": 10,
                "scaricato": 0,
                "impegnato": 0,
                "in_arrivo": 0,
                "giacenza": 10,
                "disponibilita": 10,
                "disponibilita_futura": 10
            },
            {
                "id_prodotto": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
                "id_lotto": "",
                "id_ubicazione": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
                "data_inserimento": "2026-11-19 15:49:00",
                "data_modifica": "2026-11-19 15:49:00",
                "caricato": 10,
                "scaricato": 0,
                "impegnato": 0,
                "in_arrivo": 0,
                "giacenza": 10,
                "disponibilita": 10,
                "disponibilita_futura": 10
            }
        ]
    }
}

WindDoc 6

Fatturazione fatture.aggiungi
Aggiunta di un Documento

Evento richiamato quando viene inserito un nuovo documento.

Payload di esempio
{
    "model": "fatture",
    "event": "aggiungi",
    "data": {
        "id_invoice": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "document_type": "fatture",
        "id_contatto": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "stato": "1",
        "stato_documento": "0",
        "contatto_nome": "Mario",
        "contatto_cognome": "Rossi",
        "contatto_ragione_sociale": "Azienda Srls",
        "contatto_partita_iva": "",
        "contatto_email": "",
        "contatto_codice_fiscale": "XXXXXXXXXXXXXXX",
        "contatto_indirizzo_via": "Via Francesco",
        "contatto_indirizzo_citta": "Milano",
        "contatto_indirizzo_cap": "20122",
        "contatto_indirizzo_provincia": "MI",
        "contatto_indirizzo_nazione": "IT",
        "contatto_indirizzo_extra": "",
        "contatto_email_pec": "",
        "lingua_documento": null,
        "id_azienda_param": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "data_inserimento": "2026-10-30 11:28:37",
        "data_modifica": "2026-11-18 10:29:22",
        "data_documento": "2026-10-30",
        "numero_documento": "14",
        "numerazione": "",
        "numero": "14",
        "valuta": "e994378e-c24b-12e2-cb41-5717c48cdc99",
        "dicitura_invoice": "Riferimento Ordine #1032",
        "dicitura_invoice_nascosta": "",
        "centro_ricavo": null,
        "cassa_rivalsa": "0",
        "rivalsa_inps": "0.000000",
        "cassa_previdenza": "0.000000",
        "ritenuta_acconto_enable": "0",
        "ritenuta_acconto": "0.000000",
        "ritenuta_acconto_su_imponibile": "0.000000",
        "altra_ritenuta_enable": "0",
        "altra_ritenuta": "8.500000",
        "mostra_pagamenti_scadenze": "0",
        "pagamenti_modalita_nome": "",
        "pagamenti_modalita_parametri": [
            {
                "nome1": "",
                "nome2": ""
            }
        ],
        "marca_da_bollo_enable": "0",
        "marca_da_bollo": "2.000000",
        "competenze": "190.000000",
        "rivalsa_inps_totale": "0.000000",
        "competenze_rivalsa_lordo": "0.000000",
        "cassa_previdenza_totale": "0.000000",
        "imponibile": "190.000000",
        "totale_documento": "231.800000",
        "altre_ritenute_acconto_totale": "0.000000",
        "altre_ritenute_acconto_su": "0.000000",
        "altre_ritenute_altre": null,
        "altre_ritenute_altre_totale": "0.000000",
        "non_imponibile": "0.000000",
        "totale_pagare": "231.800000",
        "applica_ritenute": "0",
        "rivalsa_inps_name": "INPS",
        "cassa_previdenza_name": "Cassa previdenza",
        "altra_ritenuta_name": "ENASARCO",
        "all_iva": {
            "b8a4ff89-59b0-6114-96d6-5717c45712d4": 41.7999999999999971578290569595992565155029296875
        },
        "all_iva_tot": {
            "b8a4ff89-59b0-6114-96d6-5717c45712d4": 190
        },
        "note_documento": "",
        "template_stampa": "base",
        "parent_type": null,
        "parent_id": null,
        "colli": "",
        "peso": "",
        "annotazioni": "",
        "casuale_trasporto": "",
        "trasporto_cura_di": "",
        "luogo_destinazione": "",
        "PA_doc_emesso_per": null,
        "PA_iddocumento": null,
        "PA_data_ordine": null,
        "PA_cup": null,
        "PA_cig": null,
        "PA_codicedestinatario": null,
        "PA_esigibilitaiva": "",
        "PA_modalitapagamento": null,
        "PA_istitutofinanziario": null,
        "PA_iban": null,
        "PA_beneficiario": null,
        "PA_tipodocumento": null,
        "PA_causale": null,
        "id_social_invoice": null,
        "ricavo": "190.000000",
        "intestatari_multipli": null,
        "rf_id_contatto": "",
        "rf_contatto_nome": "",
        "rf_contatto_ragione_sociale": "",
        "rf_contatto_partita_iva": "",
        "rf_contatto_codice_fiscale": "",
        "rf_contatto_indirizzo_via": "",
        "rf_contatto_indirizzo_citta": "",
        "rf_contatto_indirizzo_cap": "",
        "rf_contatto_indirizzo_provincia": "",
        "rf_contatto_indirizzo_nazione": "IT",
        "rf_contatto_indirizzo_extra": null,
        "rf_enable": "0",
        "PA_abi": null,
        "PA_cab": null,
        "PA_bic": null,
        "PA_giorni_termini_pagamento": null,
        "regole": "[]",
        "id_centro_costo": "[\"\"]",
        "id_marca_da_bollo": "125333",
        "nascondi_iva": "0",
        "iva_totale": "41.800000",
        "id_pagamento": "",
        "marca_da_bollo_dm62146": "0",
        "imponibile_fix": "0.000000",
        "iva_totale_fix": {
            "b8a4ff89-59b0-6114-96d6-5717c45712d4": ""
        },
        "data_primo_invio_fe": null,
        "imponibile_faqm": "25202.279900",
        "prodotti_ritenuta_totale": "0.000000",
        "contatto_codice_destinatario": "",
        "tipo_invio_fe": null,
        "altridatigestionali": "",
        "altridatigestionali_riferimento_testo": "",
        "contributo_solidarieta_percent": "0.000000",
        "contributo_solidarieta_value": "0.000000",
        "contributo_solidarieta_su_totale": "0.000000",
        "contributo_aggiuntivo_percent": "0.000000",
        "contributo_aggiuntivo_value": "0.000000",
        "contributo_aggiuntivo_su_totale": "0.000000",
        "imponibile_faqm_mesi": "",
        "numero_fattura_elettronica": null,
        "stato_fattura_elettronica": null,
        "fattura_elettronica_b2b_advanced": "0",
        "iva_totale_detraibile": "41.800000",
        "enpals_disable_aaart33841192": "0",
        "valuta_documento": "e994378e-c24b-12e2-cb41-5717c48cdc99",
        "cambio_valuta": "1.000000",
        "cambio_valuta_default": "1.000000",
        "contatto_telefono": "",
        "contatto_cellulare": "",
        "id_codedocumento": null,
        "contatto_flagOpposizione": "0",
        "pagamentoTracciato": "0",
        "spesa_sanitaria_abilitata": "0",
        "tipo_spesa": null,
        "tipo_spesa_flag": null,
        "spesa_sanitaria_stato": "9",
        "non_rimborsabile": "0",
        "contratto_estimatorio_conto_visione": "0",
        "contatto_numero_cig": null,
        "abbuono": "0.000000",
        "nascondi_sconti": "0",
        "id_prodotto_listino": "",
        "autofattura_cedente_cessionario": "0",
        "contatto_id_regimefiscale": "",
        "not_insert_marca_da_bollo": "0",
        "xml_other": "[]",
        "tot_pagare": "0.000000",
        "tot_patrimoniale": "0.000000",
        "anno": "2026",
        "scaricato_pdf": "1",
        "scaricato_pdf_data": "2026-10-30 11:28:42",
        "marca_da_bollo_pa_natura": "",
        "xml_other_contatto": "[]",
        "pagamenti": null,
        "raggruppa_pagamenti_automatici": "0",
        "tot_anticipazioni": "0.000000",
        "id_users_groups": null,
        "doc_to_type": "0",
        "doc_to": "fatture",
        "anno_provvigioni": "2026",
        "imponibile_faqm_enasarco": "0.000000",
        "iva_scissione_pagamenti": "0.000000",
        "xml_other_pagamento": null,
        "contatto_iban": null,
        "show_pagamenti_fe": "0",
        "altridatigestionali_riferimento_numero": "0,00",
        "altridatigestionali_riferimento_data": null,
        "id_rsm_tipocessione": null,
        "prodotti": [
            {
                "id_prodotto_invoice": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
                "data_inserimento": "2026-11-18 10:29:21",
                "data_modifica": "2026-11-18 10:29:21",
                "id_invoice": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
                "id_prodotto": null,
                "nome": "Monitor",
                "codice": "LS123SD",
                "quantita": "2.000000",
                "unita_misura": "",
                "prezzo_netto": "100.000000",
                "prezzo_lordo": "122.000000",
                "prezzo_scontato": "95.000000",
                "iva": "b8a4ff89-59b0-6114-96d6-5717c45712d4",
                "importo_totale": "190.000000",
                "note": "",
                "sconto": "5.000000",
                "non_imponibile": "0",
                "applica_ritenute": "0",
                "in_ddt": "0",
                "ordine": "0",
                "tipo_riga": "0",
                "PA_data_inizio_periodo": null,
                "PA_data_fine_periodo": null,
                "scarica_da_magazzino": "0",
                "id_movimento_magazzino_rif": null,
                "id_centro_costo": "",
                "id_categoria_vendita": "",
                "tipo_categoria_vendita": null,
                "id_rsm_tipomerce": null,
                "id_monofase": null,
                "tipo_spesa": null,
                "tipo_spesa_flag": null,
                "id_prodotto_ddt_rif": "",
                "xml_other": null,
                "sconti": "",
                "sconto_riservato": "0",
                "importo_totale_iva": "231.800000",
                "altre_ritenute_acconto_totale": "0.000000",
                "altre_ritenute_altre_totale": "0.000000",
                "iva_totale_detraibile": "41.800000",
                "cassa_previdenza_totale": "0.000000",
                "marca_da_bollo": "0.000000",
                "rivalsa_inps_totale": "0.000000",
                "id_rif_prodotto_quote": "",
                "modificatore": "[]",
                "categoria_vendita": ""
            }
        ],
        "cointestatari": [],
        "scadenze_pagamenti": [
            {
                "id_scadenza_pagamento": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
                "data_inserimento": "2026-11-18 10:29:21",
                "data_modifica": "2026-11-18 10:29:21",
                "ammontare": "231.8000",
                "ammontare_valuta": "e994378e-c24b-12e2-cb41-5717c48cdc99",
                "termini": "0",
                "scadenza": "2026-10-30",
                "id_conto": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
                "data_saldo": "2026-10-30",
                "parent_type": "fatture",
                "parent_id": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
                "id_contatto": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
                "tipo_scadenza": "0",
                "ritenuta_bonifico_dl78_2010": "0.0000",
                "ammontare_iva": "41.8000",
                "id_pagamento": "",
                "commissioni": "0.0000",
                "sollecito_enable": "0",
                "ritenuta_ristrutturazione": "0",
                "ammontare_istituzionale_cs": "0.0000",
                "ammontare_istituzionale_cs_iva": "0.0000",
                "saldato": "1",
                "ammontare_commerciale": "0.0000",
                "ammontare_commerciale_iva": "0.0000",
                "note": "",
                "id_pagamento_log": null,
                "id_settings_pagamento": "",
                "ammontare_sponsor": "0.0000"
            }
        ],
        "simbolo_valuta": "€",
        "url": "https://app.winddoc.com/sct/XXXXXXX",
        "url_dir": "https://app.winddoc.com/sct/XXXXX"
    }
}
Fatturazione fatture.modifica
Modifica di un documento

Evento richiamato quando viene modificato un documento.

Payload di esempio
{
    "model": "fatture",
    "event": "modifica",
    "data": {
        "id_invoice": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "document_type": "fatture",
        "id_contatto": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "stato": "1",
        "stato_documento": "0",
        "contatto_nome": "Mario",
        "contatto_cognome": "Rossi",
        "contatto_ragione_sociale": "Azienda Srls",
        "contatto_partita_iva": "",
        "contatto_email": "",
        "contatto_codice_fiscale": "XXXXXXXXXXXXXXX",
        "contatto_indirizzo_via": "Via Francesco",
        "contatto_indirizzo_citta": "Milano",
        "contatto_indirizzo_cap": "20122",
        "contatto_indirizzo_provincia": "MI",
        "contatto_indirizzo_nazione": "IT",
        "contatto_indirizzo_extra": "",
        "contatto_email_pec": "",
        "lingua_documento": null,
        "id_azienda_param": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "data_inserimento": "2026-10-30 11:28:37",
        "data_modifica": "2026-11-18 10:29:22",
        "data_documento": "2026-10-30",
        "numero_documento": "14",
        "numerazione": "",
        "numero": "14",
        "valuta": "e994378e-c24b-12e2-cb41-5717c48cdc99",
        "dicitura_invoice": "Riferimento Ordine #1032",
        "dicitura_invoice_nascosta": "",
        "centro_ricavo": null,
        "cassa_rivalsa": "0",
        "rivalsa_inps": "0.000000",
        "cassa_previdenza": "0.000000",
        "ritenuta_acconto_enable": "0",
        "ritenuta_acconto": "0.000000",
        "ritenuta_acconto_su_imponibile": "0.000000",
        "altra_ritenuta_enable": "0",
        "altra_ritenuta": "8.500000",
        "mostra_pagamenti_scadenze": "0",
        "pagamenti_modalita_nome": "",
        "pagamenti_modalita_parametri": [
            {
                "nome1": "",
                "nome2": ""
            }
        ],
        "marca_da_bollo_enable": "0",
        "marca_da_bollo": "2.000000",
        "competenze": "190.000000",
        "rivalsa_inps_totale": "0.000000",
        "competenze_rivalsa_lordo": "0.000000",
        "cassa_previdenza_totale": "0.000000",
        "imponibile": "190.000000",
        "totale_documento": "231.800000",
        "altre_ritenute_acconto_totale": "0.000000",
        "altre_ritenute_acconto_su": "0.000000",
        "altre_ritenute_altre": null,
        "altre_ritenute_altre_totale": "0.000000",
        "non_imponibile": "0.000000",
        "totale_pagare": "231.800000",
        "applica_ritenute": "0",
        "rivalsa_inps_name": "INPS",
        "cassa_previdenza_name": "Cassa previdenza",
        "altra_ritenuta_name": "ENASARCO",
        "all_iva": {
            "b8a4ff89-59b0-6114-96d6-5717c45712d4": 41.7999999999999971578290569595992565155029296875
        },
        "all_iva_tot": {
            "b8a4ff89-59b0-6114-96d6-5717c45712d4": 190
        },
        "note_documento": "",
        "template_stampa": "base",
        "parent_type": null,
        "parent_id": null,
        "colli": "",
        "peso": "",
        "annotazioni": "",
        "casuale_trasporto": "",
        "trasporto_cura_di": "",
        "luogo_destinazione": "",
        "PA_doc_emesso_per": null,
        "PA_iddocumento": null,
        "PA_data_ordine": null,
        "PA_cup": null,
        "PA_cig": null,
        "PA_codicedestinatario": null,
        "PA_esigibilitaiva": "",
        "PA_modalitapagamento": null,
        "PA_istitutofinanziario": null,
        "PA_iban": null,
        "PA_beneficiario": null,
        "PA_tipodocumento": null,
        "PA_causale": null,
        "id_social_invoice": null,
        "ricavo": "190.000000",
        "intestatari_multipli": null,
        "rf_id_contatto": "",
        "rf_contatto_nome": "",
        "rf_contatto_ragione_sociale": "",
        "rf_contatto_partita_iva": "",
        "rf_contatto_codice_fiscale": "",
        "rf_contatto_indirizzo_via": "",
        "rf_contatto_indirizzo_citta": "",
        "rf_contatto_indirizzo_cap": "",
        "rf_contatto_indirizzo_provincia": "",
        "rf_contatto_indirizzo_nazione": "IT",
        "rf_contatto_indirizzo_extra": null,
        "rf_enable": "0",
        "PA_abi": null,
        "PA_cab": null,
        "PA_bic": null,
        "PA_giorni_termini_pagamento": null,
        "regole": "[]",
        "id_centro_costo": "[\"\"]",
        "id_marca_da_bollo": "125333",
        "nascondi_iva": "0",
        "iva_totale": "41.800000",
        "id_pagamento": "",
        "marca_da_bollo_dm62146": "0",
        "imponibile_fix": "0.000000",
        "iva_totale_fix": {
            "b8a4ff89-59b0-6114-96d6-5717c45712d4": ""
        },
        "data_primo_invio_fe": null,
        "imponibile_faqm": "25202.279900",
        "prodotti_ritenuta_totale": "0.000000",
        "contatto_codice_destinatario": "",
        "tipo_invio_fe": null,
        "altridatigestionali": "",
        "altridatigestionali_riferimento_testo": "",
        "contributo_solidarieta_percent": "0.000000",
        "contributo_solidarieta_value": "0.000000",
        "contributo_solidarieta_su_totale": "0.000000",
        "contributo_aggiuntivo_percent": "0.000000",
        "contributo_aggiuntivo_value": "0.000000",
        "contributo_aggiuntivo_su_totale": "0.000000",
        "imponibile_faqm_mesi": "",
        "numero_fattura_elettronica": null,
        "stato_fattura_elettronica": null,
        "fattura_elettronica_b2b_advanced": "0",
        "iva_totale_detraibile": "41.800000",
        "enpals_disable_aaart33841192": "0",
        "valuta_documento": "e994378e-c24b-12e2-cb41-5717c48cdc99",
        "cambio_valuta": "1.000000",
        "cambio_valuta_default": "1.000000",
        "contatto_telefono": "",
        "contatto_cellulare": "",
        "id_codedocumento": null,
        "contatto_flagOpposizione": "0",
        "pagamentoTracciato": "0",
        "spesa_sanitaria_abilitata": "0",
        "tipo_spesa": null,
        "tipo_spesa_flag": null,
        "spesa_sanitaria_stato": "9",
        "non_rimborsabile": "0",
        "contratto_estimatorio_conto_visione": "0",
        "contatto_numero_cig": null,
        "abbuono": "0.000000",
        "nascondi_sconti": "0",
        "id_prodotto_listino": "",
        "autofattura_cedente_cessionario": "0",
        "contatto_id_regimefiscale": "",
        "not_insert_marca_da_bollo": "0",
        "xml_other": "[]",
        "tot_pagare": "0.000000",
        "tot_patrimoniale": "0.000000",
        "anno": "2026",
        "scaricato_pdf": "1",
        "scaricato_pdf_data": "2026-10-30 11:28:42",
        "marca_da_bollo_pa_natura": "",
        "xml_other_contatto": "[]",
        "pagamenti": null,
        "raggruppa_pagamenti_automatici": "0",
        "tot_anticipazioni": "0.000000",
        "id_users_groups": null,
        "doc_to_type": "0",
        "doc_to": "fatture",
        "anno_provvigioni": "2026",
        "imponibile_faqm_enasarco": "0.000000",
        "iva_scissione_pagamenti": "0.000000",
        "xml_other_pagamento": null,
        "contatto_iban": null,
        "show_pagamenti_fe": "0",
        "altridatigestionali_riferimento_numero": "0,00",
        "altridatigestionali_riferimento_data": null,
        "id_rsm_tipocessione": null,
        "prodotti": [
            {
                "id_prodotto_invoice": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
                "data_inserimento": "2026-11-18 10:29:21",
                "data_modifica": "2026-11-18 10:29:21",
                "id_invoice": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
                "id_prodotto": null,
                "nome": "Monitor",
                "codice": "LS123SD",
                "quantita": "2.000000",
                "unita_misura": "",
                "prezzo_netto": "100.000000",
                "prezzo_lordo": "122.000000",
                "prezzo_scontato": "95.000000",
                "iva": "b8a4ff89-59b0-6114-96d6-5717c45712d4",
                "importo_totale": "190.000000",
                "note": "",
                "sconto": "5.000000",
                "non_imponibile": "0",
                "applica_ritenute": "0",
                "in_ddt": "0",
                "ordine": "0",
                "tipo_riga": "0",
                "PA_data_inizio_periodo": null,
                "PA_data_fine_periodo": null,
                "scarica_da_magazzino": "0",
                "id_movimento_magazzino_rif": null,
                "id_centro_costo": "",
                "id_categoria_vendita": "",
                "tipo_categoria_vendita": null,
                "id_rsm_tipomerce": null,
                "id_monofase": null,
                "tipo_spesa": null,
                "tipo_spesa_flag": null,
                "id_prodotto_ddt_rif": "",
                "xml_other": null,
                "sconti": "",
                "sconto_riservato": "0",
                "importo_totale_iva": "231.800000",
                "altre_ritenute_acconto_totale": "0.000000",
                "altre_ritenute_altre_totale": "0.000000",
                "iva_totale_detraibile": "41.800000",
                "cassa_previdenza_totale": "0.000000",
                "marca_da_bollo": "0.000000",
                "rivalsa_inps_totale": "0.000000",
                "id_rif_prodotto_quote": "",
                "modificatore": "[]",
                "categoria_vendita": ""
            }
        ],
        "cointestatari": [],
        "scadenze_pagamenti": [
            {
                "id_scadenza_pagamento": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
                "data_inserimento": "2026-11-18 10:29:21",
                "data_modifica": "2026-11-18 10:29:21",
                "ammontare": "231.8000",
                "ammontare_valuta": "e994378e-c24b-12e2-cb41-5717c48cdc99",
                "termini": "0",
                "scadenza": "2026-10-30",
                "id_conto": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
                "data_saldo": "2026-10-30",
                "parent_type": "fatture",
                "parent_id": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
                "id_contatto": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
                "tipo_scadenza": "0",
                "ritenuta_bonifico_dl78_2010": "0.0000",
                "ammontare_iva": "41.8000",
                "id_pagamento": "",
                "commissioni": "0.0000",
                "sollecito_enable": "0",
                "ritenuta_ristrutturazione": "0",
                "ammontare_istituzionale_cs": "0.0000",
                "ammontare_istituzionale_cs_iva": "0.0000",
                "saldato": "1",
                "ammontare_commerciale": "0.0000",
                "ammontare_commerciale_iva": "0.0000",
                "note": "",
                "id_pagamento_log": null,
                "id_settings_pagamento": "",
                "ammontare_sponsor": "0.0000"
            }
        ],
        "simbolo_valuta": "€",
        "url": "https://app.winddoc.com/sct/XXXXXXX",
        "url_dir": "https://app.winddoc.com/sct/XXXXX"
    }
}
Fatturazione fatture.elimina
Eliminazione di un documento

Evento richiamato quando viene eliminato un documento.

Payload di esempio
{
    "model": "fatture",
    "event": "elimina",
    "data": {
        "id_invoice": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
    }
}
Ricevute ricevute.aggiungi
Aggiunta di una Ricevuta

Evento richiamato quando viene inserita una nuova ricevuta.

Payload di esempio
{
    "model": "ricevute",
    "event": "aggiungi",
    "data": {
        "id_invoice": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "document_type": "fatture",
        "id_contatto": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "stato": "1",
        "stato_documento": "0",
        "contatto_nome": "Mario",
        "contatto_cognome": "Rossi",
        "contatto_ragione_sociale": "Azienda Srls",
        "contatto_partita_iva": "",
        "contatto_email": "",
        "contatto_codice_fiscale": "XXXXXXXXXXXXXXX",
        "contatto_indirizzo_via": "Via Francesco",
        "contatto_indirizzo_citta": "Milano",
        "contatto_indirizzo_cap": "20122",
        "contatto_indirizzo_provincia": "MI",
        "contatto_indirizzo_nazione": "IT",
        "contatto_indirizzo_extra": "",
        "contatto_email_pec": "",
        "lingua_documento": null,
        "id_azienda_param": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "data_inserimento": "2026-10-30 11:28:37",
        "data_modifica": "2026-11-18 10:29:22",
        "data_documento": "2026-10-30",
        "numero_documento": "14",
        "numerazione": "",
        "numero": "14",
        "valuta": "e994378e-c24b-12e2-cb41-5717c48cdc99",
        "dicitura_invoice": "Riferimento Ordine #1032",
        "dicitura_invoice_nascosta": "",
        "centro_ricavo": null,
        "cassa_rivalsa": "0",
        "rivalsa_inps": "0.000000",
        "cassa_previdenza": "0.000000",
        "ritenuta_acconto_enable": "0",
        "ritenuta_acconto": "0.000000",
        "ritenuta_acconto_su_imponibile": "0.000000",
        "altra_ritenuta_enable": "0",
        "altra_ritenuta": "8.500000",
        "mostra_pagamenti_scadenze": "0",
        "pagamenti_modalita_nome": "",
        "pagamenti_modalita_parametri": [
            {
                "nome1": "",
                "nome2": ""
            }
        ],
        "marca_da_bollo_enable": "0",
        "marca_da_bollo": "2.000000",
        "competenze": "190.000000",
        "rivalsa_inps_totale": "0.000000",
        "competenze_rivalsa_lordo": "0.000000",
        "cassa_previdenza_totale": "0.000000",
        "imponibile": "190.000000",
        "totale_documento": "231.800000",
        "altre_ritenute_acconto_totale": "0.000000",
        "altre_ritenute_acconto_su": "0.000000",
        "altre_ritenute_altre": null,
        "altre_ritenute_altre_totale": "0.000000",
        "non_imponibile": "0.000000",
        "totale_pagare": "231.800000",
        "applica_ritenute": "0",
        "rivalsa_inps_name": "INPS",
        "cassa_previdenza_name": "Cassa previdenza",
        "altra_ritenuta_name": "ENASARCO",
        "all_iva": {
            "b8a4ff89-59b0-6114-96d6-5717c45712d4": 41.7999999999999971578290569595992565155029296875
        },
        "all_iva_tot": {
            "b8a4ff89-59b0-6114-96d6-5717c45712d4": 190
        },
        "note_documento": "",
        "template_stampa": "base",
        "parent_type": null,
        "parent_id": null,
        "colli": "",
        "peso": "",
        "annotazioni": "",
        "casuale_trasporto": "",
        "trasporto_cura_di": "",
        "luogo_destinazione": "",
        "PA_doc_emesso_per": null,
        "PA_iddocumento": null,
        "PA_data_ordine": null,
        "PA_cup": null,
        "PA_cig": null,
        "PA_codicedestinatario": null,
        "PA_esigibilitaiva": "",
        "PA_modalitapagamento": null,
        "PA_istitutofinanziario": null,
        "PA_iban": null,
        "PA_beneficiario": null,
        "PA_tipodocumento": null,
        "PA_causale": null,
        "id_social_invoice": null,
        "ricavo": "190.000000",
        "intestatari_multipli": null,
        "rf_id_contatto": "",
        "rf_contatto_nome": "",
        "rf_contatto_ragione_sociale": "",
        "rf_contatto_partita_iva": "",
        "rf_contatto_codice_fiscale": "",
        "rf_contatto_indirizzo_via": "",
        "rf_contatto_indirizzo_citta": "",
        "rf_contatto_indirizzo_cap": "",
        "rf_contatto_indirizzo_provincia": "",
        "rf_contatto_indirizzo_nazione": "IT",
        "rf_contatto_indirizzo_extra": null,
        "rf_enable": "0",
        "PA_abi": null,
        "PA_cab": null,
        "PA_bic": null,
        "PA_giorni_termini_pagamento": null,
        "regole": "[]",
        "id_centro_costo": "[\"\"]",
        "id_marca_da_bollo": "125333",
        "nascondi_iva": "0",
        "iva_totale": "41.800000",
        "id_pagamento": "",
        "marca_da_bollo_dm62146": "0",
        "imponibile_fix": "0.000000",
        "iva_totale_fix": {
            "b8a4ff89-59b0-6114-96d6-5717c45712d4": ""
        },
        "data_primo_invio_fe": null,
        "imponibile_faqm": "25202.279900",
        "prodotti_ritenuta_totale": "0.000000",
        "contatto_codice_destinatario": "",
        "tipo_invio_fe": null,
        "altridatigestionali": "",
        "altridatigestionali_riferimento_testo": "",
        "contributo_solidarieta_percent": "0.000000",
        "contributo_solidarieta_value": "0.000000",
        "contributo_solidarieta_su_totale": "0.000000",
        "contributo_aggiuntivo_percent": "0.000000",
        "contributo_aggiuntivo_value": "0.000000",
        "contributo_aggiuntivo_su_totale": "0.000000",
        "imponibile_faqm_mesi": "",
        "numero_fattura_elettronica": null,
        "stato_fattura_elettronica": null,
        "fattura_elettronica_b2b_advanced": "0",
        "iva_totale_detraibile": "41.800000",
        "enpals_disable_aaart33841192": "0",
        "valuta_documento": "e994378e-c24b-12e2-cb41-5717c48cdc99",
        "cambio_valuta": "1.000000",
        "cambio_valuta_default": "1.000000",
        "contatto_telefono": "",
        "contatto_cellulare": "",
        "id_codedocumento": null,
        "contatto_flagOpposizione": "0",
        "pagamentoTracciato": "0",
        "spesa_sanitaria_abilitata": "0",
        "tipo_spesa": null,
        "tipo_spesa_flag": null,
        "spesa_sanitaria_stato": "9",
        "non_rimborsabile": "0",
        "contratto_estimatorio_conto_visione": "0",
        "contatto_numero_cig": null,
        "abbuono": "0.000000",
        "nascondi_sconti": "0",
        "id_prodotto_listino": "",
        "autofattura_cedente_cessionario": "0",
        "contatto_id_regimefiscale": "",
        "not_insert_marca_da_bollo": "0",
        "xml_other": "[]",
        "tot_pagare": "0.000000",
        "tot_patrimoniale": "0.000000",
        "anno": "2026",
        "scaricato_pdf": "1",
        "scaricato_pdf_data": "2026-10-30 11:28:42",
        "marca_da_bollo_pa_natura": "",
        "xml_other_contatto": "[]",
        "pagamenti": null,
        "raggruppa_pagamenti_automatici": "0",
        "tot_anticipazioni": "0.000000",
        "id_users_groups": null,
        "doc_to_type": "0",
        "doc_to": "fatture",
        "anno_provvigioni": "2026",
        "imponibile_faqm_enasarco": "0.000000",
        "iva_scissione_pagamenti": "0.000000",
        "xml_other_pagamento": null,
        "contatto_iban": null,
        "show_pagamenti_fe": "0",
        "altridatigestionali_riferimento_numero": "0,00",
        "altridatigestionali_riferimento_data": null,
        "id_rsm_tipocessione": null,
        "prodotti": [
            {
                "id_prodotto_invoice": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
                "data_inserimento": "2026-11-18 10:29:21",
                "data_modifica": "2026-11-18 10:29:21",
                "id_invoice": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
                "id_prodotto": null,
                "nome": "Monitor",
                "codice": "LS123SD",
                "quantita": "2.000000",
                "unita_misura": "",
                "prezzo_netto": "100.000000",
                "prezzo_lordo": "122.000000",
                "prezzo_scontato": "95.000000",
                "iva": "b8a4ff89-59b0-6114-96d6-5717c45712d4",
                "importo_totale": "190.000000",
                "note": "",
                "sconto": "5.000000",
                "non_imponibile": "0",
                "applica_ritenute": "0",
                "in_ddt": "0",
                "ordine": "0",
                "tipo_riga": "0",
                "PA_data_inizio_periodo": null,
                "PA_data_fine_periodo": null,
                "scarica_da_magazzino": "0",
                "id_movimento_magazzino_rif": null,
                "id_centro_costo": "",
                "id_categoria_vendita": "",
                "tipo_categoria_vendita": null,
                "id_rsm_tipomerce": null,
                "id_monofase": null,
                "tipo_spesa": null,
                "tipo_spesa_flag": null,
                "id_prodotto_ddt_rif": "",
                "xml_other": null,
                "sconti": "",
                "sconto_riservato": "0",
                "importo_totale_iva": "231.800000",
                "altre_ritenute_acconto_totale": "0.000000",
                "altre_ritenute_altre_totale": "0.000000",
                "iva_totale_detraibile": "41.800000",
                "cassa_previdenza_totale": "0.000000",
                "marca_da_bollo": "0.000000",
                "rivalsa_inps_totale": "0.000000",
                "id_rif_prodotto_quote": "",
                "modificatore": "[]",
                "categoria_vendita": ""
            }
        ],
        "cointestatari": [],
        "scadenze_pagamenti": [
            {
                "id_scadenza_pagamento": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
                "data_inserimento": "2026-11-18 10:29:21",
                "data_modifica": "2026-11-18 10:29:21",
                "ammontare": "231.8000",
                "ammontare_valuta": "e994378e-c24b-12e2-cb41-5717c48cdc99",
                "termini": "0",
                "scadenza": "2026-10-30",
                "id_conto": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
                "data_saldo": "2026-10-30",
                "parent_type": "fatture",
                "parent_id": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
                "id_contatto": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
                "tipo_scadenza": "0",
                "ritenuta_bonifico_dl78_2010": "0.0000",
                "ammontare_iva": "41.8000",
                "id_pagamento": "",
                "commissioni": "0.0000",
                "sollecito_enable": "0",
                "ritenuta_ristrutturazione": "0",
                "ammontare_istituzionale_cs": "0.0000",
                "ammontare_istituzionale_cs_iva": "0.0000",
                "saldato": "1",
                "ammontare_commerciale": "0.0000",
                "ammontare_commerciale_iva": "0.0000",
                "note": "",
                "id_pagamento_log": null,
                "id_settings_pagamento": "",
                "ammontare_sponsor": "0.0000"
            }
        ],
        "simbolo_valuta": "€",
        "url": "https://app.winddoc.com/sct/XXXXXXX",
        "url_dir": "https://app.winddoc.com/sct/XXXXX"
    }
}
Ricevute ricevute.modifica
Modifica di una Ricevuta

Evento richiamato quando viene modificata una ricevuta.

Payload di esempio
{
    "model": "ricevute",
    "event": "modifica",
    "data": {
        "id_invoice": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "document_type": "fatture",
        "id_contatto": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "stato": "1",
        "stato_documento": "0",
        "contatto_nome": "Mario",
        "contatto_cognome": "Rossi",
        "contatto_ragione_sociale": "Azienda Srls",
        "contatto_partita_iva": "",
        "contatto_email": "",
        "contatto_codice_fiscale": "XXXXXXXXXXXXXXX",
        "contatto_indirizzo_via": "Via Francesco",
        "contatto_indirizzo_citta": "Milano",
        "contatto_indirizzo_cap": "20122",
        "contatto_indirizzo_provincia": "MI",
        "contatto_indirizzo_nazione": "IT",
        "contatto_indirizzo_extra": "",
        "contatto_email_pec": "",
        "lingua_documento": null,
        "id_azienda_param": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "data_inserimento": "2026-10-30 11:28:37",
        "data_modifica": "2026-11-18 10:29:22",
        "data_documento": "2026-10-30",
        "numero_documento": "14",
        "numerazione": "",
        "numero": "14",
        "valuta": "e994378e-c24b-12e2-cb41-5717c48cdc99",
        "dicitura_invoice": "Riferimento Ordine #1032",
        "dicitura_invoice_nascosta": "",
        "centro_ricavo": null,
        "cassa_rivalsa": "0",
        "rivalsa_inps": "0.000000",
        "cassa_previdenza": "0.000000",
        "ritenuta_acconto_enable": "0",
        "ritenuta_acconto": "0.000000",
        "ritenuta_acconto_su_imponibile": "0.000000",
        "altra_ritenuta_enable": "0",
        "altra_ritenuta": "8.500000",
        "mostra_pagamenti_scadenze": "0",
        "pagamenti_modalita_nome": "",
        "pagamenti_modalita_parametri": [
            {
                "nome1": "",
                "nome2": ""
            }
        ],
        "marca_da_bollo_enable": "0",
        "marca_da_bollo": "2.000000",
        "competenze": "190.000000",
        "rivalsa_inps_totale": "0.000000",
        "competenze_rivalsa_lordo": "0.000000",
        "cassa_previdenza_totale": "0.000000",
        "imponibile": "190.000000",
        "totale_documento": "231.800000",
        "altre_ritenute_acconto_totale": "0.000000",
        "altre_ritenute_acconto_su": "0.000000",
        "altre_ritenute_altre": null,
        "altre_ritenute_altre_totale": "0.000000",
        "non_imponibile": "0.000000",
        "totale_pagare": "231.800000",
        "applica_ritenute": "0",
        "rivalsa_inps_name": "INPS",
        "cassa_previdenza_name": "Cassa previdenza",
        "altra_ritenuta_name": "ENASARCO",
        "all_iva": {
            "b8a4ff89-59b0-6114-96d6-5717c45712d4": 41.7999999999999971578290569595992565155029296875
        },
        "all_iva_tot": {
            "b8a4ff89-59b0-6114-96d6-5717c45712d4": 190
        },
        "note_documento": "",
        "template_stampa": "base",
        "parent_type": null,
        "parent_id": null,
        "colli": "",
        "peso": "",
        "annotazioni": "",
        "casuale_trasporto": "",
        "trasporto_cura_di": "",
        "luogo_destinazione": "",
        "PA_doc_emesso_per": null,
        "PA_iddocumento": null,
        "PA_data_ordine": null,
        "PA_cup": null,
        "PA_cig": null,
        "PA_codicedestinatario": null,
        "PA_esigibilitaiva": "",
        "PA_modalitapagamento": null,
        "PA_istitutofinanziario": null,
        "PA_iban": null,
        "PA_beneficiario": null,
        "PA_tipodocumento": null,
        "PA_causale": null,
        "id_social_invoice": null,
        "ricavo": "190.000000",
        "intestatari_multipli": null,
        "rf_id_contatto": "",
        "rf_contatto_nome": "",
        "rf_contatto_ragione_sociale": "",
        "rf_contatto_partita_iva": "",
        "rf_contatto_codice_fiscale": "",
        "rf_contatto_indirizzo_via": "",
        "rf_contatto_indirizzo_citta": "",
        "rf_contatto_indirizzo_cap": "",
        "rf_contatto_indirizzo_provincia": "",
        "rf_contatto_indirizzo_nazione": "IT",
        "rf_contatto_indirizzo_extra": null,
        "rf_enable": "0",
        "PA_abi": null,
        "PA_cab": null,
        "PA_bic": null,
        "PA_giorni_termini_pagamento": null,
        "regole": "[]",
        "id_centro_costo": "[\"\"]",
        "id_marca_da_bollo": "125333",
        "nascondi_iva": "0",
        "iva_totale": "41.800000",
        "id_pagamento": "",
        "marca_da_bollo_dm62146": "0",
        "imponibile_fix": "0.000000",
        "iva_totale_fix": {
            "b8a4ff89-59b0-6114-96d6-5717c45712d4": ""
        },
        "data_primo_invio_fe": null,
        "imponibile_faqm": "25202.279900",
        "prodotti_ritenuta_totale": "0.000000",
        "contatto_codice_destinatario": "",
        "tipo_invio_fe": null,
        "altridatigestionali": "",
        "altridatigestionali_riferimento_testo": "",
        "contributo_solidarieta_percent": "0.000000",
        "contributo_solidarieta_value": "0.000000",
        "contributo_solidarieta_su_totale": "0.000000",
        "contributo_aggiuntivo_percent": "0.000000",
        "contributo_aggiuntivo_value": "0.000000",
        "contributo_aggiuntivo_su_totale": "0.000000",
        "imponibile_faqm_mesi": "",
        "numero_fattura_elettronica": null,
        "stato_fattura_elettronica": null,
        "fattura_elettronica_b2b_advanced": "0",
        "iva_totale_detraibile": "41.800000",
        "enpals_disable_aaart33841192": "0",
        "valuta_documento": "e994378e-c24b-12e2-cb41-5717c48cdc99",
        "cambio_valuta": "1.000000",
        "cambio_valuta_default": "1.000000",
        "contatto_telefono": "",
        "contatto_cellulare": "",
        "id_codedocumento": null,
        "contatto_flagOpposizione": "0",
        "pagamentoTracciato": "0",
        "spesa_sanitaria_abilitata": "0",
        "tipo_spesa": null,
        "tipo_spesa_flag": null,
        "spesa_sanitaria_stato": "9",
        "non_rimborsabile": "0",
        "contratto_estimatorio_conto_visione": "0",
        "contatto_numero_cig": null,
        "abbuono": "0.000000",
        "nascondi_sconti": "0",
        "id_prodotto_listino": "",
        "autofattura_cedente_cessionario": "0",
        "contatto_id_regimefiscale": "",
        "not_insert_marca_da_bollo": "0",
        "xml_other": "[]",
        "tot_pagare": "0.000000",
        "tot_patrimoniale": "0.000000",
        "anno": "2026",
        "scaricato_pdf": "1",
        "scaricato_pdf_data": "2026-10-30 11:28:42",
        "marca_da_bollo_pa_natura": "",
        "xml_other_contatto": "[]",
        "pagamenti": null,
        "raggruppa_pagamenti_automatici": "0",
        "tot_anticipazioni": "0.000000",
        "id_users_groups": null,
        "doc_to_type": "0",
        "doc_to": "fatture",
        "anno_provvigioni": "2026",
        "imponibile_faqm_enasarco": "0.000000",
        "iva_scissione_pagamenti": "0.000000",
        "xml_other_pagamento": null,
        "contatto_iban": null,
        "show_pagamenti_fe": "0",
        "altridatigestionali_riferimento_numero": "0,00",
        "altridatigestionali_riferimento_data": null,
        "id_rsm_tipocessione": null,
        "prodotti": [
            {
                "id_prodotto_invoice": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
                "data_inserimento": "2026-11-18 10:29:21",
                "data_modifica": "2026-11-18 10:29:21",
                "id_invoice": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
                "id_prodotto": null,
                "nome": "Monitor",
                "codice": "LS123SD",
                "quantita": "2.000000",
                "unita_misura": "",
                "prezzo_netto": "100.000000",
                "prezzo_lordo": "122.000000",
                "prezzo_scontato": "95.000000",
                "iva": "b8a4ff89-59b0-6114-96d6-5717c45712d4",
                "importo_totale": "190.000000",
                "note": "",
                "sconto": "5.000000",
                "non_imponibile": "0",
                "applica_ritenute": "0",
                "in_ddt": "0",
                "ordine": "0",
                "tipo_riga": "0",
                "PA_data_inizio_periodo": null,
                "PA_data_fine_periodo": null,
                "scarica_da_magazzino": "0",
                "id_movimento_magazzino_rif": null,
                "id_centro_costo": "",
                "id_categoria_vendita": "",
                "tipo_categoria_vendita": null,
                "id_rsm_tipomerce": null,
                "id_monofase": null,
                "tipo_spesa": null,
                "tipo_spesa_flag": null,
                "id_prodotto_ddt_rif": "",
                "xml_other": null,
                "sconti": "",
                "sconto_riservato": "0",
                "importo_totale_iva": "231.800000",
                "altre_ritenute_acconto_totale": "0.000000",
                "altre_ritenute_altre_totale": "0.000000",
                "iva_totale_detraibile": "41.800000",
                "cassa_previdenza_totale": "0.000000",
                "marca_da_bollo": "0.000000",
                "rivalsa_inps_totale": "0.000000",
                "id_rif_prodotto_quote": "",
                "modificatore": "[]",
                "categoria_vendita": ""
            }
        ],
        "cointestatari": [],
        "scadenze_pagamenti": [
            {
                "id_scadenza_pagamento": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
                "data_inserimento": "2026-11-18 10:29:21",
                "data_modifica": "2026-11-18 10:29:21",
                "ammontare": "231.8000",
                "ammontare_valuta": "e994378e-c24b-12e2-cb41-5717c48cdc99",
                "termini": "0",
                "scadenza": "2026-10-30",
                "id_conto": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
                "data_saldo": "2026-10-30",
                "parent_type": "fatture",
                "parent_id": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
                "id_contatto": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
                "tipo_scadenza": "0",
                "ritenuta_bonifico_dl78_2010": "0.0000",
                "ammontare_iva": "41.8000",
                "id_pagamento": "",
                "commissioni": "0.0000",
                "sollecito_enable": "0",
                "ritenuta_ristrutturazione": "0",
                "ammontare_istituzionale_cs": "0.0000",
                "ammontare_istituzionale_cs_iva": "0.0000",
                "saldato": "1",
                "ammontare_commerciale": "0.0000",
                "ammontare_commerciale_iva": "0.0000",
                "note": "",
                "id_pagamento_log": null,
                "id_settings_pagamento": "",
                "ammontare_sponsor": "0.0000"
            }
        ],
        "simbolo_valuta": "€",
        "url": "https://app.winddoc.com/sct/XXXXXXX",
        "url_dir": "https://app.winddoc.com/sct/XXXXX"
    }
}
Ricevute ricevute.elimina
Eliminazione di una Ricevuta

Evento richiamato quando viene eliminata una ricevuta.

Payload di esempio
{
    "model": "fatture",
    "event": "elimina",
    "data": {
        "id_invoice": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
    }
}

WindDoc No-Profit 3

Soci associazioni_soci.aggiungi
Aggiunta di un socio

Evento richiamato quando viene inserito un nuovo socio.

Payload di esempio
{
    "model": "associazioni_soci",
    "event": "aggiungi",
    "data": {
        "id_associazione_socio": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "id_contatto": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "data_iscrizione": "2026-01-15",
        "data_accettazione_iscrizione": "2026-02-20",
        "data_inserimento": "2026-01-15 09:30:00",
        "data_modifica": "2026-11-18 11:12:04",
        "id_contatto_maggiorenne": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "id_carica_socio": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "data_dimissione": null,
        "stato_socio": "1",
        "numero_tessera": "TESS-2026-001",
        "id_carica_socio_altre": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX;XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "note": "Socio fondatore",
        "campo1": null,
        "campo2": null,
        "campo3": null,
        "campo4": null,
        "campo5": null,
        "id_sede": null,
        "campo6": null,
        "campo7": null,
        "campo8": null,
        "campo9": null,
        "campo10": null,
        "campo11": null,
        "campo12": null,
        "campo13": null,
        "campo14": null,
        "campo15": null,
        "campo16": null,
        "campo17": null,
        "campo18": null,
        "campo19": null,
        "campo20": null,
        "id_associazione_form_iscrizione": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "forza_permanenza": "0",
        "tags": "",
        "nome": "Mario",
        "cognome": "Rossi",
        "ragione_sociale": "",
        "partita_iva": "",
        "codice_fiscale": "RSSMRA80A01H501U",
        "data_scadenza_quota": "2027-01-15",
        "data_scadenza_quota_notifica": "0",
        "peso_votazione": "1.0000",
        "contatto_id_contatto": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "contatto_nome": "Mario",
        "contatto_cognome": "Rossi",
        "contatto_email": "mario.rossi@example.com",
        "contatto_ragione_sociale": "",
        "contatto_partita_iva": "",
        "contatto_codice_fiscale": "RSSMRA80A01H501U",
        "contatto_indirizzo_via": "Via Roma 10",
        "contatto_indirizzo_citta": "Milano",
        "contatto_indirizzo_cap": "20121",
        "contatto_indirizzo_provincia": "MI",
        "contatto_indirizzo_nazione": "IT",
        "contatto_indirizzo_extra": "Via Roma 10",
        "contatto_iva": "",
        "contatto_data_nascita": "1980-01-01",
        "contatto_telefono": "0212345678",
        "contatto_cellulare": "3331234567",
        "contatto_nazione_nascita": "IT",
        "contatto_citta_nascita": "Milano (MI)",
        "contatto_provincia_nascita": "MI",
        "data_scadenza_rinnovo": "2027-01-15",
        "deve_rinnovare": false,
        "carica_socio_nome": "Presidente"
    }
}
Soci associazioni_soci.modifica
Modifica di un socio

Evento richiamato quando viene modificato un socio.

Payload di esempio
{
    "model": "associazioni_soci",
    "event": "modifica",
    "data": {
        "id_associazione_socio": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "id_contatto": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "data_iscrizione": "2026-01-15",
        "data_accettazione_iscrizione": "2026-02-20",
        "data_inserimento": "2026-01-15 09:30:00",
        "data_modifica": "2026-11-18 11:12:04",
        "id_contatto_maggiorenne": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "id_carica_socio": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "data_dimissione": null,
        "stato_socio": "1",
        "numero_tessera": "TESS-2026-001",
        "id_carica_socio_altre": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX;XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "note": "Socio fondatore",
        "campo1": null,
        "campo2": null,
        "campo3": null,
        "campo4": null,
        "campo5": null,
        "id_sede": null,
        "campo6": null,
        "campo7": null,
        "campo8": null,
        "campo9": null,
        "campo10": null,
        "campo11": null,
        "campo12": null,
        "campo13": null,
        "campo14": null,
        "campo15": null,
        "campo16": null,
        "campo17": null,
        "campo18": null,
        "campo19": null,
        "campo20": null,
        "id_associazione_form_iscrizione": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "forza_permanenza": "0",
        "tags": "",
        "nome": "Mario",
        "cognome": "Rossi",
        "ragione_sociale": "",
        "partita_iva": "",
        "codice_fiscale": "RSSMRA80A01H501U",
        "data_scadenza_quota": "2027-01-15",
        "data_scadenza_quota_notifica": "0",
        "peso_votazione": "1.0000",
        "contatto_id_contatto": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "contatto_nome": "Mario",
        "contatto_cognome": "Rossi",
        "contatto_email": "mario.rossi@example.com",
        "contatto_ragione_sociale": "",
        "contatto_partita_iva": "",
        "contatto_codice_fiscale": "RSSMRA80A01H501U",
        "contatto_indirizzo_via": "Via Roma 10",
        "contatto_indirizzo_citta": "Milano",
        "contatto_indirizzo_cap": "20121",
        "contatto_indirizzo_provincia": "MI",
        "contatto_indirizzo_nazione": "IT",
        "contatto_indirizzo_extra": "Via Roma 10",
        "contatto_iva": "",
        "contatto_data_nascita": "1980-01-01",
        "contatto_telefono": "0212345678",
        "contatto_cellulare": "3331234567",
        "contatto_nazione_nascita": "IT",
        "contatto_citta_nascita": "Milano (MI)",
        "contatto_provincia_nascita": "MI",
        "data_scadenza_rinnovo": "2027-01-15",
        "deve_rinnovare": false,
        "carica_socio_nome": "Presidente"
    }
}
Soci associazioni_soci.elimina
Eliminazione di un socio

Evento richiamato quando viene eliminato un socio.

Payload di esempio
{
    "model": "associazioni_soci",
    "event": "elimina",
    "data": {
        "id_associazione_socio": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
    }
}

Sicurezza, timeout e retry

  • Metodo: sempre POST con Content-Type: application/json.
  • Timeout: il tuo endpoint deve rispondere entro 10 secondi con un codice 2xx.
  • Retry: in caso di errore o timeout riproviamo con backoff esponenziale (fino a 5 tentativi).
  • Test: dalla gestione puoi usare il pulsante Test per inviare una chiamata di prova al tuo URL.
  • Idempotenza: usa l'ID della risorsa ricevuta (X-Webhook-Id nella sezione header) per evitare duplicati lato tuo.