SEsellasist
Zwroty

Pobierz listę zarejestrowanych zwrotów

Changed on

Zwraca listę dokumentów zwrotów (RMZ). Umożliwia filtrowanie po dacie, numerze zamówienia, statusie, źródle oraz numerze zwrotu.

get/returns

Request

  • Base URL
    https://demo.sellasist.pl/api/v1
  • URL
    https://demo.sellasist.pl/api/v1/returns
  • Auth
    API key in header apiKey

Query parameters

date_fromstring
Example:2026-07-01 00:00:00

Data utworzenia zwrotu od (format: YYYY-MM-DD HH:MM:SS)

date_tostring
Example:2026-07-31 23:59:59

Data utworzenia zwrotu do (format: YYYY-MM-DD HH:MM:SS)

order_idinteger
Example:1234

ID zamówienia w Sellasist (wskazówka: to samo ID, które występuje w endpointcie GET /orders)

status_idinteger
Example:1

ID statusu zwrotu (wskazówka: pełną listę dostępnych ID statusów pobierzesz z GET /returns_statuses)

source_idinteger
Example:1

ID źródła zwrotu (wskazówka: pełną listę źródeł pobierzesz z GET /returns_sources)

return_numberstring
Example:RMZ120072026

Dokładny numer zwrotu w systemie (np. RMZ120072026)

sort'asc' | 'desc'

Kierunek sortowania po ID (desc - od najnowszych, asc - od najstarszych)

limitinteger

Liczba wyników na stronę (domyślnie 100, maks. 500)

offsetinteger

Przesunięcie wyników (paginacja)

Response

Sukces. Zwraca listę dokumentów zwrotów.

idinteger
datestring
statusstring nullable
status_idinteger nullable
return_numberstring
external_return_numberstring nullable
order_numberinteger nullable
sourcestring nullable
source_idinteger nullable
refund_valuenumber float
refund_currencystring
shipment_pricenumber float nullable
bankaccountstring
tracking_numberstring

Example response

[
  {
    "id": 666,
    "date": "2026-07-20 12:25:43",
    "status": "Zgłoszenie przyjęte",
    "status_id": 1,
    "return_number": "RMZ215042024",
    "external_return_number": "EXT-RET-9921",
    "order_number": 1234,
    "source": "Sklep internetowy",
    "source_id": 1,
    "refund_value": 89.99,
    "refund_currency": "PLN",
    "shipment_price": 12,
    "bankaccount": "PL12345678901234567890123456",
    "tracking_number": "603236276201506110294169"
  }
]

Changes

  • 400197636ecdRevision changes
    • breaking

      the query request parameter sort was restricted to a list of enum values

    • breaking

      for the query request parameter limit, default value 100 was added

    • breaking

      for the query request parameter offset, default value 0 was added

    • breaking

      for the query request parameter sort, default value desc was added

    • breaking

      the response's body type changed from object to array for status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • info

      added the new optional query request parameter return_number

    • info

      added the new optional query request parameter status_id

    • info

      added the new enum value asc to the query request parameter sort

    • info

      added the new enum value desc to the query request parameter sort

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status