--- title: "API Emissão de Notas" description: "API Emissão de Notas - Emita documentos fiscais em segundos" lang: en canonical: https://doc.apibrasil.io/apis/creditos/7d62c6f8-0074-40bd-a17e-ba49235b7233 markdown: https://doc.apibrasil.io/apis/creditos/7d62c6f8-0074-40bd-a17e-ba49235b7233.md source: apibrasil-documentation --- # API Emissão de Notas > API Emissão de Notas - Emita documentos fiscais em segundos - **Category:** Digital Services - **Billing:** per query, with the Bearer Token only - **Price:** R$0.50 per query - **Limit:** 999,000 per month - **Registration:** requires a CNPJ - **Version:** v1 - **Published by:** APIBrasil - **OpenAPI specification:** https://doc.apibrasil.io/apis/creditos/7d62c6f8-0074-40bd-a17e-ba49235b7233/openapi.json ## How to call **Base address:** `https://gateway.apibrasil.io/api/v2` Authentication: the `Authorization: Bearer ` header. Nothing else. ## Endpoints (7 endpoints) **Contents** 1. `POST /consulta/emissao-notas/credits` 2. `POST /consulta/emissao-notas/credits` 3. `POST /consulta/emissao-notas/credits` 4. `POST /consulta/emissao-notas/credits` 5. `POST /consulta/emissao-notas/credits` 6. `POST /consulta/emissao-notas/credits` 7. `POST /consulta/emissao-notas/credits` ### 1. POST /consulta/emissao-notas/credits API Emissão de Notas - Agilidade e Controle Fiscal para Seu Negócio Com a API Emissão de Notas, você integra rapidamente a funcionalidade de cadastro de emitentes e emissão de notas ao seu sistema, agilizando processos fiscais e aumentando a eficiência operacional. Neste endpoint de cadastro de emitente (tipo emitentes-cadastro), o retorno da API fornece todas as informações necessárias para gerenciar emissões em tempo real, reduzindo erros e otimizando seu fluxo de trabalho. Potencialize o valor do seu negócio oferecendo ao seu cliente um processo de emissão simplificado, seguro e perfeitamente adaptável às necessidades da sua operação. - **Method:** `POST` - **Address:** `https://gateway.apibrasil.io/api/v2/consulta/emissao-notas/credits` - **Route version:** v1 - **Price of this operation:** R$19.00 per query **Headers** | Header | Value | | --- | --- | | `Content-Type` | `application/json` | | `Authorization` | `Bearer $APIBRASIL_TOKEN` | **Request body** ```json { "tipo": "emitentes-cadastro", "razao": "EMPRESA EXEMPLO LTDA", "nome": "EMPRESA EXEMPLO", "cnpj": "00000000000000", "cnae": "0000000", "crt": 1, "ie": "123456789", "im": "00000000", "suframa": null, "telefone": "0000000000", "email": "exemplo@empresa.com", "rua": "Rua Exemplo", "numero": "100", "bairro": "Bairro Exemplo", "municipio": "Cidade Exemplo", "cmun": "0000000", "uf": "SP", "cep": "00000000", "logo": null, "documentos": { "nfe": false, "nfce": false, "nfse": false }, "webhook_url": "https://example.com/webhook" } ``` **In cURL** ```bash curl -X POST "https://gateway.apibrasil.io/api/v2/consulta/emissao-notas/credits" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $APIBRASIL_TOKEN" \ -d '{"tipo":"emitentes-cadastro","razao":"EMPRESA EXEMPLO LTDA","nome":"EMPRESA EXEMPLO","cnpj":"00000000000000","cnae":"0000000","crt":1,"ie":"123456789","im":"00000000","suframa":null,"telefone":"0000000000","email":"exemplo@empresa.com","rua":"Rua Exemplo","numero":"100","bairro":"Bairro Exemplo","municipio":"Cidade Exemplo","cmun":"0000000","uf":"SP","cep":"00000000","logo":null,"documentos":{"nfe":false,"nfce":false,"nfse":false},"webhook_url":"https://example.com/webhook"}' ``` The catalog does not publish a sample response for this endpoint. ### 2. POST /consulta/emissao-notas/credits API Fiscal - Emissão de Notas Ágil e Precisa A API Emissão de Notas oferece atualização rápida dos dados do emitente e permite a emissão de notas fiscais em poucos cliques, tornando seu processo fiscal mais eficiente e seguro. Com integração fácil ao seu sistema via POST, o recurso consulta/emissao-notas/credits garante envio e retorno imediato das informações essenciais para suas operações. Amplie a automação do seu negócio, reduza erros e ganhe agilidade na gestão de notas, agregando valor e tecnologia ao seu fluxo financeiro. - **Method:** `POST` - **Address:** `https://gateway.apibrasil.io/api/v2/consulta/emissao-notas/credits` - **Route version:** v1 **Headers** | Header | Value | | --- | --- | | `Content-Type` | `application/json` | | `Authorization` | `Bearer $APIBRASIL_TOKEN` | **Request body** ```json { "tipo": "emitentes-atualiza", "emitente_id": "00000000-0000-0000-0000-000000000000", "razao": "EMPRESA EXEMPLO LTDA", "nome": "EMPRESA EXEMPLO", "cnpj": "00000000000000", "cnae": "0000000", "crt": 1, "ie": "123456789", "im": "00000000", "suframa": null, "telefone": "0000000000", "email": "exemplo@empresa.com", "rua": "Rua Exemplo", "numero": "100", "bairro": "Bairro Exemplo", "municipio": "Cidade Exemplo", "cmun": "0000000", "uf": "SP", "cep": "00000000", "logo": null, "documentos": { "nfe": false, "nfce": false, "nfse": false }, "webhook_url": "https://example.com/webhook" } ``` **In cURL** ```bash curl -X POST "https://gateway.apibrasil.io/api/v2/consulta/emissao-notas/credits" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $APIBRASIL_TOKEN" \ -d '{"tipo":"emitentes-atualiza","emitente_id":"00000000-0000-0000-0000-000000000000","razao":"EMPRESA EXEMPLO LTDA","nome":"EMPRESA EXEMPLO","cnpj":"00000000000000","cnae":"0000000","crt":1,"ie":"123456789","im":"00000000","suframa":null,"telefone":"0000000000","email":"exemplo@empresa.com","rua":"Rua Exemplo","numero":"100","bairro":"Bairro Exemplo","municipio":"Cidade Exemplo","cmun":"0000000","uf":"SP","cep":"00000000","logo":null,"documentos":{"nfe":false,"nfce":false,"nfse":false},"webhook_url":"https://example.com/webhook"}' ``` The catalog does not publish a sample response for this endpoint. ### 3. POST /consulta/emissao-notas/credits API Emissão de Notas - Agilidade e Controle Fiscal em Tempo Real Simplifique a rotina fiscal do seu negócio com a API Emissão de Notas, que permite a emissão automática de notas por integração rápida ao seu sistema. Com apenas um POST na ação consulta/emissao-notas/credits, você emite NFS-e em segundos (tipo nfse-envio), aumentando a eficiência operacional e reduzindo erros manuais. O retorno é claro, estruturado e pronto para uso, potencializando o controle financeiro e possibilitando automações como faturamento instantâneo, conciliação e gestão fiscal avançada no seu ambiente digital. - **Method:** `POST` - **Address:** `https://gateway.apibrasil.io/api/v2/consulta/emissao-notas/credits` - **Route version:** v1 - **Price of this operation:** R$0.50 per query **Headers** | Header | Value | | --- | --- | | `Content-Type` | `application/json` | | `Authorization` | `Bearer $APIBRASIL_TOKEN` | **Request body** ```json { "tipo": "nfse-envio", "emitente_id": "00000000-0000-0000-0000-000000000000", "dados": { "status": "1", "natureza_operacao": "1", "regime_apuracao": "1", "data_emissao": "2026-01-01T00:00:00-03:00", "data_competencia": "2026-01-01T00:00:00-03:00", "codigo_aleatorio": "12345678", "nacional": true, "tomador": { "cpf": "00000000000", "razao_social": "CLIENTE EXEMPLO", "endereco": { "logradouro": "Rua Exemplo", "numero": "100", "bairro": "Bairro Exemplo", "codigo_municipio": "0000000", "uf": "SP", "cep": "00000000" } }, "servico": { "codigo": "000000", "codigo_interno": "000000000", "cIntContrib": "000000000", "codigo_tributacao_municipio": "000", "codigo_nbs": "000000000", "discriminacao": "Descrição do serviço exemplo", "valor_servicos": 100, "codigo_municipio": "0000000", "endereco_local_prestacao": { "codigo_municipio_prestacao": "0000000" }, "tributos_municipais": { "iss_retido": false }, "tributos_totais": { "percentual_tributos_simples_nacional": 0 }, "itens": [ { "codigo": "0000", "codigo_interno": "000000000", "cIntContrib": "000000000", "codigo_nbs": "000000000", "discriminacao": "Item de serviço exemplo", "valor_servicos": 100 } ] } } } ``` **In cURL** ```bash curl -X POST "https://gateway.apibrasil.io/api/v2/consulta/emissao-notas/credits" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $APIBRASIL_TOKEN" \ -d '{"tipo":"nfse-envio","emitente_id":"00000000-0000-0000-0000-000000000000","dados":{"status":"1","natureza_operacao":"1","regime_apuracao":"1","data_emissao":"2026-01-01T00:00:00-03:00","data_competencia":"2026-01-01T00:00:00-03:00","codigo_aleatorio":"12345678","nacional":true,"tomador":{"cpf":"00000000000","razao_social":"CLIENTE EXEMPLO","endereco":{"logradouro":"Rua Exemplo","numero":"100","bairro":"Bairro Exemplo","codigo_municipio":"0000000","uf":"SP","cep":"00000000"}},"servico":{"codigo":"000000","codigo_interno":"000000000","cIntContrib":"000000000","codigo_tributacao_municipio":"000","codigo_nbs":"000000000","discriminacao":"Descrição do serviço exemplo","valor_servicos":100,"codigo_municipio":"0000000","endereco_local_prestacao":{"codigo_municipio_prestacao":"0000000"},"tributos_municipais":{"iss_retido":false},"tributos_totais":{"percentual_tributos_simples_nacional":0},"itens":[{"codigo":"0000","codigo_interno":"000000000","cIntContrib":"000000000","codigo_nbs":"000000000","discriminacao":"Item de serviço exemplo","valor_servicos":100}]}}}' ``` The catalog does not publish a sample response for this endpoint. ### 4. POST /consulta/emissao-notas/credits API Emissão de Notas - Agilidade e Controle na Gestão Fiscal A API Emissão de Notas permite que sua empresa cancele notas fiscais eletrônicas de forma automatizada, rápida e totalmente integrada ao seu sistema. Com poucos passos e utilizando o método POST no endpoint consulta/emissao-notas/credits, você garante mais segurança nos processos e reduz riscos de inconsistências fiscais. A integração é simples, com retorno claro sobre cada operação, possibilitando auditoria, correção de erros e mais eficiência no seu fluxo de trabalho. Potencialize sua gestão, evite retrabalho e assegure conformidade fiscal, tudo dentro do seu ambiente tecnológico. - **Method:** `POST` - **Address:** `https://gateway.apibrasil.io/api/v2/consulta/emissao-notas/credits` - **Route version:** v1 **Headers** | Header | Value | | --- | --- | | `Content-Type` | `application/json` | | `Authorization` | `Bearer $APIBRASIL_TOKEN` | **In cURL** ```bash curl -X POST "https://gateway.apibrasil.io/api/v2/consulta/emissao-notas/credits" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $APIBRASIL_TOKEN" ``` The catalog does not publish a sample response for this endpoint. ### 5. POST /consulta/emissao-notas/credits API Emissão de Notas - Gere e Consulte Notas Fiscais em Instantes Com a API Emissão de Notas, sua empresa automatiza a geração e consulta de notas fiscais de forma simples e ágil, integrando-se rapidamente ao seu sistema com apenas um endpoint e método POST. Ganhe eficiência operacional, reduza erros e mantenha seus processos fiscais em dia, aproveitando o retorno detalhado da API para consultar uma NFS-e emitida a partir da chave (tipo nfse-consulta). Ideal para plataformas de vendas, ERPs ou qualquer aplicação que demande emissão e gerenciamento de notas fiscais diretamente pelo seu fluxo digital. - **Method:** `POST` - **Address:** `https://gateway.apibrasil.io/api/v2/consulta/emissao-notas/credits` - **Route version:** v1 **Headers** | Header | Value | | --- | --- | | `Content-Type` | `application/json` | | `Authorization` | `Bearer $APIBRASIL_TOKEN` | **Request body** ```json { "tipo": "nfse-consulta", "emitente_id": "00000000-0000-0000-0000-000000000000", "chave": "00000000000000000000000000000000000000000000" } ``` **In cURL** ```bash curl -X POST "https://gateway.apibrasil.io/api/v2/consulta/emissao-notas/credits" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $APIBRASIL_TOKEN" \ -d '{"tipo":"nfse-consulta","emitente_id":"00000000-0000-0000-0000-000000000000","chave":"00000000000000000000000000000000000000000000"}' ``` The catalog does not publish a sample response for this endpoint. ### 6. POST /consulta/emissao-notas/credits API Emissão de Notas - Emita Documentos Fiscais com Rapidez e Segurança A API Emissão de Notas permite integrar, de forma rápida e fácil, a emissão automatizada de notas fiscais eletrônicas ao seu sistema, agregando agilidade e valor ao seu negócio. Com um simples POST no endpoint consulta/emissao-notas/credits, você pode emitir e consultar créditos fiscais de maneira totalmente digital, inclusive realizando upload de certificados diretamente pela API para garantir conformidade e proteção dos dados. O retorno é estruturado e preciso, pronto para alimentar seus processos internos, controlar obrigações fiscais e facilitar conciliações, tudo sem complicações técnicas. Modernize sua operação e ofereça uma experiência eficiente e confiável para sua empresa ou para seus clientes. - **Method:** `POST` - **Address:** `https://gateway.apibrasil.io/api/v2/consulta/emissao-notas/credits` - **Route version:** v1 **Headers** | Header | Value | | --- | --- | | `Content-Type` | `application/json` | | `Authorization` | `Bearer $APIBRASIL_TOKEN` | **Request body** ```json { "tipo": "certificado-upload", "dados": { "emitente_id": "uuid-do-emitente", "senha": "sua-senha", "certificado": "MII...base64...==" } } ``` **In cURL** ```bash curl -X POST "https://gateway.apibrasil.io/api/v2/consulta/emissao-notas/credits" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $APIBRASIL_TOKEN" \ -d '{"tipo":"certificado-upload","dados":{"emitente_id":"uuid-do-emitente","senha":"sua-senha","certificado":"MII...base64...=="}}' ``` The catalog does not publish a sample response for this endpoint. ### 7. POST /consulta/emissao-notas/credits API Emissão de Notas - Emissão Ágil e Segura para Seu Negócio Tenha total controle sobre o processo de emissão de notas fiscais integrando rapidamente a API Emissão de Notas ao seu sistema. Com o endpoint dedicado para listar emitentes no método POST, sua empresa pode automatizar e simplificar operações fiscais, ampliando a eficiência, garantindo conformidade e acelerando processos. Receba respostas claras e estruturadas, potencializando integrações contábeis ou ERPs, e ganhe tempo para focar no crescimento e na gestão inteligente do seu negócio. - **Method:** `POST` - **Address:** `https://gateway.apibrasil.io/api/v2/consulta/emissao-notas/credits` - **Route version:** v1 - **Price of this operation:** R$0.00 per query **Headers** | Header | Value | | --- | --- | | `Content-Type` | `application/json` | | `Authorization` | `Bearer $APIBRASIL_TOKEN` | **Request body** ```json { "tipo": "emitentes-lista", "emitente": "00000000-0000-0000-0000-000000000000" } ``` **In cURL** ```bash curl -X POST "https://gateway.apibrasil.io/api/v2/consulta/emissao-notas/credits" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $APIBRASIL_TOKEN" \ -d '{"tipo":"emitentes-lista","emitente":"00000000-0000-0000-0000-000000000000"}' ``` The catalog does not publish a sample response for this endpoint. ## Pitfalls: what an integration gets wrong without warning Established from the responses the catalog itself publishes. In every one of them the code works on the happy path and fails silently everywhere else: 1. **The error arrives in the BODY, with HTTP 200.** The response carries a boolean `error` field and a `message`. Checking only `response.ok` or the HTTP status lets a failure through as a success. ALWAYS check `error === false` before reading `data`. 2. **`balance`, `tax` and `extra_charges.total` are STRINGS in Brazilian format — and the format varies between APIs.** Values seen in the catalog: `"154,380"`, `"497,84"`, `"0,000"` and `"0.19"`. Comma in some, dot in another; three decimal places in some, two in another. In JavaScript, `parseFloat("154,380")` returns `154` and drops the cents with no error at all, and `Number("154,380")` returns `NaN`. Write a converter that handles both separators, and never use these fields in a financial decision without converting them. 3. **Every call costs money.** Blind retries multiply the bill. Never automatically repeat a 4xx: a bad parameter repeated is still bad, and still charged. Retry only timeouts and 5xx, with exponential backoff and a small attempt ceiling. 4. **HTTP 402 means insufficient balance, and retrying does not fix it.** It is the one status that needs a human — a top-up. Treat it as a terminal error with its own message, and do not lump it in with generic 4xx. 5. **`extra_charges` bills on top of the lookup price.** When the body asks for add-on services, the response lists each one with its price plus a `total` that is NOT included in the base amount. If you show cost to an end user, add both. ## See also - OpenAPI specification: https://doc.apibrasil.io/apis/creditos/7d62c6f8-0074-40bd-a17e-ba49235b7233/openapi.json - API catalog: [API catalog](https://doc.apibrasil.io/apis.md) - Official SDKs: [Official SDKs](https://doc.apibrasil.io/sdks.md) - Documentation index: https://doc.apibrasil.io/llms.txt - HTML version of this page: https://doc.apibrasil.io/apis/creditos/7d62c6f8-0074-40bd-a17e-ba49235b7233