---
title: "Relatório de faturamento"
method: GET
path: "/v2/partner/billing/report"
tags: ["Parceiros"]
---

# Relatório de faturamento

`GET /v2/partner/billing/report`

Para autenticar nos endpoints de Parceiros, utilize o Token de Parceiro.<br />O token pode ser gerado na plataforma em `Admin > Personalizar > Integração`.<br />Envie-o no header `Authorization` com o schema `Bearer`.<br />Este token é exclusivo para os endpoints de Gestão de Contas e Parceiros.
<br /><br />Retorna o relatório de faturamento do parceiro. As datas são tratadas apenas como data (dia/mês/ano), ignorando horário. Se a data inicial não for fornecida, considera o primeiro dia do mês atual. A data final é calculada automaticamente como o último dia do mês após a data inicial e retornada no campo EndBillingAt.

## Query parameters

- `startDate` string, date-time
- `companyId` string, uuid

## Response `200`

Success

- PublicPartnerBillingV2DTO — DTO representando dados de relatório de billing de parceiros
  - `partnerName` string, nullable
  - `period` string, nullable — Período no formato YYYY-MM
  - `accounts` PublicPartnerCompanyBillingV2DTO[], nullable — Período no formato YYYY-MM
    - `companyId` string, uuid — Código da empresa
    - `company` string, nullable — Nome da empresa
    - `startBillingAt` string, date-time, nullable — Data de início do billing
    - `endBillingAt` string, date-time, nullable — Data de fim do billing
    - `agentsCount` integer — Quantidade total de agentes
    - `agentsFirst` integer — Agentes primeira faixa
    - `agentsSecond` integer — Agentes segunda faixa
    - `agentsThird` integer — Agentes terceira faixa
    - `channelsCount` integer — Quantidade total de canais
    - `channelsFirst` integer — Canais primeira faixa
    - `channelsSecond` integer — Canais segunda faixa
    - `transcription` number, double — Valor da transcrição
    - `asaas` number, double — Valor do Asaas
    - `iaAgent` number, double — Custo do agente de IA
    - `totalPrice` number, double — Valor total
    - `infra` PublicPartnerInfraReportV2DTO
      - `sessions` integer
      - `mau` number, double
      - `mauOverBalance1` number, double
      - `mauOverBalance2` number, double
      - `cost` number, double
    - `qrInstances` PublicPartnerInstanceReportV2DTO[], nullable
      - `instanceId` string, nullable
      - `number` string, nullable
      - `startBillingAt` string, date-time
      - `endBillingAt` string, date-time, nullable
      - `days` integer
      - `cost` number, double
  - `qrInstanceTotalCost` number, double
  - `customDomain` number, double
  - `infraTotalCost` number, double
  - `companyTotalPrice` number, double
  - `appPrice` number, double
  - `volumeDiscountPrice` number, double
  - `totalPrice` number, double

## Other responses

- `500` — Server Error

---

[API](https://skmtc.dev/helena/apis/core.md) · [All operations](https://skmtc.dev/helena/apis/core/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/helena/core/revisions/811b2cdd2ec2/schema)