Премини към основното съдържание
Български— Изберете език
Меню

Информация за фактуриране

Урок 5 от 14 Обновен 29 юли 2026 г. Програмист
На тази страница
  1. Управление на фактурирането чрез API
  2. Извличане на информация за фактуриране
  3. Актуализиране на информацията
  4. Извличане на фактури
  5. Логика на фактуриране на xAI
  6. Преглед на текущите такси
  7. Ключови изводи

Управление на фактурирането чрез API

Разделът за фактуриране в Management API Ви позволява да извличате и актуализирате данните си за фактуриране, да получавате фактури и да следите разходите – всичко това програмно. Няма нужда повече да превключвате между конзолата, за да проверите статуса на плащането.

GET
Извличане
POST
Актуализиране
4
Статуси на фактури
Месечен
Фактурен цикъл

Извличане на информация за фактуриране

Детайлите за фактуриране изглеждат безобидни, докато счетоводството не отхвърли factura поради грешно име или липсващ ДДС номер. Проверката им чрез API отнема една заявка и предотвратява непоправима грешка: както е обяснено в бележката по-долу, не можете да генерирате отново издадена фактура с нови данни.

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

Отговорът съдържа регистрираните данни за фактуриране: име на компанията, адрес, държава и ДДС номер, ако е приложимо.

Актуализиране на информацията

За да промените информацията си за фактуриране:

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

Важна бележка относно съществуващите фактури

Актуализираната информация за фактуриране важи само за бъдещи фактури. Не можете ретроспективно да генерирате отново фактура с нови детайли. Проверете информацията си преди края на фактурния цикъл, за да осигурите точни фактури.

Извличане на фактури

Крайната точка GET /v1/billing/teams/{teamId}/invoices връща историята на Вашите фактури:

# Фактури за конкретен месец
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/invoices?billingCycle.year=2026&billingCycle.month=3" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

# Фактури от даден месец насам
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/invoices?since.year=2026&since.month=1" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Параметри за филтриране

  • billingCycle.year и billingCycle.month: извличане на фактури за конкретен цикъл
  • since.year и since.month: извличане на всички фактури от даден месец насам

Статуси на фактурите

От тези четири статуса само един изисква незабавно действие. FAILED означава, че таксуването не е успешно – изтекла карта, достигнат лимит, оспорване – и неплатената фактура в крайна сметка води до спиране на услугата. Това е статусът, който трябва да следите автоматично, както е показано в урока за начините на плащане; преглеждате другите три, но генерирате предупреждение само за този.

  • PENDING: фактурата се обработва; плащането все още не е таксувано
  • PAID: плащането е успешно
  • FAILED: таксуването е неуспешно (изтекла карта, недостатъчни средства и др.)
  • WILL_NEVER_BE_CHARGED: фактурата никога няма да бъде таксувана (кредит, корекция)

Логика на фактуриране на xAI

Разбирането на взаимодействието между двата режима предотвратява погрешното тълкуване на таблото Ви с данни. Предплатените кредити се използват първи; месечното фактуриране започва едва след изчерпване на баланса. Нулев баланс с активна услуга не е аномалия: това означава, че вече консумирате на пост-платена база и фактурата в края на месеца се натрупва.

Предплатени кредити

Закупените кредити се таксуват незабавно в момента на покупката. Всяко API обаждане консумира кредити въз основа на броя обработени токени. Кредитите се използват на първо място.

Месечно фактуриране (пост-платено)

Ако кредитите Ви са изчерпани или нямате такива, консумацията се фактурира в края на месеца. Цената на всяко API обаждане се изчислява незабавно, но таксуването се извършва в края на цикъла.

Разлики в броенето на токени

Очаквайте разминаване между Вашето локално броене и това за фактуриране; по-добре е да знаете това, преди да загубите половин ден в търсене на причината. Фактурирането е авторитетно: базирайте оценките си за разходи на данните от аналитичния API, никога на броене, извършено с клиентски токенизатор. Това е нормално: крайните точки за извод добавят вътрешни токени за обработка (системни инструкции, форматиране), което леко увеличава броя за фактуриране в сравнение с чистия текст.

Преглед на текущите такси

За да видите натрупаните такси преди края на цикъла:

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

Този преглед е единственият начин да разберете текущата сума преди издаването на фактурата. Проверката веднъж седмично превръща месечното фактуриране в нещо управляемо: виждате отклонението в разходите по средата на периода, когато все още има време да пренасочите трафика към по-евтин модел или да намалите лимит.

Ключови изводи

  • Използвайте GET и POST върху /v1/billing/teams/{teamId}/billing-info, за да извлечете и промените информацията
  • Фактурите имат 4 статуса: PENDING, PAID, FAILED, WILL_NEVER_BE_CHARGED
  • Промените във фактурирането не са ретроспективни за съществуващите фактури
  • xAI комбинира предплатени кредити (с приоритет) и месечно фактуриране
  • Прегледът на таксите (invoice/preview) Ви позволява да предвидите разходите