Conultar Faturas

Em teste

GET

/v2/faturamento/faturas

Este endpoint permite consultar as faturas emitidas e detalhe dos itens que compõe a fatura.

Requisição

Parâmetros de Consulta

Parâmetros Header

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢200Sucesso

application/json

Body

🟢200Sucesso (listagem Itens)

🟠400Campo Inválido

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request GET '/v2/faturamento/faturas?idFatura= idFatura=300043&idCliente= IdCliente=46&numero= numero=1379&idIntegracao= idIntegracao="97f2-571f-3a6d-312924dffa97"&competencia= competencia="01/2021"&loteCheckout= loteCheckout="eb5acb2e6b724a83bdc9973659df25bf"&codigoCheckout= codigoCheckout="5f46456a6fde447b547dff6f8658caf6"&cpfCnpj= cpfCnpj="20434562000120"&email= email="contato@faturagil.com.br"&dataHoraAtualizacaoInicial= dataHoraAtualizacaoInicial="01/12/2025 10:00"&dataHoraAtualizacaoFinal= dataHoraAtualizacaoFinal="02/12/2025 10:00" &isListarItens= isListarItens=[true/false]&sortField= sortField="idFatura"&sortOrder= sortOrder="asc"&page= page=1' \
--header 'x-api-key;' \
--header 'Content-Type: application/json' \
--data-raw '{}'

Response Example

200 - Sucesso

