Преминете към съдържанието
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 endpoints и права. Промяната на записания статус на плащане не таксува карта и не възстановява сума чрез платежен доставчик.

Безопасни записи

Права и планове

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 е общата сума на поръчката. Статусът на плащането не определя платени, възстановени или дължими суми.

Схеми на данните

Ръководства

Експорт на поръчки