Step in a violation case

Вебхук case.step

Технический текст справочника написан на английском.

Sent to the operator of a violation case when a person applies a step of the sanction ladder, lifts a suspension or a cut-off, or closes the case. No step is ever applied automatically. The notice itself is a PDF in Kazakh and Russian in the console; respond_by is the last day on which the operator can answer the step in the console.

Заголовки, которые мы отправляем

Имя	Где	Тип	Обязательный	Описание	Пример
`X-Tanba-Delivery`	заголовок	string (uuid)	да	Identifier of the delivery. It is the same on every retry; use it to ignore duplicates.	`9b2e4c60-1f7a-4d83-a5c6-3e8d0b7f2a11`
`X-Tanba-Event`	заголовок	string	да	The event name.	`approval.issued`
`X-Tanba-Signature`	заголовок	string	да	`t=<unix seconds>,v1=<hex HMAC-SHA256 of t + "." + the raw body, keyed with the webhook secret>`. See the guide on webhook signatures.	`t=1790000000,v1=5f2d9c1a0b7e4d63a8c15e90f4b2d7a3c6e81f0594ab2d3c7e6f1a08b9d4c5e2`

Тело, которое мы отправляем

`application/json`

Имя	Тип	Обязательный	Описание	Пример
`event`	const	да	The event name, the same as in the X-Tanba-Event header.	`"case.step"`
`occurred_at`	string (date-time)	да	When the step was stored.	`"2026-10-14T11:20:00+05:00"`
`data`	object	да	The step.
`data.case`	string	да	Number of the case.	`"CASE-2026-00007"`
`data.step`	string	да	The step of the ladder: notice, prescription, deemed_volume, suspension, cutoff, referral or revocation; empty when the case was closed.	`"prescription"`
`data.state`	string	да	What happened to the step. applied, lifted, closed
`data.applied_at`	string (date-time)	да	When it happened.	`"2026-10-14T11:20:00+05:00"`
`data.respond_by`	string \| null (date-time)	да	The last moment the operator can answer; null when the step has no reply window.	`"2026-10-28T23:59:59+05:00"`
`data.legal_basis_ref`	string	да	The reference to the norm the step rests on; empty for a lift or a closing.	`"ПРОЕКТ: раздел 3, ступени 1–2; п. 12 перечня правовой базы — рекомендация по итогам профилактического контроля"`
`data.draft`	boolean	да	True while the ladder has not been reviewed: the reference to the norm is a draft.	`true`
`data.structure`	string \| null	да	Code of the structure of the case; null for a case on a whole operator.	`"ALM-0012"`

Пример

{
  "event": "case.step",
  "occurred_at": "2026-10-14T11:20:00+05:00",
  "data": {
    "case": "CASE-2026-00007",
    "step": "prescription",
    "state": "applied",
    "applied_at": "2026-10-14T11:20:00+05:00",
    "respond_by": "2026-10-28T23:59:59+05:00",
    "legal_basis_ref": "ПРОЕКТ: раздел 3, ступени 1–2; п. 12 перечня правовой базы — рекомендация по итогам профилактического контроля",
    "draft": true,
    "structure": "ALM-0012"
  }
}

Ответы

200 The delivery is accepted. Any 2xx status counts; the body is ignored.

Без тела.

410 Any other status, or no answer within 10 seconds, counts as a failure and the delivery is retried.

Без тела.