Stock imports

Атомарно применить подтверждённый preview

Импорт не пишет в регистры: он создаёт и правит типовые черновики складских документов одной транзакцией. Устаревший токен, ошибки в preview и неподтверждённые предупреждения возвращают 409. Повтор с тем же токеном после успеха идемпотентен. Загрузка initial_stock запоминает созданные документы в поле documents. Если другая загрузка успела создать действующие документы с тем же «юрлицо × склад × дата», приходит 409 transfer_duplicate — так же, если действует документ прежней отменённой загрузки с такой же группой; отменённая загрузка отвечает 409 transfer_cancelled.

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

Request

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

Request body

preview_tokenstring required
confirm_warningsboolean

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.