Zwroty

Pobierz szczegóły konkretnego zwrotu

Changed on

Zwraca pełne dane zwrotu. Odpowiedź możesz zmienić (np. status lub opis) i od razu wysłać w PUT /returns/{id}.

get/returns/{id}

Request

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

Path parameters

idinteger required
Example:666

ID dokumentu zwrotu w Sellasist

Response

Sukces. Zwraca szczegółowe dane zwrotu.

idinteger
datestring
statusstring nullable
status_idinteger nullable
return_numberstring
external_return_numberstring nullable
order_numberinteger nullable

ID powiązanego zamówienia w Sellasist

sourcestring nullable
source_idinteger nullable
descriptionstring
bankaccountstring
shipment_pricenumber float nullable
refund_valuenumber float
refund_datestring nullable
refund_currencystring
payment_idinteger nullable
tracking_numberstring nullable
additional_tracking_numbersstring nullable
allegro_order_idstring nullable
termstring nullable

Termin na rozpatrzenie zwrotu

accept_datestring nullable

Data przyjęcia / zaakceptowania zwrotu

close_datestring nullable

Data zamknięcia zgłoszenia zwrotu

completedinteger
dispatch_datestring nullable

Data nadania przesyłki zwrotnej przez kupującego

dispatch_term_datestring nullable

Termin nadania przesyłki zwrotnej

courierstring nullable

Nazwa kuriera / sposobu wysyłki zwrotu, tak jak w panelu

courier_idinteger nullable

ID sposobu wysyłki w Sellasist; puste, gdy sposób wysyłki zapisano tylko nazwą (np. zgłoszenie z formularza lub z Allegro)

last_payment_status'NEW' | 'WAITING' | 'IN_PROGRESS' | 'SUCCESS' | 'CANCELLED' | 'CANCELED' | 'PARTIAL' nullable

Kod statusu ostatniego zwrotu płatności (obecnie dla zamówień z Allegro)

last_payment_status_textstring nullable

Status ostatniego zwrotu płatności opisowo

returned_valuenumber float

Całkowita zwrócona kwota (produkty i koszt dostawy). Koszt dostawy dotyczy całego zamówienia — nie sumuj tej kwoty między zwrotami jednego zamówienia

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,
  "description": "Klient odstępuje od umowy bez podania przyczyny.",
  "bankaccount": "PL12345678901234567890123456",
  "shipment_price": 12,
  "refund_value": 89.99,
  "refund_date": "2026-07-22",
  "refund_currency": "PLN",
  "payment_id": 3,
  "tracking_number": "603236276201506110294169",
  "additional_tracking_numbers": "603236276201506110294170",
  "allegro_order_id": "9f8a32b1-1234-5678-abcd-09876543210f",
  "term": "2026-08-03 12:25:43",
  "accept_date": "2026-07-21 10:00:00",
  "close_date": "2026-07-22 15:30:00",
  "completed": 1,
  "dispatch_date": "2026-07-22 12:30:00",
  "dispatch_term_date": "2026-07-29 12:30:00",
  "courier": "DHL Przesyłka krajowa",
  "courier_id": 14,
  "last_payment_status": "SUCCESS",
  "last_payment_status_text": "Zrealizowano",
  "returned_value": 43.24,
  "sale_doc_data": {
    "name": "Jan",
    "surname": "Kowalski",
    "street": "Kolejowa",
    "home_number": "12",
    "flat_number": "4",
    "description": "Kod do bramy 1234",
    "postcode": "00-001",
    "city": "Warszawa",
    "phone": "123456789",
    "country": 170,
    "country_code": "PL",
    "company_name": "Firma Sp. z o.o.",
    "company_nip": "1234567890",
    "state": "Mazowieckie"
  },
  "returned_products": [
    {
      "id": 81,
      "cart_id": 10214,
      "product_id": 341,
      "variant_id": 7691,
      "topic": "Odstąpienie od umowy",
      "name": "Koszulka sportowa męska FIT",
      "quantity": 1,
      "quantity_returned": 1,
      "quantity_accepted": 1,
      "unit_price": 89.99,
      "price_total": 89.99,
      "vat": 23,
      "return_value": 89.99,
      "value_returned": 89.99,
      "returned_products_value": 89.99,
      "status": "Przyjęto na stan",
      "status_id": 2,
      "description": "Brak śladów użytkowania",
      "note": "Zwrot przyjęty na magazyn główny"
    }
  ],
  "payment_log": [
    {
      "id": 88412,
      "date": "2026-10-05 12:30:00",
      "payment_data": "a1b2c3d4-5678",
      "name": "Zwrot płatności (dostawa)",
      "payment_id": null,
      "amount": 14.99,
      "currency": "PLN",
      "completed": false,
      "outgoing": false,
      "refund_status": "SUCCESS",
      "refund_status_text": "Zrealizowano",
      "return_id": 1532
    },
    {
      "id": 88107,
      "date": "2026-10-01 10:00:00",
      "payment_data": "PAY-7781",
      "name": "Przelew online",
      "payment_id": 5,
      "amount": 149.99,
      "currency": "PLN",
      "completed": true,
      "outgoing": false,
      "refund_status": null,
      "refund_status_text": null,
      "return_id": null
    }
  ],
  "shipping": {
    "shipment_method": "Kurier DPD",
    "shipment_method_id": 7,
    "return_shipment_status": "IN_TRANSIT",
    "return_shipment_status_text": "Przesyłka jest w drodze."
  }
}

Changes

    • breaking

      the response property became nullable for the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • breaking

      for the path request parameter id, the type changed from no type to integer

    • breaking

      the response property became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response's property type changed from string to integer for status

    • breaking

      the // response's property type changed from string to number, and format from no format to float for status

    • breaking

      the // response's property type changed from string to integer for status

    • breaking

      the // response's property type changed from string to number, and format from no format to float for status

    • breaking

      the // response's property type changed from integer to string for status

    • breaking

      the // response's property type changed from string to number, and format from no format to float for status

    • breaking

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

    • warning

      removed the optional property // from the response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status