Receipt Notification Webhook

The Receipt Notification Webhook is the default webhook provided by anybill.
It notifies your system whenever a receipt is successfully added to the anybill platform for a specific user.

This webhook can be used in two main ways:

• As a push notification mechanism for end users, letting your application know immediately when a new receipt is available.
• As a data delivery mechanism, providing full receipt information in real time for further processing, integration, or analytics.

The example payload shown below represents the default structure. Depending on your integration, the payload can be extended with additional receipt information.

---

Use Cases

• Push notifications for end users
  Notify your application when a receipt has been issued to a user.
  This enables real-time features such as in-app notifications or alerts.
  These events are triggered based on user receipt creation.

• Receipt data processing and analytics
  Receive detailed receipt information for backend systems.
  Use this data for loyalty programs, ERP/CRM syncing, storage, or downstream analytics.
  The data push is triggered by receipt creation but can be extended to support additional workflows.

---

Webhook Request Structure

The endpoint will receive the following properties as a JSON-formatted payload.
All property names are camelCased, ASCII-encoded strings.

Properties

Property Name	Type	Description
receiptId	String	A GUID representing an identifier for the receipt. This ID can be used for further interactions with the receipt.
receiptNr	String	Identifier of the receipt issued by the POS that created the receipt.
storeId	String	A GUID representing the store in the anybill system where the receipt was issued.
externalStoreId	String	The external store ID of the store where the receipt was issued.
externalId	String	Identifies the user in your system.
vendorName	String	The name of the vendor who issued the receipt.
amount	Decimal	The total amount of the receipt, including VAT.
date	DateTimeOffset	The date and time when the receipt was issued.
vendorAddress	Object	The address object corresponding to the store that issued the receipt. (defined below)
lines	Array[Object]	An array of line objects (defined below).

VendorAddress

Property Name	Type	Description
street	String	The street name and number of the vendor's location.
postalCode	String	The postal code of the vendor's location.
city	String	The city where the vendor's store is located.
countryCode	String	The country code (ISO 3166-1 alpha-3 format) corresponding to the vendor's location.

Lines

Property Name	Type	Description
amount	Decimal	The total amount including VAT for the product group purchased.
name	String	The product's name as it appears on the receipt, maintaining the original formatting.
number	String	The SKU (Stock Keeping Unit) number identifying the product.
qty	Decimal	The quantity of the product purchased.
quantityMeasure	QuantityMeasure	A nullable enum indicating the unit of measure (e.g., liters, kg).
pricePerUnit	Decimal	The price per unit of the product.

WARNING

The string parameter quantity in the Line object was deprecated and replaced with the decimal parameter qty.

QuantityMeasure Enum

• Count
• Kilogram
• Lbs
• Meters
• Inches
• Liter
• CubicMeters
• SquareMeters
• KilowattHour

---

Example Payload

{
  "receiptId": "123e4567-e89b-12d3-a456-426614174000",
  "receiptNr": "32048",
  "storeId": "123e4567-e89b-12d3-a456-426614174000",
  "externalStoreId": "23123",
  "externalId": "user_001",
  "date": "2024-07-07T16:18:43+02:00",
  "vendorName": "Examplemarket XYZ",
  "amount": 95.27,
  "vendorAddress": {
    "street": "123 Example Street",
    "postalCode": "12345",
    "city": "Example City",
    "countryCode": "DEU"
  },
  "lines": [
    {
      "amount": 50.00,
      "name": "Organic Milk 1L",
      "number": "SKU123456",
      "qty": 2.0,
      "quantityMeasure": "Count",
      "pricePerUnit": 25.00
    },
    {
      "amount": 45.27,
      "name": "Whole Wheat Bread",
      "number": "SKU654321",
      "qty": 3.0,
      "quantityMeasure": "Count",
      "pricePerUnit": 15.09
    }
  ]
}