Prvé volanie SAPI+

Pripravte si aktivovanú testovaciu firmu, client_id, client_secret a jej Peppol Participant ID. Príklady používajú cURL.

1. Pripravte premenné

Príkazy spúšťajte v jednom termináli. Participant ID nahraďte údajom svojej sandbox firmy.

SAPI_BASE_URL='https://einvoice-v1-ynyiur6quq-ey.a.run.app/v1'
SAPI_PARTICIPANT_ID='0245:VASE_DIC'

2. Získajte access token

V tele požiadavky nahraďte VAS_CLIENT_ID a VAS_CLIENT_SECRET pridelenými prístupmi. Zachovajte platný JSON vrátane escapovania prípadných úvodzoviek alebo spätných lomítok v hodnotách.

curl --request POST --fail-with-body --silent --show-error \
  "$SAPI_BASE_URL/sapi/auth/token" \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --data-raw '{
    "client_id": "VAS_CLIENT_ID",
    "client_secret": "VAS_CLIENT_SECRET",
    "grant_type": "client_credentials",
    "scope": "document:send document:receive"
  }'

Z úspešnej JSON odpovede skopírujte hodnotu access_token a nastavte ju pre ďalšie volania:

SAPI_ACCESS_TOKEN='ACCESS_TOKEN_Z_ODPOVEDE'

Pokračujte iba po úspešnej odpovedi s neprázdnym access_token. Pri 400, 401, 403 alebo 423 opravte vstup alebo prístup podľa návodu Autentifikácia. Príklady spúšťajte v súkromnom testovacom prostredí; prístupy ani odpoveď s tokenmi nezdieľajte a nezapisujte do logov.

3. Načítajte prijaté dokumenty

curl --fail-with-body --silent --show-error --get \
  "$SAPI_BASE_URL/sapi/document/receive" \
  --header "Authorization: Bearer $SAPI_ACCESS_TOKEN" \
  --header "X-Peppol-Participant-Id: $SAPI_PARTICIPANT_ID" \
  --header 'Accept: application/json' \
  --data-urlencode 'limit=20'

Hlavička X-Peppol-Participant-Id určuje firmu, ktorej dokumenty čítate. Použite identifikátor firmy, ku ktorej majú vaše prístupy oprávnenie. Hodnota nemá byť automaticky Participant ID protistrany z poslednej odoslanej faktúry.

Príklad nepoužíva filter stavu. Ak chcete iba nepotvrdené dokumenty, pridajte --data-urlencode 'status=RECEIVED'. Predvolený výber bez tohto filtra nepovažujte automaticky za výber iba nepotvrdených dokumentov.

4. Spracujte odpoveď

documents obsahuje metadáta dokumentov. Ak je zoznam prázdny, firma nemusí mať dostupné prijaté eFaktúry.

Ak dostanete nextPageToken, odovzdajte ho bez úprav v query parametri pageToken ďalšej požiadavky. Pre každý dokument stiahnite detail a XML, uložte alebo spracujte ho a až potom zavolajte acknowledge podľa návodu Prijímanie eFaktúr.