Vodiči

Stanje (kredit)

Stanje, povijest kretanja i porezne račune čitate preko API-ja i MCP-a. Plaćanje karticom - jednokratno i automatsko - uvijek ide preko poveznice na Stripe Checkout koju dovršava čovjek; API sam nikad ne tereti karticu. Isto vrijedi za neobvezni mjesečni paket.

Novac bez PDV-a, haléři, jezik opisa

Svi iznosi u ovom API-ju su cijeli brojevi u HALÉŘIMA i bez PDV-a - volai je obveznik PDV-a, ali se PDV obračunava tek pri dopuni stanja karticom (pregled na /cenik). Opise kretanja (GET /v1/credit/ledger) API slaže na engleskom iz vrste kretanja - spremljena češka napomena ne izlazi van nikad, ni u drugom polju.

Stanje, trajanje i upozorenja

GET /v1/balance vraća trenutačno stanje plus dva dodatna izračuna ADITIVNO (postojeći klijenti koji čitaju samo balanceHal/balanceCzk/currency ne pucaju): runway (dailyAverageHal - prosječna dnevna potrošnja u posljednje vrijeme, runwayDays - koliko dana stanje traje ovim tempom, null kad se ne može izračunati) i notice - isto upozorenje koje vidite na /prehled u portalu, null kad nema nijednog. Osam mogućih oblika notice: {kind:"unknown"} (premalo podataka za procjenu), {kind:"empty"} (nulto stanje), {kind:"number_fee",feeHal,dueAt} (u roku od 3 dana dospijeva mjesečna naknada za glasovne ili mobilne brojeve, a stanje na nju ne dostaje; feeHal je zbroj svih takvih naknada, dueAt najraniji rok dospijeća; kad je uključena automatska dopuna, ne vraća se), {kind:"runway",days} (stanje će se potrošiti za days dana pri trenutačnom tempu) i četiri oblika samo za račun s mjesečnim paketom: {kind:"subscription_exhausted_topup",renewsAt} (mjesečno stanje ovog razdoblja je iskorišteno, a paket radi u načinu dokupljivanja, daljnja potrošnja ide iz dopunjenog stanja; renewsAt je kraj razdoblja u ms, kad se pripisuje novo mjesečno stanje), {kind:"subscription_cap_reached",renewsAt} (mjesečno stanje je iskorišteno, paket radi sa stropom i dopunjeno stanje ništa ne pokriva, plaćene radnje stoje do renewsAt ili do ručne dopune) i {kind:"subscription_past_due"} (obnova paketa nije prošla, spremljenu karticu nije bilo moguće teretiti; obnovu platite u portalu ili zamijenite karticu) te {kind:"subscription_runway",renewsAt,runsOutAt} (stanje će se potrošiti prije nego se u renewsAt pripiše novo mjesečno stanje; runsOutAt je procjena u ms kad će se potrošiti, iz opreznog tempa paketa, istog kao prognoza mjesečnog stanja na kartici paketa u portalu: najviše od prosjeka za 28 dana (samo uz potpunu povijest stanja), prosjeka prometa u posljednjih 7 pražkih dana bez naknada za brojeve i prosjeka od početka razdoblja (tek nakon njegova prvog tjedna); runway i dalje računa s prosjekom za 28 dana; pretplatniku se vraća umjesto runway, a kad je uključena automatska dopuna, ne vraća se). renewsAt je u ms (epoch), dakle isti trenutak kao subscription.periodEnd u istom odgovoru, gdje je ISO 8601 niz; format nijednog polja se ne mijenja. Kod paketa otkazanog na kraju razdoblja subscription_exhausted_topup, subscription_cap_reached i subscription_runway nose dodatno cancelAtPeriodEnd: true: obnova neće stići, renewsAt je kraj paketa i novo mjesečno stanje se neće pripisati (kod stropa se tada može nastaviti samo dopunom); bez otkazivanja polja u upozorenju nema. Kod računa s mjesečnim paketom odgovor nosi dodatno subscription (stanje paketa, inače null) i topupBalanceHal (samo dopunjeno stanje); balanceHal ostaje zbroj mjesečnog i dopunjenog stanja, vidi poglavlje Mjesečni paket.

Povijest kretanja

