White label

Testovanie

Overíte celý reťazec v DEV: zákaznícku väzbu, odoslanie a príjem dokumentu, stav a udalosti bez duplicít.

Predpoklady

  • Zaregistrovaný alebo migrovaný participant v DEV.
  • Oddelené prístupy pre registráciu (participants:write) a čítanie (participants:read).

Zákaznícka väzba

  • Toto volanie nie je všeobecná SAPI ani Connector operácia; vyžaduje Enterprise oprávnenie a firms:manage.
  • Použite rovnaký customerRef a rovnaké testovacie identifikátory ako pri registrácii.
  • customerAuthorization.confirmed nastavte na true iba s platným poverením klienta. Ukážkový evidenceReference nahraďte odkazom na váš auditovateľný doklad o poverení.
  • Tento krok nespotrebúva verification token a nenahrádza registráciu participanta.
Vytvorenie Enterprise zákazníka
curl -X POST "https://dev.epostak.sk/api/v1/customers" \
  -H "Authorization: Bearer <API_JWT>" \
  -H "Idempotency-Key: wl-customer-demo-0001" \
  -H "Content-Type: application/json" \
  -d '{
    "customerRef": "erp-klient-42",
    "relationship": "represented",
    "country": "SK",
    "taxId": "2120000000",
    "contactEmail": "firma@example.test",
    "customerAuthorization": {
      "confirmed": true,
      "evidenceReference": "mandate-demo-0001"
    }
  }'

Koncový test dokumentov

  1. Odošlite syntetický dokument

    Overte odpoveď, stav dokumentu a uloženie na strane príjemcu.

  2. Zopakujte s rovnakým idempotency kľúčom

    Overte, že nevznikol druhý dokument.

  3. Overte udalosti alebo pull

    Pri Enterprise udalostiach najprv vytvorte odber; pre pravidelný pull použite url=null podľa kontraktu.

Očakávaný výsledok

Doklad prešiel od API po uloženie u príjemcu, opakovanie nevytvorilo duplicitu a udalosť alebo pull doručil očakávaný stav.

Keď to nefunguje

  • Druhý dokument pri opakovaní: telo alebo idempotency kľúč sa zmenil.
  • Udalosť nechodí: skontrolujte, či je odber vytvorený a či callback prešiel overením podpisu.

Pokračujte

  1. Produkcia

    Oddelí produkčnú white-label aktiváciu od DEV testov.

  2. Enterprise webhooky

    Referenčný detail Enterprise udalostí a pull režimu.

  3. Stavy dokumentov

    Zabráni zámene „prijaté API“ s „doručené a potvrdené“.

Súvisiace návody

Všetka dokumentácia