Connector referencia
Connector odosielanie
Z business JSON údajov vytvoríte a odošlete doklad cez Connector s väzbou na konkrétnu klientsku firmu.
Predpoklady
- Connector prístup a token z POST /api/v1/auth/token (client_credentials).
- Údaje faktúry, ktoré sa dajú naplniť do Connector JSON kontraktu.
Postup odoslania
Namapujte údaje
Dopĺňte polia podľa Connector JSON kontraktu. Mapper a Autopilot sú pomocné nástroje; runtime kontrakt zostáva POST /connector/documents.
Odošlite doklad
POST /api/v1/connector/documents s customerRef konkrétnej firmy a povinnou hlavičkou Idempotency-Key. Pre opakovanie tej istej požiadavky zachovajte rovnaký kľúč aj telo; customerRef identifikuje firmu a nenahrádza tento kľúč.
Overte stav
Sledujte udalosti alebo stav dokladu; potvrdenie prevzatia je samostatný krok príjemcu.
Mapovanie nie je odhad
- Každé pole kontraktu musí mať zdroj vo vašich dátach; nedopĺňajte hodnoty odhadom.
- Mapper pomáha s návrhom, ale runtime kontrakt kontroluje až POST /connector/documents.
- Doklady s chýbajúcou stranou alebo súčtom patria na opravu, nie na tichý fallback.
Očakávaný výsledok
Doklad je prijatý z business údajov a priradený správnej firme cez customerRef.
Keď to nefunguje
- 422: pole nezodpovedá kontraktu — najčastejšie chýbajúca strana, položka alebo súčet.
- Dokument sa objavil v nesprávnej firme: customerRef nepatrí cieľovej firme.