DataMatrix

API кодов маркировки rw_datamatrix: список, пакетное создание, смена статуса и удаление.

GET/api/datamatrix

Даты приёмки и отгрузки: ответ GET содержит dmt_accepted_at и dmt_shipped_at (ISO 8601 с часовым поясом или null). Фильтры: dmt_accepted_at_from, dmt_accepted_at_to, dmt_shipped_at_from, dmt_shipped_at_to; дата или точное время с Z/смещением, неверный диапазон — 422. Полная инструкция: смысл дат, правила границ, сортировка, cURL и проверка ответа.

Постраничный список кодов. Нужен datamatrix.view.

Exact/in	`dmt_id`, `dmt_status`, `dmt_wh_id`, `dmt_acceptance_id`, `dmt_order_id`, `dmt_accept_place`, `dmt_order_place`.
Domain	`dmt_domain_id` применяется только для global scope; остальные всегда ограничены своим доменом.
LIKE	`dmt_barcode`, `dmt_datamatrix`.
Статусы	`0`, `1`, `2`.
Сортировка	`dmt_id`, `dmt_status`, `dmt_wh_id`, `dmt_acceptance_id`, `dmt_order_id`, `dmt_created_date`, `dmt_used_date`, `created_at`, `dmt_accepted_at`, `dmt_shipped_at`.

GET /api/datamatrix?dmt_wh_id[]=2&dmt_status[]=0&dmt_barcode=460123&sort=-dmt_id&per_page=100

POST/api/datamatrix

Пакетное создание кодов. Нужен datamatrix.create. Максимум 5000 записей за запрос.

{
  "items": [
    {
      "dmt_wh_id": 2,
      "dmt_status": 0,
      "dmt_acceptance_id": 538,
      "dmt_barcode": "4601234567890",
      "dmt_short_code": "ABC123",
      "dmt_crypto_tail": "....",
      "dmt_datamatrix": "010460123456789021ABC...",
      "dmt_accept_place": 12345,
      "dmt_created_date": "2026-01-14"
    }
  ]
}

dmt_domain_id и dmt_id запрещены в payload.
dmt_domain_id принудительно ставится из текущего пользователя.
dmt_wh_id должен быть доступным складом.
Если dmt_created_date не передан, ставится текущая дата.

{
  "created": 1
}

PUT/api/datamatrix/status

Пакетная смена статуса. Нужен datamatrix.update. Максимум 10000 id за запрос.

{
  "ids": [101, 102, 103],
  "dmt_status": 2
}

Если новый статус 2, поле dmt_used_date ставится в текущую дату. Для других статусов очищается.

{
  "updated": 3,
  "dmt_status": 2
}

DELETE/api/datamatrix

Пакетное удаление кодов. Нужен datamatrix.delete; legacy delete разрешен admin/warehouse_manager.

{
  "ids": [101, 102, 103]
}

Удаляются только записи со статусом dmt_status=0. Остальные считаются skipped.

{
  "deleted": 2,
  "skipped": 1
}