Firmy a prístupy
Pozvánky a súhlas
Prejdete celý životný cyklus jedného súhlasu: vytvorenie, doručenie, potvrdenie, kontrola stavu a odvolanie.
Predpoklady
- Rozhodnutý režim spolupráce a platiteľ API spotreby.
- Bezpečné miesto na uloženie id pozvánky a jednorazového consentUrl.
Čo znamenajú stavy
| Stav | Význam | Čo urobiť |
|---|---|---|
| required | Pozvánka existuje, oprávnená osoba ju ešte nepotvrdila. | Doručte odkaz a čakajte; nevytvárajte druhú pozvánku pre tú istú firmu. |
| pending | Súhlas je potvrdený, ale aktivácia ešte nie je dokončená. | Neposielajte dokumenty; čakajte na dokončenie alebo zistite stav. |
| active | Firma má prístup v zvolenom rozhraní. | Overte firemný kontext a pošlite prvý testovací doklad. |
| revoked | Súhlas bol odvolaný. | Prístup neobnovujte starým odkazom; vytvorte novú pozvánku. |
Odkaz na súhlas je tajomstvo
- consentUrl patrí oprávnenej osobe firmy, nie logom, analytike ani verejným príkladom.
- Portálové akcie pre vlastníka nie sú verejné API; externému integrátorovi neodporúčajte interné cesty.
Odvolanie súhlasu
Po odvolaní prestanú platiť nové volania tohto partnera pre túto firmu. Existujúce Peppol registrácie, iné poverenia ani už doručené doklady sa nemenia.
Očakávaný výsledok
Vidíte stav active pre správnu firmu a partnera a viete, čo presne sa zmení po odvolaní.
Keď to nefunguje
- 403 pri práci s firmou: chýba firms:manage alebo požadované documents:* oprávnenie.
- Odkaz potvrdila nesprávna osoba: súhlas sa nedá preniesť, vytvorte novú pozvánku pre firmu.