Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Faisnéis Fhactúraithe

Ceacht 5 as 14 Nuashonraithe 29 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Bainistigh an fhactúrú tríd an API
  2. Faigh faisnéis fhactúraithe
  3. Nuashonraigh an fhaisnéis
  4. Faigh faisnéisí
  5. Loighic fhactúraithe xAI
  6. Féach ar mhuirir reatha
  7. Príomhphointí

Bainistigh an fhactúrú tríd an API

Ligeann an roinn Factúraithe den API Bainistíochta duit do chuid faisnéise factúraithe a fháil agus a nuashonrú, faisnéisí a tharraingt siar, agus caiteachas a mhonatóiriú—go hiomlán trí chód. Ní gá duit a thuilleadh léim ar ais is ar aghaidh chuig an gconsól chun stádas na híocaíochta a sheiceáil.

GET
Faigh
POST
Nuashonraigh
4
Stádas na bhfaisnéisí
Míosúil
Timthriall factúraithe

Faigh faisnéis fhactúraithe

Is cosúil go bhfuil sonraí factúraithe neamhchiontach go dtí go ndiúltaíonn an chuntasaíocht faisnéis mar gheall ar ainm mícheart nó uimhir CBL in easnamh. Tógann sé aon iarratas amháin iad a fhíorú tríd an API agus cosnaíonn sé tú ó earráid nach féidir a shocrú: mar a mhíníonn an nóta thíos, ní féidir leat faisnéis eisithe a athghiniúint le sonraí nua.

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

Tá na sonraí factúraithe cláraithe sa fhreagra: ainm na cuideachta, seoladh, tír, agus uimhir CBL más infheidhme.

Nuashonraigh an fhaisnéis

Chun do chuid faisnéise factúraithe a mhodhnú:

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"
  }'

Nóta tábhachtach maidir le faisnéisí atá ann cheana

Ní bhaineann faisnéis fhactúraithe nuashonraithe ach le faisnéisí amach anseo. Ní féidir leat faisnéis a athghiniúint go cúlghabhálach le sonraí nua. Fíoraigh do chuid faisnéise sula gcríochnaíonn an timthriall factúraithe chun faisnéisí cruinne a chinntiú.

Faigh faisnéisí

Tugann an críochphointe GET /v1/billing/teams/{teamId}/invoices do stair fhaisnéisí ar ais:

# Faisnéisí do mhí ar leith
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/invoices?billingCycle.year=2026&billingCycle.month=3" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

# Faisnéisí ó mhí ar leith i leith
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/invoices?since.year=2026&since.month=1" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Paraiméadair scagtha

  • billingCycle.year agus billingCycle.month: faigh faisnéisí do thimthriall ar leith
  • since.year agus since.month: faigh gach faisnéis ó mhí ar leith i leith

Stádas na bhfaisnéisí

As na ceithre stádas seo, níl ach ceann amháin a éilíonn gníomh láithreach. Ciallaíonn FAILED nár éirigh leis an muirearú—cárta in éag, teorainn bainte amach, díospóid—agus luíonn faisnéis gan íoc go deireadh thiar ar chur ar fionraí seirbhíse. Is é seo an stádas a chaithfidh tú a mhonatóiriú go huathoibríoch, mar a thaispeántar sa cheacht modhanna íocaíochta; déanann tú athbhreithniú ar an trí cinn eile, ach cuirfidh tú aláram ar an gceann seo.

  • PENDING: tá an fhaisnéis á próiseáil; níor gearradh an íocaíocht fós
  • PAID: d’éirigh leis an íocaíocht
  • FAILED: theip ar an muirearú (cárta in éag, cistí neamhleora, srl.)
  • WILL_NEVER_BE_CHARGED: ní ghearrfar an fhaisnéis riamh (creidmheas, coigeartú)

Loighic fhactúraithe xAI

Cuireann tuiscint ar conas a idirghníomhaíonn an dá mhód míthuiscintí ar do dheasc rialaithe. Úsáidtear creidmheasanna réamhíoctha ar dtús; ní thosaíonn an bhilleáil mhíosúil ach nuair a bheidh an t-iarmhéid ídithe. Ní héagsúlacht é iarmhéid nialasach le seirbhís ghníomhach: ciallaíonn sé go bhfuil tú ag tomhaltas anois ar bhonn iar-íoctha, agus tá an fhaisnéis deireadh míosa ag carnadh.

Creidmheasanna réamhíoctha

Gearrtar creidmheasanna ceannaithe láithreach tráth an cheannaigh. Caitheann gach glaonna API creidmheasanna bunaithe ar líon na dtócan a próiseáladh. Úsáidtear creidmheasanna ar dtús.

Billeáil mhíosúil (iar-íoctha)

Má tá do chuid creidmheasanna ídithe nó mura bhfuil aon cheann agat, déantar an tomhaltas a bhilliú ag deireadh na míosa. Ríomhtar costas gach glaonna API láithreach, ach tarlaíonn an muirearú ag deireadh an timthrialla.

Difríochtaí i gcomhaireamh tócan

Bí ag súil le héagsúlacht idir do chomhaireamh áitiúil agus an comhaireamh factúraithe, agus is fearr é a bheith ar eolas agat sula gcaitheann tú leath lá á lorg. Is í an bhilleáil an t-údarás: bunaithe do mheastacháin chostais ar fhigiúirí an API anailíse, riamh ar chomhaireamh a rinneadh le tokenizeoir taobh an chliaint. Is gnách é seo: cuireann críochphointí tátail tócan inmheánacha leis le haghaidh próiseála (treoracha córais, formáidiú), rud a mhéadaíonn beagán an comhaireamh billithe i gcomparáid leis an téacs amh.

Féach ar mhuirir reatha

Chun muirir charntha a fheiceáil sula gcríochnaíonn an timthriall:

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

Is é an réamhamharc seo an t-aon bhealach chun an méid reatha a bheith ar eolas agat sula n-eisítear an fhaisnéis. Má sheiceáiltear é uair sa tseachtain, déanann sé billeáil mhíosúil ina rud inbhainistithe: feiceann tú claonadh costais i lár na míosa, nuair atá am fós ann chun tráchta a atreorú chuig samhail níos saoire nó teorainn a ísliú.

Príomhphointí

  • GET agus POST ar /v1/billing/teams/{teamId}/billing-info chun faisnéis a fháil agus a mhodhnú
  • Tá 4 stádas ag faisnéisí: PENDING, PAID, FAILED, WILL_NEVER_BE_CHARGED
  • Níl athruithe billithe cúlghabhálach ar fhaisnéisí atá ann cheana
  • Comhcheanglaíonn xAI creidmheasanna réamhíoctha (tosaíocht) agus billeáil mhíosúil
  • Ligeann an réamhamharc muirear (invoice/preview) duit costais a réamh-mheas