Dodawanie zamówień
Jeśli sprzedajesz w kanale, którego Sellrocket nie obsługuje natywnie (własny sklep, B2B, aplikacja mobilna, telefon), przekazujesz zamówienia przez API. Każde zamówienie musi wskazywać połączenie reprezentujące Twój kanał oraz numer zamówienia w Twoim systemie — dzięki temu Sellrocket rozpoznaje duplikaty, a Ty możesz odnaleźć zamówienie po własnym ID.
Jak to działa
Dział zatytułowany „Jak to działa”- Połączenie (Connection) to kanał sprzedaży. Dla własnej integracji utwórz w panelu połączenie typu „Pozostałe kanały sprzedaży” i odczytaj jego
idzGET /api/v3/Connections. source.connectionId= ID tego połączenia,source.platformOrderId= ID zamówienia w Twoim systemie. Para ta identyfikuje zamówienie; zallowDuplicates: falsedrugie zamówienie z tym samym numerem nie zostanie utworzone.- Zapis jest asynchroniczny — w odpowiedzi dostajesz zadanie (
JobDTO), a nie gotowe zamówienie. Zobacz Operacje asynchroniczne.
Dodanie zamówienia
Dział zatytułowany „Dodanie zamówienia”-
Ustal ID połączenia i statusu
Okno terminala curl "https://$SR_INSTANCE-smerp-api.enterprise.sellrocket.pl/api/v3/Connections?limit=100" \-H "Authorization: Bearer $SR_TOKEN"curl "https://$SR_INSTANCE-smerp-api.enterprise.sellrocket.pl/api/v3/Statuses/GetAll" \-H "Authorization: Bearer $SR_TOKEN"Status początkowy zamówienia wskazujesz w
status.id. Statusy są inne w każdej instancji — zobacz Statusy zamówień. -
Wyślij zamówienie —
POST /api/v5/OrdersOkno terminala curl -X POST "https://$SR_INSTANCE-smerp-api.enterprise.sellrocket.pl/api/v5/Orders" \-H "Authorization: Bearer $SR_TOKEN" \-H "Content-Type: application/json" \-d @order.json{"source": { "connectionId": 12, "platformOrderId": "WEB-100231" },"allowDuplicates": false,"platformDateAddedUtc": "2026-10-05T08:12:00Z","platformDateConfirmedUtc": "2026-10-05T08:15:00Z","status": { "id": 1 },"buyer": { "email": "klient@example.com", "fullName": "Klient Przykładowy", "phone": "+48500100200" },"delivery": {"recipient": {"fullName": "Klient Przykładowy","phone": "+48500100200","address": { "street": "Prosta", "houseNo": "1", "apartmentNo": "2", "city": "Warszawa", "postCode": "00-001", "countryCode": "PL" }},"method": { "platformId": "dpd", "platformName": "Kurier DPD" },"cost": { "currency": "PLN", "amount": 14.99 },"isCod": false},"invoice": { "required": false },"lineItems": [{"platformId": "1","product": { "name": "Kubek ceramiczny 300 ml", "code": "KUB-300", "ean": "5901234123457" },"quantity": 2,"price": { "currency": "PLN", "unitPrice": 39.9 }}],"payments": {"paymentName": "Przelewy24","payments": [{"platformId": "P24-778812","platformName": "Przelewy24","finishedAtUtc": "2026-10-05T08:14:30Z","paymentAmount": { "currency": "PLN", "amount": 94.79 },"paid": true}]},"summary": { "totalToPay": { "currency": "PLN", "amount": 94.79 } },"additionalField1": "B2B","elasticFields": [{"fieldName": "kanal_marketingowy", "fieldType": "text", "fieldValue": "newsletter","definition": { "fieldName": "kanal_marketingowy", "fieldDisplayName": "Kanał marketingowy", "fieldType": "text" }}]} -
Sprawdź wynik zadania —
GET /api/v3/jobs/get/{id}, ażstatusbędzieCompletedlubFailed. -
Odczytaj zamówienie po własnym numerze —
GET /api/v5/Orders/{platformConnectionId}/{orderId}, np./api/v5/Orders/12/WEB-100231. Tak poznaszidnadane przez Sellrocket.
Najważniejsze pola
Dział zatytułowany „Najważniejsze pola”| Pole | Znaczenie |
|---|---|
platformDateAddedUtc |
Wymagane. Data złożenia zamówienia w Twoim systemie |
platformDateConfirmedUtc |
Data potwierdzenia (np. opłacenia lub akceptacji) zamówienia |
lineItems[] |
Pozycje: product (name, code, ean…), quantity, price.unitPrice (brutto), tax; platformId — ID pozycji w Twoim systemie |
payments |
Nazwa metody płatności i lista wpłat (paid, kwota, data) |
delivery.pickupPoint |
Punkt odbioru: code, name, address |
invoice |
required i dane płatnika (payer), jeśli różne od kupującego |
elasticFields[] |
Wartości pól elastycznych zapisywane razem z zamówieniem. Pole musi mieć definicję — załóż ją wcześniej albo przekaż w definition (fieldName, fieldDisplayName, fieldType, predefinedValues); inaczej zadanie zakończy się błędem |
Płatności możesz też dopisać później: POST /api/v3/Orders/{orderId}/Payments.
Wiele zamówień naraz
Dział zatytułowany „Wiele zamówień naraz”POST /api/v5/Orders/batch-upsert przyjmuje tablicę zamówień i zwraca jedno zadanie. Element bez id tworzy zamówienie, z id — aktualizuje istniejące. Pole clientReference (np. Twój numer zamówienia) pozwala dopasować wyniki do wysłanych rekordów.
[ { "clientReference": "WEB-100232", "source": { "connectionId": 12, "platformOrderId": "WEB-100232" }, "allowDuplicates": false, "platformDateAddedUtc": "2026-10-05T09:01:00Z", "buyer": { "email": "firma@example.com", "companyName": "Przykładowa Firma sp. z o.o.", "rawCompanyTaxId": "5250000000" }, "lineItems": [ { "platformId": "1", "product": { "name": "Kubek ceramiczny 300 ml", "code": "KUB-300" }, "quantity": 24, "price": { "currency": "PLN", "unitPrice": 29.9 } } ], "summary": { "totalToPay": { "currency": "PLN", "amount": 717.6 } } }]Import historycznych zamówień
Dział zatytułowany „Import historycznych zamówień”Przy migracji danych nie chcesz, żeby stare zamówienia uruchamiały automatyzacje (e-maile do klientów, zmiany statusów, wystawianie dokumentów). Dodaj nagłówek:
X-SR-ForceSilentChanges: trueJednorazowy import z pliku CSV możesz też wykonać przez serwis Importy — POST /api/v2/Imports/orders/import z mapowaniem kolumn; również ma opcję forceSilentChanges.
Na co uważać
Dział zatytułowany „Na co uważać”- Ustaw
allowDuplicates: falsei zawsze podawajplatformOrderId— ponowienie żądania po błędzie sieci nie utworzy wtedy duplikatu. - Odpowiedź
200nie oznacza, że zamówienie istnieje — to tylko przyjęcie zadania. Błędy danych zobaczysz wresultzadania ze statusemFailed. - Kwoty są brutto, a waluta jest podawana przy każdej kwocie.
- Nie twórz osobnego połączenia dla każdego zamówienia — jedno połączenie „Pozostałe kanały sprzedaży” na jeden kanał sprzedaży.
- Nowe zamówienie (bez nagłówka trybu cichego) uruchamia automatyzacje skonfigurowane w instancji — uzgodnij z administratorem, co się wtedy dzieje.
Odpowiedniki w BaseLinker
Dział zatytułowany „Odpowiedniki w BaseLinker”addOrder→POST /api/v5/Orders.order_source_id→source.connectionId(ID połączenia Sellrocket; żeby zachować ID źródeł z BaseLinkera, zobacz Identyfikatory z BaseLinkera);shop_order_id/external_order_id→source.platformOrderId.date_add→platformDateAddedUtc;extra_field_1/2→additionalField1/2;custom_extra_fields→elasticFields.setOrderPayment→POST /api/v3/Orders/{orderId}/Payments.

