Stock imports

Сохранить сопоставление колонок складского импорта

expected_version реализует compare-and-swap; expected_revision принимается как синоним, оба имени с разными значениями — 400. Неизвестный исходный заголовок, неизвестное целевое поле и повторяющаяся целевая колонка отклоняются как 400; разошедшаяся ревизия и уже применённый прогон — как 409. Сохранение сбрасывает предыдущий preview и его счётчики. defaults — значение поля для всех строк, где колонки нет или ячейка пуста (дата, юрлицо и склад начальных остатков); filter — брать только строки, где колонка равна одному из значений (машина или склад общего файла поставок); value_map — замена значений, которых нет в справочнике (склад «Плеханово» → склад справочника), одним решением на все строки. Прежние ключи полей (product_id, warehouse_id, company_id) принимаются как синонимы product, warehouse, company.

patch/api/v1/stock/imports/{id}/mapping

Request

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

OR

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.