Webhook

Los Webhooks permiten que WindDoc se comunique automáticamente con aplicaciones, sitios web y servicios externos cuando se produce un evento determinado.

A diferencia de las API, que obligan al sistema externo a consultar WindDoc para obtener información, los Webhooks permiten que WindDoc envíe de forma autónoma una notificación al sistema externo en el momento en que ocurre un evento.

Por ejemplo, cuando se crea una nueva factura, se modifica un cliente o se actualiza un producto, WindDoc puede enviar automáticamente los datos a una URL (endpoint) previamente configurada.

De esta forma es posible sincronizar los datos y automatizar los procesos entre WindDoc y otros sistemas, sin necesidad de realizar continuamente solicitudes para comprobar si hay actualizaciones.

Ejemplos de uso

  • Sincronización de contactos: actualizar automáticamente los clientes de un CRM externo cuando se añaden o modifican en WindDoc.
  • Gestión de facturas: recibir una notificación cuando se crea una nueva factura y adquirir automáticamente sus datos.
  • Sincronización de productos: actualizar un e-commerce cuando se modifican productos o la disponibilidad de stock.
  • Automatización de procesos: iniciar procedimientos, notificaciones u operaciones en aplicaciones externas como respuesta a eventos específicos.

Cómo activar los Webhooks

Para utilizar los Webhooks es necesario disponer de una cuenta WindDoc o WindDoc NoProfit.

Si utilizáis una configuración Multiempresa, acceded a la gestión y seleccionad la empresa para la que deseáis activar los Webhooks. La configuración es, de hecho, específica para cada empresa.

  1. 1

    Acceder a la sección Aplicaciones

    Desde el menú lateral izquierdo, acceded a la sección indicada a continuación. En esta sección encontraréis la lista de las aplicaciones e integraciones ya conectadas a vuestra cuenta.

    Configuración → Aplicaciones

  2. 2

    Generar el Token Webhooks

    Para crear una nueva configuración de Webhook, haced clic en el botón Generar Token Webhooks. Una vez completada la generación, en la lista de aplicaciones aparecerá una nueva entrada denominada Webhooks.

  3. 3

    Activar y configurar los Webhooks

    Activated la entrada Webhooks y haced clic en el botón Configurar. En la pantalla de configuración encontraréis el token utilizado para la firma de las solicitudes, que permite al sistema receptor verificar la autenticidad de las notificaciones enviadas por WindDoc. Desde la misma sección podéis configurar cada Webhook disponible.

  4. 4

    Configurar las URL de llamada

    Para cada Webhook que deseéis utilizar, es necesario indicar una URL de destino (endpoint), es decir, la dirección de la página o del servicio externo que deberá recibir las notificaciones enviadas por WindDoc. Después de introducir la URL, podéis utilizar el botón Test para verificar que la dirección configurada sea accesible y que la página responda correctamente a la llamada enviada por WindDoc.

Cómo funcionan

Para cada evento listado en esta página puedes configurar una URL desde la sección Webhook de tu gestión. Cuando ocurre el evento, WindDoc envía una solicitud POST en formato application/json a tu endpoint.

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

Detalles de la llamada

Método POST
Content-Type application/json
Accept application/json
User-Agent WindDoc-Webhooks/1.0

Cada solicitud incluye los siguientes encabezados, que puedes usar para identificar y verificar la llamada:

Encabezado Descripción Ejemplo
X-Webhook-Id Identificador del webhook configurado en tu gestión. a34fd455....
X-Webhook-Event Evento que ha generado la llamada, en la forma model.event. fatture.aggiungi
X-Webhook-Signature Firma HMAC-SHA256 del cuerpo sin procesar de la solicitud, usando como clave el token de firma de la empresa. Formato: sha256=<hex>. sha256=3f9a…

Verificación de la firma

