Приёмки
Приход товара от поставщика: строки с ценой накладной и себестоимостью, корректировки «было → стало». Сторно отмечает voided_at.
Приёмки
Объекты
GoodsReceipt
idintegerобязательноID записи, уникальный среди записей своего вида в магазине.
numberstring или nullобязательноНомер приёмки; null у приёмки, заведённой до нумерации.
supplier_idinteger или nullобязательноID поставщика (/v1/suppliers); null у приёмки без поставщика.
location_idintegerобязательноID точки, куда принят товар (/v1/locations).
legal_entity_idinteger или nullобязательноID юрлица магазина-покупателя (/v1/legal-entities): его налоговый режим решает, зачитывается ли налог закупки; null у старых приёмок.
purchase_order_idinteger или nullобязательноID заказа поставщику, по которому принимали (/v1/purchase-orders); null — приёмка без заказа.
received_atstring (date-time)обязательноКогда товар принят.
currencystringобязательноВалюта приёмки, ISO 4217: в ней цены накладной, суммы строк и итоги.
exchange_ratestring или nullобязательноКурс валюты приёмки к валюте магазина десятичной строкой, снимок на приёмке; null у приёмки без снимка курса.
settlement_modestring или nullобязательноКак магазин рассчитывается за поставку: on_receipt — за принятое; on_sale — по факту продажи, актом реализации; null у старых приёмок.
- Значения:
on_receipton_salenull
supplier_documentobjectобязательноНакладная поставщика, как её подтвердил сотрудник.
Поля · 3
type_codestring или nullобязательноКод типа документа у налогового провайдера страны магазина (в Аргентине — код comprobante ARCA); null — документа нет.
numberstring или nullобязательноНомер накладной; null, если не указан.
datestring или nullобязательноДата накладной, YYYY-MM-DD; null, если не указана.
prices_include_taxboolean или nullобязательноtrue — цены строк с налогом; false — без налога; null — база цен не указана.
input_tax_treatmentstring или nullобязательноКуда ушёл налог в цене закупки: recoverable — зачитывается, себестоимость без налога; cost — зачесть некуда, налог в себестоимости; null — себестоимость как введена.
- Значения:
recoverablecostnull
lines_subtotalinteger или nullобязательноНа сколько принято: сумма line_total строк в валюте приёмки; null — цен в документе нет.
payable_totalinteger или nullобязательноПричитается поставщику в валюте приёмки; null — сумма неизвестна.
voided_atstring (date-time) или nullобязательноКогда приёмку сторнировали: товар снят с остатка, долг по поставке аннулирован; null у действующей.
notestring или nullобязательноЗаметка сотрудника; null, если её нет.
linesмассив objectобязательноСтроки приёмки; значения — после корректировок.
Поля · 16
idintegerобязательноID записи, уникальный среди записей своего вида в магазине.
variant_idinteger или nullобязательноID варианта товара (/v1/variants).
lot_idinteger или nullобязательноID партии строки (/v1/lots); null — товар без партий.
purchase_order_line_idinteger или nullобязательноID строки заказа поставщику (lines[].id заказа), против которой принята строка; null без заказа.
added_by_correction_idinteger или nullобязательноID корректировки (corrections[].id), которая добавила строку; null у строки из проведения.
supplier_descriptionstring или nullобязательноНаименование позиции, как в накладной; null, если не записано.
supplier_quantitystring или nullобязательноКоличество, как в накладной, в единице supplier_unit, десятичной строкой; null, если не записано.
supplier_unitstring или nullобязательноЕдиница накладной, как в документе: «кг», «15 кг», «шт»; null, если не указана.
unitstring или nullобязательноБазовая единица quantity и cost_per_quantity: pcs — штуки, g — граммы, ml — миллилитры.
quantitystring или nullобязательноПринято на склад, десятичной строкой в базовой единице.
unit_costinteger или nullобязательноЦена накладной в валюте приёмки за cost_per_quantity; null — цена не указана.
cost_per_quantitystring или nullобязательноЗа какое количество в базовой единице указана цена: "1000" у весового товара — за килограмм.
line_totalinteger или nullобязательноСумма строки в валюте приёмки: цена на количество накладной; null без цены или количества накладной.
store_unit_cost_microinteger или nullобязательноЦена строки в валюте магазина по курсу приёмки за cost_per_quantity, в миллионных долях минорной единицы; null без цены.
tax_rate_bpsinteger или nullобязательноСтавка налога, по которой считалась себестоимость, в базисных пунктах; null — трактовки налога не было.
landed_unit_cost_microinteger или nullобязательноСебестоимость после трактовки налога, которую строка выставила в карточку позиции: валюта магазина, за cost_per_quantity, в миллионных долях минорной единицы; null без цены.
correctionsмассив objectобязательноКорректировки проведённой приёмки по порядку: что исправили и почему.
Поля · 8
idintegerобязательноID записи, уникальный среди записей своего вида в магазине.
numberstringобязательноНомер корректировки.
reasonstringобязательноПочему исправили, словами сотрудника.
subtotal_beforeinteger или nullобязательноlines_subtotal до корректировки; null — цен не было.
subtotal_afterinteger или nullобязательноlines_subtotal после корректировки; null — цен нет.
consumed_varianceintegerобязательноРазница цены по уже ушедшему со склада, в валюте магазина: она легла в себестоимость проданного.
linesмассив objectобязательноИсправленные строки: было и стало.
Поля · 11
goods_receipt_line_idintegerобязательноID строки приёмки (lines[].id).
quantity_beforestring или nullобязательноПринято до корректировки, в базовой единице.
quantity_afterstring или nullобязательноПринято после корректировки, в базовой единице.
supplier_quantity_beforestring или nullобязательноКоличество накладной до корректировки; null, если не было.
supplier_quantity_afterstring или nullобязательноКоличество накладной после корректировки; null, если нет.
unit_cost_beforeinteger или nullобязательноЦена накладной до корректировки; null — цены не было.
unit_cost_afterinteger или nullобязательноЦена накладной после корректировки; null — цены нет.
store_unit_cost_before_microinteger или nullобязательноЦена в валюте магазина до корректировки, в миллионных долях минорной единицы.
store_unit_cost_after_microinteger или nullобязательноЦена в валюте магазина после корректировки, в миллионных долях минорной единицы.
consumed_quantitystring или nullобязательноСколько из принятого по строке уже ушло со склада к моменту корректировки.
consumed_varianceintegerобязательноРазница цены по ушедшему со склада, в валюте магазина.
created_atstring (date-time)обязательноКогда корректировку провели.
created_atstring (date-time)обязательноКогда запись создана.
updated_atstring (date-time)обязательноКогда запись менялась последний раз.
Методы
Приёмки: приход от поставщика со строками, ценами накладной и корректировками
get/goods-receipts
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})$
supplier_idintegerТолько документы этого поставщика.
- Минимум:
- 1
purchase_order_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/goods-receipts" \
-H "Authorization: Bearer $SALEYA_API_TOKEN"{
"data": [
{
"id": 0,
"number": "string",
"supplier_id": 0,
"location_id": 0,
"legal_entity_id": 0,
"purchase_order_id": 0,
"received_at": "2026-01-15T12:00:00Z",
"currency": "string",
"exchange_rate": "string",
"settlement_mode": "on_receipt",
"supplier_document": {
"type_code": "string",
"number": "string",
"date": "string"
},
"prices_include_tax": true,
"input_tax_treatment": "recoverable",
"lines_subtotal": 0,
"payable_total": 0,
"voided_at": "2026-01-15T12:00:00Z",
"note": "string",
"lines": [
{
"id": 0,
"variant_id": 0,
"lot_id": 0,
"purchase_order_line_id": 0,
"added_by_correction_id": 0,
"supplier_description": "string",
"supplier_quantity": "string",
"supplier_unit": "string",
"unit": "string",
"quantity": "string",
"unit_cost": 0,
"cost_per_quantity": "string",
"line_total": 0,
"store_unit_cost_micro": 0,
"tax_rate_bps": 0,
"landed_unit_cost_micro": 0
}
],
"corrections": [
{
"id": 0,
"number": "string",
"reason": "string",
"subtotal_before": 0,
"subtotal_after": 0,
"consumed_variance": 0,
"lines": [
{
"goods_receipt_line_id": 0,
"quantity_before": "string",
"quantity_after": "string",
"supplier_quantity_before": "string",
"supplier_quantity_after": "string",
"unit_cost_before": 0,
"unit_cost_after": 0,
"store_unit_cost_before_micro": 0,
"store_unit_cost_after_micro": 0,
"consumed_quantity": "string",
"consumed_variance": 0
}
],
"created_at": "2026-01-15T12:00:00Z"
}
],
"created_at": "2026-01-15T12:00:00Z",
"updated_at": "2026-01-15T12:00:00Z"
}
],
"deleted": [
{
"id": 0,
"deleted_at": "2026-01-15T12:00:00Z"
}
],
"next_cursor": "string",
"has_more": true,
"sync_cursor": "string"
}Приёмка
get/goods-receipts/{goods_receipt}
Scope: procurement:read
Параметры
Путь
goods_receiptintegerобязательноID приёмки.
Ответы
200Успешно
application/json
Возвращает GoodsReceipt
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/goods-receipts/{goods_receipt}" \
-H "Authorization: Bearer $SALEYA_API_TOKEN"{
"id": 0,
"number": "string",
"supplier_id": 0,
"location_id": 0,
"legal_entity_id": 0,
"purchase_order_id": 0,
"received_at": "2026-01-15T12:00:00Z",
"currency": "string",
"exchange_rate": "string",
"settlement_mode": "on_receipt",
"supplier_document": {
"type_code": "string",
"number": "string",
"date": "string"
},
"prices_include_tax": true,
"input_tax_treatment": "recoverable",
"lines_subtotal": 0,
"payable_total": 0,
"voided_at": "2026-01-15T12:00:00Z",
"note": "string",
"lines": [
{
"id": 0,
"variant_id": 0,
"lot_id": 0,
"purchase_order_line_id": 0,
"added_by_correction_id": 0,
"supplier_description": "string",
"supplier_quantity": "string",
"supplier_unit": "string",
"unit": "string",
"quantity": "string",
"unit_cost": 0,
"cost_per_quantity": "string",
"line_total": 0,
"store_unit_cost_micro": 0,
"tax_rate_bps": 0,
"landed_unit_cost_micro": 0
}
],
"corrections": [
{
"id": 0,
"number": "string",
"reason": "string",
"subtotal_before": 0,
"subtotal_after": 0,
"consumed_variance": 0,
"lines": [
{
"goods_receipt_line_id": 0,
"quantity_before": "string",
"quantity_after": "string",
"supplier_quantity_before": "string",
"supplier_quantity_after": "string",
"unit_cost_before": 0,
"unit_cost_after": 0,
"store_unit_cost_before_micro": 0,
"store_unit_cost_after_micro": 0,
"consumed_quantity": "string",
"consumed_variance": 0
}
],
"created_at": "2026-01-15T12:00:00Z"
}
],
"created_at": "2026-01-15T12:00:00Z",
"updated_at": "2026-01-15T12:00:00Z"
}