Przejdź do głównej zawartości

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.

  • 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 id z GET /api/v3/Connections.
  • source.connectionId = ID tego połączenia, source.platformOrderId = ID zamówienia w Twoim systemie. Para ta identyfikuje zamówienie; z allowDuplicates: false drugie 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.
  1. 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ń.

  2. Wyślij zamówienie — POST /api/v5/Orders

    Okno 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" }
    }
    ]
    }
  3. Sprawdź wynik zadania — GET /api/v3/jobs/get/{id}, aż status będzie Completed lub Failed.

  4. Odczytaj zamówienie po własnym numerze — GET /api/v5/Orders/{platformConnectionId}/{orderId}, np. /api/v5/Orders/12/WEB-100231. Tak poznasz id nadane przez Sellrocket.

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.

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 } }
}
]

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: true

Jednorazowy 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.

  • Ustaw allowDuplicates: false i zawsze podawaj platformOrderId — ponowienie żądania po błędzie sieci nie utworzy wtedy duplikatu.
  • Odpowiedź 200 nie oznacza, że zamówienie istnieje — to tylko przyjęcie zadania. Błędy danych zobaczysz w result zadania ze statusem Failed.
  • 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.
  • 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.