Stock documents

Решить расхождение отправки

Решение расхождения отправки (ERP-2179) документом на её основании: shortage_writeoff — списание недостачи со склада «в пути» на расходы; shortage_claim — то же списание претензией виновнику (contact_id обязателен): Дт 60.01 claim / Кт 41, сторона расчётов claim; return — перемещение со склада «в пути» обратно на склад-отправитель; surplus_receipt — оприходование излишка на склад-получатель по цене отправки (товара, которого в отправке не было, — по средней цене склада-отправителя на дату отправки); regrade — «Принят другой товар» (ERP-2198): строка недостачи товара А (basis_line_id) и строка излишка товара Б (to_basis_line_id) одной отправки закрываются одной пересортицей со склада «в пути» на получателя — Б стоит как А, строки обязательны, количество пары — меньшее из открытых. Без строк — весь открытый хвост (у излишка — весь неоприходованный излишек). post: true проводит сразу, иначе черновик.

Решение без документа — отметка wait (ответ status: marked): «Ждать» по недостаче — остаток строки снова считается ещё в пути, а не недостачей. Пересорт серии расхождением не считается и решения не требует.

Читает Idempotency-Key: повтор с тем же ключом отдаёт тот же документ.

post/api/v1/stock/transit-shipments/{id}/resolve

Request

Base URL: https://erp.akeda.ru
URL: https://erp.akeda.ru/api/v1/stock/transit-shipments/{id}/resolve
Auth: one of:
- HTTP bearer
- API key in header X-Api-Key
- OAuth 2 (authorization code, authorization URL https://erp.akeda.ru/oauth2/authorize, token URL https://erp.akeda.ru/oauth2/token, scopes: akeda:delegate)
- HTTP bearer

Path parameters

idstring uuid required

Headers

X-Tenantstring required

Slug выбранного кабинета; кабинет не является юрлицом

Idempotency-Keystring

Ключ одной логической попытки команды. Единственная форма идемпотентности на уровне HTTP; читают его только операции, у которых этот параметр объявлен.

Повтор ТОГО ЖЕ запроса (метод, адрес с параметрами, тело) с тем же ключом не выполняет команду второй раз, а отдаёт первый успешный ответ с заголовком Idempotent-Replay: true. Тот же ключ с другим запросом — отказ 422 idempotency.key_mismatch, а не чужой ответ. Пока первая попытка ещё выполняется, повтор получает 409 idempotency.in_progress и Retry-After: он не ждёт и не выполняется второй раз.

Ключ принадлежит предъявителю в кабинете: человеку, кабинетному API-ключу или установке приложения. Одинаковый ключ у соседа — другая попытка.

Отказ 4xx ключ ОСВОБОЖДАЕТ: запрос отклонён до работы, в кабинете не изменилось ничего, и исправленный запрос с тем же ключом выполняется. Отказ 5xx ключ ЗАПИРАЕТ: записалось или нет — неизвестно, коммит мог случиться, а ответ до вас не доехать. Повтор с тем же ключом получает тот же статус и тот же машинный код, а команда второй раз не выполняется. Чтобы попробовать снова, прочитайте отдельным запросом, появился ли результат, и возьмите НОВЫЙ ключ.

И ответ, и запомненный отказ живут сутки; после этого тот же ключ — новая попытка, и команда выполняется заново. Ответы, несущие секрет (выдача токена, аренда секрета настройки), заголовок не читают: секрет отдаётся ровно один раз. Хранилище недоступно — 503 idempotency.unavailable, команда без защиты не выполняется; этот отказ приходит ДО заявки на ключ и потому ключ не тратит.

Для естественного ключа интеграции годится любая строка вида crm:order:123:create; UUID не обязателен.

Request body

contact_idstring uuid

datestring date

commentstring

postboolean

true — провести сразу; по умолчанию черновик

Response

Заведённый документ решения — черновик или проведённый

document_idstring uuid

numberstring

type_keystring

statusstring required

Статус документа (draft, posted) или marked у отметки

action'wait' | 'close'

Только у отметки: что отмечено; close — отправка закрыта без документа, qty — остаток, ставший недостачей

linesinteger required

qtystring required

Сумма количеств строк

Changes

No recorded changes to this operation across all 1 revision of this API.