---
title: "A bill was received"
method: POST
path: "bill.received"
---

# A bill was received

`POST bill.received` (webhook)

A bill was recorded in a status other than draft or cancelled, or submitted out of draft. Sent once per bill. data.object is the bill as GET /v1/bills/{id} returns it.

## Headers

- `Dynt-Signature` string, required
- `Dynt-Event-Id` string, required
- `Dynt-Event-Type` 'bill.received', required

## Payload

- object
  - `id` string, required: Event id, evt_…; the same on every retry. Deduplicate on it.
  - `type` 'bill.received', required
  - `created_at` string, required: When the change happened (RFC 3339, UTC).
  - `api_version` 'v1', required
  - `data` object, required
    - `object` object, required: A bill the organization received (payable).
      - `id` string, required
      - `number` string, required: Dynt's sequence number for the document.
      - `custom_id` string, nullable, required: The organization's own document number, when set.
      - `approval_status` string, required
      - `currency` string, required
      - `net_amount` string, required: Total before VAT.
      - `vat_amount` string, required: Decimal amount as a string with the currency's own decimals (ISO 4217: 2 for EUR, 0 for JPY, 3 for BHD, 4 for CLF), e.g. "1234.50"; eur_amount always has 2.
      - `total_amount` string, required: Total including VAT.
      - `eur_amount` string, nullable, required: Decimal amount as a string with the currency's own decimals (ISO 4217: 2 for EUR, 0 for JPY, 3 for BHD, 4 for CLF), e.g. "1234.50"; eur_amount always has 2.
      - `fx_rate` string, nullable, required: The stored exchange rate used for eur_amount, as a decimal string; null when none is stored.
      - `issue_date` string, date-time, nullable, required: RFC 3339 date-time in UTC.
      - `due_date` string, date-time, required: RFC 3339 date-time in UTC.
      - `category` object, nullable, required
        - `id` string, required
        - `name` string, required
      - `purchase_order_reference` string, nullable, required
      - `created_at` string, date-time, required: RFC 3339 date-time in UTC.
      - `updated_at` string, date-time, required: RFC 3339 date-time in UTC.
      - `proofs` object[], required
        - `id` string, required
        - `filename` string, required
        - `content_type` string, required
        - `size_bytes` integer, nullable, required: File size in bytes; null when unknown.
        - `created_at` string, date-time, required: When the file was attached.
      - `status` 'draft' | 'received' | 'paid' | 'cancelled' | 'overdue' | 'scheduled', required
      - `type_code` string, required: UNCL1001 document type: 380 invoice, 381 credit note.
      - `vendor` object, nullable, required
        - `id` string, required
        - `name` string, required
        - `tax_number` string, nullable, required
      - `seller_reference` string, nullable, required

## Acknowledgement `2XX`

Received. Any other answer, or none within 10 seconds, is retried.

---

[API](https://skmtc.dev/dynt/apis/dynt-api.md) · [All operations](https://skmtc.dev/dynt/apis/dynt-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dynt/apis/dynt-api/revisions/35825587b87b?raw)