Przejdź do treści
ShopentlyLearn
Polski

Zamówienia

Pobieraj podsumowania i szczegóły zamówień oraz zmieniaj status zamówienia lub płatności.

Operacje

GETPobierz statusy zamówień/api/v1/order-statuses

Przykład żądaniaPrzykład odpowiedzi

GETPobierz listę zamówień/api/v1/orders

Przykład żądaniaPrzykład odpowiedzi

GETPobierz zamówienie/api/v1/orders/{order_id}

Przykład żądaniaPrzykład odpowiedzi

PATCHZmień status płatności zamówienia/api/v1/orders/{order_id}/payment-status

Przykład żądaniaPrzykład odpowiedzi

PATCHZmień status zamówienia/api/v1/orders/{order_id}/status

Przykład żądaniaPrzykład odpowiedzi

Jak to działa

Lista i szczegóły zamówienia zawierają delivery.dates. Daty YYYY-MM-DD są planowane, nie potwierdzają nadania. Bieżące daty mają pierwszeństwo; dla starszych zamówień używana jest zapisana estymacja. Wyczyszczone lub nieznane wartości to null. Szczegóły zawierają też wszystkie pozycje i zdjęcia produktów.

Prawidłowe identyfikatory statusów pobierz z /api/v1/order-statuses. Status zamówienia i status płatności mają oddzielne endpointy PATCH i uprawnienia. Zmiana zapisanego statusu płatności nie obciąża karty ani nie zleca zwrotu u operatora płatności.

Bezpieczny zapis

Uprawnienia i plany

delivery.dates: planned_dispatch_on, dispatch_timezone, estimated_delivery_from, estimated_delivery_to. Daty wysyłki i dostawy: YYYY-MM-DD; null. Strefa czasowa wysyłki: IANA.

Zamówienie · Podsumowania

Kwoty i stawki podatku pochodzą z zapisanego zamówienia, z uwzględnieniem korekt pozycji. Brakująca historia ma wartość null; nie zastępują jej bieżące stawki z katalogu. Kwoty pozostają tekstami dziesiętnymi.

  • tax_country_code · Kraj podatkowy · Zapisana migawka zamówienia · ISO 3166-1 alpha-2; null.
  • lines[].unit_* · Jedna sztuka · Przed rabatami; lines[].original_total_* · Przed rabatami; lines[].total_* · Po rabatach.
  • lines[].discount_* · Rabaty; manual_discount · Rabat ręczny; percentage "10" = 10%.
  • delivery.net / tax / gross · Po rabatach; delivery.original_* · Przed rabatami; delivery.discount_* · Rabaty.
  • tax_rate: "0.23" = 23%; "0" ≠ null. Nieznane: null; znane zero: 0.
  • totals · Podsumowania; tax_breakdown.groups · Grupy podatkowe; Nieprzypisany podatek = order.tax − Σ groups.tax; ±.

Lista zwraca podsumowania. Dla każdego wyniku pobierz GET /api/v1/orders/{order_id}, aby wyeksportować pełne rozliczenie. Ponawianie GET jest ograniczone i uwzględnia Retry-After. Eksport według daty utworzenia nie synchronizuje późniejszych korekt.

payment.amount to łączna kwota zamówienia. Status płatności nie określa kwoty wpłaconej, zwróconej ani pozostałej do zapłaty.

Schematy danych

Przewodniki

Jak wyeksportować zamówienia