filing.filed
The receipt of a filing was uploaded: it is paid. data.object is the Filing. Live endpoints only. Sent as JSON with a Getbeel-Signature header (t=<unix seconds>,v1=<hex HMAC-SHA256 of "<t>.<raw body>" keyed with your endpoint secret>). Answer 2xx; other answers are retried with backoff for about 3 days.
The receipt of a filing was uploaded: it is paid. data.object is the Filing. Live endpoints only. Sent as JSON with a Getbeel-Signature header (t=,v1=<hex HMAC-SHA256 of "." keyed with your endpoint secret>). Answer 2xx; other answers are retried with backoff for about 3 days.
application/json- body
id*stringobject*stringtype*string"filing.ready""filing.filed""filing.needs_review""filing.changes_requested""filing.approved""filing.skipped""filing.approval_due""tax_deadline.upcoming""tax_deadline.insufficient_funds"created*integerUnix seconds
-9007199254740991 <= value <= 9007199254740991livemode*booleandata*Received
{ "id": "string", "object": "event", "type": "filing.ready", "created": -9007199254740991, "livemode": true, "data": { "object": { "id": "fil_3f2a…", "object": "filing", "type": "bollo", "period": "string", "status": "ready", "approved_at": "2019-08-24T14:15:22Z", "approved_by": "string", "skip_reason": "string", "filed_reference": "string", "extension": { "source_title": "string", "source_url": "string" }, "file_spec": { "id": "lipe:IVP18", "file": "lipe_xml", "name": "string", "version": "IVP18 (schema Versione 1.0)", "approved_by": "Provv. AdE prot. 125654 of 14 March 2024", "source_url": "string", "official_format": true, "tax_year": -9007199254740991, "other_tax_year": true, "provisional": true }, "due_date": "2026-10-29", "amount": "122.00", "currency": "EUR", "f24_lines": [ { "section": "erario", "tax_code": "2523", "reference_month": "string", "reference_year": "2026", "amount": "122.00" } ], "details": { "invoices": [ { "id": "string", "number": "string", "date": "2026-10-29", "list": "A" } ], "pending_invoices": [ { "id": "string", "number": "string", "date": "2026-10-29" } ], "invoices_without_bollo_flag": -9007199254740991, "bollo_threshold_confirmed": true, "deferral": { "pay_by": "september_30" }, "settlement": { "id": "string", "lipe": { "operations_active": "122.00", "operations_passive": "122.00", "vat_due": "122.00", "vat_deducted": "122.00", "vat_balance_debit": "122.00", "vat_balance_credit": "122.00", "previous_debt": "122.00", "previous_credit": "122.00", "annual_credit": "122.00", "car_payments": "122.00", "tax_credits": "122.00", "interest": "122.00", "advance": "122.00", "advance_method": -9007199254740991, "amount_due": "122.00", "amount_credit": "122.00" }, "notes": [ "string" ] }, "lipe": { "year": -9007199254740991, "quarter": -9007199254740991, "declarant": { "fiscal_code": "string", "role": -9007199254740991 }, "modules": [ { "month": -9007199254740991, "quarter": -9007199254740991, "lipe": { "operations_active": "122.00", "operations_passive": "122.00", "vat_due": "122.00", "vat_deducted": "122.00", "vat_balance_debit": "122.00", "vat_balance_credit": "122.00", "previous_debt": "122.00", "previous_credit": "122.00", "annual_credit": "122.00", "car_payments": "122.00", "tax_credits": "122.00", "interest": "122.00", "advance": "122.00", "advance_method": -9007199254740991, "amount_due": "122.00", "amount_credit": "122.00" } } ] }, "vat_return": { "year": -9007199254740991, "model": { "name": "IVA 2026", "tax_year": -9007199254740991, "approved_by": "string", "instructions_url": "string", "technical_specs": "string" }, "lines": [ { "quadro": "VE", "row": "VE23", "field": -9007199254740991, "code": "VE023001", "label": "string", "amount": -9007199254740991 } ], "balance": { "to_pay": -9007199254740991, "credit": -9007199254740991, "tax_code": "6099" }, "volume_d_affari": -9007199254740991, "periods": [ { "period": "string", "settlement_saved": true, "amount_to_pay": 0, "advance": 0, "paid": 0 } ], "issues": [ { "code": "string", "message": "string", "items": [ "string" ], "taxable": 0, "vat": 0 } ], "checks": [ { "rule": "string", "ok": true } ] }, "redditi_pf": { "year": -9007199254740991, "entity": "forfettario", "model": "Redditi PF 2026", "lines": [ { "quadro": "LM", "rigo": "string", "key": "string", "label": "string", "amount": "122.00" } ], "payments": [ { "property1": null, "property2": null } ], "balance_to_pay": 0, "warnings": [ "string" ], "needs_review": true }, "withholdings": [ { "id": "string", "recipient_name": "string", "document_number": "string", "paid_on": "2026-10-29", "withheld_amount": "122.00" } ] }, "checks": { "xsd": { "schema": "string", "valid": true, "issues": [ { "message": "string", "line": -9007199254740991 } ] }, "ade_control_software": "not_run" }, "needs_review": true, "receipt": { "uploaded_at": "2019-08-24T14:15:22Z" }, "completed_at": "2019-08-24T14:15:22Z", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "next_steps": { "file_url": "string", "deep_link": { "url": "string", "label": "string" }, "other_links": [ { "url": "string", "label": "string" } ], "copy_values": [ { "key": "string", "label": "string", "value": "string" } ], "drafts": [ { "id": "bank", "subject": "string", "body": "string" } ], "steps": [ "string" ] } } }}filing.ready Webhook
A filing was prepared or recomputed (F24 ready to pay). data.object is the Filing. Live endpoints only. Sent as JSON with a Getbeel-Signature header (t=<unix seconds>,v1=<hex HMAC-SHA256 of "<t>.<raw body>" keyed with your endpoint secret>). Answer 2xx; other answers are retried with backoff for about 3 days.
tax_deadline.upcoming Webhook
A tax deadline is 7 days or 1 day away and not paid yet (once each). data.object is the TaxDeadline with reminder_days_before. Live endpoints only. Sent as JSON with a Getbeel-Signature header (t=<unix seconds>,v1=<hex HMAC-SHA256 of "<t>.<raw body>" keyed with your endpoint secret>). Answer 2xx; other answers are retried with backoff for about 3 days.