GET /v1/credit/ledger?limit - najnovija kretanja prva, BEZ kursora (samo limit, 1-200, zadano 50) - starija kretanja od najnovijih 200 preko API-ja ne dosežete, cijelu povijest ima portal /kredit i porezni računi. Svaki zapis nosi type (bonus, topup, call_out, call_in, sms, number_fee, agent, refund, admin, setup_revision - krug izmjena narudžbe Ključ u ruke povrh paketa, subscription_grant - pripis mjesečnog stanja iz paketa i subscription_expire - istek njegova neiskorištenog ostatka), amountHal (pozitivno pribrajanje, negativno oduzimanje), grossHal (iznos s PDV-om kod dopune karticom, inače null) i engleski description složen iz vrste - kod number_fee dodatno s brojem na koji se naknada odnosi. Kod potrošnje pokrivene mjesečnim stanjem postoji i polje fromSubscriptionHal - dio potrošnje koji je pokrilo mjesečno stanje; kod ostalih kretanja ga nema. Dodatak „mobilni broj“ u povijesti se prikazuje kao number_fee (prvo razdoblje pri kupnji i svaka obnova nakon 30 dana) i sms (slanje s mobilnog broja, cijena po segmentu je u cjeniku); kad operater naknadno odbije SMS s mobilnog broja, stanje se vraća zapisom refund.

Dopuna karticom

POST /v1/credit/topup {amountCzk} vraća {checkoutUrl} - poveznicu na Stripe Checkout koju otvara ČOVJEK u pregledniku. Ništa se ne tereti dok plaćanje sam ne dovrši. Adresa za naplatu (PUT /v1/account/billing) mora biti potpuna PRIJE poziva - bez nje nije moguće izdati valjan porezni račun (billing_address_required). Podržava Idempotency-Key - sigurno je ponoviti nakon isteka vremena, a da ne nastanu dvije uplate.

Automatska dopuna

Preko API-ja automatsku dopunu možete samo ČITATI, ISKLJUČITI i promijeniti PRAG - uključivanje i promjena IZNOSA ide isključivo preko Stripe Checkouta, nikad izravnim upisom.

Čitanje i isključivanje

GET /v1/credit/auto-topup vraća {enabled, thresholdHal, amountHal, card: {brand, last4} | null, spentThisMonthHal, monthlyCapHal, disabledReason} - BEZ broja kartice, samo marka i posljednje četiri znamenke. PATCH {enabled: false} isključuje odmah, PATCH {thresholdHal} mijenja samo prag (mora biti iz ponuđenog niza i niži od spremljenog iznosa, inače bi nakon dopune stanje odmah ponovno palo ispod praga).

Uključivanje i promjena iznosa

POST /v1/credit/auto-topup/setup {thresholdHal, amountHal} vraća {checkoutUrl} - nakon dovršetka Checkouta ODMAH se tereti amountHal kao prva dopuna i tek time se sprema kartica za buduće automatske dopune. Radi i s karticom već spremljenom od prije - to je jedini put da se automatska dopuna uključi ili joj se promijeni iznos. Nakon dovršetka Checkouta preglednik se vraća na ČESKU stranicu portala (/kredit?automat=zapnuto) i klijentu koji govori engleski - poznata praznina, nije greška vaše integracije.

Kartica

POST /v1/credit/auto-topup/card vraća poveznicu na Checkout (način zamjene kartice, ništa se ne tereti) za zamjenu spremljene kartice. DELETE /v1/credit/auto-topup/card odvaja karticu ODMAH - briše se cijela konfiguracija (prag i iznos), ne samo kartica; sljedeće uključivanje ide samo ponovno preko .../setup, koji odmah tereti prvu dopunu. Nakon dovršetka Checkouta preglednik se vraća na ČESKU stranicu portala (/kredit?karta=zmenena) bez obzira na jezik računa - ista poznata praznina kao gore.

Gornje granice

Dvije NEOVISNE gornje granice: najviše 10 000 CZK pripisanog stanja po kalendarskom mjesecu i najviše 4 dopune po KALENDARSKOM DANU - bez obzira na to koliko puta prag padne ispod granice. Prekoračenje bilo koje automatska dopuna sama isključuje (disabledReason monthly_cap, odnosno daily_cap); spentThisMonthHal/monthlyCapHal u odgovoru pokazuju koliko je od mjesečne granice ostalo.

MCP: get_auto_topup (čitanje) i disable_auto_topup (isključivanje) - uključivanja, promjene iznosa ni kartice u MCP-u nema, iz istog razloga kao enabled: true u RESTu gore.

Mjesečni strop potrošnje

