Различия

Показаны различия между двумя версиями страницы.

--- rest_cl [2022/10/18 07:04] – timofeev
+++ rest_cl [2024/12/01 10:39] (текущий) – timofeev
@@ Строка 1: / Строка 1: @@
 ===Клиенты - работа со списками и записями===
-==- получить список клиентов==
+==Список клиентов==
 Пример запроса (записи не более 2 клиентов, созданных или обновленных после 1 января 2020 г.):
 <code>
@@ Строка 70: / Строка 70: @@
 </code>
 Возвращаемое значение - ДОЛГ клиента на утро текущего дня (без учета отгрузок и платежей, проведенных текущим днем). Отрицательное значение возвращается, если есть предоплата.
+==Получить задолженность контрагента по таре==
+Пример
+<code>
+GET http://127.0.0.1:10400/api/clients/1000000000185/bottles
+</code>
+Ответ (ДОЛГ 10 бутылей)
+<code>
+{"result": 10}
+</code>
+Возвращаемое значение - ДОЛГ клиента по таре на утро текущего дня (без учета документов, проведенных текущим днем). \\
+Долг = остаток тары у клиента - количество бутылей, за которое уплачен залог - число выкупленных.\\
+[[api_sverka|Получение сверки по  взаиморасчетам и таре через API]]
+==Получить сумму бонусов на счету контрагента (в рублях)==
+GET /clients/:id/bonus
+Пример
+<code>
+GET http://127.0.0.1:10400/api/clients/1000000000048/bonus
+</code>
+Ответ
+<code>
+{"result": 45.99}
+</code>
+Возвращаемое значение - сумма бонусов на счету клиента на утро текущего дня (без учета отгрузок и платежей, проведенных текущим днем).
 ==Получить данные контрагента по номеру телефона==
@@ Строка 186: / Строка 219: @@
 Если передан параметр psw, будет сохранен хэш от этого значения для поиска клиента при вызове метода  /api/clients?psw\\
+==Изменить реквизиты клиента==
+PATCH /clients/:id
+Пример
+<code>
+http://127.0.0.1:10400/api/clients/1000000000060
+</code>
+Тело запроса (JSON, содержащий измененные поля; служебные поля будут проигнорированы).
+<code>
+{"naimenovanie":"Торговый дом 'Сидоров и сыновья'", "dop_sv":"Проверка API", "NEVYGRV1C":"1}
+</code>
+ответ
+<code>
+OK
+</code>
+[[rest_adr|Продолжение - работа со списками и записями адресов клиентов]]
 [[rest_s|Работа со справочниками через REST API]]