Документы и бухгалтерия (finances)
Управление документами продавца
Управление документами продавца
Отчет о продажах по реализации{{ /api/v5/supplier/reportDetailByPeriod }}
Возвращает детализацию к еженедельному отчёту реализации. Доступны данные, начиная с 29 января 2024 года.
Если нет данных за указанный период, метод вернет []
Authorizations:
query Parameters
dateFrom required | string <RFC3339> Начальная дата отчета.
|
limit | integer Default: 100000 Максимальное количество строк отчета, возвращаемых методом. Не может быть более 100000. |
dateTo required | string <date> Конечная дата отчета |
rrdid | integer Уникальный ID строки отчета. Необходим для получения отчета частями.
|
Responses
Response samples
- 200
- 401
- 429
[- {
- "realizationreport_id": 1234567,
- "date_from": "2022-10-17",
- "date_to": "2022-10-23",
- "create_dt": "2022-10-24",
- "currency_name": "руб",
- "suppliercontract_code": null,
- "rrd_id": 1232610467,
- "gi_id": 123456,
- "subject_name": "Мини-печи",
- "nm_id": 1234567,
- "brand_name": "BlahBlah",
- "sa_name": "MAB123",
- "ts_name": "0",
- "barcode": "1231312352310",
- "doc_type_name": "Продажа",
- "quantity": 1,
- "retail_price": 1249,
- "retail_amount": 367,
- "sale_percent": 68,
- "commission_percent": 0.1324,
- "office_name": "Коледино",
- "supplier_oper_name": "Продажа",
- "order_dt": "2022-10-13T00:00:00Z",
- "sale_dt": "2022-10-20T00:00:00Z",
- "rr_dt": "2022-10-20",
- "shk_id": 1239159661,
- "retail_price_withdisc_rub": 399.68,
- "delivery_amount": 0,
- "return_amount": 0,
- "delivery_rub": 0,
- "gi_box_type_name": "Монопаллета",
- "product_discount_for_report": 399.68,
- "supplier_promo": 0,
- "rid": 123722249253,
- "ppvz_spp_prc": 0.1581,
- "ppvz_kvw_prc_base": 0.15,
- "ppvz_kvw_prc": -0.0081,
- "sup_rating_prc_up": 0,
- "is_kgvp_v2": 0,
- "ppvz_sales_commission": -3.74,
- "ppvz_for_pay": 376.99,
- "ppvz_reward": 0,
- "acquiring_fee": 14.89,
- "acquiring_percent": 4.06,
- "acquiring_bank": "Тинькофф",
- "ppvz_vw": -3.74,
- "ppvz_vw_nds": -0.75,
- "ppvz_office_id": 105383,
- "ppvz_office_name": "Пункт самовывоза (ПВЗ)",
- "ppvz_supplier_id": 186465,
- "ppvz_supplier_name": "ИП Жасмин",
- "ppvz_inn": "010101010101",
- "declaration_number": "",
- "bonus_type_name": "Штраф МП. Невыполненный заказ (отмена клиентом после недовоза)",
- "sticker_id": "1964038895",
- "site_country": "RU",
- "penalty": 231.35,
- "additional_payment": 0,
- "rebill_logistic_cost": 1.349,
- "rebill_logistic_org": "ИП Иванов Иван Иванович(123456789012)",
- "kiz": "0102900000376311210G2CIS?ehge)S\u001d91002A\u001d92F9Qof4FDo/31Icm14kmtuVYQzLypxm3HWkC1vQ/+pVVjm1dNAth1laFMoAGn7yEMWlTjxIe7lQnJqZ7TRZhlHQ==",
- "storage_fee": 12647.29,
- "deduction": 6354,
- "acceptance": 865,
- "srid": "0f1c3999172603062979867564654dac5b702849",
- "report_type": 1
}
]
Категории документов{{ /api/v1/documents/categories }}
Возвращает категории документов.
Authorizations:
query Parameters
locale | string Default: "en" Example: locale=ru Язык поля
|
Responses
Response samples
- 200
- 401
- 429
{- "data": {
- "categories": [
- {
- "name": "redeem-notification",
- "title": "Уведомление о выкупе"
}
]
}
}
Список документов{{ /api/v1/documents/list }}
Возвращает список документов продавца.
Authorizations:
query Parameters
locale | string Default: "en" Example: locale=ru Язык поля
|
beginTime | number <ГГГГ-MM-ДД> Example: beginTime=2024-07-09 Начало периода. Только вместе с |
endTime | number <ГГГГ-MM-ДД> Example: endTime=2024-07-15 Конец периода. Только вместе с |
sort | string Default: "date" Enum: "date" "category" Example: sort=category Сортировка:
Только вместе с |
order | string Default: "desc" Enum: "desc" "asc" Example: order=asc Порядок данных:
Только вместе с |
category | |
serviceName | string Example: serviceName=redeem-notification-44841941 Уникальный ID документа |
Responses
Response samples
- 200
- 400
- 401
- 429
{- "data": {
- "documents": [
- {
- "serviceName": "redeem-notification-44841941",
- "name": "redeem-notification",
- "category": "Уведомление о выкупе",
- "extensions": [
- "zip"
], - "creationTime": "2023-10-03T00:18:06.879Z",
- "viewed": false
}
]
}
}
Получить документ{{ /api/v1/documents/download }}
Возвращает один документ.
Authorizations:
query Parameters
serviceName required | string Example: serviceName=redeem-notification-44841941 Уникальный ID документа |
extension required | string Example: extension=zip Формат документа |
Responses
Response samples
- 200
- 400
- 401
- 429
{- "data": {
- "fileName": "Notice of redemption 44841941.zip",
- "extension": "zip",
- "document": "UEsDBBQACAgIAAAAAAAAAAAAAAAAAAAAAABHAAAA0KPQstC10LTQvtC80LvQtdC90LjQtSDQviDQstGL0LrRg9C/0LUg4oSWNDQ4NDE5NDEg0L7RgiAyNS4wOS4yMDIzLnhsc3jsnQk0lP3f/0dEUiRkNwmVECI7o0WS7EklxprdkH2bKVkqISRkGSlkaxRlN2TPnmzJvu/Gzmz/Uz33fY/L8/Q8zrn/x/07565zcjrn9f1cn/V6f69v53zTVCWnYATtA+0DAX/Rg0AgM5ip5l2Yg5OwKeyu+Wl3O1vbcA3YV5FDVfPej2vXKptOK1V9LjycmPDG72uW4vcG9xdsOI1V2wj86sk6+4nHJeZ92NFgC/He3gmDlccFXSyumXYUGSKK4hLLsqu5aBTspu5lqlcGB/JNlQVn1Eumj6o8ZEWPRotEVGkH9/kf457totEKj2N2P4dSZWAIaC0ajy5J+VL5fen1YOhcGMxvvUw+XOKFOHL...LSL/tC77s0GzTi2iBuHorbMpcOaw0Hmsc/gpk7ty3/cdDYRmhkRUPAIC37P94CA8oiP/fIvpPK8n9l43YARWRgH/tI6E3ntD/nfOfPyj9jxxDwn+b8/8dZqBDQPjPNSAACJgBAAD21P9s/y8AAP//UEsHCFHrudyQEwAASxQAAFBLAQIUABQACAgIAAAAAACH4v2BaSgAAGNjAABHAAAAAAAAAAAAAAAAAAAAAADQo9Cy0LXQtNC+0LzQu9C10L3QuNC1INC+INCy0YvQutGD0L/QtSDihJY0NDg0MTk0MSDQvtGCIDI1LjA5LjIwMjMueGxzeFBLAQIUABQACAgIAAAAAADTmLxwRQcAAGAPAABLAAAAAAAAAAAAAAAAAN4oAADQo9Cy0LXQtNC+0LzQu9C10L3QuNC1INC+INCy0YvQutGD0L/QtSDihJY0NDg0MTk0MSDQvtGCIDI1LjA5LjIwMjMueGxzeC5zaWdQSwECFAAUAAgACAAAAAAAUeu53JATAABLFAAACAAAAAAAAAAAAAAAAACcMAAAbWNoZC56aXBQSwUGAAAAAAMAAwAkAQAAYkQAAAAA"
}
}
Получить документы{{ /api/v1/documents/download/all }}
Возвращает больше одного документа. Можно получить неограниченное количество документов.
Authorizations:
Request Body schema: application/json
Array of objects |
Responses
Request samples
- Payload
{- "params": [
- {
- "extension": "zip",
- "serviceName": "redeem-notification-44841941"
}, - {
- "extension": "xlsx",
- "serviceName": "act-income-mp-392460936"
}
]
}
Response samples
- 200
- 400
- 401
- 429
{- "data": {
- "fileName": "documents.zip",
- "extension": "zip",
- "document": "UEsDBBQACAgIAAAAAAAAAAAAAAAAAAAAAABHAAAA0KPQstC10LTQvtC80LvQtdC90LjQtSDQviDQstGL0LrRg9C/0LUg4oSWNDQ4NDE5NDEg0L7RgiAyNS4wOS4yMDIzLnhsc3jsnQk0lP3f/0dEUiRkNwmVECI7o0WS7EklxprdkH2bKVkqISRkGSlkaxRlN2TPnmzJvu/Gzmz/Uz33fY/L8/Q8zrn/x/07565zcjrn9f1cn/V6f69v53zTVCWnYATtA+0DAX/Rg0AgM5ip5l2Yg5OwKeyu+Wl3O1vbcA3YV5FDVfPej2vXKptOK1V9LjycmPDG72uW4vcG9xdsOI1V2wj86sk6+4nHJeZ92NFgC/He3gmDlccFXSyumXYUGSKK4hLLsqu5aBTspu5lqlcGB/JNlQVn1Eumj6o8ZEWPRotEVGkH9/kf457totEKj2N2P4dSZWAIaC0ajy5J+VL5fen1YOhcGMxvvUw+XOKFOHL...LSL/tC77s0GzTi2iBuHorbMpcOaw0Hmsc/gpk7ty3/cdDYRmhkRUPAIC37P94CA8oiP/fIvpPK8n9l43YARWRgH/tI6E3ntD/nfOfPyj9jxxDwn+b8/8dZqBDQPjPNSAACJgBAAD21P9s/y8AAP//UEsHCFHrudyQEwAASxQAAFBLAQIUABQACAgIAAAAAACH4v2BaSgAAGNjAABHAAAAAAAAAAAAAAAAAAAAAADQo9Cy0LXQtNC+0LzQu9C10L3QuNC1INC+INCy0YvQutGD0L/QtSDihJY0NDg0MTk0MSDQvtGCIDI1LjA5LjIwMjMueGxzeFBLAQIUABQACAgIAAAAAADTmLxwRQcAAGAPAABLAAAAAAAAAAAAAAAAAN4oAADQo9Cy0LXQtNC+0LzQu9C10L3QuNC1INC+INCy0YvQutGD0L/QtSDihJY0NDg0MTk0MSDQvtGCIDI1LjA5LjIwMjMueGxzeC5zaWdQSwECFAAUAAgACAAAAAAAUeu53JATAABLFAAACAAAAAAAAAAAAAAAAACcMAAAbWNoZC56aXBQSwUGAAAAAAMAAwAkAQAAYkQAAAAA"
}
}