Neobvezno osiguranje od neočekivano visokog računa: sami određujete koliko smiju koštati pozivi, SMS i glasovni agent u kalendarskom mjesecu (prema vremenu u Pragu). Funkcija je uključena samo kod računa koji je postavio strop; bez njega se ništa ne mijenja, a potrošnja mjeseca se samo broji.

GET /v1/account/spend-cap vraća {spendCap: {enabled, capHal, warnShare, inboundAboveCap, month, monthSpendHal, remainingHal, reached, updatedAt}}. Bez stropa je enabled: false, a polja stropa su null, ali monthSpendHal dobivate uvijek. Iznosi su u cijelim haléřima bez PDV-a.

PUT /v1/account/spend-cap {capHal, warnShare?, inboundAboveCap?} postavlja ili mijenja strop: capHal je u cijelim haléřima od 5 000 (50 CZK) do 100 000 000 (1 000 000 CZK), warnShare je udio stropa od 0,5 do 0,99 (zadano 0,8) pri kojem stiže upozoravajuća e-poruka, a inboundAboveCap: true dopušta agentima da i dalje primaju dolazne pozive i iznad stropa (zadano false, pri promjeni bez polja vrijedi spremljena vrijednost). DELETE /v1/account/spend-cap strop ukida; ukidanje nepostojećeg stropa je u redu.

Nakon dosezanja stropa novi odlazni pozivi, prozvanjanja, probni pozivi i SMS odbijaju se kodom spend_cap_reached (HTTP 402), ništa se ne naplaćuje, a ponavljanje ne pomaže dok mjesec ne završi ili strop ne povisite ili ne ukinete. Dolazni poziv agenta nakon jedne rečenice završava i ništa ne košta, osim ako nije inboundAboveCap: true. E-poruka stiže pri dosezanju warnShare i pri dosezanju stropa, uvijek najviše jednom mjesečno.

Što strop NE zaustavlja: pozive koji upravo traju (cijena se tereti tek nakon poziva, pa mjesec može završiti za njihovu cijenu iznad stropa, jednako kao kod poziva knjiženih nakon ponoći), preusmjeravanje bez agenta te naknade za brojeve, krug izmjena Ključ u ruke i mjesečni paket, koji se u strop ne računaju. Kod računa s paketom u potrošnju se računa i ono što je pokrilo mjesečno stanje. Broj u Vlastitoj SIP centrali s inboundAboveCap: true ostaje u SIP proxyju, pa strop ne zaustavlja odlazne pozive iz centrale.

MCP: get_spend_cap, set_spend_cap i clear_spend_cap pozivaju istu uslugu kao REST i portal (odjeljak Mjesečni strop potrošnje u Stanju). set_spend_cap treba klijentu ponoviti iznos prije upisa i nakon njega.

Mjesečni paket

Neobvezna pretplata: svakog mjeseca sa spremljene kartice naplaćuje se cijena odabranog stupnja i pripisuje se mjesečno stanje u CZK, koje se troši po uobičajenom cjeniku. Tarife i naplata po sekundama time se ne mijenjaju, paket je sloj povrh njih. Stupnjeva su tri, a tier je njihova cijena u CZK bez PDV-a: "490", "990" i "1990"; cijene i stanje svakog stupnja vraća GET /v1/subscription u polju tiers.

Dvije vrste stanja

Mjesečno stanje potječe iz paketa, na kraju razdoblja istječe i nije povratno. Dopunjeno stanje (dopuna, dobrodošli bonus, korekcija) ne istječe i povratno je kao i dosad. Stanje računa - balanceHal u GET /v1/balance, u portalu i u svim provjerama (minimum za poziv, granica duga, upozorenja) - je zbroj obiju vrsta. Samo dopunjeno stanje je u topupBalanceHal, preostalo mjesečno stanje u subscription.monthlyRemainingHal. Dug može nastati samo u dopunjenom stanju.

Redoslijed potrošnje

Svaka potrošnja ide najprije iz mjesečnog stanja, a ostatak iz dopunjenog - pozivi po sekundama, agent, naknade za brojeve i mobilne brojeve, SMS, prozvanjanja i odlazni zadaci. Podjela je atomska i zapisana u knjizi: potrošnja pokrivena mjesečnim stanjem nosi fromSubscriptionHal (dio koji je pokrilo mjesečno stanje). Korekcije vlasnika (admin, i negativne) i povrat za neposlani SMS (refund) odnose se samo na dopunjeno stanje.

Razdoblje i pripis

