Dokumentacja API

1. Właściciel konta wchodzi w Połączenia → Klucze API → Nowy klucz, zaznacza zakresy i kopiuje klucz w postaci sm_live_…. Klucz jest pokazywany tylko raz.
2. Każde zapytanie wysyłasz na adres https://app.sellmatic.online/api/v1 z nagłówkiem Authorization: Bearer sm_live_….
3. Odpowiedzi i treść zapytań są w formacie JSON (UTF-8).

curl "https://app.sellmatic.online/api/v1/orders?pageSize=10" \
  -H "Authorization: Bearer sm_live_…"

Klucz jest przypisany do jednej organizacji (konta sprzedawcy). Widzisz tylko jej dane i tylko w zakresach, które zaznaczył właściciel. Nie potrzebujesz ciasteczek ani nagłówka organizacji. Jeśli jednak wyślesz x-organization-id, musi się zgadzać z organizacją klucza.

Klucz nie daje dostępu do ustawień konta, użytkowników, integracji, faktur ani innych kluczy. Każda zmiana wykonana kluczem jest zapisywana w dzienniku audytu z nazwą klucza. Właściciel może unieważnić klucz w każdej chwili, a dostęp znika natychmiast.

• Paginacja: ?page=1&pageSize=50. Odpowiedź listy: { items, total, page, pageSize }.
• Kwoty w odpowiedziach są tekstem z kropką ("249.99"), żeby nie tracić groszy. W zapytaniach możesz wysłać liczbę albo tekst, najwyżej 2 miejsca po przecinku.
• Daty w formacie ISO 8601 (2026-09-27T10:00:00Z). W filtrach wystarczy 2026-09-27.
• Identyfikatory to UUID. Numer zamówienia widoczny w panelu jest w polu number, a numer z Allegro w externalId.
• Stawki VAT: "23", "8", "5", "0" (tekst).

Każdy błąd ma ten sam kształt:

{
  "error": {
    "code": "FORBIDDEN",
    "message": "Nie masz uprawnień do wykonania tej operacji.",
    "requestId": "…"
  }
}

Limit: 300 zapytań na minutę. Po przekroczeniu dostaniesz 429. Do synchronizacji dużych katalogów używaj filtrów (np. statusChangedFrom) i większych stron zamiast pobierania wszystkiego za każdym razem.

Zamówienia ze wszystkich źródeł (Allegro, ręczne, API) w jednym miejscu. Zmiana statusu przez API uruchamia te same automatyczne akcje co zmiana w panelu.

Katalog produktów z wariantami, zdjęciami, kategoriami i markami. SKU jest unikalne w organizacji (produkty i warianty razem).

Zmiana stanu zapisuje ruch magazynowy z powodem. Jeśli sprzedawca ma włączone wysyłanie stanów do Allegro, nowy stan trafi też do powiązanych ofert.

Opłacone zamówienia z ostatniego dnia

curl "https://app.sellmatic.online/api/v1/orders?paid=paid&dateFrom=2026-09-26&pageSize=100" \
  -H "Authorization: Bearer sm_live_…"

{
  "items": [
    {
      "id": "3f6c…",
      "number": 10482,
      "externalId": "a1b2c3d4-…",
      "source": "allegro",
      "status": { "id": "9e1d…", "name": "Do wysyłki", "color": "#f97316" },
      "totalGross": "249.99",
      "currency": "PLN",
      "orderedAt": "2026-09-26T18:42:11.000Z",
      …
    }
  ],
  "total": 37,
  "page": 1,
  "pageSize": 100
}

Zmiana statusu zamówienia

Id statusu weźmiesz z GET /order-statuses.

curl -X PUT "https://app.sellmatic.online/api/v1/orders/3f6c…/status" \
  -H "Authorization: Bearer sm_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "statusId": "9e1d…" }'

Nowe zamówienie

curl -X POST "https://app.sellmatic.online/api/v1/orders" \
  -H "Authorization: Bearer sm_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "customer": { "firstName": "Anna", "lastName": "Nowak", "email": "anna@example.com", "phone": "+48600100200" },
    "items": [
      { "sku": "KUB-001", "name": "Kubek ceramiczny", "quantity": 2, "unitPriceGross": "39.90", "vatRate": "23" }
    ],
    "shippingCost": "12.99",
    "shippingMethod": "InPost Paczkomat",
    "paymentStatus": "PAID",
    "shippingAddress": { "name": "Anna Nowak", "street": "Prosta 1", "city": "Warszawa", "postalCode": "00-001", "countryCode": "PL" }
  }'

Ustawienie stanu produktu

curl -X POST "https://app.sellmatic.online/api/v1/products/7a2e…/stock" \
  -H "Authorization: Bearer sm_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "warehouseId": "c41b…", "mode": "set", "quantity": 25, "reason": "Dostawa od hurtowni" }'