Stock imports

Рассчитать изменения и ошибки без записи данных

Возвращает построчный diff, структурированные issues и токен, связанный с файлом, сопоставлением и ревизиями затрагиваемых черновиков. Если issues есть, рядом сохраняется XLSX-отчёт ошибок. Тела у запроса нет. Для initial_stock проверяется и повтор. Повтор — это не совпадение содержимого файла, а пересечение по «юрлицо × склад × дата» с действующими документами прежней загрузки: если такая есть, приходит ошибка file_already_applied — сначала отмените ту загрузку (stockCancelImport). Файл, загруженный частями с другим отбором строк, не пересекается и не мешает. Если ту загрузку уже отменили, но её документ провели заново, приходит ошибка file_document_active: она называет документ, который нужно отменить в журнале. Отменённая загрузка отвечает 409 transfer_cancelled.

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

Request

  • Base URL: https://erp.akeda.ru
  • URL: https://erp.akeda.ru/api/v1/stock/imports/{id}/preview
  • 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

Preview без изменения складских данных

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.