--- title: "API Emissão de Notas" description: "API Emissão de Notas - Emita documentos fiscais em segundos" lang: pt-BR 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 - **Categoria:** Serviços Digitais - **Cobrança:** por consulta, só com o Bearer Token - **Preço:** R$ 0,50 por consulta - **Limite:** 999.000 por mês - **Cadastro:** exige CNPJ - **Versão:** v1 - **Publicada por:** APIBrasil - **Especificação OpenAPI:** https://doc.apibrasil.io/apis/creditos/7d62c6f8-0074-40bd-a17e-ba49235b7233/openapi.json ## Como chamar **Endereço base:** `https://gateway.apibrasil.io/api/v2` Autenticação: cabeçalho `Authorization: Bearer `. Nada além disso. ## Endpoints (7 endpoints) **Sumário** 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. Utilizando o endpoint de consulta/e emissão de créditos, 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. - **Método:** `POST` - **Endereço:** `https://gateway.apibrasil.io/api/v2/consulta/emissao-notas/credits` - **Versão da rota:** v1 - **Preço desta operação:** R$ 19,00 por consulta **Cabeçalhos** | Cabeçalho | Valor | | --- | --- | | `Content-Type` | `application/json` | | `Authorization` | `Bearer $APIBRASIL_TOKEN` | **Corpo da requisição** ```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" } ``` **Em 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"}' ``` O catálogo não publica resposta de exemplo para este 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. - **Método:** `POST` - **Endereço:** `https://gateway.apibrasil.io/api/v2/consulta/emissao-notas/credits` - **Versão da rota:** v1 **Cabeçalhos** | Cabeçalho | Valor | | --- | --- | | `Content-Type` | `application/json` | | `Authorization` | `Bearer $APIBRASIL_TOKEN` | **Corpo da requisição** ```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" } ``` **Em 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"}' ``` O catálogo não publica resposta de exemplo para este 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ê gera e consulta créditos de notas fiscais em segundos, 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. - **Método:** `POST` - **Endereço:** `https://gateway.apibrasil.io/api/v2/consulta/emissao-notas/credits` - **Versão da rota:** v1 - **Preço desta operação:** R$ 0,00 por consulta **Cabeçalhos** | Cabeçalho | Valor | | --- | --- | | `Content-Type` | `application/json` | | `Authorization` | `Bearer $APIBRASIL_TOKEN` | **Corpo da requisição** ```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 } ] } } } ``` **Em 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}]}}}' ``` O catálogo não publica resposta de exemplo para este 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. - **Método:** `POST` - **Endereço:** `https://gateway.apibrasil.io/api/v2/consulta/emissao-notas/credits` - **Versão da rota:** v1 **Cabeçalhos** | Cabeçalho | Valor | | --- | --- | | `Content-Type` | `application/json` | | `Authorization` | `Bearer $APIBRASIL_TOKEN` | **Em 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" ``` O catálogo não publica resposta de exemplo para este 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 rastrear créditos com precisão. Ideal para plataformas de vendas, ERPs ou qualquer aplicação que demande emissão e gerenciamento de notas fiscais diretamente pelo seu fluxo digital. - **Método:** `POST` - **Endereço:** `https://gateway.apibrasil.io/api/v2/consulta/emissao-notas/credits` - **Versão da rota:** v1 **Cabeçalhos** | Cabeçalho | Valor | | --- | --- | | `Content-Type` | `application/json` | | `Authorization` | `Bearer $APIBRASIL_TOKEN` | **Corpo da requisição** ```json { "tipo": "nfse-consulta", "emitente_id": "00000000-0000-0000-0000-000000000000", "chave": "00000000000000000000000000000000000000000000" } ``` **Em 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"}' ``` O catálogo não publica resposta de exemplo para este 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. - **Método:** `POST` - **Endereço:** `https://gateway.apibrasil.io/api/v2/consulta/emissao-notas/credits` - **Versão da rota:** v1 **Cabeçalhos** | Cabeçalho | Valor | | --- | --- | | `Content-Type` | `application/json` | | `Authorization` | `Bearer $APIBRASIL_TOKEN` | **Corpo da requisição** ```json { "tipo": "certificado-upload", "dados": { "emitente_id": "uuid-do-emitente", "senha": "sua-senha", "certificado": "MII...base64...==" } } ``` **Em 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...=="}}' ``` O catálogo não publica resposta de exemplo para este 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. - **Método:** `POST` - **Endereço:** `https://gateway.apibrasil.io/api/v2/consulta/emissao-notas/credits` - **Versão da rota:** v1 - **Preço desta operação:** R$ 0,00 por consulta **Cabeçalhos** | Cabeçalho | Valor | | --- | --- | | `Content-Type` | `application/json` | | `Authorization` | `Bearer $APIBRASIL_TOKEN` | **Corpo da requisição** ```json { "tipo": "emitentes-lista", "emitente": "00000000-0000-0000-0000-000000000000" } ``` **Em 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"}' ``` O catálogo não publica resposta de exemplo para este endpoint. ## Armadilhas: o que uma integração erra sem avisar Apuradas nas respostas que o próprio catálogo publica. Em todas elas o código funciona no caminho feliz e falha em silêncio no resto: 1. **O erro chega no CORPO, com HTTP 200.** A resposta traz um campo `error` booleano e uma `message`. Checar só `response.ok` ou o status HTTP deixa passar falha como sucesso. Confira SEMPRE `error === false` antes de ler `data`. 2. **`balance`, `tax` e `extra_charges.total` são STRING em formato brasileiro — e o formato varia entre APIs.** Valores observados no catálogo: `"154,380"`, `"497,84"`, `"0,000"` e `"0.19"`. Vírgula em umas, ponto em outra; três casas decimais em umas, duas em outra. Em JavaScript, `parseFloat("154,380")` devolve `154` e perde os centavos sem erro nenhum, e `Number("154,380")` devolve `NaN`. Escreva um conversor que trate os dois separadores, e nunca use esses campos numa decisão financeira sem convertê-los. 3. **Cada chamada custa dinheiro.** Retry cego multiplica a conta. Nunca repita automaticamente um 4xx: parâmetro errado repetido continua errado e continua cobrando. Repita só tempo esgotado e 5xx, com recuo exponencial e um teto pequeno de tentativas. 4. **HTTP 402 é saldo insuficiente, e repetir não resolve.** É o único status que exige ação humana — recarregar. Trate-o como erro terminal, com mensagem própria, e não o jogue no mesmo balde dos 4xx genéricos. 5. **`extra_charges` cobra à parte do preço da consulta.** Quando o corpo pede serviços adicionais, a resposta traz cada um com o preço e um `total` que NÃO está incluso no valor base. Se você mostra custo a quem usa, some os dois. ## Ver também - Especificação OpenAPI: https://doc.apibrasil.io/apis/creditos/7d62c6f8-0074-40bd-a17e-ba49235b7233/openapi.json - Catálogo de APIs: [Catálogo de APIs](https://doc.apibrasil.io/apis.md) - SDKs oficiais: [SDKs oficiais](https://doc.apibrasil.io/sdks.md) - Índice da documentação: https://doc.apibrasil.io/llms.txt - Versão HTML desta página: https://doc.apibrasil.io/apis/creditos/7d62c6f8-0074-40bd-a17e-ba49235b7233