Перейти до вмісту
ShopentlyLearn

Замовлення

Читайте зведення й деталі замовлень, а потім оновлюйте статус замовлення чи оплати.

Операції

GETОтримати список · Статуси — Замовлення/api/v1/order-statuses

GETОтримати список — Замовлення/api/v1/orders

GETОтримати — Замовлення/api/v1/orders/{order_id}

PATCHОновити · Статус оплати — Замовлення/api/v1/orders/{order_id}/payment-status

PATCHОновити · Статус — Замовлення/api/v1/orders/{order_id}/status

Як це працює

Список і деталі замовлення містять delivery.dates. Заплановані дати YYYY-MM-DD не підтверджують відправлення. Поточні дати мають пріоритет; для старих замовлень використовується збережена оцінка. Очищені або невідомі значення — null. Деталі також містять усі позиції та зображення товарів.

Отримуйте допустимі ідентифікатори статусів через /api/v1/order-statuses. Статус замовлення й статус оплати мають окремі кінцеві точки PATCH та дозволи. Зміна записаного статусу оплати не списує кошти з картки й не виконує повернення через платіжного провайдера.

delivery.dates: planned_dispatch_on, dispatch_timezone, estimated_delivery_from, estimated_delivery_to. Дати відправлення й доставки: YYYY-MM-DD; null. Часовий пояс відправлення: IANA.

Замовлення · Підсумки

Суми й ставки походять зі збереженого замовлення, включно з виправленнями позицій. Відсутні історичні дані мають значення null і не замінюються поточними ставками каталогу. Суми залишаються десятковими рядками.

  • tax_country_code · Країна оподаткування · Збережені дані замовлення · ISO 3166-1 alpha-2; null.
  • lines[].unit_* · Одна одиниця · До знижок; lines[].original_total_* · До знижок; lines[].total_* · Після знижок.
  • lines[].discount_* · Знижки; manual_discount · Ручна знижка; percentage "10" = 10%.
  • delivery.net / tax / gross · Після знижок; delivery.original_* · До знижок; delivery.discount_* · Знижки.
  • tax_rate: "0.23" = 23%; "0" ≠ null. Невідомо: null; відомий нуль: 0.
  • totals · Підсумки; tax_breakdown.groups · Податкові групи; Нерозподілений податок = order.tax − Σ groups.tax; ±.

Список повертає підсумки. Для кожного результату отримайте GET /api/v1/orders/{order_id}, щоб експортувати повні фінансові дані. Повторні GET обмежені та враховують Retry-After. Експорт за датою створення не синхронізує пізніші виправлення.

payment.amount — загальна сума замовлення. Статус оплати не визначає сплачені, повернуті чи несплачені суми.

Посібники

Експорт замовлень