# 1. token dostępu (ważny 3600 s)
curl -X POST https://api.firma.pl/oauth/token \
  -H "Content-Type: application/json" \
  -d '{"grant_type":"client_credentials",
       "client_id":"3f9c2a7be41d8a05",
       "client_secret":"••••••••",
       "scope":"towary.read cennik.read"}'

# 2. towary z grupy, strona 1
curl "https://api.firma.pl/towary?kodGrupy=KARTONY" \
  -H "Authorization: Bearer q8ZxV3…"

# 200 OK
{ "dane": [ { "Twr_Kod": "KART-40",
             "Twr_Nazwa": "Karton 40×30×30",
             "Twr_EAN": "5901234123457" } ],
  "strona": 1, "lacznie": 1247, "stron": 25 }

curl -X POST https://api.firma.pl/dokumenty \
  -H "Authorization: Bearer q8ZxV3…" \
  -H "Content-Type: application/json" \
  -d '{
    "typ": "FS",
    "kontrahentKod": "HURT-KRK",
    "magazynSymbol": "MAG",
    "formaPlatnosci": "przelew",
    "termin": "2026-10-09",
    "pozycje": [
      { "towarKod": "KART-40", "ilosc": 120,
        "cenaJednostkowa": 3.85, "stawkaVat": 23 }
    ]
  }'

# 200 OK
{ "success": true, "id": 4521,
  "numerPelny": "FS/41/2026" }

# zlecenie paczki dokumentów
curl -X POST https://api.firma.pl/api/jobs/dokumenty \
  -H "Authorization: Bearer q8ZxV3…" \
  -H "Content-Type: application/json" \
  -d @zamowienia-z-dnia.json

# 202 Accepted
{ "jobId": "7c1e…", "dokumentow": 240 }

# stan zadania i każdej pozycji
curl https://api.firma.pl/api/jobs/7c1e… \
  -H "Authorization: Bearer q8ZxV3…"

# dwie rezerwacje odbiorcy → jedno wydanie zewnętrzne (typy docelowe: FS, PA, WZ, RW, ZD, FPF)
curl -X POST https://api.firma.pl/dokumenty/ro/przeksztalc   -H "Authorization: Bearer q8ZxV3…"   -H "Content-Type: application/json"   -d '{ "typDocelowy": "WZ", "numeryPelne": ["RO/12/2026", "RO/13/2026"] }'

# 200 OK
{ "success": true, "typDocelowy": "WZ",
  "dokumenty": [ { "id": 4533, "numerDokumentu": "WZ/88/2026", "typDokumentu": "WZ" } ] }