03-12-2018 23:59

Получение операций за указанный период с разбивкой по страницам

GET   /bs-core/main/contracts/{contractId}/actors/date-from/{dateFrom}/date-to/{dateTo}/page-no/{pageNo}?portion-size={portionSize}

Возвращаются операции за указанные период времени с разбивкой по страницам, с указанием к какому процессу или документу привязана операция. 

В отличие от метода 431 - не указана ссылка на ДДС и разбивка по экшенам в операции.

Более подробную информацию по учету в системе вы можете прочитать в статье "Операции в системе Brainysoft".

"Операция" (OPERATION) - самый младший в классе actor - может содержать в себе только движения одного типа по одному виду задолженности (ОДИН тип движения и ОДИН тип задолженности). Например: Начисление процентов.

"Документ" (DOCUMENT) - может содержать сразу несколько операций, например:
Документ "Погашение с предоплатой". содержит в себе операцию типовую операцию "Погашение" и операцию "Предоплата"
Обе операции в данном случае относятся к операциям связанным с ДДС

"Процессы"(PROCESS)- могут содержать в себе один или несколько документов.
Например, Процесс "Обработка с досрочным зачетом предоплаты и перерасчетом графика"- содержит в себе документы:
Начисление процентов, зачет предоплаты, перерасчет графика

Запрос

/bs-core/main/contracts/101342018/actors/date-from/2018-06-21/date-to/2018-06-30/page-no/1?portion-size=1
Описание параметров
Параметр Обязателен Тип данных Описание
contractId R [int] Идентификатор контракта
portion-size R [int] Количество отображаемых элементов коллекции actor про страницу. Дополнительный параметр адресной строки.
pageNo R [int] номер страницы
dateTo R [date] Дата по
dateFrom R [date] Дата с

Ответ


                        {
    "status": "ok",
    "timestamp": 1529652354919,
    "data": {
        "contractId": 101342018,
        "totalQty": 3,
        "portionSize": 1,
        "pageNo": 1,
        "curPageActorsQty": 1,
        "actors": [
            {
                "date": 1529591420000,
                "paymentTypeId": null,
                "totalAmount": {
                    "local": 2000,
                    "foreign": 0
                },
                "id": 101490985,
                "actorType": "PROCESS",
                "amountTypeId": null,
                "actionTypeId": null,
                "type": "Погашение",
                "children": [
                    {
                        "date": 1529591420000,
                        "paymentTypeId": null,
                        "totalAmount": {
                            "local": 2000,
                            "foreign": 0
                        },
                        "id": 101433466,
                        "actorType": "DOCUMENT",
                        "amountTypeId": null,
                        "actionTypeId": null,
                        "type": "Досрочное погашение",
                        "children": [
                            {
                                "date": 1529591420000,
                                "paymentTypeId": 101172,
                                "totalAmount": {
                                    "local": 2000,
                                    "foreign": 0
                                },
                                "id": 101525601,
                                "actorType": "OPERATION",
                                "amountTypeId": 101292,
                                "actionTypeId": 101022,
                                "type": "Погашение",
                                "children": []
                            }
                        ]
                    }
                ]
            }
        ]
    }
}
Описание параметров
Параметр Обязателен Тип данных Описание
curPageActorsQty R [ ] общее количество акторов на странице
paymentTypeId R [ ] тип платежа 101171 - Банк,  101172 - Касса, 101173 - Пусто
type R [ ] название actor 
totalAmount R [ ] всего сумма
actionTypeId R [string]

id вида дижения (указывается только для actor OPERATION, для других - null)
amountTypeId О [int][20]

id вида суммы (указывается только для actor OPERATION, для других - null), ниже перечислены все возможные
acrorType R [ ] тип actorа: PROCESS, DOCUMENT, OPERATION
data R [ ] дата actorа
  R [ ]  
actors R [collection] инструменты учета (типы: процессы, документы, операции)
pageNo R [ ] № страницы
portionSize R [ ] максимальное количество элементов на странице (если не передается значение, то применяется указанное из констант системы БС
totalQty R [ ] общее количество actor-ов за указанный период
contractId R [ ] id контракта