Zarejestruj nowy zwrot (RMZ)
Changed onTworzy nowy dokument zwrotu. Wskazówki integracyjne (Skąd wziąć dane): - order_number: ID zamówienia z GET /orders. - status_id lub status: ID z GET /returns_statuses (lub wpisz po prostu typ/nazwę np. "positive", "new"). - source_id lub source: ID lub nazwa z GET /returns_sources. - returned_products[].cart_id: ID pozycji w koszyku zamówienia z GET /orders/{order_id} (tablica carts[].id). Jeśli podasz cart_id, system sam pobierze nazwę, ID produktu, wariantu oraz cenę! - return_number: Opcjonalne pole. Jeśli puste, system wygeneruje automatyczny numer w formacie RMZ{numer}{data}. - term: Opcjonalne pole daty terminu rozpatrzenia. W przypadku braku system ustawi automatycznie +14 dni od daty zwrotu.
Request
- Base URLhttps://demo.sellasist.pl/api/v1
- URLhttps://demo.sellasist.pl/api/v1/returns
- AuthAPI key in header apiKey
Request body
Example request
{
"order_number": 1234,
"status_id": 1,
"source_id": 1,
"return_number": "RMZ215042024",
"description": "Klient odstępuje od umowy w terminie 14 dni.",
"bankaccount": "PL12345678901234567890123456",
"refund_value": 89.99,
"refund_currency": "PLN",
"tracking_number": "603236276201506110294169",
"sale_doc_data": {
"name": "Jan",
"surname": "Kowalski",
"street": "Kolejowa",
"home_number": "12",
"flat_number": "4",
"postcode": "00-001",
"city": "Warszawa",
"phone": "123456789",
"country": "PL"
},
"returned_products": [
{
"cart_id": 10214,
"quantity": 1,
"quantity_returned": 1,
"quantity_accepted": 1,
"unit_price": 89.99,
"return_value": 89.99,
"value_returned": 89.99,
"topic": "Odstąpienie od umowy",
"description": "Towar nienaruszony",
"note": "Przyjęto na magazyn główny"
}
]
}Response
Pomyślnie zarejestrowano zwrot. Zwraca pełny obiekt utworzonego dokumentu (gotowy do natychmiastowego użycia w PUT).
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
- info
endpoint added
- info