Webhooks📝 Documents

📨 Document status

Description of the event DOCUMENT.STATUSUPDATE

This webhook notification will be triggered for subscriptions under the event DOCUMENT.STATUSUPDATE. It is used to receive notifications about documents that have been sent to the tax bureau and their status updates.

This webhook is related to the /documents endpoint

Event triggers

  • Synchronous countries (issuance and sending happen at the same time)

    • A document changed from draft to issued (this includes tax bureau sending information)

  • Asynchronous countries (issuance and sending happen separately)

    • A document changed from draft to issued (no tax bureau sending information is included yet)
    • A document already issued was sent to the tax bureau
    • A document already sent to the tax bureau was accepted/rejected

Webhook notification format

We will notify you at the subscribed URL every time there is a trigger. We will include the new status and the date when it changed. Please check document statuses for each country to understand how to proceed.

  • event_id: DOCUMENT.STATUSUPDATE
1{
2    "document_id": 123,
3    "account_id": 123,
4    "document_status" : 1,
5    "taxbureau_send_status": 1,
6    "taxbureau_send_id": "XXXXXX",
7    "taxbureau_send_date": "AAAA-MM-DD",
8    "taxbureau_validation_status": 5,
9    "taxbureau_validation_comments": "XXXXX"
10}

Document lifecycle for each country

Below you will find the lists of document statuses for each of the countries available in our API.