|
|
Для возможности добавления проводок в TS:Operator необходимо предварительно сгенерировать вебхук для получения доступа к api модуля. Для этого нужно пройти по пути TS:Operator->Справочники->Вебхуки -> Добавить вебхук и выбрать необходимые параметры.
Для передачи проводок в TS:Operator используется метод tsoperator:payments.processpayment.
Доступные для передачи POST-параметры:
order_id: [обязательный, строка] Номер заказа в системе.
Для получения списка заказов можно использовать соответствующий метод tsoperator:orders.getlist
cashdesk_id: [обязательный, число] ID кассы.
Список доступных касс можно получить, используя метод tsoperator:payments.cashdesks(пример: https://#server_name#/rest/69/rci9sp3nsxi27k9c/tsoperator:payments.cashdesks).
paymenttype_id: [обязательный, число] ID типа платежа.
Список доступных типов платежей можно получить, используя метод tsoperator:payments.types (пример: https://#server_name#/rest/69/rci9sp3nsxi27k9c/tsoperator:payments.types).
sign_id: [обязательный, строка] ID признака платежа
Список доступных типов платежей можно получить, используя метод tsoperator:payments.signs (пример: https://#server_name#/rest/69/rci9sp3nsxi27k9c/tsoperator:payments.sign).
price: [обязательный, число] Сумма проводки.
currency: [обязательный, строка] Валюта проводки
Список доступных типов платежей можно получить, используя метод tsoperator:payments.currencies (пример: https://#server_name#/rest/69/rci9sp3nsxi27k9c/tsoperator:payments.currencies).
comment: [необязательный, строка] Комментарий к проводке.
date_create: [необязательный, дата и время в формате dd.mm.yyyy hh:mm:ss] Дата и время создания проводки. Если передается пустое значение, в качестве даты проводки будет фиксироваться дата и время запроса.
Пример запроса:
https://#server_name#/rest/502/f0qxfdhznwqn5ud9/tsoperator:payments.processpayment
{ "order_id": "123", "cashdesk_id": "1", "paymenttype_id": "2", "sign_id": "ALL", "price": 1450,
"currency": "RUB",
"comment": "Комментарий",
"date_create": "12.12.2024 12:12:12" }
В случае успешного проведения платежа в ответе на запрос возвращается массив с ID проводки.
Пример успешного ответа:
{
"result": { "paymentId": 305 }, "time": { "start": 1727772947.552967, "finish": 1727772947.59291, "duration": 0.03994297981262207, "processing": 0.026877164840698242, "date_start": "2024-10-01T11:55:47+03:00", "date_finish": "2024-10-01T11:55:47+03:00" } }
В случае ошибочного запроса, в ответе возвращается код ошибки и ее описание:
Пример ответа на ошибочный запрос:
{
"error": 106, "error_description": "Укажите валюту" } Импорт данных | Описание курса |
Copyright © 2022 - ТрэвелСофт