Listar Faturas

GET

/v2/faturamento/faturas

Retorna lista paginada de faturas com filtros opcionais. Todos os parâmetros
são opcionais e combinam com lógica AND.

Exemplos de uso:

Buscar fatura específica: ?idFatura=632606

Buscar por cliente: ?idCliente=1001

Buscar por número do pedido externo: ?numeroPedido=5000

Buscar por competência: ?competencia=06/2026

Buscar por período de atualização: ?dataHoraAtualizacaoInicial=01/06/2026 00:00&dataHoraAtualizacaoFinal=30/06/2026 23:59

Requisição

Parâmetros de Consulta

Parâmetros Header

Respostas

🟢200Sucesso

application/json

Lista de faturas retornada com sucesso

Bodyapplication/json

🟠400Sucesso (listagem Itens)

🟠401Campo Inválido

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v2/faturamento/faturas?idFatura=632606&idCliente=1001&numero=842&idIntegracao=ERP-2026-001&numeroPedido=5000&competencia=06%2F2026&loteCheckout=undefined&codigoCheckout=undefined&cpfCnpj=12345678000190&email=cliente%40empresa.com.br&dataHoraAtualizacaoInicial=01%2F06%2F2026%2000%3A00&dataHoraAtualizacaoFinal=30%2F06%2F2026%2023%3A59&isListarItens=true&sortField=numero&sortOrder=desc&page=0' \
--header 'x-api-key;'

Response Example

200 - Sucesso

{
    "status": "200",
    "message": [],
    "paging": {
        "totalRows": 1,
        "totalPages": 1,
        "itemsPerPage": 50,
        "page": 0
    },
    "data": [
        {
            "idFatura": 632606,
            "idIntegracao": null,
            "numeroPedido": 5000,
            "codigoCheckout": null,
            "numero": 842,
            "statusFatura": "ABERTA",
            "tipoFatura": "AVULSA",
            "formaFaturamentoAssinatura": null,
            "origemFatura": "MANUAL",
            "competencia": "06/2026",
            "idCliente": 1001,
            "nomeCliente": "Empresa Exemplo Ltda",
            "dataEmissao": "2026-06-16",
            "valorTotal": 1500,
            "itens": null
        }
    ]
}

Modificado em 2026-06-17 16:45:39

Página anterior

Emitir NFS-e para Fatura

Próxima página

Consulta de NFS-e - Notas Fiscais de Serviços