Фискальные документы

Фактуры, кредит- и дебет-ноты продаж так, как их выпустила налоговая: номер, дата, налог, аннулирование и PDF.

Загружаем поисковый индекс…

Фискальные документы

Объекты

FiscalDocument

  • idintegerобязательно

    ID записи, уникальный среди записей своего вида в магазине.

  • typestringобязательно

    invoice — фактура продажи; credit_note — кредит-нота: возврат, уменьшение заказа или аннулирование фактуры; debit_note — дебет-нота: увеличение заказа после фактуры.

    Значения:
    invoicecredit_notedebit_note
  • statusstringобязательно

    issued — авторизован налоговой; pending — ждёт выпуска; failed — сбой выпуска, повторяется сам; rejected — отказ налоговой, нужна правка данных; voided — выпуск отменён вместе с продажей, юридического следа нет.

    Значения:
    pendingissuedrejectedfailedvoided
  • status_reasonсловарь string или nullобязательно

    Почему документ в этом статусе — отказ налоговой, сбой или отмена — по языкам магазина; null у выпущенного и ожидающего.

  • legal_entity_idinteger или nullобязательно

    ID юрлица-эмитента; null — документ до разделения продаж по юрлицам, его эмитент — юрлицо по умолчанию.

  • order_idintegerобязательно

    ID заказа.

  • refund_idinteger или nullобязательно

    ID возврата, который документирует кредит-нота; null у остальных документов.

  • related_document_idinteger или nullобязательно

    ID фактуры, которую корректирует нота; null у фактуры.

  • numberstring или nullобязательно

    Номер, как он напечатан в документе, например 0004-00000013; null, пока документ не выпущен.

  • issued_onstring (date) или nullобязательно

    Учётная дата документа, YYYY-MM-DD в часовом поясе магазина: по ней документ попадает в налоговый период. null, пока документ не выпущен.

  • issued_atstring (date-time) или nullобязательно

    Когда налоговая авторизовала документ; null, пока не выпущен.

  • currencystringобязательно

    Валюта сумм, код ISO 4217: валюта магазина.

  • totalinteger или nullобязательно

    Сумма документа с налогом; null у документов, созданных до того, как магазин стал хранить сумму.

  • tax_linesмассив object или nullобязательно

    Налог, авторизованный налоговой, — юридически значимый: его определяет режим юрлица-эмитента, и он может не совпадать с налогом заказа. null, если документ не выпущен, налог не выделяет (фактура C монотрибутиста) или разбивку не восстановить.

    Поля · 6
    • regimestringобязательно

      Какой налог: vat — налог на добавленную стоимость (IVA); income — на прибыль; turnover — оборотный (Ingresos Brutos); municipal — муниципальный сбор; internal — акциз; social — социальные взносы; other — прочее. Налог продажи — vat: класс налога товара классифицирует НДС.

      Значения:
      vatincometurnovermunicipalinternalsocialother
    • kindstringобязательно

      taxed — по ставке; exempt — освобождено законом; untaxed — вне периметра налога. У строк exempt и untaxed rate_bps 0 и amount 0: сумма — в base.

      Значения:
      taxedexemptuntaxed
    • rate_bpsintegerобязательно

      Ставка в базисных пунктах: 2100 — это 21 %.

    • baseintegerобязательно

      База налога, без налога. Цены — с налогом: base + amount — сколько покупатель заплатил за эту часть.

    • amountintegerобязательно

      Сумма налога. Налог продажи считается по ставке для всего заказа: база к ближайшей единице, налог остатком; позиции и доставка получают доли, поэтому их строки в сумме дают строку заказа.

    • jurisdictionstring или nullобязательно

      Провинция или муниципалитет у налогов, которым они нужны (turnover, municipal); иначе null.

  • annulmentobject или nullобязательно

    Фактура снята аннулирующей нотой: в налоговой она осталась, но для продажи больше не действует. null, если не снята.

    Поля · 4
    • annulled_atstring (date-time)обязательно

      Когда фактура снята.

    • document_idinteger или nullобязательно

      ID аннулирующей кредит-ноты.

    • reasonstring или nullобязательно

      Почему снята: order_cancelled — продажу отменили; advance_applied — аванс брони зачтён в чек, его документирует фактура чека; manual — решение человека или приложения, причина словами — в comment. null, если аннулирующую ноту не найти.

      Значения:
      order_cancelledadvance_appliedmanualnull
    • commentstring или nullобязательно

      Причина словами того, кто снял фактуру, у manual; null у снятия системой.

  • dismissalobject или nullобязательно

    Документ снят с контроля: налоговая его отклонила (или не приняла информирование под CAEA), и выпускать его не будут. Статус документа не меняется. null, если не снимали.

    Поля · 2
    • dismissed_atstring (date-time)обязательно

      Когда документ снят с контроля.

    • reasonstringобязательно

      Причина словами того, кто снял.

  • receptorobject или null

    Кому выписан документ; null — розничная продажа без реквизитов. Только со scope customers:read.

    Поля · 5
    • id_typestringобязательно

      Вид идентификатора: tax_id — налоговый номер организации (CUIT в Аргентине); personal_id — налоговый номер физлица (CUIL); national_id — удостоверение личности (DNI); passport — паспорт; none — без идентификатора.

      Значения:
      tax_idpersonal_idnational_idpassportnone
    • id_numberstring или nullобязательно

      Номер идентификатора; null, когда id_type — none.

    • namestring или nullобязательно

      Наименование или полное имя для документа; null, если не задано.

    • tax_statusstringобязательно

      Налоговый статус: registered — плательщик НДС (Responsable Inscripto в Аргентине); small_taxpayer — упрощённый режим (Monotributo); exempt — освобождён от НДС; final_consumer — конечный потребитель; not_categorized — без категории; foreign — иностранный покупатель.

      Значения:
      registeredsmall_taxpayerexemptfinal_consumernot_categorizedforeign
    • addressstring или nullобязательно

      Фискальный адрес одной строкой; null, если не задан.

  • arobject или nullобязательно

    Реквизиты ARCA; null у магазина другой страны, у невыпущенного документа и если реквизиты не восстановить из сохранённого провайдером.

    Поля · 7
    • document_type_codestring или nullобязательно

      Код типа comprobante ARCA: 001 — фактура A, 006 — фактура B, 011 — фактура C; 003, 008, 013 — кредит-ноты A, B, C.

    • point_of_saleinteger или nullобязательно

      Точка продаж (punto de venta).

    • sequence_numberstring или nullобязательно

      Порядковый номер документа в точке продаж, 8 цифр.

    • authorization_kindstringобязательно

      CAE — код выдан при выпуске онлайн; CAEA — заранее выданный код, выпуск в контингенции.

      Значения:
      CAECAEA
    • authorization_codestring или nullобязательно

      Код авторизации: CAE или CAEA.

    • authorization_expires_onstring (date) или nullобязательно

      Срок действия кода авторизации, YYYY-MM-DD; null, если неизвестен.

    • testingbooleanобязательно

      true — выпущен тестовой средой ARCA (homologación): юридической силы нет, проводить как продажу нельзя.

  • created_atstring (date-time)обязательно

    Когда запись создана.

  • updated_atstring (date-time)обязательно

    Когда запись менялась последний раз.

