метод REST scope: crm

crm.item.payment.delivery.list

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

Кто может выполнять: требуется право на чтение заказа оплаты

Описание

Метод получает список позиций доставки по конкретной оплате.

Параметры

paymentId sale_order_payment.id обязательный

Идентификатор оплаты.
Можно получить с помощью метода sale.payment.list

filter object обязательный

Объект для фильтрации выбранных позиций доставки в формате {"field_1": "value_1", ... "field_N": "value_N"}.

Возможные значения для field:
- id
- quantity

Ключу может быть задан дополнительный префикс, уточняющий поведение фильтра. Возможные значения префикса:

  • = — равно, точное совпадение (используется по умолчанию)
  • % — LIKE, поиск по подстроке. Символ % в значении фильтра передавать не нужно. Поиск ищет подстроку в любой позиции строки
  • > — больше
  • < — меньше
  • != — не равно
  • !% — NOT LIKE, поиск по подстроке. Символ % в значении фильтра передавать не нужно. Поиск идет с обоих сторон.
  • >= — больше либо равно
  • <= — меньше либо равно
  • @ — IN, в качестве значения передается массив
  • !@ — NOT IN, в качестве значения передается массив
  • =% — LIKE, поиск по подстроке. Символ % нужно передавать в значении. Примеры:
    - "мол%" — ищем значения начинающиеся с «мол»
    - "%мол" — ищем значения заканчивающиеся на «мол»
    - "%мол%" — ищем значения, где «мол» может быть в любой позиции
  • %= — LIKE (смотрите описание выше)
  • !=% — NOT LIKE, поиск по подстроке. Символ % нужно передавать в значении. Примеры:
    - "мол%" — ищем значения не начинающиеся с «мол»
    - "%мол" — ищем значения не заканчивающиеся на «мол»
    - "%мол%" — ищем значения, где подстроки «мол» нет в любой позиции
  • !%= — NOT LIKE (смотрите описание выше)
order object необязательный

Объект для сортировки выбранных позиций доставки оплаты в формате {"field_1": "order_1", ... "field_N": "order_N"}.

Возможные значения для field:
- id
- quantity

Возможные значения для order:

  • asc — в порядке возрастания
  • desc — в порядке убывания

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"paymentId":1040,"filter":{"@id":[1201], ">=quantity":1}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.item.payment.delivery.list

Ответ

HTTP-статус: 200

{
   "result":[
      {
         "id":1201,
         "paymentId":1040,
         "quantity":1,
         "deliveryId":4073
      }
   ],
   "time":{
      "start":1716301848.792584,
      "finish":1716301849.095721,
      "duration":0.30313706398010254,
      "processing":0.05563783645629883,
      "date_start":"2024-05-21T17:30:48+03:00",
      "date_finish":"2024-05-21T17:30:49+03:00"
   }
}

Возвращаемые данные

result crm_item_payment_delivery[]

Массив объектов, содержащий информацию о выбранных позициях доставки оплаты

time time

Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 400

{
   "error":0,
   "error_description":"Payment has not been found"
}
Код Описание Значение
0 Оплата не найдена
0 Доступ запрещен
100 Не переданы обязательные параметры
0 Другие ошибки (например, фатальные ошибки)

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.