Pobierz listę zwrotów
const url = 'https://twoja-instancja-smerp-api.enterprise.sellrocket.pl/api/v4/returns';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://twoja-instancja-smerp-api.enterprise.sellrocket.pl/api/v4/returns \ --header 'Authorization: Bearer <token>'Stronicowana lista zwrotów z filtrami. Odpowiednik getOrderReturns w BaseLinker.
Autoryzacja
Dział zatytułowany „Autoryzacja”Parametry
Dział zatytułowany „Parametry”Parametry zapytania
Dział zatytułowany „Parametry zapytania”Offset (liczba pominiętych wyników)
Limit (maksymalna liczba wyników)
Operator wyszukiwania (AND/OR)
Zwrot statusu (ID statusu zwrotu)
ID zwrotu
ID zamówienia pierwotnego
Data utworzenia: zakres od
Data utworzenia: zakres do
Data w statusie: zakres od
Data w statusie: zakres do
Imię
Nazwisko
Adres e-mail
Numer telefonu kupującego
Nazwa użytkownika kupującego
Numer telefonu odbiorcy
Łączna cena: zakres od
Łączna cena: zakres do
Typ zwrotu, możliwe wartości: “Any”, “Full”, “Partial”
Nazwa produktu
SKU produktu (code)
EAN produktu
ID zwrotu platformy źródłowej
Nazwa firmy odbiorcy
Numer przesyłki (odwrócony filtr, shipmentNumber musi się zawierać w podanej wartości)
Numer przesyłki
ID statusu zamówienia, używany jest przed wszystkimi innymi filtrami niezależnie od operatora
ID zwrotu: zakres od (włącznie)
ID zwrotu: zakres do (włącznie)
ID połączenia (SourceConnectionId)
Typ połączenia (PlatformName)
Pole sortowania (domyślnie Id)
Kierunek sortowania (Ascending/Descending, domyślnie Ascending)
Czy dołączyć pola elastyczne zwrotu (domyślnie false)
Czy dołączyć pola elastyczne pozycji zwrotu (domyślnie false)
Filtry pól elastycznych zwrotu w postaci AdditionalFieldsFilters[nazwa pola]=wartość (wartość pola musi zawierać podany tekst, bez rozróżniania wielkości liter)
object
Odpowiedzi
Dział zatytułowany „Odpowiedzi”Success
object
object
object
object
object
object
object
object
object
object
object
object
object
object
object
object
object
object
object
object
object
object
Examplegenerated
{ "list": [ { "id": 1, "connectionId": "example", "connectionType": "example", "sourcePlatformAccountId": "example", "sourcePlatformOrderId": "example", "sourcePlatformReturnId": "example", "platformDateAddedUtc": "2026-04-15T12:00:00Z", "payments": { "paymentName": "example", "payments": [ { "id": 1, "platformId": "example", "platformName": "example", "finishedAtUtc": "2026-04-15T12:00:00Z", "currency": "example", "amount": 1 } ] }, "buyer": { "email": "example", "username": "example", "phone": "example" }, "delivery": { "recipient": { "username": "example", "firstName": "example", "lastName": "example", "companyName": "example", "phone": "example", "address": { "apartmentNo": "example", "houseNo": "example", "street": "example", "city": "example", "postCode": "example", "state": "example", "countryCode": "example" } }, "cost": { "currency": "example", "amount": 1 } }, "summary": { "totalToPay": { "currency": "example", "amount": 1 } }, "returnStatusId": 1, "status": { "id": 1, "from": "2026-04-15T12:00:00Z" }, "additionalField1": "example", "additionalField2": "example", "additionalFields": [ { "objectId": 1, "ownerType": "example", "definitionId": 1, "fieldType": "example", "fieldName": "example", "fieldDisplayName": "example", "fieldValue": "example" } ], "packStationId": 1, "orderReturnAccountNumber": "example", "orderReturnIBan": "example", "orderReturnSwitft": "example", "fulfillmentStatus": 1, "lineItems": [ { "product": { "id": 1, "warehouseId": "example", "platformId": "example", "name": "example", "code": "example", "ean": "example", "imageUrl": "example", "bundleId": "example", "storage": "example", "parentName": "example", "variantId": "example", "location": "example" }, "platformId": "example", "quantity": 1, "quantityPicked": 1, "quantityPacked": 1, "tax": { "symbol": "example", "rate": 1 }, "price": { "currency": "example", "unitPrice": 1 }, "originalCreatedAt": "2026-04-15T12:00:00Z", "returnsReasonId": 1, "returnsPositionStatusId": 1, "additionalFields": [ { "objectId": 1, "ownerType": "example", "definitionId": 1, "fieldType": "example", "fieldName": "example", "fieldDisplayName": "example", "fieldValue": "example" } ], "miniatures": { "originalImageUrl": "example", "selector": "example", "entityId": "example" }, "clientNote": "example" } ], "orderId": 1, "isComplete": true, "shipments": [ { "id": 1, "shipmentId": "example", "dateAddedUtc": "2026-04-15T12:00:00Z", "courierCode": "example", "trackingNumber": "example", "externalCarrierTrackingNumber": "example", "status": "example", "connectionId": "example", "courierConnectionType": "example", "courierService": "example", "trackingUrl": "example", "courierTransport": [ "example" ], "deliveryMethodPlatformId": "example", "shippingDate": "2026-04-15", "isReturn": true, "connection": { "id": 1, "name": "example", "connectionType": "example", "externalSourceType": "example", "externalSourceTypeName": "example", "externalSourceId": "example", "isConfigured": true, "isSystemTool": true, "positionInDefinition": { "position": 1 }, "createdAt": "2026-04-15T12:00:00Z" }, "courierPickup": true } ], "referenceNumber": "example", "externalPackage": true, "buyerComment": "example" } ], "pageNumber": 1, "total": 1}
