Webhooks

The Smart Receipts API provides a number of events that you can subscribe to. These events are triggered by various actions that occur within the Smart Receipts system. When an event is triggered, Smart Receipts will send a POST request to the webhook URL that you have configured.

Configuration and security

You can setup a webhook by using API endpoint POST /webhooks.

You can verify the webhook signature by following the instructions here.

Event Types

The following events are available:

receipt

This event is triggered when a new receipt is submitted and ready to download. The event payload is as follows:

{
  "return_receipts": [],
  "voiding_receipt": {},
  "returned_receipt": {},
  "voided_receipt": {},
  "uuid": "string",
  "type": "sale",
  "status": "ready",
  "fiscal_id": "string",
  "created_at": "string",
  "gross_amount": 0,
  "transaction_id": "string",
  "document_number": "string",
  "document_date": "string"
}

receipt-error

This event is triggered when the communication with the Tax Authority portal failed.

The event payload is as follows:

{
  "uuid": "string",
  "message": "string",
  "code": "string",
  "sent_at": "datetime"
}

Error codes you can receive are: