Счета поставщиков

Кредиторка: фактуры, ноты дебета и кредита, долги по поставкам без фактуры — с НДС по ставкам, перцепциями и строками.

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

Счета поставщиков

Объекты

SupplierBill

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

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

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

    Версия записи: растёт с каждым изменением. Чтобы изменить запись, передайте её как ETag в If-Match.

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

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

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

    draft — черновик: в учёт не входит; posted — проведён: входит в кредиторку и книгу покупок и не меняется; void — аннулирован: не входит никуда.

    Значения:
    draftpostedvoid
  • fiscalbooleanобязательно

    false — долг по поставке без фактуры: реквизитов ARCA нет, в книгу покупок не входит; true — фактура или нота.

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

    ID юрлица магазина-покупателя (/v1/legal-entities).

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

    ID поставщика (/v1/suppliers).

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

    ID документа, который корректирует нота; null у фактуры и у ноты без ссылки.

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

    Номер документа, как его ввёл магазин; null у долга без фактуры.

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

    Дата документа, YYYY-MM-DD в часовом поясе магазина.

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

    Налоговый период, в котором документ учтён в книге покупок, YYYY-MM.

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

    Срок оплаты, YYYY-MM-DD в часовом поясе магазина; null — срок не задан.

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

    Валюта документа, ISO 4217: в ней все суммы, кроме base_total.

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

    Курс валюты документа к валюте магазина десятичной строкой; null у документа в валюте магазина.

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

    Облагаемая база НДС.

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

    Освобождённая от НДС сумма.

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

    Не облагаемая НДС сумма.

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

    НДС документа.

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

    Перцепции: суммы, которые поставщик добавил к оплате в счёт будущих налогов магазина.

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

    Внутренние и прочие налоги документа.

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

    Итог документа: база, налоги и перцепции.

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

    Итог в валюте магазина по курсу документа.

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

    Сколько закрыто погашениями в валюте документа: деньгами, зачётом, нотой кредита, авансом, выплатой журнала, вне системы. Любое погашение сдвигает счёт в ленте.

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

    Непогашенная часть в валюте документа: total − paid_total. У ноты кредита — незачтённый кредит; у переплаченного документа отрицательна.

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

    НДС по ставкам: облагаемое, освобождённое и не облагаемое. null — в документе нет налога или ставку облагаемой части не определить.

    Поля · 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.

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

    Налоги сверх НДС: перцепции, удержания, внутренние и прочие. У них в документе только сумма, без базы и ставки.

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

      perception — перцепция: увеличивает сумму к оплате и зачитывается магазином; withholding — удержание: магазин удерживает его при оплате и платит в бюджет, сумма к перечислению уменьшается; internal — внутренние налоги (акцизы); other — прочие.

      Значения:
      perceptionwithholdinginternalother
    • regimestringобязательно

      Какой налог: vat — НДС, income — налог на прибыль, turnover — оборотный (Ingresos Brutos), municipal — муниципальный и другие.

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

      Юрисдикция налога, например провинция Ingresos Brutos; null, если налогу она не нужна.

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

      Сумма налога.

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

      Номер справки об удержании или перцепции; null, если её нет.

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

    Строки документа по порядку; у документа, введённого итогами, строк нет.

    Поля · 8
    • descriptionstringобязательно

      Описание строки, как в документе.

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

      ID варианта товара (/v1/variants); null у строки не о товаре.

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

      Количество десятичной строкой; null, если не указано.

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

      Цена за единицу без налога; null, если не указана.

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

      Сумма строки без налога.

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

      taxed — облагается по ставке; exempt — освобождено; untaxed — не облагается.

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

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

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

      НДС строки.

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

    Реквизиты поставщика, как они стоят в документе: остаются прежними, если карточку поставщика потом исправили.

    Поля · 2
    • tax_idstring или nullобязательно

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

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

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

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

    ID приёмки, которая завела этот долг по поставке; null, если документ заведён не приёмкой.

  • goods_receipt_idsмассив integerобязательно

    ID приёмок, которые покрывает документ (/v1/goods-receipts): поставки, сверенные с фактурой, или поставка долга.

  • purchase_order_idsмассив integerобязательно

    ID заказов поставщику, к которым относится документ (/v1/purchase-orders).

  • supplier_return_idsмассив integerобязательно

    ID возвратов поставщику, за которые выставлена нота кредита (/v1/supplier-returns).

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

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

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

    Сверка с приёмкой: unmatched — не связан с приёмкой; matched — связан и сходится; flagged — связан и расходится. Оплату не блокирует.

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

    Заметка сотрудника; null, если её нет.

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

    Когда документ одобрен к оплате; null, если не одобрен.

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

    Когда документ проведён; null у черновика.

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

    Когда документ аннулирован; null, если не аннулирован.

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

    Реквизиты ARCA фактуры или ноты; null у долга по поставке без фактуры.

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

      Код типа comprobante ARCA: 001 — фактура A, 006 — фактура B, 011 — фактура C; null, если не указан.

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

      Точка продаж поставщика (punto de venta); null, если не указана.

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

      CAE — электронный документ; CAEA — код, выданный на период; CAI — печатный бланк; null — без авторизации (например, зарубежный документ).

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

      Код авторизации; null, если не указан.

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

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

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

      Проверка документа в ARCA: verified — подтверждён; rejected — ARCA его не признала; unavailable — проверить не удалось; pending — ждёт проверки; null — не проверялся.

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

      Зачитываемая часть НДС при пропорциональном зачёте; null — зачитывается весь налог.

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

      Импорт товаров или услуг — своя раскладка книги импорта ARCA; null у внутреннего документа.

      Поля · 9
      • kindstringобязательно

        goods — импорт товаров по таможенному оформлению; services — услуги исполнителя из-за рубежа.

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

        Номер таможенного оформления (despacho) импорта товаров; null, если не указан.

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

        Документ исполнителя услуг: invoice — фактура, contract — договор, other — прочее (с описанием); null, если не указан.

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

        Описание документа вида other; null у прочих.

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

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

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

        Дата уплаты НДС за импорт услуг, YYYY-MM-DD; null, если не указана.

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

        Уплаченный НДС за импорт услуг в валюте документа; null, если не указан.

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

        Идентификатор платежа налога; null, если не указан.

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

        CUIT банка, через который внесён налог; null, если не указан.

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

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

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

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

Методы

Счета поставщиков: фактуры, ноты и долги по поставкам без фактуры с налогом и строками

get/supplier-bills

Scope: procurement: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} в продолжении по курсору синхронизации. Включайте для синхронизации.

  • supplier_idinteger

    Только документы этого поставщика.

    Минимум:
    1

Ответы

200Успешно

application/json

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

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

  • 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/supplier-bills" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN"