Razdoblje traje jedan mjesec od uspješnog terećenja (31. 1. daje 28. 2.). Mjesečno stanje pripisuje se tek nakon potvrđene uplate zapisom subscription_grant, a pripis je idempotentan prema ID-u uplate. Ako račun u tom trenutku ima dug u dopunjenom stanju, najprije se podmiruje iz novog mjesečnog stanja, da dopunjeno stanje ne ostane negativno.

Istek

Neiskorišteni ostatak mjesečnog stanja istječe na dan obnove (zapis subscription_expire s negativnim iznosom), pri završetku pretplate ili automatskim osiguračem kad je razdoblje završilo prije više od 36 sati bez obnove. Ako terećenje ne prođe, ostatak je već istekao i novo se stanje ne pripisuje; do plaćanja račun radi samo na dopunjenom stanju.

Izbor nakon iskorištenja

Pri uključivanju obvezno se bira exhaustionMode, bez zadane vrijednosti. topup: nakon iskorištenja mjesečnog stanja dokupljuje se dopunjeno stanje sa spremljene kartice - to je današnja automatska dopuna s istim ograničenjima i e-porukama. cap (strop): ništa se ne dokupljuje, odlazni pozivi, SMS i kupnje brojeva odbijaju se pogreškom subscription_cap_reached (HTTP 402), a pri stanju ispod nule zaustavljaju se i dolazni pozivi, preusmjeravanje i SIP pristup (zaustavljanje na nuli, obnavlja se nakon dopune ili s novim mjesečnim stanjem). Sa stropom nije moguće uključiti automatsku dopunu (subscription_cap_active); prelazak na strop nju isključuje. Najviše što ćete mjesečno sa stropom platiti je cijena paketa.

Promjena stupnja, otkazivanje, obnova

Promjena stupnja (prema gore i prema dolje) vrijedi od sljedećeg razdoblja, bez obračuna razlike. Otkazivanje je cancelAtPeriodEnd: true: stanje vrijedi do kraja razdoblja, zatim istječe, a status je canceled; do kraja razdoblja otkazivanje se može povući. Preko RESTa ni MCP-a nije moguće povisiti stupanj, obnoviti otkazani paket ni prijeći na dokupljivanje s kartice - ti koraci povećavaju ili ponovno uključuju ponavljana terećenja, pa vraćaju subscription_confirmation_required s confirmUrl, koji čovjek otvara i potvrđuje u portalu (vrijedi 24 sata).

Savjet prije obnove

Tri dana prije obnove (najkasnije dan ranije) stiže e-poruka, ali samo ako bi vam uz dosadašnju potrošnju bilo jeftinije plaćati po sekundama ili niži stupanj. Vrijedi isto pravilo kao savjet u e-poruci o obnovi i u portalu: drugi put mora ispasti barem 50 CZK i 5 % jeftiniji. Procjena za cijelo razdoblje uzima viši od tempa od početka razdoblja i u posljednjih 7 dana i nikad nije niža od potrošnje u posljednjih 30 dana, prema kojoj savjetuje portal; retci Stupanj i Otkazivanje stoga nakon klika neće reći da stupanj odgovara. E-poruka navodi točan datum i vrijeme obnove i stiže najviše jednom po razdoblju, nikad kod paketa otkazanog na kraju razdoblja, s planiranom promjenom stupnja, bez spremljene kartice ni dok se čeka uplata. Gumb u njoj u portalu otvara izravno redak Otkazivanje (/kredit?pausal=zrusit) ili Stupanj (/kredit?pausal=stupen). E-poruka o obnovi zatim ponovno savjetuje iz stvarne potrošnje cijelog razdoblja, pa savjet može ispasti i drukčije.

Neplaćena obnova

Terećenje sa spremljene kartice pokušava se na dan obnove, nakon 2 i nakon 4 dana. Nakon prvog neuspjeha status je past_due, stiže e-poruka s poveznicom na ručno plaćanje i zamjenu kartice, a mjesečno stanje je 0; ručno plaćanje vraća POST /v1/subscription/pay. Nakon trećeg neuspjeha paket završava (canceled), a dopunjeno stanje i račun rade dalje.

PDV i računi

Cijene su bez PDV-a. Način obračuna PDV-a čita se prije svakog terećenja, pa obveznik iz druge države EU s potvrđenim DIČ plaća bez češkog PDV-a (reverse charge), a račun to odražava. Porezni račun za svako plaćeno razdoblje izdaje sam volai (porezna osnovica je cijena stupnja, a ne pripisano stanje) i nalazite ga u GET /v1/billing/documents.

Odnos prema bonusu i prvoj dopuni

