Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Arveldusteave

Õppetund 5 / 14 Värskendatud 29. juuli 2026 Arendajatele
Sellel lehel
  1. Arvelduse haldamine API kaudu
  2. Arveldusteabe pärimine
  3. Teabe uuendamine
  4. Arvete pärimine
  5. xAI arveldusloogika
  6. Praeguste tasude vaatamine
  7. Peamised punktid

Arvelduse haldamine API kaudu

Management API arveldusjaotis võimaldab sul programmeeritult hankida ja uuendada oma arveldusteavet, pärida arveid ning jälgida kulusid. Enam ei pea maksestaatuse kontrollimiseks konsooli ja tagasi hüppama.

GET
Päring
POST
Uuendamine
4
Arvete staatused
Igakuine
Arveldustsükkel

Arveldusteabe pärimine

Arveldusandmed võivad tunduda kahjutuna, kuni raamatupidamine lükkab arve tagasi vale nime või puuduva KM-numbri tõttu. Nende API kaudu kontrollimine võtab aega ühe päringu ja hoiab ära parandamatu vea: nagu allpool olev märkus selgitab, ei saa väljastatud arvet uute andmetega uuesti genereerida.

curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/billing-info" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Vastus sisaldab registreeritud arveldusandmeid: ettevõtte nimi, aadress, riik ja vajadusel KM-number.

Teabe uuendamine

Arveldusteabe muutmiseks:

curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/billing-info" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "companyName": "My Company SAS",
    "address": "15 Peace Street",
    "city": "Paris",
    "country": "FR",
    "vatNumber": "FR12345678901"
  }'

Oluline märkus olemasolevate arvete kohta

Uuendatud arveldusteave kehtib ainult tulevastele arvetele. Sa ei saa tagasiulatuvalt arvet uute andmetega uuesti genereerida. Veendu oma andmete õigsuses enne arveldustsükli lõppu, et tagada korrektsete arvete väljastamine.

Arvete pärimine

Lõpp-punkt GET /v1/billing/teams/{teamId}/invoices tagastab sinu arvete ajaloo:

# Konkreetse kuu arved
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/invoices?billingCycle.year=2026&billingCycle.month=3" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

# Arved alates kindlast kuust
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/invoices?since.year=2026&since.month=1" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Filtreerimisparameetrid

  • billingCycle.year ja billingCycle.month: päri arved konkreetse tsükli kohta
  • since.year ja since.month: päri kõik arved alates kindlast kuust

Arvete staatused

Nendest neljast staatusest nõuab vaid üks viivitamatut tegevust. FAILED tähendab, et makse ei õnnestunud – aegunud kaart, limiit ületatud, vaidlus – ja tasumata arve viib lõpuks teenuse peatamiseni. Just seda staatust pead automaatselt jälgima, nagu näidatud makseviiside õppetükis; ülejäänud kolme saad lihtsalt üle vaadata, kuid just sellele seadista häired.

  • PENDING: arvet töödeldakse; makset ei ole veel maha kantud
  • PAID: makse õnnestus
  • FAILED: makse ebaõnnestus (aegunud kaart, vahendite puudumine jne)
  • WILL_NEVER_BE_CHARGED: arvet ei hakata kunagi tasuma (krediit, korrigeerimine)

xAI arveldusloogika

Kahe režiimi koostoime mõistmine hoiab ära oma armatuurlaua valesti tõlgendamise. Esmalt kasutatakse ettemakstud krediidipunkte; igakuine arveldamine käivitub alles siis, kui saldo on ammendunud. Nullsaldo aktiivse teenuse korral ei ole anomaalia: see tähendab, et tarbid nüüd järelmaksu alusel ja kuu lõpu arve koguneb.

Ettemakstud krediidipunktid

Ostetud krediidipunktid kantakse maha kohe ostu hetkel. Iga API väljakutse tarbib krediidipunkte vastavalt töödeldud tokenite arvule. Krediidipunkte kasutatakse esimesena.

Igakuine arveldamine (järelmaks)

Kui sinu krediidipunktid on otsas või sul neid üldse pole, arveldatakse tarbimine kuu lõpus. Iga API väljakutse maksumus arvutatakse koheselt, kuid maha kandmine toimub tsükli lõpus.

Tokenite lugemise erinevused

Oota lahknevust oma kohaliku loenduse ja arveldusloenduse vahel ning parem on seda teada enne, kui kulutad pool päeva selle põhjuse otsimisele. Arveldus on autoriteetne: põhine oma kuluhinnangutel analüütika API näitajatel, mitte kunagi kliendipoolsel tokenisaatoril tehtud loendusel. See on normaalne: järelduspunktid lisavad töötlemiseks sisemisi tokeneid (süsteemijuhised, vormindamine), mis suurendab arveldatavat kogust veidi võrreldes toortekstiga.

Praeguste tasude vaatamine

Enne tsükli lõppu kogunenud tasude vaatamiseks:

curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/invoice/preview" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

See eelvaade on ainus viis teada saada praegust summat enne arve väljastamist. Kui kontrollid seda kord nädalas, muutub igakuine arveldamine hallatavaks: näed kulude kõrvalekallet kuu keskel, kui on veel aega suunata liiklus odavamale mudelile või vähendada limiiti.

Peamised punktid

  • Kasuta GET ja POST lõpp-punktil /v1/billing/teams/{teamId}/billing-info teabe pärimiseks ja muutmiseks
  • Arvetel on 4 staatust: PENDING, PAID, FAILED, WILL_NEVER_BE_CHARGED
  • Arveldusmuudatused ei kehti tagasiulatuvalt olemasolevatele arvetele
  • xAI ühendab ettemakstud krediidipunktid (esmatähtsad) ja igakuise arvelduse
  • Tasude eelvaade (invoice/preview) võimaldab kulusid ette näha