QUINCEFIN
Відкрити меню

QUINCE API. Ціни товарів

Список методів

| /price/list | Отримання списку цін |

Отримання списку цін

Назва методу: /price/list

Повертає список цін товарів і послуг. Для навігації використовується номер сторінки (page).

Розмір сторінки фіксований і дорівнює 100 елементам.

Параметри запиту:

| filter Тип: object (необов’язковий) | Доступні поля фільтру (використовується логіка “AND“): |

| | PriceType- масив ідентифікаторів типиів цін. Необов’язковий параметр |

| | Product - масив ідентифікаторів товарів. Необов’язковий параметр |

| | Date - Дата, на яку повертаються ціни. Якщо не вказано, то береться поточна дата. Необов’язковий параметр |

| page Тип: integer (необов’язковий) | Якщо в запиті не передати, за замовчуванням буде встановлена перша сторінка. |

Результат запиту:

Якщо в запиті фільтр відсутній, то повертається список цін у порядку зростання Id.

Значення полів цін, що повертаються методом:

| Id | Ідентифікатор ціни (int) |

| Date | Дата початку дії ціни (string) |

| PriceType | Ідентифікатор типу ціни (int) |

| Product | Ідентифікатор товару (int) |

| Price | Ціна товару (decimal) |

| Currency | Код валюти (string) |

Приклад:

Запит:

{
    "filter": {
      "PriceType": [
          110
      ],
      "Product": [
          204,
          205
      ]
    },
    "page": 1
}

Результат:

{
    "success": true,
    "data": [
        {
            Id": 111,
            "Date": "2022-07-12T00:00:00Z",
            "PriceType": 110,
            "Product": 205,
            "Price": 20.00,
            "Currency": "USD"
        },
        ...
    ]
}

Створення цін

Метод створення цін: /api/v2/price/add

Метод додає ціни. Максимальна кількість цін в одному пакеті - 100.

Параметри запиту:

| array Тип: масив (Обов’язковий) | Кожна ціна в масиві являє собою об’єкт з наступними полями: |

| Product* | Id товару (int) |

| PriceType* | Id типу ціни (integer) |

| Date* | Дата початку дії ціни (string). Формат: yyyy-mm-dd |

| Price* | Ціна товару (decimal) |

  • обов’язкове поле

Результат запиту:

Метод повертає масив:

| success | true або false |

| data | Масив ідентифікаторів створених цін |

| error | Зміст помилки (вказується, якщо success = false) |

Приклад:

Запит:

{
    "strict": true,
    "array": [
        {
            "Product": 14489,
            "PriceType": 243,
            "Date": "2024-11-12",
            "Price": 55.55
        },
        ...
    ]
}

Результат:

{
    "success": true,
    "data": [
        {
            "id": 722
        },
        ...
    ]
}

Оновлення цін

Метод оновлення цін: /api/v2/price/update

Метод оновлює ціни. Максимальна кількість цін в одному пакеті - 100.

Оновити ціну можна двома способами:

  1. Передати Id ціни. Якщо в запиті Id переданий, але не знайдений в довіднику цін, жодна ціна також не оновлюється і додатково повертається перелік незнайдених Id.
  2. Передати Id товару та Id типу ціни. Якщо не вказати дату, то автоматично буде назначена поточна дата.

Параметри запиту:

| array Тип: масив (Обов’язковий) | Кожна ціна в масиві являє собою об’єкт з наступними полями: |

| Id* | Ідентифікатор ціни (int). Обов’язкове. |

| Date | Дата початку дії ціни (string). Формат: yyyy-mm-dd |

| Price* | Ціна товару (decimal) |

Або

| array Тип: масив (Обов’язковий) | Кожна ціна в масиві являє собою об’єкт з наступними полями: |

| Product* | Ідентифікатор продукту (int). Обов’язкове. |

| PriceType* | Ідентифікатор типу ціни (int). Обов’язкове. |

| ** Date** | Дата початку дії ціни (string). Формат: yyyy-mm-dd |

| Price* | Ціна товару (decimal) |

  • обов’язкове поле

Результат запиту:

Метод повертає масив:

| success | true або false |

| data | Масив ідентифікаторів оновлених цін |

| error | Зміст помилки (вказується, якщо success = false) |

Приклад:

Запит:

{
    "strict": true,
    "array": [
        {
            "Id": 722,
            "Price": 102.12,
            "Date": "2024-11-12"
        },
        ...
    ]
}

Результат:

{
    "success": true,
    "data": [
        {
            "id": 722
        },
        ...
    ]
}