Uključivanje paketa računa se kao prva uplata: otključava SMS sa zajedničkog pošiljatelja, preusmjeravanje, drugi broj, dodatak „mobilni broj“ i karticu automatske dopune jednako kao dopuna. Dobrodošli bonus ostaje dopunjeno stanje.

Povratnost

Mjesečno stanje nije povratno i istječe; dopunjeno stanje je povratno kao i dosad. Otkazivanje paketa ne daje pravo na razmjerni dio plaćenog razdoblja. Povrat uplate za paket (reklamacija, pogreška) rješava vlasnik volai ručno, preko API-ja ni MCP-a nije moguć.

Paket u RESTu i MCP-u

Novac se kreće samo uz čovjeka uz karticu. Uključivanje paketa i ručno plaćanje vraćaju samo poveznicu na Stripe Checkout i nikad izravno ne terete karticu; povišenje stupnja, obnova paketa postavljenog na kraj razdoblja i prelazak na dokupljivanje s kartice zahtijevaju potvrdu prijavljenog čovjeka u portalu.

• GET /v1/subscription - status paketa (subscription ili null), katalog stupnjeva tiers (id, priceHal, creditHal), topupBalanceHal, available (može se uključiti novi paket: ponuda je uključena i nijedan paket ne radi), recommendation (najjeftiniji put za potrošnju u posljednjih 30 dana i steady, traje li potrošnja, a ne samo jednokratni vrh; null bez ponude ili bez 30 dana povijesti) i previousPeriod (prošlo razdoblje s istim brojevima kao e-poruka o obnovi: usedHal od creditHal, usedPercent, potrošnja iznad mjesečnog stanja overHal i istekli ostatak expiredHal; samo kod aktivnog paketa, null u prvom razdoblju i kad se potrošnja ne može dokazati iz povijesti).
• POST /v1/subscription/checkout {tier, exhaustionMode, consumerConsent?} - vraća {checkoutUrl} na Stripe Checkout, nakon čijeg dovršetka paket počinje. exhaustionMode (topup ili cap) je obvezan; potrošač bez IČO mora poslati consumerConsent: true (inače consumer_consent_required). Adresa za naplatu mora biti potpuna (billing_address_required). Podržava Idempotency-Key.
• PATCH /v1/subscription {tier?, cancelAtPeriodEnd?, exhaustionMode?} - snižavanje stupnja, otkazivanje (cancelAtPeriodEnd: true) i prelazak na strop (exhaustionMode: "cap") izvršava i vraća {subscription}. Povišenje stupnja, obnova paketa postavljenog na kraj razdoblja (cancelAtPeriodEnd: false) i exhaustionMode: "topup" ništa ne mijenjaju i vraćaju 409 subscription_confirmation_required s confirmUrl.
• POST /v1/subscription/pay - samo u stanju past_due; vraća {checkoutUrl} za ručno plaćanje obnove. Podržava Idempotency-Key.
• POST /v1/subscription/card - vraća {checkoutUrl} za zamjenu spremljene kartice paketa, ništa se ne tereti. Podržava Idempotency-Key.
• GET /v1/balance nosi dodatno subscription (isti oblik kao gore, inače null) i topupBalanceHal.

MCP: get_subscription (čitanje), create_subscription_link (poveznica za uključivanje), update_subscription i cancel_subscription (snižavanje stupnja, otkazivanje, strop; povišenje, obnova i dokupljivanje vraćaju confirmUrl s rečenicom da to mora potvrditi čovjek u portalu) i create_subscription_payment_link (ručno plaćanje). Zamjene kartice u MCP-u nema, iz istog razloga kao kod automatske dopune: odavde se ništa ne tereti.

Porezni računi

Račun nastaje automatski pri dopuni stanja karticom (jednokratnoj i automatskoj), pri plaćanju uvođenja Ključ u ruke i kao ispravni račun pri povratu uvođenja - bez ručnog koraka, bez izdavanja preko API-ja.

GET /v1/billing/documents?limit&before - najnoviji prvi, kursor before (Unix ms, isključiv) je nextBefore s prethodne stranice. Pohrana sama nikad ne vraća više od 100 zapisa po pozivu, čak i ako limit traži više.

