> ## Documentation Index
> Fetch the complete documentation index at: https://doc.allcomtelecom.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Invoices

> Listar as faturas das contas virtuais / Buscar os detalhes da fatura do MoT.



## OpenAPI

````yaml GET /broker/{customerId}/invoices
openapi: 3.0.1
info:
  title: OpenAPI Auth Store
  description: API de exemplo para demonstração de autenticação e obtenção de tokens.
  license:
    name: Allcom Telecom
  version: 1.0.0
servers:
  - url: >-
      https://apicorp.algartelecom.com.br/telecom/product-Inventory-management/management/v1
security: []
paths:
  /broker/{customerId}/invoices:
    get:
      description: >-
        Listar as faturas das contas virtuais / Buscar os detalhes da fatura do
        MoT.
      parameters:
        - name: Content-Type
          in: header
          required: true
          description: |-
            Define o formato da requisição.

            🔹 **Valor padrão:**
            ```
            application/json
            ```
            📌 **Dica:** Copie e cole esse valor no campo Content-Type.
          schema:
            type: string
            example: application/json
            default: application/json
        - name: client_id
          in: header
          required: true
          schema:
            type: string
            example: client_id
        - name: access_token
          in: header
          required: true
          description: Token gerado.
          schema:
            type: string
            example: access_token
        - name: customerId
          in: path
          required: true
          description: Identificador do cliente.
          schema:
            type: string
            example: '123654'
        - name: status
          in: query
          description: Status da fatura.
          schema:
            type: string
            example: status
        - name: from
          in: query
          description: Data inicial.
          schema:
            type: string
            example: YYYYmmdd
        - name: to
          in: query
          description: Data final.
          schema:
            type: string
            example: YYYYmmdd
        - name: unit
          in: query
          description: Unidade que deseja retorno, se não infomrado por default MB
          schema:
            type: string
            example: MB
            default: ' B, MB, K, GB'
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                type: object
                properties:
                  quantityInvoices:
                    type: integer
                    description: Quantidade de faturas.
                  listaFaturasVirtuais:
                    type: array
                    items:
                      type: object
                      properties:
                        invoiceId:
                          type: integer
                          description: Identificador da fatura.
                        startDate:
                          type: string
                          description: Data de início.
                        endDate:
                          type: string
                          description: Data de fim.
                        dueDate:
                          type: string
                          description: Data de vencimento.
                        totalTraffic:
                          type: integer
                          description: Tráfego total.
                        invoiceAmount:
                          type: integer
                          description: Valor da fatura.
                        terminals:
                          type: integer
                          description: Terminais.
                        useTerminals:
                          type: integer
                          description: Uso de terminais.
                        subInvoiceQuantity:
                          type: integer
                          description: Quantidade de subfaturas.
                        idStatusInvoice:
                          type: string
                          description: Identificador do status da fatura.
                        synchronized:
                          type: boolean
                          description: Se está sincronizado.
              example:
                quantityInvoices: 1
                listaFaturasVirtuais:
                  - invoiceId: 6
                    startDate: 01-09-2021
                    endDate: 30-09-2021
                    dueDate: 11-10-2021
                    totalTraffic: 0
                    invoiceAmount: 0
                    terminals: 0
                    useTerminals: 0
                    subInvoiceQuantity: 0
                    idStatusInvoice: C
                    synchronized: false
        '400':
          description: Requisição mal formada.
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: string
                    description: Erro encontrado.
              example:
                errors: Parameter not found
        '401':
          description: Requisição requer autenticação.
        '403':
          description: O acesso ao recurso foi negado.
        '404':
          description: URI de API/Recurso inexistente para processamento.
        '500':
          description: Erro Interno do servidor.
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: string
                    description: Erro encontrado.
              example:
                errors: Parameter not found

````