Массовые операции

Тысячи записей одним запросом: установить остатки, записать товары, выгрузить заказы. Результат — 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

  • dataмассив BulkOperationобязательно

    Записи страницы.

  • 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"
Пример ответа · 200
{
  "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_idinteger

      ID собранной загрузки частями (/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-Replayedstring

    true, когда это сохранённый ответ более раннего запроса с тем же 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

Отказы метода

Общие отказы — токен, доступ, проверка входа, лимит запросов — может вернуть любой метод, они собраны в каталоге: Ошибки

Пример запроса
curl -X POST "https://api.saleya.app/v1/bulk-operations" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d @body.json
Тело запроса — 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"
    ]
  }
}
Пример ответа · 202
{
  "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"
Пример ответа · 200
{
  "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-Rangestring

    ETag результата из прошлого ответа. Диапазон отдаётся, только если результат с тех пор не дописывался, иначе — целиком (200).

    Пример:
    "52428800"

Ответы

200Успешно

Заголовки

  • Accept-Rangesstring

    bytes — результат отдаётся диапазонами. У сжатого ответа (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-Rangesstring

    bytes — результат отдаётся диапазонами. У сжатого ответа (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

Отказы метода

Общие отказы — токен, доступ, проверка входа, лимит запросов — может вернуть любой метод, они собраны в каталоге: Ошибки

Пример запроса
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-Replayedstring

    true, когда это сохранённый ответ более раннего запроса с тем же 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

Отказы метода

Общие отказы — токен, доступ, проверка входа, лимит запросов — может вернуть любой метод, они собраны в каталоге: Ошибки

Пример запроса
curl -X POST "https://api.saleya.app/v1/bulk-operations/{operation}/cancel" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN"
Пример ответа · 200
{
  "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"
}