# Notas fiscais

A API de Notas Fiscais (v1) tem como objetivo permitir a consulta de documentos fiscais de forma programática. No momento, o suporte disponível é apenas para consulta de notas de produto NF-e emitidas no ERP, permitindo que sistemas externos recuperem informações fiscais, validem dados e integrem essas notas aos seus próprios fluxos.

Essa API possibilita acessar detalhes das notas já emitidas, acompanhar informações essenciais para controle fiscal e garantir maior eficiência na integração entre sistemas.

Se desejar aprofundar o entendimento das regras de negócio aplicadas pelo ERP, recomendamos, de forma opcional a consulta à nossa Central de Ajuda:

[https://ajuda.contaazul.com/hc/pt-br/articles/4424707438605-Como-acessar-notas-fiscais-emitidas-na-Conta-Azul](https://ajuda.contaazul.com/hc/pt-br/articles/4424707438605-Como-acessar-notas-fiscais-emitidas-na-Conta-Azul) 

Version: v1

## Servers

```
https://api-v2.contaazul.com
```

## Security

### BearerAuth

Digite **'Bearer <JWT>'**, onde JWT é o access_token recebido no login (passo 2 do fluxo de autenticação).

Type: apiKey
In: header
Name: Authorization

## Download OpenAPI description

[Notas fiscais](https://developers.contaazul.com/_bundle/open-api-docs/open-api-invoice.yaml)

## v1

Operações relacionadas a notas fiscais

### Retornar as notas fiscais por filtro

 - [GET /v1/notas-fiscais](https://developers.contaazul.com/open-api-docs/open-api-invoice/v1/obternotasfiscaisporfiltro.md): Permite consultar todas as notas fiscais de produto (NFe) já emitidas no ERP, com suporte a filtros como data, número da nota, id da venda.. Este endpoint retorna somente NFe com status EMITIDA e CORRIGIDA COM SUCESSO (outros status em construção). Essa funcionalidade facilita o monitoramento fiscal, exportação para relatórios ou integração com contabilidade.

### Retornar notas fiscais de serviço por filtros

 - [GET /v1/notas-fiscais-servico](https://developers.contaazul.com/open-api-docs/open-api-invoice/v1/obternotasfiscaisservicoporfiltro.md): Permite consultar todas as notas fiscais de serviço (NFS-e) já emitidas no ERP, com uso de filtros como data, número da nota, id da venda.. Este endpoint retorna NFS-e com todos os status possíveis a partir da emissão. Essa funcionalidade facilita o monitoramento fiscal, exportação para relatórios ou integração com contabilidade.

### Vincular nota fiscal a mdfe

 - [POST /v1/notas-fiscais/vinculo-mdfe](https://developers.contaazul.com/open-api-docs/open-api-invoice/v1/vincularnotafiscalmdfe.md): Permite associar uma ou mais notas fiscais (identificadas pelas chaves de acesso) a um MDF-e (Manifesto Eletrônico de Documento Fiscal). É possível também informar o status do vínculo (ex: "AUTORIZADO", "ENCERRADO", "CANCELADO"). Apoio no controle logístico e fiscal.

### Retornar a nota fiscal por chave

 - [GET /v1/notas-fiscais/{chave}](https://developers.contaazul.com/open-api-docs/open-api-invoice/v1/obternotafiscalporchave.md): Permite consultar dados de uma nota fiscal específica, buscando pela sua chave de acesso