La firma se calcula con hash_hmac('sha256', , ) donde es el cuerpo sin procesar recibido (la cadena JSON exacta, antes de cualquier parsing). Compárala con el encabezado X-Webhook-Signature utilizando una comparación de tiempo constante.

Token de firma (por empresa): a34fd455•••• Lo encontrarás en la sección Webhook de tu gestión.

Ejemplo de verificación:

$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

Atención: la firma se calcula sobre los bytes exactos del cuerpo. Si decodificas y vuelves a codificar el JSON, el orden de las claves, los espacios y los caracteres Unicode pueden cambiar, y la verificación fallará. Usa siempre el cuerpo sin procesar.

General 7

Agenda contatti.aggiungi
Alta de un contacto

Evento que se activa cuando se crea un nuevo contacto.

Payload de ejemplo
{
    "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"
    }
}
Agenda contatti.modifica
Modificación de un contacto

Evento que se activa cuando se modifica un contacto.

Payload de ejemplo
{
    "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"
    }
}
Agenda contatti.elimina
Eliminación de un contacto

Evento que se activa cuando se elimina un contacto.

Payload de ejemplo
{
    "model": "contatti",
    "event": "elimina",
    "data": {
        "id_contatto": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
    }
}
Productos y Servicios prodotti.aggiungi
Alta de un producto

Evento que se activa cuando se crea un nuevo producto.

Payload de ejemplo
{
    "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": ""
    }
}
Productos y Servicios prodotti.modifica
Modificación de un producto

Evento que se activa cuando se modifica un producto.

Payload de ejemplo
{
    "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": ""
    }
}
Productos y Servicios prodotti.elimina
Eliminación de un producto

Evento que se activa cuando se elimina un producto.

Payload de ejemplo
{
    "model": "prodotti",
    "event": "elimina",
    "data": {
        "id_prodotto": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
    }
}
Productos y Servicios prodotti.magazzino
Movimiento de almacén

Evento que se activa cuando cambia el stock de un producto.

Payload de ejemplo
{
    "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

Facturación fatture.aggiungi
Alta de un documento

Evento que se activa cuando se crea un nuevo documento.

Payload de ejemplo
{
    "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"
    }
}
Facturación fatture.modifica
Modificación de un documento

Evento que se activa cuando se modifica un documento.

Payload de ejemplo
{
    "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"
    }
}
Facturación fatture.elimina
Eliminación de un documento

Evento que se activa cuando se elimina un documento.

Payload de ejemplo
{
    "model": "fatture",
    "event": "elimina",
    "data": {
        "id_invoice": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
    }
}
Recibos ricevute.aggiungi
Alta de un recibo

Evento que se activa cuando se crea un nuevo recibo.

Payload de ejemplo
{
    "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"
    }
}
Recibos ricevute.modifica
Modificación de un recibo

Evento que se activa cuando se modifica un recibo.

Payload de ejemplo
{
    "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"
    }
}
Recibos ricevute.elimina
Eliminación de un recibo

Evento que se activa cuando se elimina un recibo.

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

WindDoc No-Profit 3

Socios associazioni_soci.aggiungi
Alta de un socio

Evento que se activa cuando se crea un nuevo socio.

Payload de ejemplo
{
    "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"
    }
}
Socios associazioni_soci.modifica
Modificación de un socio

Evento que se activa cuando se modifica un socio.

Payload de ejemplo
{
    "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"
    }
}
Socios associazioni_soci.elimina
Eliminación de un socio

Evento que se activa cuando se elimina un socio.

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

Seguridad, timeout y retry

  • Método: siempre POST con Content-Type: application/json.
  • Timeout: tu endpoint debe responder en un plazo de 10 segundos con un código 2xx.
  • Retry: en caso de error o timeout reintentamos con backoff exponencial (hasta 5 intentos).
  • Test: desde tu gestión puedes usar el botón Test para enviar una llamada de prueba a tu URL.
  • Idempotencia: usa el ID del recurso recibido para evitar duplicados en tu lado.