Массовые операции
Тысячи записей одним запросом: установить остатки, записать товары, выгрузить заказы. Результат — NDJSON, строка на строку входа, докачивается диапазонами.
Массовые операции
Объекты
BulkOperation
idintegerобязательноID записи, уникальный среди записей своего вида в магазине.
app_idintegerобязательноID приложения, создавшего операцию.
typestringобязательноВид операции: inventory.set — установка остатков; products.upsert — создание или обновление товаров с вариантами; money_transactions.create — ручные доходы и расходы; money_transactions.update — правка движений денег, например разноска по статьям; orders.export — выгрузка заказов; libro_iva.export — книги Libro IVA Digital юрлица за месяц; accountant_package.export — пакет бухгалтера юрлица за месяц.
- Значения:
inventory.setproducts.upsertmoney_transactions.createmoney_transactions.updateorders.exportlibro_iva.exportaccountant_package.export
statusstringобязательноpending — ждёт запуска; running — идёт; cancelling — остановится после текущей строки; completed — вход пройден целиком или файл собран; cancelled — отменена; failed — остановилась до конца входа или не собрала файл (error).
- Значения:
pendingrunningcancellingcompletedcancelledfailed
inputobject или nullобязательноВход операции: загрузка частями или адрес. null у выгрузки и файла — входа у них нет.
Поля · 5
sourcestringобязательноupload — загрузка частями (/v1/uploads); url — файл, скачанный по адресу.
- Значения:
uploadurl
urlstring или nullобязательноАдрес, с которого скачивается вход; null у загрузки.
file_namestring или nullобязательноИмя загруженного файла; null у адреса.
bytesinteger или nullобязательноРазмер входа в байтах, развёрнутого, если он пришёл в gzip; null, пока неизвестен.
processed_bytesintegerобязательноСколько байт входа пройдено: их доля — прогресс.
paramsobject или nullобязательноПараметры выгрузки или файла, как их приняло создание: у orders.export — фильтры ленты GET /v1/orders (updated_since, number), у libro_iva.export — legal_entity_id, period и books, у accountant_package.export — legal_entity_id и period. null у операции со входом.
linesobjectобязательноСтроки входа: прочитано (вместе с пустыми), исполнено успешно и с отказом. Отказ строки операцию не останавливает, его причина — в результате. У выгрузки — элементы ленты, записанные в результат: read и succeeded равны, failed — 0. У файла — нули: его исход — status, содержимое — архив.
Поля · 3
readintegerобязательноПрочитано строк.
succeededintegerобязательноИсполнено успешно.
failedintegerобязательноОтказано строк.
errorobject или nullобязательноУ failed — почему операция не дошла до конца входа или не собрала файл. У идущей — последний сбой скачивания входа, который ещё повторяется. Иначе null.
Поля · 4
codestringобязательноinvalid_url, blocked_address, unreachable, too_large, access_denied, not_found, rate_limited, http_error — вход не скачался (source_status — у ответа его сервера с ошибкой); input_corrupt — вход не читается, например битый gzip; app_unavailable — приложение удалено или потеряло доступ; scope_revoked — у приложения сняли scope, нужный операции; capability_disabled — у магазина больше нет налогового учёта, который держит данные файла; locations_restricted — приложение ограничили точками, а файл собирается по юрлицу целиком; legal_entity_deleted — юрлицо удалено после создания операции; libro_iva_not_applicable — юрлицо не ведёт Libro IVA Digital; libro_iva_incomplete — документы периода не описать записью книги (documents); processing_failed — внутренний сбой.
- Значения:
invalid_urlblocked_addressunreachabletoo_largeaccess_deniednot_foundrate_limitedhttp_errorinput_corruptapp_unavailablescope_revokedprocessing_failedcapability_disabledlocations_restrictedlegal_entity_deletedlibro_iva_not_applicablelibro_iva_incomplete
messagestringобязательноПричина словами, на языке запроса.
source_statusinteger или nullобязательноHTTP-статус, которым ответил сервер входа, у access_denied, not_found, rate_limited и http_error; иначе null.
documentsмассив object или nullобязательноУ libro_iva_incomplete — документы периода, которые не описать записью книги; их нужно исправить в магазине и создать операцию заново. Иначе null.
Поля · 3
typestringобязательноfiscal_document — фискальный документ из книги продаж; supplier_bill — счёт поставщика из книги покупок или импорта.
- Значения:
fiscal_documentsupplier_bill
idintegerобязательноID записи, уникальный среди записей своего вида в магазине.
reasonstringобязательноПочему документ не описать: missing_request, missing_number — у фискального документа нет запроса ARCA или номера; unknown_document_type, other_ledger_file, broker_fields_required — тип счёта не для этой книги или нужны реквизиты корредора; currency_code_unconfirmed, unsupported_currency, missing_exchange_rate — валюта без кода ARCA или без курса; invalid_vendor_tax_id — неверный CUIT продавца; unknown_tax_rate — ставку не разложить по алькуотам; missing_despacho, unknown_rate — у импорта товаров нет номера оформления или ставки; missing_import_document_kind, missing_import_document_description, unsupported_service_rate, missing_import_tax_payment — у импорта услуг не заполнен документ исполнителя, ставка или уплата налога.
- Значения:
missing_requestmissing_numberunknown_document_typeother_ledger_filebroker_fields_requiredcurrency_code_unconfirmedunsupported_currencymissing_exchange_rateinvalid_vendor_tax_idunknown_tax_ratemissing_despachounknown_ratemissing_import_document_kindmissing_import_document_descriptionunsupported_service_ratemissing_import_tax_payment
result_urlstringобязательноАдрес результата: NDJSON, строка на каждую строку входа по порядку, с исходами уже пройденных строк; у выгрузки — по элементу ленты на строку; у файла — ZIP законченной операции. Докачивается диапазонами.
result_scopesмассив stringобязательноScopes, без которых результат не отдаётся: чтение данных вида и scopes полей, с которыми операция создана, например customers:read у выгрузки заказов с данными покупателей. Набор закреплён при создании; снятый scope останавливает операцию (scope_revoked).
sync_cursorstring или nullобязательноУ завершённой выгрузки — курсор синхронизации ленты, из которой она собрана (GET /v1/orders с теми же params): лента отдаёт по нему изменённое после выгрузки. Иначе null.
created_atstring (date-time)обязательноКогда запись создана.
updated_atstring (date-time)обязательноКогда запись менялась последний раз.
started_atstring (date-time) или nullобязательноКогда операция началась; null, пока в pending.
finished_atstring (date-time) или nullобязательноКогда операция закончилась; null до окончания.
Методы
Массовые операции приложения, изменённые с указанного момента: прогресс и исходы
get/bulk-operations
Scope: bulk:read
Параметры
Строка запроса
limitintegerРазмер страницы: до 250 записей; по умолчанию 50.
- Минимум:
- 1
- Максимум:
- 250
cursorstringНепрозрачный курсор: next_cursor предыдущей страницы или sync_cursor последней страницы, сохранённый прошлой синхронизацией. Список идёт в порядке коммитов, поэтому курсор синхронизации позже отдаёт только изменённое после него.
- Макс. длина:
- 4096
updated_sincestring (date-time)Только записи, изменённые после этого момента, ISO 8601 с часовым поясом. Фильтр первой синхронизации; дальше — курсор.
- Шаблон:
^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{1,6})?(Z|[+-]\d{2}:\d{2})$
typestringТолько операции этого вида.
- Значения:
inventory.setproducts.upsertmoney_transactions.createmoney_transactions.updateorders.exportlibro_iva.exportaccountant_package.export
statusstringТолько операции в этом статусе.
- Значения:
pendingrunningcancellingcompletedcancelledfailed
Ответы
200Успешно
application/json
Записи страницы.
deletedмассив objectобязательноЗаписи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации.
Поля · 2
idintegerобязательноID стёртой записи.
deleted_atstring (date-time)обязательноКогда запись стёрта.
next_cursorstring или nullобязательноКурсор следующей страницы; null на последней.
has_morebooleanобязательноtrue, если есть следующая страница.
sync_cursorstring или nullобязательноНа последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных.
401Токена нет, он неверен, истёк или отозван
Заголовки
WWW-AuthenticatestringобязательноСхема аутентификации (RFC 6750).
- Пример:
Bearer
application/problem+json
Возвращает Problem
403Запрос не разрешают тариф, IP-адрес или scopes токена
Заголовки
WWW-AuthenticatestringСхема аутентификации (RFC 6750).
- Пример:
Bearer error="insufficient_scope", scope="locations:read"
application/problem+json
Возвращает ForbiddenProblem
410Курсор синхронизации старше срока хранения удалений или выдан до восстановления базы
application/problem+json
Возвращает Problem
422Параметр неверен или неизвестен
application/problem+json
Возвращает ValidationProblem
429Лимит запросов исчерпан
Заголовки
Retry-AfterintegerобязательноСколько секунд подождать перед повтором.
- Минимум:
- 0
application/problem+json
Возвращает RateLimitProblem
503Магазин временно недоступен
Заголовки
Retry-AfterintegerСколько секунд подождать перед повтором.
- Минимум:
- 0
application/problem+json
Возвращает Problem
Отказы метода
Общие отказы — токен, доступ, проверка входа, лимит запросов — может вернуть любой метод, они собраны в каталоге: Ошибки
curl "https://api.saleya.app/v1/bulk-operations" \
-H "Authorization: Bearer $SALEYA_API_TOKEN"{
"data": [
{
"id": 0,
"app_id": 0,
"type": "inventory.set",
"status": "pending",
"input": {
"source": "upload",
"url": "string",
"file_name": "string",
"bytes": 0,
"processed_bytes": 0
},
"params": {},
"lines": {
"read": 0,
"succeeded": 0,
"failed": 0
},
"error": {
"code": "invalid_url",
"message": "string",
"source_status": 0,
"documents": [
{
"type": "fiscal_document",
"id": 0,
"reason": "missing_request"
}
]
},
"result_url": "string",
"result_scopes": [
"string"
],
"sync_cursor": "string",
"created_at": "2026-01-15T12:00:00Z",
"updated_at": "2026-01-15T12:00:00Z",
"started_at": "2026-01-15T12:00:00Z",
"finished_at": "2026-01-15T12:00:00Z"
}
],
"deleted": [
{
"id": 0,
"deleted_at": "2026-01-15T12:00:00Z"
}
],
"next_cursor": "string",
"has_more": true,
"sync_cursor": "string"
}Начать массовую операцию по загрузке или адресу входа, выгрузку ленты или сборку файла
post/bulk-operations
Scope: bulk:write
Параметры
Заголовок
Idempotency-KeystringУникальный ключ попытки, например UUID. Повтор с тем же ключом и телом получает сохранённый ответ вместо второй записи. Ключ живёт 24 часа.
- Мин. длина:
- 1
- Макс. длина:
- 255
- Пример:
8e03978e-40d5-43e8-bc93-6894a57f9324
Тело запроса application/json
typestringобязательноВид операции: inventory.set — установка остатков; products.upsert — создание или обновление товаров с вариантами; money_transactions.create — ручные доходы и расходы; money_transactions.update — правка движений денег, например разноска по статьям; orders.export — выгрузка заказов; libro_iva.export — книги Libro IVA Digital юрлица за месяц; accountant_package.export — пакет бухгалтера юрлица за месяц.
- Значения:
inventory.setproducts.upsertmoney_transactions.createmoney_transactions.updateorders.exportlibro_iva.exportaccountant_package.export
inputobjectВход операции: загрузка частями или адрес. null у выгрузки и файла — входа у них нет.
Поля · 2
upload_idintegerID собранной загрузки частями (/v1/uploads).
- Минимум:
- 1
urlstringАдрес, с которого скачивается вход; null у загрузки.
- Макс. длина:
- 2048
paramsobjectПараметры выгрузки или файла, как их приняло создание: у orders.export — фильтры ленты GET /v1/orders (updated_since, number), у libro_iva.export — legal_entity_id, period и books, у accountant_package.export — legal_entity_id и period. null у операции со входом.
Поля · 6
updated_sincestring (date-time)У orders.export — заказы, изменённые после этого момента.
- Шаблон:
^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{1,6})?(Z|[+-]\d{2}:\d{2})$
include_deletedbooleanУ orders.export — ещё и удалённые заказы.
numberstringУ orders.export — только заказ с этим номером.
- Макс. длина:
- 16
legal_entity_idintegerУ libro_iva.export и accountant_package.export — юрлицо, чей файл собирается.
periodstringУ libro_iva.export и accountant_package.export — месяц вида YYYY-MM, не позже текущего месяца магазина.
booksмассив stringУ libro_iva.export — книги: ventas (продажи) и compras (покупки вместе с файлами импорта), одна или обе.
- Мин. элементов:
- 1
- Макс. элементов:
- 2
- Без повторов
- Значения:
ventascompras
Ответы
202Принято: исход — по адресу из Location
Заголовки
Idempotent-Replayedstringtrue, когда это сохранённый ответ более раннего запроса с тем же Idempotency-Key.
- Значения:
true
Locationstring (uri)обязательноАдрес созданной записи, а у принятого к исполнению (202) — адрес, где следить за исходом.
application/json
Возвращает BulkOperation
401Токена нет, он неверен, истёк или отозван
Заголовки
WWW-AuthenticatestringобязательноСхема аутентификации (RFC 6750).
- Пример:
Bearer
application/problem+json
Возвращает Problem
403Запрос не разрешают тариф, IP-адрес или scopes токена
Заголовки
WWW-AuthenticatestringСхема аутентификации (RFC 6750).
- Пример:
Bearer error="insufficient_scope", scope="locations:read"
application/problem+json
Возвращает ForbiddenProblem
409Запрос с тем же ключом идемпотентности ещё исполняется, данные изменились после чтения, внешний id у другой записи, исчерпан лимит тарифа или адресов вебхуков, или правке нужно согласие на последствия
Заголовки
Retry-AfterintegerСколько секунд подождать перед повтором.
- Минимум:
- 0
application/problem+json
Возвращает ConflictProblem
422Параметр неверен или неизвестен
application/problem+json
Возвращает ValidationProblem
429Лимит запросов исчерпан
Заголовки
Retry-AfterintegerобязательноСколько секунд подождать перед повтором.
- Минимум:
- 0
application/problem+json
Возвращает RateLimitProblem
503Магазин временно недоступен
Заголовки
Retry-AfterintegerСколько секунд подождать перед повтором.
- Минимум:
- 0
application/problem+json
Возвращает Problem
Отказы метода
- 403
capability_disabledРесурс недоступен этому магазину - 409
bulk_operation_queue_fullОчередь операций приложения полна - 409
idempotency_key_in_useЗапрос с этим ключом ещё исполняется - 422
idempotency_key_reusedКлюч идемпотентности уже использован - 422
invalid_idempotency_keyКлюч идемпотентности неверен
Общие отказы — токен, доступ, проверка входа, лимит запросов — может вернуть любой метод, они собраны в каталоге: Ошибки
curl -X POST "https://api.saleya.app/v1/bulk-operations" \
-H "Authorization: Bearer $SALEYA_API_TOKEN" \
-H "Content-Type: application/json" \
-d @body.json{
"type": "inventory.set",
"input": {
"upload_id": 1,
"url": "string"
},
"params": {
"updated_since": "2026-01-15T12:00:00Z",
"include_deleted": true,
"number": "string",
"legal_entity_id": 0,
"period": "string",
"books": [
"ventas"
]
}
}{
"id": 0,
"app_id": 0,
"type": "inventory.set",
"status": "pending",
"input": {
"source": "upload",
"url": "string",
"file_name": "string",
"bytes": 0,
"processed_bytes": 0
},
"params": {},
"lines": {
"read": 0,
"succeeded": 0,
"failed": 0
},
"error": {
"code": "invalid_url",
"message": "string",
"source_status": 0,
"documents": [
{
"type": "fiscal_document",
"id": 0,
"reason": "missing_request"
}
]
},
"result_url": "string",
"result_scopes": [
"string"
],
"sync_cursor": "string",
"created_at": "2026-01-15T12:00:00Z",
"updated_at": "2026-01-15T12:00:00Z",
"started_at": "2026-01-15T12:00:00Z",
"finished_at": "2026-01-15T12:00:00Z"
}Массовая операция
get/bulk-operations/{operation}
Scope: bulk:read
Параметры
Путь
operationintegerобязательноID массовой операции.
Ответы
200Успешно
application/json
Возвращает BulkOperation
401Токена нет, он неверен, истёк или отозван
Заголовки
WWW-AuthenticatestringобязательноСхема аутентификации (RFC 6750).
- Пример:
Bearer
application/problem+json
Возвращает Problem
403Запрос не разрешают тариф, IP-адрес или scopes токена
Заголовки
WWW-AuthenticatestringСхема аутентификации (RFC 6750).
- Пример:
Bearer error="insufficient_scope", scope="locations:read"
application/problem+json
Возвращает ForbiddenProblem
404Объекта нет или он недоступен приложению
application/problem+json
Возвращает Problem
422Параметр неверен или неизвестен
application/problem+json
Возвращает ValidationProblem
429Лимит запросов исчерпан
Заголовки
Retry-AfterintegerобязательноСколько секунд подождать перед повтором.
- Минимум:
- 0
application/problem+json
Возвращает RateLimitProblem
503Магазин временно недоступен
Заголовки
Retry-AfterintegerСколько секунд подождать перед повтором.
- Минимум:
- 0
application/problem+json
Возвращает Problem
Общие отказы — токен, доступ, проверка входа, лимит запросов — может вернуть любой метод, они собраны в каталоге: Ошибки
curl "https://api.saleya.app/v1/bulk-operations/{operation}" \
-H "Authorization: Bearer $SALEYA_API_TOKEN"{
"id": 0,
"app_id": 0,
"type": "inventory.set",
"status": "pending",
"input": {
"source": "upload",
"url": "string",
"file_name": "string",
"bytes": 0,
"processed_bytes": 0
},
"params": {},
"lines": {
"read": 0,
"succeeded": 0,
"failed": 0
},
"error": {
"code": "invalid_url",
"message": "string",
"source_status": 0,
"documents": [
{
"type": "fiscal_document",
"id": 0,
"reason": "missing_request"
}
]
},
"result_url": "string",
"result_scopes": [
"string"
],
"sync_cursor": "string",
"created_at": "2026-01-15T12:00:00Z",
"updated_at": "2026-01-15T12:00:00Z",
"started_at": "2026-01-15T12:00:00Z",
"finished_at": "2026-01-15T12:00:00Z"
}Результат массовой операции — NDJSON, строка на строку входа или элемент выгрузки, либо ZIP операции-файла; докачка — по Range
get/bulk-operations/{operation}/result
Scope: bulk:read
Параметры
Путь
operationintegerобязательноID массовой операции.
Заголовок
RangestringОдин диапазон байт для докачки: bytes=<с>- или bytes=<с>-<по>. Результат идущей операции только дописывается: продолжение — bytes=<скачано>- без If-Range, 416 — новых строк пока нет. Несколько диапазонов — ответ целиком.
- Пример:
bytes=1048576-
If-RangestringETag результата из прошлого ответа. Диапазон отдаётся, только если результат с тех пор не дописывался, иначе — целиком (200).
- Пример:
"52428800"
Ответы
200Успешно
Заголовки
Accept-Rangesstringbytes — результат отдаётся диапазонами. У сжатого ответа (Content-Encoding: gzip) заголовка нет: его не докачивают.
- Значения:
bytes
ETagstringобязательноТег результата: меняется, когда результат дописывается. Передайте его в If-Range, чтобы докачать эту же версию. У сжатого ответа тег слабый (W/) и для If-Range не годится.
- Пример:
"52428800"
application/x-ndjson
object или Order
Вариант 1: object
lineintegerобязательноНомер строки входа, с 1.
statusintegerобязательноHTTP-статус, который строка получила бы отдельным запросом.
bodyobjectобязательноОтвет на строку: запись в том виде, в каком её отдаёт одиночный запрос, или отказ problem+json.
application/zip
string (binary)
206Часть результата по Range
Заголовки
Accept-Rangesstringbytes — результат отдаётся диапазонами. У сжатого ответа (Content-Encoding: gzip) заголовка нет: его не докачивают.
- Значения:
bytes
ETagstringобязательноТег результата: меняется, когда результат дописывается. Передайте его в If-Range, чтобы докачать эту же версию. У сжатого ответа тег слабый (W/) и для If-Range не годится.
- Пример:
"52428800"
Content-RangestringобязательноОтданный диапазон и записанная длина: bytes 0-1023/52428800; у 416 — bytes */52428800.
- Пример:
bytes 1048576-52428799/52428800
application/x-ndjson
object или Order
Вариант 1: object
lineintegerобязательноНомер строки входа, с 1.
statusintegerобязательноHTTP-статус, который строка получила бы отдельным запросом.
bodyobjectобязательноОтвет на строку: запись в том виде, в каком её отдаёт одиночный запрос, или отказ problem+json.
application/zip
string (binary)
401Токена нет, он неверен, истёк или отозван
Заголовки
WWW-AuthenticatestringобязательноСхема аутентификации (RFC 6750).
- Пример:
Bearer
application/problem+json
Возвращает Problem
403Запрос не разрешают тариф, IP-адрес или scopes токена
Заголовки
WWW-AuthenticatestringСхема аутентификации (RFC 6750).
- Пример:
Bearer error="insufficient_scope", scope="locations:read"
application/problem+json
Возвращает ForbiddenProblem
404Объекта нет или он недоступен приложению
application/problem+json
Возвращает Problem
409Запрос с тем же ключом идемпотентности ещё исполняется, данные изменились после чтения, внешний id у другой записи, исчерпан лимит тарифа или адресов вебхуков, или правке нужно согласие на последствия
Заголовки
Retry-AfterintegerСколько секунд подождать перед повтором.
- Минимум:
- 0
application/problem+json
Возвращает ConflictProblem
416Диапазон начинается за концом записанного результата
Заголовки
Content-RangestringобязательноОтданный диапазон и записанная длина: bytes 0-1023/52428800; у 416 — bytes */52428800.
- Пример:
bytes 1048576-52428799/52428800
application/problem+json
Возвращает Problem
422Параметр неверен или неизвестен
application/problem+json
Возвращает ValidationProblem
429Лимит запросов исчерпан
Заголовки
Retry-AfterintegerобязательноСколько секунд подождать перед повтором.
- Минимум:
- 0
application/problem+json
Возвращает RateLimitProblem
503Магазин временно недоступен
Заголовки
Retry-AfterintegerСколько секунд подождать перед повтором.
- Минимум:
- 0
application/problem+json
Возвращает Problem
Отказы метода
- 409
bulk_operation_result_unavailableФайла результата нет - 416
range_not_satisfiableДиапазон за концом результата
Общие отказы — токен, доступ, проверка входа, лимит запросов — может вернуть любой метод, они собраны в каталоге: Ошибки
curl "https://api.saleya.app/v1/bulk-operations/{operation}/result" \
-H "Authorization: Bearer $SALEYA_API_TOKEN"Отменить массовую операцию на границе строки
post/bulk-operations/{operation}/cancel
Scope: bulk:write
Параметры
Путь
operationintegerобязательноID массовой операции.
Заголовок
Idempotency-KeystringУникальный ключ попытки, например UUID. Повтор с тем же ключом и телом получает сохранённый ответ вместо второй записи. Ключ живёт 24 часа.
- Мин. длина:
- 1
- Макс. длина:
- 255
- Пример:
8e03978e-40d5-43e8-bc93-6894a57f9324
Ответы
200Успешно
Заголовки
Idempotent-Replayedstringtrue, когда это сохранённый ответ более раннего запроса с тем же Idempotency-Key.
- Значения:
true
application/json
Возвращает BulkOperation
401Токена нет, он неверен, истёк или отозван
Заголовки
WWW-AuthenticatestringобязательноСхема аутентификации (RFC 6750).
- Пример:
Bearer
application/problem+json
Возвращает Problem
403Запрос не разрешают тариф, IP-адрес или scopes токена
Заголовки
WWW-AuthenticatestringСхема аутентификации (RFC 6750).
- Пример:
Bearer error="insufficient_scope", scope="locations:read"
application/problem+json
Возвращает ForbiddenProblem
404Объекта нет или он недоступен приложению
application/problem+json
Возвращает Problem
409Запрос с тем же ключом идемпотентности ещё исполняется, данные изменились после чтения, внешний id у другой записи, исчерпан лимит тарифа или адресов вебхуков, или правке нужно согласие на последствия
Заголовки
Retry-AfterintegerСколько секунд подождать перед повтором.
- Минимум:
- 0
application/problem+json
Возвращает ConflictProblem
422Параметр неверен или неизвестен
application/problem+json
Возвращает ValidationProblem
429Лимит запросов исчерпан
Заголовки
Retry-AfterintegerобязательноСколько секунд подождать перед повтором.
- Минимум:
- 0
application/problem+json
Возвращает RateLimitProblem
503Магазин временно недоступен
Заголовки
Retry-AfterintegerСколько секунд подождать перед повтором.
- Минимум:
- 0
application/problem+json
Возвращает Problem
Отказы метода
- 409
bulk_operation_finishedОперация уже закончилась - 409
idempotency_key_in_useЗапрос с этим ключом ещё исполняется - 422
idempotency_key_reusedКлюч идемпотентности уже использован - 422
invalid_idempotency_keyКлюч идемпотентности неверен
Общие отказы — токен, доступ, проверка входа, лимит запросов — может вернуть любой метод, они собраны в каталоге: Ошибки
curl -X POST "https://api.saleya.app/v1/bulk-operations/{operation}/cancel" \
-H "Authorization: Bearer $SALEYA_API_TOKEN"{
"id": 0,
"app_id": 0,
"type": "inventory.set",
"status": "pending",
"input": {
"source": "upload",
"url": "string",
"file_name": "string",
"bytes": 0,
"processed_bytes": 0
},
"params": {},
"lines": {
"read": 0,
"succeeded": 0,
"failed": 0
},
"error": {
"code": "invalid_url",
"message": "string",
"source_status": 0,
"documents": [
{
"type": "fiscal_document",
"id": 0,
"reason": "missing_request"
}
]
},
"result_url": "string",
"result_scopes": [
"string"
],
"sync_cursor": "string",
"created_at": "2026-01-15T12:00:00Z",
"updated_at": "2026-01-15T12:00:00Z",
"started_at": "2026-01-15T12:00:00Z",
"finished_at": "2026-01-15T12:00:00Z"
}