Iba odosielanie

Čo táto cesta je a čo nie je

• Firma vznikne s lokálnou identitou, zmluvnou evidenciou a API oprávnením — nevzniká používateľ, heslo ani dashboardové členstvo.
• Príjem sa nemení. Send-only vetva nevykonáva registráciu, migráciu ani odregistráciu v SMP.
• Overtoken nie je súčasťou tejto cesty; patrí k white-label onboardingu.

Postup krok za krokom

1. 1

   1. Partner vytvorí jednu onboardingovú požiadavku

   POST /api/v1/onboarding-requests so serviceMode: send_only, relationshipMode a customerRef. Vyžaduje neobmedzený partnerský kľúč, firms:manage a Idempotency-Key.

2. 2

   2. Autoritatívne podanie spustí pozvánku

   Po autentifikovanom podaní PFS dostane odkaz kontakt uvedený pri overení, nie kontakt z API požiadavky. E-mail z requestu nie je dôkaz identity.

3. 3

   3. Firma potvrdí jedno prepojenie

   Na jednej obrazovke vidí firmu, konkrétneho partnera, odosielanie, platiteľa a podmienky. Tlačidlo Potvrdiť a prepojiť zaznamená výslovný súhlas.

4. 4

   4. Partner vytvorí kľúč viazaný na firmu

   Až stav active sprístupní firmId. Potom vytvorte kľúč s scopedFirmId a oprávneniami documents:send a documents:read. Rodičovský kľúč potrebuje keys:manage aj požadované oprávnenia a vytváranie kľúčov musí byť prevádzkovo povolené. Kľúč sa nikdy nevracia v onboardingovej odpovedi.

5. 5

   5. Odošlite prvý doklad a overte stav

   Použite firemný kontext konkrétnej firmy. Prijímanie dokladov zostáva zakázané; overte stav dokumentu a dostupný dôkaz odoslania.

Príklad: technický partner, firma platí, príjem inde

curl -X POST "https://epostak.sk/api/v1/onboarding-requests" \
  -H "Authorization: Bearer <PARTNERSKY_JWT>" \
  -H "Idempotency-Key: demo-send-only-2026-09-20-0001" \
  -H "Content-Type: application/json" \
  -d '{
    "serviceMode": "send_only",
    "relationshipMode": "technical_delegation",
    "customerRef": "erp-klient-42",
    "dic": "2120000000",
    "contactEmail": "kontakt@example.test"
  }'

curl "https://epostak.sk/api/v1/onboarding-requests/<REQUEST_ID>" \
  -H "Authorization: Bearer <PARTNERSKY_JWT>"

curl -X POST "https://epostak.sk/api/v1/integrator/keys" \
  -H "Authorization: Bearer <PARTNERSKY_JWT>" \
  -H "Content-Type: application/json" \
  -d '{
    "scopedFirmId": "<FIRMID_Z_ONBOARDINGU>",
    "scopes": ["documents:send", "documents:read"]
  }'

Keď má firmu oslovených viac partnerov

• Zhoda DIČ neudeľuje súhlas. Klient výslovne vyberá konkrétneho partnera a rozsah.
• Jediná požiadavka môže byť predvybraná a viditeľná, ale predvýber nie je súhlas.
• Partner nikdy nevidí požiadavky ani stav iných partnerov.