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
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
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
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
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
POST
application/json
application/json
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.
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 10simport hmac, hashlib raw_body = request.get_data() # bytes grezzi expected = 'sha256=' + hmac.new( token.encode('utf-8'), raw_body, hashlib.sha256 ).hexdigest() received = request.headers.get('X-Webhook-Signature', '') if not hmac.compare_digest(expected, received): return 'Firma non valida', 401 payload = request.get_json() # ora puoi parsare # payload = { "model": "...", "event": "...", "data": {...} } return '', 200 # rispondi 2xx entro 10sconst crypto = require('crypto'); const express = require('express'); const app = express(); app.post('/webhook', express.raw({ type: 'application/json' }), (req, res) => { const rawBody = req.body; // Buffer grezzo const expected = 'sha256=' + crypto .createHmac('sha256', token) .update(rawBody) .digest('hex'); const received = req.get('X-Webhook-Signature') || ''; const a = Buffer.from(expected); const b = Buffer.from(received); if (a.length !== b.length || !crypto.timingSafeEqual(a, b)) { return res.status(401).send('Firma non valida'); } const payload = JSON.parse(rawBody.toString('utf8')); // ora puoi parsare res.status(200).end(); // rispondi 2xx entro 10s });package main import ( "crypto/hmac" "crypto/sha256" "encoding/hex" "io" "net/http" ) func webhook(w http.ResponseWriter, r *http.Request) { rawBody, _ := io.ReadAll(r.Body) defer r.Body.Close() mac := hmac.New(sha256.New, []byte(token)) mac.Write(rawBody) expected := "sha256=" + hex.EncodeToString(mac.Sum(nil)) received := r.Header.Get("X-Webhook-Signature") if !hmac.Equal([]byte(expected), []byte(received)) { http.Error(w, "Firma non valida", http.StatusUnauthorized) return } // payload := json.Unmarshal(rawBody, &data) // ora puoi parsare w.WriteHeader(http.StatusOK) // rispondi 2xx entro 10s }require 'openssl' require 'json' raw_body = request.body.read # body grezzo expected = 'sha256=' + OpenSSL::HMAC.hexdigest( 'SHA256', token, raw_body ) received = request.headers['X-Webhook-Signature'].to_s unless OpenSSL.secure_compare(expected, received) halt 401, 'Firma non valida' end payload = JSON.parse(raw_body) # ora puoi parsare status 200 # rispondi 2xx entro 10s# 1) Salva il body grezzo e gli header curl -sS -D headers.txt \ -o body.json \ -H "Content-Type: application/json" \ -X POST "https://tuo-endpoint.example/webhook" # 2) Estrai la firma ricevuta SIG=$(grep -i '^X-Webhook-Signature:' headers.txt | tr -d '\r' | cut -d' ' -f2) # 3) Calcola la firma attesa (HMAC-SHA256 del body grezzo) EXPECTED="sha256=$(openssl dgst -sha256 -hmac "$TOKEN" body.json | awk '{print $2}')" # 4) Confronto if [ "$SIG" = "$EXPECTED" ]; then echo "OK firma valida" else echo "Firma non valida" >&2; exit 1 fi
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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"model": "associazioni_soci",
"event": "elimina",
"data": {
"id_associazione_socio": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
}
}
Sicurezza, timeout e retry
- Metodo: sempre
POSTconContent-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.
