GetbeelDocs

tax_deadline.upcoming

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.

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=,v1=<hex HMAC-SHA256 of "." keyed with your endpoint secret>). Answer 2xx; other answers are retried with backoff for about 3 days.

Request Body

application/json
  1. body
id*string
object*string
type*string
Value in"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*integer

Unix seconds

Range-9007199254740991 <= value <= 9007199254740991
livemode*boolean
data*

Response Body

Received

Example Requests
POST/tax_deadline.upcoming
Request Body
application/json
{  "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"        ]      }    }  }}