Пример ответа · 200
{
  "data": [
    {
      "id": 0,
      "version": 0,
      "kind": "invoice",
      "status": "draft",
      "fiscal": true,
      "legal_entity_id": 0,
      "supplier_id": 0,
      "related_bill_id": 0,
      "number": "string",
      "issued_on": "2026-01-15",
      "tax_period": "string",
      "due_on": "2026-01-15",
      "currency": "string",
      "exchange_rate": "string",
      "net_taxed": 0,
      "net_exempt": 0,
      "net_untaxed": 0,
      "tax_total": 0,
      "perceptions_total": 0,
      "other_taxes_total": 0,
      "total": 0,
      "base_total": 0,
      "paid_total": 0,
      "outstanding": 0,
      "tax_lines": [
        {
          "regime": "vat",
          "kind": "taxed",
          "rate_bps": 0,
          "base": 0,
          "amount": 0,
          "jurisdiction": "string"
        }
      ],
      "additional_taxes": [
        {
          "kind": "perception",
          "regime": "vat",
          "jurisdiction": "string",
          "amount": 0,
          "certificate_number": "string"
        }
      ],
      "lines": [
        {
          "description": "string",
          "variant_id": 0,
          "quantity": "string",
          "unit_amount": 0,
          "net_amount": 0,
          "tax_kind": "taxed",
          "rate_bps": 0,
          "tax_amount": 0
        }
      ],
      "vendor": {
        "tax_id": "string",
        "legal_name": "string"
      },
      "goods_receipt_id": 0,
      "goods_receipt_ids": [
        0
      ],
      "purchase_order_ids": [
        0
      ],
      "supplier_return_ids": [
        0
      ],
      "consignment_settlement_id": 0,
      "match_status": "unmatched",
      "note": "string",
      "approved_at": "2026-01-15T12:00:00Z",
      "posted_at": "2026-01-15T12:00:00Z",
      "voided_at": "2026-01-15T12:00:00Z",
      "ar": {
        "document_type_code": "string",
        "point_of_sale": 0,
        "authorization_kind": "CAE",
        "authorization_code": "string",
        "authorization_expires_on": "2026-01-15",
        "verification_status": "verified",
        "credit_fiscal_amount": 0,
        "import": {
          "kind": "goods",
          "customs_declaration": "string",
          "document_kind": "invoice",
          "document_description": "string",
          "provider_tax_id": "string",
          "tax_paid_on": "2026-01-15",
          "tax_paid_amount": 0,
          "payment_reference": "string",
          "payment_entity_tax_id": "string"
        }
      },
      "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"
}

Создать черновик счёта поставщика

post/supplier-bills

Scope: procurement:write

Параметры

Заголовок

  • Idempotency-Keystring

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

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

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

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

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

    Значения:
    invoicedebit_notecredit_note
  • fiscalbooleanобязательно

    false — долг по поставке без фактуры: реквизитов ARCA нет, в книгу покупок не входит; true — фактура или нота.

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

    ID юрлица магазина-покупателя (/v1/legal-entities).

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

    ID поставщика (/v1/suppliers).

  • related_bill_idinteger или null

    ID документа, который корректирует нота; null у фактуры и у ноты без ссылки.

  • numberstring или null

    Номер документа, как его ввёл магазин; null у долга без фактуры.

    Макс. длина:
    20
  • issued_onstring (date)обязательно

    Дата документа, YYYY-MM-DD в часовом поясе магазина.

  • tax_periodstring

    Налоговый период, в котором документ учтён в книге покупок, YYYY-MM.

  • due_onstring (date) или null

    Срок оплаты, YYYY-MM-DD в часовом поясе магазина; null — срок не задан.

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

    Валюта документа, ISO 4217: в ней все суммы, кроме base_total.

    Значения:
    ARSUSDBRLCLPCOPMXNPENRUB
  • exchange_ratestring или null

    Курс валюты документа к валюте магазина десятичной строкой; null у документа в валюте магазина.

    Макс. длина:
    1000000000000
    Шаблон:
    ^\d{1,14}(\.\d{1,10})?$
  • net_taxedinteger

    Облагаемая база НДС.

    Минимум:
    0
    Максимум:
    10000000000
  • net_exemptinteger

    Освобождённая от НДС сумма.

    Минимум:
    0
    Максимум:
    10000000000
  • net_untaxedinteger

    Не облагаемая НДС сумма.

    Минимум:
    0
    Максимум:
    10000000000
  • tax_totalinteger

    НДС документа.

    Минимум:
    0
    Максимум:
    10000000000
  • totalintegerобязательно

    Итог документа: база, налоги и перцепции.

    Минимум:
    0
    Максимум:
    10000000000
  • notestring или null

    Заметка сотрудника; null, если её нет.

    Макс. длина:
    2000
  • linesмассив object

    Строки документа по порядку; у документа, введённого итогами, строк нет.

    Макс. элементов:
    500
    Поля · 8
    • descriptionstringобязательно

      Описание строки, как в документе.

      Макс. длина:
      300
    • variant_idinteger или null

      ID варианта товара (/v1/variants); null у строки не о товаре.

    • quantitystring или null

      Количество десятичной строкой; null, если не указано.

      Мин. длина:
      0
      Макс. длина:
      1000000000000
      Шаблон:
      ^\d{1,14}(\.\d{1,6})?$
    • unit_amountinteger или null

      Цена за единицу без налога; null, если не указана.

      Минимум:
      0
      Максимум:
      10000000000
    • net_amountintegerобязательно

      Сумма строки без налога.

      Минимум:
      0
      Максимум:
      10000000000
    • tax_kindstringобязательно

      taxed — облагается по ставке; exempt — освобождено; untaxed — не облагается.

      Значения:
      taxedexemptuntaxed
    • rate_bpsinteger

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

      Минимум:
      0
      Максимум:
      10000
    • tax_amountinteger

      НДС строки.

      Минимум:
      0
      Максимум:
      10000000000
  • additional_taxesмассив object

    Налоги сверх НДС: перцепции, удержания, внутренние и прочие. У них в документе только сумма, без базы и ставки.

    Макс. элементов:
    50
    Поля · 5
    • kindstringобязательно

      perception — перцепция: увеличивает сумму к оплате и зачитывается магазином; withholding — удержание: магазин удерживает его при оплате и платит в бюджет, сумма к перечислению уменьшается; internal — внутренние налоги (акцизы); other — прочие.

      Значения:
      perceptionwithholdinginternalother
    • regimestringобязательно

      Какой налог: vat — НДС, income — налог на прибыль, turnover — оборотный (Ingresos Brutos), municipal — муниципальный и другие.

      Значения:
      vatincometurnovermunicipalinternalsocialother
    • jurisdictionstring или null

      Юрисдикция налога, например провинция Ingresos Brutos; null, если налогу она не нужна.

      Макс. длина:
      8
      Шаблон:
      ^[A-Z]{2}-[A-Z0-9]{1,5}$
    • amountintegerобязательно

      Сумма налога.

      Минимум:
      0
      Максимум:
      10000000000
    • certificate_numberstring или null

      Номер справки об удержании или перцепции; null, если её нет.

      Макс. длина:
      64
  • goods_receipt_idsмассив integer

    ID приёмок, которые покрывает документ (/v1/goods-receipts): поставки, сверенные с фактурой, или поставка долга.

    Макс. элементов:
    100
  • purchase_order_idsмассив integer

    ID заказов поставщику, к которым относится документ (/v1/purchase-orders).

    Макс. элементов:
    100
  • supplier_return_idsмассив integer

    ID возвратов поставщику, за которые выставлена нота кредита (/v1/supplier-returns).

    Макс. элементов:
    100
  • arobject или null

    Реквизиты ARCA фактуры или ноты; null у долга по поставке без фактуры.

    Поля · 7
    • document_type_codestring или null

      Код типа comprobante ARCA: 001 — фактура A, 006 — фактура B, 011 — фактура C; null, если не указан.

      Макс. длина:
      3
    • point_of_saleinteger или null

      Точка продаж поставщика (punto de venta); null, если не указана.

      Минимум:
      0
      Максимум:
      99999
    • authorization_kindstring или null

      CAE — электронный документ; CAEA — код, выданный на период; CAI — печатный бланк; null — без авторизации (например, зарубежный документ).

      Значения:
      CAECAEACAInull
    • authorization_codestring или null

      Код авторизации; null, если не указан.

      Макс. длина:
      14
    • authorization_expires_onstring (date) или null

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

    • credit_fiscal_amountinteger или null

      Зачитываемая часть НДС при пропорциональном зачёте; null — зачитывается весь налог.

      Минимум:
      0
      Максимум:
      10000000000
    • importobject или null

      Импорт товаров или услуг — своя раскладка книги импорта ARCA; null у внутреннего документа.

      Поля · 9
      • kindstring

        goods — импорт товаров по таможенному оформлению; services — услуги исполнителя из-за рубежа.

        Значения:
        goodsservices
      • customs_declarationstring или null

        Номер таможенного оформления (despacho) импорта товаров; null, если не указан.

        Макс. длина:
        16
      • document_kindstring или null

        Документ исполнителя услуг: invoice — фактура, contract — договор, other — прочее (с описанием); null, если не указан.

        Значения:
        invoicecontractothernull
      • document_descriptionstring или null

        Описание документа вида other; null у прочих.

        Макс. длина:
        20
      • provider_tax_idstring или null

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

        Макс. длина:
        20
      • tax_paid_onstring (date) или null

        Дата уплаты НДС за импорт услуг, YYYY-MM-DD; null, если не указана.

      • tax_paid_amountinteger или null

        Уплаченный НДС за импорт услуг в валюте документа; null, если не указан.

        Минимум:
        0
        Максимум:
        10000000000
      • payment_referencestring или null

        Идентификатор платежа налога; null, если не указан.

        Макс. длина:
        20
      • payment_entity_tax_idstring или null

        CUIT банка, через который внесён налог; null, если не указан.

        Макс. длина:
        11

Ответы

201Создано

Заголовки

  • Idempotent-Replayedstring

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

    Значения:
    true
  • ETagstringобязательно

    Версия записи. Передайте её в If-Match, чтобы изменить запись.

    Пример:
    "7"
  • Locationstring (uri)обязательно

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

application/json

Возвращает SupplierBill

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/supplier-bills" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d @body.json
Тело запроса — body.json
{
  "kind": "invoice",
  "fiscal": true,
  "legal_entity_id": 0,
  "supplier_id": 0,
  "related_bill_id": 0,
  "number": "string",
  "issued_on": "2026-01-15",
  "tax_period": "string",
  "due_on": "2026-01-15",
  "currency": "ARS",
  "exchange_rate": "string",
  "net_taxed": 0,
  "net_exempt": 0,
  "net_untaxed": 0,
  "tax_total": 0,
  "total": 0,
  "note": "string",
  "lines": [
    {
      "description": "string",
      "variant_id": 0,
      "quantity": "string",
      "unit_amount": 0,
      "net_amount": 0,
      "tax_kind": "taxed",
      "rate_bps": 0,
      "tax_amount": 0
    }
  ],
  "additional_taxes": [
    {
      "kind": "perception",
      "regime": "vat",
      "jurisdiction": "string",
      "amount": 0,
      "certificate_number": "string"
    }
  ],
  "goods_receipt_ids": [
    0
  ],
  "purchase_order_ids": [
    0
  ],
  "supplier_return_ids": [
    0
  ],
  "ar": {
    "document_type_code": "string",
    "point_of_sale": 0,
    "authorization_kind": "CAE",
    "authorization_code": "string",
    "authorization_expires_on": "2026-01-15",
    "credit_fiscal_amount": 0,
    "import": {
      "kind": "goods",
      "customs_declaration": "string",
      "document_kind": "invoice",
      "document_description": "string",
      "provider_tax_id": "string",
      "tax_paid_on": "2026-01-15",
      "tax_paid_amount": 0,
      "payment_reference": "string",
      "payment_entity_tax_id": "string"
    }
  }
}
Пример ответа · 201
{
  "id": 0,
  "version": 0,
  "kind": "invoice",
  "status": "draft",
  "fiscal": true,
  "legal_entity_id": 0,
  "supplier_id": 0,
  "related_bill_id": 0,
  "number": "string",
  "issued_on": "2026-01-15",
  "tax_period": "string",
  "due_on": "2026-01-15",
  "currency": "string",
  "exchange_rate": "string",
  "net_taxed": 0,
  "net_exempt": 0,
  "net_untaxed": 0,
  "tax_total": 0,
  "perceptions_total": 0,
  "other_taxes_total": 0,
  "total": 0,
  "base_total": 0,
  "paid_total": 0,
  "outstanding": 0,
  "tax_lines": [
    {
      "regime": "vat",
      "kind": "taxed",
      "rate_bps": 0,
      "base": 0,
      "amount": 0,
      "jurisdiction": "string"
    }
  ],
  "additional_taxes": [
    {
      "kind": "perception",
      "regime": "vat",
      "jurisdiction": "string",
      "amount": 0,
      "certificate_number": "string"
    }
  ],
  "lines": [
    {
      "description": "string",
      "variant_id": 0,
      "quantity": "string",
      "unit_amount": 0,
      "net_amount": 0,
      "tax_kind": "taxed",
      "rate_bps": 0,
      "tax_amount": 0
    }
  ],
  "vendor": {
    "tax_id": "string",
    "legal_name": "string"
  },
  "goods_receipt_id": 0,
  "goods_receipt_ids": [
    0
  ],
  "purchase_order_ids": [
    0
  ],
  "supplier_return_ids": [
    0
  ],
  "consignment_settlement_id": 0,
  "match_status": "unmatched",
  "note": "string",
  "approved_at": "2026-01-15T12:00:00Z",
  "posted_at": "2026-01-15T12:00:00Z",
  "voided_at": "2026-01-15T12:00:00Z",
  "ar": {
    "document_type_code": "string",
    "point_of_sale": 0,
    "authorization_kind": "CAE",
    "authorization_code": "string",
    "authorization_expires_on": "2026-01-15",
    "verification_status": "verified",
    "credit_fiscal_amount": 0,
    "import": {
      "kind": "goods",
      "customs_declaration": "string",
      "document_kind": "invoice",
      "document_description": "string",
      "provider_tax_id": "string",
      "tax_paid_on": "2026-01-15",
      "tax_paid_amount": 0,
      "payment_reference": "string",
      "payment_entity_tax_id": "string"
    }
  },
  "created_at": "2026-01-15T12:00:00Z",
  "updated_at": "2026-01-15T12:00:00Z"
}

Счёт поставщика

get/supplier-bills/{supplier_bill}

Scope: procurement:read

Параметры

Путь

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

    ID счёта поставщика.

Ответы

200Успешно

Заголовки

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

    Версия записи. Передайте её в If-Match, чтобы изменить запись.

    Пример:
    "7"

application/json

Возвращает SupplierBill

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/supplier-bills/{supplier_bill}" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN"
Пример ответа · 200
{
  "id": 0,
  "version": 0,
  "kind": "invoice",
  "status": "draft",
  "fiscal": true,
  "legal_entity_id": 0,
  "supplier_id": 0,
  "related_bill_id": 0,
  "number": "string",
  "issued_on": "2026-01-15",
  "tax_period": "string",
  "due_on": "2026-01-15",
  "currency": "string",
  "exchange_rate": "string",
  "net_taxed": 0,
  "net_exempt": 0,
  "net_untaxed": 0,
  "tax_total": 0,
  "perceptions_total": 0,
  "other_taxes_total": 0,
  "total": 0,
  "base_total": 0,
  "paid_total": 0,
  "outstanding": 0,
  "tax_lines": [
    {
      "regime": "vat",
      "kind": "taxed",
      "rate_bps": 0,
      "base": 0,
      "amount": 0,
      "jurisdiction": "string"
    }
  ],
  "additional_taxes": [
    {
      "kind": "perception",
      "regime": "vat",
      "jurisdiction": "string",
      "amount": 0,
      "certificate_number": "string"
    }
  ],
  "lines": [
    {
      "description": "string",
      "variant_id": 0,
      "quantity": "string",
      "unit_amount": 0,
      "net_amount": 0,
      "tax_kind": "taxed",
      "rate_bps": 0,
      "tax_amount": 0
    }
  ],
  "vendor": {
    "tax_id": "string",
    "legal_name": "string"
  },
  "goods_receipt_id": 0,
  "goods_receipt_ids": [
    0
  ],
  "purchase_order_ids": [
    0
  ],
  "supplier_return_ids": [
    0
  ],
  "consignment_settlement_id": 0,
  "match_status": "unmatched",
  "note": "string",
  "approved_at": "2026-01-15T12:00:00Z",
  "posted_at": "2026-01-15T12:00:00Z",
  "voided_at": "2026-01-15T12:00:00Z",
  "ar": {
    "document_type_code": "string",
    "point_of_sale": 0,
    "authorization_kind": "CAE",
    "authorization_code": "string",
    "authorization_expires_on": "2026-01-15",
    "verification_status": "verified",
    "credit_fiscal_amount": 0,
    "import": {
      "kind": "goods",
      "customs_declaration": "string",
      "document_kind": "invoice",
      "document_description": "string",
      "provider_tax_id": "string",
      "tax_paid_on": "2026-01-15",
      "tax_paid_amount": 0,
      "payment_reference": "string",
      "payment_entity_tax_id": "string"
    }
  },
  "created_at": "2026-01-15T12:00:00Z",
  "updated_at": "2026-01-15T12:00:00Z"
}

Изменить черновик счёта поставщика

patch/supplier-bills/{supplier_bill}

Scope: procurement:write

Параметры

Путь

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

    ID счёта поставщика.

Заголовок

  • Idempotency-Keystring

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

    Мин. длина:
    1
    Макс. длина:
    255
    Пример:
    8e03978e-40d5-43e8-bc93-6894a57f9324
  • If-Matchstringобязательно

    ETag записи из последнего чтения, например "7". Правка применится, только если запись с тех пор никто не менял, иначе 412. Без заголовка — 428.

    Пример:
    "7"

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

  • kindstring

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

    Значения:
    invoicedebit_notecredit_note
  • fiscalboolean

    false — долг по поставке без фактуры: реквизитов ARCA нет, в книгу покупок не входит; true — фактура или нота.

  • legal_entity_idinteger

    ID юрлица магазина-покупателя (/v1/legal-entities).

  • supplier_idinteger

    ID поставщика (/v1/suppliers).

  • related_bill_idinteger или null

    ID документа, который корректирует нота; null у фактуры и у ноты без ссылки.

  • numberstring или null

    Номер документа, как его ввёл магазин; null у долга без фактуры.

    Макс. длина:
    20
  • issued_onstring (date)

    Дата документа, YYYY-MM-DD в часовом поясе магазина.

  • tax_periodstring

    Налоговый период, в котором документ учтён в книге покупок, YYYY-MM.

  • due_onstring (date) или null

    Срок оплаты, YYYY-MM-DD в часовом поясе магазина; null — срок не задан.

  • currencystring

    Валюта документа, ISO 4217: в ней все суммы, кроме base_total.

    Значения:
    ARSUSDBRLCLPCOPMXNPENRUB
  • exchange_ratestring или null

    Курс валюты документа к валюте магазина десятичной строкой; null у документа в валюте магазина.

    Макс. длина:
    1000000000000
    Шаблон:
    ^\d{1,14}(\.\d{1,10})?$
  • net_taxedinteger

    Облагаемая база НДС.

    Минимум:
    0
    Максимум:
    10000000000
  • net_exemptinteger

    Освобождённая от НДС сумма.

    Минимум:
    0
    Максимум:
    10000000000
  • net_untaxedinteger

    Не облагаемая НДС сумма.

    Минимум:
    0
    Максимум:
    10000000000
  • tax_totalinteger

    НДС документа.

    Минимум:
    0
    Максимум:
    10000000000
  • totalinteger

    Итог документа: база, налоги и перцепции.

    Минимум:
    0
    Максимум:
    10000000000
  • notestring или null

    Заметка сотрудника; null, если её нет.

    Макс. длина:
    2000
  • linesмассив object

    Строки документа по порядку; у документа, введённого итогами, строк нет.

    Макс. элементов:
    500
    Поля · 8
    • descriptionstringобязательно

      Описание строки, как в документе.

      Макс. длина:
      300
    • variant_idinteger или null

      ID варианта товара (/v1/variants); null у строки не о товаре.

    • quantitystring или null

      Количество десятичной строкой; null, если не указано.

      Мин. длина:
      0
      Макс. длина:
      1000000000000
      Шаблон:
      ^\d{1,14}(\.\d{1,6})?$
    • unit_amountinteger или null

      Цена за единицу без налога; null, если не указана.

      Минимум:
      0
      Максимум:
      10000000000
    • net_amountintegerобязательно

      Сумма строки без налога.

      Минимум:
      0
      Максимум:
      10000000000
    • tax_kindstringобязательно

      taxed — облагается по ставке; exempt — освобождено; untaxed — не облагается.

      Значения:
      taxedexemptuntaxed
    • rate_bpsinteger

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

      Минимум:
      0
      Максимум:
      10000
    • tax_amountinteger

      НДС строки.

      Минимум:
      0
      Максимум:
      10000000000
  • additional_taxesмассив object

    Налоги сверх НДС: перцепции, удержания, внутренние и прочие. У них в документе только сумма, без базы и ставки.

    Макс. элементов:
    50
    Поля · 5
    • kindstringобязательно

      perception — перцепция: увеличивает сумму к оплате и зачитывается магазином; withholding — удержание: магазин удерживает его при оплате и платит в бюджет, сумма к перечислению уменьшается; internal — внутренние налоги (акцизы); other — прочие.

      Значения:
      perceptionwithholdinginternalother
    • regimestringобязательно

      Какой налог: vat — НДС, income — налог на прибыль, turnover — оборотный (Ingresos Brutos), municipal — муниципальный и другие.

      Значения:
      vatincometurnovermunicipalinternalsocialother
    • jurisdictionstring или null

      Юрисдикция налога, например провинция Ingresos Brutos; null, если налогу она не нужна.

      Макс. длина:
      8
      Шаблон:
      ^[A-Z]{2}-[A-Z0-9]{1,5}$
    • amountintegerобязательно

      Сумма налога.

      Минимум:
      0
      Максимум:
      10000000000
    • certificate_numberstring или null

      Номер справки об удержании или перцепции; null, если её нет.

      Макс. длина:
      64
  • goods_receipt_idsмассив integer

    ID приёмок, которые покрывает документ (/v1/goods-receipts): поставки, сверенные с фактурой, или поставка долга.

    Макс. элементов:
    100
  • purchase_order_idsмассив integer

    ID заказов поставщику, к которым относится документ (/v1/purchase-orders).

    Макс. элементов:
    100
  • supplier_return_idsмассив integer

    ID возвратов поставщику, за которые выставлена нота кредита (/v1/supplier-returns).

    Макс. элементов:
    100
  • arobject или null

    Реквизиты ARCA фактуры или ноты; null у долга по поставке без фактуры.

    Поля · 7
    • document_type_codestring или null

      Код типа comprobante ARCA: 001 — фактура A, 006 — фактура B, 011 — фактура C; null, если не указан.

      Макс. длина:
      3
    • point_of_saleinteger или null

      Точка продаж поставщика (punto de venta); null, если не указана.

      Минимум:
      0
      Максимум:
      99999
    • authorization_kindstring или null

      CAE — электронный документ; CAEA — код, выданный на период; CAI — печатный бланк; null — без авторизации (например, зарубежный документ).

      Значения:
      CAECAEACAInull
    • authorization_codestring или null

      Код авторизации; null, если не указан.

      Макс. длина:
      14
    • authorization_expires_onstring (date) или null

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

    • credit_fiscal_amountinteger или null

      Зачитываемая часть НДС при пропорциональном зачёте; null — зачитывается весь налог.

      Минимум:
      0
      Максимум:
      10000000000
    • importobject или null

      Импорт товаров или услуг — своя раскладка книги импорта ARCA; null у внутреннего документа.

      Поля · 9
      • kindstring

        goods — импорт товаров по таможенному оформлению; services — услуги исполнителя из-за рубежа.

        Значения:
        goodsservices
      • customs_declarationstring или null

        Номер таможенного оформления (despacho) импорта товаров; null, если не указан.

        Макс. длина:
        16
      • document_kindstring или null

        Документ исполнителя услуг: invoice — фактура, contract — договор, other — прочее (с описанием); null, если не указан.

        Значения:
        invoicecontractothernull
      • document_descriptionstring или null

        Описание документа вида other; null у прочих.

        Макс. длина:
        20
      • provider_tax_idstring или null

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

        Макс. длина:
        20
      • tax_paid_onstring (date) или null

        Дата уплаты НДС за импорт услуг, YYYY-MM-DD; null, если не указана.

      • tax_paid_amountinteger или null

        Уплаченный НДС за импорт услуг в валюте документа; null, если не указан.

        Минимум:
        0
        Максимум:
        10000000000
      • payment_referencestring или null

        Идентификатор платежа налога; null, если не указан.

        Макс. длина:
        20
      • payment_entity_tax_idstring или null

        CUIT банка, через который внесён налог; null, если не указан.

        Макс. длина:
        11

Ответы

200Успешно

Заголовки

  • Idempotent-Replayedstring

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

    Значения:
    true
  • ETagstringобязательно

    Версия записи. Передайте её в If-Match, чтобы изменить запись.

    Пример:
    "7"

application/json

Возвращает SupplierBill

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

412Запись изменилась после чтения: версия в If-Match не текущая

application/problem+json

Возвращает Problem

422Параметр неверен или неизвестен

application/problem+json

Возвращает ValidationProblem

428Запросу нужен If-Match с ETag записи

application/problem+json

Возвращает Problem

429Лимит запросов исчерпан

Заголовки

  • Retry-Afterintegerобязательно

    Сколько секунд подождать перед повтором.

    Минимум:
    0

application/problem+json

Возвращает RateLimitProblem

503Магазин временно недоступен

Заголовки

  • Retry-Afterinteger

    Сколько секунд подождать перед повтором.

    Минимум:
    0

application/problem+json

Возвращает Problem

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

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

Пример запроса
curl -X PATCH "https://api.saleya.app/v1/supplier-bills/{supplier_bill}" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN" \
  -H 'If-Match: "7"' \
  -H "Content-Type: application/json" \
  -d @body.json
Тело запроса — body.json
{
  "kind": "invoice",
  "fiscal": true,
  "legal_entity_id": 0,
  "supplier_id": 0,
  "related_bill_id": 0,
  "number": "string",
  "issued_on": "2026-01-15",
  "tax_period": "string",
  "due_on": "2026-01-15",
  "currency": "ARS",
  "exchange_rate": "string",
  "net_taxed": 0,
  "net_exempt": 0,
  "net_untaxed": 0,
  "tax_total": 0,
  "total": 0,
  "note": "string",
  "lines": [
    {
      "description": "string",
      "variant_id": 0,
      "quantity": "string",
      "unit_amount": 0,
      "net_amount": 0,
      "tax_kind": "taxed",
      "rate_bps": 0,
      "tax_amount": 0
    }
  ],
  "additional_taxes": [
    {
      "kind": "perception",
      "regime": "vat",
      "jurisdiction": "string",
      "amount": 0,
      "certificate_number": "string"
    }
  ],
  "goods_receipt_ids": [
    0
  ],
  "purchase_order_ids": [
    0
  ],
  "supplier_return_ids": [
    0
  ],
  "ar": {
    "document_type_code": "string",
    "point_of_sale": 0,
    "authorization_kind": "CAE",
    "authorization_code": "string",
    "authorization_expires_on": "2026-01-15",
    "credit_fiscal_amount": 0,
    "import": {
      "kind": "goods",
      "customs_declaration": "string",
      "document_kind": "invoice",
      "document_description": "string",
      "provider_tax_id": "string",
      "tax_paid_on": "2026-01-15",
      "tax_paid_amount": 0,
      "payment_reference": "string",
      "payment_entity_tax_id": "string"
    }
  }
}
Пример ответа · 200
{
  "id": 0,
  "version": 0,
  "kind": "invoice",
  "status": "draft",
  "fiscal": true,
  "legal_entity_id": 0,
  "supplier_id": 0,
  "related_bill_id": 0,
  "number": "string",
  "issued_on": "2026-01-15",
  "tax_period": "string",
  "due_on": "2026-01-15",
  "currency": "string",
  "exchange_rate": "string",
  "net_taxed": 0,
  "net_exempt": 0,
  "net_untaxed": 0,
  "tax_total": 0,
  "perceptions_total": 0,
  "other_taxes_total": 0,
  "total": 0,
  "base_total": 0,
  "paid_total": 0,
  "outstanding": 0,
  "tax_lines": [
    {
      "regime": "vat",
      "kind": "taxed",
      "rate_bps": 0,
      "base": 0,
      "amount": 0,
      "jurisdiction": "string"
    }
  ],
  "additional_taxes": [
    {
      "kind": "perception",
      "regime": "vat",
      "jurisdiction": "string",
      "amount": 0,
      "certificate_number": "string"
    }
  ],
  "lines": [
    {
      "description": "string",
      "variant_id": 0,
      "quantity": "string",
      "unit_amount": 0,
      "net_amount": 0,
      "tax_kind": "taxed",
      "rate_bps": 0,
      "tax_amount": 0
    }
  ],
  "vendor": {
    "tax_id": "string",
    "legal_name": "string"
  },
  "goods_receipt_id": 0,
  "goods_receipt_ids": [
    0
  ],
  "purchase_order_ids": [
    0
  ],
  "supplier_return_ids": [
    0
  ],
  "consignment_settlement_id": 0,
  "match_status": "unmatched",
  "note": "string",
  "approved_at": "2026-01-15T12:00:00Z",
  "posted_at": "2026-01-15T12:00:00Z",
  "voided_at": "2026-01-15T12:00:00Z",
  "ar": {
    "document_type_code": "string",
    "point_of_sale": 0,
    "authorization_kind": "CAE",
    "authorization_code": "string",
    "authorization_expires_on": "2026-01-15",
    "verification_status": "verified",
    "credit_fiscal_amount": 0,
    "import": {
      "kind": "goods",
      "customs_declaration": "string",
      "document_kind": "invoice",
      "document_description": "string",
      "provider_tax_id": "string",
      "tax_paid_on": "2026-01-15",
      "tax_paid_amount": 0,
      "payment_reference": "string",
      "payment_entity_tax_id": "string"
    }
  },
  "created_at": "2026-01-15T12:00:00Z",
  "updated_at": "2026-01-15T12:00:00Z"
}

Удалить черновик счёта поставщика

delete/supplier-bills/{supplier_bill}

Scope: procurement:write

Параметры

Путь

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

    ID счёта поставщика.

Заголовок

  • Idempotency-Keystring

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

    Мин. длина:
    1
    Макс. длина:
    255
    Пример:
    8e03978e-40d5-43e8-bc93-6894a57f9324
  • If-Matchstringобязательно

    ETag записи из последнего чтения, например "7". Правка применится, только если запись с тех пор никто не менял, иначе 412. Без заголовка — 428.

    Пример:
    "7"

Ответы

204Успешно

Заголовки

  • Idempotent-Replayedstring

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

    Значения:
    true

Без тела

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

412Запись изменилась после чтения: версия в If-Match не текущая

application/problem+json

Возвращает Problem

422Параметр неверен или неизвестен

application/problem+json

Возвращает ValidationProblem

428Запросу нужен If-Match с ETag записи

application/problem+json

Возвращает Problem

429Лимит запросов исчерпан

Заголовки

  • Retry-Afterintegerобязательно

    Сколько секунд подождать перед повтором.

    Минимум:
    0

application/problem+json

Возвращает RateLimitProblem

503Магазин временно недоступен

Заголовки

  • Retry-Afterinteger

    Сколько секунд подождать перед повтором.

    Минимум:
    0

application/problem+json

Возвращает Problem

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

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

Пример запроса
curl -X DELETE "https://api.saleya.app/v1/supplier-bills/{supplier_bill}" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN" \
  -H 'If-Match: "7"'

Провести счёт поставщика: он войдёт в кредиторку и книгу покупок

post/supplier-bills/{supplier_bill}/post

Scope: procurement:write

Параметры

Путь

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

    ID счёта поставщика.

Строка запроса

  • consentobject

    Согласия на последствия правки по видам: consent[<consent_kind>]=<consent_token> из ответа 409 consent_required. Уже данные согласия сохраняются, когда спрашивается следующий вид.

    Поля · 2
    • vendor_tax_idstring

      Счёт прислал поставщик без налогового номера в карточке: проведение запишет в карточку CUIT из фактуры. suppliers — сколько карточек изменится.

      Мин. длина:
      64
      Макс. длина:
      64
    • close_returnsstring

      Нота кредита покрыла возвраты поставщику целиком: проведение закроет их. supplier_returns — сколько возвратов закроется.

      Мин. длина:
      64
      Макс. длина:
      64

Заголовок

  • Idempotency-Keystring

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

    Мин. длина:
    1
    Макс. длина:
    255
    Пример:
    8e03978e-40d5-43e8-bc93-6894a57f9324
  • If-Matchstringобязательно

    ETag записи из последнего чтения, например "7". Правка применится, только если запись с тех пор никто не менял, иначе 412. Без заголовка — 428.

    Пример:
    "7"

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

object

Ответы

200Успешно

Заголовки

  • Idempotent-Replayedstring

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

    Значения:
    true
  • ETagstringобязательно

    Версия записи. Передайте её в If-Match, чтобы изменить запись.

    Пример:
    "7"

application/json

Возвращает SupplierBill

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

412Запись изменилась после чтения: версия в If-Match не текущая

application/problem+json

Возвращает Problem

422Параметр неверен или неизвестен

application/problem+json

Возвращает ValidationProblem

428Запросу нужен If-Match с ETag записи

application/problem+json

Возвращает Problem

429Лимит запросов исчерпан

Заголовки

  • Retry-Afterintegerобязательно

    Сколько секунд подождать перед повтором.

    Минимум:
    0

application/problem+json

Возвращает RateLimitProblem

503Магазин временно недоступен

Заголовки

  • Retry-Afterinteger

    Сколько секунд подождать перед повтором.

    Минимум:
    0

application/problem+json

Возвращает Problem

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

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

Пример запроса
curl -X POST "https://api.saleya.app/v1/supplier-bills/{supplier_bill}/post" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN" \
  -H 'If-Match: "7"' \
  -H "Content-Type: application/json" \
  -d @body.json
Тело запроса — body.json
{}
Пример ответа · 200
{
  "id": 0,
  "version": 0,
  "kind": "invoice",
  "status": "draft",
  "fiscal": true,
  "legal_entity_id": 0,
  "supplier_id": 0,
  "related_bill_id": 0,
  "number": "string",
  "issued_on": "2026-01-15",
  "tax_period": "string",
  "due_on": "2026-01-15",
  "currency": "string",
  "exchange_rate": "string",
  "net_taxed": 0,
  "net_exempt": 0,
  "net_untaxed": 0,
  "tax_total": 0,
  "perceptions_total": 0,
  "other_taxes_total": 0,
  "total": 0,
  "base_total": 0,
  "paid_total": 0,
  "outstanding": 0,
  "tax_lines": [
    {
      "regime": "vat",
      "kind": "taxed",
      "rate_bps": 0,
      "base": 0,
      "amount": 0,
      "jurisdiction": "string"
    }
  ],
  "additional_taxes": [
    {
      "kind": "perception",
      "regime": "vat",
      "jurisdiction": "string",
      "amount": 0,
      "certificate_number": "string"
    }
  ],
  "lines": [
    {
      "description": "string",
      "variant_id": 0,
      "quantity": "string",
      "unit_amount": 0,
      "net_amount": 0,
      "tax_kind": "taxed",
      "rate_bps": 0,
      "tax_amount": 0
    }
  ],
  "vendor": {
    "tax_id": "string",
    "legal_name": "string"
  },
  "goods_receipt_id": 0,
  "goods_receipt_ids": [
    0
  ],
  "purchase_order_ids": [
    0
  ],
  "supplier_return_ids": [
    0
  ],
  "consignment_settlement_id": 0,
  "match_status": "unmatched",
  "note": "string",
  "approved_at": "2026-01-15T12:00:00Z",
  "posted_at": "2026-01-15T12:00:00Z",
  "voided_at": "2026-01-15T12:00:00Z",
  "ar": {
    "document_type_code": "string",
    "point_of_sale": 0,
    "authorization_kind": "CAE",
    "authorization_code": "string",
    "authorization_expires_on": "2026-01-15",
    "verification_status": "verified",
    "credit_fiscal_amount": 0,
    "import": {
      "kind": "goods",
      "customs_declaration": "string",
      "document_kind": "invoice",
      "document_description": "string",
      "provider_tax_id": "string",
      "tax_paid_on": "2026-01-15",
      "tax_paid_amount": 0,
      "payment_reference": "string",
      "payment_entity_tax_id": "string"
    }
  },
  "created_at": "2026-01-15T12:00:00Z",
  "updated_at": "2026-01-15T12:00:00Z"
}

Аннулировать счёт поставщика вместе с его оплатами и зачётами

post/supplier-bills/{supplier_bill}/void

Scope: procurement:write

Параметры

Путь

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

    ID счёта поставщика.

Заголовок

  • Idempotency-Keystring

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

    Мин. длина:
    1
    Макс. длина:
    255
    Пример:
    8e03978e-40d5-43e8-bc93-6894a57f9324
  • If-Matchstringобязательно

    ETag записи из последнего чтения, например "7". Правка применится, только если запись с тех пор никто не менял, иначе 412. Без заголовка — 428.

    Пример:
    "7"

Ответы

200Успешно

Заголовки

  • Idempotent-Replayedstring

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

    Значения:
    true
  • ETagstringобязательно

    Версия записи. Передайте её в If-Match, чтобы изменить запись.

    Пример:
    "7"

application/json

Возвращает SupplierBill

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

412Запись изменилась после чтения: версия в If-Match не текущая

application/problem+json

Возвращает Problem

422Параметр неверен или неизвестен

application/problem+json

Возвращает ValidationProblem

428Запросу нужен If-Match с ETag записи

application/problem+json

Возвращает Problem

429Лимит запросов исчерпан

Заголовки

  • Retry-Afterintegerобязательно

    Сколько секунд подождать перед повтором.

    Минимум:
    0

application/problem+json

Возвращает RateLimitProblem

503Магазин временно недоступен

Заголовки

  • Retry-Afterinteger

    Сколько секунд подождать перед повтором.

    Минимум:
    0

application/problem+json

Возвращает Problem

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

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

Пример запроса
curl -X POST "https://api.saleya.app/v1/supplier-bills/{supplier_bill}/void" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN" \
  -H 'If-Match: "7"'
Пример ответа · 200
{
  "id": 0,
  "version": 0,
  "kind": "invoice",
  "status": "draft",
  "fiscal": true,
  "legal_entity_id": 0,
  "supplier_id": 0,
  "related_bill_id": 0,
  "number": "string",
  "issued_on": "2026-01-15",
  "tax_period": "string",
  "due_on": "2026-01-15",
  "currency": "string",
  "exchange_rate": "string",
  "net_taxed": 0,
  "net_exempt": 0,
  "net_untaxed": 0,
  "tax_total": 0,
  "perceptions_total": 0,
  "other_taxes_total": 0,
  "total": 0,
  "base_total": 0,
  "paid_total": 0,
  "outstanding": 0,
  "tax_lines": [
    {
      "regime": "vat",
      "kind": "taxed",
      "rate_bps": 0,
      "base": 0,
      "amount": 0,
      "jurisdiction": "string"
    }
  ],
  "additional_taxes": [
    {
      "kind": "perception",
      "regime": "vat",
      "jurisdiction": "string",
      "amount": 0,
      "certificate_number": "string"
    }
  ],
  "lines": [
    {
      "description": "string",
      "variant_id": 0,
      "quantity": "string",
      "unit_amount": 0,
      "net_amount": 0,
      "tax_kind": "taxed",
      "rate_bps": 0,
      "tax_amount": 0
    }
  ],
  "vendor": {
    "tax_id": "string",
    "legal_name": "string"
  },
  "goods_receipt_id": 0,
  "goods_receipt_ids": [
    0
  ],
  "purchase_order_ids": [
    0
  ],
  "supplier_return_ids": [
    0
  ],
  "consignment_settlement_id": 0,
  "match_status": "unmatched",
  "note": "string",
  "approved_at": "2026-01-15T12:00:00Z",
  "posted_at": "2026-01-15T12:00:00Z",
  "voided_at": "2026-01-15T12:00:00Z",
  "ar": {
    "document_type_code": "string",
    "point_of_sale": 0,
    "authorization_kind": "CAE",
    "authorization_code": "string",
    "authorization_expires_on": "2026-01-15",
    "verification_status": "verified",
    "credit_fiscal_amount": 0,
    "import": {
      "kind": "goods",
      "customs_declaration": "string",
      "document_kind": "invoice",
      "document_description": "string",
      "provider_tax_id": "string",
      "tax_paid_on": "2026-01-15",
      "tax_paid_amount": 0,
      "payment_reference": "string",
      "payment_entity_tax_id": "string"
    }
  },
  "created_at": "2026-01-15T12:00:00Z",
  "updated_at": "2026-01-15T12:00:00Z"
}

Одобрить проведённый счёт поставщика к оплате

post/supplier-bills/{supplier_bill}/approve

Scope: procurement:approve

Параметры

Путь

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

    ID счёта поставщика.

Заголовок

  • Idempotency-Keystring

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

    Мин. длина:
    1
    Макс. длина:
    255
    Пример:
    8e03978e-40d5-43e8-bc93-6894a57f9324
  • If-Matchstringобязательно

    ETag записи из последнего чтения, например "7". Правка применится, только если запись с тех пор никто не менял, иначе 412. Без заголовка — 428.

    Пример:
    "7"

Ответы

200Успешно

Заголовки

  • Idempotent-Replayedstring

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

    Значения:
    true
  • ETagstringобязательно

    Версия записи. Передайте её в If-Match, чтобы изменить запись.

    Пример:
    "7"

application/json

Возвращает SupplierBill

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

412Запись изменилась после чтения: версия в If-Match не текущая

application/problem+json

Возвращает Problem

422Параметр неверен или неизвестен

application/problem+json

Возвращает ValidationProblem

428Запросу нужен If-Match с ETag записи

application/problem+json

Возвращает Problem

429Лимит запросов исчерпан

Заголовки

  • Retry-Afterintegerобязательно

    Сколько секунд подождать перед повтором.

    Минимум:
    0

application/problem+json

Возвращает RateLimitProblem

503Магазин временно недоступен

Заголовки

  • Retry-Afterinteger

    Сколько секунд подождать перед повтором.

    Минимум:
    0

application/problem+json

Возвращает Problem

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

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

Пример запроса
curl -X POST "https://api.saleya.app/v1/supplier-bills/{supplier_bill}/approve" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN" \
  -H 'If-Match: "7"'
Пример ответа · 200
{
  "id": 0,
  "version": 0,
  "kind": "invoice",
  "status": "draft",
  "fiscal": true,
  "legal_entity_id": 0,
  "supplier_id": 0,
  "related_bill_id": 0,
  "number": "string",
  "issued_on": "2026-01-15",
  "tax_period": "string",
  "due_on": "2026-01-15",
  "currency": "string",
  "exchange_rate": "string",
  "net_taxed": 0,
  "net_exempt": 0,
  "net_untaxed": 0,
  "tax_total": 0,
  "perceptions_total": 0,
  "other_taxes_total": 0,
  "total": 0,
  "base_total": 0,
  "paid_total": 0,
  "outstanding": 0,
  "tax_lines": [
    {
      "regime": "vat",
      "kind": "taxed",
      "rate_bps": 0,
      "base": 0,
      "amount": 0,
      "jurisdiction": "string"
    }
  ],
  "additional_taxes": [
    {
      "kind": "perception",
      "regime": "vat",
      "jurisdiction": "string",
      "amount": 0,
      "certificate_number": "string"
    }
  ],
  "lines": [
    {
      "description": "string",
      "variant_id": 0,
      "quantity": "string",
      "unit_amount": 0,
      "net_amount": 0,
      "tax_kind": "taxed",
      "rate_bps": 0,
      "tax_amount": 0
    }
  ],
  "vendor": {
    "tax_id": "string",
    "legal_name": "string"
  },
  "goods_receipt_id": 0,
  "goods_receipt_ids": [
    0
  ],
  "purchase_order_ids": [
    0
  ],
  "supplier_return_ids": [
    0
  ],
  "consignment_settlement_id": 0,
  "match_status": "unmatched",
  "note": "string",
  "approved_at": "2026-01-15T12:00:00Z",
  "posted_at": "2026-01-15T12:00:00Z",
  "voided_at": "2026-01-15T12:00:00Z",
  "ar": {
    "document_type_code": "string",
    "point_of_sale": 0,
    "authorization_kind": "CAE",
    "authorization_code": "string",
    "authorization_expires_on": "2026-01-15",
    "verification_status": "verified",
    "credit_fiscal_amount": 0,
    "import": {
      "kind": "goods",
      "customs_declaration": "string",
      "document_kind": "invoice",
      "document_description": "string",
      "provider_tax_id": "string",
      "tax_paid_on": "2026-01-15",
      "tax_paid_amount": 0,
      "payment_reference": "string",
      "payment_entity_tax_id": "string"
    }
  },
  "created_at": "2026-01-15T12:00:00Z",
  "updated_at": "2026-01-15T12:00:00Z"
}

Отозвать одобрение счёта поставщика к оплате

post/supplier-bills/{supplier_bill}/revoke-approval

Scope: procurement:approve

Параметры

Путь

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

    ID счёта поставщика.

Заголовок

  • Idempotency-Keystring

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

    Мин. длина:
    1
    Макс. длина:
    255
    Пример:
    8e03978e-40d5-43e8-bc93-6894a57f9324
  • If-Matchstringобязательно

    ETag записи из последнего чтения, например "7". Правка применится, только если запись с тех пор никто не менял, иначе 412. Без заголовка — 428.

    Пример:
    "7"

Ответы

200Успешно

Заголовки

  • Idempotent-Replayedstring

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

    Значения:
    true
  • ETagstringобязательно

    Версия записи. Передайте её в If-Match, чтобы изменить запись.

    Пример:
    "7"

application/json

Возвращает SupplierBill

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

412Запись изменилась после чтения: версия в If-Match не текущая

application/problem+json

Возвращает Problem

422Параметр неверен или неизвестен

application/problem+json

Возвращает ValidationProblem

428Запросу нужен If-Match с ETag записи

application/problem+json

Возвращает Problem

429Лимит запросов исчерпан

Заголовки

  • Retry-Afterintegerобязательно

    Сколько секунд подождать перед повтором.

    Минимум:
    0

application/problem+json

Возвращает RateLimitProblem

503Магазин временно недоступен

Заголовки

  • Retry-Afterinteger

    Сколько секунд подождать перед повтором.

    Минимум:
    0

application/problem+json

Возвращает Problem

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

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

Пример запроса
curl -X POST "https://api.saleya.app/v1/supplier-bills/{supplier_bill}/revoke-approval" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN" \
  -H 'If-Match: "7"'
Пример ответа · 200
{
  "id": 0,
  "version": 0,
  "kind": "invoice",
  "status": "draft",
  "fiscal": true,
  "legal_entity_id": 0,
  "supplier_id": 0,
  "related_bill_id": 0,
  "number": "string",
  "issued_on": "2026-01-15",
  "tax_period": "string",
  "due_on": "2026-01-15",
  "currency": "string",
  "exchange_rate": "string",
  "net_taxed": 0,
  "net_exempt": 0,
  "net_untaxed": 0,
  "tax_total": 0,
  "perceptions_total": 0,
  "other_taxes_total": 0,
  "total": 0,
  "base_total": 0,
  "paid_total": 0,
  "outstanding": 0,
  "tax_lines": [
    {
      "regime": "vat",
      "kind": "taxed",
      "rate_bps": 0,
      "base": 0,
      "amount": 0,
      "jurisdiction": "string"
    }
  ],
  "additional_taxes": [
    {
      "kind": "perception",
      "regime": "vat",
      "jurisdiction": "string",
      "amount": 0,
      "certificate_number": "string"
    }
  ],
  "lines": [
    {
      "description": "string",
      "variant_id": 0,
      "quantity": "string",
      "unit_amount": 0,
      "net_amount": 0,
      "tax_kind": "taxed",
      "rate_bps": 0,
      "tax_amount": 0
    }
  ],
  "vendor": {
    "tax_id": "string",
    "legal_name": "string"
  },
  "goods_receipt_id": 0,
  "goods_receipt_ids": [
    0
  ],
  "purchase_order_ids": [
    0
  ],
  "supplier_return_ids": [
    0
  ],
  "consignment_settlement_id": 0,
  "match_status": "unmatched",
  "note": "string",
  "approved_at": "2026-01-15T12:00:00Z",
  "posted_at": "2026-01-15T12:00:00Z",
  "voided_at": "2026-01-15T12:00:00Z",
  "ar": {
    "document_type_code": "string",
    "point_of_sale": 0,
    "authorization_kind": "CAE",
    "authorization_code": "string",
    "authorization_expires_on": "2026-01-15",
    "verification_status": "verified",
    "credit_fiscal_amount": 0,
    "import": {
      "kind": "goods",
      "customs_declaration": "string",
      "document_kind": "invoice",
      "document_description": "string",
      "provider_tax_id": "string",
      "tax_paid_on": "2026-01-15",
      "tax_paid_amount": 0,
      "payment_reference": "string",
      "payment_entity_tax_id": "string"
    }
  },
  "created_at": "2026-01-15T12:00:00Z",
  "updated_at": "2026-01-15T12:00:00Z"
}