GET /v1/billing/documents/{id} vraća {id, number, issuedAt, taxableAt, netHal, vatHal, grossHal, vatRatePercent, reverseCharge, description, customer, paymentRef, pdfUrl} - reverseCharge: true kod obveznika iz druge države EU s potvrđenim DIČ (VIES) koji plaćaju bez češkog PDV-a. Polje kind je uvijek popunjeno - "invoice" kod običnog računa (i kod računa izdanih prije uvođenja polja), "credit_note" kod ispravnog poreznog računa - on nastaje automatski kad vlasnik vrati cijenu uvođenja kod otkazane narudžbe Ključ u ruke, numerira se vlastitim nizom OD... i nosi dodatno correctsNumber (broj ispravljanog računa) i correctionReason (razlog povrata); iznosi netHal/vatHal/grossHal su i kod odobrenja POZITIVNI, predznak minus daje tek PDF.

GET /v1/billing/documents/{id}/pdf preuzima isti račun kao application/pdf - slaže se svježe pri svakom preuzimanju, ne sprema se. Tuđi ili nepostojeći id prijavljuju istu pogrešku (invoice_not_found) u oba endpointa, da se iz odgovora ne može zaključiti da tuđi račun postoji.

MCP: list_billing_documents i get_billing_document imaju isti oblik kao REST. PDF je samo REST - MCP nema binarni kanal za prijenos datoteke.

Pogreške

• ledger_unavailable - Povijest kretanja ni stanje trenutačno nije moguće pročitati - pokušajte ponovno za trenutak.
• invalid_amount - Iznos dopune, praga ili automatske uplate nije jedna od ponuđenih fiksnih vrijednosti.
• billing_address_required - Adresa za naplatu nedostaje ili je nepotpuna - dopunite je u portalu (/nastaveni) prije dopune, inače nije moguće izdati valjan račun.
• stripe_not_configured - Plaćanja su za ovo izvođenje volai isključena - ne odnosi se konkretno na vaš zahtjev.
• stripe_error - Stripe je odbio izraditi platnu sesiju - pokušajte ponovno za trenutak.
• autotopup_not_configured - Automatska dopuna još nikad nije prošla .../setup - nema što isključiti, promijeniti ni koju karticu zamijeniti.
• invoice_not_found - Računa s ovim id na računu nema (ili pripada drugom računu - odgovor je isti).
• spend_cap_reached - Mjesečni strop potrošnje koji ste postavili je dosegnut: novi odlazni pozivi i SMS se odbijaju i ništa se ne naplaćuje. Strop povisite ili ukinite preko PUT ili DELETE /v1/account/spend-cap, inače vrijedi do kraja mjeseca (do ponoći u Pragu).
• subscription_cap_reached - Strop paketa: i mjesečno i dopunjeno stanje je iskorišteno, a račun ima odabran strop. Odlazni pozivi, SMS i kupnje brojeva odbijaju se (HTTP 402) do sljedeće obnove ili do ručne dopune.
• subscription_exists - Račun već ima paket; promjena stupnja, otkazivanje i izbor nakon iskorištenja idu preko PATCH /v1/subscription.
• subscription_missing - Račun nema aktivan paket koji bi se mogao promijeniti, otkazati ili platiti ručno.
• subscription_canceled - Paket je već završio (status canceled): ne može se promijeniti, otkazati ni platiti ručno. Novi uključujete preko POST /v1/subscription/checkout.
• subscription_confirmation_required - Povišenje stupnja, obnovu paketa postavljenog na kraj razdoblja i dokupljivanje s kartice potvrđuje samo čovjek u portalu - odgovor nosi confirmUrl i ništa se nije promijenilo.
• consumer_consent_required - Potrošač bez IČO mora pri uključivanju potvrditi izričit zahtjev za početak izvršenja prije isteka roka za odustanak (consumerConsent: true).
• pausal_unavailable - Ponuda paketa je za ovaj račun trenutačno isključena.
• invalid_tier - Stupanj koji paket već ima, kad nije planiran nijedan drugi (stupanj na koji već prelazi nije pogreška i uzima se kao izvršen, pa isti PATCH /v1/subscription može se nakon ispada poslati ponovno; iznimka je povratak na današnji stupanj, koji planiranu promjenu poništava: pri ponavljanju više nema što poništiti); nepoznata vrijednost izvan "490", "990", "1990" završava kao validation.
• subscription_cap_active - Sa stropom nije moguće uključiti automatsku dopunu; najprije u portalu prebacite izbor nakon iskorištenja na topup.
• validation - Kod PATCH /v1/credit/auto-topup konkretno: pokušaj uključivanja (enabled: true) ili izravne promjene amountHal - umjesto toga koristite POST .../setup.

Potpunu tablicu pogrešaka za svaki endpoint naći ćete u odjeljku Stanje u REST API referenci.