Skip to content
API/
/v1

Notas fiscais (v1)

Endpoints openapi responsável pelo contexto de notas fiscais

Download OpenAPI description
open-api-invoice.json
open-api-invoice.yaml
Overview
Languages
Servers
https://api-v2.contaazul.com/
Mock server
https://developers.contaazul.com/_mock/open-api-docs/open-api-invoice/

v1

Operações relacionadas a notas fiscais

Operations

Retornar as notas fiscais por filtro

Request

Security
BearerAuth
Query
data_inicialstringrequired

Data inicial no formato YYYY-MM-DD

data_finalstringrequired

Data final no formato YYYY-MM-DD

paginainteger

Página

Default 1
tamanho_paginainteger

Tamanho da página

Default 10
documento_tomadorstring

Documento do tomador

numero_notastring

Número da nota fiscal

id_vendastring

ID da venda

curl -i -X GET \
  'https://api-v2.contaazul.com/v1/notas-fiscais?data_inicial=string&data_final=string&pagina=1&tamanho_pagina=10&documento_tomador=string&numero_nota=string&id_venda=string' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

OK

Bodyapplication/json
itensArray of objects(NotaFiscal)

Lista de notas fiscais

paginacaoobject
Response
application/json
{
  "itens": [
    { … }
  ],
  "paginacao": {
    "pagina_atual": 1,
    "tamanho_pagina": 10,
    "total_itens": 50,
    "total_paginas": 5
  }
}

Vincular nota fiscal a mdfe

Request

Security
BearerAuth
Bodyapplication/jsonrequired

Dados para vincular nota fiscal a mdfe

chaves_acessoArray of stringsrequired

Chaves de acesso das notas fiscais vinculadas ao MDF-e

Example: ["42250323643586000108550010000001151606401726","42250323643586000108550010000001141054498495"]
identificadorstringrequired

Identificador do MDF-e

Example: "345345"
statusstring
Enum"AUTORIZADO""ENCERRADO""CANCELADO"
Example: "ENCERRADO"
curl -i -X POST \
  https://api-v2.contaazul.com/v1/notas-fiscais/vinculo-mdfe \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "chaves_acesso": [
      "42250323643586000108550010000001151606401726",
      "42250323643586000108550010000001141054498495"
    ],
    "identificador": "345345",
    "status": "ENCERRADO"
  }'

Responses

No Content

Response
No content

Retornar a nota fiscal por chave

Request

Security
BearerAuth
Path
chavestringrequired

Chave da nota fiscal

curl -i -X GET \
  'https://api-v2.contaazul.com/v1/notas-fiscais/{chave}' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

OK

Bodyapplication/xml
string
Response
application/xml
<root>string</root>