# 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

 - [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 CORR
 - [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
 - [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
 - [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. A resposta é um conteúdo binário e deve ser tratada como download de arquivo: - Quando a nota **não** possui c