Stock imports

Отменить загрузку начальных остатков целиком

Отменяет все документы «Ввод начальных остатков», которые создала загрузка: проведённые — штатной отменой с теми же проверками, что и stockCancelDocument, черновики закрываются без движений. Уже отменённые и помеченные на удаление документы пропускаются. Всё происходит одной транзакцией: если хотя бы один документ отменить нельзя — например, его остаток уже израсходован, — не отменяется ни один, загрузка остаётся применённой, а ответ 409 transfer_cancel_refused называет документ (document_id, document_number) и причину. После отмены тот же файл можно загрузить снова. Повторный вызов для отменённой загрузки возвращает её без изменений. Другие виды загрузки так не отменяются — 409 transfer_cancel_unsupported; неприменённая загрузка — 409 transfer_not_applied; загрузка без списка документов (сделана до появления связи) — 409 transfer_documents_unknown. Тела у запроса нет.

post/api/v1/stock/imports/{id}/cancel

Request

  • Base URL: https://erp.akeda.ru
  • URL: https://erp.akeda.ru/api/v1/stock/imports/{id}/cancel
  • 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 выбранного кабинета; кабинет не является юрлицом

Response

Отменённая загрузка с её документами

idstring uuid required
kind'initial_stock' | 'inventory_count' | 'document_items' | 'reorder_rules' | 'kit_specs' | 'agent_report_lines' required

Вид складской ЗАГРУЗКИ. Выгрузка шире, у неё свой перечень StockExportKind. agent_report_lines — строки отчёта комиссионера для формы отчёта в «Документах»; прогон только проверяет строки и находит товары, apply его не применяет

format'xlsx' | 'xls' | 'ods' | 'csv' | 'tsv' required
status'uploaded' | 'mapped' | 'previewed' | 'applied' | 'cancelled' required

cancelled — загрузка отменена целиком (stockCancelImport); бывает только у initial_stock

mode'create_only' | 'upsert' | 'replace' required

Режим загрузки: create_only — initial_stock, kit_specs и agent_report_lines; upsert — добавить строки, строки с ID строки обновить (меняются только присланные колонки, CLEAR очищает поле); replace — только document_items, строки файла заменяют все строки черновика

target_document_idstring uuid
source_namestring required
source_sha256string required
source_sizeinteger required
schema_version'stock-v1' required
revisioninteger required
preview_tokenstring
created_countinteger required
updated_countinteger required
unchanged_countinteger required
warning_countinteger required
error_countinteger required
created_byinteger
created_atstring date-time required
previewed_atstring date-time
applied_atstring date-time
cancelled_atstring date-time
source_columnsstring[]
source_valuesobject

Различающиеся значения колонок файла с небольшим набором значений (не больше 30): из них выбирается отбор строк — машина, склад

target_document_typestring

Вид черновика, в который грузятся строки (document_items с target_document_id); target_fields — колонки этого вида

source_samplesobject

До трёх различающихся примеров значений каждой колонки файла

source_filledobject

Число заполненных ячеек каждой колонки файла: заполненная колонка без решения (поле или «-» — не загружать) даёт ошибку column_not_decided

Changes

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