eFakturuj / API Docs
Dashboard ↗
Všetky onboarding návody
Pre firmy aj partnerov · offboarding

Riadený odchod s 90-dňovou ochrannou lehotou

Offboarding zmrazí firmu, spustí 90-dňovú lehotu na export dát a po jej uplynutí sa obchodné dáta definitívne zmažú. Odchod môže spustiť admin firmy aj partner — zrušiť ho v rámci lehoty môže iba poskytovateľ.

Lehota
90 dní na export
Po lehote
dáta sa zmažú, náhrobok zostáva
Notifikácia
client.offboarding · client.purged

Priebeh

Od rozhodnutia po zmazanie

  1. 1

    Deň 0 — offboarding

    Firma sa zmrazí (len na čítanie, implikuje deaktiváciu) a spustí sa 90-dňová lehota.

  2. 2

    Počas lehoty — export

    Export dokladov funguje celú lehotu; offboarding sa dá kedykoľvek zrušiť (poskytovateľ).

  3. 3

    Migrácia SMP

    Prijímanie cez Peppol končí uvoľnením SMP registrácie — keď ju preberá nový poskytovateľ.

  4. 4

    Deň 90 — zmazanie

    Obchodné dáta sa definitívne zmažú; zostáva náhrobok firmy a naše účtovno-auditné záznamy.

Zrušenie offboardingu v rámci lehoty je bezstratové — hodiny sa zastavia a nič sa nemaže. Firma však zostáva deaktivovaná, kým ju poskytovateľ znova nezapne (samostatný prepínač).

Oprávnenia

Kto čo môže

AkciaAdmin firmyPartnerPlatforma
Deaktivovať firmu✔ (len vypnúť)✔✔
Reaktivovať firmu✖✔✔
Spustiť offboarding✔✔ (aj cez API)✔
Zrušiť offboarding✖✔✔
Exportovať dáta✔✔ (za klienta aj hromadne)✔

Asymetria je zámerná: firma sa vie sama vypnúť a sama odísť, ale nevie si sama vrátiť službu ani zastaviť lehotu — inak by sa napríklad pozastavenie pre neplatenie dalo obísť.

API

Spustenie, zrušenie a webhooky

Partner API vyžaduje scope invoices:write. Obe volania sú idempotentné. Pokus o reaktiváciu firmy v offboardingu vráti 409 offboarding_in_progress — najprv treba offboarding zrušiť; po zmazaní vráti každá zmena 409 company_purged.

POST /api/v1/partner/clients/{company_id}/offboard[/cancel]idempotentné
# Partner spustí offboarding klienta
curl -X POST https://api.sandbox.efakturuj.sk/api/v1/partner/clients/<COMPANY_ID>/offboard \
  -H 'X-API-Key: efk_…'

# 200 OK
{
  "data": {
    "company_id": "48ecb56f-…",
    "offboarded_at": "2026-08-30T09:00:00+00:00",
    "purge_after_days": 90
  }
}

# Zrušenie v rámci lehoty (iba partner / platforma)
curl -X POST https://api.sandbox.efakturuj.sk/api/v1/partner/clients/<COMPANY_ID>/offboard/cancel \
  -H 'X-API-Key: efk_…'
POST /api/v1/companies/{company_id}/offboard
# Firma spustí vlastný odchod (admin firmy)
POST /api/v1/companies/{company_id}/offboard

# Zrušiť vlastný offboarding firma nemôže — rovnaká asymetria ako pri
# reaktivácii: zrušenie vykoná poskytovateľ alebo podpora.

Webhooky životného cyklu

Rovnaký kanál ako client.linked / client.activated: v konzole Connect → Webhooky na vlastnej firme partnera pridajte udalosti client.offboarding (spustenie odchodu) a client.purged (dáta zmazané v deň 90).

{
  "id": "3f6c…",
  "event": "client.offboarding",        // neskôr aj "client.purged"
  "created_at": "2026-08-30T09:00:00+00:00",
  "data": {
    "organisation_id": "48ecb56f-…",
    "dic": "2020555666",
    "name": "Klient A, s. r. o.",
    "peppol_id": "0245:2020555666"
  }
}

Retencia

Čo sa v deň 90 maže — a čo zostáva

Zmaže sa definitívne

  • faktúry a ich položky, UBL originály aj PDF
  • odberatelia, platby, cash-flow
  • všetky Peppol prenosy vrátane metadát
  • API kľúče, SAPI prístupy, webhooky, exporty
  • kontaktné údaje firmy (e-mail, telefón, IBAN)

Zostáva

  • náhrobok firmy — názov, IČO/DIČ a dátumy životného cyklu (nikdy sa nemaže)
  • naše vlastné compliance záznamy (audit a billing ledger) — append-only, bez osobných údajov
  • regulačné Peppol reporty (TSR/EUSR)

Všeobecné pravidlo platformy: dlhodobo držíme iba zákonom vyžadované informácie; prevádzkové logy žijú 90 dní priebežne — bez ohľadu na offboarding.

Sieť Peppol

Migrácia SMP k novému poskytovateľovi

Centrálny SMP drží jednu registráciu na účastníka, takže nový poskytovateľ ju môže prevziať až po uvoľnení tej našej. Uvoľnenie registrácie je manuálny, operátorom potvrdený krok — prijímanie faktúr cez Peppol funguje až do tohto momentu (nie do dňa 90). Kontaktujte podporu, keď má klient nového poskytovateľa vybratého; samotné prijatie u nového poskytovateľa potom prebieha jeho vlastným onboardingom (pri návrate k nám cez VPDS — aktivácia firmy).