Финансы

Документы

Request

• HTTP Method: POST
• Content Type: application/json
• URL: https://api.skladbot.ru/v1/finance/documents

Header Parameters

Property	Description
Authorization	string API-ключ.

Request Body Raw Schema: application/json

Property	Description
customer_id optional	Integer ID клиента
limit required	Integer Количество элементов на странице.
type optional	string Тип документа: 1(Договор) 2(Счета) 3(Приходная накладная)
is_paid optional	string Статус оплаты: 0(Не оплаченно) 1(Оплачено)
from optional	Date Период с.
to optional	Date Период по.

Примеры запроса

{
    "customer_id": 28,
    "limit": 20,
    "type": 2,
    "is_paid": 0,
    "from": "2024-04-20",
    "to": "2024-09-01"    
}

Примеры ответа (1)

{
    "data": [
        {
            "id": 10, // ID документа
            "customer": "ИП Тест",
            "number": 123, // Номер документа
            "date": '2024-01-01', // Дата документа
            "type": "Приходная накладная", // Тип документа
            "paid_at": null, // Дата оплаты
            "is_paid": false, // Оплачено
            "total_price": 308, // Общая стоимость
            "total_price_with_tax": 308,
            "invoices":[] // Реестр счета
        }
    ]
}

Примеры ответа (2)

{
    "data": [
        {
            "id": 11, // ID документа
            "customer": "ИП Тест",
            "number": 123, // Номер документа
            "date": "2024-01-01", // Дата документа
            "type": "Счета", // Тип документа
            "paid_at": "2024-01-01", // Дата оплаты
            "is_paid": true, // Оплачено
            "total_price": 252010.56, // Общая стоимость
            "total_price_with_tax": 252010.56
            "invoices":[
                "id": 12321, // ID реестра                
                "label": "2024-05-31",                
                "total_price": 252010.56, // Общая стоимость
                "total_price_with_tax": 252010.56
                "services": [
                    {
                        "id": 234234, // ID услуги
                        "active": 0, // Активен ли услуга
                        "name": "Хранение 1 куб",
                        "vendor_code": null, // Артикул товара
                        "price": 60, // Цена за единицу услуги
                        "amount": 732, // К-во услуги
                        "total": 43920, // Общая стоимость
                        "total_with_tax": 43920                 
                    },
                    {
                        "id": 199822, // ID услуги
                        "active": 1, // Активен ли услуга
                        "name": "Комплекс услуг по подготовке товара для МП",
                        "vendor_code": null, // Артикул товара
                        "price": 252010.56, // Цена за единицу услуги
                        "amount": 1, // К-во услуги
                        "total": 252010.56, // Общая стоимость
                        "total_with_tax": 220
                    }
                ]
            ]
        }
    ]
}

Счета

Request

• HTTP Method: POST
• Content Type: application/json
• URL: https://api.skladbot.ru/v1/finance/invoices

Header Parameters

Property	Description
Authorization	string API-ключ.

Request Body Raw Schema: application/json

Property	Description
customer_id required	Integer ID клиента
limit required	Integer Количество элементов на странице.
from optional	Date Период с.
to optional	Date Период по.

Примеры запроса

{
    "customer_id": 28,
    "limit": 20,
    "from": "2024-04-20",
    "to": "2024-09-01"    
}

Примеры ответа

{
    "data": [
        {
            "id": 10, // ID Счета
            "customer": "ИП Тест",
            "type": "request",
            "type_format": "Обработка заявки",
            "title": "WH-R-333234",
            "service_total_price": "3276.00",
            "services": [
                {
                    "id": 202456,
                    "active": 1,
                    "name": "Маркировка",
                    "vendor_code": null,
                    "price": 7,
                    "amount": 28,
                    "total": 196,
                },
                {
                    "id": 202457,
                    "active": 1,
                    "name": " Короб 60*40*40",
                    "vendor_code": null,
                    "price": 110,
                    "amount": 28,
                    "total": 3080,
                }
            ]
        }
    ]
}