# Glossário de A a Z — letra R > 20 termos. Glossário compacto: https://conota.dev/glossario/llms-full.txt --- # Rastreamento de requisições > Rastreamento de requisições é a prática de identificar e acompanhar cada chamada feita a uma API, do envio até a resposta final, normalmente por meio de um identificador único. Em integrações fiscais, permite saber exatamente o que aconteceu com cada pedido de emissão, consulta ou cancelamento de nota, facilitando a investigação de erros e rejeições. **Também conhecido como:** Tracing de requisições, Rastreabilidade de requisições, Correlação de requisições, Rastreamento de chamadas de API, Request tracing **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** R ## O que é rastreamento de requisições na prática? Toda vez que um sistema, como um ERP ou uma plataforma de vendas, pede algo a uma API, ele faz uma requisição. Pode ser o envio de uma NF-e para emissão, a consulta do status de uma NFS-e ou o pedido de cancelamento de uma NFC-e. Rastrear essas requisições significa conseguir localizar cada uma delas depois e reconstruir o seu caminho. A ideia é parecida com o código de rastreio de uma encomenda. Com um número em mãos, você descobre quando o pedido foi recebido, por onde passou, quanto tempo levou e qual foi o resultado. Sem esse número, investigar um problema vira um trabalho de adivinhação. ## Como funciona o rastreamento de requisições? O ponto central é um identificador único, muitas vezes chamado de ID da requisição ou ID de correlação. Ele pode ser gerado pelo sistema do cliente e enviado em um cabeçalho HTTP, ou gerado pela própria API e devolvido na resposta. Um nome comum para esse cabeçalho é X-Request-Id, mas cada API define o seu padrão na documentação. Esse identificador acompanha a requisição por todas as etapas internas: recebimento, validação dos dados, assinatura do XML, envio à SEFAZ ou à prefeitura e retorno do resultado. Cada etapa registra informações associadas ao mesmo ID, como horário, duração e mensagens de erro. Quando a emissão é assíncrona, o rastreamento costuma ligar a requisição inicial ao documento criado. Assim, é possível relacionar o pedido original com o status posterior, o protocolo de autorização ou o motivo de rejeição, mesmo que o resultado chegue minutos depois por webhook ou polling. ## Para que serve o rastreamento de requisições em uma integração fiscal? Serve principalmente para diagnosticar problemas com rapidez. Se um cliente diz que a nota de um pedido não foi emitida, o time técnico consegue procurar a requisição, ver se ela chegou à API, se foi recusada por erro de validação ou se foi rejeitada pelo órgão autorizador. Também ajuda a evitar emissões duplicadas. Ao cruzar o ID da requisição com mecanismos de idempotência, fica mais fácil confirmar se uma nova tentativa após um timeout criou outro documento ou apenas repetiu a mesma operação. Por fim, o rastreamento facilita o contato com o suporte do fornecedor da API. Informar o identificador da requisição permite que a investigação vá direto ao caso, sem depender de descrições vagas como algo deu errado ontem à tarde. ## Qual a diferença entre rastreamento de requisições, log e trilha de auditoria? O log de integração é o registro bruto dos acontecimentos: mensagens, erros e dados técnicos gravados pelos sistemas. O rastreamento de requisições é a forma de organizar e conectar esses registros, usando um identificador comum para enxergar a história completa de uma chamada. A trilha de auditoria fiscal tem outro foco: registrar quem fez o quê e quando, com finalidade de controle e comprovação. Ela pode usar os mesmos identificadores, mas se preocupa mais com responsabilidade e conformidade do que com o diagnóstico técnico. Os três conceitos se complementam dentro da observabilidade da API fiscal. ## Quais boas práticas ajudam no rastreamento de requisições? Guarde o identificador da requisição no seu próprio sistema, junto ao pedido de venda ou ao registro da nota. Quando possível, associe também a chave de acesso ou o número do documento fiscal, criando uma ponte entre o mundo técnico e o mundo fiscal. Evite registrar dados sensíveis sem necessidade, como senhas, tokens de autenticação ou o conteúdo de certificados digitais. Defina ainda por quanto tempo os registros serão mantidos, equilibrando a utilidade para investigação com o custo de armazenamento e as regras de proteção de dados. ## Exemplos de Rastreamento de requisições - Um ERP envia uma NF-e e recebe um erro de timeout. O desenvolvedor usa o ID da requisição para verificar que a nota foi, na verdade, autorizada, e evita reenviar o documento. - Uma plataforma de vendas grava o ID de cada requisição de emissão de NFC-e no pedido do cliente. Quando o caixa relata uma falha, o suporte localiza o caso em segundos e identifica um CSC inválido. - Um marketplace percebe lentidão na emissão de NFS-e em um município. Ao analisar o tempo de cada etapa das requisições rastreadas, descobre que a demora está no retorno da prefeitura, e não na própria integração. - Um agente de inteligência artificial conectado via MCP consulta o status de um CT-e, e a ação fica registrada com um identificador que permite revisar depois exatamente o que foi solicitado. ## Perguntas frequentes ### Quem gera o identificador da requisição? Depende da API. Em alguns casos o sistema cliente envia seu próprio ID em um cabeçalho; em outros, a API cria o identificador e o devolve na resposta. O ideal é consultar a documentação e sempre guardar esse valor. ### O ID da requisição é o mesmo que a chave de acesso da nota? Não. O ID da requisição identifica a chamada técnica feita à API. A chave de acesso identifica o documento fiscal perante a SEFAZ. Vale guardar os dois e relacioná-los no seu sistema. ### Rastreamento de requisições é obrigatório por lei? Não se trata de uma exigência fiscal específica, e sim de uma boa prática técnica. Ele ajuda a investigar falhas, evitar duplicidades e apoiar controles internos e auditorias. ## Termos relacionados - [Log de integração fiscal](https://conota.dev/glossario/log-de-integracao-fiscal.md) - [Observabilidade da API fiscal](https://conota.dev/glossario/observabilidade-da-api-fiscal.md) - [Trilha de auditoria fiscal](https://conota.dev/glossario/trilha-de-auditoria-fiscal.md) - [Idempotência na emissão fiscal](https://conota.dev/glossario/idempotencia-na-emissao-fiscal.md) - [Fluxo assíncrono de emissão](https://conota.dev/glossario/fluxo-assincrono-de-emissao.md) - [Latência da API fiscal](https://conota.dev/glossario/latencia-da-api-fiscal.md) --- Fonte: [Rastreamento de requisições](https://conota.dev/glossario/rastreamento-de-requisicoes/) · Atualizado em 2026-10-22 --- # Recibo de lote > Recibo de lote é o número que a SEFAZ devolve quando recebe um lote de documentos fiscais enviado de forma assíncrona. Ele confirma apenas que o lote chegou e entrou na fila de processamento. Não significa que as notas foram autorizadas. Com esse número, o sistema emissor consulta depois o resultado de cada documento do lote. **Também conhecido como:** Número do recibo, Recibo de recepção do lote, nRec, Batch receipt **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** R ## O que é o recibo de lote, em termos simples? Funciona como a senha que você recebe ao deixar um pedido no balcão. Ela não garante que o pedido ficou pronto, apenas que foi aceito e está na fila. Para saber se deu certo, é preciso voltar e apresentar a senha. Na emissão fiscal, quando um sistema envia um lote de notas no modo assíncrono, a SEFAZ responde com um número de recibo, identificado no XML pelo campo nRec. Esse número é a referência para consultar o processamento daquele lote. ## Como funciona o fluxo com recibo de lote? O fluxo tem duas etapas. Na primeira, o emissor envia o lote assinado digitalmente. Se o lote passar pelas validações iniciais, a SEFAZ responde com o código de status 103 (lote recebido com sucesso) e informa o número do recibo. Na segunda etapa, o emissor faz uma consulta usando o recibo. A resposta pode indicar que o lote ainda está em processamento (código 105) ou que já foi processado (código 104). Quando o lote está processado, a resposta traz o resultado individual de cada documento: autorizado, com seu protocolo, ou rejeitado, com o motivo da rejeição. ## Qual a diferença entre recibo de lote e protocolo de autorização? O recibo de lote se refere ao conjunto enviado e só confirma o recebimento. O protocolo de autorização se refere a cada documento individualmente e confirma que aquela nota foi aceita e tem validade jurídica. Um mesmo lote gera um único recibo, mas pode resultar em várias notas autorizadas e outras rejeitadas. Guardar apenas o recibo não basta: o que comprova a validade da nota é o protocolo de autorização anexado ao XML. ## Em quais documentos fiscais o recibo de lote aparece? Ele é típico da NF-e e do MDF-e quando enviados no modo assíncrono. Na NF-e, o emissor pode optar pelo envio síncrono, em que o resultado vem na mesma resposta e não há recibo para consultar, desde que o lote tenha um único documento. Outros documentos seguem regras próprias. A NFC-e é normalmente emitida de forma síncrona, e versões mais recentes do CT-e também adotaram o envio síncrono. Na NFS-e, alguns sistemas municipais trabalham com envio de lotes de RPS e devolvem um número de protocolo que cumpre papel parecido, mas o nome e o funcionamento variam conforme a prefeitura. ## Por que o recibo de lote importa para quem integra por API? Se o sistema perder o número do recibo, ele fica sem a referência direta para saber o que aconteceu com as notas enviadas. Por isso, integrações robustas registram o recibo assim que ele chega e fazem consultas periódicas, com intervalos crescentes, até obter o resultado final. Em uma API fiscal como o Conota, esse controle costuma ficar com a própria infraestrutura de emissão. O sistema do cliente envia o documento e recebe o status final, o XML e o PDF por consulta ou webhook, sem precisar gerenciar recibos e consultas à SEFAZ diretamente. ## Exemplos de Recibo de lote - Um ERP envia um lote com 20 NF-e para a SEFAZ no modo assíncrono, recebe o código 103 com o número do recibo e agenda uma consulta para alguns segundos depois. - Ao consultar o recibo, uma plataforma de vendas recebe o código 105, indicando que o lote ainda está em processamento, e repete a consulta usando backoff exponencial. - Uma transportadora envia um MDF-e, guarda o recibo no log de integração e, na consulta seguinte, obtém o protocolo de autorização que permite iniciar a viagem. - Após uma queda de conexão, um sistema usa o recibo salvo no banco de dados para descobrir que 18 notas do lote foram autorizadas e 2 foram rejeitadas por erro de NCM. ## Perguntas frequentes ### Receber o recibo de lote significa que a nota foi autorizada? Não. O recibo apenas confirma que o lote chegou à SEFAZ e entrou na fila. A autorização só é confirmada quando a consulta ao recibo retorna o protocolo de autorização de cada documento. ### O que fazer se o sistema perder o número do recibo? É possível consultar a situação de cada nota pela chave de acesso. Se a nota foi autorizada, a consulta retorna o protocolo. Se não consta na SEFAZ, a nota pode ser reenviada com cuidado para evitar duplicidade. ### Preciso guardar o recibo de lote junto com o XML da nota? Não é obrigatório. O documento que deve ser guardado é o XML com o protocolo de autorização. O recibo é útil para rastreamento e auditoria da integração, por isso costuma ser registrado em log. ## Termos relacionados - [Lote de documentos fiscais](https://conota.dev/glossario/lote-de-documentos-fiscais.md) - [Fluxo assíncrono de emissão](https://conota.dev/glossario/fluxo-assincrono-de-emissao.md) - [Protocolo de autorização](https://conota.dev/glossario/protocolo-de-autorizacao.md) - [Polling de status fiscal](https://conota.dev/glossario/polling-de-status-fiscal.md) - [Status de documento fiscal](https://conota.dev/glossario/status-de-documento-fiscal.md) - [Rejeição fiscal](https://conota.dev/glossario/rejeicao-fiscal.md) --- Fonte: [Recibo de lote](https://conota.dev/glossario/recibo-de-lote/) · Atualizado em 2026-10-22 --- # Redução de base de cálculo > Redução de base de cálculo é um benefício fiscal que diminui o valor sobre o qual um imposto é calculado. Antes de aplicar a alíquota, desconta-se um percentual da base. É muito comum no ICMS e faz a carga tributária efetiva ficar menor que a alíquota nominal, sem mudar a alíquota prevista em lei. **Também conhecido como:** Redução da base de cálculo, Base reduzida, BC reduzida, Redução de BC, Tax base reduction **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** R ## O que significa reduzir a base de cálculo? Todo imposto é calculado multiplicando uma base de cálculo, normalmente o valor da operação, por uma alíquota. Reduzir a base de cálculo significa que a lei permite usar apenas uma parte desse valor como ponto de partida, e não o valor total. Na prática, o governo concede um desconto no imposto sem alterar a alíquota oficial. Por isso a redução de base de cálculo é considerada um tipo de benefício fiscal. No ICMS, ela costuma ser prevista em convênios firmados entre os estados e no regulamento do ICMS de cada estado, valendo apenas para produtos, operações e condições específicas. ## Como calcular o imposto com base reduzida? O cálculo segue três passos: aplicar o percentual de redução sobre o valor da operação, encontrar a base reduzida e, por fim, aplicar a alíquota normal sobre ela. Exemplo: uma mercadoria de R$ 1.000,00 com redução de 40% na base e alíquota de ICMS de 18%. A base reduzida fica em R$ 600,00 (R$ 1.000,00 menos 40%). O ICMS devido é 18% de R$ 600,00, ou seja, R$ 108,00. Isso equivale a uma carga efetiva de 10,8% sobre o valor total da venda. Muitas normas expressam o benefício já pensando na carga final, por exemplo, uma redução calculada para que a carga efetiva fique em determinado percentual. Por isso é importante seguir exatamente o percentual indicado na legislação, sem arredondamentos por conta própria. ## Como a redução de base de cálculo aparece na NF-e e na NFC-e? No XML da NF-e e da NFC-e, a redução é sinalizada no grupo de tributação do ICMS. Para empresas do regime normal, os códigos de situação tributária mais usados são o CST 20 (tributada com redução de base de cálculo) e o CST 70 (com redução de base de cálculo e cobrança do ICMS por substituição tributária). O documento informa o percentual de redução no campo pRedBC, além da base já reduzida e do valor do imposto. Dependendo do estado e do benefício, também pode ser obrigatório informar o código de benefício fiscal (cBenef) e, quando a norma exigir, o valor do ICMS desonerado e o motivo da desoneração. Se esses dados estiverem inconsistentes, por exemplo, uma base que não bate com o percentual informado, a SEFAZ pode rejeitar a nota. ## Qual a diferença entre redução de base de cálculo, isenção e redução de alíquota? Na isenção, o imposto deixa de ser cobrado naquela operação. Na redução de base de cálculo, o imposto continua sendo cobrado, só que sobre um valor menor. Por isso ela é frequentemente tratada como uma espécie de isenção parcial. Na redução de alíquota, a base permanece integral e o percentual aplicado é que diminui. O efeito financeiro pode ser parecido, mas o registro no documento fiscal é diferente: cada situação usa códigos e campos próprios, e confundir uma com a outra gera erro de escrituração. ## Quais cuidados tomar ao aplicar a redução na emissão por API? O sistema emissor, como um ERP ou uma plataforma de vendas, precisa saber quando o benefício se aplica. Isso normalmente envolve cruzar NCM, CFOP, estado de origem e destino e regime tributário com as regras do benefício. Deixar o percentual fixo no código do sistema, sem parametrização, aumenta o risco de erro quando a legislação muda. Outro ponto é o crédito de ICMS. Em muitos casos, quem vende com base reduzida pode ter de estornar proporcionalmente o crédito das entradas, conforme a legislação estadual. Esse controle fica na apuração, fora da nota, mas depende de a nota ter sido emitida com o CST e os valores corretos. Ao emitir por uma API fiscal, o sistema do cliente envia os dados tributários do item e a API valida a estrutura, transmite à SEFAZ e devolve o status. Testar os cenários com redução no ambiente de homologação antes de ir para produção ajuda a identificar rejeições com antecedência. ## Exemplos de Redução de base de cálculo - Um atacadista vende itens da cesta básica dentro do estado com redução de base de cálculo prevista no regulamento estadual e emite a NF-e com CST 20, informando o percentual no campo pRedBC. - Um fabricante de máquinas industriais aplica redução de base de cálculo prevista em convênio de ICMS, de modo que a carga efetiva fica menor que a alíquota interna, e informa o código de benefício fiscal exigido pelo estado. - Um ERP integrado a uma API fiscal recebe rejeição da SEFAZ porque o valor da base de cálculo enviado não corresponde ao valor do produto descontado do percentual de redução informado. - Uma distribuidora vende mercadoria sujeita a substituição tributária que também tem base reduzida e preenche a NF-e com CST 70, calculando tanto o ICMS próprio quanto o ICMS-ST sobre as bases reduzidas. ## Perguntas frequentes ### Redução de base de cálculo é o mesmo que desconto na nota? Não. O desconto reduz o preço cobrado do cliente. A redução de base de cálculo é um benefício tributário que diminui apenas o valor usado para calcular o imposto, sem alterar o preço da mercadoria. ### Qualquer empresa pode aplicar redução de base de cálculo? Só quando a legislação prevê o benefício para aquele produto, operação e situação. Alguns benefícios exigem condições extras, como regime específico ou credenciamento. Aplicar sem amparo legal pode gerar cobrança da diferença com multa e juros. ### Empresas do Simples Nacional usam CST 20? Em regra, não. Empresas do Simples Nacional informam o CSOSN no lugar do CST. A forma de tratar benefícios de ICMS nesse regime depende das regras do Simples e da legislação estadual. ### A redução de base de cálculo vale para o ISSQN? É bem menos comum. No ISSQN, a diminuição da base costuma ocorrer por deduções permitidas pela lei municipal, como em alguns serviços de construção civil, e é informada na NFS-e conforme as regras de cada município. ## Termos relacionados - [Base de cálculo reduzida](https://conota.dev/glossario/base-de-calculo-reduzida.md) - [Base de cálculo do ICMS](https://conota.dev/glossario/base-de-calculo-do-icms.md) - [Benefício fiscal](https://conota.dev/glossario/beneficio-fiscal.md) - [Código de benefício fiscal](https://conota.dev/glossario/codigo-de-beneficio-fiscal.md) - [CST](https://conota.dev/glossario/cst.md) - [Desoneração do ICMS](https://conota.dev/glossario/desoneracao-do-icms.md) --- Fonte: [Redução de base de cálculo](https://conota.dev/glossario/reducao-de-base-de-calculo/) · Atualizado em 2026-10-22 --- # Regime especial de tributação > Regime especial de tributação é uma forma diferenciada de calcular, declarar ou recolher tributos, prevista em lei ou concedida pelo fisco a certos contribuintes ou atividades. Na emissão de notas fiscais, sobretudo na NFS-e, indica se o prestador segue regras próprias de ISSQN, como sociedade de profissionais, cooperativa ou estimativa. **Também conhecido como:** Regime especial, Regime especial de tributação do ISSQN, Regime especial de ICMS, Special tax regime **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** R ## O que é um regime especial de tributação? É um tratamento tributário diferente da regra geral. Em vez de calcular o imposto como a maioria das empresas, o contribuinte segue regras próprias, que podem mudar a base de cálculo, a forma de recolhimento, os prazos ou as obrigações acessórias. Esse tratamento pode vir diretamente da legislação, valendo para todos que se enquadram em uma categoria, ou ser concedido individualmente pelo fisco a pedido da empresa, geralmente por meio de um ato formal da secretaria de fazenda estadual ou municipal. ## Como o regime especial aparece na NFS-e? Nos leiautes de NFS-e existe um campo específico para informar o regime especial de tributação do prestador. Ele indica à prefeitura se o ISSQN daquele serviço segue alguma regra diferenciada. As opções mais comuns incluem: nenhum regime especial, ato cooperado (cooperativas), estimativa, microempresa municipal, notário ou registrador, profissional autônomo e sociedade de profissionais. A lista exata e os códigos variam conforme o padrão adotado, como o da NFS-e Nacional ou o de cada município. Quando o campo é preenchido de forma incompatível com o cadastro do prestador na prefeitura, a nota pode ser rejeitada ou o imposto pode ser calculado de forma errada. ## Como funcionam os principais regimes especiais de ISSQN? Na sociedade de profissionais, comum em escritórios de advocacia, contabilidade ou medicina, o ISSQN pode ser cobrado por um valor fixo por profissional habilitado, e não sobre o faturamento de cada nota. No caso do profissional autônomo, a lógica é parecida: o imposto pode ser fixo, cobrado periodicamente. No regime de estimativa, a prefeitura define um valor presumido de imposto para um período, útil para atividades em que é difícil controlar cada operação. Para cooperativas, o ato cooperado pode ter tratamento próprio. As regras concretas dependem da lei de cada município. ## Qual a diferença entre regime especial e regime tributário? Regime tributário é o enquadramento geral da empresa para tributos federais e, em parte, estaduais e municipais: Simples Nacional, Lucro Presumido ou Lucro Real. Na NF-e, isso é informado pelo código de regime tributário do emitente. Regime especial é uma camada adicional e mais específica. Uma empresa do Lucro Presumido pode, por exemplo, ser uma sociedade de profissionais com ISSQN fixo. Os dois conceitos convivem e são informados em campos diferentes do documento fiscal. ## Existe regime especial também no ICMS? Sim. Secretarias da fazenda estaduais podem conceder regimes especiais de ICMS a empresas específicas, autorizando, por exemplo, formas diferenciadas de apuração, emissão de documentos ou recolhimento do imposto. Muitas vezes isso está ligado a um benefício fiscal e exige pedido e aprovação formal. Nesses casos, a NF-e pode precisar trazer informações complementares, como o número do ato concessivo ou um código de benefício fiscal, conforme a regra de cada estado. ## Por que isso importa para quem emite notas por API? Sistemas como ERPs e plataformas de venda precisam guardar o regime especial de cada empresa emissora e enviá-lo corretamente na requisição. Em uma API fiscal, esse dado normalmente faz parte da configuração do emitente ou do próprio payload da nota. Quem gerencia vários CNPJs precisa atenção redobrada: cada empresa pode ter um regime diferente, e um valor padrão aplicado a todas gera rejeições ou recolhimento incorreto de ISSQN. ## Exemplos de Regime especial de tributação - Um escritório de contabilidade cadastrado na prefeitura como sociedade de profissionais emite NFS-e informando esse regime especial, e o ISSQN não é destacado sobre o valor de cada nota. - Uma cooperativa de transporte de passageiros emite NFS-e marcando o regime de ato cooperado para os serviços prestados aos seus cooperados. - Um ERP integrado a uma API fiscal guarda, no cadastro de cada CNPJ, o regime especial de tributação e o envia automaticamente em cada emissão de NFS-e. - Uma indústria obtém da SEFAZ um regime especial de ICMS e passa a informar o número do ato concessivo nas informações complementares da NF-e. ## Perguntas frequentes ### Toda empresa tem um regime especial de tributação? Não. A maioria das empresas não tem regime especial e, na NFS-e, informa a opção equivalente a nenhum regime especial. Ele só se aplica a quem se enquadra em uma categoria prevista em lei ou recebeu autorização do fisco. ### Simples Nacional é um regime especial de tributação? O Simples Nacional é um regime tributário diferenciado, informado em campo próprio. Em alguns leiautes antigos de NFS-e ele aparecia na lista de regimes especiais, mas nos padrões atuais costuma ser informado separadamente. ### O que acontece se eu informar o regime errado na NFS-e? A prefeitura pode rejeitar a nota por incompatibilidade com o cadastro do prestador ou aceitá-la com cálculo de ISSQN incorreto, gerando cobranças, multas ou necessidade de cancelamento e reemissão. ### Onde descubro qual é o meu regime especial? Consulte o cadastro da empresa na prefeitura ou na secretaria da fazenda estadual e confirme com o contador. Regimes concedidos individualmente constam em ato formal emitido pelo órgão responsável. ## Termos relacionados - [ISSQN](https://conota.dev/glossario/issqn.md) - [Benefício fiscal](https://conota.dev/glossario/beneficio-fiscal.md) - [Inscrição municipal](https://conota.dev/glossario/inscricao-municipal.md) - [Homologação de benefício fiscal](https://conota.dev/glossario/homologacao-de-beneficio-fiscal.md) - [DPS da NFS-e](https://conota.dev/glossario/dps-da-nfs-e.md) - [Código de benefício fiscal](https://conota.dev/glossario/codigo-de-beneficio-fiscal.md) --- Fonte: [Regime especial de tributação](https://conota.dev/glossario/regime-especial-de-tributacao/) · Atualizado em 2026-10-22 --- # Regime tributário > Regime tributário é o conjunto de regras que define como uma empresa calcula e paga seus tributos federais, estaduais e municipais. No Brasil, os principais são Simples Nacional, Lucro Presumido e Lucro Real, além do MEI. A escolha afeta os impostos devidos, as obrigações acessórias e o preenchimento dos documentos fiscais emitidos pela empresa. **Também conhecido como:** Regime de tributação, Enquadramento tributário, Regime fiscal, CRT, Tax regime **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** R ## Quais são os principais regimes tributários no Brasil? O Simples Nacional é um regime simplificado para micro e pequenas empresas. Ele reúne vários tributos em uma guia única, com alíquotas que variam conforme a atividade e o faturamento. O MEI, voltado ao microempreendedor individual, é uma forma ainda mais simplificada dentro desse universo. O Lucro Presumido calcula o imposto de renda e a contribuição social sobre um lucro estimado, obtido aplicando um percentual fixo sobre o faturamento. Já o Lucro Real tributa o lucro efetivamente apurado na contabilidade, o que exige controles mais detalhados. Algumas empresas são obrigadas por lei a adotar o Lucro Real, dependendo da atividade ou do porte. ## Como o regime tributário aparece na nota fiscal? Na NF-e e na NFC-e, o regime é informado no campo CRT (Código de Regime Tributário), que diferencia, por exemplo, empresas do Simples Nacional das empresas do regime normal (Lucro Presumido ou Lucro Real). Esse código orienta como o restante da tributação deve ser preenchido. Empresas do Simples Nacional usam o CSOSN para descrever a situação do ICMS de cada item, enquanto empresas do regime normal usam o CST. Na NFS-e, o prestador geralmente indica se é optante pelo Simples Nacional e, quando for o caso, um regime especial de tributação previsto pelo município. ## Por que o regime tributário é importante na emissão fiscal por API? Em uma integração fiscal, o regime tributário costuma fazer parte do cadastro da empresa emissora. A partir dele, o sistema sabe quais campos enviar, quais códigos usar e quais validações aplicar a cada documento. Se o regime estiver errado, a nota pode ser rejeitada pela SEFAZ ou pela prefeitura, ou pior, ser autorizada com tributos calculados incorretamente. Por isso, ERPs e plataformas que emitem para vários CNPJs precisam manter essa informação atualizada para cada empresa. ## Qual a diferença entre regime tributário e alíquota? O regime tributário é a regra geral que a empresa segue para apurar seus impostos. A alíquota é o percentual aplicado sobre uma base de cálculo em um tributo específico, como ICMS ou ISSQN. O regime influencia quais alíquotas e regras se aplicam, mas não substitui a análise de cada operação. Duas empresas no mesmo regime podem ter alíquotas diferentes conforme o produto, o serviço, o estado ou o município. ## Uma empresa pode mudar de regime tributário? Sim, mas a mudança segue regras e prazos definidos pela legislação. Em geral, a opção é feita no início do ano-calendário e vale para o ano inteiro, salvo casos de exclusão ou desenquadramento. Quando a empresa muda de regime, é preciso atualizar o cadastro em todos os sistemas que emitem documentos fiscais em seu nome. A orientação de um contador é recomendada antes de qualquer alteração. ## Exemplos de Regime tributário - Uma loja virtual optante pelo Simples Nacional emite NF-e com o CRT correspondente ao Simples e preenche o CSOSN em cada item vendido. - Um ERP que atende várias indústrias cadastra o regime tributário de cada CNPJ, enviando CST para clientes no Lucro Real e CSOSN para clientes no Simples Nacional. - Uma clínica no Lucro Presumido emite NFS-e informando que não é optante pelo Simples Nacional, e o ISSQN é calculado pela alíquota definida pelo município. - Após uma empresa sair do Simples Nacional, a plataforma de vendas atualiza o regime no cadastro do emissor para evitar rejeições nas próximas notas. ## Perguntas frequentes ### Onde fica o regime tributário na NF-e? No grupo de dados do emitente, no campo CRT (Código de Regime Tributário). Ele indica se a empresa é do Simples Nacional ou do regime normal e define se os itens usam CSOSN ou CST. ### MEI é um regime tributário? O MEI é uma forma simplificada de recolhimento vinculada ao Simples Nacional, voltada ao microempreendedor individual. Na prática, tem regras próprias de faturamento, tributos e emissão de notas fiscais. ### O que acontece se eu informar o regime errado na nota? A nota pode ser rejeitada por inconsistência entre o regime e os códigos de tributação, ou ser autorizada com impostos incorretos, exigindo correções, cancelamento ou ajustes fiscais posteriores. ### Quem define o regime tributário da empresa? A própria empresa escolhe, normalmente com apoio do contador, respeitando os limites e as restrições da legislação para cada regime, como faturamento e tipo de atividade. ## Termos relacionados - [Simples Nacional](https://conota.dev/glossario/simples-nacional.md) - [Lucro presumido](https://conota.dev/glossario/lucro-presumido.md) - [Optante pelo Simples Nacional](https://conota.dev/glossario/optante-pelo-simples-nacional.md) - [CSOSN](https://conota.dev/glossario/csosn.md) - [CST](https://conota.dev/glossario/cst.md) - [MEI na emissão fiscal](https://conota.dev/glossario/mei-na-emissao-fiscal.md) --- Fonte: [Regime tributário](https://conota.dev/glossario/regime-tributario/) · Atualizado em 2026-10-22 --- # Rejeição fiscal > Rejeição fiscal é a resposta negativa que o órgão autorizador, como a SEFAZ ou a prefeitura, devolve quando um documento fiscal eletrônico enviado para autorização contém erro ou inconsistência. O documento rejeitado não tem validade jurídica e precisa ser corrigido e reenviado. A resposta traz um código e uma mensagem que explicam o problema. **Também conhecido como:** Rejeição de nota fiscal, Rejeição da SEFAZ, Nota rejeitada, Documento fiscal rejeitado, Tax document rejection **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** R ## O que significa uma rejeição fiscal na prática? Todo documento fiscal eletrônico, como NF-e, NFC-e, CT-e, MDF-e ou NFS-e, passa por uma checagem antes de valer oficialmente. O sistema da empresa envia o arquivo, e o órgão responsável confere se os dados estão completos, coerentes e de acordo com as regras vigentes. Se algo não estiver certo, o órgão não autoriza o documento e devolve uma rejeição. Na prática, é como se a nota não tivesse sido emitida: ela não pode acompanhar a mercadoria, não pode ser entregue ao cliente e não gera efeitos fiscais até ser corrigida e aceita. ## Por que um documento fiscal é rejeitado? As causas mais comuns envolvem dados cadastrais e tributários. Entre elas estão CNPJ ou inscrição estadual inválidos, CFOP incompatível com a operação, NCM inexistente, valores de impostos que não batem com a base de cálculo, totais divergentes da soma dos itens e data de emissão fora do prazo aceito. Também há causas técnicas, como certificado digital vencido, assinatura digital inválida, número de documento já utilizado (duplicidade) ou XML fora do leiaute exigido. No caso da NFS-e, cada prefeitura ou o Padrão Nacional pode ter regras próprias, o que aumenta a variedade de motivos possíveis. ## Como identificar o motivo de uma rejeição? A resposta do órgão autorizador sempre traz um código numérico e uma descrição curta do problema. Esse par de informações é o ponto de partida para descobrir o que precisa ser ajustado no documento. Nem sempre a mensagem é clara para quem não é da área fiscal. Por isso, muitos sistemas e plataformas de emissão traduzem o código em orientações mais compreensíveis e registram o histórico de cada tentativa, facilitando a correção pela equipe técnica ou pelo contador. ## O que fazer depois de receber uma rejeição? O caminho é corrigir a informação apontada e enviar o documento novamente. Em geral, como a nota rejeitada não chega a ser registrada, o mesmo número pode ser reaproveitado no reenvio. Se a empresa decidir não reenviar aquele número, pode ser necessário inutilizar a numeração para evitar lacunas na sequência, conforme as regras do documento. Reenviar sem corrigir a causa só gera nova rejeição, por isso o ideal é tratar o motivo antes de tentar outra vez. ## Qual a diferença entre rejeição, denegação e erro de validação? O erro de validação acontece antes do envio ao órgão: o próprio sistema emissor ou a API identifica que falta um campo ou que o formato está errado e barra o documento. A rejeição, por sua vez, é dada pelo órgão autorizador depois de receber o documento. Já a denegação é mais grave. Ocorre quando o órgão identifica irregularidade cadastral do emitente ou do destinatário. Diferentemente da rejeição, o número do documento denegado fica registrado e não pode ser reaproveitado. ## Como sistemas integrados por API lidam com rejeições? Em uma emissão fiscal por API, o sistema da empresa, como um ERP ou uma plataforma de vendas, envia os dados e acompanha o status do documento. Quando há rejeição, a API devolve o código, a mensagem e o status atualizado, normalmente por webhook ou consulta de status. Com essas informações, o sistema pode avisar o usuário, corrigir dados automaticamente quando possível ou enviar o caso para revisão. No Conota, as rejeições ficam reunidas no Console, junto com o histórico de cada documento, o que ajuda a gerenciar vários CNPJs ao mesmo tempo. ## Exemplos de Rejeição fiscal - Uma loja virtual emite uma NF-e com o CFOP de venda interna para um cliente de outro estado, e a SEFAZ rejeita o documento por incompatibilidade entre o CFOP e o destino da operação. - Um ERP envia uma NFC-e cujo valor total não corresponde à soma dos itens; a nota é rejeitada e o sistema mostra ao operador o motivo para correção. - Uma empresa de serviços tenta emitir uma NFS-e com o certificado digital A1 vencido, e a prefeitura rejeita o envio até que um certificado válido seja cadastrado. - Uma transportadora reenvia por engano um CT-e com número já autorizado e recebe rejeição por duplicidade. ## Perguntas frequentes ### Nota rejeitada tem validade? Não. Um documento rejeitado não foi autorizado pelo órgão fiscal, portanto não tem validade jurídica, não pode acompanhar mercadoria nem ser entregue ao cliente como comprovante. ### Posso usar o mesmo número depois de uma rejeição? Em geral, sim. Como o documento rejeitado não é registrado, o número pode ser reutilizado no reenvio corrigido. Se não for usado, pode ser preciso inutilizá-lo para evitar lacunas na numeração. ### Rejeição gera multa? A rejeição em si é apenas a recusa do documento. O risco surge quando a empresa realiza a operação sem ter um documento autorizado, situação que pode gerar penalidades conforme a legislação aplicável. ### Quem corrige a rejeição: o desenvolvedor ou o contador? Depende da causa. Problemas técnicos, como XML ou certificado, costumam ficar com a equipe técnica. Questões tributárias, como CFOP, CST ou alíquotas, normalmente exigem orientação do contador. ## Termos relacionados - [Motivo de rejeição fiscal](https://conota.dev/glossario/motivo-de-rejeicao-fiscal.md) - [Erro de validação fiscal](https://conota.dev/glossario/erro-de-validacao-fiscal.md) - [Autorização de uso da NF-e](https://conota.dev/glossario/autorizacao-de-uso-da-nf-e.md) - [Status de documento fiscal](https://conota.dev/glossario/status-de-documento-fiscal.md) - [Reprocessamento de emissão fiscal](https://conota.dev/glossario/reprocessamento-de-emissao-fiscal.md) - [SEFAZ](https://conota.dev/glossario/sefaz.md) --- Fonte: [Rejeição fiscal](https://conota.dev/glossario/rejeicao-fiscal/) · Atualizado em 2026-10-22 --- # Renovação de certificado A1 > Renovação de certificado A1 é o processo de obter um novo certificado digital do tipo A1 antes que o atual expire, para que a empresa continue assinando e emitindo documentos fiscais eletrônicos, como NF-e, NFC-e, CT-e, MDF-e e NFS-e. O certificado renovado deve ser instalado ou enviado novamente ao emissor fiscal. **Também conhecido como:** Renovação do certificado digital A1, Renovação de e-CNPJ A1, Renovação de certificado modelo A1, A1 digital certificate renewal **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** R ## O que é a renovação de certificado A1? O certificado digital A1 funciona como a identidade eletrônica da empresa. Ele é usado para assinar os arquivos XML dos documentos fiscais e comprovar ao Fisco quem os emitiu. Por ser um arquivo armazenado em computador ou servidor, ele tem prazo de validade mais curto que outros tipos de certificado, geralmente de até um ano. Renovar significa adquirir um novo certificado antes que o atual vença. Na prática, não se trata de estender a validade do arquivo antigo: um novo certificado é emitido por uma Autoridade Certificadora, com um novo par de chaves e um novo arquivo PFX. ## Por que é importante renovar o certificado A1 antes do vencimento? Quando o certificado expira, a assinatura digital deixa de ser aceita. A SEFAZ e as prefeituras rejeitam documentos assinados com certificado vencido, o que interrompe a emissão de notas e pode parar vendas, faturamento e transporte de mercadorias. Além da emissão, o certificado costuma ser usado em outras operações, como consulta e download de documentos recebidos e envio de eventos, por exemplo cancelamentos e cartas de correção. Um vencimento esquecido afeta todas essas rotinas ao mesmo tempo. ## Como funciona a renovação de certificado A1? O responsável pela empresa contrata um novo certificado com uma Autoridade Certificadora ou Autoridade de Registro. Dependendo das regras vigentes e da certificadora, a renovação pode ser feita online usando o certificado ainda válido ou pode exigir nova validação de identidade, presencial ou por videoconferência. Após a validação, o novo certificado é gerado e baixado como arquivo PFX protegido por senha. Esse arquivo precisa ser guardado em local seguro, ter uma cópia de backup e ser enviado a todos os sistemas que assinam documentos em nome da empresa. ## O que fazer depois de renovar o certificado A1? O passo mais esquecido é atualizar o certificado nos sistemas. Em uma integração por API, o novo arquivo PFX e sua senha devem ser enviados ao emissor fiscal, muitas vezes codificados em Base64. Até que isso aconteça, o sistema pode continuar tentando usar o certificado antigo. Também vale testar uma emissão no ambiente de homologação, quando disponível, conferir a nova data de validade registrada e remover com segurança cópias antigas do arquivo que não serão mais usadas. ## Como empresas com vários CNPJs controlam a renovação? Cada CNPJ emissor normalmente tem seu próprio certificado, com datas de vencimento diferentes. Em ERPs, marketplaces e softwares de gestão que emitem notas para muitos clientes, controlar essas datas manualmente aumenta o risco de algum certificado vencer sem aviso. Por isso, é comum centralizar os certificados em um painel de gestão. No Conota, o Console reúne a gestão de várias empresas e seus certificados, o que ajuda a acompanhar a validade de cada um e atualizar o arquivo quando ocorrer a renovação. ## Exemplos de Renovação de certificado A1 - Uma loja virtual percebe que o certificado A1 vence em duas semanas, contrata a renovação com a certificadora, baixa o novo arquivo PFX e o envia pela API do emissor fiscal antes da data limite, sem interromper a emissão de NF-e. - Um ERP que emite notas para centenas de clientes consulta periodicamente a validade dos certificados cadastrados e avisa cada cliente quando a renovação se aproxima. - Uma transportadora renova o certificado, mas esquece de atualizá-lo no sistema; no dia seguinte ao vencimento, os CT-e e MDF-e passam a ser rejeitados até que o novo arquivo seja enviado. - Um escritório de contabilidade renova os certificados das empresas atendidas e guarda uma cópia de backup de cada arquivo PFX em ambiente protegido. ## Perguntas frequentes ### Posso renovar o certificado A1 depois que ele venceu? Pode, mas nesse caso costuma ser necessário fazer uma nova emissão com validação completa de identidade. Além disso, a empresa fica sem emitir documentos fiscais até instalar o novo certificado. ### O certificado renovado usa o mesmo arquivo e a mesma senha? Não. A renovação gera um novo arquivo PFX, com novas chaves e senha definida no momento da emissão. Por isso, o novo arquivo precisa ser enviado novamente a todos os sistemas que assinam documentos. ### Com quanto tempo de antecedência devo renovar? Não há prazo único obrigatório, mas é prudente iniciar com algumas semanas de antecedência, para ter tempo de validar a identidade, atualizar os sistemas e testar a emissão antes do vencimento. ### Documentos emitidos com o certificado antigo continuam válidos? Sim. Documentos autorizados enquanto o certificado estava válido permanecem válidos. O vencimento impede apenas novas assinaturas a partir daquela data. ## Termos relacionados - [Certificado digital A1](https://conota.dev/glossario/certificado-digital-a1.md) - [Arquivo PFX](https://conota.dev/glossario/arquivo-pfx.md) - [Backup de certificado A1](https://conota.dev/glossario/backup-de-certificado-a1.md) - [Autoridade Certificadora](https://conota.dev/glossario/autoridade-certificadora.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) --- Fonte: [Renovação de certificado A1](https://conota.dev/glossario/renovacao-de-certificado-a1/) · Atualizado em 2026-10-22 --- # Reprocessamento de emissão fiscal > Reprocessamento de emissão fiscal é o novo envio de um documento fiscal, como NF-e, NFS-e, NFC-e ou CT-e, que não foi autorizado na primeira tentativa por rejeição, falha de comunicação ou indisponibilidade do órgão autorizador. Pode ser automático ou manual e normalmente exige corrigir os dados ou confirmar antes que o documento ainda não foi autorizado. **Também conhecido como:** Reenvio de documento fiscal, Reenvio de nota fiscal, Retransmissão de documento fiscal, Reprocessamento de nota fiscal, Tax document reprocessing **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** R ## O que significa reprocessar uma emissão fiscal? Emitir um documento fiscal eletrônico envolve enviar um arquivo com os dados da operação para um órgão autorizador, como a SEFAZ ou a prefeitura. Esse órgão analisa as informações e responde se o documento foi autorizado ou rejeitado. Às vezes a resposta nem chega, por instabilidade ou demora na comunicação. Reprocessar é tentar de novo a emissão que não terminou bem. Na prática, o sistema pega o mesmo documento, corrigido ou não, e o submete novamente até obter um resultado definitivo: autorização ou uma rejeição que precise de intervenção humana. ## Quando é necessário reprocessar uma nota fiscal? Os casos mais comuns são três. O primeiro é a rejeição por erro nos dados, como um NCM inválido, um CFOP incompatível com a operação ou uma inscrição estadual incorreta. Nesse caso, é preciso corrigir a informação antes de reenviar. O segundo é a falha de comunicação, como um timeout, em que o sistema não sabe se o documento chegou ao órgão autorizador. O terceiro é a indisponibilidade temporária do serviço da SEFAZ ou da prefeitura, quando basta aguardar e tentar outra vez, sem alterar nada no documento. ## Como funciona o reprocessamento na prática? O processo começa identificando por que a emissão falhou. Se houve rejeição, o código e o motivo informados pelo órgão autorizador indicam o que deve ser ajustado. Se houve falha técnica, o primeiro passo é consultar o status do documento para saber se ele foi ou não autorizado. Depois disso, o documento é reenviado. Em integrações bem construídas, esse reenvio acontece por meio de uma fila de emissão, que organiza as tentativas, registra cada resultado e evita que o mesmo documento seja processado duas vezes ao mesmo tempo. ## Qual a diferença entre reprocessamento e retry automático? O retry é a nova tentativa automática feita pelo sistema logo após uma falha técnica, geralmente com intervalos crescentes entre as tentativas. Ele resolve bem problemas passageiros, como lentidão ou instabilidade momentânea. O reprocessamento é um conceito mais amplo. Inclui o retry, mas também os reenvios feitos depois de corrigir dados rejeitados, muitas vezes disparados por uma pessoa ou por uma regra de negócio. Uma rejeição por dado errado não se resolve só repetindo o envio: é preciso alterar o conteúdo antes. ## Quais cuidados evitam notas fiscais duplicadas? O maior risco do reprocessamento é emitir a mesma venda duas vezes. Isso pode acontecer quando o primeiro envio foi autorizado, mas a resposta se perdeu, e o sistema envia de novo como se nada tivesse ocorrido. Para evitar o problema, usa-se a idempotência: cada pedido de emissão recebe um identificador único, e o emissor reconhece quando aquele pedido já foi processado. Outro cuidado é consultar o status do documento antes de reenviar após uma falha de comunicação. Também é importante controlar a numeração, já que números que não forem usados podem precisar ser inutilizados. ## Como uma API fiscal ajuda no reprocessamento? Uma API fiscal pode assumir boa parte do trabalho: acompanha cada documento até a autorização, refaz tentativas em falhas temporárias e devolve ao sistema do cliente o status, o motivo de eventual rejeição, o XML e o PDF. Assim, o ERP ou a plataforma de vendas só precisa agir quando há algo a corrigir. Em soluções como o Conota, as rejeições ficam reunidas em um Console, o que facilita localizar documentos pendentes, entender o erro e reenviar após o ajuste. O histórico de cada tentativa também serve como registro para auditoria. ## Exemplos de Reprocessamento de emissão fiscal - Um e-commerce envia uma NF-e que é rejeitada porque o NCM de um produto está desatualizado. A equipe corrige o cadastro e reprocessa a nota, que é autorizada na segunda tentativa. - Um ERP sofre timeout ao emitir uma NFC-e. Antes de reenviar, o sistema consulta o status e descobre que a nota já havia sido autorizada, evitando uma duplicidade. - Durante uma instabilidade no serviço de uma prefeitura, várias NFS-e ficam pendentes na fila de emissão e são reprocessadas automaticamente quando o serviço volta ao normal. - Uma transportadora tem um CT-e rejeitado por erro no RNTRC, corrige o dado no cadastro do veículo e reenvia o documento pelo Console. ## Perguntas frequentes ### Reprocessar uma nota gera um novo número? Depende do caso e das regras do documento. Em geral, um documento rejeitado não chega a ser registrado como autorizado, e o número pode ser reaproveitado no reenvio. Números que acabarem não sendo usados podem precisar ser inutilizados. ### Posso reprocessar uma nota que já foi autorizada? Não. Um documento autorizado já tem validade jurídica. Se houver erro, o caminho é o cancelamento, uma carta de correção quando permitida ou a emissão de um novo documento, conforme as regras de cada tipo. ### Todo reprocessamento precisa de ação manual? Não. Falhas temporárias, como lentidão ou indisponibilidade do órgão autorizador, costumam ser resolvidas com novas tentativas automáticas. Já rejeições por dados incorretos normalmente exigem correção antes do reenvio. ## Termos relacionados - [Retry na integração fiscal](https://conota.dev/glossario/retry-na-integracao-fiscal.md) - [Rejeição fiscal](https://conota.dev/glossario/rejeicao-fiscal.md) - [Idempotência na emissão fiscal](https://conota.dev/glossario/idempotencia-na-emissao-fiscal.md) - [Fila de emissão fiscal](https://conota.dev/glossario/fila-de-emissao-fiscal.md) - [Timeout na emissão fiscal](https://conota.dev/glossario/timeout-na-emissao-fiscal.md) - [Status de documento fiscal](https://conota.dev/glossario/status-de-documento-fiscal.md) --- Fonte: [Reprocessamento de emissão fiscal](https://conota.dev/glossario/reprocessamento-de-emissao-fiscal/) · Atualizado em 2026-10-22 --- # Responsabilidade tributária > Responsabilidade tributária é a regra prevista em lei que obriga uma pessoa ou empresa, diferente de quem praticou o fato gerador, a pagar um tributo ao fisco. Ela aparece, por exemplo, quando o tomador de um serviço retém e recolhe o ISS, ou quando o fabricante recolhe antecipadamente o ICMS devido nas etapas seguintes da venda. **Também conhecido como:** Sujeição passiva indireta, Responsabilidade fiscal de terceiros, Tax liability **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** R ## O que é responsabilidade tributária? Todo tributo tem alguém que precisa pagá-lo. Na maioria das vezes, quem paga é a própria pessoa ou empresa que realizou a atividade tributada, chamada de contribuinte. Em algumas situações, porém, a lei transfere essa obrigação para outra pessoa, que passa a ser chamada de responsável tributário. O responsável não é escolhido livremente. Ele precisa ter alguma ligação com a operação, como ser o comprador, o tomador do serviço, o sucessor de uma empresa ou o administrador que agiu de forma irregular. As regras gerais sobre o tema estão no Código Tributário Nacional, e cada tributo pode ter regras específicas em leis federais, estaduais ou municipais. ## Qual a diferença entre contribuinte e responsável tributário? O contribuinte é quem tem relação pessoal e direta com o fato gerador. Por exemplo, o prestador de um serviço é o contribuinte do ISS, porque foi ele quem prestou o serviço. O responsável tributário é alguém que não praticou o fato gerador, mas que a lei obriga a pagar o tributo. Se uma prefeitura determina que o tomador de certos serviços deve reter o ISS, esse tomador passa a ser o responsável pelo recolhimento, mesmo sem ter prestado o serviço. Os dois são considerados sujeitos passivos da obrigação tributária. ## Quais são os principais tipos de responsabilidade tributária? Responsabilidade por substituição: a lei define desde o início que outra pessoa pagará o tributo no lugar do contribuinte. É o caso da substituição tributária do ICMS, em que um integrante da cadeia recolhe o imposto das etapas seguintes, e das retenções na fonte, como ISS, IRRF e INSS retidos na nota. Responsabilidade por transferência: a obrigação nasce para o contribuinte, mas depois passa para outra pessoa por causa de um evento posterior. Exemplos são a compra de uma empresa ou de um estabelecimento com dívidas fiscais, a herança e a responsabilidade de sócios ou administradores que agiram com excesso de poderes ou infração à lei. ## Como a responsabilidade tributária aparece nos documentos fiscais? Na NFS-e, ela costuma aparecer como ISS retido: a nota indica que o imposto será recolhido pelo tomador do serviço, e não pelo prestador. A nota também pode informar retenções federais, como IRRF, INSS, PIS, COFINS e CSLL, dependendo do serviço e de quem contrata. Na NF-e, a substituição tributária do ICMS aparece em campos e códigos próprios, como o CST 10, usado quando o emitente cobra o ICMS por substituição tributária, e o CST 60, usado quando o imposto já foi cobrado anteriormente por substituição. Há ainda campos para a base de cálculo e o valor do ICMS-ST, além do FCP retido quando aplicável. ## Por que isso importa para quem emite notas por sistema próprio? Quando um ERP, marketplace ou plataforma de vendas emite notas por API, ele precisa enviar corretamente quem é o responsável por cada tributo. Um campo de retenção marcado de forma errada pode gerar rejeição, cobrança em duplicidade ou falta de recolhimento, com multa e juros para uma das partes. Por isso, é comum que o sistema guarde regras por cliente, serviço e município, como a indicação de ISS retido ou de produtos sujeitos à substituição tributária. A API fiscal valida o formato e transmite o documento, mas a definição de quem é o responsável depende da legislação aplicável e, em geral, da orientação do contador. ## Exemplos de Responsabilidade tributária - Uma empresa de software emite NFS-e para um cliente localizado em um município que exige a retenção do ISS pelo tomador. A nota é enviada com o ISS marcado como retido, e o cliente desconta o imposto do pagamento e o recolhe à prefeitura. - Um fabricante de bebidas emite NF-e para um supermercado com ICMS cobrado por substituição tributária. O fabricante recolhe o imposto que seria devido na revenda, e o supermercado, ao vender, não paga o ICMS novamente sobre aquela mercadoria. - Uma grande empresa contrata um serviço de limpeza com cessão de mão de obra e retém o INSS indicado na nota fiscal, ficando responsável por recolher esse valor. - Uma pessoa compra um ponto comercial e continua o mesmo negócio no local. Dependendo da situação, ela pode responder por tributos devidos pelo antigo dono, o que é um caso de responsabilidade por sucessão. ## Perguntas frequentes ### O contribuinte deixa de ter obrigação quando existe um responsável? Depende do caso. Em algumas situações a lei exclui a responsabilidade do contribuinte; em outras, ele continua obrigado de forma conjunta ou complementar. É preciso verificar a regra específica de cada tributo e de cada situação. ### O que acontece se o responsável não recolher o tributo retido? Ele pode ser cobrado pelo fisco com multa e juros. Em casos de valores descontados de terceiros e não repassados, a conduta pode ainda ter consequências mais graves previstas em lei. ### Quem decide se o ISS deve ser retido na NFS-e? A legislação do município, além de regras gerais nacionais sobre o ISS. O emissor informa a retenção na nota conforme essas regras, normalmente com apoio do contador, e o sistema emissor apenas transmite essa informação. ### Substituição tributária e retenção na fonte são a mesma coisa? Ambas são formas de responsabilidade por substituição, mas o termo substituição tributária costuma se referir ao ICMS cobrado antecipadamente na cadeia, enquanto retenção na fonte descreve descontos de tributos feitos no pagamento, como ISS, IRRF e INSS. ## Termos relacionados - [Fato gerador](https://conota.dev/glossario/fato-gerador.md) - [Antecipação tributária](https://conota.dev/glossario/antecipacao-tributaria.md) - [ISSQN](https://conota.dev/glossario/issqn.md) - [IRRF](https://conota.dev/glossario/irrf.md) - [INSS retido na nota fiscal](https://conota.dev/glossario/inss-retido-na-nota-fiscal.md) - [Fundo de Combate à Pobreza retido por substituição tributária](https://conota.dev/glossario/fundo-de-combate-a-pobreza-retido-por-substituicao-tributaria.md) --- Fonte: [Responsabilidade tributária](https://conota.dev/glossario/responsabilidade-tributaria/) · Atualizado em 2026-10-22 --- # Ressarcimento de ICMS-ST > Ressarcimento de ICMS-ST é o procedimento que permite a uma empresa recuperar o ICMS pago antecipadamente por substituição tributária quando a operação prevista pelo fisco não acontece como presumido, por exemplo, em vendas para outro estado, saídas isentas ou perda da mercadoria. A recuperação pode ocorrer como crédito, compensação ou devolução, conforme as regras de cada estado. **Também conhecido como:** Ressarcimento de ICMS por substituição tributária, Ressarcimento de ICMS retido, Restituição de ICMS-ST, Recuperação de ICMS-ST **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** R ## O que é o ressarcimento de ICMS-ST? Na substituição tributária do ICMS, um contribuinte da cadeia, geralmente a indústria ou o importador, recolhe antecipadamente o imposto que seria devido nas etapas seguintes, até a venda ao consumidor final. Esse valor é calculado sobre uma base presumida, ou seja, uma estimativa de como a mercadoria vai circular e por quanto será vendida. Quando essa previsão não se confirma, a empresa que comprou a mercadoria com o imposto já retido pode ter pago ICMS a mais ou para o estado errado. O ressarcimento é o caminho para recuperar esse valor, dentro das regras definidas pela legislação de cada unidade da federação. ## Em quais situações a empresa tem direito ao ressarcimento? As hipóteses mais comuns são: venda da mercadoria para outro estado, quando o ICMS-ST foi pago ao estado de origem mas a operação passa a gerar imposto para o estado de destino; saída com isenção ou não incidência, como algumas exportações; e casos em que o fato gerador presumido não ocorre, como perda, furto, quebra ou perecimento da mercadoria. Também há discussão sobre o ressarcimento quando a mercadoria é vendida ao consumidor por valor menor que a base presumida. O Supremo Tribunal Federal reconheceu esse direito, mas a forma de aplicação depende das regras de cada estado, que podem exigir procedimentos e controles específicos. ## Como o valor é recuperado na prática? Dependendo do estado, a empresa pode usar o valor como crédito na sua própria apuração de ICMS, pedir que o fornecedor substituto o abata do imposto que ele recolhe, transferir o crédito a outro contribuinte ou solicitar a devolução em dinheiro. Cada modalidade tem exigências próprias de documentação e, em alguns casos, de autorização prévia do fisco. Um caminho frequente é a emissão de uma NF-e de ressarcimento, com CFOP específico para ressarcimento de ICMS retido por substituição tributária, destinada ao fornecedor que fez a retenção. Com esse documento, o substituto pode deduzir o valor do próximo recolhimento e acertar a diferença com o cliente. ## Quais documentos e controles são necessários? O direito ao ressarcimento precisa ser comprovado. Normalmente, a empresa deve relacionar cada saída à nota de entrada correspondente, mostrando quanto ICMS-ST foi retido na compra e qual foi o destino da mercadoria. Por isso, os XMLs de entrada e saída precisam estar guardados e organizados. Muitos estados exigem que essas informações apareçam na escrituração fiscal, em registros específicos da EFD ICMS/IPI, além de controles de estoque detalhados por produto. Erros de cadastro, como CFOP, CST ou CEST incorretos, costumam ser a principal causa de pedidos negados ou créditos glosados. ## Qual a relação do ressarcimento com a emissão de notas por API? Empresas que emitem NF-e a partir de ERPs ou plataformas próprias dependem de que os campos de ICMS-ST estejam preenchidos corretamente desde a origem: base de cálculo retida, valor do imposto retido, FCP-ST quando houver e o CFOP adequado. Esses dados alimentam o levantamento do valor a ressarcir. Uma API fiscal ajuda ao emitir a nota de ressarcimento a partir do próprio sistema, devolver XML e status automaticamente e manter um histórico consultável dos documentos. Isso facilita reunir as notas de entrada e saída que comprovam o crédito quando a empresa ou o contador montam o pedido. ## Exemplos de Ressarcimento de ICMS-ST - Um distribuidor de autopeças compra produtos com ICMS-ST retido pela fábrica e depois vende parte do estoque para clientes em outro estado. Como o imposto antecipado não se refere mais ao estado de origem, ele pede o ressarcimento do valor correspondente. - Um atacadista de alimentos perde um lote por vencimento e descarta as mercadorias. Como a venda ao consumidor nunca aconteceu, ele levanta o ICMS-ST pago sobre esse lote e solicita o ressarcimento conforme as regras do seu estado. - Um ERP integrado a uma API fiscal emite automaticamente uma NF-e de ressarcimento contra o fornecedor substituto, com o CFOP correto e o valor apurado no mês, e arquiva o XML autorizado junto às notas de entrada que comprovam a retenção. - Um varejista que vende cosméticos abaixo da base presumida usada no cálculo do ICMS-ST revisa, com seu contador, se a legislação estadual permite recuperar a diferença entre o imposto retido e o efetivamente devido. ## Perguntas frequentes ### Ressarcimento e restituição de ICMS-ST são a mesma coisa? São conceitos próximos e muitas vezes usados como sinônimos. Em geral, restituição indica devolução de imposto pago indevidamente, enquanto ressarcimento se refere à recuperação do ICMS-ST quando a operação presumida não ocorre. A nomenclatura exata varia na legislação de cada estado. ### Toda empresa pode pedir ressarcimento de ICMS-ST? Pode pedir quem adquiriu mercadoria com o imposto já retido e se enquadra em uma hipótese prevista na legislação estadual. Empresas do Simples Nacional também podem ter direito, mas as regras e procedimentos variam e devem ser confirmados com o contador. ### Existe prazo para solicitar o ressarcimento? Sim. Como regra geral, pedidos de recuperação de tributos estão sujeitos a prazo de prescrição, normalmente contado em anos a partir da operação. Cada estado pode definir procedimentos próprios, por isso é importante acompanhar as saídas mensalmente e não acumular pendências. ### O sistema emissor calcula o valor a ressarcir? Normalmente não. O emissor ou a API fiscal transmite as notas e devolve XML e status. O cálculo do valor a ressarcir costuma ser feito pelo ERP, por ferramentas fiscais ou pelo contador, cruzando entradas, saídas e estoque. ## Termos relacionados - [ICMS](https://conota.dev/glossario/icms.md) - [Antecipação tributária](https://conota.dev/glossario/antecipacao-tributaria.md) - [Aproveitamento de crédito tributário](https://conota.dev/glossario/aproveitamento-de-credito-tributario.md) - [CFOP](https://conota.dev/glossario/cfop.md) - [Fundo de Combate à Pobreza retido por substituição tributária](https://conota.dev/glossario/fundo-de-combate-a-pobreza-retido-por-substituicao-tributaria.md) --- Fonte: [Ressarcimento de ICMS-ST](https://conota.dev/glossario/ressarcimento-de-icms-st/) · Atualizado em 2026-10-22 --- # REST > REST é um estilo de arquitetura para construir APIs que se comunicam pela web usando o protocolo HTTP. Nele, cada informação é tratada como um recurso com endereço próprio, manipulado por métodos padronizados como GET, POST, PUT e DELETE, geralmente trocando dados em JSON. É o modelo mais comum em integrações modernas, inclusive fiscais. **Também conhecido como:** RESTful, API REST, Arquitetura REST, Estilo REST, REST, Representational State Transfer **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** R ## O que significa REST na prática? REST não é um programa nem uma linguagem. É um conjunto de regras e boas práticas para organizar a comunicação entre sistemas pela internet. Quando uma API segue essas regras, ela é chamada de API REST ou RESTful. A ideia central é simples: tudo o que o sistema oferece é um recurso, como uma nota fiscal, uma empresa ou um certificado. Cada recurso tem um endereço (a URL) e pode ser consultado, criado, alterado ou removido usando os mesmos verbos do HTTP, o protocolo que os navegadores já usam para abrir páginas. ## Como funciona uma API REST? O sistema que quer algo (o cliente) envia uma requisição HTTP para um endereço da API, chamado endpoint. A requisição informa o método, que indica a intenção: GET para consultar, POST para criar, PUT ou PATCH para atualizar e DELETE para remover. Quando há dados a enviar, eles vão no corpo da requisição, normalmente em JSON. O servidor processa o pedido e devolve uma resposta com um código de status e, se for o caso, um corpo com dados. Os códigos seguem um padrão: a faixa 200 indica sucesso, a faixa 400 indica erro do cliente (como dados inválidos ou falta de autenticação) e a faixa 500 indica falha no servidor. Por exemplo, um ERP pode enviar um POST com os dados de uma venda para um endpoint de emissão de NF-e e, depois, fazer um GET no endereço daquela nota para saber se ela já foi autorizada. ## Quais são os princípios de uma API REST? Separação entre cliente e servidor: cada lado evolui de forma independente, desde que a forma de comunicação seja mantida. Comunicação sem estado (stateless): cada requisição carrega tudo o que é necessário para ser entendida, incluindo a autenticação, sem depender de conversas anteriores. Interface uniforme: recursos identificados por URLs e manipulados pelos mesmos métodos padronizados, o que torna a API previsível. Há ainda a possibilidade de cache de respostas e a organização em camadas, permitindo usar gateways e balanceadores sem que o cliente perceba. ## Qual a diferença entre REST e SOAP? SOAP é um protocolo mais antigo e rígido, baseado em mensagens XML com envelopes e contratos formais. REST é um estilo mais leve e flexível, que aproveita diretamente os recursos do HTTP e costuma usar JSON, um formato mais fácil de ler e de gerar. No mundo fiscal essa diferença aparece bastante: os web services da SEFAZ para NF-e, por exemplo, usam SOAP com XML assinado. Uma API fiscal REST pode receber os dados em JSON, montar o XML no padrão exigido, assiná-lo e conversar com os órgãos autorizadores, poupando o sistema do cliente dessa complexidade. ## Por que REST é tão usado na emissão fiscal por API? Porque praticamente toda linguagem de programação sabe fazer requisições HTTP e trabalhar com JSON. Isso reduz o tempo de integração de ERPs, plataformas de venda e marketplaces, que podem emitir NF-e, NFC-e, NFS-e, CT-e e MDF-e por uma interface única e padronizada. O modelo também combina bem com fluxos assíncronos: o sistema envia o documento, recebe uma resposta imediata de que o pedido foi aceito e depois consulta o status ou recebe um webhook com o resultado, o XML e o PDF. ## Exemplos de REST - Um ERP envia um POST para o endpoint de NFC-e com os itens da venda em JSON e recebe como resposta um identificador do documento e o status inicial de processamento. - Uma plataforma de serviços faz um GET no endereço de uma NFS-e específica para verificar se a prefeitura já autorizou a nota e obter o link do PDF. - Um marketplace recebe o código de status 401 ao chamar a API porque a API Key enviada no header de autenticação estava expirada. - Uma transportadora consulta, via GET com query parameters de data e status, a lista de MDF-e ainda não encerrados. ## Perguntas frequentes ### REST e API são a mesma coisa? Não. API é qualquer interface que permite a comunicação entre sistemas. REST é um estilo específico de construir APIs, baseado em recursos, URLs e métodos HTTP. Existem APIs que seguem outros modelos, como SOAP ou JSON-RPC. ### Uma API REST precisa usar JSON? Não obrigatoriamente. REST aceita outros formatos, como XML. Porém, JSON se tornou o padrão de fato por ser leve e simples de manipular. Em APIs fiscais, é comum enviar dados em JSON e receber o XML fiscal como arquivo de retorno. ### Uma API REST é segura? A segurança depende da implementação. Boas APIs REST usam HTTPS para criptografar a comunicação, exigem autenticação a cada requisição (como API Key ou Bearer token), aplicam limites de requisições e registram acessos para auditoria. ## Termos relacionados - [API REST para emissão fiscal](https://conota.dev/glossario/api-rest-para-emissao-fiscal.md) - [HTTP](https://conota.dev/glossario/http.md) - [SOAP](https://conota.dev/glossario/soap.md) - [Endpoint de API](https://conota.dev/glossario/endpoint-de-api.md) - [JSON](https://conota.dev/glossario/json.md) - [API fiscal](https://conota.dev/glossario/api-fiscal.md) --- Fonte: [REST](https://conota.dev/glossario/rest/) · Atualizado em 2026-10-22 --- # Restituição tributária > Restituição tributária é a devolução, pelo Fisco ao contribuinte, de valores de tributos pagos indevidamente ou a maior, seja por erro de cálculo, pagamento em duplicidade, cobrança sem base legal ou base presumida maior que a real. Depende de pedido formal e de comprovação documental, e o valor costuma ser corrigido monetariamente. **Também conhecido como:** Repetição de indébito, Restituição de tributos, Restituição de indébito tributário, Devolução de tributo pago indevidamente, Tax refund **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** R ## O que é restituição tributária? Restituição tributária é o direito que a empresa ou a pessoa física tem de receber de volta um imposto ou contribuição que pagou sem dever, ou que pagou em valor maior do que o correto. Quem devolve é o órgão arrecadador: a Receita Federal, a Secretaria da Fazenda do estado ou a prefeitura, conforme o tributo. No meio jurídico, esse direito também é chamado de repetição de indébito. Indébito significa algo que não era devido, e repetição, nesse contexto, quer dizer devolução. ## Em quais situações é possível pedir restituição tributária? As situações mais comuns são o pagamento em duplicidade da mesma guia, o erro na alíquota ou na base de cálculo, a aplicação de um tributo a uma operação isenta, imune ou fora da incidência, e o recolhimento feito com código ou competência errados. Também há casos ligados à substituição tributária do ICMS. Nesse regime, o imposto é recolhido antecipadamente sobre um valor presumido. Se a venda não acontece, ou se, conforme as regras de cada estado, ela ocorre por valor menor que o presumido, pode surgir o direito de recuperar a diferença. Erros na emissão de documentos fiscais também podem gerar restituição. Uma NF-e ou NFS-e emitida com tributação incorreta, ou cancelada depois de o imposto já ter sido pago, pode levar ao recolhimento de um valor que não era devido. ## Como funciona o pedido de restituição tributária? Em geral, o contribuinte faz um pedido formal ao órgão responsável, quase sempre por sistema eletrônico, informando o tributo, o período, o valor pago e o motivo do pedido. É preciso comprovar o pagamento com guias e comprovantes e demonstrar o erro com documentos fiscais, livros e declarações. O Fisco analisa o pedido e pode solicitar mais documentos ou indeferi-lo. Antes de pedir, normalmente é necessário corrigir as declarações e escriturações que continham o erro, para que as informações enviadas ao Fisco fiquem coerentes com o valor que se quer recuperar. Quando o pedido é negado na esfera administrativa, o contribuinte pode recorrer dentro do próprio órgão ou buscar a via judicial. ## Qual a diferença entre restituição, compensação e ressarcimento? Na restituição, o contribuinte recebe o dinheiro de volta. Na compensação, o valor pago indevidamente é usado para quitar outros tributos que a empresa deve, sem que haja devolução em dinheiro. Para empresas com débitos recorrentes, a compensação costuma ser o caminho mais rápido. O ressarcimento é um pouco diferente: não se trata de um pagamento errado, mas da devolução de créditos acumulados que a legislação permite recuperar, como certos créditos de PIS, COFINS, IPI ou ICMS que a empresa não consegue aproveitar nas suas próprias apurações. ## Existe prazo para pedir restituição tributária? Sim. Pela regra geral do Código Tributário Nacional, o prazo é de cinco anos, normalmente contados a partir do pagamento indevido. Depois disso, o direito de pedir a devolução se perde. Por isso, vale revisar periodicamente os recolhimentos e não deixar erros antigos acumularem. Cada tributo e cada ente público pode ter procedimentos próprios, então é recomendável confirmar as regras específicas com a contabilidade. ## Como a emissão correta de notas fiscais ajuda a evitar pedidos de restituição? Grande parte dos pagamentos indevidos começa em um documento fiscal com dados errados, como CST, CFOP, alíquota ou base de cálculo incorretos. Como a apuração de tributos se apoia nas notas emitidas, o erro se propaga até a guia de pagamento. Sistemas que emitem documentos por API, com regras tributárias bem configuradas, validação antes do envio e acesso fácil ao XML e ao status de cada nota, reduzem esses erros. Também facilitam reunir as provas quando uma restituição precisa ser pedida, já que o histórico de emissão, os cancelamentos e os eventos ficam organizados e disponíveis para consulta. ## Exemplos de Restituição tributária - Uma indústria pagou duas vezes a mesma guia de IPI por falha no processo de contas a pagar e pediu a restituição do valor recolhido em duplicidade. - Um distribuidor recolheu ICMS por substituição tributária sobre uma mercadoria que acabou sendo furtada antes da venda e solicitou a restituição do imposto antecipado. - Uma empresa de software emitiu NFS-e com alíquota de ISS acima da prevista na legislação do município, recolheu o imposto a maior e, após corrigir as declarações, pediu a devolução da diferença à prefeitura. - Um ERP integrado à API fiscal identificou notas canceladas cujo imposto já havia sido apurado, permitindo que a contabilidade levantasse os valores e pedisse a compensação com débitos do mês seguinte. ## Perguntas frequentes ### A restituição tributária vem corrigida? Em geral, sim. O valor devolvido costuma ser atualizado. No âmbito federal, a correção normalmente segue a taxa SELIC. Estados e municípios podem adotar índices próprios definidos em sua legislação. ### Empresa do Simples Nacional pode pedir restituição? Sim. Empresas do Simples Nacional também podem recuperar valores pagos indevidamente ou a maior no DAS, seguindo os procedimentos próprios do regime, que podem exigir a retificação da declaração antes do pedido. ### Cancelar uma nota fiscal já gera restituição automática? Não. O cancelamento anula o documento, mas o imposto já recolhido não volta sozinho. É preciso ajustar a apuração e, se houver pagamento a maior, pedir a restituição ou a compensação. ### Quais documentos são necessários para pedir restituição? Normalmente, os comprovantes de pagamento, os documentos fiscais envolvidos, como o XML das notas, as declarações e escriturações corrigidas e uma demonstração clara de como o valor indevido foi calculado. ## Termos relacionados - [Aproveitamento de crédito tributário](https://conota.dev/glossario/aproveitamento-de-credito-tributario.md) - [Antecipação tributária](https://conota.dev/glossario/antecipacao-tributaria.md) - [Apuração de tributos](https://conota.dev/glossario/apuracao-de-tributos.md) - [Estorno de crédito tributário](https://conota.dev/glossario/estorno-de-credito-tributario.md) - [Juros SELIC em débitos fiscais](https://conota.dev/glossario/juros-selic-em-debitos-fiscais.md) - [Fisco](https://conota.dev/glossario/fisco.md) --- Fonte: [Restituição tributária](https://conota.dev/glossario/restituicao-tributaria/) · Atualizado em 2026-10-22 --- # Retenção de IRRF > Retenção de IRRF é o mecanismo em que quem paga por um serviço desconta o Imposto de Renda Retido na Fonte do valor devido ao prestador e recolhe esse imposto diretamente à Receita Federal. Na prática, o prestador recebe o valor líquido, e a retenção aparece destacada na nota fiscal de serviço, especialmente na NFS-e. **Também conhecido como:** Retenção do Imposto de Renda na Fonte, IR retido na fonte, Retenção de IR, IRRF retido, IRRF, Withholding income tax **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** R ## O que é a retenção de IRRF? Retenção de IRRF é quando o imposto de renda é cobrado antes mesmo de o dinheiro chegar a quem prestou o serviço. Em vez de o prestador pagar tudo depois, o tomador do serviço, ou seja, a empresa que contrata e paga, separa uma parte do valor e repassa ao governo. Por isso se diz que o imposto é retido na fonte: a fonte do pagamento é quem faz a retenção. O valor retido funciona como uma antecipação do imposto de renda que o prestador deve. Depois, ele pode compensar esse valor na apuração dos seus próprios tributos. ## Quando a retenção de IRRF acontece? A retenção é comum quando uma pessoa jurídica paga outra pessoa jurídica por certos serviços, principalmente os profissionais, como consultoria, advocacia, engenharia, contabilidade e auditoria. Também ocorre em serviços como limpeza, conservação, segurança e locação de mão de obra, além de pagamentos a pessoas físicas, como salários e aluguéis. Nem todo serviço sofre retenção. A obrigação depende do tipo de atividade, de quem paga e de quem recebe. Empresas optantes pelo Simples Nacional, por exemplo, em geral não sofrem retenção de IRRF sobre os serviços que prestam. Por isso, é importante conferir as regras com a contabilidade antes de emitir a nota. ## Como a retenção de IRRF é calculada? O cálculo parte da base de cálculo, que normalmente é o valor bruto do serviço, sobre a qual se aplica a alíquota prevista para aquela atividade. Para serviços profissionais prestados entre empresas, a alíquota mais conhecida é de 1,5%, enquanto alguns serviços, como limpeza e segurança, costumam ter alíquota de 1%. Exemplo simples: em um serviço de consultoria de R$ 10.000,00 com alíquota de 1,5%, o tomador retém R$ 150,00, paga R$ 9.850,00 ao prestador e recolhe os R$ 150,00 à Receita Federal. Existe ainda uma regra de dispensa para valores de imposto muito pequenos, que deve ser verificada na legislação vigente. ## Como a retenção de IRRF aparece na nota fiscal? Na NFS-e, há campos específicos para informar tributos federais retidos, entre eles o IRRF. O prestador informa o valor retido, e o documento mostra tanto o valor bruto do serviço quanto o valor líquido a receber, já descontadas as retenções. Quando a emissão é feita por API, o sistema da empresa, como um ERP ou uma plataforma de vendas, envia esses valores nos campos correspondentes do documento. Se o valor informado não bater com a base de cálculo ou com as regras do município ou do layout nacional, a nota pode ser rejeitada e precisar de correção antes da autorização. ## Qual a diferença entre IRRF e retenção de IRRF? IRRF é o nome do imposto: Imposto de Renda Retido na Fonte. Retenção de IRRF é o ato de descontar e recolher esse imposto no momento do pagamento. Um é o tributo; o outro é o procedimento que coloca esse tributo em prática. Também é comum a retenção de IRRF acontecer junto com outras retenções federais, como CSLL, PIS e COFINS, e com o INSS retido na nota fiscal. Cada uma tem regras e alíquotas próprias, embora apareçam lado a lado no documento. ## Exemplos de Retenção de IRRF - Uma consultoria de TI emite uma NFS-e de R$ 20.000,00 para uma indústria, informa a retenção de IRRF de 1,5% e destaca R$ 300,00 retidos, recebendo o valor líquido da cliente. - Um ERP integrado ao emissor fiscal calcula automaticamente o IRRF retido conforme o tipo de serviço cadastrado e envia o valor no campo de tributos federais retidos ao emitir a NFS-e por API. - Uma empresa de limpeza presta serviço a um shopping, que retém o IRRF no pagamento da fatura e recolhe o imposto à Receita Federal, enquanto a nota mostra o valor bruto e o líquido. - Um software de gestão recebe uma rejeição porque o valor do IRRF retido foi informado maior que o permitido para a base de cálculo, e a equipe corrige o cálculo antes de reenviar a nota. ## Perguntas frequentes ### Quem é responsável por recolher o IRRF retido? O tomador do serviço, ou seja, a empresa que paga. Ela desconta o imposto do valor devido ao prestador e faz o recolhimento à Receita Federal dentro do prazo legal. ### Empresa do Simples Nacional sofre retenção de IRRF? Em geral, não sobre os serviços que presta, pois o imposto de renda já está incluído no recolhimento unificado do Simples Nacional. Ainda assim, há situações específicas, então vale confirmar com a contabilidade. ### O prestador perde o valor retido? Não. O valor retido é uma antecipação do imposto de renda devido pelo prestador e pode ser compensado na apuração dos seus tributos, desde que a retenção esteja corretamente documentada. ### A API fiscal calcula a retenção de IRRF sozinha? Depende da integração. Normalmente, o sistema da empresa define as regras e envia os valores retidos; a API transmite o documento, valida a estrutura e devolve o status, como autorização ou rejeição. ## Termos relacionados - [IRRF](https://conota.dev/glossario/irrf.md) - [INSS retido na nota fiscal](https://conota.dev/glossario/inss-retido-na-nota-fiscal.md) - [CSLL](https://conota.dev/glossario/csll.md) - [COFINS](https://conota.dev/glossario/cofins.md) - [Base de cálculo](https://conota.dev/glossario/base-de-calculo.md) - [ISSQN](https://conota.dev/glossario/issqn.md) --- Fonte: [Retenção de IRRF](https://conota.dev/glossario/retencao-de-irrf/) · Atualizado em 2026-10-22 --- # Retenção de ISSQN > Retenção de ISSQN é o mecanismo em que o tomador de um serviço desconta o valor do imposto municipal sobre serviços do pagamento ao prestador e recolhe esse valor diretamente à prefeitura. Nesse caso, quem paga o imposto ao município deixa de ser o prestador e passa a ser o contratante, conforme as regras da legislação municipal. **Também conhecido como:** ISS retido, Retenção de ISS, ISSQN retido na fonte, ISS retido na fonte, Substituição tributária do ISS, Service tax withholding **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** R ## O que é a retenção de ISSQN? O ISSQN (Imposto Sobre Serviços de Qualquer Natureza) normalmente é pago pelo prestador de serviço, que emite a NFS-e e recolhe o imposto à prefeitura. Na retenção, essa responsabilidade passa para o tomador de serviço, ou seja, quem contratou o serviço. Na prática, o tomador recebe a nota, desconta do valor a pagar a parte correspondente ao ISSQN e depois recolhe esse valor ao município por meio de guia própria. O prestador recebe o valor líquido, já sem o imposto, e não precisa recolhê-lo de novo. ## Quando o ISSQN deve ser retido? A retenção não é automática em todo serviço. Ela depende de regras definidas pela legislação nacional do imposto e, principalmente, pelas leis de cada município. Fatores comuns que influenciam a decisão são o tipo de serviço prestado, o local onde ele é executado, o município do prestador e do tomador e o fato de o tomador ser pessoa jurídica. Alguns serviços, como os executados no estabelecimento do tomador ou em obras, costumam ter regras específicas de incidência e retenção. Muitas prefeituras também obrigam determinados tomadores, como grandes empresas ou órgãos públicos, a reter o imposto. Por isso, a análise deve ser feita caso a caso, de preferência com apoio contábil. ## Como a retenção aparece na NFS-e? Ao emitir a NFS-e, o prestador informa se o ISSQN é retido ou não. No Padrão Nacional da NFS-e, a DPS possui um campo que indica se o imposto não é retido, se é retido pelo tomador ou se é retido por um intermediário. Nos sistemas municipais próprios, existe um campo equivalente, geralmente chamado de ISS retido. Quando a retenção é marcada, a nota mostra o valor do ISSQN retido e um valor líquido menor que o valor total do serviço. Esse valor líquido é o que o tomador efetivamente paga ao prestador. Informar a retenção de forma errada pode gerar rejeição fiscal, cobrança em duplicidade ou falta de recolhimento. ## Como se calcula o valor retido? O cálculo segue a mesma lógica do ISSQN comum: aplica-se a alíquota tributária do serviço sobre a base de cálculo do ISSQN. Por exemplo, em um serviço de 10.000 reais com alíquota de 5%, o valor retido é de 500 reais, e o prestador recebe 9.500 reais, sem considerar outras retenções. Para empresas optantes pelo Simples Nacional, a alíquota usada na retenção costuma ser a informada pelo próprio prestador na nota, de acordo com sua faixa de faturamento. Deduções permitidas pelo município também podem reduzir a base de cálculo antes da aplicação da alíquota. ## Por que a retenção importa para quem emite NFS-e por API? Em sistemas que emitem notas automaticamente, como ERPs e plataformas de serviço, a regra de retenção precisa estar parametrizada por cliente, serviço e município. Se o sistema enviar sempre o mesmo valor no campo de retenção, o risco de erro é alto. Uma API fiscal recebe essa informação no payload de emissão e a transmite à prefeitura autorizadora ou ao ambiente nacional. Testar os cenários com e sem retenção no ambiente de homologação ajuda a evitar rejeições e divergências de valores em produção. ## Exemplos de Retenção de ISSQN - Uma agência de marketing de São Paulo presta serviço a uma indústria que, pela regra municipal, é obrigada a reter o ISSQN. A agência emite a NFS-e marcando o imposto como retido pelo tomador, e a indústria paga o valor líquido e recolhe o ISSQN à prefeitura. - Uma empresa de limpeza executa serviços dentro do estabelecimento de um cliente em outro município. O ISSQN é devido no local da prestação, e o cliente retém o imposto e o recolhe ao seu município. - Um ERP de serviços cadastra, para cada tomador, se há retenção de ISSQN. Ao gerar a nota, o sistema envia o indicador de retenção pela API, e a NFS-e autorizada já retorna com o valor líquido correto. - Uma prestadora optante pelo Simples Nacional informa na NFS-e a alíquota correspondente à sua faixa, e o tomador usa esse percentual para calcular o valor que vai reter. ## Perguntas frequentes ### Quem recolhe o ISSQN quando ele é retido? O tomador do serviço. Ele desconta o imposto do pagamento ao prestador e recolhe o valor à prefeitura por meio de guia própria. O prestador não deve recolher o mesmo imposto novamente. ### O prestador pode decidir se quer ou não reter o ISSQN? Não. A retenção decorre da legislação, especialmente das leis municipais, considerando o tipo de serviço, o local da prestação e o perfil do tomador. O prestador apenas informa corretamente a situação na NFS-e. ### O que acontece se a retenção for informada errada na nota? Pode haver recolhimento em duplicidade, falta de recolhimento, divergência no valor pago e autuação fiscal. Em geral, é preciso cancelar ou substituir a NFS-e, conforme as regras do município. ### MEI sofre retenção de ISSQN? Em regra, o MEI recolhe o ISS em valor fixo mensal no DAS e não sofre retenção na fonte. Ainda assim, vale confirmar com a contabilidade as particularidades do município. ## Termos relacionados - [ISSQN](https://conota.dev/glossario/issqn.md) - [NFS-e](https://conota.dev/glossario/nfs-e.md) - [Tomador de serviço](https://conota.dev/glossario/tomador-de-servico.md) - [Prestador de serviço](https://conota.dev/glossario/prestador-de-servico.md) - [Base de cálculo do ISSQN](https://conota.dev/glossario/base-de-calculo-do-issqn.md) - [Local de incidência do ISSQN](https://conota.dev/glossario/local-de-incidencia-do-issqn.md) --- Fonte: [Retenção de ISSQN](https://conota.dev/glossario/retencao-de-issqn/) · Atualizado em 2026-10-22 --- # Retenção de PIS COFINS e CSLL > Retenção de PIS, COFINS e CSLL é o mecanismo em que a empresa que contrata certos serviços desconta esses três tributos do valor pago ao prestador e os recolhe diretamente à Receita Federal. O desconto aparece na nota fiscal de serviço e antecipa parte das contribuições que o próprio prestador deveria pagar. **Também conhecido como:** CSRF, Contribuições Sociais Retidas na Fonte, Retenção de PIS/COFINS/CSLL, Retenção de contribuições sociais, Retenção de 4,65% **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** R ## O que é a retenção de PIS, COFINS e CSLL? É uma forma de cobrança antecipada de tributos federais. Em vez de o prestador de serviço pagar sozinho todo o PIS, a COFINS e a CSLL, quem contrata o serviço segura uma parte do valor da nota e faz o recolhimento em nome do prestador. Na prática, o tomador paga ao prestador o valor da nota menos o montante retido. Esse valor retido não é perdido: o prestador pode descontá-lo dos tributos que apura no período. Por ser feita na fonte do pagamento, essa retenção também é conhecida como CSRF, sigla de Contribuições Sociais Retidas na Fonte. ## Quais serviços estão sujeitos à retenção? A regra geral, prevista no artigo 30 da Lei 10.833/2003, alcança pagamentos feitos por pessoas jurídicas a outras pessoas jurídicas por serviços como limpeza, conservação, manutenção, segurança, vigilância, transporte de valores, locação de mão de obra, assessoria creditícia e mercadológica, gestão de crédito, administração de contas a pagar e a receber e serviços profissionais, como advocacia, consultoria e engenharia. Venda de mercadorias não sofre essa retenção. Por isso, ela aparece principalmente em notas fiscais de serviço, a NFS-e, e não na NF-e de produtos. ## Como é feito o cálculo? Na regra geral, aplica-se um percentual total de 4,65% sobre o valor bruto do serviço, dividido em 0,65% de PIS, 3% de COFINS e 1% de CSLL. Em uma nota de R$ 10.000,00, por exemplo, a retenção seria de R$ 465,00, e o prestador receberia R$ 9.535,00, desconsiderando outras retenções. Existe dispensa de retenção quando o valor a reter é muito pequeno, abaixo de um limite mínimo definido na legislação. Como regras e limites podem mudar, é recomendável que o contador confirme os parâmetros vigentes antes de configurar o sistema. ## Quem não sofre a retenção? Empresas optantes pelo Simples Nacional, em regra, não sofrem essa retenção, desde que informem sua condição ao tomador. Também há tratamentos diferentes para algumas situações específicas previstas em lei, como pagamentos feitos por órgãos públicos federais, que seguem regras próprias de retenção, incluindo o imposto de renda. Por isso, o regime tributário do prestador e a natureza do tomador precisam estar corretos no cadastro do sistema emissor, para evitar retenções indevidas ou omitidas. ## Como a retenção aparece na emissão da NFS-e? Os documentos de serviço possuem campos próprios para informar os valores retidos de PIS, COFINS e CSLL, ao lado de outras retenções, como IRRF, INSS e ISSQN. O valor líquido da nota é calculado a partir do valor bruto menos todas essas retenções. Em uma integração por API, o sistema do cliente, como um ERP, envia esses valores no pedido de emissão. A infraestrutura fiscal transmite o documento ao município ou ao ambiente nacional e devolve XML, PDF e status. Informar campos errados pode gerar rejeição ou divergências na escrituração. ## Qual a diferença entre retenção e pagamento normal dessas contribuições? No pagamento normal, o próprio prestador calcula e recolhe PIS, COFINS e CSLL sobre seu faturamento ou lucro. Na retenção, parte desse valor é recolhida antecipadamente pelo tomador, que passa a ser responsável pelo pagamento daquela parcela. O prestador depois compensa o que foi retido na sua apuração. Já o tomador precisa declarar e recolher o valor retido, informando a retenção nas obrigações acessórias, como a EFD-Reinf. ## Exemplos de Retenção de PIS COFINS e CSLL - Uma empresa de limpeza optante pelo Lucro Presumido emite uma NFS-e de R$ 20.000,00 para um condomínio comercial administrado por pessoa jurídica. A nota informa retenção de R$ 930,00 de PIS, COFINS e CSLL, e o tomador paga o valor líquido. - Um ERP de uma consultoria envia pela API fiscal o pedido de emissão da NFS-e já com os campos de PIS, COFINS e CSLL retidos preenchidos, e recebe de volta o XML autorizado com o valor líquido calculado. - Um software de gestão identifica que o prestador é optante pelo Simples Nacional e não preenche os valores retidos, evitando um desconto indevido no pagamento. - O departamento financeiro de uma indústria usa os XMLs das NFS-e recebidas para conferir quanto reteve de cada fornecedor e preparar o recolhimento e a declaração do mês. ## Perguntas frequentes ### Quem paga a retenção de PIS, COFINS e CSLL? O tributo pertence ao prestador do serviço, mas quem recolhe aos cofres públicos é o tomador, que desconta o valor no momento do pagamento da nota. ### A retenção acontece na venda de produtos? Não. Em regra, ela se aplica a determinados serviços prestados entre pessoas jurídicas, por isso aparece em notas de serviço, como a NFS-e, e não na NF-e de mercadorias. ### O prestador perde o valor retido? Não. O valor retido funciona como antecipação. O prestador pode deduzi-lo dos valores de PIS, COFINS e CSLL que apura no período, desde que a retenção esteja corretamente comprovada. ### Empresa do Simples Nacional sofre essa retenção? Em regra, não. O prestador optante pelo Simples Nacional deve informar sua condição ao tomador, que então deixa de reter essas contribuições. ## Termos relacionados - [COFINS](https://conota.dev/glossario/cofins.md) - [CSLL](https://conota.dev/glossario/csll.md) - [IRRF](https://conota.dev/glossario/irrf.md) - [INSS retido na nota fiscal](https://conota.dev/glossario/inss-retido-na-nota-fiscal.md) - [ISSQN](https://conota.dev/glossario/issqn.md) - [EFD-Contribuições](https://conota.dev/glossario/efd-contribuicoes.md) --- Fonte: [Retenção de PIS COFINS e CSLL](https://conota.dev/glossario/retencao-de-pis-cofins-e-csll/) · Atualizado em 2026-10-22 --- # Retenção previdenciária > Retenção previdenciária é o desconto de contribuição ao INSS feito pela empresa contratante sobre o valor de certos serviços, principalmente os prestados por cessão de mão de obra ou empreitada. A contratante desconta o valor da nota fiscal, paga menos ao prestador e recolhe a quantia diretamente à Previdência, em nome de quem prestou o serviço. **Também conhecido como:** Retenção de INSS, Retenção do INSS sobre serviços, Retenção de 11% do INSS, Contribuição previdenciária retida, Social security withholding **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** R ## O que é retenção previdenciária? É um mecanismo em que quem contrata o serviço passa a ser responsável por recolher parte da contribuição previdenciária devida pelo prestador. Em vez de o prestador receber o valor total e pagar o INSS depois, a contratante já desconta essa parcela no pagamento e faz o recolhimento. Na prática, a nota fiscal mostra o valor bruto do serviço e o valor do INSS retido. O prestador recebe a diferença e depois pode compensar o valor retido com as contribuições que deve sobre a folha de pagamento dos seus funcionários. ## Para que serve a retenção previdenciária? O objetivo é garantir que a contribuição seja efetivamente recolhida. Em serviços com muitos trabalhadores cedidos a terceiros, como limpeza, vigilância e construção, o governo transfere a obrigação para a contratante, que costuma ter mais estrutura e é mais fácil de fiscalizar. Para o prestador, o valor retido não é um custo a mais: funciona como uma antecipação do que ele já teria de pagar sobre a folha. ## Em quais serviços acontece a retenção previdenciária? A regra geral se aplica a serviços executados mediante cessão de mão de obra, quando trabalhadores do prestador ficam à disposição da contratante, e a serviços por empreitada, como obras e reformas. A lista detalhada de atividades sujeitas está na legislação previdenciária e deve ser conferida caso a caso. Há situações específicas: empresas do Simples Nacional em geral não sofrem retenção, com exceções para algumas atividades, e empresas que contribuem sobre a receita bruta podem ter percentual diferente. Por isso, o enquadramento deve ser validado com a contabilidade. ## Como é calculada a retenção previdenciária? Na regra geral, aplica-se a alíquota de 11% sobre o valor bruto dos serviços informado na nota fiscal. Em alguns casos, é possível excluir da base de cálculo valores de materiais ou equipamentos, desde que discriminados no documento e previstos em contrato. Exemplo simples: em um serviço de R$ 10.000,00 sujeito a 11%, a contratante retém R$ 1.100,00, paga R$ 8.900,00 ao prestador e recolhe os R$ 1.100,00 ao INSS. ## Como a retenção previdenciária aparece na nota fiscal eletrônica? Na NFS-e existe um campo próprio para informar o valor do INSS retido, ao lado de outras retenções como IRRF, PIS, COFINS, CSLL e ISSQN. O valor líquido da nota já considera esses descontos. Em sistemas que emitem notas por API, o software de gestão envia a base de cálculo e o valor retido no momento da emissão. A informação precisa estar correta, porque a contratante também declara essa retenção nas obrigações acessórias, como a EFD-Reinf, e os dados devem bater. ## Qual a diferença entre retenção previdenciária e INSS do funcionário? O INSS descontado no salário do empregado é a contribuição do próprio trabalhador, retida pelo empregador na folha. Já a retenção previdenciária ocorre entre empresas: é feita pela contratante sobre a nota fiscal de serviço emitida pelo prestador. São obrigações diferentes, com bases de cálculo e responsáveis distintos, embora ambas acabem destinadas à Previdência Social. ## Exemplos de Retenção previdenciária - Uma empresa de limpeza emite NFS-e de R$ 20.000,00 para um condomínio comercial e informa R$ 2.200,00 de INSS retido; o cliente paga o valor líquido e recolhe a retenção. - Uma construtora contratada por empreitada discrimina na nota o valor dos materiais aplicados, reduzindo a base de cálculo da retenção conforme permitido em contrato. - Um ERP de prestadoras de vigilância calcula automaticamente o INSS retido de cada contrato e envia o valor no JSON de emissão da NFS-e via API. - Uma empresa do Simples Nacional que presta consultoria emite a nota sem retenção previdenciária, pois sua atividade não está sujeita à regra. ## Perguntas frequentes ### Quem recolhe o valor da retenção previdenciária? A empresa contratante. Ela desconta o valor do pagamento ao prestador e faz o recolhimento à Previdência em nome dele, dentro do prazo legal. ### O prestador perde o valor retido? Não. O valor retido pode ser compensado com as contribuições previdenciárias que o prestador deve sobre a folha de pagamento. Se sobrar saldo, existem procedimentos para compensação ou restituição. ### Toda nota fiscal de serviço tem retenção de INSS? Não. A retenção vale principalmente para cessão de mão de obra e empreitada, e há exceções conforme o regime tributário do prestador. Cada caso deve ser verificado com a contabilidade. ### Erro no valor retido invalida a nota? Nem sempre impede a autorização, mas gera divergência fiscal. O ideal é cancelar e reemitir a nota ou corrigi-la conforme as regras do município, e alinhar a declaração da contratante. ## Termos relacionados - [INSS retido na nota fiscal](https://conota.dev/glossario/inss-retido-na-nota-fiscal.md) - [IRRF](https://conota.dev/glossario/irrf.md) - [ISSQN](https://conota.dev/glossario/issqn.md) - [Base de cálculo](https://conota.dev/glossario/base-de-calculo.md) - [Dedução na NFS-e](https://conota.dev/glossario/deducao-na-nfs-e.md) - [DPS da NFS-e](https://conota.dev/glossario/dps-da-nfs-e.md) --- Fonte: [Retenção previdenciária](https://conota.dev/glossario/retencao-previdenciaria/) · Atualizado em 2026-10-22 --- # Retry na integração fiscal > Retry na integração fiscal é a nova tentativa automática de enviar uma requisição, como a emissão ou consulta de um documento fiscal, quando a primeira tentativa falha por um problema temporário, como queda de rede ou lentidão da SEFAZ ou da prefeitura. Bem feito, evita perder emissões sem gerar notas duplicadas. **Também conhecido como:** Retentativa, Nova tentativa automática, Reenvio automático, Política de retry, Retry **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** R ## O que é retry na integração fiscal? Retry, palavra em inglês para "tentar de novo", é o mecanismo que faz um sistema repetir uma requisição que não deu certo. Na integração fiscal, isso acontece quando um ERP, uma plataforma de vendas ou um marketplace tenta emitir, consultar ou cancelar uma NF-e, NFS-e, NFC-e, CT-e ou MDF-e e recebe um erro ou não recebe resposta nenhuma. Em vez de desistir na primeira falha ou depender de alguém clicar em "reenviar", o próprio sistema aguarda um pouco e tenta novamente, seguindo regras definidas pela equipe de desenvolvimento. ## Quando vale a pena fazer retry? O retry só faz sentido para falhas temporárias, aquelas que podem se resolver sozinhas com o tempo. Exemplos: perda momentânea de conexão, timeout, erros de servidor indisponível (códigos HTTP da faixa 5xx), excesso de requisições (HTTP 429) ou instabilidade no órgão autorizador. Já falhas permanentes não devem ser repetidas sem correção. Se a nota foi rejeitada porque o CFOP está errado, o NCM é inválido ou falta a inscrição estadual do destinatário, tentar de novo com os mesmos dados vai gerar a mesma rejeição. Nesses casos, o caminho é corrigir o payload e só então reenviar. ## Qual o risco de fazer retry sem cuidado? O maior risco é a duplicidade. Imagine que o sistema envia uma nota, a SEFAZ autoriza, mas a resposta se perde no caminho por um timeout. O sistema acha que falhou e envia de novo. Resultado: duas notas para a mesma venda, ou uma rejeição por numeração já utilizada, o que exige cancelamento e retrabalho. Para evitar isso, usa-se a idempotência: cada pedido de emissão carrega um identificador único, e a API reconhece que aquela requisição já foi recebida, devolvendo o resultado original em vez de criar um novo documento. Outra boa prática é consultar o status do documento antes de reenviar após um timeout. ## Como implementar um retry seguro? Um retry bem feito costuma combinar quatro cuidados: limitar o número máximo de tentativas; aumentar o intervalo entre elas com backoff exponencial (por exemplo, esperar 1, 2, 4, 8 segundos); adicionar uma pequena variação aleatória no tempo de espera para que muitos clientes não tentem todos ao mesmo tempo; e respeitar o tempo indicado pela API quando ela informa que o limite de requisições foi atingido. Também é recomendável registrar cada tentativa em log, com horário, erro recebido e identificador da requisição. Quando o número de tentativas se esgota, o documento deve ir para uma fila de pendências ou gerar um alerta, em vez de simplesmente sumir. ## Qual a diferença entre retry e reprocessamento? O retry é automático e imediato: acontece em segundos ou minutos, logo após a falha, sem mudar nada na requisição. O reprocessamento é uma nova tentativa feita depois, muitas vezes de forma manual ou em lote, geralmente após corrigir dados, renovar um certificado digital ou esperar o fim de uma indisponibilidade prolongada. Em resumo, o retry resolve tropeços passageiros; o reprocessamento resolve problemas que exigiram alguma intervenção. ## Como o retry funciona em uma API fiscal assíncrona? Em um fluxo assíncrono, a API fiscal recebe o pedido, devolve uma confirmação de recebimento e segue acompanhando o documento até a autorização junto à SEFAZ ou à prefeitura. Nesse modelo, o sistema do cliente precisa se preocupar principalmente com o retry da chamada à API, e não com cada etapa da comunicação com o órgão autorizador. Plataformas como o Conota, que acompanham cada documento até a autorização e devolvem XML, PDF e status automaticamente, reduzem a necessidade de lógica complexa de nova tentativa no ERP. Ainda assim, é boa prática que o sistema do cliente trate falhas de rede, use identificadores de idempotência e acompanhe o status por webhook ou polling. ## Exemplos de Retry na integração fiscal - Um e-commerce envia a emissão de uma NF-e, recebe timeout e, antes de reenviar, consulta o status pelo identificador do pedido. Descobre que a nota já foi autorizada e apenas baixa o XML, sem emitir outra. - Um ERP recebe HTTP 429 por excesso de requisições ao emitir um lote de NFC-e no fechamento do dia e espera o tempo indicado pela API antes de tentar novamente. - Uma transportadora tenta emitir um MDF-e durante instabilidade da SEFAZ; o sistema faz até cinco tentativas com backoff exponencial e, sem sucesso, envia o documento para uma fila de reprocessamento e alerta a equipe. - Um software de gestão recebe rejeição de NFS-e por código de serviço inválido e não faz retry: marca a nota como pendente de correção e avisa o usuário. ## Perguntas frequentes ### Devo fazer retry quando a nota é rejeitada? Normalmente não. Rejeição indica erro nos dados, como CFOP, NCM ou tributação incorretos. Repetir o envio sem corrigir gera a mesma rejeição. Corrija as informações e só então reenvie. ### Quantas tentativas de retry são recomendadas? Não existe número oficial. É comum limitar a poucas tentativas com intervalos crescentes. O importante é ter um limite e, ao atingi-lo, mover o documento para uma fila de pendências ou gerar alerta. ### Retry pode gerar nota duplicada? Pode, se a primeira tentativa foi autorizada mas a resposta se perdeu. Para evitar, use identificadores de idempotência e consulte o status do documento antes de reenviar após um timeout. ### O que é backoff exponencial no retry? É a técnica de aumentar o tempo de espera entre tentativas, geralmente dobrando a cada falha. Isso dá tempo para o serviço se recuperar e evita sobrecarregar a API ou o órgão autorizador. ## Termos relacionados - [Backoff exponencial](https://conota.dev/glossario/backoff-exponencial.md) - [Idempotência na emissão fiscal](https://conota.dev/glossario/idempotencia-na-emissao-fiscal.md) - [Timeout na emissão fiscal](https://conota.dev/glossario/timeout-na-emissao-fiscal.md) - [Reprocessamento de emissão fiscal](https://conota.dev/glossario/reprocessamento-de-emissao-fiscal.md) - [Limite de requisições](https://conota.dev/glossario/limite-de-requisicoes.md) - [Fila de emissão fiscal](https://conota.dev/glossario/fila-de-emissao-fiscal.md) --- Fonte: [Retry na integração fiscal](https://conota.dev/glossario/retry-na-integracao-fiscal/) · Atualizado em 2026-10-22 --- # Revogação de certificado digital > Revogação de certificado digital é o cancelamento definitivo de um certificado antes do fim da sua validade, feito pela Autoridade Certificadora que o emitiu. Depois de revogado, o certificado passa a constar em listas públicas de certificados inválidos e não pode mais ser usado para assinar documentos, como notas fiscais eletrônicas, nem para autenticar sistemas. **Também conhecido como:** Revogação de certificado, Cancelamento de certificado digital, Digital certificate revocation **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** R ## O que significa revogar um certificado digital? Todo certificado digital tem uma data de validade. A revogação é a forma de encerrar esse certificado antes dessa data, tornando-o inválido de maneira permanente. É como bloquear um cartão de banco perdido: o cartão físico continua existindo, mas deixa de funcionar. Quem executa a revogação é a Autoridade Certificadora (AC) responsável pela emissão. A partir desse momento, o certificado é incluído na Lista de Certificados Revogados (LCR) da AC e passa a aparecer como revogado em consultas de status online. Qualquer sistema que verifique o certificado, como os servidores da SEFAZ ou das prefeituras, consegue identificar que ele não é mais confiável. ## Por que um certificado digital é revogado? O motivo mais comum é a suspeita de que a chave privada foi comprometida: o arquivo PFX vazou, a senha foi exposta, um computador foi invadido ou um token foi perdido ou roubado. Nesses casos, revogar impede que outra pessoa assine documentos em nome da empresa. Também há motivos administrativos, como mudança de dados que constam no certificado (por exemplo, razão social), encerramento das atividades da empresa, saída do responsável legal ou erro na emissão. A própria AC pode revogar um certificado se identificar irregularidades no processo de emissão. ## O que acontece com a emissão de notas fiscais após a revogação? Documentos fiscais eletrônicos, como NF-e, NFC-e, CT-e, MDF-e e, em muitos casos, NFS-e, precisam ser assinados digitalmente. Quando o XML é assinado com um certificado revogado, o órgão autorizador rejeita o documento, e a emissão fica parada até que um novo certificado válido seja instalado. Notas autorizadas antes da revogação, em regra, continuam válidas, porque foram assinadas quando o certificado ainda era confiável. O problema afeta as emissões feitas dali em diante, além de outras operações que dependem do certificado, como eventos de cancelamento, cartas de correção e consultas de distribuição de DF-e. ## Qual a diferença entre revogação e vencimento do certificado? O vencimento acontece naturalmente quando chega a data final de validade, e é previsível. A revogação é antecipada e normalmente provocada por um evento específico, como perda, vazamento ou mudança cadastral. Nos dois casos o certificado deixa de servir para assinar documentos, mas um certificado revogado é sinalizado publicamente como não confiável. Em ambas as situações, a solução é a mesma: emitir um novo certificado e substituí-lo em todos os sistemas que o utilizam. A revogação não pode ser desfeita. ## Como lidar com a revogação em sistemas que emitem notas por API? Empresas com ERP, plataforma de vendas ou marketplace integrados a uma API fiscal costumam armazenar o certificado A1 no próprio emissor. Ao revogar o certificado, é preciso enviar o novo arquivo PFX e sua senha para a plataforma, senão as emissões passam a ser rejeitadas. Em plataformas que gerenciam vários CNPJs, como o Console do Conota, a boa prática é acompanhar o status dos certificados de cada empresa e monitorar rejeições ligadas à assinatura. Assim, um certificado revogado é identificado rapidamente e substituído antes de causar acúmulo de notas pendentes. ## Exemplos de Revogação de certificado digital - Um funcionário envia por engano o arquivo PFX e a senha do certificado da empresa para um e-mail externo. O responsável solicita a revogação à Autoridade Certificadora, emite um novo certificado A1 e o carrega no emissor fiscal. - Uma loja virtual troca de razão social. Como o nome antigo consta no certificado, a empresa emite um novo certificado com os dados atualizados e revoga o anterior. - Um ERP integrado a uma API fiscal começa a receber rejeições na emissão de NF-e. Ao verificar, a equipe descobre que o certificado da filial foi revogado e faz o upload do novo certificado no painel de gestão. - Uma transportadora perde o token com o certificado A3 usado para assinar CT-e e MDF-e e pede a revogação imediata para evitar uso indevido. ## Perguntas frequentes ### É possível desfazer a revogação de um certificado digital? Não. A revogação é definitiva. Se o certificado foi revogado por engano ou o problema foi resolvido, é necessário emitir um novo certificado digital. ### As notas emitidas antes da revogação perdem a validade? Em regra, não. Documentos assinados e autorizados enquanto o certificado era válido continuam válidos. A revogação impede apenas novas assinaturas com aquele certificado. ### Quem pode pedir a revogação de um certificado? O titular ou o responsável legal pela empresa titular, seguindo o procedimento da Autoridade Certificadora que emitiu o certificado. A própria AC também pode revogá-lo em casos previstos nas suas regras. ### Preciso revogar o certificado antigo ao renovar? Não necessariamente. Se o certificado antigo não foi comprometido, ele pode simplesmente vencer. A revogação é recomendada quando há risco de uso indevido ou dados incorretos. ## Termos relacionados - [Certificado digital A1](https://conota.dev/glossario/certificado-digital-a1.md) - [Autoridade Certificadora](https://conota.dev/glossario/autoridade-certificadora.md) - [ICP-Brasil](https://conota.dev/glossario/icp-brasil.md) - [Assinatura digital do XML](https://conota.dev/glossario/assinatura-digital-do-xml.md) - [Arquivo PFX](https://conota.dev/glossario/arquivo-pfx.md) - [Backup de certificado A1](https://conota.dev/glossario/backup-de-certificado-a1.md) --- Fonte: [Revogação de certificado digital](https://conota.dev/glossario/revogacao-de-certificado-digital/) · Atualizado em 2026-10-22 --- # RNTRC > RNTRC é o Registro Nacional de Transportadores Rodoviários de Cargas, cadastro mantido pela ANTT que habilita pessoas e empresas a transportar cargas de terceiros por rodovia mediante pagamento. O número desse registro é informado em documentos fiscais de transporte, como o CT-e e o MDF-e do modal rodoviário. **Também conhecido como:** Registro Nacional de Transportadores Rodoviários de Cargas, Registro na ANTT, Número ANTT, RNTRC **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** R ## O que significa RNTRC? RNTRC é a sigla de Registro Nacional de Transportadores Rodoviários de Cargas. Trata-se de um cadastro obrigatório, administrado pela ANTT (Agência Nacional de Transportes Terrestres), para quem faz transporte rodoviário de cargas de forma remunerada, ou seja, quando alguém é pago para levar a mercadoria de outra pessoa ou empresa. Na prática, o RNTRC funciona como uma autorização para atuar no setor. Ao se cadastrar, o transportador recebe um número de registro, que passa a identificá-lo nas operações de frete e nos documentos fiscais. ## Quem precisa ter RNTRC? O registro é exigido de quem presta serviço de transporte rodoviário de cargas para terceiros. O cadastro costuma ser dividido em categorias: o transportador autônomo (TAC), que é a pessoa física dona do próprio caminhão; a empresa de transporte (ETC); e a cooperativa de transporte (CTC). Uma empresa que transporta apenas as próprias mercadorias, com veículos próprios, geralmente não presta serviço de frete e, por isso, não precisa do RNTRC para essa atividade. Em caso de dúvida sobre um enquadramento específico, o ideal é consultar as regras da ANTT ou um contador. ## Onde o RNTRC aparece nos documentos fiscais? No CT-e (Conhecimento de Transporte Eletrônico) do modal rodoviário, o número do RNTRC da transportadora emitente é informado no grupo de dados específico do transporte rodoviário. Ele também é exibido no DACTE, a representação impressa do CT-e. No MDF-e (Manifesto Eletrônico de Documentos Fiscais) rodoviário, o RNTRC é informado nas informações destinadas à ANTT, junto de outros dados do transporte, quando o emitente é um prestador de serviço de transporte. Em geral, ele também aparece no DAMDFE. ## Por que o RNTRC é importante na emissão por API? Quando um ERP, TMS ou plataforma de logística emite CT-e e MDF-e por uma API fiscal, o RNTRC precisa estar presente no payload enviado sempre que a operação exigir. Se o número estiver ausente, em formato incorreto ou incompatível com o emitente, o documento pode ser recusado pela SEFAZ, gerando uma rejeição fiscal. Por isso, é comum guardar o RNTRC no cadastro de cada empresa emissora e preenchê-lo automaticamente nas requisições. Em sistemas que gerenciam várias transportadoras ao mesmo tempo, cada CNPJ deve ter o seu próprio registro associado. ## Qual a diferença entre RNTRC e inscrição estadual? A inscrição estadual é um cadastro tributário junto ao estado, ligado principalmente ao ICMS. O RNTRC é um registro regulatório do setor de transportes, junto à ANTT, que comprova a habilitação para prestar serviço de frete rodoviário. Uma transportadora normalmente precisa dos dois: a inscrição estadual para cumprir obrigações tributárias e o RNTRC para atuar legalmente como transportadora de cargas de terceiros. ## Exemplos de RNTRC - Uma transportadora que integra seu TMS a uma API fiscal cadastra o RNTRC no perfil da empresa, e o número passa a ser incluído automaticamente em cada CT-e rodoviário emitido. - Ao montar o MDF-e de uma viagem entre dois estados, o sistema da transportadora informa o RNTRC no grupo de dados destinados à ANTT, junto com as informações dos veículos. - Um caminhoneiro autônomo com cadastro de TAC informa seu número de RNTRC à empresa que o contrata para que os dados do frete sejam registrados corretamente. - Um CT-e é rejeitado em homologação porque o campo de RNTRC foi enviado vazio; a equipe corrige o cadastro do emitente e reprocessa a emissão. ## Perguntas frequentes ### Quem emite o RNTRC? O registro é concedido pela ANTT (Agência Nacional de Transportes Terrestres), que mantém o cadastro nacional de transportadores rodoviários de cargas. ### Empresa que transporta carga própria precisa de RNTRC? Em geral, não, pois não presta serviço de frete a terceiros. Nesse caso, ela pode emitir MDF-e como transportadora de carga própria sem informar RNTRC. Confirme o enquadramento com a ANTT ou com seu contador. ### O RNTRC é obrigatório no CT-e? No CT-e do modal rodoviário, o RNTRC do emitente é um dado esperado no grupo de informações rodoviárias. Sem ele, ou com valor inválido, o documento pode ser rejeitado. ### O RNTRC substitui o CNPJ ou a inscrição estadual? Não. O RNTRC é um registro do setor de transportes e convive com o CNPJ e a inscrição estadual, que continuam sendo exigidos nos documentos fiscais. ## Termos relacionados - [CT-e](https://conota.dev/glossario/ct-e.md) - [MDF-e](https://conota.dev/glossario/mdf-e.md) - [Modal de transporte no CT-e](https://conota.dev/glossario/modal-de-transporte-no-ct-e.md) - [Transporte de carga no MDF-e](https://conota.dev/glossario/transporte-de-carga-no-mdf-e.md) - [DACTE](https://conota.dev/glossario/dacte.md) - [Emitente de documento fiscal](https://conota.dev/glossario/emitente-de-documento-fiscal.md) --- Fonte: [RNTRC](https://conota.dev/glossario/rntrc/) · Atualizado em 2026-10-22 --- # RPS > RPS, ou Recibo Provisório de Serviços, é um documento emitido pelo prestador de serviço para registrar uma prestação de forma temporária, até que ela seja convertida em NFS-e pela prefeitura. É usado em integrações por lote e em situações em que a nota não pode ser gerada na hora, com prazo de conversão definido por cada município. **Também conhecido como:** Recibo Provisório de Serviços, Recibo Provisório de Serviço, RPS **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** R ## O que é o RPS e para que serve? O RPS é um comprovante provisório de que um serviço foi prestado. Ele não tem validade fiscal definitiva. Sua função é registrar a operação até que a prefeitura gere a nota fiscal de serviço eletrônica (NFS-e) correspondente. Ele surgiu porque nem sempre é possível emitir a NFS-e no momento do atendimento, seja por falta de conexão, por instabilidade no sistema da prefeitura ou porque o sistema do prestador envia as notas em lotes. Com o RPS, o prestador entrega um comprovante ao cliente e regulariza a situação depois. ## Como funciona a conversão do RPS em NFS-e? O prestador gera o RPS com uma numeração própria, normalmente composta por número, série e tipo. Depois, envia esse RPS à prefeitura, individualmente ou em lote, por meio do sistema municipal ou de um webservice. A prefeitura valida as informações e, se estiver tudo certo, gera a NFS-e, que recebe um número oficial e passa a ter validade fiscal. A nota fica vinculada ao RPS que a originou, permitindo rastrear a operação. Se houver erro, o envio é rejeitado e o RPS precisa ser corrigido e reenviado. Cada município define o prazo para essa conversão. Um RPS não convertido dentro do prazo pode ser considerado irregular e sujeitar o prestador a penalidades previstas na legislação local. ## Qual a diferença entre RPS e NFS-e? A NFS-e é o documento fiscal oficial, com validade jurídica, número atribuído pela prefeitura e código de verificação. O RPS é apenas um registro temporário, numerado pelo próprio prestador, que serve de base para gerar a NFS-e. Na prática, o RPS é o pedido e a NFS-e é o resultado. O cliente pode receber o RPS no momento do serviço, mas o documento que vale para fins de tributação e contabilidade é a NFS-e gerada a partir dele. ## Qual a diferença entre RPS e DPS? O RPS é típico dos modelos municipais de NFS-e, especialmente os baseados no padrão ABRASF, adotado por muitas prefeituras. Cada município pode ter variações de leiaute e de regras. No Padrão Nacional da NFS-e, o papel equivalente é exercido pela DPS (Declaração de Prestação de Serviço), que é enviada para gerar a nota no ambiente nacional. Os dois conceitos são parecidos, mas pertencem a modelos diferentes, e o que se usa depende de como o município de cada prestador emite suas notas. ## Como o RPS aparece na emissão de NFS-e por API? Em uma integração por API, o sistema do cliente, como um ERP ou plataforma de vendas, envia os dados do serviço, e a API monta o RPS no formato exigido pela prefeitura, transmite e acompanha o processamento até a NFS-e ser autorizada ou rejeitada. Como a conversão costuma ser assíncrona, é comum consultar o status por polling ou receber o resultado por webhook. Controlar bem a numeração do RPS também é importante para evitar duplicidade, já que reenviar um RPS com o mesmo número pode gerar rejeição ou notas repetidas. ## Exemplos de RPS - Uma clínica sem internet no momento do atendimento entrega ao paciente um RPS impresso e, no mesmo dia, envia o recibo à prefeitura para gerar a NFS-e. - Um software de gestão de academias acumula os RPS das mensalidades do dia e os transmite em um único lote à prefeitura no fim do expediente. - Um ERP integrado a uma API fiscal envia os dados de um serviço de consultoria; a API gera o RPS com número e série, transmite ao município e devolve ao ERP o XML e o PDF da NFS-e autorizada. - Um RPS enviado com o código de serviço incorreto é rejeitado pela prefeitura; o sistema corrige o campo e reenvia o recibo para conversão. ## Perguntas frequentes ### O RPS substitui a nota fiscal de serviço? Não. O RPS é provisório e precisa ser convertido em NFS-e dentro do prazo definido pelo município. Somente a NFS-e tem validade fiscal definitiva. ### Quem define o prazo para converter o RPS? Cada prefeitura define seu próprio prazo na legislação municipal. Por isso, o prestador deve consultar as regras do município onde está inscrito. ### Todo município usa RPS? Não necessariamente. Muitos modelos municipais usam RPS, mas municípios que aderiram ao Padrão Nacional da NFS-e trabalham com a DPS, que cumpre papel semelhante. ### Posso reaproveitar o número de um RPS? Não. A numeração do RPS deve ser sequencial e única por série. Repetir um número pode causar rejeição ou duplicidade de notas. ## Termos relacionados - [NFS-e](https://conota.dev/glossario/nfs-e.md) - [DPS da NFS-e](https://conota.dev/glossario/dps-da-nfs-e.md) - [Padrão Nacional da NFS-e](https://conota.dev/glossario/padrao-nacional-da-nfs-e.md) - [Prefeitura autorizadora de NFS-e](https://conota.dev/glossario/prefeitura-autorizadora-de-nfs-e.md) - [Lote de documentos fiscais](https://conota.dev/glossario/lote-de-documentos-fiscais.md) - [Prestador de serviço](https://conota.dev/glossario/prestador-de-servico.md) --- Fonte: [RPS](https://conota.dev/glossario/rps/) · Atualizado em 2026-10-22