Счета поставщиков
Кредиторка: фактуры, ноты дебета и кредита, долги по поставкам без фактуры — с НДС по ставкам, перцепциями и строками.
Счета поставщиков
Объекты
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).
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_deletedbooleantrue — отдавать и удалённые записи: архивные с заполненным deleted_at и стёртые из базы — отметками об удалении {id, deleted_at} в продолжении по курсору синхронизации. Включайте для синхронизации.
supplier_idintegerТолько документы этого поставщика.
- Минимум:
- 1
Ответы
200Успешно
application/json
Записи страницы.
deletedмассив objectобязательноЗаписи, стёртые из базы с момента курсора, отметками об удалении: только с include_deleted=true в продолжении по курсору синхронизации.
Поля · 2
idintegerобязательноID стёртой записи.
deleted_atstring (date-time)обязательноКогда запись стёрта.
next_cursorstring или nullобязательноКурсор следующей страницы; null на последней.
has_morebooleanобязательноtrue, если есть следующая страница.
sync_cursorstring или nullобязательноНа последней странице — курсор, с которого продолжить позже: по нему придёт только изменённое после этой страницы. null на остальных.
401Токена нет, он неверен, истёк или отозван
Заголовки
WWW-AuthenticatestringобязательноСхема аутентификации (RFC 6750).
- Пример:
Bearer
application/problem+json
Возвращает Problem
403Запрос не разрешают тариф, IP-адрес или scopes токена
Заголовки
WWW-AuthenticatestringСхема аутентификации (RFC 6750).
- Пример:
Bearer error="insufficient_scope", scope="locations:read"
application/problem+json
Возвращает ForbiddenProblem
410Курсор синхронизации старше срока хранения удалений или выдан до восстановления базы
application/problem+json
Возвращает Problem
422Параметр неверен или неизвестен
application/problem+json
Возвращает ValidationProblem
429Лимит запросов исчерпан
Заголовки
Retry-AfterintegerобязательноСколько секунд подождать перед повтором.
- Минимум:
- 0
application/problem+json
Возвращает RateLimitProblem
503Магазин временно недоступен
Заголовки
Retry-AfterintegerСколько секунд подождать перед повтором.
- Минимум:
- 0
application/problem+json
Возвращает Problem
Отказы метода
Общие отказы — токен, доступ, проверка входа, лимит запросов — может вернуть любой метод, они собраны в каталоге: Ошибки
curl "https://api.saleya.app/v1/supplier-bills" \
-H "Authorization: Bearer $SALEYA_API_TOKEN"{
"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).
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 или nullID варианта товара (/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массив integerID приёмок, которые покрывает документ (/v1/goods-receipts): поставки, сверенные с фактурой, или поставка долга.
- Макс. элементов:
- 100
purchase_order_idsмассив integerID заказов поставщику, к которым относится документ (/v1/purchase-orders).
- Макс. элементов:
- 100
supplier_return_idsмассив integerID возвратов поставщику, за которые выставлена нота кредита (/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 или nullCAE — электронный документ; 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
kindstringgoods — импорт товаров по таможенному оформлению; 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 или nullCUIT банка, через который внесён налог; null, если не указан.
- Макс. длина:
- 11
Ответы
201Создано
Заголовки
Idempotent-Replayedstringtrue, когда это сохранённый ответ более раннего запроса с тем же 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
Отказы метода
- 409
idempotency_key_in_useЗапрос с этим ключом ещё исполняется - 422
idempotency_key_reusedКлюч идемпотентности уже использован - 422
invalid_idempotency_keyКлюч идемпотентности неверен
Общие отказы — токен, доступ, проверка входа, лимит запросов — может вернуть любой метод, они собраны в каталоге: Ошибки
curl -X POST "https://api.saleya.app/v1/supplier-bills" \
-H "Authorization: Bearer $SALEYA_API_TOKEN" \
-H "Content-Type: application/json" \
-d @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"
}
}
}{
"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"{
"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
kindstringinvoice — фактура; debit_note — нота дебета: увеличивает долг; credit_note — нота кредита: уменьшает долг (возврат, скидка, исправление). Суммы документа всегда положительные, знак задаёт kind.
- Значения:
invoicedebit_notecredit_note
fiscalbooleanfalse — долг по поставке без фактуры: реквизитов ARCA нет, в книгу покупок не входит; true — фактура или нота.
legal_entity_idintegerID юрлица магазина-покупателя (/v1/legal-entities).
supplier_idintegerID поставщика (/v1/suppliers).
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 или nullID варианта товара (/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массив integerID приёмок, которые покрывает документ (/v1/goods-receipts): поставки, сверенные с фактурой, или поставка долга.
- Макс. элементов:
- 100
purchase_order_idsмассив integerID заказов поставщику, к которым относится документ (/v1/purchase-orders).
- Макс. элементов:
- 100
supplier_return_idsмассив integerID возвратов поставщику, за которые выставлена нота кредита (/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 или nullCAE — электронный документ; 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
kindstringgoods — импорт товаров по таможенному оформлению; 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 или nullCUIT банка, через который внесён налог; null, если не указан.
- Макс. длина:
- 11
Ответы
200Успешно
Заголовки
Idempotent-Replayedstringtrue, когда это сохранённый ответ более раннего запроса с тем же 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
Отказы метода
- 409
idempotency_key_in_useЗапрос с этим ключом ещё исполняется - 409
supplier_bill_refusedСчёт поставщика не принимает эту команду - 412
precondition_failedЗапись изменилась - 422
idempotency_key_reusedКлюч идемпотентности уже использован - 422
invalid_idempotency_keyКлюч идемпотентности неверен - 428
precondition_requiredНужен If-Match
Общие отказы — токен, доступ, проверка входа, лимит запросов — может вернуть любой метод, они собраны в каталоге: Ошибки
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{
"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"
}
}
}{
"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-Replayedstringtrue, когда это сохранённый ответ более раннего запроса с тем же 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
Отказы метода
- 409
idempotency_key_in_useЗапрос с этим ключом ещё исполняется - 409
in_use_conflictЗапись используется - 409
supplier_bill_refusedСчёт поставщика не принимает эту команду - 412
precondition_failedЗапись изменилась - 422
idempotency_key_reusedКлюч идемпотентности уже использован - 422
invalid_idempotency_keyКлюч идемпотентности неверен - 428
precondition_requiredНужен If-Match
Общие отказы — токен, доступ, проверка входа, лимит запросов — может вернуть любой метод, они собраны в каталоге: Ошибки
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-Replayedstringtrue, когда это сохранённый ответ более раннего запроса с тем же 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
Отказы метода
- 409
consent_requiredНужно согласие на последствия - 409
idempotency_key_in_useЗапрос с этим ключом ещё исполняется - 409
supplier_bill_refusedСчёт поставщика не принимает эту команду - 412
precondition_failedЗапись изменилась - 422
idempotency_key_reusedКлюч идемпотентности уже использован - 422
invalid_idempotency_keyКлюч идемпотентности неверен - 428
precondition_requiredНужен If-Match
Общие отказы — токен, доступ, проверка входа, лимит запросов — может вернуть любой метод, они собраны в каталоге: Ошибки
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{}{
"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-Replayedstringtrue, когда это сохранённый ответ более раннего запроса с тем же 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
Отказы метода
- 409
idempotency_key_in_useЗапрос с этим ключом ещё исполняется - 409
supplier_bill_refusedСчёт поставщика не принимает эту команду - 412
precondition_failedЗапись изменилась - 422
idempotency_key_reusedКлюч идемпотентности уже использован - 422
invalid_idempotency_keyКлюч идемпотентности неверен - 428
precondition_requiredНужен If-Match
Общие отказы — токен, доступ, проверка входа, лимит запросов — может вернуть любой метод, они собраны в каталоге: Ошибки
curl -X POST "https://api.saleya.app/v1/supplier-bills/{supplier_bill}/void" \
-H "Authorization: Bearer $SALEYA_API_TOKEN" \
-H 'If-Match: "7"'{
"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-Replayedstringtrue, когда это сохранённый ответ более раннего запроса с тем же 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
Отказы метода
- 409
idempotency_key_in_useЗапрос с этим ключом ещё исполняется - 409
supplier_bill_refusedСчёт поставщика не принимает эту команду - 412
precondition_failedЗапись изменилась - 422
idempotency_key_reusedКлюч идемпотентности уже использован - 422
invalid_idempotency_keyКлюч идемпотентности неверен - 428
precondition_requiredНужен If-Match
Общие отказы — токен, доступ, проверка входа, лимит запросов — может вернуть любой метод, они собраны в каталоге: Ошибки
curl -X POST "https://api.saleya.app/v1/supplier-bills/{supplier_bill}/approve" \
-H "Authorization: Bearer $SALEYA_API_TOKEN" \
-H 'If-Match: "7"'{
"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-Replayedstringtrue, когда это сохранённый ответ более раннего запроса с тем же 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
Отказы метода
- 409
idempotency_key_in_useЗапрос с этим ключом ещё исполняется - 409
supplier_bill_refusedСчёт поставщика не принимает эту команду - 412
precondition_failedЗапись изменилась - 422
idempotency_key_reusedКлюч идемпотентности уже использован - 422
invalid_idempotency_keyКлюч идемпотентности неверен - 428
precondition_requiredНужен If-Match
Общие отказы — токен, доступ, проверка входа, лимит запросов — может вернуть любой метод, они собраны в каталоге: Ошибки
curl -X POST "https://api.saleya.app/v1/supplier-bills/{supplier_bill}/revoke-approval" \
-H "Authorization: Bearer $SALEYA_API_TOKEN" \
-H 'If-Match: "7"'{
"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"
}