Stock imports

Открыть сессию загрузки файла складского импорта

Файл импорта (XLSX, XLS, ODS, CSV или TSV до 25 МиБ) кладётся прямо в хранилище кабинета по подписанному адресу, мимо API: так его загружают агент по MCP и клиенты без формы. Ответ называет путь байтов: post — один multipart POST на upload.url с полями upload.fields и файлом последним полем upload.file_field; parts — PUT каждой части на upload.direct_urls; api — хранилище подписывать не умеет, байты идут PUT на upload.url этого API с авторизацией. Затем stockFinishUploadSession проверяет размер, контрольную сумму и антивирус, разбирает таблицу и заводит прогон импорта со статусом uploaded и номером сессии — дальше inspect, mapping, preview и apply. Пара kind+mode та же, что у загрузки формой: initial_stock — только create_only, kit_specs — create_only или upsert, document_items — upsert или replace, остальные виды — только upsert. Имена filename и size приняты как синонимы name и size_bytes. Прогон принадлежит открывшему сессию; её открывает пользователь или агент от его имени.

post/api/v1/stock/imports/upload-sessions

Request

  • Base URL: https://erp.akeda.ru
  • URL: https://erp.akeda.ru/api/v1/stock/imports/upload-sessions
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://erp.akeda.ru/oauth2/authorize, token URL https://erp.akeda.ru/oauth2/token, scopes: akeda:delegate)

Request body

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

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

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

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

namestring

Имя файла с расширением xlsx, xls, ods, csv или tsv

mime_typestring

Тип содержимого; по умолчанию — по расширению файла

size_bytesinteger

Точный размер файла в байтах

sha256string

Необязательная контрольная сумма SHA-256 строчными шестнадцатеричными знаками

target_document_idstring uuid
filenamestring

Синоним поля name

sizeinteger

Синоним поля size_bytes

Response

Сессия и адрес для байтов

idstring uuid required
owner_typestring required
owner_idstring
namestring required
mime_typestring required
size_bytesinteger required
sha256string
attributesobject
status'pending' | 'processing' | 'attached' | 'failed' | 'expired' required
failure'infected' | 'size' | 'checksum' | 'storage' | 'owner' | 'aborted' | 'expired'
failure_detailstring
scan_status'pending' | 'clean' | 'infected' | 'skipped'
scan_verdictstring
published_refstring

Номер строки, заведённой по файлу; у почты — id загрузки для upload_ids

expires_atstring date-time required
created_atstring date-time required
completed_atstring date-time

Changes

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