# Glossário de A a Z — letra A > 20 termos. Glossário compacto: https://conota.dev/glossario/llms-full.txt --- # AC Raiz da ICP-Brasil > AC Raiz da ICP-Brasil é a autoridade certificadora no topo da Infraestrutura de Chaves Públicas Brasileira, responsável por credenciar, fiscalizar e assinar os certificados das autoridades certificadoras abaixo dela. É a âncora de confiança que permite à SEFAZ e às prefeituras reconhecer como válidos os certificados digitais usados para assinar notas fiscais eletrônicas. **Também conhecido como:** Autoridade Certificadora Raiz da ICP-Brasil, AC Raiz, Certificado raiz da ICP-Brasil, AC-Raiz, Root Certificate Authority **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** A ## O que é a AC Raiz da ICP-Brasil? A AC Raiz é o primeiro elo da cadeia de confiança da ICP-Brasil, o sistema oficial brasileiro de certificação digital. Ela fica no topo de uma estrutura hierárquica: abaixo dela estão as autoridades certificadoras de primeiro nível, depois as de segundo nível e, por fim, os certificados entregues a empresas e pessoas, como o e-CNPJ e o e-CPF. O papel de AC Raiz é exercido pelo Instituto Nacional de Tecnologia da Informação (ITI), autarquia federal. Diferentemente das autoridades certificadoras comerciais, a AC Raiz não emite certificados para usuários finais. Ela emite e assina apenas os certificados das autoridades certificadoras que credencia. ## Para que serve a AC Raiz da ICP-Brasil? A AC Raiz serve para garantir que todo certificado da ICP-Brasil tenha origem confiável. Ela credencia as autoridades certificadoras, define regras técnicas e de segurança, audita e fiscaliza o cumprimento dessas regras e pode descredenciar quem não as segue. Na prática, isso significa que, quando um sistema verifica um certificado digital, ele não precisa confiar diretamente em cada empresa certificadora. Basta confiar na AC Raiz: se a cadeia de assinaturas leva até ela, o certificado é considerado legítimo no Brasil. ## Como funciona a cadeia de confiança até a AC Raiz? Cada certificado é assinado digitalmente pela autoridade imediatamente acima dele. O certificado A1 de uma empresa é assinado por uma autoridade certificadora; o certificado dessa autoridade é assinado por outra de nível superior; e assim por diante, até chegar à AC Raiz, cujo certificado é autoassinado. Para validar um certificado, o sistema percorre essa cadeia de baixo para cima, conferindo cada assinatura, a validade de cada certificado e se nenhum foi revogado. Se todos os elos estiverem corretos e o topo for uma AC Raiz reconhecida, o certificado é aceito. A AC Raiz pode ter mais de uma versão de certificado em uso ao longo do tempo, já que certificados raiz também têm prazo de validade e são renovados com algoritmos mais seguros. ## Por que a AC Raiz importa na emissão de notas fiscais? Documentos fiscais eletrônicos como NF-e, NFC-e, CT-e e MDF-e precisam ser assinados digitalmente com um certificado da ICP-Brasil. Ao receber o XML, a SEFAZ verifica se a assinatura foi feita com um certificado cuja cadeia termina na AC Raiz. Se não terminar, o documento é rejeitado. Além da assinatura do XML, a comunicação com os webservices da SEFAZ costuma usar conexões seguras que também dependem de certificados da ICP-Brasil. Por isso, servidores e bibliotecas de integração fiscal precisam reconhecer os certificados da AC Raiz em seu repositório de certificados confiáveis, sob pena de erros de conexão. ## Qual a diferença entre AC Raiz e Autoridade Certificadora comum? A Autoridade Certificadora comum é a empresa ou entidade credenciada que emite certificados para empresas e pessoas, geralmente com apoio de uma Autoridade de Registro que confere a identidade do solicitante. É com ela que o contribuinte compra seu certificado A1 ou A3. A AC Raiz, por outro lado, não vende certificados nem atende o público final. Ela regula e assina os certificados das autoridades certificadoras, funcionando como a base de confiança de todo o sistema. ## Exemplos de AC Raiz da ICP-Brasil - Uma software house que integra seu ERP à SEFAZ recebe erros de conexão SSL em um servidor novo e descobre que o certificado da AC Raiz da ICP-Brasil não estava instalado no repositório de confiança do sistema operacional. - Ao enviar uma NF-e por uma API fiscal, o XML é assinado com o e-CNPJ da empresa; a SEFAZ valida a cadeia desse certificado até a AC Raiz antes de conceder a autorização de uso. - Um desenvolvedor configura um arquivo JKS em uma aplicação Java incluindo os certificados da AC Raiz e das autoridades intermediárias para que a comunicação com os webservices fiscais seja aceita. - Uma equipe de suporte analisa uma rejeição por certificado não confiável e verifica se o certificado A1 enviado pelo cliente realmente pertence à cadeia da ICP-Brasil. ## Perguntas frequentes ### Posso comprar um certificado diretamente da AC Raiz? Não. A AC Raiz não emite certificados para empresas ou pessoas. Ela apenas credencia e assina os certificados das autoridades certificadoras, que são as responsáveis por vender e emitir certificados como e-CNPJ e e-CPF. ### Quem é a AC Raiz da ICP-Brasil? A função é exercida pelo Instituto Nacional de Tecnologia da Informação (ITI), autarquia federal que também credencia, audita e fiscaliza as demais entidades da ICP-Brasil. ### Preciso instalar o certificado da AC Raiz no meu servidor? Em muitos casos, sim. Sistemas que se comunicam diretamente com webservices fiscais precisam reconhecer a cadeia da ICP-Brasil. Ao usar uma API fiscal como intermediária, essa configuração costuma ficar a cargo do provedor. ### O certificado da AC Raiz expira? Sim. Certificados raiz também têm validade e são substituídos por novas versões ao longo do tempo. Por isso, é importante manter atualizado o repositório de certificados confiáveis dos servidores. ## Termos relacionados - [ICP-Brasil](https://conota.dev/glossario/icp-brasil.md) - [Autoridade Certificadora](https://conota.dev/glossario/autoridade-certificadora.md) - [Cadeia de certificação digital](https://conota.dev/glossario/cadeia-de-certificacao-digital.md) - [Hierarquia de certificados digitais](https://conota.dev/glossario/hierarquia-de-certificados-digitais.md) - [Certificado digital A1](https://conota.dev/glossario/certificado-digital-a1.md) - [Assinatura digital do XML](https://conota.dev/glossario/assinatura-digital-do-xml.md) --- Fonte: [AC Raiz da ICP-Brasil](https://conota.dev/glossario/ac-raiz-da-icp-brasil/) · Atualizado em 2026-10-22 --- # Ajuste SINIEF > Ajuste SINIEF é um ato normativo firmado entre o governo federal e os estados, no âmbito do CONFAZ, para padronizar obrigações acessórias em todo o país. Ele define regras sobre documentos fiscais, livros e procedimentos, e foi o instrumento usado para criar documentos eletrônicos como NF-e, CT-e e MDF-e. **Também conhecido como:** Ajuste Sinief, Ajustes SINIEF **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** A ## O que significa SINIEF? SINIEF é a sigla de Sistema Nacional Integrado de Informações Econômico-Fiscais. Trata-se de um sistema criado para que a União e os estados compartilhem informações e sigam regras comuns sobre como as empresas devem registrar e informar suas operações. Um Ajuste SINIEF é, portanto, um acordo dentro desse sistema. Ele altera ou complementa as regras nacionais sobre documentos e registros fiscais, para que um mesmo modelo de nota, por exemplo, seja aceito em qualquer estado. ## Para que serve um Ajuste SINIEF? Serve para padronizar as obrigações acessórias, que são os deveres burocráticos das empresas além de pagar o imposto: emitir notas, escriturar livros, enviar declarações e guardar documentos. Sem esse tipo de acordo, cada estado poderia exigir um modelo diferente de nota fiscal, o que tornaria muito difícil vender ou transportar mercadorias entre estados. O Ajuste SINIEF cria uma base comum que todos seguem. ## Quem cria e aprova os Ajustes SINIEF? Os Ajustes SINIEF são celebrados no CONFAZ, o Conselho Nacional de Política Fazendária, que reúne representantes da área fazendária federal e das secretarias de fazenda dos estados e do Distrito Federal. Depois de aprovados, são publicados oficialmente e passam a valer conforme as datas e condições previstas no próprio texto. Cada estado também pode incorporar as regras à sua legislação interna. ## Qual a relação entre Ajuste SINIEF e os documentos fiscais eletrônicos? Os principais documentos fiscais eletrônicos de circulação de mercadorias e de transporte foram instituídos por Ajustes SINIEF. É o caso da NF-e, do CT-e, do MDF-e e da NFC-e. Esses atos definem o que é o documento, quem deve emiti-lo, como ocorre a autorização de uso, o cancelamento e outros eventos. Os detalhes técnicos, como leiaute do XML, campos obrigatórios e regras de validação, costumam ser publicados em documentos complementares, como manuais de orientação e notas técnicas. Por isso, sistemas emissores e APIs fiscais precisam acompanhar tanto os Ajustes quanto essas publicações técnicas. A NFS-e, por ser ligada ao ISSQN, que é um imposto municipal, não segue esse mesmo caminho: suas regras vêm de normas municipais e do padrão nacional próprio da nota de serviço. ## Qual a diferença entre Ajuste SINIEF e Convênio ICMS? Ambos são aprovados no CONFAZ, mas tratam de assuntos diferentes. O Ajuste SINIEF cuida das obrigações acessórias, ou seja, da forma de documentar e informar as operações. O Convênio ICMS trata de questões ligadas ao próprio imposto, como concessão de benefícios fiscais, regras de substituição tributária e partilha de arrecadação entre estados. Em resumo: o Convênio mexe no quanto e como se paga; o Ajuste mexe em como se registra e informa. ## Por que um Ajuste SINIEF importa para quem integra sistemas fiscais? Quando um novo Ajuste altera prazos, cria eventos ou muda regras de emissão, ERPs, marketplaces e plataformas de venda precisam se adaptar para não ter notas rejeitadas. Uma mudança pode exigir novos campos, novos eventos ou novos fluxos de cancelamento. Ao usar uma infraestrutura de emissão por API, boa parte dessa adaptação técnica fica concentrada no provedor, mas a empresa ainda precisa entender o que mudou para preencher corretamente as informações da operação. ## Exemplos de Ajuste SINIEF - O Ajuste SINIEF 07/2005 instituiu a Nota Fiscal Eletrônica (NF-e) e o DANFE, base das regras de emissão de notas de produtos até hoje. - O Ajuste SINIEF 09/2007 instituiu o Conhecimento de Transporte Eletrônico (CT-e), usado por transportadoras para documentar a prestação de serviço de transporte. - O Ajuste SINIEF 21/2010 instituiu o Manifesto Eletrônico de Documentos Fiscais (MDF-e), que agrupa os documentos da carga transportada. - Um time de desenvolvimento de um ERP acompanha a publicação de um novo Ajuste SINIEF que altera prazos de cancelamento da NF-e e ajusta as validações do sistema antes da data de vigência. ## Perguntas frequentes ### Ajuste SINIEF é lei? Não é uma lei aprovada pelo Congresso. É um ato normativo firmado no CONFAZ entre a União e os estados, com força para padronizar obrigações acessórias. Os estados costumam incorporar suas regras à legislação estadual. ### Todo Ajuste SINIEF vale para todos os estados? Em geral, sim, pois o objetivo é padronizar regras nacionalmente. Porém, alguns Ajustes preveem exceções, adesões específicas ou prazos diferentes para determinados estados, por isso é importante ler o texto completo. ### Ajuste SINIEF se aplica à NFS-e? Normalmente não. A NFS-e está ligada ao ISSQN, imposto municipal, e segue normas municipais e o padrão nacional próprio. Os Ajustes SINIEF tratam principalmente de documentos ligados ao ICMS, como NF-e, NFC-e, CT-e e MDF-e. ### Onde ficam os detalhes técnicos de um documento criado por Ajuste SINIEF? Ficam em manuais de orientação ao contribuinte e notas técnicas publicados pelos órgãos responsáveis. Eles detalham leiaute do XML, regras de validação e códigos de rejeição. ## Termos relacionados - [ICMS](https://conota.dev/glossario/icms.md) - [CT-e](https://conota.dev/glossario/ct-e.md) - [Escrituração fiscal](https://conota.dev/glossario/escrituracao-fiscal.md) - [Autorização de uso da NF-e](https://conota.dev/glossario/autorizacao-de-uso-da-nf-e.md) - [Esquema XML](https://conota.dev/glossario/esquema-xml.md) --- Fonte: [Ajuste SINIEF](https://conota.dev/glossario/ajuste-sinief/) · Atualizado em 2026-10-22 --- # Alíquota tributária > Alíquota tributária é o percentual (ou valor fixo) aplicado sobre a base de cálculo para determinar quanto de imposto deve ser pago em uma operação. Ela é definida em lei pelo ente responsável pelo tributo e aparece nos documentos fiscais, como NF-e, NFC-e e NFS-e, junto ao valor do imposto calculado. **Também conhecido como:** Alíquota, Alíquota do imposto, Percentual do imposto, Taxa do imposto, Tax rate **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** A ## Como a alíquota tributária funciona na prática? A alíquota é um dos dois ingredientes básicos do cálculo de qualquer imposto. O outro é a base de cálculo, que costuma ser o valor da venda, do serviço ou da mercadoria. A conta é simples: valor do imposto = base de cálculo × alíquota. Por exemplo, se um serviço custa R$ 1.000,00 e a alíquota do imposto é de 5%, o imposto devido é R$ 50,00. Se a alíquota mudar para 3%, o mesmo serviço passa a gerar R$ 30,00 de imposto. ## Qual a diferença entre alíquota e base de cálculo? A base de cálculo é o valor sobre o qual o imposto incide. A alíquota é o percentual aplicado sobre esse valor. Uma responde "sobre quanto" e a outra responde "quanto por cento". As duas podem mudar o resultado final. Uma redução de base de cálculo diminui o valor tributado, mesmo que a alíquota continue a mesma. Por isso, em um documento fiscal, ambos os campos precisam estar corretos e coerentes entre si. ## Quais tipos de alíquota existem? A mais comum é a alíquota ad valorem, expressa em percentual sobre um valor, como 12% sobre o preço de uma mercadoria. Existe também a alíquota específica, um valor fixo por unidade de medida, como um valor em reais por litro ou por quilo, usada em alguns produtos. Também é comum falar em alíquota nominal, que é a prevista em lei, e alíquota efetiva, que é o percentual realmente pago depois de descontos, reduções ou regras do regime tributário. Há ainda a alíquota zero, quando o imposto existe, mas o percentual aplicado é nulo. ## Quem define a alíquota de cada imposto? Cada imposto tem sua alíquota definida pelo ente que o cobra. O ICMS, por exemplo, tem alíquotas definidas pelos estados, com regras próprias para operações internas e interestaduais. O ISS, cobrado na prestação de serviços, é definido por cada município, em regra dentro de uma faixa entre 2% e 5%. Já impostos e contribuições como IPI, PIS e COFINS seguem regras federais. Empresas do Simples Nacional pagam vários tributos em uma guia única, com alíquota que varia conforme o faturamento e a atividade. Mesmo assim, em certas situações, alíquotas precisam ser informadas no documento fiscal, por exemplo, para fins de crédito de ICMS ou para o ISS da NFS-e. ## Onde a alíquota aparece nos documentos fiscais e por que ela importa na emissão? Na NF-e e na NFC-e, as alíquotas são informadas item a item, para cada imposto aplicável, junto com a base de cálculo, o CST ou CSOSN e o valor calculado. Na NFS-e, o destaque principal é a alíquota do ISS do município onde o imposto é devido. Quando a emissão é feita por uma API fiscal, normalmente o sistema da empresa, como um ERP ou uma plataforma de vendas, define a alíquota de cada item e a envia nos dados do documento. A API transmite as informações ao órgão autorizador e devolve o resultado. Alíquotas incoerentes com a base de cálculo, o valor do imposto ou o enquadramento tributário podem gerar rejeição ou, pior, um documento autorizado com imposto errado. ## Exemplos de Alíquota tributária - Uma clínica emite uma NFS-e de R$ 2.000,00 em um município cuja alíquota de ISS para aquele serviço é 2%. O valor do ISS destacado na nota é R$ 40,00. - Um e-commerce vende um produto de R$ 500,00 para um consumidor no próprio estado. O ERP aplica a alíquota interna de ICMS daquele produto e envia, pela API, a base de cálculo, a alíquota e o valor do imposto em cada item da NF-e. - Uma plataforma de gestão recebe a rejeição de uma nota porque o valor do ICMS informado não corresponde à multiplicação da base de cálculo pela alíquota. O time ajusta o arredondamento no cálculo e reenvia o documento. - Uma empresa do Simples Nacional calcula sua alíquota efetiva no mês para saber quanto realmente pagará de tributos sobre o faturamento, que é diferente da alíquota nominal da sua faixa. ## Perguntas frequentes ### Alíquota e imposto são a mesma coisa? Não. A alíquota é o percentual ou valor fixo usado no cálculo. O imposto é o valor em reais que resulta da aplicação da alíquota sobre a base de cálculo. ### A API fiscal calcula a alíquota automaticamente? Em geral, não. A definição da alíquota depende do produto, do serviço, do regime tributário e da localidade, e costuma ficar a cargo do sistema da empresa ou do seu contador. A API transmite os dados e retorna autorização ou rejeição. ### Por que a mesma venda pode ter alíquotas diferentes? Porque a alíquota varia conforme o tipo de produto ou serviço, o estado ou município envolvido, a natureza da operação, o regime tributário da empresa e eventuais benefícios fiscais. ### Errar a alíquota sempre causa rejeição da nota? Nem sempre. Algumas incoerências são barradas na validação, mas outras passam e a nota é autorizada com imposto errado. Nesse caso, pode ser necessário corrigir, cancelar ou complementar o documento, conforme as regras aplicáveis. ## Termos relacionados - [Base de cálculo](https://conota.dev/glossario/base-de-calculo.md) - [Base de cálculo do ICMS](https://conota.dev/glossario/base-de-calculo-do-icms.md) - [Base de cálculo do ISSQN](https://conota.dev/glossario/base-de-calculo-do-issqn.md) - [CST](https://conota.dev/glossario/cst.md) - [CSOSN](https://conota.dev/glossario/csosn.md) - [API fiscal](https://conota.dev/glossario/api-fiscal.md) --- Fonte: [Alíquota tributária](https://conota.dev/glossario/aliquota-tributaria/) · Atualizado em 2026-10-22 --- # Ambiente de homologação > Ambiente de homologação é o ambiente de testes oferecido por SEFAZ, prefeituras e provedores de API fiscal para simular a emissão de documentos como NF-e, NFC-e, NFS-e, CT-e e MDF-e. Os documentos passam por validações semelhantes às do ambiente real, mas não têm valor fiscal, o que permite testar integrações sem riscos tributários. **Também conhecido como:** Ambiente de testes, Homologação, Sandbox, Produção restrita, Sandbox environment **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** A ## O que é o ambiente de homologação na emissão fiscal? É uma espécie de cópia de treino do sistema oficial de emissão de notas. A empresa envia documentos fiscais de verdade, com estrutura e dados completos, e recebe respostas reais do órgão autorizador: autorização, rejeição ou erro de validação. A diferença é que nada do que é emitido ali vale perante o Fisco. Uma NF-e autorizada em homologação não acoberta a circulação de mercadoria, não gera obrigação de imposto e não aparece como documento válido para o destinatário. ## Para que serve o ambiente de homologação? Serve para validar uma integração antes de colocá-la em uso. Desenvolvedores de ERPs, plataformas de venda e marketplaces usam a homologação para conferir se o XML está bem montado, se os cálculos de impostos estão corretos e se o sistema trata bem as rejeições. Também é útil depois que a integração já está funcionando: para testar um novo tipo de operação, uma mudança de regra tributária, um novo CNPJ ou uma atualização de layout publicada pelos órgãos fiscais, sem arriscar emitir notas erradas para clientes reais. ## Como funciona o ambiente de homologação? Nos documentos eletrônicos estaduais, como NF-e, NFC-e, CT-e e MDF-e, o XML possui um campo que indica o ambiente de destino. Quando ele aponta para homologação, o documento é enviado aos servidores de teste da SEFAZ, que aplicam as regras de validação e devolvem o resultado. Mesmo em testes, normalmente é necessário um certificado digital válido do emitente para assinar o XML. Algumas regras são específicas desse ambiente, como a exigência de textos indicando que o documento foi emitido sem valor fiscal. Na NFS-e, a situação varia: alguns municípios oferecem ambiente de testes, outros não. No padrão nacional da NFS-e, o ambiente equivalente é chamado de produção restrita. ## Qual a diferença entre ambiente de homologação e ambiente de produção? O ambiente de produção é o oficial: os documentos emitidos nele têm validade jurídica, geram obrigações tributárias e só podem ser corrigidos por cancelamento, carta de correção ou outros procedimentos formais. Já a homologação é um espaço de testes, em que erros não trazem consequências fiscais. Em APIs fiscais, os dois ambientes costumam ter endereços ou credenciais separados. Por isso, ao concluir os testes, é preciso trocar a configuração com cuidado para não emitir notas reais por engano em homologação, nem notas de teste em produção. ## Como usar o ambiente de homologação em uma API fiscal? Em uma API fiscal, o sistema da empresa envia os dados da venda e a API monta, assina e transmite o documento ao órgão autorizador. Na homologação, todo esse fluxo é executado de ponta a ponta, incluindo o retorno de status, XML e PDF, permitindo verificar se o sistema reage corretamente a cada resposta. No Conota, a disponibilidade de homologação varia conforme o tipo de documento e o município, já que depende do ambiente oferecido por cada órgão. Vale conferir esse suporte antes de planejar os testes, principalmente para NFS-e. ## Exemplos de Ambiente de homologação - Um ERP que está começando a emitir NF-e envia notas em homologação para conferir se o cálculo de ICMS e os códigos CFOP estão corretos antes de liberar a funcionalidade aos clientes. - Uma plataforma de e-commerce testa em homologação como seu sistema trata rejeições da SEFAZ, simulando um destinatário com dados inválidos para ver se a mensagem de erro é exibida corretamente. - Uma transportadora integra a emissão de CT-e e MDF-e e valida em homologação todo o fluxo de autorização e encerramento do manifesto antes de usar o sistema em viagens reais. - Uma empresa de software de gestão usa a produção restrita da NFS-e nacional para testar a emissão de notas de serviço de um novo cliente sem gerar documentos válidos. ## Perguntas frequentes ### Nota emitida em homologação tem valor fiscal? Não. Documentos emitidos em homologação servem apenas para testes. Eles não acobertam operações, não geram impostos e não podem ser usados como comprovante fiscal perante clientes ou o Fisco. ### Preciso de certificado digital para usar a homologação? Na maioria dos casos, sim. O XML precisa ser assinado digitalmente mesmo em testes, por isso costuma ser exigido um certificado digital válido do emitente, como o certificado A1. ### Todo município oferece homologação para NFS-e? Não. A existência de ambiente de testes para NFS-e depende de cada prefeitura ou do padrão adotado. No padrão nacional, o ambiente de testes é chamado de produção restrita. ### Preciso cancelar notas emitidas em homologação? Não é obrigatório, pois elas não têm validade fiscal. Ainda assim, o cancelamento pode ser testado em homologação para validar esse fluxo no sistema. ## Termos relacionados - [Ambiente de produção](https://conota.dev/glossario/ambiente-de-producao.md) - [API fiscal](https://conota.dev/glossario/api-fiscal.md) - [Certificado digital A1](https://conota.dev/glossario/certificado-digital-a1.md) - [Autorização de uso da NF-e](https://conota.dev/glossario/autorizacao-de-uso-da-nf-e.md) - [API Key](https://conota.dev/glossario/api-key.md) - [Assinatura digital do XML](https://conota.dev/glossario/assinatura-digital-do-xml.md) --- Fonte: [Ambiente de homologação](https://conota.dev/glossario/ambiente-de-homologacao/) · Atualizado em 2026-10-22 --- # Ambiente de produção > Ambiente de produção é o ambiente oficial dos sistemas fiscais em que os documentos emitidos, como NF-e, NFS-e, NFC-e, CT-e e MDF-e, têm validade jurídica e efeitos tributários reais. Tudo o que é autorizado nele é registrado pela Secretaria da Fazenda ou pela prefeitura e gera obrigações para o emitente. **Também conhecido como:** Ambiente produtivo, Ambiente real, Produção, Production environment **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** A ## O que é o ambiente de produção na emissão fiscal? Na emissão de documentos fiscais eletrônicos, os órgãos autorizadores mantêm dois ambientes separados: um para testes e outro para uso real. O ambiente de produção é o real. Quando uma nota é autorizada nele, ela passa a existir oficialmente, com validade jurídica, e entra nos registros do fisco. Isso significa que a nota pode ser consultada pelo destinatário, gera tributos a recolher e precisa ser escriturada pela empresa. Não se trata de uma simulação: cada documento conta de verdade. ## Qual a diferença entre ambiente de produção e ambiente de homologação? O ambiente de homologação serve para testes. Nele, a empresa ou o desenvolvedor envia documentos para verificar se a integração funciona, se os dados estão corretos e como o sistema reage a rejeições. Os documentos emitidos ali não têm valor fiscal. No ambiente de produção, ao contrário, tudo tem efeito real. Por isso, o caminho recomendado é validar a integração primeiro em homologação e só depois passar a emitir em produção. Nos documentos eletrônicos, essa escolha costuma aparecer em um campo do próprio XML que indica o tipo de ambiente, e os endereços de envio também costumam ser diferentes. ## Quais cuidados tomar antes de emitir em produção? Antes de virar a chave, é importante conferir se o certificado digital está válido e corretamente cadastrado, se a empresa está habilitada como emitente junto ao estado ou ao município e se dados como CFOP, CST ou CSOSN e alíquotas estão configurados de acordo com a orientação contábil. Também vale testar em homologação os cenários mais comuns da operação, como vendas, devoluções e cancelamentos, além do tratamento de rejeições. Um erro em produção pode exigir cancelamento, carta de correção ou nova emissão, o que dá trabalho e pode ter prazos limitados. ## Como funciona o ambiente de produção em uma API fiscal? Em uma API fiscal, o ambiente geralmente é definido por configuração, por exemplo com credenciais ou chaves de API distintas para teste e para produção. Assim, o mesmo código de integração pode apontar para um ambiente ou outro sem grandes mudanças. No Conota, o sistema do cliente envia os dados da venda pela API e a plataforma acompanha o documento até a autorização no ambiente indicado, devolvendo XML, PDF e status. A disponibilidade de cada ambiente pode variar conforme o tipo de documento e o município, algo importante especialmente na NFS-e. ## É possível desfazer uma nota emitida em produção? Uma nota autorizada em produção não pode simplesmente ser apagada. O que existe são procedimentos previstos na legislação, como o cancelamento dentro do prazo permitido, a carta de correção para alguns tipos de erro ou a emissão de um documento de devolução ou estorno. As regras e prazos variam conforme o tipo de documento e o órgão autorizador. ## Exemplos de Ambiente de produção - Um ERP que acabou de concluir os testes de emissão de NF-e em homologação troca a configuração para o ambiente de produção e começa a emitir as notas reais de venda dos clientes. - Uma plataforma de e-commerce usa uma chave de API de testes durante o desenvolvimento e, no lançamento, passa a usar a chave de produção para que as NFC-e e NF-e emitidas tenham validade fiscal. - Uma transportadora emite um CT-e no ambiente de produção e percebe um erro no valor do frete; como o documento já é oficial, ela precisa seguir o procedimento de cancelamento ou correção previsto. - Uma software house mantém dois cadastros no Console da plataforma fiscal: um para homologação, onde roda testes automatizados, e outro para produção, onde ficam as emissões reais dos clientes. ## Perguntas frequentes ### Nota emitida em homologação vale como nota fiscal? Não. Documentos emitidos em homologação servem apenas para testes e não têm validade jurídica nem efeito tributário. Somente as notas autorizadas no ambiente de produção são oficiais. ### Preciso de certificado digital para emitir em produção? Na maioria dos documentos fiscais eletrônicos, sim. O XML precisa ser assinado com um certificado digital válido, geralmente do tipo A1 em integrações por API. Algumas prefeituras podem ter regras próprias para a NFS-e. ### Posso testar algo diretamente em produção? Não é recomendado. Qualquer documento autorizado em produção gera efeitos reais e pode precisar ser cancelado depois. Testes devem ser feitos no ambiente de homologação. ### Todos os municípios oferecem ambiente de produção e homologação para NFS-e? Nem sempre. Alguns municípios não disponibilizam ambiente de testes ou o oferecem com limitações. Por isso, é importante verificar a disponibilidade de cada município antes de planejar a integração. ## Termos relacionados - [Ambiente de homologação](https://conota.dev/glossario/ambiente-de-homologacao.md) - [API fiscal](https://conota.dev/glossario/api-fiscal.md) - [Autorização de uso da NF-e](https://conota.dev/glossario/autorizacao-de-uso-da-nf-e.md) - [Certificado digital A1](https://conota.dev/glossario/certificado-digital-a1.md) - [Cancelamento de documento fiscal](https://conota.dev/glossario/cancelamento-de-documento-fiscal.md) - [API Key](https://conota.dev/glossario/api-key.md) --- Fonte: [Ambiente de produção](https://conota.dev/glossario/ambiente-de-producao/) · Atualizado em 2026-10-22 --- # Antecipação tributária > Antecipação tributária é a cobrança de um tributo, geralmente o ICMS, antes do momento em que ele normalmente seria devido. Em vez de pagar o imposto só na venda ao consumidor, a empresa ou um terceiro recolhe o valor de forma adiantada, como na entrada de mercadorias vindas de outro estado, conforme regras de cada unidade da federação. **Também conhecido como:** Antecipação do ICMS, Antecipação de imposto, Antecipação parcial do ICMS, Recolhimento antecipado, Tax prepayment **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** A ## O que é antecipação tributária, em palavras simples? Normalmente, um imposto é pago quando acontece o fato que o gera, como a venda de uma mercadoria. Na antecipação tributária, a lei determina que parte ou todo o imposto seja pago antes disso, por exemplo, quando o produto ainda está entrando no estoque da loja. No Brasil, o caso mais comum envolve o ICMS, imposto estadual sobre circulação de mercadorias. Cada estado define quais produtos, operações e contribuintes estão sujeitos à antecipação, por isso as regras mudam bastante de um estado para outro. ## Para que serve a antecipação tributária? Para o governo, ela facilita a arrecadação e a fiscalização. É mais simples cobrar o imposto de poucos distribuidores ou na entrada da mercadoria no estado do que acompanhar milhares de vendas no varejo. Ela também ajuda a reduzir a sonegação e a equilibrar a concorrência entre empresas que compram mercadorias dentro do estado e as que compram de fornecedores de outros estados, onde a alíquota interestadual costuma ser menor. ## Como funciona a antecipação na prática? Um exemplo típico é a antecipação parcial do ICMS. Quando uma empresa compra mercadoria para revenda de outro estado, paga ao estado de destino a diferença entre a alíquota interna e a alíquota interestadual destacada na nota fiscal. Depois, na venda, o imposto segue a apuração normal, e o valor antecipado pode ser compensado como crédito pelas empresas do regime normal. Há também a antecipação com encerramento da tributação, em que o imposto de toda a cadeia é calculado de uma vez, usando uma base de cálculo presumida. Nesse caso, as vendas seguintes daquele produto já não geram novo ICMS a pagar. O recolhimento costuma ser feito por guia estadual ou por GNRE, quando o pagamento é devido a outro estado. ## Qual a diferença entre antecipação tributária e substituição tributária? Na antecipação, o próprio contribuinte paga o imposto mais cedo, como a loja que recolhe o ICMS ao receber a mercadoria. Na substituição tributária, a responsabilidade pelo pagamento é transferida para outra empresa da cadeia, geralmente o fabricante ou o importador, que recolhe o imposto em nome dos compradores seguintes. Na prática, a substituição tributária para frente também é uma forma de antecipação, pois o imposto das etapas futuras é pago adiantado. A diferença principal está em quem fica responsável pelo recolhimento. ## Qual a diferença entre antecipação tributária e DIFAL? O DIFAL é a diferença de alíquotas cobrada em operações interestaduais destinadas a consumidor final, seja uma pessoa física ou uma empresa que vai usar o bem, sem revendê-lo. A antecipação parcial, por outro lado, normalmente atinge mercadorias compradas para revenda. Os dois cálculos se parecem, porque comparam alíquota interna e interestadual, mas têm finalidades, fundamentos e regras de recolhimento diferentes. ## Como a antecipação tributária aparece nos documentos fiscais? Na NF-e, quando o imposto é antecipado por substituição tributária, os valores aparecem no grupo de tributação do ICMS, com códigos de CST ou CSOSN específicos e, em muitos casos, com o CEST do produto. Nas vendas seguintes de itens com imposto já recolhido antecipadamente, também há códigos próprios para indicar essa situação. Para sistemas que emitem notas por API, como ERPs e plataformas de venda, é essencial manter o cadastro tributário dos produtos correto. Um código errado pode gerar rejeição na SEFAZ ou, pior, uma nota autorizada com imposto calculado de forma incorreta. ## Exemplos de Antecipação tributária - Uma loja de roupas em um estado do Nordeste compra peças de um fornecedor de outro estado para revender. Ao receber a mercadoria, ela recolhe a antecipação parcial do ICMS, correspondente à diferença entre a alíquota interna do seu estado e a alíquota interestadual da nota. - Um distribuidor de autopeças vende produtos sujeitos à substituição tributária e emite a NF-e com o ICMS-ST destacado, antecipando o imposto que seria devido nas revendas seguintes. - Um ERP integrado a uma API fiscal identifica, pelo NCM e pelo CEST do produto, que o item já teve o ICMS recolhido antecipadamente e emite a NF-e de venda com o CST correspondente, sem cobrar o imposto novamente. - Uma empresa do Simples Nacional que compra mercadorias de outro estado precisa verificar se o seu estado exige antecipação parcial, pois o pagamento é feito à parte, fora do DAS. ## Perguntas frequentes ### Empresas do Simples Nacional pagam antecipação tributária? Podem pagar, dependendo da legislação do estado. A antecipação do ICMS é cobrada fora do DAS e, em regra, não gera crédito para a empresa do Simples Nacional, ao contrário do que ocorre no regime normal. ### A antecipação tributária é um imposto novo? Não. É apenas uma forma de cobrar um imposto já existente, geralmente o ICMS, em um momento anterior ao usual. O tributo é o mesmo; muda o momento e, às vezes, quem faz o recolhimento. ### O valor pago na antecipação pode ser recuperado? Depende do tipo. Na antecipação parcial, empresas do regime normal costumam aproveitar o valor como crédito. Na antecipação com encerramento da tributação, o imposto da cadeia é considerado pago e as vendas seguintes não geram novo débito. ### Como saber se um produto está sujeito à antecipação? É preciso consultar a legislação do estado de destino, que lista produtos, NCMs e operações sujeitas. Por variar muito entre estados, o ideal é validar com um contador e manter o cadastro tributário atualizado no sistema. ## Termos relacionados - [ICMS](https://conota.dev/glossario/icms.md) - [Fato gerador](https://conota.dev/glossario/fato-gerador.md) - [DIFAL](https://conota.dev/glossario/difal.md) - [GNRE](https://conota.dev/glossario/gnre.md) - [Diferimento do ICMS](https://conota.dev/glossario/diferimento-do-icms.md) - [Base de cálculo do ICMS](https://conota.dev/glossario/base-de-calculo-do-icms.md) --- Fonte: [Antecipação tributária](https://conota.dev/glossario/antecipacao-tributaria/) · Atualizado em 2026-10-22 --- # API fiscal > API fiscal é uma interface de programação que permite a sistemas como ERPs, lojas virtuais e marketplaces emitir, consultar e cancelar documentos fiscais eletrônicos, como NF-e, NFS-e, NFC-e, CT-e e MDF-e, de forma automática, sem que o usuário precise acessar portais da Sefaz ou das prefeituras manualmente. **Também conhecido como:** API de emissão fiscal, API de nota fiscal, API de notas fiscais eletrônicas, API para emissão de NF-e, Tax invoicing API **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** A ## O que é uma API fiscal, em palavras simples? Uma API fiscal funciona como uma ponte entre o sistema de uma empresa e os órgãos que autorizam documentos fiscais, como as Secretarias da Fazenda estaduais e as prefeituras. Em vez de alguém digitar os dados de cada nota em um site oficial, o próprio sistema envia essas informações para a API, que cuida do restante. API é a sigla em inglês para interface de programação de aplicações. Na prática, é um conjunto de endereços e regras que permitem que um software converse com outro de maneira padronizada, trocando dados de forma automática. ## Para que serve uma API fiscal? Ela serve para automatizar a emissão e a gestão de documentos fiscais. Quando uma venda é concluída em uma loja virtual ou um serviço é faturado em um ERP, o sistema chama a API, que gera o documento, assina digitalmente o XML, transmite ao órgão autorizador e devolve o resultado. Além da emissão, uma API fiscal costuma oferecer consulta de status, cancelamento, carta de correção, download de XML e PDF e tratamento de rejeições. Isso reduz erros de digitação, acelera o faturamento e libera a equipe de tarefas repetitivas. ## Como funciona uma API fiscal no dia a dia? O fluxo básico é: o sistema da empresa monta os dados da nota (emitente, destinatário, itens, impostos) e envia uma requisição à API, normalmente identificada por uma API Key ou Bearer token. A API valida os dados, monta o XML no layout exigido, assina com o certificado digital A1 da empresa e transmite ao órgão responsável. Em seguida, a API acompanha o processamento até a autorização ou rejeição e devolve o status, a chave de acesso, o XML autorizado e o documento auxiliar em PDF, como DANFE ou DANFCE. Muitas APIs avisam o sistema automaticamente por notificações, sem que ele precise ficar consultando. ## Quais documentos uma API fiscal pode emitir? Depende do fornecedor, mas os mais comuns são a NF-e (venda de produtos), a NFC-e (varejo ao consumidor final), a NFS-e (serviços, emitida conforme regras de cada município ou do padrão nacional), o CT-e (transporte de cargas) e o MDF-e (manifesto que acompanha o transporte). A disponibilidade pode variar conforme o documento, o município e o ambiente suportado, especialmente no caso da NFS-e, em que cada prefeitura pode ter regras e sistemas próprios. ## Qual a diferença entre usar uma API fiscal e integrar direto com a Sefaz? Integrar direto exige que a própria empresa desenvolva e mantenha a geração do XML, a assinatura digital, a comunicação com cada webservice, o tratamento de rejeições e as atualizações de layout. É trabalhoso, sobretudo quando envolve vários estados e centenas de prefeituras com padrões diferentes. Com uma API fiscal, o sistema faz uma única integração e o fornecedor absorve essa complexidade técnica. A responsabilidade pelas informações fiscais, como CFOP, CST e alíquotas corretas, continua sendo da empresa emissora. ## Como uma API fiscal se relaciona com agentes de inteligência artificial? Algumas APIs fiscais oferecem acesso via MCP, um protocolo que permite a agentes de IA consultar documentos e executar ações autorizadas. Assim, um assistente pode verificar o status de uma nota ou listar rejeições, sempre dentro de permissões controladas e com registro para auditoria. ## Exemplos de API fiscal - Um marketplace integra uma API fiscal para emitir automaticamente a NF-e de cada pedido aprovado, recebendo de volta o XML e o DANFE para enviar ao comprador. - Um software de gestão para clínicas usa a API fiscal para emitir NFS-e em diferentes municípios, sem precisar desenvolver uma integração para cada prefeitura. - Uma transportadora conecta seu sistema a uma API fiscal para emitir CT-e e MDF-e antes de cada viagem e acompanhar a autorização em tempo real. - Um ERP que atende vários clientes gerencia certificados e rejeições de dezenas de CNPJs em um único painel, com todas as emissões feitas pela mesma API. ## Perguntas frequentes ### Preciso de certificado digital para usar uma API fiscal? Sim, na maioria dos casos. Documentos como NF-e, NFC-e, CT-e e MDF-e exigem assinatura com certificado digital, geralmente do tipo A1, que é enviado à API para que ela assine o XML em nome da empresa. ### Posso testar a API fiscal sem emitir notas válidas? Sim. As APIs fiscais costumam oferecer um ambiente de homologação, onde os documentos são processados sem valor fiscal. Depois dos testes, a integração passa a usar o ambiente de produção. ### A API fiscal calcula os impostos sozinha? Depende do fornecedor. Em geral, a API valida e transmite os dados, mas a definição de regras tributárias, como CST, CSOSN, CFOP e alíquotas, continua sendo responsabilidade da empresa ou do seu contador. ### API fiscal serve para empresas pequenas? Serve para qualquer empresa que tenha um sistema próprio ou plataforma de vendas e queira automatizar a emissão. É especialmente útil para quem desenvolve software e precisa emitir notas para vários clientes. ## Termos relacionados - [API REST para emissão fiscal](https://conota.dev/glossario/api-rest-para-emissao-fiscal.md) - [Arquivo XML fiscal](https://conota.dev/glossario/arquivo-xml-fiscal.md) - [Assinatura digital do XML](https://conota.dev/glossario/assinatura-digital-do-xml.md) - [Certificado digital A1](https://conota.dev/glossario/certificado-digital-a1.md) - [Ambiente de homologação](https://conota.dev/glossario/ambiente-de-homologacao.md) - [Conota MCP](https://conota.dev/glossario/conota-mcp.md) --- Fonte: [API fiscal](https://conota.dev/glossario/api-fiscal/) · Atualizado em 2026-10-22 --- # API Key > API Key é uma chave de acesso, geralmente uma sequência longa de letras e números, que identifica e autoriza um sistema a usar uma API. Funciona como uma senha entre máquinas: quem envia a chave em cada requisição prova que tem permissão para consultar dados ou executar ações, como emitir notas fiscais. **Também conhecido como:** Chave de API, Chave de acesso à API, Token de API, API key, Apikey, API Key **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** A ## Para que serve uma API Key? A API Key serve para responder a duas perguntas sempre que um sistema conversa com uma API: quem está fazendo o pedido e se ele tem permissão para isso. Sem essa identificação, qualquer pessoa que descobrisse o endereço da API poderia usá-la. Em uma API fiscal, isso é ainda mais importante. A chave impede que terceiros emitam, cancelem ou baixem notas fiscais em nome da sua empresa. Ela também permite que o provedor saiba qual conta está consumindo o serviço, aplique os limites do plano e registre as operações realizadas. ## Como funciona uma API Key na prática? O fluxo costuma ser simples. Primeiro, a chave é gerada em um painel de gestão, como um console do provedor. Depois, o desenvolvedor configura essa chave no sistema da empresa, por exemplo, no ERP ou na plataforma de vendas. A partir daí, toda requisição enviada à API leva a chave junto, normalmente em um cabeçalho HTTP indicado na documentação. O servidor confere se a chave existe, se está ativa e se tem permissão para aquela ação. Se estiver tudo certo, o pedido é processado; caso contrário, a API devolve um erro de autenticação ou de acesso negado. Por exemplo: quando o ERP envia os dados de uma venda para gerar uma NF-e, a API Key garante que aquele pedido realmente veio do sistema autorizado da empresa. ## Qual a diferença entre API Key e Bearer token? A API Key é uma credencial fixa, que continua válida até ser revogada ou substituída. Ela identifica o sistema ou a conta que está acessando a API. O Bearer token é um formato de envio de credencial: quem apresenta (em inglês, bearer, o portador) o token recebe acesso. Muitas vezes ele é temporário, gerado a partir de um login ou de outra credencial, e expira depois de algum tempo. Em algumas APIs, a própria API Key é enviada no formato de Bearer token, por isso os dois termos às vezes aparecem juntos. ## Por que existem chaves diferentes para homologação e produção? Muitas APIs fiscais separam o ambiente de testes, chamado de homologação, do ambiente real, chamado de produção. Em homologação, os documentos emitidos não têm valor fiscal; em produção, cada nota autorizada passa a valer perante o Fisco. Ter chaves diferentes para cada ambiente evita acidentes, como emitir uma nota real durante um teste ou tentar validar uma integração usando dados de produção. Antes de colocar a integração no ar, vale conferir se o sistema está usando a chave do ambiente correto. ## Como guardar uma API Key com segurança? A API Key deve ser tratada como uma senha. Ela não deve aparecer no código de aplicativos ou sites que rodam no navegador do usuário, não deve ser enviada por e-mail ou chat e não deve ser salva em repositórios de código. O ideal é guardá-la em variáveis de ambiente ou em um cofre de segredos no servidor. Outras boas práticas são criar chaves separadas para cada sistema ou integração, dar a cada uma apenas as permissões necessárias e trocar a chave periodicamente. Se houver suspeita de vazamento, a chave deve ser revogada imediatamente e substituída por uma nova. ## API Keys também são usadas por agentes de inteligência artificial? Sim. Quando um agente de IA acessa uma plataforma por meio de MCP (Model Context Protocol), ele também precisa de uma credencial para provar que está autorizado. Nesse caso, é especialmente importante limitar o que a chave permite fazer, por exemplo, liberar apenas consultas de documentos ou apenas ações específicas, e manter registro das operações para auditoria. ## Exemplos de API Key - Uma software house gera uma API Key no console do provedor fiscal e a configura no servidor do seu ERP, permitindo que o sistema emita NF-e automaticamente a cada pedido faturado. - Um marketplace usa uma API Key de homologação para testar a emissão de NFS-e e, depois de validar os resultados, troca para a chave de produção. - Após um desenvolvedor publicar por engano uma API Key em um repositório público, a equipe revoga a chave no painel e cria uma nova, evitando o uso indevido da conta. - Uma empresa cria uma chave com permissão apenas de leitura para que um agente de IA consulte o status de notas fiscais sem poder emitir ou cancelar documentos. ## Perguntas frequentes ### API Key é a mesma coisa que certificado digital? Não. A API Key autoriza seu sistema a usar a API do provedor. O certificado digital, como o A1, identifica juridicamente a empresa e é usado para assinar os documentos fiscais enviados ao Fisco. Em uma integração fiscal, normalmente os dois são necessários. ### O que acontece se minha API Key vazar? Quem tiver a chave poderá fazer requisições em nome da sua conta, dentro das permissões dela. O correto é revogar a chave imediatamente, gerar uma nova, atualizá-la nos sistemas e verificar os registros de uso em busca de operações suspeitas. ### Posso usar a mesma API Key em vários sistemas? Tecnicamente pode ser possível, mas não é recomendado. Chaves separadas por sistema facilitam identificar a origem de cada requisição e permitem revogar o acesso de uma integração sem interromper as demais. ### A API Key expira? Depende do provedor. Muitas API Keys valem até serem revogadas, mas algumas plataformas definem prazo de validade. Mesmo sem expiração automática, trocar a chave periodicamente é uma boa prática de segurança. ## Termos relacionados - [Bearer token](https://conota.dev/glossario/bearer-token.md) - [API fiscal](https://conota.dev/glossario/api-fiscal.md) - [API REST para emissão fiscal](https://conota.dev/glossario/api-rest-para-emissao-fiscal.md) - [Ambiente de homologação](https://conota.dev/glossario/ambiente-de-homologacao.md) - [Ambiente de produção](https://conota.dev/glossario/ambiente-de-producao.md) - [Conota MCP](https://conota.dev/glossario/conota-mcp.md) --- Fonte: [API Key](https://conota.dev/glossario/api-key/) · Atualizado em 2026-10-22 --- # API REST para emissão fiscal > API REST para emissão fiscal é uma interface de programação que permite a um sistema, como um ERP ou uma loja virtual, emitir documentos fiscais eletrônicos (NF-e, NFS-e, NFC-e, CT-e, MDF-e) enviando requisições HTTP com dados em JSON. A API transforma esses dados no XML exigido, assina, transmite ao órgão autorizador e devolve o resultado. **Também conhecido como:** API de emissão de notas fiscais, API REST fiscal, API de nota fiscal eletrônica, API para emissão de NF-e, REST API for tax invoice issuance **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** A ## O que significa REST em uma API de emissão fiscal? REST é um estilo de construção de APIs que usa os recursos da própria web. Cada coisa que o sistema manipula, como uma nota fiscal, uma empresa ou um certificado, é tratada como um recurso com um endereço próprio (URL). As ações são feitas com os métodos padrão do protocolo HTTP: POST para criar, por exemplo, uma nova nota; GET para consultar seu status; e outros métodos para ações como cancelamento. As respostas costumam vir em JSON, um formato de texto simples que praticamente toda linguagem de programação entende. ## Como funciona a emissão de uma nota por API REST? O sistema do cliente monta os dados da venda (emitente, destinatário, itens, valores e tributos) e envia em uma requisição POST para a API, autenticando-se com uma credencial, como uma API Key ou um Bearer token. A API valida os dados, gera o XML no layout oficial, aplica a assinatura digital com o certificado da empresa e transmite o documento para a SEFAZ ou para a prefeitura, conforme o tipo de nota. Em seguida, acompanha o processamento até a autorização ou rejeição. O resultado volta para o sistema de origem: status, chave de acesso, XML autorizado e PDF do documento auxiliar, como o DANFE. Isso pode acontecer por consulta (o sistema pergunta o status) ou por notificação automática, quando a API avisa assim que há novidade. ## Por que usar uma API REST em vez de integrar direto com a SEFAZ e as prefeituras? Os serviços oficiais de autorização usam padrões técnicos mais antigos e detalhados, como mensagens XML em web services SOAP, exigências específicas de assinatura e regras que mudam com notas técnicas. No caso da NFS-e, ainda há variações entre municípios. Uma API REST para emissão fiscal funciona como uma camada intermediária que esconde essa complexidade. O time de desenvolvimento trabalha com um único formato, mais simples, e a API cuida das diferenças entre documentos, estados e municípios. Isso reduz o tempo de integração e o esforço de manutenção quando as regras fiscais mudam. ## Qual a diferença entre API REST para emissão fiscal e biblioteca de emissão? Uma biblioteca de emissão fiscal é um código instalado dentro do próprio sistema. Ela ajuda a gerar e transmitir o XML, mas a empresa continua responsável por servidores, atualizações, certificados e tratamento de falhas de comunicação. Já a API REST é um serviço externo acessado pela internet. A infraestrutura de emissão, as atualizações de layout e o acompanhamento dos documentos ficam com o provedor da API, enquanto o sistema do cliente se concentra no próprio negócio. ## Quais cuidados técnicos são importantes ao integrar? Primeiro, testar tudo no ambiente de homologação, onde as notas não têm valor fiscal, antes de passar ao ambiente de produção. Segundo, proteger as credenciais de acesso e nunca expô-las no código do lado do navegador. Também é importante tratar falhas temporárias com novas tentativas espaçadas, como no backoff exponencial, e evitar emitir a mesma nota duas vezes caso uma requisição seja repetida. Por fim, o sistema deve saber lidar com rejeições, exibindo o motivo para correção, e guardar o XML autorizado pelo prazo exigido pela legislação. ## Exemplos de API REST para emissão fiscal - Um ERP de distribuidora envia um POST com os itens de um pedido faturado e, segundos depois, recebe a NF-e autorizada com chave de acesso, XML e DANFE para anexar ao pedido. - Uma plataforma de agendamento para clínicas emite automaticamente a NFS-e de cada consulta paga, usando a mesma integração para clientes em municípios diferentes. - Um sistema de PDV transmite a NFC-e no momento da venda e imprime o DANFCE com o QR Code retornado pela API. - Um software de gestão de transportadoras emite o CT-e de cada frete e, ao fechar a viagem, o MDF-e vinculando esses conhecimentos, tudo pela mesma API. ## Perguntas frequentes ### Preciso de certificado digital para usar uma API REST de emissão fiscal? Sim, na maioria dos documentos. O XML precisa ser assinado com o certificado da empresa emitente, geralmente o modelo A1. Normalmente o certificado é cadastrado uma vez na plataforma da API, que passa a usá-lo nas assinaturas. ### É preciso conhecer o layout XML da NF-e para integrar? Não em detalhe. A API recebe os dados em JSON e monta o XML oficial. Porém, é preciso conhecer as informações fiscais da operação, como CFOP, CST ou CSOSN e alíquotas, pois elas definem o conteúdo da nota. ### Uma mesma API REST serve para NF-e, NFS-e e CT-e? Depende do provedor. Algumas APIs atendem vários documentos com uma única integração, mudando apenas o recurso chamado e os dados enviados. A disponibilidade pode variar por documento, município e ambiente. ### Agentes de inteligência artificial podem usar essa API? Podem, desde que haja um canal adequado. Protocolos como o MCP permitem que agentes consultem documentos e executem ações autorizadas, com permissões controladas e registro das operações para auditoria. ## Termos relacionados - [API fiscal](https://conota.dev/glossario/api-fiscal.md) - [Bearer token](https://conota.dev/glossario/bearer-token.md) - [API Key](https://conota.dev/glossario/api-key.md) - [Ambiente de homologação](https://conota.dev/glossario/ambiente-de-homologacao.md) - [Arquivo XML fiscal](https://conota.dev/glossario/arquivo-xml-fiscal.md) - [Backoff exponencial](https://conota.dev/glossario/backoff-exponencial.md) --- Fonte: [API REST para emissão fiscal](https://conota.dev/glossario/api-rest-para-emissao-fiscal/) · Atualizado em 2026-10-22 --- # Aproveitamento de crédito tributário > Aproveitamento de crédito tributário é o direito de uma empresa abater, do imposto devido sobre suas vendas ou serviços, o valor do mesmo tributo já pago nas etapas anteriores, como na compra de mercadorias e insumos. Ele decorre do princípio da não cumulatividade e se aplica a tributos como ICMS, IPI, PIS, COFINS, IBS e CBS. **Também conhecido como:** Crédito de imposto, Creditamento tributário, Apropriação de crédito tributário, Tomada de crédito, Compensação de créditos na apuração, Tax credit utilization **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** A ## Para que serve o aproveitamento de crédito tributário? Ele serve para evitar que o mesmo imposto seja cobrado várias vezes ao longo da cadeia produtiva, o chamado efeito cascata. Sem o crédito, um produto que passa pelo fabricante, pelo distribuidor e pelo varejista carregaria o imposto de cada etapa somado ao das anteriores. Com o aproveitamento, cada empresa paga apenas sobre o valor que acrescentou ao produto ou serviço. Isso reduz o custo tributário real do negócio e torna a carga final mais transparente para quem compra. ## Como funciona o aproveitamento de crédito na prática? A lógica é de débitos e créditos. Quando a empresa compra uma mercadoria, o imposto destacado na nota fiscal de compra vira crédito. Quando ela vende, o imposto destacado na nota de venda vira débito. No fim do período de apuração, ela paga a diferença entre os dois. Em um exemplo hipotético: uma loja compra produtos com 18 reais de ICMS destacados na NF-e do fornecedor e depois os revende com 27 reais de ICMS na sua própria nota. Ao apurar, ela recolhe apenas 9 reais, pois os 18 já pagos na compra são abatidos. Se os créditos forem maiores que os débitos, o saldo pode ser transportado para os períodos seguintes, conforme as regras do tributo. ## Quais tributos permitem aproveitamento de crédito? Os principais são o ICMS, imposto estadual sobre circulação de mercadorias e alguns serviços, e o IPI, imposto federal sobre produtos industrializados. PIS e COFINS também geram crédito quando a empresa está no regime não cumulativo, em geral associado ao Lucro Real. No Lucro Presumido, PIS e COFINS costumam seguir o regime cumulativo, sem créditos. Na reforma tributária do consumo, o IBS e a CBS foram desenhados com não cumulatividade ampla, permitindo crédito sobre a maior parte das aquisições. Já o ISSQN, imposto municipal sobre serviços, em regra não funciona por créditos: ele incide sobre o valor do serviço prestado. ## Qual a relação entre a nota fiscal e o crédito tributário? A nota fiscal é a prova do direito ao crédito. É no XML da NF-e de compra que aparecem a base de cálculo, a alíquota, o valor do imposto destacado e o código de situação tributária (CST ou CSOSN). Se esses campos vierem errados, ausentes ou com tributação incompatível, o comprador pode perder o crédito ou ter problemas em uma fiscalização. Por isso, a qualidade dos dados enviados na emissão é decisiva. Um ERP que monta o payload da nota com o grupo de tributação correto garante que o cliente consiga escriturar o documento e aproveitar o crédito. Do outro lado, recuperar e importar os XMLs recebidos de fornecedores alimenta a escrituração fiscal de entradas, onde o crédito é efetivamente registrado. ## Quem pode aproveitar crédito e quais são as restrições? O direito depende do regime tributário e da finalidade da compra. Empresas optantes pelo Simples Nacional, em geral, não aproveitam créditos dos tributos que recolhem pelo regime unificado, mas podem, em situações previstas, transferir crédito de ICMS ao comprador, informando o percentual e o valor permitidos na NF-e com o CSOSN adequado. Há também restrições comuns: itens de uso e consumo próprio costumam não gerar crédito de ICMS, compras para o ativo imobilizado podem ter o crédito aproveitado em parcelas ao longo do tempo, e mercadorias sujeitas à substituição tributária geralmente não geram crédito do imposto retido para o revendedor. As regras específicas variam por tributo e por estado, e devem ser confirmadas com a contabilidade. ## Exemplos de Aproveitamento de crédito tributário - Uma indústria que compra matéria-prima com IPI e ICMS destacados na NF-e do fornecedor registra esses valores como crédito e os abate do imposto devido na venda do produto acabado. - Um ERP integrado a uma API fiscal emite NF-e de uma empresa optante pelo Simples Nacional com CSOSN 101, informando o percentual e o valor de crédito de ICMS que o cliente comprador poderá aproveitar. - Um atacadista no Lucro Real usa os XMLs de compras obtidos pela distribuição de DF-e para apurar créditos de PIS e COFINS no regime não cumulativo. - Uma plataforma de gestão corrige o CST de um produto que estava sendo emitido como isento, para que os clientes do vendedor voltem a ter direito ao crédito de ICMS destacado. ## Perguntas frequentes ### Empresa do Simples Nacional pode aproveitar crédito tributário? Em regra, não aproveita créditos dos tributos pagos pelo regime unificado. Porém, em situações permitidas, pode transferir crédito de ICMS aos compradores, desde que informe corretamente o percentual e o valor na NF-e. ### O que acontece se a nota fiscal de compra vier com erro no imposto? O comprador pode ter o crédito negado ou glosado em uma fiscalização. Dependendo do erro, pode ser necessário solicitar ao fornecedor uma nota complementar, uma carta de correção, quando cabível, ou um novo documento. ### O ISSQN gera crédito para quem contrata o serviço? Em regra, não. O ISSQN é um imposto cumulativo, cobrado sobre o valor do serviço prestado, sem sistema de débitos e créditos. Situações diferentes, como a retenção, não se confundem com aproveitamento de crédito. ### Crédito tributário é o mesmo que restituição de imposto? Não. O aproveitamento é o abatimento do imposto pago nas compras do imposto devido nas vendas, dentro da apuração. Restituição é a devolução de valores pagos indevidamente ou a maior, por outro procedimento. ## Termos relacionados - [ICMS](https://conota.dev/glossario/icms.md) - [IPI](https://conota.dev/glossario/ipi.md) - [PIS](https://conota.dev/glossario/pis.md) - [Escrituração fiscal](https://conota.dev/glossario/escrituracao-fiscal.md) - [CSOSN](https://conota.dev/glossario/csosn.md) - [Regime tributário](https://conota.dev/glossario/regime-tributario.md) --- Fonte: [Aproveitamento de crédito tributário](https://conota.dev/glossario/aproveitamento-de-credito-tributario/) · Atualizado em 2026-10-22 --- # Apuração de tributos > Apuração de tributos é o processo de calcular quanto uma empresa deve pagar de cada imposto em determinado período. Para isso, ela reúne as operações registradas nos documentos fiscais, aplica bases de cálculo e alíquotas, desconta os créditos permitidos e chega ao valor a recolher ou a um saldo credor que pode ser usado depois. **Também conhecido como:** Apuração fiscal, Apuração de impostos, Apuração tributária, Cálculo de impostos, Tax computation **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** A ## O que significa apurar um tributo? Apurar um tributo é fechar a conta de um imposto em um período definido, como um mês ou um trimestre. Durante esse período, a empresa vende, compra, presta e contrata serviços. Cada operação pode gerar imposto a pagar ou direito a crédito. A apuração organiza tudo isso e responde a uma pergunta simples: quanto devo recolher agora? Cada tributo tem sua própria apuração. O ICMS é apurado separadamente do IPI, do PIS, da COFINS e do ISSQN, porque cada um segue regras, alíquotas e prazos diferentes. Por isso, uma mesma empresa costuma fazer várias apurações no mesmo período. ## Como funciona a apuração na prática? Nos tributos que permitem crédito, a lógica lembra um extrato bancário. De um lado ficam os débitos, que são os impostos destacados nas vendas e prestações de serviço. Do outro ficam os créditos, que são os impostos pagos nas compras de insumos e mercadorias que a lei permite aproveitar. Ao final do período, a empresa subtrai os créditos dos débitos. Se os débitos forem maiores, a diferença é o valor a recolher por meio da guia correspondente. Se os créditos forem maiores, sobra um saldo credor, que normalmente pode ser transportado para o período seguinte, conforme as regras de cada tributo. Além dessa conta principal, entram ajustes: estornos de crédito, benefícios fiscais, valores retidos por terceiros, substituição tributária e diferencial de alíquota, entre outros. ## Qual a diferença entre apuração cumulativa e não cumulativa? Na apuração não cumulativa, a empresa desconta o imposto já pago nas etapas anteriores da cadeia. É o caso do ICMS, do IPI e do PIS e COFINS no regime não cumulativo. Assim, o imposto incide apenas sobre o valor que a empresa agregou. Na apuração cumulativa, não há desconto de créditos: aplica-se a alíquota sobre a receita ou o valor da operação e pronto. É o que acontece, por exemplo, com o PIS e a COFINS no regime cumulativo e, em geral, com o ISSQN. O cálculo é mais simples, mas o imposto se acumula ao longo da cadeia. ## Como o regime tributário influencia a apuração? No Simples Nacional, a apuração é mensal e unificada: a empresa informa sua receita bruta, aplica a alíquota efetiva da sua faixa e paga vários tributos em uma única guia, o DAS. Mesmo assim, algumas situações, como substituição tributária e DIFAL, podem exigir cálculos à parte. No Lucro Presumido e no Lucro Real, cada tributo é apurado individualmente. IRPJ e CSLL têm apuração trimestral ou anual, enquanto ICMS, IPI, PIS e COFINS costumam ser apurados mensalmente. O Lucro Real exige o controle mais detalhado, porque o imposto de renda depende do lucro contábil ajustado e o PIS e a COFINS seguem a regra não cumulativa. ## Qual a relação entre a emissão de notas fiscais e a apuração? A apuração depende diretamente dos documentos fiscais. Os XMLs de NF-e, NFC-e, NFS-e, CT-e e outros trazem a base de cálculo, a alíquota, o CST ou CSOSN, o CFOP e o valor de cada imposto. São esses dados que alimentam a escrituração fiscal e, a partir dela, a apuração. Quando um ERP ou plataforma de vendas emite notas por uma API fiscal, a qualidade da apuração começa na emissão. Uma nota com CFOP errado ou alíquota incorreta gera débito ou crédito errado, e o problema aparece no fechamento do mês. Ter os XMLs autorizados organizados por empresa e período também facilita conferir e importar os dados no sistema contábil. ## Que erros mais comprometem a apuração? Os erros mais comuns são classificação tributária incorreta dos produtos, uso de CST ou CFOP inadequado, notas canceladas que continuam sendo consideradas, documentos de entrada não lançados e créditos aproveitados sem permissão legal. Cada um distorce o saldo final. As consequências vão de pagar imposto a mais até recolher a menos e receber autuação, com multa e juros. Por isso, conferir os documentos emitidos e recebidos antes de fechar o período é uma etapa importante da rotina fiscal. ## Exemplos de Apuração de tributos - Uma distribuidora fecha o mês com R$ 50 mil de ICMS destacado em suas vendas e R$ 32 mil de ICMS creditado nas compras de mercadorias. Na apuração, recolhe a diferença de R$ 18 mil. - Uma prestadora de serviços no Simples Nacional soma o faturamento das NFS-e emitidas no mês, aplica a alíquota efetiva da sua faixa e gera um único DAS com os tributos devidos. - Um ERP integrado ao emissor fiscal exporta os XMLs de NF-e autorizados no mês para o escritório contábil, que importa os dados na EFD ICMS/IPI e faz a apuração do ICMS e do IPI. - Uma indústria percebe, ao conferir a apuração, que notas canceladas estavam sendo somadas como venda e corrige os débitos antes de gerar a guia de recolhimento. ## Perguntas frequentes ### Quem faz a apuração de tributos? Normalmente o setor fiscal da empresa ou o escritório de contabilidade, com apoio de sistemas que leem os documentos fiscais. A responsabilidade legal pelo valor apurado e recolhido, porém, é sempre da empresa contribuinte. ### Apuração e escrituração fiscal são a mesma coisa? Não. A escrituração é o registro organizado das operações e documentos fiscais. A apuração é o cálculo feito a partir desses registros para chegar ao imposto devido. Na prática, as duas andam juntas e a apuração costuma constar nos próprios arquivos de escrituração. ### O que acontece se a apuração estiver errada? Se o erro gerar pagamento a menor, a empresa pode ser autuada e pagar a diferença com multa e juros. Se gerar pagamento a maior, pode pedir restituição ou compensação. Em muitos casos é possível retificar a declaração antes de uma fiscalização. ### Emitir notas por API muda a forma de apurar tributos? As regras de apuração continuam as mesmas. A diferença é que a emissão automatizada padroniza os dados e entrega os XMLs de forma organizada, o que reduz erros de digitação e facilita a conferência no fechamento do período. ## Termos relacionados - [Escrituração fiscal](https://conota.dev/glossario/escrituracao-fiscal.md) - [Aproveitamento de crédito tributário](https://conota.dev/glossario/aproveitamento-de-credito-tributario.md) - [Balanço de créditos e débitos de ICMS](https://conota.dev/glossario/balanco-de-creditos-e-debitos-de-icms.md) - [Base de cálculo](https://conota.dev/glossario/base-de-calculo.md) - [Fato gerador](https://conota.dev/glossario/fato-gerador.md) --- Fonte: [Apuração de tributos](https://conota.dev/glossario/apuracao-de-tributos/) · Atualizado em 2026-10-22 --- # Área de Livre Comércio > Área de Livre Comércio é uma região delimitada do território brasileiro, geralmente em cidades de fronteira da Região Norte, onde operações com mercadorias recebem tratamento tributário diferenciado, como isenção ou suspensão de tributos. O objetivo é estimular o desenvolvimento local, e as vendas para essas áreas exigem cuidados específicos na emissão da nota fiscal. **Também conhecido como:** ALC, Áreas de Livre Comércio, Free Trade Area **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** A ## O que é uma Área de Livre Comércio? Uma Área de Livre Comércio, conhecida pela sigla ALC, é um território criado por lei federal em que a compra e a venda de mercadorias têm regras fiscais mais vantajosas que no restante do país. Essas áreas ficam principalmente em municípios de fronteira da Amazônia, como Tabatinga, Guajará-Mirim, Macapá e Santana. A ideia é compensar o isolamento geográfico dessas regiões, atrair comércio e gerar empregos. As ALCs são acompanhadas pela SUFRAMA, a autarquia federal que também administra a Zona Franca de Manaus. ## Quais benefícios fiscais existem nas Áreas de Livre Comércio? Os benefícios mais conhecidos envolvem o IPI e o ICMS. Mercadorias que entram na área podem ter o IPI suspenso ou isento, e vendas vindas de outros estados podem ter isenção de ICMS, desde que cumpridas as condições previstas na legislação. Em determinadas situações, também há tratamento diferenciado para PIS e COFINS. Os benefícios não valem para qualquer produto nem para qualquer comprador. Existem listas de mercadorias excluídas e exigências de cadastro, por isso cada operação precisa ser analisada antes da emissão. ## Qual a diferença entre Área de Livre Comércio e Zona Franca de Manaus? A Zona Franca de Manaus é um polo maior, com forte foco industrial, além do comercial. As Áreas de Livre Comércio são regiões menores, voltadas sobretudo ao comércio e ao abastecimento local, com benefícios parecidos, porém em geral mais restritos. Na prática fiscal, as duas compartilham vários procedimentos, como a exigência de Inscrição SUFRAMA do destinatário e o uso de CFOPs específicos para vendas destinadas a essas regiões. ## Como a Área de Livre Comércio afeta a emissão da NF-e? Quando uma empresa vende para um cliente localizado em ALC, a NF-e precisa trazer informações que comprovem o direito ao benefício. Entre elas estão a Inscrição SUFRAMA do destinatário, o CFOP adequado (como 6.109 ou 6.110, usados em vendas destinadas à Zona Franca de Manaus ou às Áreas de Livre Comércio) e o valor do ICMS desonerado, com o motivo de desoneração correspondente à SUFRAMA. Depois da emissão, a entrada da mercadoria na área costuma passar por um procedimento de registro e vistoria junto à SUFRAMA, conhecido como internação. Sem essa comprovação, o benefício pode ser questionado pelo fisco e o imposto cobrado depois. ## Como sistemas próprios lidam com vendas para Áreas de Livre Comércio? ERPs e plataformas de venda precisam identificar automaticamente quando o comprador está em uma ALC, verificar se ele tem Inscrição SUFRAMA válida e aplicar as regras tributárias corretas no item. Erros nesses campos são uma causa comum de rejeição da nota ou de autuação posterior. Com uma API fiscal, o sistema envia os dados da venda já com a tributação definida, e a infraestrutura de emissão cuida da validação, da transmissão à SEFAZ e do retorno do XML, do PDF e do status, inclusive informando rejeições ligadas a esses campos. ## Exemplos de Área de Livre Comércio - Uma distribuidora de São Paulo vende eletrodomésticos para uma loja em Macapá com Inscrição SUFRAMA ativa e emite a NF-e com CFOP 6.110, informando o ICMS desonerado. - Uma indústria de alimentos fabrica produtos próprios e os vende para um mercado em Tabatinga, usando o CFOP 6.109 na nota fiscal. - O ERP de um atacadista bloqueia a aplicação do benefício porque o cliente localizado em Guajará-Mirim não possui Inscrição SUFRAMA cadastrada, emitindo a nota com tributação normal. - Um marketplace integrado a uma API fiscal recebe uma rejeição da SEFAZ por inconsistência no valor do ICMS desonerado em uma venda para ALC e corrige o cálculo antes de reenviar. ## Perguntas frequentes ### Qualquer venda para uma Área de Livre Comércio tem isenção? Não. O benefício depende do tipo de mercadoria, da finalidade da compra e de o destinatário estar regularmente cadastrado na SUFRAMA. Alguns produtos são expressamente excluídos dos incentivos. ### O destinatário precisa ter Inscrição SUFRAMA? Sim. A Inscrição SUFRAMA identifica o comprador habilitado e deve constar na NF-e. Sem ela, em regra, a venda não pode usufruir dos benefícios fiscais da área. ### O que acontece se a mercadoria não for internada? Se a entrada na área não for comprovada junto à SUFRAMA, o fisco pode considerar o benefício indevido e cobrar o imposto que deixou de ser pago, com acréscimos legais. ### Área de Livre Comércio é o mesmo que zona franca? Não exatamente. Ambas têm benefícios fiscais, mas a Zona Franca de Manaus é um polo maior e industrial, enquanto as ALCs são menores e voltadas principalmente ao comércio. ## Termos relacionados - [Inscrição SUFRAMA](https://conota.dev/glossario/inscricao-suframa.md) - [Benefício fiscal](https://conota.dev/glossario/beneficio-fiscal.md) - [Desoneração do ICMS](https://conota.dev/glossario/desoneracao-do-icms.md) - [CFOP](https://conota.dev/glossario/cfop.md) - [Isenção tributária](https://conota.dev/glossario/isencao-tributaria.md) - [ICMS](https://conota.dev/glossario/icms.md) --- Fonte: [Área de Livre Comércio](https://conota.dev/glossario/area-de-livre-comercio/) · Atualizado em 2026-10-22 --- # Arquivo PFX > Arquivo PFX é um arquivo protegido por senha que guarda, num só pacote, o certificado digital e a chave privada correspondente. No Brasil, é o formato mais comum do certificado digital A1 da ICP-Brasil, usado por sistemas e APIs fiscais para assinar NF-e, NFC-e, CT-e, MDF-e e, em muitos municípios, NFS-e. **Também conhecido como:** Arquivo .pfx, Certificado PFX, Arquivo P12, Arquivo .p12, Arquivo PKCS#12, PFX, PFX file (Personal Information Exchange) **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** A ## O que existe dentro de um arquivo PFX? Um arquivo PFX reúne três coisas: o certificado digital, que traz os dados públicos do titular (razão social, CNPJ, validade e chave pública); a chave privada, que é a parte secreta usada para assinar; e, muitas vezes, os certificados da cadeia de certificação, que mostram qual Autoridade Certificadora emitiu aquele certificado. Tecnicamente, o PFX segue um padrão internacional chamado PKCS#12. Por isso, o mesmo tipo de arquivo também aparece com a extensão .p12. O conteúdo é criptografado e só pode ser aberto com a senha definida no momento da emissão ou da exportação do certificado. ## Para que serve o arquivo PFX na emissão de notas fiscais? Todo documento fiscal eletrônico precisa ser assinado digitalmente antes de ser enviado ao Fisco. O sistema emissor usa a chave privada guardada no PFX para fazer a assinatura digital do XML, o que garante a autoria e mostra que o conteúdo não foi alterado depois de assinado. Além da assinatura, o PFX costuma ser usado para autenticar a conexão segura com os webservices da SEFAZ e de algumas prefeituras. Sem ele, o servidor do Fisco não reconhece quem está enviando a nota, e a comunicação é recusada. Também é comum usá-lo em serviços como a distribuição de DF-e, que permite baixar documentos emitidos contra o CNPJ da empresa. ## Como o arquivo PFX é enviado para uma API fiscal? Em uma emissão fiscal por API, o certificado precisa ficar disponível para o serviço que assina e transmite os documentos. Normalmente, isso é feito de duas formas: pelo upload do arquivo em um painel de gestão ou pelo envio do conteúdo do PFX convertido em Base64, junto com a senha, em uma requisição à API. No Conota, por exemplo, o certificado pode ser cadastrado para cada empresa emissora e gerenciado no Console, onde também é possível acompanhar a validade. A partir daí, o sistema do cliente apenas envia os dados da venda, e a assinatura acontece no momento da emissão. ## Qual a diferença entre PFX, P12, CER e JKS? PFX e P12 são, na prática, o mesmo formato: ambos seguem o padrão PKCS#12 e carregam certificado e chave privada. Já o arquivo .cer (ou .crt) contém apenas a parte pública do certificado, sem a chave privada, e por isso não serve para assinar notas fiscais. O JKS é um formato de armazenamento de chaves próprio do ecossistema Java. Ele pode guardar o mesmo certificado, mas é usado principalmente dentro de aplicações Java. Em geral, é possível converter um PFX em JKS com ferramentas específicas quando a aplicação exige. ## Quais cuidados tomar com o arquivo PFX? Quem tem o arquivo e a senha consegue assinar documentos em nome da empresa. Por isso, o PFX não deve ser enviado por e-mail ou mensagens sem proteção, e a senha deve ser guardada separadamente. Em ambientes de software, o ideal é usar práticas de gerenciamento de segredos e acesso restrito. Também é importante manter uma cópia de segurança, já que a perda do arquivo obriga a emitir um novo certificado, e acompanhar a data de vencimento. Certificados A1 têm validade limitada, geralmente de um ano, e um certificado vencido ou revogado faz o Fisco rejeitar as emissões. Por fim, o CNPJ do certificado deve corresponder ao emitente do documento, ou à regra de autorização aceita pelo órgão. ## Exemplos de Arquivo PFX - Uma loja virtual compra um certificado digital A1 e recebe um arquivo empresa.pfx com uma senha. A equipe técnica cadastra esse arquivo na API fiscal para que as NFC-e e NF-e passem a ser assinadas automaticamente. - Um ERP que atende vários clientes envia, para cada CNPJ, o conteúdo do arquivo PFX em Base64 e a senha por meio de uma requisição à API, permitindo emitir notas para todas as empresas a partir de uma única integração. - Uma transportadora recebe rejeições ao emitir CT-e e MDF-e. Ao verificar o painel, descobre que o arquivo PFX cadastrado venceu na semana anterior e substitui o certificado pelo renovado. - Um desenvolvedor tenta usar um arquivo .cer exportado do computador e a assinatura falha. Ele percebe que precisa exportar o certificado no formato PFX, incluindo a chave privada. ## Perguntas frequentes ### Arquivo PFX e certificado A1 são a mesma coisa? Não exatamente. O certificado A1 é o tipo de certificado digital que fica armazenado em arquivo, e o PFX é o formato desse arquivo. Na prática, quando alguém fala em certificado A1, quase sempre está se referindo a um arquivo PFX ou P12. ### Esqueci a senha do arquivo PFX. Dá para recuperar? Em geral, não. A senha protege a chave privada com criptografia e não há como descobri-la a partir do arquivo. Se ninguém tiver a senha guardada, normalmente é necessário adquirir ou emitir um novo certificado digital. ### Posso usar o mesmo arquivo PFX em mais de um sistema? Sim, o mesmo arquivo pode ser instalado em diferentes sistemas, como o ERP e a API fiscal. Porém, cada cópia aumenta o risco de vazamento, então convém limitar onde ele fica armazenado e quem tem acesso. ### Certificados A3 também geram arquivo PFX? Normalmente não. No certificado A3, a chave privada fica em um cartão, token ou equipamento seguro e não pode ser exportada como arquivo. Por isso, integrações por API costumam usar certificados A1 em formato PFX. ## Termos relacionados - [Certificado digital A1](https://conota.dev/glossario/certificado-digital-a1.md) - [Assinatura digital do XML](https://conota.dev/glossario/assinatura-digital-do-xml.md) - [Base64 no envio de certificados](https://conota.dev/glossario/base64-no-envio-de-certificados.md) - [Backup de certificado A1](https://conota.dev/glossario/backup-de-certificado-a1.md) - [JKS para armazenamento de certificados](https://conota.dev/glossario/jks-para-armazenamento-de-certificados.md) - [Cadeia de certificação digital](https://conota.dev/glossario/cadeia-de-certificacao-digital.md) --- Fonte: [Arquivo PFX](https://conota.dev/glossario/arquivo-pfx/) · Atualizado em 2026-10-22 --- # Arquivo XML fiscal > Arquivo XML fiscal é o arquivo digital, escrito na linguagem XML, que reúne todas as informações de um documento fiscal eletrônico, como NF-e, NFC-e, NFS-e, CT-e ou MDF-e. Assinado digitalmente e autorizado pelo órgão competente, ele é o documento com validade jurídica. O PDF impresso é apenas uma representação dele para leitura. **Também conhecido como:** XML da nota fiscal, XML da NF-e, XML do documento fiscal, XML autorizado, XML de distribuição, XML, Tax document XML file **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** A ## O que é XML e por que ele é usado nos documentos fiscais? XML é um formato de texto que organiza informações em etiquetas, chamadas tags, como ou . Cada dado fica identificado e no lugar certo, o que permite que computadores leiam e confiram o conteúdo automaticamente. Nos documentos fiscais eletrônicos, o XML segue um modelo oficial (o leiaute) definido pelos órgãos fiscais. Assim, qualquer sistema, seja da empresa, da Secretaria da Fazenda ou da prefeitura, consegue interpretar a nota da mesma forma, sem depender de papel ou de digitação manual. ## Qual a diferença entre o XML e o PDF da nota? O XML é a nota fiscal de verdade: é ele que recebe a assinatura digital e a autorização do fisco. O PDF, como o DANFE da NF-e, o DANFCE da NFC-e, o DACTE do CT-e ou o DAMDFE do MDF-e, é só uma versão visual para facilitar a leitura e acompanhar a mercadoria. Por isso, perder o PDF não é um grande problema, já que ele pode ser gerado novamente a partir do XML. Já o XML precisa ser guardado com cuidado, pois é a prova legal da operação. ## O que vem dentro de um arquivo XML fiscal? O conteúdo varia conforme o tipo de documento, mas em geral inclui dados do emitente e do destinatário, itens vendidos ou serviços prestados, valores, impostos, códigos fiscais como CFOP e CST, além de informações de pagamento e transporte. Também fazem parte do arquivo a assinatura digital, que garante quem emitiu e que nada foi alterado, e, após a autorização, o protocolo do órgão fiscal. Na NF-e, a chave de acesso de 44 dígitos identifica o documento de forma única. O XML que já contém o protocolo costuma ser chamado de XML autorizado ou XML de distribuição. ## Por quanto tempo é preciso guardar o XML fiscal? Tanto quem emite quanto quem recebe o documento deve armazenar o XML pelo prazo previsto na legislação tributária, que normalmente é de cinco anos. Guardar apenas o PDF não substitui essa obrigação. Na prática, muitas empresas mantêm os arquivos em sistemas ou serviços de armazenamento, organizados por CNPJ, tipo de documento e data, para conseguir apresentá-los rapidamente em uma fiscalização, auditoria ou conferência contábil. ## Como os sistemas geram e recebem o XML por meio de uma API fiscal? Em uma integração por API, o sistema da empresa, como um ERP ou uma plataforma de vendas, envia os dados da operação. A API monta o XML no leiaute correto, assina com o certificado digital, transmite ao órgão fiscal e acompanha o retorno até a autorização ou rejeição. Depois de autorizado, o XML é devolvido ao sistema de origem, geralmente junto com o PDF e o status do documento. Isso evita que cada empresa precise lidar diretamente com as diferenças de leiaute entre documentos, estados e municípios, algo especialmente comum na NFS-e. ## Exemplos de Arquivo XML fiscal - Uma loja virtual emite uma NF-e pelo seu ERP; após a autorização, o sistema envia ao cliente, por e-mail, o arquivo XML e o DANFE em PDF. - O contador solicita mensalmente os arquivos XML de todas as notas emitidas e recebidas para fazer a escrituração fiscal da empresa. - Uma transportadora consulta o XML de um CT-e autorizado para conferir os valores do frete e os dados da carga antes de emitir o MDF-e. - Um marketplace que emite notas para vários vendedores baixa os XMLs organizados por CNPJ para atender a um pedido de auditoria. ## Perguntas frequentes ### O PDF da nota substitui o XML? Não. O PDF é apenas uma representação visual. O documento com validade jurídica é o XML assinado e autorizado, que deve ser guardado pelo prazo legal. ### Posso editar um XML fiscal depois de autorizado? Não. Qualquer alteração invalida a assinatura digital. Para corrigir informações, é preciso usar os procedimentos previstos, como carta de correção, cancelamento ou emissão de um novo documento, conforme o caso. ### Quem recebe a nota também precisa guardar o XML? Sim. O destinatário também deve armazenar o XML das notas recebidas, pois ele comprova a operação e pode ser exigido pelo fisco. ### Como abrir um arquivo XML fiscal? Ele pode ser aberto em navegadores ou editores de texto, mas a leitura é técnica. Para visualizar de forma amigável, usa-se o PDF correspondente ou um sistema que interprete o arquivo. ## Termos relacionados - [Assinatura digital do XML](https://conota.dev/glossario/assinatura-digital-do-xml.md) - [DANFE](https://conota.dev/glossario/danfe.md) - [Chave de acesso da NF-e](https://conota.dev/glossario/chave-de-acesso-da-nf-e.md) - [Download de XML fiscal](https://conota.dev/glossario/download-de-xml-fiscal.md) - [Autorização de uso da NF-e](https://conota.dev/glossario/autorizacao-de-uso-da-nf-e.md) - [Distribuição de DF-e](https://conota.dev/glossario/distribuicao-de-df-e.md) --- Fonte: [Arquivo XML fiscal](https://conota.dev/glossario/arquivo-xml-fiscal/) · Atualizado em 2026-10-22 --- # Assinatura digital do XML > Assinatura digital do XML é o procedimento criptográfico que vincula um documento fiscal eletrônico, como NF-e, NFC-e, CT-e, MDF-e ou NFS-e, ao certificado digital do emissor. Ela comprova quem emitiu o arquivo e garante que o conteúdo não foi alterado depois de assinado. É exigida para que a Sefaz ou a prefeitura aceite o documento. **Também conhecido como:** Assinatura do XML, Assinatura digital de documento fiscal, Assinatura XMLDSig, Assinatura eletrônica do XML, XML Digital Signature **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** A ## O que é a assinatura digital do XML? Todo documento fiscal eletrônico é, na essência, um arquivo XML: um texto estruturado com os dados da operação, como emitente, destinatário, produtos, valores e impostos. Antes de ser enviado ao Fisco, esse arquivo precisa ser assinado digitalmente com o certificado digital da empresa emissora. Essa assinatura não é uma imagem nem uma rubrica escaneada. Trata-se de um bloco de informações criptográficas inserido dentro do próprio XML. Esse bloco permite a qualquer pessoa ou sistema verificar quem assinou o documento e se ele continua exatamente igual ao momento da assinatura. ## Para que serve assinar o XML de uma nota fiscal? A assinatura cumpre três funções principais. A primeira é a autoria: ela comprova que o documento foi emitido pelo titular do certificado, normalmente identificado pelo CNPJ. A segunda é a integridade: qualquer alteração no conteúdo, mesmo de um único caractere, invalida a assinatura. A terceira é o não repúdio: o emissor não pode negar depois que emitiu aquele documento. É graças a essa combinação que o XML assinado e autorizado tem validade jurídica e substitui a antiga nota em papel. Sem a assinatura, a Sefaz ou a prefeitura rejeita o documento e ele não pode ser autorizado. ## Como funciona a assinatura digital do XML? O padrão adotado nos documentos fiscais brasileiros segue a especificação de assinatura XML do W3C, conhecida como XMLDSig, no formato de assinatura envelopada, em que a assinatura fica dentro do próprio arquivo. Primeiro, o trecho a ser assinado é padronizado, em um processo chamado canonicalização, para que diferenças de formatação não afetem o resultado. Em seguida, é calculado um resumo matemático (hash) desse conteúdo. Esse resumo é então criptografado com a chave privada do certificado digital, gerando o valor da assinatura. O XML passa a conter um elemento Signature com o resumo, o valor assinado e a parte pública do certificado. Ao receber o arquivo, o Fisco usa a chave pública para conferir se tudo confere. Na NF-e, por exemplo, a assinatura aponta para o grupo de informações da nota identificado pelo atributo Id, que traz a chave de acesso. ## Quais documentos e eventos precisam ser assinados? NF-e, NFC-e, CT-e e MDF-e exigem assinatura do XML do documento. Os eventos ligados a eles, como cancelamento, carta de correção e encerramento de MDF-e, também são assinados antes do envio. Na NFS-e, a exigência depende do padrão adotado. No modelo nacional, a DPS é assinada pelo emissor. Em sistemas municipais próprios, as regras variam: algumas prefeituras pedem assinatura do documento, outras apenas do lote de envio, e algumas não exigem assinatura. ## Quais erros de assinatura são mais comuns? Entre os problemas mais frequentes estão: certificado vencido ou revogado; CNPJ do certificado diferente do CNPJ do emitente informado no XML; alteração do arquivo depois de assinado, como a inclusão de espaços, quebras de linha ou mudança de codificação; e assinatura aplicada ao elemento errado. Cada um desses casos gera uma rejeição específica no retorno do Fisco. Por isso, a regra prática é assinar o XML apenas quando ele estiver completamente pronto e não modificá-lo mais até o envio. ## Quem faz a assinatura quando a emissão é feita por API? Em uma integração por API fiscal, o sistema da empresa normalmente envia os dados da operação, e a plataforma de emissão monta o XML, aplica a assinatura com o certificado digital cadastrado e transmite o documento ao Fisco. Assim, o ERP ou a plataforma de vendas não precisa implementar canonicalização, hash e criptografia por conta própria. Para isso, o certificado, geralmente do tipo A1, é armazenado de forma protegida pela plataforma. Cabe à empresa manter o certificado válido e renovado, pois sem ele nenhuma assinatura pode ser gerada. ## Exemplos de Assinatura digital do XML - Um ERP envia por API os dados de uma venda; a plataforma de emissão gera o XML da NF-e, assina com o certificado A1 da empresa e transmite à Sefaz, que valida a assinatura e autoriza a nota. - Um desenvolvedor reformata o XML assinado para facilitar a leitura antes de enviá-lo e recebe rejeição por assinatura inválida, porque o conteúdo deixou de corresponder ao resumo assinado. - Uma transportadora precisa encerrar um MDF-e e o evento de encerramento é assinado com o certificado digital antes de ser enviado ao Fisco. - Uma empresa com várias filiais tenta emitir uma nota usando o certificado de outro CNPJ e recebe rejeição por divergência entre o certificado e o emitente. ## Perguntas frequentes ### A assinatura digital do XML é a mesma coisa que o certificado digital? Não. O certificado digital é a identidade eletrônica da empresa. A assinatura é o resultado de usar esse certificado sobre um arquivo específico. Um mesmo certificado gera assinaturas diferentes para cada documento emitido. ### Posso editar o XML depois de assinado? Não. Qualquer alteração, inclusive de espaços ou formatação, invalida a assinatura. Se for preciso mudar algo, o XML deve ser corrigido e assinado novamente antes do envio. ### O DANFE também é assinado digitalmente? Não. O DANFE é apenas uma representação impressa ou em PDF do documento. A validade jurídica está no XML assinado e autorizado, que deve ser guardado pelo emitente e pelo destinatário. ### É possível assinar com certificado A3? Sim, desde que o sistema tenha acesso ao token ou cartão no momento da emissão. Em integrações automatizadas por API, o certificado A1 costuma ser preferido por ser um arquivo que pode ser armazenado no servidor. ## Termos relacionados - [Certificado digital A1](https://conota.dev/glossario/certificado-digital-a1.md) - [Arquivo XML fiscal](https://conota.dev/glossario/arquivo-xml-fiscal.md) - [Autorização de uso da NF-e](https://conota.dev/glossario/autorizacao-de-uso-da-nf-e.md) - [Chave de acesso da NF-e](https://conota.dev/glossario/chave-de-acesso-da-nf-e.md) - [Base64 no envio de certificados](https://conota.dev/glossario/base64-no-envio-de-certificados.md) - [DPS da NFS-e](https://conota.dev/glossario/dps-da-nfs-e.md) --- Fonte: [Assinatura digital do XML](https://conota.dev/glossario/assinatura-digital-do-xml/) · Atualizado em 2026-10-22 --- # Autenticidade de documento eletrônico > Autenticidade de documento eletrônico é a garantia de que um arquivo digital, como o XML de uma NF-e, foi realmente emitido por quem diz tê-lo emitido e não foi alterado depois. No Brasil, ela é obtida principalmente pela assinatura digital com certificado ICP-Brasil e confirmada pela consulta ao fisco. **Também conhecido como:** Autenticidade de documento fiscal eletrônico, Autenticidade do XML fiscal, Autenticidade de nota fiscal eletrônica, Electronic document authenticity **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** A ## O que significa autenticidade em um documento fiscal eletrônico? No papel, a autenticidade de um documento costuma ser confirmada por assinatura à mão, carimbo ou reconhecimento de firma. No mundo digital, isso não funciona: um arquivo pode ser copiado e editado sem deixar marcas visíveis. Por isso, a autenticidade precisa ser garantida por meios técnicos. Em documentos fiscais como NF-e, NFC-e, NFS-e, CT-e e MDF-e, autenticidade quer dizer duas coisas na prática: saber com segurança quem emitiu o documento (a origem) e ter certeza de que o conteúdo não foi modificado depois da emissão (a integridade). Se qualquer um desses pontos falhar, o documento perde sua confiabilidade. ## Como a autenticidade é garantida na prática? O principal mecanismo é a assinatura digital do XML. Antes de enviar o documento ao fisco, o sistema emissor usa o certificado digital da empresa, emitido dentro da ICP-Brasil, para assinar o arquivo. Essa assinatura é calculada a partir do conteúdo exato do XML, por meio de um resumo criptográfico chamado hash. Se alguém alterar uma única letra ou número do arquivo depois da assinatura, o resumo deixa de bater e a assinatura passa a ser considerada inválida. Ao mesmo tempo, como só o titular do certificado possui a chave privada usada para assinar, a assinatura comprova a origem do documento. Além disso, o órgão autorizador (como a SEFAZ ou a prefeitura, conforme o documento) valida a assinatura e registra o documento em sua base. O protocolo de autorização devolvido junto ao XML funciona como uma confirmação oficial de que aquele arquivo foi aceito. ## Como verificar se uma nota fiscal eletrônica é autêntica? A forma mais simples é consultar o documento no portal do órgão autorizador usando a chave de acesso, a sequência numérica que identifica cada nota. Se a consulta retornar os mesmos dados do documento recebido e a situação estiver autorizada, a nota é válida. No caso da NFC-e, o QR Code impresso no cupom leva diretamente a essa consulta. Já em sistemas, é possível validar tecnicamente a assinatura do XML e conferir se o certificado usado pertence a uma cadeia de certificação confiável da ICP-Brasil. ## O DANFE ou o PDF da nota comprovam a autenticidade? Não sozinhos. O DANFE, o DANFCE, o DACTE e os demais documentos auxiliares são apenas representações visuais do documento fiscal. O documento com valor jurídico é o arquivo XML assinado e autorizado. Um PDF pode ser facilmente editado, por isso ele serve para acompanhar a mercadoria ou facilitar a leitura, mas a confirmação da autenticidade sempre depende do XML ou da consulta pela chave de acesso no fisco. ## Qual a diferença entre autenticidade, integridade e validade? Autenticidade se refere à origem: confirma quem emitiu o documento. Integridade se refere ao conteúdo: confirma que nada foi alterado. A assinatura digital garante as duas ao mesmo tempo, por isso os termos aparecem juntos com frequência. Validade fiscal é outra questão: um documento pode ser autêntico e íntegro, mas não ter efeito fiscal se, por exemplo, tiver sido cancelado ou não tiver recebido autorização de uso. Por isso, além de checar a assinatura, é importante consultar a situação atual do documento. ## Exemplos de Autenticidade de documento eletrônico - Uma distribuidora recebe o XML de uma NF-e de compra e, antes de dar entrada no estoque, seu ERP consulta a chave de acesso na SEFAZ para confirmar que a nota é autêntica e está autorizada. - Um consumidor escaneia o QR Code de um cupom NFC-e com o celular e confere, no portal da SEFAZ, se os itens e o valor coincidem com o que foi pago. - Uma plataforma de vendas integrada por API recebe do emissor o XML autorizado com o protocolo de autorização e o armazena para comprovar a autenticidade da nota em uma futura fiscalização. - Um contador desconfia de um PDF de nota de serviço enviado por e-mail e solicita o XML da NFS-e para verificar a assinatura digital e consultar o documento no ambiente oficial. ## Perguntas frequentes ### Uma nota fiscal sem assinatura digital é válida? Não. Os documentos fiscais eletrônicos precisam ser assinados digitalmente com certificado ICP-Brasil. Sem assinatura válida, o órgão autorizador rejeita o envio e o documento não chega a ser autorizado. ### Se eu editar o XML depois de autorizado, o que acontece? A assinatura digital deixa de corresponder ao conteúdo e o arquivo perde a autenticidade. Qualquer validação técnica identificará a alteração, e o documento passa a não ter valor como prova. ### Preciso guardar o XML para comprovar a autenticidade? Sim. O XML assinado e autorizado é o documento com valor jurídico. Emitentes e destinatários devem guardá-lo pelo prazo exigido pela legislação, pois o PDF não substitui o arquivo original. ## Termos relacionados - [Assinatura digital do XML](https://conota.dev/glossario/assinatura-digital-do-xml.md) - [ICP-Brasil](https://conota.dev/glossario/icp-brasil.md) - [Certificado digital A1](https://conota.dev/glossario/certificado-digital-a1.md) - [Chave de acesso da NF-e](https://conota.dev/glossario/chave-de-acesso-da-nf-e.md) - [Autorização de uso da NF-e](https://conota.dev/glossario/autorizacao-de-uso-da-nf-e.md) - [Hash de documento fiscal](https://conota.dev/glossario/hash-de-documento-fiscal.md) --- Fonte: [Autenticidade de documento eletrônico](https://conota.dev/glossario/autenticidade-de-documento-eletronico/) · Atualizado em 2026-10-22 --- # Autoridade Certificadora > Autoridade Certificadora (AC) é a entidade autorizada a emitir, renovar e revogar certificados digitais, garantindo que uma chave criptográfica pertence de fato a determinada pessoa ou empresa. No Brasil, as ACs credenciadas na ICP-Brasil emitem os certificados e-CNPJ e e-CPF usados para assinar documentos fiscais eletrônicos, como NF-e, NFC-e, CT-e e MDF-e. **Também conhecido como:** Autoridade de Certificação, AC emissora, Certificadora, AC, Certificate Authority (CA) **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** A ## O que faz uma Autoridade Certificadora? Uma Autoridade Certificadora funciona como um cartório digital. Ela confirma que uma pessoa ou empresa é quem diz ser e, a partir disso, emite um certificado digital que associa essa identidade a um par de chaves criptográficas: uma chave privada, que fica com o titular, e uma chave pública, que pode ser conferida por qualquer um. Além de emitir, a AC também renova certificados próximos do vencimento, revoga certificados comprometidos ou emitidos indevidamente e publica listas de certificados revogados. Assim, quem recebe um documento assinado consegue verificar se o certificado usado ainda era válido e confiável. ## Como funciona a emissão de um certificado por uma AC? O processo começa com a solicitação do certificado e a validação da identidade do titular. Essa etapa de conferência de documentos costuma ser feita por uma Autoridade de Registro vinculada à AC, de forma presencial ou por videoconferência, conforme as regras vigentes. Depois da validação, é gerado o par de chaves e a AC assina digitalmente o certificado com a sua própria chave. Essa assinatura é o que dá credibilidade ao certificado: se a AC é confiável, os certificados emitidos por ela também são. ## Qual a diferença entre Autoridade Certificadora e Autoridade de Registro? A Autoridade de Registro (AR) é a ponta de atendimento: recebe o pedido, confere documentos e confirma a identidade do solicitante. Ela não emite o certificado. A Autoridade Certificadora é quem efetivamente emite, assina, renova e revoga o certificado. Em resumo, a AR verifica quem é o titular e a AC transforma essa verificação em um certificado digital válido. ## Onde a AC se encaixa na hierarquia da ICP-Brasil? A ICP-Brasil é organizada em níveis. No topo está a AC Raiz, que credencia e certifica as Autoridades Certificadoras de primeiro nível. Essas ACs podem certificar outras ACs de nível inferior, que por sua vez emitem os certificados finais para pessoas e empresas. Essa estrutura forma a cadeia de certificação: para confiar em um certificado, um sistema verifica cada elo até chegar à AC Raiz. Cada AC credenciada também precisa seguir regras públicas descritas em sua Declaração de Práticas de Certificação. ## Por que a Autoridade Certificadora importa na emissão fiscal por API? Todo XML de NF-e, NFC-e, CT-e ou MDF-e precisa ser assinado digitalmente com um certificado ICP-Brasil antes de ser enviado à SEFAZ. Muitos municípios também exigem certificado para a NFS-e. Se o certificado não tiver sido emitido por uma AC reconhecida, a assinatura é recusada e o documento é rejeitado. Em uma integração fiscal, a empresa geralmente envia seu certificado A1 (arquivo PFX) para a plataforma de emissão, que passa a assinar os documentos em nome dela. Por isso, é importante acompanhar a validade do certificado e renová-lo com a AC antes do vencimento, evitando interrupções na emissão. ## Exemplos de Autoridade Certificadora - Uma distribuidora contrata um certificado e-CNPJ do tipo A1 com uma AC credenciada na ICP-Brasil e cadastra o arquivo PFX no Console do emissor fiscal para assinar suas NF-e via API. - Um ERP recebe rejeição da SEFAZ ao emitir uma NF-e porque o certificado do cliente foi revogado pela Autoridade Certificadora após suspeita de vazamento da senha. - Uma transportadora renova o certificado com a mesma AC um mês antes do vencimento para não interromper a emissão de CT-e e MDF-e. - Um sistema de gestão valida a cadeia de certificação do certificado enviado pelo cliente, conferindo se a AC emissora pertence à hierarquia da ICP-Brasil. ## Perguntas frequentes ### Qualquer Autoridade Certificadora serve para emitir notas fiscais? Não. Para documentos fiscais eletrônicos no Brasil, o certificado precisa ser emitido por uma AC credenciada na ICP-Brasil. Certificados de outras autoridades, como os usados apenas em sites, não são aceitos pela SEFAZ. ### Trocar de Autoridade Certificadora afeta a emissão fiscal? Não, desde que a nova AC seja credenciada na ICP-Brasil e o certificado esteja em nome do mesmo CNPJ. Basta cadastrar o novo certificado no sistema emissor. ### O que acontece se a AC revogar meu certificado? O certificado deixa de ser válido e os documentos assinados com ele passam a ser rejeitados. É preciso emitir um novo certificado e atualizá-lo no sistema de emissão. ## Termos relacionados - [AC Raiz da ICP-Brasil](https://conota.dev/glossario/ac-raiz-da-icp-brasil.md) - [Autoridade de Registro](https://conota.dev/glossario/autoridade-de-registro.md) - [ICP-Brasil](https://conota.dev/glossario/icp-brasil.md) - [Certificado digital A1](https://conota.dev/glossario/certificado-digital-a1.md) - [Cadeia de certificação digital](https://conota.dev/glossario/cadeia-de-certificacao-digital.md) - [Declaração de Práticas de Certificação](https://conota.dev/glossario/declaracao-de-praticas-de-certificacao.md) --- Fonte: [Autoridade Certificadora](https://conota.dev/glossario/autoridade-certificadora/) · Atualizado em 2026-10-22 --- # Autoridade de Registro > Autoridade de Registro é a entidade vinculada a uma Autoridade Certificadora responsável por receber pedidos de certificado digital, conferir documentos e confirmar a identidade do solicitante antes da emissão. No Brasil, integra a ICP-Brasil e funciona como o ponto de atendimento onde empresas e pessoas validam seus dados para obter certificados como e-CNPJ e e-CPF. **Também conhecido como:** AR, Autoridade de Registro da ICP-Brasil, Agente de registro, Registration Authority **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** A ## O que faz uma Autoridade de Registro? A Autoridade de Registro, conhecida pela sigla AR, é a porta de entrada para quem precisa de um certificado digital. Ela atende o solicitante, confere documentos pessoais e da empresa, coleta dados biométricos quando exigido e confirma que quem está pedindo o certificado é realmente quem diz ser. Depois dessa validação, a AR registra e encaminha a solicitação para a Autoridade Certificadora à qual está vinculada. Sem a aprovação da AR, o certificado não pode ser emitido. Ela também pode participar de pedidos de revogação, quando um certificado precisa ser invalidado antes do prazo. ## Qual a diferença entre Autoridade de Registro e Autoridade Certificadora? A Autoridade Certificadora (AC) é quem efetivamente emite, assina, renova e revoga os certificados digitais. A Autoridade de Registro não emite certificados: ela faz o trabalho de identificação e validação do titular, que vem antes da emissão. Uma comparação simples: a AR é como o balcão de atendimento que confere seus documentos, e a AC é o órgão que produz o documento oficial. Uma mesma AC pode trabalhar com várias ARs, espalhadas por diferentes cidades, para atender mais pessoas e empresas. ## Como funciona a validação de identidade na Autoridade de Registro? O processo costuma começar com a compra ou solicitação do certificado. Em seguida, o solicitante agenda o atendimento e apresenta os documentos exigidos, como documento de identidade e, no caso de empresas, os documentos que comprovam a existência da empresa e quem é seu representante legal. A validação pode ser presencial ou, em situações permitidas pelas regras da ICP-Brasil, feita por videoconferência. Aprovada a identificação, o certificado é liberado para emissão e instalação, seja como arquivo (tipo A1) ou em mídia física, como token ou cartão (tipo A3). ## Por que a Autoridade de Registro importa para a emissão de notas fiscais? Para emitir documentos fiscais eletrônicos como NF-e, NFC-e, CT-e e MDF-e, a empresa precisa assinar digitalmente o XML com um certificado válido da ICP-Brasil, geralmente um e-CNPJ. Esse certificado só existe porque uma Autoridade de Registro validou previamente a identidade da empresa e de seu responsável. Em integrações por API, é comum usar o certificado A1, enviado como arquivo PFX ao emissor. Se os dados validados na AR estiverem errados, por exemplo um CNPJ diferente do emitente, a assinatura não será aceita e a nota pode ser rejeitada. Por isso, conferir as informações no momento do atendimento evita problemas na hora de emitir. ## Como saber se uma Autoridade de Registro é confiável? As ARs que atuam na ICP-Brasil precisam ser credenciadas e seguir as regras definidas para a infraestrutura, incluindo auditorias e procedimentos documentados na Declaração de Práticas de Certificação da AC à qual estão vinculadas. Na prática, o mais seguro é contratar o certificado diretamente com uma Autoridade Certificadora conhecida ou com um parceiro indicado por ela, e verificar se a AR consta como credenciada na ICP-Brasil antes de entregar documentos. ## Exemplos de Autoridade de Registro - Uma loja virtual que vai começar a emitir NFC-e agenda uma videoconferência com uma Autoridade de Registro para validar o representante legal e obter seu primeiro e-CNPJ A1. - Uma empresa de software com dezenas de clientes orienta cada um a renovar o certificado em uma AR antes do vencimento, para que a emissão de NF-e pela API não seja interrompida. - Uma transportadora descobre que o certificado foi emitido com dados societários desatualizados e precisa voltar à Autoridade de Registro para emitir um novo antes de transmitir CT-e e MDF-e. - Um contador acompanha o sócio de uma empresa até a AR para apresentar o contrato social e os documentos pessoais exigidos na emissão do e-CNPJ. ## Perguntas frequentes ### A Autoridade de Registro emite o certificado digital? Não. A AR valida a identidade e os documentos do solicitante e encaminha o pedido. Quem emite e assina o certificado é a Autoridade Certificadora à qual a AR está vinculada. ### Preciso ir pessoalmente a uma Autoridade de Registro? Nem sempre. Além do atendimento presencial, a ICP-Brasil admite validação por videoconferência em determinadas situações. A disponibilidade depende da AR, do tipo de certificado e de o solicitante atender aos requisitos exigidos. ### Na renovação do certificado preciso passar de novo pela AR? Depende das regras vigentes e da situação do titular. Em alguns casos a renovação é simplificada; em outros, especialmente após mudanças cadastrais ou certificado vencido, é exigida nova validação de identidade. ### O emissor fiscal por API tem relação com a Autoridade de Registro? Indiretamente. O emissor usa o certificado digital da empresa para assinar os documentos, e esse certificado só foi emitido após a validação feita pela AR. O emissor não substitui esse processo. ## Termos relacionados - [Autoridade Certificadora](https://conota.dev/glossario/autoridade-certificadora.md) - [ICP-Brasil](https://conota.dev/glossario/icp-brasil.md) - [AC Raiz da ICP-Brasil](https://conota.dev/glossario/ac-raiz-da-icp-brasil.md) - [Certificado digital A1](https://conota.dev/glossario/certificado-digital-a1.md) - [e-CNPJ](https://conota.dev/glossario/e-cnpj.md) - [Declaração de Práticas de Certificação](https://conota.dev/glossario/declaracao-de-praticas-de-certificacao.md) --- Fonte: [Autoridade de Registro](https://conota.dev/glossario/autoridade-de-registro/) · Atualizado em 2026-10-22 --- # Autorização de uso da NF-e > Autorização de uso da NF-e é a confirmação dada pela Secretaria da Fazenda (SEFAZ) de que uma nota fiscal eletrônica foi recebida, validada e registrada. Ela vem acompanhada de um número de protocolo e é o que dá validade jurídica ao documento: sem autorização, a NF-e não existe para o Fisco nem pode acompanhar a mercadoria. **Também conhecido como:** Autorização da NF-e, NF-e autorizada, Protocolo de autorização da NF-e, Autorização de uso da nota fiscal eletrônica, NF-e authorization **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** A ## O que significa ter uma NF-e autorizada? Emitir uma NF-e não é só gerar um arquivo. O documento só passa a valer depois que a SEFAZ do estado do emitente (ou um ambiente autorizador que atua em nome dela) analisa o arquivo e responde que está tudo certo. Essa resposta positiva é a autorização de uso. Na prática, uma NF-e autorizada é uma nota oficialmente registrada no Fisco. A partir desse momento ela pode ser consultada pela chave de acesso, o DANFE pode ser impresso para acompanhar a mercadoria e o destinatário pode escriturar a compra. Uma nota que ainda não recebeu autorização é apenas um rascunho, sem valor fiscal. ## Como funciona o processo de autorização? O sistema emissor monta o XML da nota com os dados da venda, dos produtos e dos impostos, assina digitalmente o arquivo com o certificado digital da empresa e o envia ao serviço web da SEFAZ. A SEFAZ então faz uma série de verificações: se o XML segue o formato oficial, se a assinatura é válida, se o emitente está habilitado, se a numeração não foi usada antes, se os cálculos e códigos fiscais estão coerentes, entre outras regras. Se tudo estiver correto, ela registra a nota e devolve a autorização. Dependendo do serviço usado, a resposta pode vir na mesma hora (processamento síncrono) ou em duas etapas: primeiro a SEFAZ devolve um recibo de recebimento e, depois, o sistema consulta esse recibo para saber o resultado (processamento assíncrono). ## O que é o protocolo de autorização? O protocolo é o comprovante da autorização. Ele contém o número do protocolo, a data e a hora do registro, a chave de acesso da nota e um código de status que indica o resultado. Para uma NF-e autorizada normalmente, o código é 100, acompanhado da mensagem de que o uso da NF-e foi autorizado. Esse protocolo é anexado ao XML original, formando o chamado XML de distribuição (também conhecido como nfeProc). É esse arquivo completo, com nota e protocolo juntos, que deve ser guardado pela empresa e enviado ao destinatário, pois prova que a nota foi de fato autorizada. ## Qual a diferença entre NF-e autorizada, rejeitada e denegada? Autorizada é a nota aprovada e registrada pela SEFAZ, com validade jurídica. Rejeitada é a nota que apresentou algum erro de preenchimento, formato ou regra de validação. Nesse caso ela não é registrada, e a empresa pode corrigir o problema e reenviar usando o mesmo número. Denegada é um caso diferente: a nota não tem erro técnico, mas existe uma irregularidade cadastral do emitente ou do destinatário perante o Fisco. A SEFAZ registra a nota como denegada, e aquele número fica usado definitivamente, sem possibilidade de reaproveitamento nem de circulação da mercadoria com esse documento. ## O que acontece quando a SEFAZ está fora do ar? Se o ambiente autorizador estiver indisponível, a legislação prevê modalidades de contingência. Em algumas delas a nota é enviada a um ambiente autorizador alternativo, que concede a autorização no lugar da SEFAZ de origem. Em outras, a mercadoria pode circular com um documento auxiliar emitido em contingência, e a nota precisa ser transmitida para autorização assim que o serviço normal voltar. Em qualquer cenário, a autorização continua sendo obrigatória: a contingência apenas muda o caminho ou o momento em que ela acontece. ## Como um sistema acompanha a autorização por meio de uma API fiscal? Para quem tem ERP, plataforma de vendas ou marketplace, lidar diretamente com os serviços de cada SEFAZ dá trabalho: é preciso assinar o XML, tratar respostas assíncronas, interpretar códigos de rejeição e montar o XML de distribuição. Uma API fiscal faz essa intermediação. No Conota, por exemplo, o sistema do cliente envia os dados da venda, e a plataforma acompanha a nota até a autorização, devolvendo o status, o XML autorizado e o PDF do DANFE automaticamente. Rejeições ficam visíveis no Console para correção, o que evita que o sistema precise consultar a SEFAZ repetidamente. ## Exemplos de Autorização de uso da NF-e - Uma loja virtual conclui uma venda, o ERP envia a NF-e para a SEFAZ e recebe o código 100 com o número de protocolo. Só então o DANFE é impresso e colocado junto ao pedido para despacho. - Um marketplace envia uma nota com um código NCM inválido e recebe uma rejeição. Após corrigir o código, reenvia a nota com o mesmo número e obtém a autorização de uso. - Uma distribuidora tenta emitir nota para um cliente com inscrição estadual irregular e recebe a NF-e denegada. O número fica inutilizável, e a venda precisa ser revista antes de nova emissão. - Um software de gestão integrado a uma API fiscal recebe automaticamente o status de autorizado e o XML com protocolo, e o disponibiliza para download pelo cliente final. ## Perguntas frequentes ### Posso entregar a mercadoria antes da autorização da NF-e? Não, como regra. A mercadoria só deve circular com a NF-e já autorizada e o DANFE impresso. A exceção são as situações de contingência previstas na legislação, que têm regras próprias e exigem a transmissão posterior da nota. ### Uma NF-e autorizada pode ser alterada? Não. Depois de autorizada, a nota não pode ser editada. Erros que não afetam valores, impostos ou dados cadastrais essenciais podem ser ajustados por carta de correção. Nos demais casos, é preciso cancelar dentro do prazo legal ou emitir nota complementar ou de devolução. ### Onde consultar se uma NF-e foi realmente autorizada? Pela chave de acesso de 44 dígitos, no portal oficial de consulta da NF-e ou da SEFAZ do estado emitente. O próprio XML de distribuição, com o protocolo anexado, também comprova a autorização. ### Autorização em homologação vale como nota fiscal? Não. No ambiente de homologação as notas são apenas de teste e não têm valor jurídico. Somente a autorização concedida no ambiente de produção gera um documento fiscal válido. ## Termos relacionados - [Chave de acesso da NF-e](https://conota.dev/glossario/chave-de-acesso-da-nf-e.md) - [Assinatura digital do XML](https://conota.dev/glossario/assinatura-digital-do-xml.md) - [Arquivo XML fiscal](https://conota.dev/glossario/arquivo-xml-fiscal.md) - [DANFE](https://conota.dev/glossario/danfe.md) - [Cancelamento de documento fiscal](https://conota.dev/glossario/cancelamento-de-documento-fiscal.md) - [Ambiente de produção](https://conota.dev/glossario/ambiente-de-producao.md) --- Fonte: [Autorização de uso da NF-e](https://conota.dev/glossario/autorizacao-de-uso-da-nf-e/) · Atualizado em 2026-10-22 --- # Averbação de carga > Averbação de carga é o procedimento em que a transportadora ou o dono da mercadoria informa à seguradora os dados de cada carga transportada, geralmente enviando o XML do CT-e, da NF-e ou do MDF-e. Esse registro confirma que o embarque está coberto pela apólice de seguro e gera um número de averbação, usado depois em documentos fiscais. **Também conhecido como:** Averbação do seguro de carga, Averbação de seguro, Averbação de CT-e, Averbação de mercadoria, Cargo insurance endorsement **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** A ## O que é averbação de carga, na prática? Quem transporta mercadorias costuma ter uma apólice de seguro que cobre as cargas durante um período, e não uma apólice para cada viagem. Para que a seguradora saiba exatamente o que está sendo transportado, cada embarque precisa ser comunicado. Essa comunicação é a averbação. Em termos simples, averbar é dizer à seguradora: esta carga, com este valor, de tal origem para tal destino, está saindo agora e deve ficar protegida pela minha apólice. Como resposta, a seguradora ou a empresa averbadora devolve um protocolo, chamado número de averbação. ## Para que serve a averbação de carga? A principal função é garantir a cobertura do seguro. Se a carga não foi averbada, a seguradora pode entender que aquele embarque não estava coberto e recusar a indenização em caso de roubo, acidente ou avaria. Ela também serve para controle. A seguradora acompanha o volume e o valor transportado, o que influencia o cálculo do prêmio do seguro. Já a transportadora tem um registro organizado de quais viagens estavam seguradas. ## Como funciona a averbação com documentos fiscais eletrônicos? Hoje a averbação é quase sempre eletrônica. Depois que o documento fiscal é autorizado, o arquivo XML (de CT-e, NF-e ou MDF-e, conforme o caso e as regras da apólice) é enviado ao sistema da seguradora ou de uma empresa averbadora, normalmente por um web service ou integração automática. O sistema lê os dados do XML, como valor da mercadoria, remetente, destinatário e trajeto, e registra o embarque na apólice. Em seguida, devolve o número de averbação. Em regra, esse envio deve acontecer antes do início do transporte, conforme as condições definidas na apólice. Se um documento for cancelado, a averbação correspondente também costuma precisar ser cancelada, para que a seguradora não considere uma carga que não viajou. ## Qual a relação entre averbação de carga e o MDF-e? O leiaute do MDF-e possui um grupo de informações de seguro da carga, com dados como o responsável pelo seguro, o CNPJ da seguradora, o número da apólice e o número da averbação. No transporte rodoviário, essas informações costumam ser exigidas para que o MDF-e seja autorizado. Por isso, a ordem das etapas importa: muitas vezes é preciso emitir o CT-e ou a NF-e, averbar a carga e só então emitir o MDF-e com o número de averbação já em mãos. Quando esses dados faltam ou estão errados, o MDF-e pode ser rejeitado. ## Quem é responsável por averbar a carga? Depende de quem contratou o seguro. Quando a transportadora é a responsável, ela averba normalmente com base no CT-e que emitiu. Quando o próprio dono da mercadoria transporta com frota própria ou contrata o seguro diretamente, a averbação pode ser feita com base na NF-e. Essa informação deve estar alinhada entre as partes e refletida no documento fiscal, no campo que indica o responsável pelo seguro. ## Como a averbação se encaixa em sistemas integrados por API? Em empresas que emitem documentos por uma API fiscal, a averbação costuma ser automatizada. O sistema emite o CT-e ou a NF-e, recebe o XML autorizado, envia esse arquivo para a averbadora e guarda o número de averbação retornado. Depois, esse número é incluído na requisição de emissão do MDF-e. Assim, todo o fluxo, da emissão do documento de transporte até o manifesto, roda sem digitação manual, reduzindo atrasos na saída do veículo e rejeições por dados de seguro ausentes. ## Exemplos de Averbação de carga - Uma transportadora emite o CT-e de um frete de eletrônicos, envia o XML autorizado para a averbadora contratada e recebe o número de averbação antes de o caminhão deixar o pátio. - Uma indústria com frota própria emite a NF-e de venda, averba a carga na sua seguradora com base nesse XML e informa o número de averbação no MDF-e da viagem. - Um ERP de logística recebe pela API o XML do CT-e autorizado, encaminha automaticamente o arquivo para averbação e só libera a emissão do MDF-e quando o protocolo de averbação é retornado. - Após cancelar um CT-e emitido por engano, a transportadora também cancela a averbação correspondente para que a seguradora não contabilize uma carga que não foi transportada. ## Perguntas frequentes ### A averbação de carga é feita na Sefaz? Não. A averbação é feita junto à seguradora ou a uma empresa averbadora. A Sefaz autoriza os documentos fiscais, como CT-e e MDF-e, mas o número de averbação vem do sistema do seguro e depois é informado no documento fiscal. ### O que acontece se a carga não for averbada? A seguradora pode negar a indenização em caso de sinistro, porque não há registro de que aquele embarque estava coberto. Além disso, a falta do número de averbação pode causar rejeição na emissão do MDF-e. ### Averbação de carga é a mesma coisa que averbação de exportação? Não. A averbação de carga trata do seguro do transporte. Na exportação, o termo averbação se refere à confirmação do embarque da mercadoria para o exterior no controle aduaneiro, um procedimento diferente. ### Preciso averbar cada viagem separadamente? Em geral, sim. A apólice cobre um período, mas cada embarque precisa ser comunicado individualmente, normalmente com o XML do documento fiscal correspondente, conforme as regras da apólice contratada. ## Termos relacionados - [CT-e](https://conota.dev/glossario/ct-e.md) - [MDF-e](https://conota.dev/glossario/mdf-e.md) - [DAMDFE](https://conota.dev/glossario/damdfe.md) - [DACTE](https://conota.dev/glossario/dacte.md) - [Arquivo XML fiscal](https://conota.dev/glossario/arquivo-xml-fiscal.md) - [Cancelamento de documento fiscal](https://conota.dev/glossario/cancelamento-de-documento-fiscal.md) --- Fonte: [Averbação de carga](https://conota.dev/glossario/averbacao-de-carga/) · Atualizado em 2026-10-22