{
    "status": "200",
    "message": [],
    "data": [
        {
            "idFatura": 1676,
            "idIntegracao": "f3bc0af4-0831-a413-22c2-5b9ec7c6f824",
            "codigoCheckout": null,
            "numero": 263,
            "statusFatura": "REFATURADA",
            "tipoFatura": "RECORRENTE",
            "formaFaturamentoAssinatura": "AGRUPADA",
            "origemFatura": "MANUAL",
            "competencia": "01/2020",
            "idCliente": 493,
            "nomeCliente": "MATHEUS",
            "dataEmissao": "2020-01-22",
            "valorTotal": 100.00,
            "itens": null
        },
        {
            "idFatura": 3523,
            "idIntegracao": "e2501b2e-f861-84e0-6377-0a8788f0a31a",
            "codigoCheckout": null,
            "numero": 277,
            "statusFatura": "FATURADA",
            "tipoFatura": "RECORRENTE",
            "formaFaturamentoAssinatura": "AGRUPADA",
            "origemFatura": "MANUAL",
            "competencia": "02/2020",
            "idCliente": 493,
            "nomeCliente": "MATHEUS",
            "dataEmissao": "2020-02-03",
            "valorTotal": 100.00,
            "itens": null
        },
        {
            "idFatura": 4012,
            "idIntegracao": "9cc653b2-6fa2-e81c-e656-7e1735fce79e",
            "codigoCheckout": null,
            "numero": 342,
            "statusFatura": "REFATURADA",
            "tipoFatura": "RECORRENTE",
            "formaFaturamentoAssinatura": "AGRUPADA",
            "origemFatura": "MANUAL",
            "competencia": "03/2020",
            "idCliente": 493,
            "nomeCliente": "MATHEUS",
            "dataEmissao": "2020-03-28",
            "valorTotal": 100.00,
            "itens": null
        },
        {
            "idFatura": 4026,
            "idIntegracao": "1442793e-4157-ed8a-6432-f19845ddcd70",
            "codigoCheckout": null,
            "numero": 356,
            "statusFatura": "FATURADA",
            "tipoFatura": "AVULSA",
            "formaFaturamentoAssinatura": "AGRUPADA",
            "origemFatura": "MANUAL",
            "competencia": "03/2020",
            "idCliente": 493,
            "nomeCliente": "MATHEUS",
            "dataEmissao": "2020-03-03",
            "valorTotal": 1000.00,
            "itens": null
        },
        {
            "idFatura": 4031,
            "idIntegracao": "96a06213-3040-b290-bdae-76305dbaf144",
            "codigoCheckout": null,
            "numero": 357,
            "statusFatura": "CANCELADA",
            "tipoFatura": "AVULSA",
            "formaFaturamentoAssinatura": "AGRUPADA",
            "origemFatura": "MANUAL",
            "competencia": "03/2020",
            "idCliente": 493,
            "nomeCliente": "MATHEUS",
            "dataEmissao": "2020-03-04",
            "valorTotal": 1000.00,
            "itens": null
        },
        {
            "idFatura": 4142,
            "idIntegracao": "51ee0f6a-7edb-8733-1ef8-b1d3bf1037d2",
            "codigoCheckout": null,
            "numero": 360,
            "statusFatura": "CANCELADA",
            "tipoFatura": "AVULSA",
            "formaFaturamentoAssinatura": "AGRUPADA",
            "origemFatura": "MANUAL",
            "competencia": "03/2020",
            "idCliente": 493,
            "nomeCliente": "MATHEUS",
            "dataEmissao": "2020-03-12",
            "valorTotal": 2000.00,
            "itens": null
        },
        {
            "idFatura": 4869,
            "idIntegracao": "9dbf821a-1071-3a54-2599-5cbd7f957931",
            "codigoCheckout": null,
            "numero": 393,
            "statusFatura": "FATURADA",
            "tipoFatura": "RECORRENTE",
            "formaFaturamentoAssinatura": "AGRUPADA",
            "origemFatura": "MANUAL",
            "competencia": "04/2020",
            "idCliente": 493,
            "nomeCliente": "MATHEUS",
            "dataEmissao": "2020-04-02",
            "valorTotal": 600.00,
            "itens": null
        },
        {
            "idFatura": 5102,
            "idIntegracao": "a23d8d71-825c-19b6-9175-62a907f68bdf",
            "codigoCheckout": null,
            "numero": 413,
            "statusFatura": "CANCELADA",
            "tipoFatura": "AVULSA",
            "formaFaturamentoAssinatura": "AGRUPADA",
            "origemFatura": "MANUAL",
            "competencia": "04/2020",
            "idCliente": 493,
            "nomeCliente": "MATHEUS",
            "dataEmissao": "2020-04-22",
            "valorTotal": 200.00,
            "itens": null
        },
        {
            "idFatura": 5148,
            "idIntegracao": "dc1b597c-42c9-bc8f-bc8f-cb0b882f13cd",
            "codigoCheckout": null,
            "numero": 415,
            "statusFatura": "FATURADA",
            "tipoFatura": "AVULSA",
            "formaFaturamentoAssinatura": "AGRUPADA",
            "origemFatura": "MANUAL",
            "competencia": "04/2020",
            "idCliente": 493,
            "nomeCliente": "MATHEUS",
            "dataEmissao": "2020-04-25",
            "valorTotal": 100.00,
            "itens": null
        },
        {
            "idFatura": 5354,
            "idIntegracao": "737fd0d0-e9ad-5d32-0bb4-41b20750567f",
            "codigoCheckout": null,
            "numero": 440,
            "statusFatura": "FATURADA",
            "tipoFatura": "RECORRENTE",
            "formaFaturamentoAssinatura": "AGRUPADA",
            "origemFatura": "MANUAL",
            "competencia": "05/2020",
            "idCliente": 493,
            "nomeCliente": "MATHEUS",
            "dataEmissao": "2020-05-01",
            "valorTotal": 100.00,
            "itens": null
        },
        {
            "idFatura": 5640,
            "idIntegracao": "77e58fed-b6d0-cf80-f76d-d69fd28ed441",
            "codigoCheckout": null,
            "numero": 455,
            "statusFatura": "CANCELADA",
            "tipoFatura": "AVULSA",
            "formaFaturamentoAssinatura": "AGRUPADA",
            "origemFatura": "MANUAL",
            "competencia": "05/2020",
            "idCliente": 493,
            "nomeCliente": "MATHEUS",
            "dataEmissao": "2020-05-05",
            "valorTotal": 45.00,
            "itens": null
        },
        {
            "idFatura": 5661,
            "idIntegracao": "c3789919-accc-aee7-f1e2-c400c5f5ab88",
            "codigoCheckout": null,
            "numero": 456,
            "statusFatura": "CANCELADA",
            "tipoFatura": "AVULSA",
            "formaFaturamentoAssinatura": "AGRUPADA",
            "origemFatura": "MANUAL",
            "competencia": "05/2020",
            "idCliente": 493,
            "nomeCliente": "MATHEUS",
            "dataEmissao": "2020-05-06",
            "valorTotal": 1000.00,
            "itens": null
        },
        {
            "idFatura": 5793,
            "idIntegracao": "e4c9b173-2991-88e2-3cd5-759610150f5e",
            "codigoCheckout": null,
            "numero": 458,
            "statusFatura": "CANCELADA",
            "tipoFatura": "AVULSA",
            "formaFaturamentoAssinatura": "AGRUPADA",
            "origemFatura": "MANUAL",
            "competencia": "05/2020",
            "idCliente": 493,
            "nomeCliente": "MATHEUS",
            "dataEmissao": "2020-05-12",
            "valorTotal": 10.00,
            "itens": null
        },
        {
            "idFatura": 5879,
            "idIntegracao": "08fb9170-b130-da8c-1463-5c1010adfadc",
            "codigoCheckout": null,
            "numero": 459,
            "statusFatura": "CANCELADA",
            "tipoFatura": "AVULSA",
            "formaFaturamentoAssinatura": "AGRUPADA",
            "origemFatura": "MANUAL",
            "competencia": "05/2020",
            "idCliente": 493,
            "nomeCliente": "MATHEUS",
            "dataEmissao": "2020-05-15",
            "valorTotal": 10000.00,
            "itens": null
        },
        {
            "idFatura": 5905,
            "idIntegracao": "ab075ff9-7380-dcfa-fbee-1e7c04a3a3d7",
            "codigoCheckout": null,
            "numero": 460,
            "statusFatura": "CANCELADA",
            "tipoFatura": "AVULSA",
            "formaFaturamentoAssinatura": "AGRUPADA",
            "origemFatura": "MANUAL",
            "competencia": "05/2020",
            "idCliente": 493,
            "nomeCliente": "MATHEUS",
            "dataEmissao": "2020-05-19",
            "valorTotal": 2000.00,
            "itens": null
        },
        {
            "idFatura": 7381,
            "idIntegracao": "76bcbb5b-1f66-752c-4ab0-4d5a1e281978",
            "codigoCheckout": null,
            "numero": 461,
            "statusFatura": "FATURADA",
            "tipoFatura": "RECORRENTE",
            "formaFaturamentoAssinatura": "AGRUPADA",
            "origemFatura": "MANUAL",
            "competencia": "06/2020",
            "idCliente": 493,
            "nomeCliente": "MATHEUS",
            "dataEmissao": "2020-05-21",
            "valorTotal": 220.00,
            "itens": null
        },
        {
            "idFatura": 10074,
            "idIntegracao": "378625b8-ee21-c8b3-e806-0e53313f6a7e",
            "codigoCheckout": null,
            "numero": 512,
            "statusFatura": "FATURADA",
            "tipoFatura": "AVULSA",
            "formaFaturamentoAssinatura": "AGRUPADA",
            "origemFatura": "MANUAL",
            "competencia": "07/2020",
            "idCliente": 493,
            "nomeCliente": "MATHEUS",
            "dataEmissao": "2020-06-16",
            "valorTotal": 2000.00,
            "itens": null
        },
        {
            "idFatura": 10536,
            "idIntegracao": "279e60db-8c04-750b-66b0-f159e52c2309",
            "codigoCheckout": null,
            "numero": 514,
            "statusFatura": "CANCELADA",
            "tipoFatura": "AVULSA",
            "formaFaturamentoAssinatura": "AGRUPADA",
            "origemFatura": "MANUAL",
            "competencia": "06/2020",
            "idCliente": 493,
            "nomeCliente": "MATHEUS",
            "dataEmissao": "2020-06-23",
            "valorTotal": 2000.00,
            "itens": null
        },
        {
            "idFatura": 10600,
            "idIntegracao": "10d4f90d-ea84-24ed-a0f1-0ca0ddc856d3",
            "codigoCheckout": null,
            "numero": 515,
            "statusFatura": "CANCELADA",
            "tipoFatura": "AVULSA",
            "formaFaturamentoAssinatura": "AGRUPADA",
            "origemFatura": "MANUAL",
            "competencia": "06/2020",
            "idCliente": 493,
            "nomeCliente": "MATHEUS",
            "dataEmissao": "2020-06-24",
            "valorTotal": 5000.00,
            "itens": null
        },
        {
            "idFatura": 11356,
            "idIntegracao": "67808cc2-750f-38b9-2f5f-397f8bb98e8b",
            "codigoCheckout": null,
            "numero": 545,
            "statusFatura": "FATURADA",
            "tipoFatura": "RECORRENTE",
            "formaFaturamentoAssinatura": "AGRUPADA",
            "origemFatura": "MANUAL",
            "competencia": "07/2020",
            "idCliente": 493,
            "nomeCliente": "MATHEUS",
            "dataEmissao": "2020-07-02",
            "valorTotal": 170.00,
            "itens": null
        }
    ],
    "paging": {
        "page": 1
    }
}

Modificado em 2025-12-19 17:35:38

Página anterior

Emitir NFS-e da Fatura existente

Próxima página

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