Методы

Фискальные документы, изменённые с указанного момента: фактуры, кредит- и дебет-ноты во всех статусах

get/fiscal-documents

Scope: fiscal: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})$
  • include_deletedboolean

    true — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации.

  • order_idinteger

    Только записи этого заказа.

    Минимум:
    1

Ответы

200Успешно

application/json

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

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

  • 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/fiscal-documents" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN"
Пример ответа · 200
{
  "data": [
    {
      "id": 0,
      "type": "invoice",
      "status": "pending",
      "status_reason": {
        "key": "string"
      },
      "legal_entity_id": 0,
      "order_id": 0,
      "refund_id": 0,
      "related_document_id": 0,
      "number": "string",
      "issued_on": "2026-01-15",
      "issued_at": "2026-01-15T12:00:00Z",
      "currency": "string",
      "total": 0,
      "tax_lines": [
        {
          "regime": "vat",
          "kind": "taxed",
          "rate_bps": 0,
          "base": 0,
          "amount": 0,
          "jurisdiction": "string"
        }
      ],
      "annulment": {
        "annulled_at": "2026-01-15T12:00:00Z",
        "document_id": 0,
        "reason": "order_cancelled",
        "comment": "string"
      },
      "dismissal": {
        "dismissed_at": "2026-01-15T12:00:00Z",
        "reason": "string"
      },
      "receptor": {
        "id_type": "tax_id",
        "id_number": "string",
        "name": "string",
        "tax_status": "registered",
        "address": "string"
      },
      "ar": {
        "document_type_code": "string",
        "point_of_sale": 0,
        "sequence_number": "string",
        "authorization_kind": "CAE",
        "authorization_code": "string",
        "authorization_expires_on": "2026-01-15",
        "testing": true
      },
      "created_at": "2026-01-15T12:00:00Z",
      "updated_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"
}

Фискальный документ

get/fiscal-documents/{document}

Scope: fiscal:read

Параметры

Путь

  • documentintegerобязательно

    ID фискального документа.

Ответы

200Успешно

application/json

Возвращает FiscalDocument

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/fiscal-documents/{document}" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN"
Пример ответа · 200
{
  "id": 0,
  "type": "invoice",
  "status": "pending",
  "status_reason": {
    "key": "string"
  },
  "legal_entity_id": 0,
  "order_id": 0,
  "refund_id": 0,
  "related_document_id": 0,
  "number": "string",
  "issued_on": "2026-01-15",
  "issued_at": "2026-01-15T12:00:00Z",
  "currency": "string",
  "total": 0,
  "tax_lines": [
    {
      "regime": "vat",
      "kind": "taxed",
      "rate_bps": 0,
      "base": 0,
      "amount": 0,
      "jurisdiction": "string"
    }
  ],
  "annulment": {
    "annulled_at": "2026-01-15T12:00:00Z",
    "document_id": 0,
    "reason": "order_cancelled",
    "comment": "string"
  },
  "dismissal": {
    "dismissed_at": "2026-01-15T12:00:00Z",
    "reason": "string"
  },
  "receptor": {
    "id_type": "tax_id",
    "id_number": "string",
    "name": "string",
    "tax_status": "registered",
    "address": "string"
  },
  "ar": {
    "document_type_code": "string",
    "point_of_sale": 0,
    "sequence_number": "string",
    "authorization_kind": "CAE",
    "authorization_code": "string",
    "authorization_expires_on": "2026-01-15",
    "testing": true
  },
  "created_at": "2026-01-15T12:00:00Z",
  "updated_at": "2026-01-15T12:00:00Z"
}

PDF фискального документа — тот же файл, что получает покупатель

get/fiscal-documents/{document}/pdf

Scope: fiscal:read

Параметры

Путь

  • documentintegerобязательно

    ID фискального документа.

Ответы

200Успешно

application/pdf

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

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/fiscal-documents/{document}/pdf" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN"

Выпустить фактуру по закрытой продаже: выпуск идёт в фоне, итог — событием

post/orders/{order}/invoice

Scope: fiscal:write

Параметры

Путь

  • orderintegerобязательно

    ID заказа.

Заголовок

  • Idempotency-Keystringобязательно

    Обязательный ключ попытки, например UUID: дубль этой команды в налоговой не отменить. Повтор с тем же ключом и телом получает сохранённый ответ. Ключ живёт 24 часа.

    Мин. длина:
    1
    Макс. длина:
    255
    Пример:
    8e03978e-40d5-43e8-bc93-6894a57f9324

Ответы

202Принято: исход — по адресу из Location

Заголовки

  • Idempotent-Replayedstring

    true, когда это сохранённый ответ более раннего запроса с тем же Idempotency-Key.

    Значения:
    true
  • Locationstring (uri)обязательно

    Адрес созданной записи, а у принятого к исполнению (202) — адрес, где следить за исходом.

application/json

Возвращает FiscalDocument

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/orders/{order}/invoice" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN" \
  -H 'Idempotency-Key: 8e03978e-40d5-43e8-bc93-6894a57f9324'
Пример ответа · 202
{
  "id": 0,
  "type": "invoice",
  "status": "pending",
  "status_reason": {
    "key": "string"
  },
  "legal_entity_id": 0,
  "order_id": 0,
  "refund_id": 0,
  "related_document_id": 0,
  "number": "string",
  "issued_on": "2026-01-15",
  "issued_at": "2026-01-15T12:00:00Z",
  "currency": "string",
  "total": 0,
  "tax_lines": [
    {
      "regime": "vat",
      "kind": "taxed",
      "rate_bps": 0,
      "base": 0,
      "amount": 0,
      "jurisdiction": "string"
    }
  ],
  "annulment": {
    "annulled_at": "2026-01-15T12:00:00Z",
    "document_id": 0,
    "reason": "order_cancelled",
    "comment": "string"
  },
  "dismissal": {
    "dismissed_at": "2026-01-15T12:00:00Z",
    "reason": "string"
  },
  "receptor": {
    "id_type": "tax_id",
    "id_number": "string",
    "name": "string",
    "tax_status": "registered",
    "address": "string"
  },
  "ar": {
    "document_type_code": "string",
    "point_of_sale": 0,
    "sequence_number": "string",
    "authorization_kind": "CAE",
    "authorization_code": "string",
    "authorization_expires_on": "2026-01-15",
    "testing": true
  },
  "created_at": "2026-01-15T12:00:00Z",
  "updated_at": "2026-01-15T12:00:00Z"
}

Перевыпустить документ после сбоя или отказа налоговой

post/fiscal-documents/{document}/reissue

Scope: fiscal:write

Параметры

Путь

  • documentstringобязательно

    ID фискального документа.

Заголовок

  • Idempotency-Keystringобязательно

    Обязательный ключ попытки, например UUID: дубль этой команды в налоговой не отменить. Повтор с тем же ключом и телом получает сохранённый ответ. Ключ живёт 24 часа.

    Мин. длина:
    1
    Макс. длина:
    255
    Пример:
    8e03978e-40d5-43e8-bc93-6894a57f9324

Тело запроса application/json

  • receptorobject

    Исправленные реквизиты получателя отклонённой фактуры; переписывают и реквизиты заказа. Только у фактуры: ноты наследуют получателя своей фактуры. Не передавайте, если реквизиты не меняются.

    Поля · 5
    • id_typestring

      Вид идентификатора: tax_id — налоговый номер организации (CUIT в Аргентине); personal_id — налоговый номер физлица (CUIL); national_id — удостоверение личности (DNI); passport — паспорт; none — без идентификатора.

      Значения:
      tax_idpersonal_idnational_idpassportnone
    • id_numberstring или null

      Номер идентификатора; null, когда id_type — none.

      Макс. длина:
      32
    • namestring или null

      Наименование или полное имя для документа; null, если не задано.

      Макс. длина:
      255
    • tax_statusstring

      Налоговый статус: registered — плательщик НДС (Responsable Inscripto в Аргентине); small_taxpayer — упрощённый режим (Monotributo); exempt — освобождён от НДС; final_consumer — конечный потребитель; not_categorized — без категории; foreign — иностранный покупатель.

      Значения:
      registeredsmall_taxpayerexemptfinal_consumernot_categorizedforeign
    • addressstring или null

      Фискальный адрес одной строкой; null, если не задан.

      Макс. длина:
      255
  • refresh_receptorboolean

    true — перечитать реквизиты из текущего профиля покупателя заказа (PUT /v1/customers/{customer}/fiscal-profile). Вместе с receptor нельзя.

Ответы

202Принято: исход — по адресу из Location

Заголовки

  • Idempotent-Replayedstring

    true, когда это сохранённый ответ более раннего запроса с тем же Idempotency-Key.

    Значения:
    true
  • Locationstring (uri)обязательно

    Адрес созданной записи, а у принятого к исполнению (202) — адрес, где следить за исходом.

application/json

Возвращает FiscalDocument

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/fiscal-documents/{document}/reissue" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN" \
  -H 'Idempotency-Key: 8e03978e-40d5-43e8-bc93-6894a57f9324' \
  -H "Content-Type: application/json" \
  -d @body.json
Тело запроса — body.json
{
  "receptor": {
    "id_type": "tax_id",
    "id_number": "string",
    "name": "string",
    "tax_status": "registered",
    "address": "string"
  },
  "refresh_receptor": true
}
Пример ответа · 202
{
  "id": 0,
  "type": "invoice",
  "status": "pending",
  "status_reason": {
    "key": "string"
  },
  "legal_entity_id": 0,
  "order_id": 0,
  "refund_id": 0,
  "related_document_id": 0,
  "number": "string",
  "issued_on": "2026-01-15",
  "issued_at": "2026-01-15T12:00:00Z",
  "currency": "string",
  "total": 0,
  "tax_lines": [
    {
      "regime": "vat",
      "kind": "taxed",
      "rate_bps": 0,
      "base": 0,
      "amount": 0,
      "jurisdiction": "string"
    }
  ],
  "annulment": {
    "annulled_at": "2026-01-15T12:00:00Z",
    "document_id": 0,
    "reason": "order_cancelled",
    "comment": "string"
  },
  "dismissal": {
    "dismissed_at": "2026-01-15T12:00:00Z",
    "reason": "string"
  },
  "receptor": {
    "id_type": "tax_id",
    "id_number": "string",
    "name": "string",
    "tax_status": "registered",
    "address": "string"
  },
  "ar": {
    "document_type_code": "string",
    "point_of_sale": 0,
    "sequence_number": "string",
    "authorization_kind": "CAE",
    "authorization_code": "string",
    "authorization_expires_on": "2026-01-15",
    "testing": true
  },
  "created_at": "2026-01-15T12:00:00Z",
  "updated_at": "2026-01-15T12:00:00Z"
}

Снять отклонённый документ с контроля: выпускать его не будут

post/fiscal-documents/{document}/dismiss

Scope: fiscal:write

Параметры

Путь

  • documentstringобязательно

    ID фискального документа.

Заголовок

  • Idempotency-Keystring

    Уникальный ключ попытки, например UUID. Повтор с тем же ключом и телом получает сохранённый ответ вместо второй записи. Ключ живёт 24 часа.

    Мин. длина:
    1
    Макс. длина:
    255
    Пример:
    8e03978e-40d5-43e8-bc93-6894a57f9324

Тело запроса application/json

  • reasonstringобязательно

    Почему документ не будут выпускать, своими словами, от 3 до 500 символов: её спросит налоговый аудит.

    Мин. длина:
    3
    Макс. длина:
    500

Ответы

200Успешно

Заголовки

  • Idempotent-Replayedstring

    true, когда это сохранённый ответ более раннего запроса с тем же Idempotency-Key.

    Значения:
    true

application/json

Возвращает FiscalDocument

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/fiscal-documents/{document}/dismiss" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d @body.json
Тело запроса — body.json
{
  "reason": "string"
}
Пример ответа · 200
{
  "id": 0,
  "type": "invoice",
  "status": "pending",
  "status_reason": {
    "key": "string"
  },
  "legal_entity_id": 0,
  "order_id": 0,
  "refund_id": 0,
  "related_document_id": 0,
  "number": "string",
  "issued_on": "2026-01-15",
  "issued_at": "2026-01-15T12:00:00Z",
  "currency": "string",
  "total": 0,
  "tax_lines": [
    {
      "regime": "vat",
      "kind": "taxed",
      "rate_bps": 0,
      "base": 0,
      "amount": 0,
      "jurisdiction": "string"
    }
  ],
  "annulment": {
    "annulled_at": "2026-01-15T12:00:00Z",
    "document_id": 0,
    "reason": "order_cancelled",
    "comment": "string"
  },
  "dismissal": {
    "dismissed_at": "2026-01-15T12:00:00Z",
    "reason": "string"
  },
  "receptor": {
    "id_type": "tax_id",
    "id_number": "string",
    "name": "string",
    "tax_status": "registered",
    "address": "string"
  },
  "ar": {
    "document_type_code": "string",
    "point_of_sale": 0,
    "sequence_number": "string",
    "authorization_kind": "CAE",
    "authorization_code": "string",
    "authorization_expires_on": "2026-01-15",
    "testing": true
  },
  "created_at": "2026-01-15T12:00:00Z",
  "updated_at": "2026-01-15T12:00:00Z"
}

Аннулировать выпущенную фактуру кредит-нотой

post/fiscal-documents/{document}/annul

Scope: fiscal:annul

Параметры

Путь

  • documentstringобязательно

    ID фискального документа.

Заголовок

  • Idempotency-Keystringобязательно

    Обязательный ключ попытки, например UUID: дубль этой команды в налоговой не отменить. Повтор с тем же ключом и телом получает сохранённый ответ. Ключ живёт 24 часа.

    Мин. длина:
    1
    Макс. длина:
    255
    Пример:
    8e03978e-40d5-43e8-bc93-6894a57f9324

Тело запроса application/json

  • reasonstringобязательно

    Почему фактура снимается, своими словами, от 3 до 500 символов: уходит на аннулирующую ноту и в историю заказа.

    Мин. длина:
    3
    Макс. длина:
    500

Ответы

202Принято: исход — по адресу из Location

Заголовки

  • Idempotent-Replayedstring

    true, когда это сохранённый ответ более раннего запроса с тем же Idempotency-Key.

    Значения:
    true
  • Locationstring (uri)обязательно

    Адрес созданной записи, а у принятого к исполнению (202) — адрес, где следить за исходом.

application/json

Возвращает FiscalDocument

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/fiscal-documents/{document}/annul" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN" \
  -H 'Idempotency-Key: 8e03978e-40d5-43e8-bc93-6894a57f9324' \
  -H "Content-Type: application/json" \
  -d @body.json
Тело запроса — body.json
{
  "reason": "string"
}
Пример ответа · 202
{
  "id": 0,
  "type": "invoice",
  "status": "pending",
  "status_reason": {
    "key": "string"
  },
  "legal_entity_id": 0,
  "order_id": 0,
  "refund_id": 0,
  "related_document_id": 0,
  "number": "string",
  "issued_on": "2026-01-15",
  "issued_at": "2026-01-15T12:00:00Z",
  "currency": "string",
  "total": 0,
  "tax_lines": [
    {
      "regime": "vat",
      "kind": "taxed",
      "rate_bps": 0,
      "base": 0,
      "amount": 0,
      "jurisdiction": "string"
    }
  ],
  "annulment": {
    "annulled_at": "2026-01-15T12:00:00Z",
    "document_id": 0,
    "reason": "order_cancelled",
    "comment": "string"
  },
  "dismissal": {
    "dismissed_at": "2026-01-15T12:00:00Z",
    "reason": "string"
  },
  "receptor": {
    "id_type": "tax_id",
    "id_number": "string",
    "name": "string",
    "tax_status": "registered",
    "address": "string"
  },
  "ar": {
    "document_type_code": "string",
    "point_of_sale": 0,
    "sequence_number": "string",
    "authorization_kind": "CAE",
    "authorization_code": "string",
    "authorization_expires_on": "2026-01-15",
    "testing": true
  },
  "created_at": "2026-01-15T12:00:00Z",
  "updated_at": "2026-01-15T12:00:00Z"
}