Dev prostredie ePošťáka

Testovací ePošťák pre integrátorov.

Dev host kopíruje produkčné API, ale používa oddelené účty, sandbox databázu, test SMP a test AS4. Je určený na bezpečné overenie integrácie pred produkčným schválením.

Sandbox nepotrebuje DIČ klientskych firiem. Po schválení operátor pripraví dve syntetické identity vo formáte 0245:DIČ. Pre produkčné firmy platí: DIČ je primárny identifikátor a IČO iba doplnkový údaj.

Panel integrátora Vybrať rozhranie Connector

01Úvod

Najprv si vybavíte testovací prístup.

Toto nie je produkčný onboarding. Registrácia vytvorí žiadosť pre integrátora, ktorá ide na manuálne schválenie. Po schválení operátor ePošťáka manuálne pripraví presne dve syntetické firmy, zaregistruje ich v test SMP a v paneli zobrazí stav a referenciu odovzdania.

Žiadosť o testovací prístup

Registrácia testera

Registrácia vytvorí iba sandbox žiadosť. Po overení emailu ide do manuálneho schvaľovania. Po schválení pripraví test-SMP pár operátor; samoobslužná časť pokračuje až API integráciou.

Kontrolovaný prístup

Ako sa dostať do testovania

01Overíte email integrátoraŽiadosť ide do manuálneho approval queue.02Operátor pripraví test-SMP párDve syntetické identity; bez DIČ vašich klientov.03Testujete na dev hosteEndpointy kopírujú produkciu, ale sieť je testovacia.

02Pravidlá testu

Dev účet nikdy nemieša produkčnú sieť.

Test integrátori posielajú cez test Peppol. Produkčné firmy, produkčný billing a verejný dashboard ostávajú mimo dev hostu.

Sandbox DBOddelená dev databáza a samostatné test firmy.Test AS4Test SMP, test AS4 a test Peppol participant lookup.BillingSandbox sa nikdy nefakturuje ani nepoužíva live plány.

03Jednotlivé položky

Vyberte rozhranie.

SAPI-SK je štandardný transport UBL dokladov. Enterprise API je integračný účet pre správu firiem, súhlasy, webhooky, SMP operácie a automatizáciu. Connector je zjednotený tok nad Enterprise API pre rýchle napojenie ERP systému.

SAPI-SK

Keď potrebujete iba poslať a prijať UBL cez štandardné endpointy.

8 základných endpointov pre dokumenty a stav doručenia
OAuth 2.0 a rovnaký model naprieč SAPI kompatibilitou
Najjednoduchšia voľba pre vlastný účtovný softvér

https://dev.epostak.sk/sapi/v1

Dokumentácia SAPI-SK OpenAPI SAPI-SK

Enterprise API

Keď spravujete viac firiem, potrebujete súhlasy, webhooky, preflight kontroly, SMP lookup, OCR alebo hromadné operácie.

API kľúče v paneli integrátora a auditovateľné prístupy
Správa klientskych firiem cez owner consent
Vhodné pre SaaS, účtovné domy a väčšie integrácie

https://dev.epostak.sk/api/v1

Dokumentácia Enterprise API OpenAPI Enterprise

Connector

Keď chcete napojiť ERP za jeden deň cez riadený tok nad Enterprise API.

Jeden hlavný tok pre odoslanie faktúry
Preflight, opravy, stav, inbox a dôkazy pod kapotou
Bez povinných webhookov pri štarte integrácie

https://dev.epostak.sk/api/v1/connector

Prvý Connector payload

Začnite cez customerRef. Connector flow nepotrebuje ručné X-Firm-Id hlavičky.

Najľahší štartTolerantný JSON z ERP/api/v1/connector/zen-input

Použite, keď ERP vie poslať JSON, ale nechcete ladiť presné názvy polí hneď v prvej iterácii.

{
  "customerRef": "cust-demo",
  "invoiceNo": "FA-2026-001",
  "receiver": {
    "peppolId": "0245:2020123456",
    "name": "Demo odberateľ s.r.o."
  },
  "lines": [
    {
      "name": "Služba ERP Connector",
      "qty": 1,
      "price": 100,
      "vat": 23
    }
  ],
  "send": {
    "policy": "stage_only"
  }
}

Pre exportyERP export cez Mapper/api/v1/connector/mapper

Použite, keď ERP posiela vlastný JSON export a chcete si najprv overiť mapovanie bez uloženého template-u.

{
  "sourceType": "json",
  "customerRef": "cust-demo",
  "execute": "preview",
  "sourceJson": {
    "invoiceNo": "FA-2026-001",
    "receiver": {
      "peppolId": "0245:2020123456",
      "name": "Demo odberateľ s.r.o."
    },
    "issuedOn": "2026-06-29",
    "dueOn": "2026-07-13",
    "currency": "EUR",
    "lines": [
      {
        "name": "Služba ERP Connector",
        "qty": 1,
        "price": 100,
        "vat": 23
      }
    ]
  }
}

Presná kontrolaPresný Autopilot payload/api/v1/connector/autopilot

Použite, keď ERP už vie posielať stabilný payload a chcete stage/send lifecycle bez ručného skladania X-Firm-Id flow.

{
  "customerRef": "cust-demo",
  "mode": "stage",
  "externalId": "ERP-FA-2026-001",
  "idempotencyKey": "erp-fa-2026-001",
  "send": {
    "policy": "stage_only"
  },
  "payload": {
    "invoiceNumber": "FA-2026-001",
    "receiverPeppolId": "0245:2020123456",
    "receiverName": "Demo odberateľ s.r.o.",
    "currency": "EUR",
    "issueDate": "2026-06-29",
    "dueDate": "2026-07-13",
    "items": [
      {
        "description": "Služba ERP Connector",
        "quantity": 1,
        "unitPrice": 100,
        "vatRate": 23
      }
    ]
  }
}

Prehľad Connectora Connector dokumentácia

Len UBL transportSAPI-SKIntegrator spravuje klientovEnterprise APIWebhooky alebo SMP automatizáciaEnterprise APIERP integrácia za jeden deňConnectorSDK na GitHube

04Endpointy

Adresy pre testerov.

Adresy

Endpointy pre testerov

Cesty endpointov sú rovnaké ako v produkcii, mení sa iba host. Testovacie API kľúče používajte len na dev prostredí.

Enterprise APIhttps://dev.epostak.sk/api/v1

Connectorhttps://dev.epostak.sk/api/v1/connector

SAPI-SKhttps://dev.epostak.sk/sapi/v1

AS4https://dev.epostak.sk/as4

Prístup

Čo sa stane po registrácii

Po overení emailu žiadosť čaká na schválenie administrátorom. Schválený integrátor dostane prístup do konzoly a operátor manuálne pripraví presne dve syntetické firmy v test SMP. Integrátor v paneli vidí ich stav a referenciu odovzdania, potom si sám vytvorí kľúče a pokračuje API integráciou. Produkčné firmy a ich reálne DIČ zostávajú v oddelenom procese súhlasu.

Test SMP: test.peppol-smp.skProdukcia zostáva mimo dev hostuDoklady sú iba sandbox/test