Pripojenie ďalšej firmy

White label na pripojenie firmy nepotrebujete

Jeden partnerský prístup obslúži aj viac klientskych firiem. Každá firma vám však musí samostatne povoliť prístup a vy musíte vedieť, kto platí API spotrebu.

Partnerský kľúč identifikuje vás. Sám osebe vám nedáva prístup k ľubovoľnej firme — ten vzniká až potvrdeným súhlasom.

Postup cez partnerský portál

1. 1

   Prihláste sa do správneho prostredia

   Rozlíšte DEV a produkciu ešte pred vytvorením pozvánky. Testovacia väzba v DEV neplatí v produkcii.

2. 2

   Otvorte Súhlasy klientov

   Panel „Pripojiť ďalšiu firmu“ nájdete v časti so súhlasmi. Ak ho nevidíte, partnerský prístup ešte nie je aktivovaný alebo nemá potrebné oprávnenie.

3. 3

   Zadajte presné IČO alebo DIČ

   Zhoda musí byť presná. Pri zhode samotného DIČ nevzniká vlastníctvo ani automatické práva k existujúcemu účtu.

4. 4

   Zvoľte režim a platiteľa

   Technická delegácia znamená, že firma platí svoju API spotrebu. Spravovaná služba znamená, že ju platí integrátor.

5. 5

   Zvoľte rozhranie a najmenší rozsah

   Voľba odosielania nie je pokyn na zmenu prijímajúceho poštára. Pridajte len tie oprávnenia, ktoré naozaj potrebujete.

6. 6

   Doručte odkaz a nechajte ho potvrdiť

   Odkaz doručte vlastným kanálom a nechajte ho potvrdiť vlastníkom alebo správcom firmy. Vytvorenie odkazu samo neposiela e-mail.

7. 7

   Overte súhlas aj aktiváciu

   Súhlas je len prvý krok. Pred odosielaním overte, že firma má v zvolenom rozhraní prístup a správny firemný kontext.

Postup cez verejné consent API

• Volajúci kľúč aj JWT musia mať firms:manage a všetky požadované oprávnenia; telo musí obsahovať aspoň jedno documents:* oprávnenie.
• POST nie je idempotentný. Pri timeoute alebo neistej odpovedi ho neopakujte naslepo; customerReference nie je idempotency key.
• GET /api/v1/consent-offers/{offerId} vráti stav, ale nikdy nezopakuje stratený consentUrl.
• Verejný POST nevytvára firmu, neregistruje ju do SMP, neudeľuje súhlas a neposiela e-mail.

curl -X POST "https://epostak.sk/api/v1/consent-offers" \
  -H "Authorization: Bearer <PARTNERSKY_JWT>" \
  -H "Content-Type: application/json" \
  -d '{
    "targetIdentifierType": "dic",
    "targetIdentifier": "<DIC_TESTOVACEJ_FIRMY>",
    "customerReference": "erp-klient-42",
    "integrationPath": "sapi",
    "relationshipMode": "technical_delegation",
    "scopes": ["firms:manage", "documents:send"]
  }'

{
  "id": "3f4f0b7e-0a8d-4c39-9d0f-1a2b3c4d5e6f",
  "status": "required",
  "consentUrl": "https://epostak.sk/d/consent/<JEDNORAZOVY_TOKEN>"
}