# Glossário de A a Z — letra P > 20 termos. Glossário compacto: https://conota.dev/glossario/llms-full.txt --- # Padrão Nacional da NFS-e > Padrão Nacional da NFS-e é o modelo unificado de nota fiscal de serviço eletrônica criado para substituir a variedade de formatos municipais no Brasil. Ele define um leiaute único, regras comuns de validação e um ambiente nacional de dados. Assim, prestadores emitem notas da mesma forma, independentemente do município onde estão estabelecidos. **Também conhecido como:** NFS-e Padrão Nacional, NFS-e Nacional, Sistema Nacional da NFS-e, Padrão Nacional de NFS-e **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** P ## O que é o Padrão Nacional da NFS-e? A NFS-e, nota fiscal de serviço eletrônica, sempre foi responsabilidade dos municípios, porque o principal imposto envolvido, o ISSQN, é municipal. Por isso, cada prefeitura criou o seu próprio sistema, com campos, regras e formas de envio diferentes. Uma empresa que presta serviços em várias cidades acabava lidando com dezenas de modelos distintos. O Padrão Nacional surgiu para resolver esse problema. Ele estabelece um único leiaute de documento, uma mesma lógica de emissão e um repositório nacional onde as notas ficam disponíveis. Na prática, uma nota emitida em uma cidade segue a mesma estrutura de uma nota emitida em qualquer outra cidade que adote o padrão. ## Como funciona a emissão no Padrão Nacional? O prestador de serviço não envia a nota pronta. Ele envia uma DPS, a Declaração de Prestação de Serviço, com os dados da operação: quem prestou, quem contratou, qual serviço foi realizado, valores e tributos. O sistema nacional valida essas informações e, se estiver tudo certo, gera a NFS-e com uma chave de acesso própria. A emissão pode ser feita por um emissor público disponibilizado pelo governo, em versão web ou aplicativo, ou por integração direta entre sistemas, via API. Depois de gerada, a nota fica registrada em um ambiente nacional de dados, que permite consulta e compartilhamento com as prefeituras e com outros órgãos. Além do XML, que é o documento oficial, existe uma representação visual para impressão ou envio ao cliente, chamada DANFSe, semelhante ao DANFE da NF-e. ## Qual a diferença entre o Padrão Nacional e os padrões municipais? Nos padrões municipais, cada prefeitura define seu próprio leiaute, suas próprias rotinas de validação e, muitas vezes, exige o envio de um RPS, o Recibo Provisório de Serviços, para conversão posterior em nota. Os códigos de erro, os campos obrigatórios e até a forma de autenticação variam de cidade para cidade. No Padrão Nacional, essas regras são comuns. O documento de envio passa a ser a DPS, os campos seguem uma única especificação e a nota fica disponível em um ambiente centralizado. Isso reduz o trabalho de manutenção para quem desenvolve sistemas e diminui erros para quem emite. ## Todos os municípios usam o Padrão Nacional? A adesão acontece de forma gradual e depende de cada município. Algumas prefeituras passaram a usar diretamente o emissor nacional, enquanto outras mantêm seus sistemas próprios e apenas compartilham os dados com o ambiente nacional. Há ainda municípios que seguem operando somente com seus modelos locais. Para os Microempreendedores Individuais, o uso do Padrão Nacional já se tornou obrigatório na emissão de notas de serviço. Com a reforma tributária sobre o consumo, a tendência é que o modelo nacional ganhe ainda mais importância, já que o leiaute passou a prever informações dos novos tributos, como IBS e CBS. Antes de emitir, vale sempre confirmar a situação do município onde a empresa está estabelecida. ## Por que o Padrão Nacional importa para quem integra sistemas? Para empresas com ERP, plataforma de vendas ou software de gestão próprio, cada novo padrão municipal significava uma nova integração para desenvolver e manter. O Padrão Nacional reduz essa fragmentação, porque uma única estrutura de dados atende a muitos municípios ao mesmo tempo. Mesmo assim, enquanto parte das prefeituras continua com sistemas próprios, a convivência entre o modelo nacional e os modelos locais segue existindo. Por isso, muitas empresas usam uma API fiscal que recebe os dados em um formato único e cuida do envio para o padrão correto de cada cidade, devolvendo XML, PDF e status da nota. ## Exemplos de Padrão Nacional da NFS-e - Um MEI que presta serviços de design gráfico emite suas notas pelo emissor nacional, preenchendo a DPS com os dados do cliente e o valor do serviço, sem precisar acessar o sistema da prefeitura. - Uma plataforma de agendamento de consultas integra seu sistema a uma API fiscal e passa a emitir NFS-e no Padrão Nacional para clínicas de diferentes cidades usando a mesma estrutura de dados. - Uma empresa de manutenção de equipamentos com filiais em vários estados reduz o número de integrações que mantém, já que os municípios dessas filiais aderiram ao Padrão Nacional. - Um ERP valida a DPS no ambiente de homologação antes de liberar a emissão em produção, verificando se os códigos de serviço e as alíquotas estão de acordo com o leiaute nacional. ## Perguntas frequentes ### O Padrão Nacional substitui o ISSQN? Não. O Padrão Nacional muda a forma de emitir e registrar a nota, mas o ISSQN continua sendo um imposto municipal. A alíquota, as regras de retenção e o recolhimento seguem a legislação de cada município. ### Qual a diferença entre DPS e NFS-e no Padrão Nacional? A DPS é a declaração que o prestador envia com os dados do serviço. A NFS-e é o documento fiscal gerado depois que essa declaração é validada e aceita pelo sistema. ### Uma nota emitida no Padrão Nacional pode ser cancelada? Sim. O cancelamento é feito por meio de um evento registrado no próprio ambiente nacional, respeitando os prazos e as condições definidos pelas regras vigentes e pelo município. ### Minha empresa precisa trocar de sistema para usar o Padrão Nacional? Não necessariamente. É possível usar o emissor público ou integrar o sistema atual por API. Quem já usa uma API fiscal costuma ter a adaptação feita pelo próprio fornecedor da integração. ## Termos relacionados - [NFS-e](https://conota.dev/glossario/nfs-e.md) - [DPS da NFS-e](https://conota.dev/glossario/dps-da-nfs-e.md) - [Prefeitura autorizadora de NFS-e](https://conota.dev/glossario/prefeitura-autorizadora-de-nfs-e.md) - [ISSQN](https://conota.dev/glossario/issqn.md) - [RPS](https://conota.dev/glossario/rps.md) - [MEI na emissão fiscal](https://conota.dev/glossario/mei-na-emissao-fiscal.md) --- Fonte: [Padrão Nacional da NFS-e](https://conota.dev/glossario/padrao-nacional-da-nfs-e/) · Atualizado em 2026-10-22 --- # Paginação na API fiscal > Paginação na API fiscal é a técnica de dividir uma lista grande de resultados, como notas fiscais emitidas, eventos ou empresas cadastradas, em partes menores chamadas páginas. Em vez de devolver milhares de registros de uma só vez, a API entrega blocos controlados, e o sistema cliente pede a próxima parte quando precisar. **Também conhecido como:** Paginação de resultados, Paginação de listagens, Pagination **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** P ## O que é paginação na API fiscal? Paginação é a forma como uma API organiza respostas que contêm muitos itens. Quando um sistema pede, por exemplo, a lista de todas as NF-e emitidas no mês, a API não manda tudo de uma vez: ela envia um primeiro bloco de resultados e informa como buscar o próximo. É parecido com um livro dividido em páginas. Você lê uma página por vez e sabe que existem outras depois dela. Na API, cada página é uma resposta separada, com uma quantidade limitada de registros. ## Para que serve a paginação? A principal função é manter a comunicação rápida e estável. Respostas enormes demoram para ser geradas, consomem muita memória e podem estourar o tempo limite da requisição. Dividindo em páginas, cada chamada fica leve e previsível. Em integrações fiscais isso é especialmente importante, porque uma empresa pode acumular milhares de documentos por dia entre NF-e, NFC-e, NFS-e, CT-e e MDF-e. Sem paginação, uma simples consulta de histórico poderia travar o ERP ou a plataforma de vendas que está fazendo a busca. ## Como funciona a paginação na prática? O sistema cliente faz uma requisição a um endpoint de listagem, geralmente informando quantos itens quer por página por meio de um query parameter, como limit ou page_size. A API devolve os registros daquela página e, junto com eles, informações para continuar: o número da próxima página, um indicador de que há mais resultados ou um cursor. O cliente repete a chamada usando essa informação até que a API indique que não há mais itens. É comum combinar a paginação com filtros, como período de emissão, CNPJ do emitente ou status do documento, para trazer apenas o que interessa. ## Quais são os tipos de paginação mais comuns? Paginação por página ou deslocamento (offset): o cliente pede a página 1, 2, 3 e assim por diante, ou informa quantos itens pular. É simples de entender, mas pode gerar resultados repetidos ou perdidos se novos documentos forem criados enquanto a listagem está sendo percorrida. Paginação por cursor: a API devolve um marcador que aponta para o último item entregue, e o cliente usa esse marcador para pedir os seguintes. É mais estável para listas que mudam com frequência, como documentos sendo emitidos em tempo real, e costuma ter melhor desempenho em grandes volumes. ## Qual a diferença entre paginação e o NSU na distribuição de DF-e? A paginação é uma escolha de quem desenha a API para organizar listagens. Já o NSU é um número sequencial definido pelo ambiente fiscal para controlar quais documentos já foram distribuídos a um interessado. Os dois têm lógica parecida, pois o cliente avança a partir do último ponto lido, mas o NSU segue regras próprias do serviço de distribuição de DF-e. ## Que cuidados tomar ao consumir APIs paginadas? Percorra todas as páginas até o fim indicado pela API, em vez de supor que a primeira resposta contém tudo. Respeite o tamanho máximo de página e o limite de requisições, evitando disparar chamadas em sequência rápida demais. Em caso de falha temporária, use retry com backoff exponencial e retome a partir da última página ou cursor obtido. Também vale usar filtros de data bem definidos e considerar o fuso horário, para não perder documentos emitidos perto da virada do dia. ## Exemplos de Paginação na API fiscal - Um ERP consulta todas as NFS-e emitidas em março, pedindo 100 notas por página, e percorre as páginas seguintes até a API informar que não há mais resultados. - Uma plataforma de marketplace lista os documentos rejeitados de vários CNPJs usando paginação por cursor, para exibir as rejeições em um painel interno sem sobrecarregar o servidor. - Um agente de inteligência artificial conectado via MCP busca as últimas NFC-e de uma loja e solicita a próxima página apenas se o usuário pedir mais resultados. - Uma rotina noturna sincroniza o histórico de eventos fiscais com o banco de dados do cliente, guardando o último cursor recebido para continuar de onde parou na execução seguinte. ## Perguntas frequentes ### Por que a API não devolve todos os documentos de uma vez? Porque respostas muito grandes ficam lentas, consomem muitos recursos e podem falhar por tempo limite. A paginação mantém cada resposta pequena e confiável, tanto para a API quanto para o sistema que consome os dados. ### Como saber que cheguei à última página? A própria resposta da API indica isso, geralmente com um campo informando se há mais resultados, a ausência de próximo cursor ou uma página com menos itens que o tamanho solicitado. Consulte a documentação do endpoint para saber qual sinal é usado. ### Posso escolher quantos itens vêm por página? Normalmente sim, por meio de um parâmetro na query string, desde que respeitado o valor máximo definido pela API. Páginas maiores reduzem o número de chamadas, mas deixam cada resposta mais pesada. ### Paginação por cursor é melhor que por número de página? Para listas que mudam com frequência, como documentos fiscais sendo emitidos continuamente, o cursor costuma ser mais seguro, pois evita itens repetidos ou pulados. A paginação por número é mais simples e funciona bem para consultas estáveis. ## Termos relacionados - [Filtro de documentos fiscais](https://conota.dev/glossario/filtro-de-documentos-fiscais.md) - [Query parameter](https://conota.dev/glossario/query-parameter.md) - [Endpoint de API](https://conota.dev/glossario/endpoint-de-api.md) - [Limite de requisições](https://conota.dev/glossario/limite-de-requisicoes.md) - [Latência da API fiscal](https://conota.dev/glossario/latencia-da-api-fiscal.md) --- Fonte: [Paginação na API fiscal](https://conota.dev/glossario/paginacao-na-api-fiscal/) · Atualizado em 2026-10-22 --- # Parcelamento tributário > Parcelamento tributário é um acordo entre o contribuinte e o Fisco que permite pagar tributos em atraso, como impostos e contribuições, em várias prestações mensais em vez de um único pagamento. Em geral, a dívida é atualizada com juros e multa, e o pedido exige reconhecer o débito e manter as parcelas em dia. **Também conhecido como:** Parcelamento de débitos tributários, Parcelamento fiscal, Parcelamento de dívidas fiscais, Refis, Tax installment plan **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** P ## O que é parcelamento tributário? Parcelamento tributário é uma forma de regularizar dívidas com o governo dividindo o valor devido em parcelas. Ele pode envolver tributos federais, estaduais ou municipais, como IRPJ, ICMS ou ISSQN, desde que o órgão responsável ofereça essa possibilidade. Na prática, a empresa ou pessoa que deixou de pagar um tributo no prazo pede ao órgão competente para quitar o débito aos poucos. Cada esfera de governo tem suas próprias regras, prazos, número máximo de parcelas e valores mínimos por prestação. ## Para que serve o parcelamento tributário? O principal objetivo é permitir que o contribuinte saia da situação de inadimplência sem precisar ter todo o dinheiro de uma vez. Isso ajuda a preservar o caixa da empresa enquanto a dívida é resolvida. Além disso, enquanto o parcelamento está ativo e as parcelas estão em dia, a cobrança do débito costuma ficar suspensa. Isso evita medidas como execução fiscal e pode permitir a emissão de certidão positiva com efeitos de negativa, documento que comprova que a situação fiscal está regularizada. ## Como funciona um pedido de parcelamento? O contribuinte acessa o canal do órgão responsável, geralmente um portal online, seleciona os débitos que deseja parcelar e escolhe a quantidade de parcelas permitida. Ao fazer o pedido, ele confessa a dívida, ou seja, reconhece formalmente que deve aquele valor. O débito é atualizado com multa e juros de mora, e as parcelas seguintes também costumam ser corrigidas, frequentemente pela taxa SELIC no caso de tributos federais. Se o contribuinte deixar de pagar parcelas, o acordo pode ser cancelado e a cobrança do saldo restante é retomada. ## Qual a diferença entre parcelamento comum e parcelamento especial? O parcelamento comum, também chamado de ordinário, fica disponível de forma permanente e segue regras gerais, normalmente sem descontos sobre multas e juros. Já os parcelamentos especiais são criados por lei por tempo limitado e podem oferecer condições diferenciadas, como redução de multas e juros ou prazos mais longos. Esses programas são popularmente conhecidos como Refis. Como as regras mudam a cada programa, é importante verificar as condições vigentes com um contador. ## Qual a relação entre parcelamento tributário e emissão de notas fiscais? Dívidas tributárias não regularizadas podem trazer problemas operacionais. Dependendo do estado, do município e da situação cadastral, débitos em aberto podem levar a restrições na inscrição estadual ou municipal e, em alguns casos, ao bloqueio da emissão de documentos fiscais. Para empresas do Simples Nacional, débitos não regularizados também podem levar à exclusão do regime. Por isso, o parcelamento é muitas vezes o caminho para manter a empresa apta a emitir NF-e, NFC-e, NFS-e e outros documentos. Para quem emite notas por API, uma rejeição ligada à situação cadastral do emitente pode ser um sinal de que é preciso verificar pendências fiscais junto ao órgão responsável. ## Exemplos de Parcelamento tributário - Uma loja de varejo que deixou de recolher o ICMS de alguns meses pede o parcelamento à Secretaria da Fazenda do seu estado para regularizar a inscrição estadual e continuar emitindo NFC-e normalmente. - Uma prestadora de serviços com ISSQN em atraso negocia o débito em parcelas com a prefeitura para obter a certidão necessária e participar de uma licitação. - Uma empresa do Simples Nacional, notificada sobre débitos que poderiam levar à sua exclusão do regime, parcela a dívida dentro do prazo e mantém a tributação simplificada. - Uma plataforma que emite notas por API para vários clientes identifica rejeições de um CNPJ por irregularidade cadastral e orienta o cliente a verificar débitos e avaliar um parcelamento. ## Perguntas frequentes ### Parcelar a dívida tira multa e juros? Não necessariamente. No parcelamento comum, multa e juros continuam sendo cobrados. Descontos só costumam existir em programas especiais criados por lei, com regras e prazos próprios. ### O que acontece se eu atrasar as parcelas? Atrasos podem gerar acréscimos e, a partir de certo número de parcelas não pagas, o parcelamento pode ser cancelado. Nesse caso, o saldo restante volta a ser cobrado integralmente, inclusive por via judicial. ### Com o parcelamento ativo, a empresa fica regular? Em geral, sim. Com as parcelas em dia, a cobrança fica suspensa e a empresa pode obter certidão positiva com efeitos de negativa, que tem o mesmo valor prático de uma certidão negativa. ### É possível parcelar tributos de estados e municípios? Sim, desde que o estado ou município ofereça essa opção. Cada ente define suas próprias regras, como número de parcelas, valor mínimo e débitos que podem ser incluídos. ## Termos relacionados - [Juros de mora tributária](https://conota.dev/glossario/juros-de-mora-tributaria.md) - [Juros SELIC em débitos fiscais](https://conota.dev/glossario/juros-selic-em-debitos-fiscais.md) - [Fisco](https://conota.dev/glossario/fisco.md) - [Fiscalização tributária](https://conota.dev/glossario/fiscalizacao-tributaria.md) - [Bloqueio de emissão pela SEFAZ](https://conota.dev/glossario/bloqueio-de-emissao-pela-sefaz.md) - [Apuração de tributos](https://conota.dev/glossario/apuracao-de-tributos.md) --- Fonte: [Parcelamento tributário](https://conota.dev/glossario/parcelamento-tributario/) · Atualizado em 2026-10-22 --- # Partilha do ICMS > Partilha do ICMS é a divisão do imposto entre o estado de origem e o estado de destino nas vendas interestaduais para consumidores finais não contribuintes. O estado de origem fica com a parte da alíquota interestadual, e o estado de destino recebe a diferença até sua alíquota interna, chamada DIFAL, recolhida pelo vendedor. **Também conhecido como:** Partilha do DIFAL, Repartição do ICMS entre estados, Partilha do ICMS interestadual **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** P ## O que é a Partilha do ICMS? A Partilha do ICMS é a regra que define como o imposto de uma venda entre estados é dividido quando o comprador é consumidor final e não contribui com ICMS, como uma pessoa física que compra pela internet de uma loja de outro estado. Antes dessa regra, nessas vendas todo o ICMS ficava com o estado de onde a mercadoria saía. Com a Emenda Constitucional 87/2015, o estado onde o consumidor está passou a receber uma parte do imposto, o que tornou a arrecadação mais equilibrada entre estados produtores e consumidores. ## Como funciona a divisão do imposto? O estado de origem recebe o ICMS calculado pela alíquota interestadual, que normalmente é de 4%, 7% ou 12%, conforme a origem, o destino e o tipo de produto. O estado de destino recebe a diferença entre a sua alíquota interna e a alíquota interestadual. Essa diferença é o DIFAL. Na fase de transição, o próprio DIFAL era repartido entre os dois estados em percentuais que mudavam ano a ano: 40% para o destino em 2016, 60% em 2017 e 80% em 2018. Desde 2019, 100% do DIFAL fica com o estado de destino. Por isso, hoje muita gente usa Partilha do ICMS e DIFAL quase como sinônimos. ## Qual a diferença entre Partilha do ICMS e DIFAL? DIFAL é o valor da diferença entre a alíquota interna do estado de destino e a alíquota interestadual. Partilha do ICMS é o mecanismo de divisão do imposto entre os estados, que inclui o DIFAL e, durante a transição, definia quanto dele cada estado recebia. Vale lembrar que também existe DIFAL em operações entre contribuintes, por exemplo na compra de bens para uso e consumo ou ativo imobilizado. Nesse caso, quem recolhe é o comprador, e não se fala em partilha no mesmo sentido da venda ao consumidor final não contribuinte. ## Como a partilha aparece na NF-e? Na NF-e, as informações da partilha ficam no grupo ICMSUFDest, preenchido em vendas interestaduais para consumidor final não contribuinte. Ele traz, entre outros dados, a base de cálculo no destino, a alíquota interna do destino, a alíquota interestadual, o percentual de partilha, o valor do Fundo de Combate à Pobreza (FCP) do destino e os valores de ICMS destinados a cada estado. Como a transição terminou, o percentual de partilha para o destino deve ser informado como 100%, e o valor destinado ao estado de origem dentro desse grupo fica zerado. Erros nesses campos costumam gerar rejeição pela SEFAZ. ## Quem recolhe e quando? Na venda para consumidor final não contribuinte, o responsável pelo recolhimento do DIFAL é o vendedor. Se ele não tiver inscrição estadual no estado de destino, em geral precisa pagar o imposto por meio de GNRE a cada operação, antes da saída da mercadoria, e a guia deve acompanhar o transporte. Quando o vendedor possui inscrição estadual como substituto no estado de destino, normalmente pode apurar e recolher o valor de forma periódica. As regras específicas variam conforme a legislação de cada estado, e a situação de empresas do Simples Nacional deve ser verificada com a contabilidade. ## Por que isso importa para quem emite notas por sistema? Lojas virtuais, marketplaces e ERPs que vendem para todo o país precisam identificar automaticamente quando a operação é interestadual e o comprador é não contribuinte, calcular corretamente o DIFAL e o FCP do destino e preencher o grupo da partilha no XML. Em uma integração por API fiscal, o sistema de vendas envia os dados da operação e dos tributos, e o emissor gera, transmite e acompanha a nota até a autorização. Se houver rejeição ligada à partilha, o retorno indica o problema para que o cadastro ou o cálculo seja corrigido. ## Exemplos de Partilha do ICMS - Uma loja virtual de São Paulo vende um produto de R$ 1.000 para uma pessoa física na Bahia. Considerando, como exemplo, alíquota interestadual de 7% e alíquota interna hipotética de 18% no destino, São Paulo recebe R$ 70 e a Bahia recebe R$ 110 de DIFAL, em cálculo simplificado. - Um ERP identifica que o cliente de outro estado não tem inscrição estadual, marca a operação como consumidor final não contribuinte e preenche o grupo ICMSUFDest da NF-e com percentual de partilha de 100% para o destino. - Um marketplace emite a NF-e de uma venda interestadual via API e, como o vendedor não tem inscrição no estado de destino, gera a GNRE do DIFAL e do FCP para acompanhar a mercadoria. - Uma nota é rejeitada porque o percentual de partilha foi informado com valor da época de transição; o time de integração ajusta o campo para 100% e reenvia o documento. ## Perguntas frequentes ### A Partilha do ICMS ainda existe? A divisão gradual do DIFAL entre origem e destino terminou em 2018. Desde 2019, o estado de destino recebe 100% do DIFAL, mas a lógica de repartição continua: a origem fica com a alíquota interestadual e o destino com a diferença. ### A partilha se aplica a vendas para empresas? Não no mesmo formato. Ela trata de vendas interestaduais para consumidor final não contribuinte. Em vendas para contribuintes, o DIFAL, quando devido, é responsabilidade do comprador e segue outras regras. ### O FCP entra na partilha? O Fundo de Combate à Pobreza do estado de destino, quando existe, é calculado e informado junto ao DIFAL no grupo ICMSUFDest da NF-e e é destinado integralmente ao estado de destino. ### A NFC-e tem partilha do ICMS? Em regra, não. A NFC-e é usada em vendas presenciais dentro do próprio estado. Vendas interestaduais para consumidor final são feitas com NF-e. ## Termos relacionados - [DIFAL](https://conota.dev/glossario/difal.md) - [ICMS](https://conota.dev/glossario/icms.md) - [FCP](https://conota.dev/glossario/fcp.md) - [GNRE](https://conota.dev/glossario/gnre.md) - [Grupo de tributação do ICMS](https://conota.dev/glossario/grupo-de-tributacao-do-icms.md) - [B2C na emissão de notas fiscais](https://conota.dev/glossario/b2c-na-emissao-de-notas-fiscais.md) --- Fonte: [Partilha do ICMS](https://conota.dev/glossario/partilha-do-icms/) · Atualizado em 2026-10-22 --- # Payload de emissão fiscal > Payload de emissão fiscal é o conjunto de dados estruturados, normalmente em formato JSON, que um sistema envia a uma API fiscal para pedir a emissão de um documento como NF-e, NFS-e, NFC-e, CT-e ou MDF-e. Ele reúne emitente, destinatário, itens, valores e tributos que a API transforma no XML oficial. **Também conhecido como:** Corpo da requisição de emissão, Body de emissão fiscal, Dados de emissão da nota, Requisição de emissão fiscal, Invoice issuance payload **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** P ## O que significa payload na emissão fiscal? Payload é uma palavra em inglês que pode ser traduzida como carga útil. Em integrações por API, ela indica o conteúdo principal de uma requisição, ou seja, as informações que realmente importam, sem contar endereço, cabeçalhos de autenticação e outros detalhes técnicos da comunicação. Na emissão fiscal, o payload funciona como um formulário preenchido pelo sistema da empresa, como um ERP, uma loja virtual ou um software de gestão. Em vez de alguém digitar os dados da nota em um portal, o sistema monta esse formulário automaticamente e o envia para a API, que cuida de gerar, assinar e transmitir o documento ao órgão autorizador. ## O que vai dentro de um payload de emissão fiscal? O conteúdo muda conforme o tipo de documento, mas costuma seguir a mesma lógica. Há dados de quem emite (CNPJ, inscrição estadual ou municipal), de quem recebe (destinatário ou tomador), da operação (natureza, data, série) e dos valores envolvidos. Em uma NF-e ou NFC-e, o payload traz a lista de produtos com NCM, CFOP, quantidade, preço e a tributação de cada item, como ICMS, PIS e COFINS. Em uma NFS-e, o foco é o serviço prestado: código da lista de serviços, descrição, valor, alíquota do ISSQN e possíveis retenções. Já no CT-e e no MDF-e aparecem informações de transporte, como modal, percursos, veículos e documentos vinculados à carga. ## Qual a diferença entre o payload e o XML fiscal? O payload é o pedido; o XML fiscal é o documento oficial. O sistema da empresa envia um payload geralmente em JSON, um formato mais simples de montar e ler. A API fiscal valida esses dados, converte para o leiaute exigido pela SEFAZ ou pela prefeitura, assina digitalmente o XML com o certificado do emissor e o transmite. Por isso, o payload não tem validade jurídica sozinho. Somente o XML autorizado, com protocolo de autorização, representa a nota fiscal de fato. Essa separação permite que o sistema do cliente trabalhe com uma estrutura padronizada, enquanto a API lida com as diferenças entre leiautes, versões e municípios. ## Por que um payload de emissão fiscal é recusado? Existem dois tipos principais de recusa. A primeira acontece na própria API, antes do envio ao órgão: campos obrigatórios ausentes, formato errado de data, CNPJ inválido ou valores que não batem com o total. Isso costuma ser apresentado como erro de validação, com indicação do campo problemático. A segunda é a rejeição fiscal, que vem da SEFAZ ou da prefeitura depois da transmissão. Nesse caso, os dados estavam tecnicamente bem formados, mas violam alguma regra tributária ou cadastral, como um CFOP incompatível com a operação ou uma inscrição estadual irregular. Em ambos os casos, é preciso corrigir o payload e reenviar. ## Como montar um payload de emissão fiscal com menos erros? O primeiro passo é seguir a documentação da API, que normalmente descreve cada campo, seus tipos e quais são obrigatórios, muitas vezes por meio de um JSON Schema ou especificação OpenAPI. Testar no ambiente de homologação antes de ir para produção evita que erros virem notas reais. Também ajuda enviar um identificador único por pedido, para garantir idempotência: se a requisição for repetida por falha de rede, a API reconhece que se trata do mesmo documento e não emite em duplicidade. Por fim, manter cadastros de produtos, clientes e regras tributárias atualizados no sistema de origem reduz a maior parte das rejeições. ## Exemplos de Payload de emissão fiscal - Um ERP industrial finaliza um pedido de venda e monta um payload em JSON com dados do cliente, três itens com NCM e CFOP, valores de ICMS e frete, enviando-o à API fiscal para gerar a NF-e. - Uma plataforma de agendamento de serviços envia, a cada atendimento concluído, um payload com o tomador, o código do serviço, o valor e a alíquota do ISSQN para emitir a NFS-e no município do prestador. - Um sistema de frente de caixa envia o payload de uma venda ao consumidor com os itens, a forma de pagamento e o CPF opcional do cliente para emitir a NFC-e em poucos segundos. - Uma transportadora integra seu sistema de gestão de frota e envia um payload com veículo, motorista, UFs de percurso e chaves dos CT-e vinculados para emitir o MDF-e da viagem. ## Perguntas frequentes ### O payload de emissão fiscal precisa ser em JSON? Não obrigatoriamente, mas JSON é o formato mais comum em APIs REST modernas por ser leve e fácil de gerar. Algumas integrações aceitam XML ou outros formatos. O que define isso é a documentação da API utilizada. ### O payload é igual para todos os tipos de nota? Não. A estrutura geral é parecida, mas os campos variam. NF-e e NFC-e focam em produtos e ICMS, NFS-e em serviços e ISSQN, e CT-e e MDF-e em dados de transporte. Uma boa API padroniza o máximo possível para simplificar a integração. ### Posso reenviar o mesmo payload se não receber resposta? Pode, desde que a API ofereça idempotência e você envie o mesmo identificador da requisição original. Assim, a API reconhece a repetição e devolve o resultado já existente, sem emitir o documento duas vezes. ### O payload contém o certificado digital? Normalmente não. O certificado costuma ser cadastrado previamente na plataforma emissora e usado para assinar o XML. O payload carrega apenas os dados do documento, enquanto a autenticação é feita por cabeçalhos, como API Key ou token. ## Termos relacionados - [Emissão fiscal por API](https://conota.dev/glossario/emissao-fiscal-por-api.md) - [JSON](https://conota.dev/glossario/json.md) - [Arquivo XML fiscal](https://conota.dev/glossario/arquivo-xml-fiscal.md) - [Erro de validação fiscal](https://conota.dev/glossario/erro-de-validacao-fiscal.md) - [Idempotência na emissão fiscal](https://conota.dev/glossario/idempotencia-na-emissao-fiscal.md) - [Leiaute fiscal](https://conota.dev/glossario/leiaute-fiscal.md) --- Fonte: [Payload de emissão fiscal](https://conota.dev/glossario/payload-de-emissao-fiscal/) · Atualizado em 2026-10-22 --- # PEM > PEM é um formato de arquivo em texto usado para guardar certificados digitais, chaves privadas e chaves públicas. O conteúdo binário é convertido em Base64 e delimitado por linhas como BEGIN CERTIFICATE e END CERTIFICATE. Na emissão fiscal, é comum converter o certificado A1, entregue em PFX, para PEM ao integrar sistemas com a SEFAZ. **Também conhecido como:** Formato PEM, Arquivo .pem, Certificado em PEM, Chave em PEM, PEM, Privacy-Enhanced Mail **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** P ## O que significa PEM? PEM é a sigla de Privacy-Enhanced Mail, um padrão criado para proteger mensagens de e-mail. O padrão de e-mail em si não se popularizou, mas a forma de representar certificados e chaves que ele definiu acabou adotada por servidores, bibliotecas de criptografia e linguagens de programação. Hoje, quando alguém fala em arquivo PEM, está se referindo apenas a esse formato de texto para material criptográfico, sem relação direta com e-mail. ## Como é um arquivo PEM por dentro? Um arquivo PEM é texto puro e pode ser aberto em qualquer editor. Ele começa com uma linha de abertura, como —–BEGIN CERTIFICATE—–, segue com várias linhas de caracteres em Base64 e termina com uma linha de fechamento, como —–END CERTIFICATE—–. O rótulo entre os traços indica o que está guardado ali: CERTIFICATE para um certificado, PRIVATE KEY para uma chave privada, ENCRYPTED PRIVATE KEY para uma chave privada protegida por senha, PUBLIC KEY para uma chave pública. Um mesmo arquivo pode conter vários blocos, por exemplo o certificado do emitente seguido dos certificados intermediários da cadeia. As extensões mais comuns são .pem, .crt, .cer e .key. A extensão, porém, não garante o formato: um .cer pode estar em PEM ou em DER, que é a versão binária do mesmo conteúdo. ## Qual a diferença entre PEM e PFX? O PFX (também chamado de PKCS#12) é um arquivo binário que funciona como um cofre: reúne o certificado, a chave privada e, às vezes, a cadeia de certificação, tudo protegido por uma senha. É o formato em que o certificado digital A1 costuma ser entregue pela Autoridade Certificadora. O PEM é texto e normalmente separa as peças: o certificado fica em um bloco ou arquivo e a chave privada em outro. A chave em PEM pode estar com ou sem senha. Em resumo, o conteúdo pode ser o mesmo; o que muda é a forma de empacotar e o nível de proteção padrão. ## Por que o PEM aparece na emissão de notas fiscais? Para emitir NF-e, NFC-e, CT-e, MDF-e e muitas NFS-e, o sistema precisa assinar o XML com o certificado do emitente e, em geral, se conectar aos webservices do fisco usando esse mesmo certificado na comunicação segura (HTTPS com autenticação do cliente). Várias bibliotecas e ambientes, especialmente em Node.js, Python, PHP e servidores web, esperam o certificado e a chave em PEM, e não em PFX. Por isso, desenvolvedores que constroem a própria integração costumam converter o A1 de PFX para PEM antes de usá-lo. Quando a empresa usa uma API fiscal, essa conversão normalmente é feita pelo próprio serviço: o cliente envia o PFX e a senha, e a plataforma cuida do armazenamento e do uso correto do certificado em cada emissão. ## Como converter um certificado PFX para PEM? A ferramenta mais usada para isso é o OpenSSL, disponível em linha de comando. Com o comando pkcs12, ele lê o arquivo PFX, pede a senha e grava o certificado e a chave privada em formato PEM, juntos ou em arquivos separados. Também é possível fazer a conversão dentro do próprio código, usando bibliotecas de criptografia da linguagem escolhida. Depois de converter, vale conferir se o arquivo tem os blocos esperados e se o certificado ainda está dentro do prazo de validade. ## Quais cuidados de segurança o PEM exige? Como é texto, um arquivo PEM é fácil de copiar, colar em mensagens ou subir por engano para um repositório de código. Se a chave privada vazar, alguém pode assinar documentos fiscais em nome da empresa. Boas práticas incluem manter a chave privada protegida por senha, guardá-la em um cofre de segredos em vez de deixá-la no código, restringir quem tem acesso e apagar cópias temporárias criadas durante a conversão. ## Exemplos de PEM - Um desenvolvedor de ERP em Node.js converte o certificado A1 do cliente de PFX para PEM para conseguir assinar o XML da NF-e com a biblioteca de criptografia que já usa no projeto. - Uma equipe configura a conexão HTTPS com o webservice de uma prefeitura informando dois arquivos: cert.pem com o certificado e key.pem com a chave privada do emitente da NFS-e. - Ao revisar o repositório, um time encontra um arquivo .pem com a chave privada da empresa versionado por engano, remove o arquivo, revoga o certificado e passa a guardar a chave em um gerenciador de segredos. - Um marketplace que emite documentos por meio de uma API fiscal apenas envia o PFX e a senha de cada vendedor, sem precisar lidar com PEM, porque a plataforma faz o tratamento do certificado. ## Perguntas frequentes ### Posso enviar um certificado PEM direto para a SEFAZ? A SEFAZ não recebe o arquivo PEM em si. O certificado é usado pelo seu sistema para assinar o XML e para autenticar a conexão HTTPS. O formato do arquivo só importa para a biblioteca ou serviço que fará essa assinatura e conexão. ### Um arquivo PEM serve como certificado A1? Sim, desde que contenha o certificado e a chave privada do A1. O conteúdo é o mesmo do PFX, apenas em outro formato. Sem a chave privada, o arquivo serve só para identificar o certificado, não para assinar documentos. ### Como saber se um arquivo está em PEM? Abra-o em um editor de texto. Se aparecerem linhas como -----BEGIN CERTIFICATE----- ou -----BEGIN PRIVATE KEY----- seguidas de caracteres legíveis, é PEM. Se aparecerem símbolos ilegíveis, provavelmente é um formato binário, como DER ou PFX. ### Dá para converter PEM de volta para PFX? Sim. Com o certificado e a chave privada em PEM, ferramentas como o OpenSSL geram um novo arquivo PFX protegido por senha, que pode ser usado em sistemas que exigem esse formato. ## Termos relacionados - [Arquivo PFX](https://conota.dev/glossario/arquivo-pfx.md) - [Certificado digital A1](https://conota.dev/glossario/certificado-digital-a1.md) - [Base64 no envio de certificados](https://conota.dev/glossario/base64-no-envio-de-certificados.md) - [Assinatura digital do XML](https://conota.dev/glossario/assinatura-digital-do-xml.md) - [Cadeia de certificação digital](https://conota.dev/glossario/cadeia-de-certificacao-digital.md) - [Gerenciamento de segredos](https://conota.dev/glossario/gerenciamento-de-segredos.md) --- Fonte: [PEM](https://conota.dev/glossario/pem/) · Atualizado em 2026-10-22 --- # PER/DCOMP > PER/DCOMP é o sistema e o conjunto de formulários eletrônicos da Receita Federal usados por empresas e pessoas para pedir de volta tributos federais pagos a mais ou indevidamente, solicitar ressarcimento ou reembolso de créditos e declarar a compensação desses valores com outros débitos federais, sem precisar recorrer a processos em papel. **Também conhecido como:** PERDCOMP, PER/DComp, PER/DCOMP Web, Pedido de restituição e declaração de compensação, PER/DCOMP **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** P ## O que significa a sigla PER/DCOMP? A sigla junta dois instrumentos. PER significa Pedido Eletrônico de Restituição, Ressarcimento ou Reembolso. DCOMP significa Declaração de Compensação. Ambos são transmitidos à Receita Federal pelo mesmo programa ou pela versão web, acessada pelo portal e-CAC. Na prática, o PER é usado quando a empresa quer receber o dinheiro de volta. A DCOMP é usada quando ela prefere abater esse crédito de outro tributo federal que precisa pagar. ## Para que serve o PER/DCOMP? Serve para recuperar valores que a empresa tem direito a receber do fisco federal. Os casos mais comuns são pagamentos em duplicidade, recolhimentos maiores que o devido, saldo negativo de IRPJ ou CSLL ao fim do ano e créditos acumulados de IPI, PIS e COFINS. Sem esse pedido formal, o crédito simplesmente fica parado. A Receita não devolve nem compensa automaticamente valores pagos a mais na grande maioria das situações: é o contribuinte quem precisa identificar e solicitar. ## Qual a diferença entre restituição, ressarcimento, reembolso e compensação? Restituição é a devolução de um tributo pago indevidamente ou a maior. Ressarcimento é a devolução em dinheiro de créditos que a lei permite acumular, como créditos de IPI ou de PIS e COFINS não cumulativos que a empresa não conseguiu usar. Reembolso se refere a valores que a empresa adiantou em nome do governo em situações específicas previstas na legislação. Compensação é diferente: em vez de receber o dinheiro, a empresa usa o crédito para quitar outro débito federal. A compensação declarada extingue o débito de imediato, mas fica sujeita à análise posterior da Receita, que pode homologá-la ou não. ## Como funciona o envio de um PER/DCOMP? A empresa, geralmente por meio da contabilidade, informa a origem do crédito (por exemplo, o pagamento indevido ou o saldo negativo apurado), o período, o valor e, no caso de compensação, quais débitos serão quitados. Esses dados precisam bater com o que já foi declarado em outras obrigações, como DCTF, ECF e EFD-Contribuições. Depois da transmissão, a Receita analisa o pedido. Se houver inconsistência, pode emitir intimação para apresentação de documentos ou não homologar a compensação, o que faz o débito voltar a ser cobrado com multa e juros. Créditos reconhecidos em restituição costumam ser atualizados pela taxa SELIC. ## Qual a relação entre PER/DCOMP e as notas fiscais emitidas? Os documentos fiscais são a principal prova da origem de muitos créditos. Retenções de IRRF, CSLL, PIS e COFINS destacadas em NFS-e, por exemplo, podem gerar saldo negativo de IRPJ ou CSLL que depois é recuperado via PER/DCOMP. Créditos de IPI e de PIS e COFINS dependem das NF-e de entrada corretamente escrituradas. Por isso, emitir documentos com tributação, CST e retenções corretas e guardar os arquivos XML organizados facilita muito a recuperação. Erros na nota podem levar à glosa do crédito ou a pedidos negados por falta de comprovação. ## Exemplos de PER/DCOMP - Uma empresa de software teve IRRF retido em várias NFS-e ao longo do ano e, ao fechar a apuração, ficou com saldo negativo de IRPJ. Ela transmite uma DCOMP para usar esse saldo no pagamento do PIS e da COFINS do mês seguinte. - Um e-commerce pagou a mesma guia de COFINS duas vezes por erro no financeiro e envia um PER pedindo a restituição do valor duplicado, corrigido pela SELIC. - Uma indústria exportadora acumula créditos de IPI sobre insumos comprados com NF-e e, sem débitos suficientes para abater, solicita o ressarcimento em dinheiro por meio do PER/DCOMP. - Durante a análise de um pedido de ressarcimento de PIS e COFINS, a Receita intima a empresa a apresentar os XML das notas de entrada, que estavam guardados e organizados no sistema de emissão. ## Perguntas frequentes ### Qual o prazo para pedir restituição ou compensação pelo PER/DCOMP? Em regra, o contribuinte tem cinco anos, contados a partir do pagamento indevido ou da data em que o crédito foi constituído, para apresentar o pedido. Passado esse prazo, o direito ao crédito pode ser perdido. ### Empresas do Simples Nacional usam PER/DCOMP? Os tributos recolhidos pelo DAS do Simples Nacional têm procedimentos próprios de restituição e compensação, feitos em sistemas específicos do regime. O PER/DCOMP é usado principalmente por empresas do Lucro Real e do Lucro Presumido. ### O que acontece se a compensação não for homologada? Os débitos que haviam sido quitados com o crédito voltam a ser cobrados, acrescidos de multa e juros. A empresa pode apresentar manifestação de inconformidade para contestar a decisão na esfera administrativa. ### O PER/DCOMP é emitido pela API fiscal? Não. O PER/DCOMP é transmitido diretamente à Receita Federal. A API fiscal ajuda indiretamente, garantindo notas emitidas corretamente e XML disponíveis para comprovar a origem dos créditos. ## Termos relacionados - [Aproveitamento de crédito tributário](https://conota.dev/glossario/aproveitamento-de-credito-tributario.md) - [Glosa de crédito tributário](https://conota.dev/glossario/glosa-de-credito-tributario.md) - [IRRF](https://conota.dev/glossario/irrf.md) - [EFD-Contribuições](https://conota.dev/glossario/efd-contribuicoes.md) - [Juros SELIC em débitos fiscais](https://conota.dev/glossario/juros-selic-em-debitos-fiscais.md) - [Guarda de documentos fiscais](https://conota.dev/glossario/guarda-de-documentos-fiscais.md) --- Fonte: [PER/DCOMP](https://conota.dev/glossario/per-dcomp/) · Atualizado em 2026-10-22 --- # Permissão de acesso à API > Permissão de acesso à API é a regra que define o que um sistema, usuário ou agente de inteligência artificial pode fazer ao se conectar a uma API, como consultar, emitir ou cancelar documentos fiscais. Ela limita ações e dados acessíveis, protegendo informações sensíveis e reduzindo o risco de uso indevido ou de erros. **Também conhecido como:** Autorização de acesso à API, Controle de acesso à API, Escopo de acesso, Permissão de API, API access permission **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** P ## Para que serve a permissão de acesso à API? A permissão de acesso serve para controlar quem pode fazer o quê dentro de uma API. Em vez de liberar tudo para qualquer sistema conectado, ela estabelece limites claros: um sistema pode apenas consultar notas, outro pode emitir e um terceiro pode também cancelar. Em uma API fiscal, isso é especialmente importante porque as operações têm efeito legal. Uma NF-e emitida ou cancelada por engano gera trabalho de correção e pode trazer problemas com o fisco. Limitar as ações reduz esse risco e protege dados de clientes, valores e informações tributárias. ## Qual a diferença entre autenticação e permissão de acesso? Autenticação responde à pergunta "quem é você?". É o momento em que o sistema apresenta uma credencial, como uma API Key ou um token, para provar sua identidade. Permissão de acesso, também chamada de autorização, responde à pergunta "o que você pode fazer?". Mesmo depois de identificado, o sistema só consegue executar as ações e ver os dados que lhe foram liberados. Uma credencial válida, portanto, não significa acesso total. ## Como funciona a permissão de acesso em uma API fiscal? Normalmente, cada credencial fica associada a um conjunto de permissões, às vezes chamadas de escopos. Quando o sistema faz uma requisição, a API verifica se aquela credencial tem autorização para a ação pedida. Se não tiver, a requisição é recusada, geralmente com um erro HTTP indicando acesso negado. As permissões podem variar por tipo de ação (consultar, emitir, cancelar, baixar XML), por tipo de documento (NF-e, NFS-e, NFC-e, CT-e, MDF-e), por empresa emissora ou por ambiente, separando homologação de produção. Em plataformas que gerenciam vários CNPJs, isso evita que uma integração enxergue ou altere dados de empresas que não são dela. ## Por que seguir o princípio do menor privilégio? O princípio do menor privilégio diz que cada sistema ou pessoa deve ter apenas as permissões necessárias para sua tarefa, e nada além disso. Um painel de relatórios, por exemplo, precisa só de leitura, não de permissão para emitir ou cancelar notas. A vantagem é limitar o estrago caso algo dê errado. Se uma credencial vazar ou um sistema tiver um defeito, o impacto fica restrito ao que aquela permissão permitia fazer. ## Como as permissões se aplicam a agentes de inteligência artificial? Agentes de IA podem se conectar a sistemas fiscais por meio do MCP para consultar documentos ou executar tarefas. Nesse caso, as permissões definem exatamente quais ações o agente pode realizar, evitando que ele tome decisões fora do que foi autorizado. Uma prática comum é liberar consultas livremente e restringir ações sensíveis, como cancelamentos. O registro de cada ação para auditoria complementa esse controle, permitindo saber depois o que o agente fez e quando. ## Como gerenciar permissões de forma segura? Algumas boas práticas ajudam: criar credenciais separadas para cada sistema ou finalidade, revisar periodicamente as permissões concedidas, revogar acessos que não são mais usados e trocar as chaves de tempos em tempos. Também é recomendável guardar as credenciais em local seguro, fora do código-fonte, e acompanhar os registros de uso. Assim, qualquer acesso estranho ou tentativa de ação não autorizada pode ser identificado rapidamente. ## Exemplos de Permissão de acesso à API - Um ERP recebe uma credencial com permissão para emitir e cancelar NF-e de uma única empresa, sem acesso aos dados das demais empresas cadastradas na mesma conta. - Uma ferramenta de business intelligence usa uma chave somente leitura para consultar status e valores de notas emitidas, sem conseguir emitir nenhum documento. - Um agente de IA conectado via MCP pode buscar NFS-e por período e baixar XMLs, mas não tem permissão para cancelar documentos. - A equipe de desenvolvimento usa uma credencial liberada apenas para o ambiente de homologação, impedindo testes acidentais em produção. ## Perguntas frequentes ### Ter uma API Key válida garante acesso a tudo? Não. A API Key identifica quem está fazendo a requisição, mas o que pode ser feito depende das permissões associadas a ela. Uma chave válida pode ser recusada ao tentar uma ação não autorizada. ### O que acontece quando o sistema tenta uma ação sem permissão? A API recusa a requisição e devolve um erro de acesso negado, geralmente com código HTTP 403. Nenhuma operação é executada, e a tentativa pode ficar registrada nos logs. ### Posso alterar as permissões de uma credencial depois de criada? Depende da plataforma. Em muitas, é possível ajustar ou revogar permissões. Quando não é, a prática comum é criar uma nova credencial com as permissões corretas e desativar a antiga. ### Permissões por empresa fazem diferença? Sim. Em contas que gerenciam vários CNPJs, restringir o acesso por empresa evita que uma integração consulte ou emita documentos em nome de quem não deveria. ## Termos relacionados - [API Key](https://conota.dev/glossario/api-key.md) - [Token de autenticação](https://conota.dev/glossario/token-de-autenticacao.md) - [OAuth 2.0](https://conota.dev/glossario/oauth-2-0.md) - [Segregação de dados por conta](https://conota.dev/glossario/segregacao-de-dados-por-conta.md) - [Conota MCP](https://conota.dev/glossario/conota-mcp.md) - [Trilha de auditoria fiscal](https://conota.dev/glossario/trilha-de-auditoria-fiscal.md) --- Fonte: [Permissão de acesso à API](https://conota.dev/glossario/permissao-de-acesso-a-api/) · Atualizado em 2026-10-22 --- # PIS > PIS é uma contribuição federal brasileira, cobrada das empresas sobre o faturamento, destinada a financiar benefícios como o seguro-desemprego e o abono salarial. Aparece nos documentos fiscais, como a NF-e e a NFC-e, com base de cálculo, alíquota e valor próprios, que variam conforme o regime tributário da empresa e o tipo de operação. **Também conhecido como:** PIS/Pasep, Contribuição para o PIS, Contribuição para o PIS/Pasep, Programa de Integração Social, PIS, Social Integration Program contribution **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** P ## O que significa PIS? PIS é a sigla de Programa de Integração Social. No dia a dia das empresas, o termo se refere à contribuição federal que financia esse programa, cobrada sobre a receita das vendas de produtos e da prestação de serviços. Ela é administrada pela Receita Federal. É comum ver o nome escrito como PIS/Pasep, porque a contribuição unificou dois programas: o PIS, voltado à iniciativa privada, e o Pasep, voltado ao setor público. Também é frequente vê-lo ao lado da COFINS, outra contribuição federal sobre o faturamento, com regras muito parecidas. ## Como o PIS é calculado? O cálculo segue a lógica básica dos tributos: aplica-se uma alíquota sobre uma base de cálculo, que normalmente é o valor da receita da operação. O que muda de empresa para empresa é o regime de apuração. No regime cumulativo, usado em geral por empresas do Lucro Presumido, a alíquota padrão é de 0,65% e não há aproveitamento de créditos. No regime não cumulativo, típico do Lucro Real, a alíquota padrão é de 1,65%, mas a empresa pode descontar créditos sobre certas compras e despesas. Existem ainda produtos com alíquota zero, isenção, suspensão ou tributação concentrada em uma etapa da cadeia (monofásica). Empresas do Simples Nacional não calculam o PIS separadamente: ele já está incluído na guia única de pagamento do regime. ## Como o PIS aparece na nota fiscal? Na NF-e e na NFC-e, cada item possui um grupo de informações de PIS. Nele constam o CST do PIS (código que indica se a operação é tributada, isenta, com alíquota zero, suspensa etc.), a base de cálculo, a alíquota e o valor da contribuição. Os valores de todos os itens são somados na totalização da nota. Na NFS-e, o PIS costuma aparecer principalmente quando há retenção na fonte: em alguns serviços prestados para outras empresas, o tomador desconta o PIS do pagamento e o recolhe no lugar do prestador, junto com outras contribuições federais. ## Por que o PIS importa na emissão fiscal por API? Quando um ERP ou plataforma de vendas emite notas por API, é o sistema do cliente que informa no payload os dados de tributação de cada item, incluindo o PIS. Um CST incompatível com o regime tributário do emitente, uma alíquota errada ou uma soma que não bate com o total podem gerar rejeição fiscal ou, pior, uma nota autorizada com imposto incorreto. Por isso, é comum que os sistemas mantenham regras de tributação por produto ou serviço, definidas pela contabilidade, e apenas repassem esses valores para a API fiscal, que valida a estrutura e acompanha o documento até a autorização. ## O PIS vai deixar de existir com a reforma tributária? Sim. A reforma tributária sobre o consumo prevê que o PIS e a COFINS sejam substituídos pela CBS (Contribuição sobre Bens e Serviços), de competência federal, enquanto o IBS substituirá tributos estaduais e municipais. A troca ocorre em uma fase de transição, durante a qual os documentos fiscais passam a trazer também os novos grupos de tributação do IBS e da CBS. Enquanto a transição não termina, o PIS continua sendo informado normalmente nas notas fiscais. ## Exemplos de PIS - Uma distribuidora optante pelo Lucro Presumido vende R$ 1.000,00 em mercadorias tributadas; o ERP informa na NF-e o CST 01, base de R$ 1.000,00, alíquota de 0,65% e PIS de R$ 6,50. - Uma loja do Simples Nacional emite NFC-e e informa o CST do PIS adequado ao regime, sem destacar valor, pois a contribuição é paga dentro da guia única do Simples. - Uma consultoria emite NFS-e para uma empresa cliente e indica a retenção de PIS, COFINS e CSLL, reduzindo o valor líquido que receberá pelo serviço. - Um marketplace recebe rejeição ao emitir uma NF-e porque a soma dos valores de PIS dos itens não confere com o total de PIS informado na nota. ## Perguntas frequentes ### PIS da nota fiscal é o mesmo que o número do PIS do trabalhador? Não. O número do PIS do trabalhador é um cadastro individual usado para benefícios trabalhistas. O PIS da nota fiscal é a contribuição paga pela empresa sobre seu faturamento. Os dois têm origem no mesmo programa, mas são coisas diferentes. ### Qual a diferença entre PIS e COFINS? Ambos são contribuições federais sobre o faturamento e seguem regimes semelhantes, cumulativo e não cumulativo. A principal diferença está na destinação dos recursos e nas alíquotas: a COFINS financia a seguridade social e tem alíquotas maiores que as do PIS. ### Quem define o CST e a alíquota do PIS de cada produto? Normalmente a contabilidade ou o responsável fiscal da empresa, com base no regime tributário e no tipo de produto ou serviço. O sistema emissor apenas envia essas informações; a API fiscal valida o formato, mas não decide a tributação. ## Termos relacionados - [CST](https://conota.dev/glossario/cst.md) - [Base de cálculo](https://conota.dev/glossario/base-de-calculo.md) - [Alíquota tributária](https://conota.dev/glossario/aliquota-tributaria.md) - [Regime tributário](https://conota.dev/glossario/regime-tributario.md) - [Lucro presumido](https://conota.dev/glossario/lucro-presumido.md) - [Grupo de tributação do IBS e da CBS](https://conota.dev/glossario/grupo-de-tributacao-do-ibs-e-da-cbs.md) --- Fonte: [PIS](https://conota.dev/glossario/pis/) · Atualizado em 2026-10-22 --- # PKCS#11 > PKCS#11 é um padrão técnico que define uma interface de programação, chamada Cryptoki, para que softwares conversem com dispositivos criptográficos, como tokens, smart cards e HSMs. Ele permite assinar documentos e usar chaves privadas sem que essas chaves saiam do dispositivo, sendo comum no uso de certificados digitais A3 para assinatura de notas fiscais. **Também conhecido como:** PKCS 11, PKCS #11, Cryptoki, PKCS, Public-Key Cryptography Standard #11 **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** P ## O que é PKCS#11 e para que serve? PKCS#11 é uma das especificações da família PKCS (Public-Key Cryptography Standards), um conjunto de padrões sobre criptografia de chave pública. Enquanto outros padrões da família tratam de formatos de arquivo ou de mensagens, o PKCS#11 define como um programa deve pedir operações criptográficas a um dispositivo físico ou virtual que guarda chaves. Na prática, ele funciona como uma língua comum. Um sistema que precisa assinar um XML de nota fiscal não precisa saber os detalhes internos de cada marca de token ou de HSM: basta usar as funções previstas no padrão, como abrir uma sessão, informar o PIN, localizar a chave e pedir a assinatura. A principal vantagem é a segurança. A chave privada fica protegida dentro do dispositivo e não pode ser copiada. O software envia os dados, o dispositivo assina internamente e devolve apenas o resultado. ## Como o PKCS#11 funciona na prática? Cada fabricante de token, smart card ou HSM fornece uma biblioteca que implementa o padrão, normalmente um arquivo .dll no Windows ou .so no Linux. O sistema emissor carrega essa biblioteca e passa a se comunicar com o dispositivo por meio dela. O padrão organiza o acesso em alguns conceitos: o slot, que representa o leitor ou a entrada onde o dispositivo está; o token, que é o dispositivo em si; a sessão, que é a conexão aberta com ele; e os objetos, como certificados e chaves armazenados. Para usar a chave privada, geralmente é preciso fazer login com um PIN. Depois do login, o sistema pede operações como assinar um conteúdo, gerar um par de chaves ou ler o certificado público. Tudo acontece dentro do dispositivo, que também pode bloquear o acesso após várias tentativas de PIN incorretas. ## Qual a relação entre PKCS#11 e o certificado digital A3? No Brasil, o certificado digital do tipo A3 da ICP-Brasil é armazenado em um token USB, em um cartão inteligente ou em um HSM. Como a chave privada não pode ser exportada desses dispositivos, os programas que assinam documentos fiscais precisam de uma forma padronizada de acessá-la, e o PKCS#11 é a interface mais usada para isso. Por esse motivo, quem emite NF-e, CT-e ou MDF-e com certificado A3 costuma instalar o driver do fabricante do token, que inclui a biblioteca PKCS#11. Sem ela, o sistema emissor não consegue enxergar o certificado nem realizar a assinatura digital do XML. ## Qual a diferença entre PKCS#11 e PKCS#12? Apesar dos nomes parecidos, eles resolvem problemas diferentes. O PKCS#12 é um formato de arquivo, usado nos arquivos .pfx ou .p12, que guarda o certificado e a chave privada juntos, protegidos por senha. É o formato típico do certificado digital A1. O PKCS#11 não é um arquivo, e sim uma interface de comunicação com dispositivos onde a chave fica presa. Em resumo: com PKCS#12, a chave viaja dentro de um arquivo; com PKCS#11, a chave permanece no hardware e o software apenas pede que ela seja usada. ## Como o PKCS#11 aparece na emissão fiscal por API? Em emissões feitas por API e executadas em servidores ou na nuvem, o certificado A1 em arquivo PFX costuma ser o mais prático, porque não depende de um dispositivo conectado fisicamente a uma máquina. Já um token A3 exige que o hardware esteja disponível no momento da assinatura, o que dificulta a automação em larga escala. Quando uma empresa precisa de proteção de hardware em ambiente de servidor, a alternativa comum é o HSM, que também é acessado via PKCS#11. Nesse cenário, o backend de integração fiscal monta o XML, envia o conteúdo ao HSM pela interface PKCS#11, recebe a assinatura e segue com a transmissão ao fisco. ## Exemplos de PKCS#11 - Uma distribuidora que emite NF-e com certificado A3 instala o driver do token USB no computador do faturamento; o software emissor carrega a biblioteca PKCS#11 do fabricante para assinar cada nota. - Uma equipe de desenvolvimento configura o caminho da biblioteca PKCS#11 nas opções do sistema para que a aplicação encontre o certificado armazenado em um cartão inteligente. - Uma empresa de software de gestão guarda as chaves de assinatura em um HSM e usa a interface PKCS#11 para assinar os XMLs de CT-e e MDF-e gerados pelo seu backend. - Um analista recebe o erro de que o certificado não foi encontrado e descobre que a biblioteca PKCS#11 instalada era de outro fabricante, incompatível com o token em uso. ## Perguntas frequentes ### PKCS#11 é um tipo de certificado digital? Não. PKCS#11 é uma interface de programação que permite a softwares acessarem dispositivos onde certificados e chaves ficam armazenados, como tokens, smart cards e HSMs. O certificado em si é outra coisa. ### Preciso de PKCS#11 para usar certificado A1? Normalmente não. O certificado A1 fica em um arquivo PFX, no formato PKCS#12, e é lido diretamente pelo sistema. O PKCS#11 é necessário quando a chave está em hardware, como no certificado A3 ou em um HSM. ### O que é Cryptoki? Cryptoki é o nome da interface de programação definida pelo padrão PKCS#11. Na prática, os dois termos são usados como equivalentes quando se fala de acesso a tokens e HSMs. ### É possível copiar a chave privada usando PKCS#11? Em dispositivos configurados corretamente, não. A chave é marcada como não exportável e as operações de assinatura acontecem dentro do hardware, que devolve apenas o resultado ao software. ## Termos relacionados - [HSM](https://conota.dev/glossario/hsm.md) - [Assinatura digital do XML](https://conota.dev/glossario/assinatura-digital-do-xml.md) - [Arquivo PFX](https://conota.dev/glossario/arquivo-pfx.md) - [Certificado digital A1](https://conota.dev/glossario/certificado-digital-a1.md) - [ICP-Brasil](https://conota.dev/glossario/icp-brasil.md) - [Gerenciamento de segredos](https://conota.dev/glossario/gerenciamento-de-segredos.md) --- Fonte: [PKCS#11](https://conota.dev/glossario/pkcs11/) · Atualizado em 2026-10-22 --- # PKCS#12 > PKCS#12 é um padrão de formato de arquivo que reúne, em um único pacote protegido por senha, um certificado digital, a chave privada correspondente e, opcionalmente, a cadeia de certificação. No Brasil, é o formato usado pelo certificado digital A1, normalmente salvo com extensão .pfx ou .p12, para assinar documentos fiscais eletrônicos como NF-e, NFC-e e CT-e. **Também conhecido como:** PKCS 12, PKCS12, Arquivo PFX, Arquivo P12, Formato .pfx, Formato .p12, PKCS#12, Public-Key Cryptography Standards #12 **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** P ## O que é PKCS#12, em palavras simples? Pense no PKCS#12 como um cofre digital em forma de arquivo. Dentro dele ficam guardadas as peças necessárias para provar a identidade de uma empresa ou pessoa no meio eletrônico: o certificado digital, que é a parte pública, e a chave privada, que é a parte secreta. Para abrir esse cofre, é preciso saber a senha definida quando o arquivo foi criado. O nome vem de uma família de padrões de criptografia chamada PKCS (Public-Key Cryptography Standards). O número 12 identifica especificamente o padrão que define como empacotar certificados e chaves em um só arquivo, de forma portátil e protegida. ## Qual a diferença entre PKCS#12, PFX e P12? Na prática, os três nomes se referem à mesma coisa. PKCS#12 é o nome do padrão técnico. PFX e P12 são as extensões de arquivo mais comuns para arquivos nesse formato. Um arquivo empresa.pfx e um arquivo empresa.p12 seguem o mesmo padrão e geralmente podem ser usados da mesma maneira. O termo PFX tem origem em um formato anterior que serviu de base para o PKCS#12, por isso ainda aparece com frequência em sistemas Windows e em instruções de emissores fiscais. ## Por que o PKCS#12 é importante na emissão de notas fiscais? Todo documento fiscal eletrônico precisa ser assinado digitalmente antes de ser enviado à SEFAZ ou à prefeitura. Essa assinatura garante que o XML foi gerado pelo emitente e não foi alterado no caminho. Para assinar, o sistema precisa da chave privada da empresa, e é justamente o arquivo PKCS#12 que a transporta. O certificado digital A1 da ICP-Brasil é entregue nesse formato. Como é um arquivo, ele pode ser instalado em servidores e usado de forma automática, sem depender de cartão, token ou leitor físico. Isso o torna o tipo mais usado por ERPs, plataformas de venda e APIs fiscais que emitem notas em grande volume. ## Como o arquivo PKCS#12 é usado em uma API fiscal? Em uma integração por API, a empresa normalmente cadastra o certificado uma única vez, enviando o arquivo .pfx junto com a senha. Muitas APIs aceitam o arquivo convertido em texto Base64 dentro de uma requisição JSON, o que facilita o envio por HTTPS. Depois do cadastro, a plataforma usa o certificado para assinar cada documento emitido em nome daquele CNPJ. Também é comum que ela leia do próprio arquivo a data de validade e avise quando o certificado estiver perto de vencer, evitando que as emissões parem de repente. ## Quais cuidados de segurança o PKCS#12 exige? Quem tem o arquivo e a senha consegue assinar documentos em nome da empresa. Por isso, o arquivo nunca deve ser enviado por e-mail sem proteção, deixado em pastas compartilhadas ou gravado em código-fonte. A senha deve ser guardada separadamente do arquivo, de preferência em um cofre de segredos. Também vale manter uma cópia de segurança em local protegido, já que perder o arquivo significa, em geral, precisar emitir um novo certificado. Em ambientes mais exigentes, a chave pode ser armazenada em um HSM, que impede que ela seja copiada. ## Exemplos de PKCS#12 - Um ERP que atende várias lojas pede a cada cliente o upload do arquivo .pfx do certificado A1 e da senha para começar a emitir NF-e automaticamente. - Um desenvolvedor converte o arquivo PKCS#12 em Base64 e o envia no corpo de uma requisição JSON para cadastrar o certificado de um novo CNPJ em uma API fiscal. - Uma transportadora renova seu certificado A1, recebe um novo arquivo .p12 e o substitui no Console do emissor para continuar emitindo CT-e e MDF-e sem interrupção. - A equipe de TI guarda o arquivo .pfx em um cofre de segredos e configura o servidor para lê-lo apenas no momento de assinar os XML. ## Perguntas frequentes ### Posso usar um certificado A3 no formato PKCS#12? Não. No certificado A3 a chave privada fica gravada em cartão ou token e não pode ser exportada. O formato PKCS#12 é característico do certificado A1, cuja chave fica em um arquivo. ### O que acontece se eu esquecer a senha do arquivo PFX? Sem a senha não é possível abrir o arquivo nem usar a chave privada. Em geral, a solução é solicitar a emissão de um novo certificado à Autoridade Certificadora. ### Um arquivo PKCS#12 pode ser convertido para outros formatos? Sim. Ferramentas de criptografia permitem extrair o certificado e a chave para formatos como PEM ou importar o conteúdo em um repositório JKS, usado em sistemas Java. A senha é necessária para isso. ### O arquivo PKCS#12 tem validade? O arquivo em si não expira, mas o certificado dentro dele tem data de validade. O certificado A1 costuma valer cerca de um ano; depois disso, as assinaturas deixam de ser aceitas e é preciso renová-lo. ## Termos relacionados - [Arquivo PFX](https://conota.dev/glossario/arquivo-pfx.md) - [Certificado digital A1](https://conota.dev/glossario/certificado-digital-a1.md) - [Assinatura digital do XML](https://conota.dev/glossario/assinatura-digital-do-xml.md) - [Base64 no envio de certificados](https://conota.dev/glossario/base64-no-envio-de-certificados.md) - [JKS para armazenamento de certificados](https://conota.dev/glossario/jks-para-armazenamento-de-certificados.md) - [Backup de certificado A1](https://conota.dev/glossario/backup-de-certificado-a1.md) --- Fonte: [PKCS#12](https://conota.dev/glossario/pkcs12/) · Atualizado em 2026-10-22 --- # Política de Certificado > Política de Certificado é o documento que define as regras de um tipo específico de certificado digital: para que ele pode ser usado, como a chave deve ser gerada e guardada, qual a validade máxima e quais exigências de segurança se aplicam. Na ICP-Brasil, é ela que diferencia certificados como A1 e A3. **Também conhecido como:** PC, Política de Certificação, Política de Certificados, Certificate Policy **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** P ## O que é uma Política de Certificado? A Política de Certificado, conhecida pela sigla PC, é um conjunto formal de regras publicado por uma Autoridade Certificadora para cada tipo de certificado que ela emite. Pense nela como a ficha técnica do certificado: descreve o que ele é, para que serve e quais cuidados devem ser seguidos. No Brasil, as Políticas de Certificado seguem as normas da ICP-Brasil. Cada certificado emitido carrega um identificador único, chamado OID, que aponta para a política sob a qual foi criado. Assim, qualquer sistema que recebe um documento assinado consegue saber exatamente que tipo de certificado foi usado. ## Para que serve a Política de Certificado? Ela garante que todos os certificados de um mesmo tipo tenham o mesmo nível de confiança, independentemente da Autoridade Certificadora que os emitiu. Um certificado A1 de uma empresa certificadora precisa obedecer às mesmas exigências mínimas de um A1 de outra. Para quem emite notas fiscais, isso significa previsibilidade: a SEFAZ, a prefeitura ou a Receita Federal aceitam o certificado porque sabem que ele seguiu regras padronizadas de identificação do titular, geração de chaves e proteção. ## O que uma Política de Certificado define? Entre os pontos tratados estão: as aplicações permitidas (assinatura, sigilo ou carimbo do tempo), o tamanho mínimo das chaves criptográficas, o tipo de mídia onde a chave privada fica armazenada, o prazo máximo de validade e os procedimentos de identificação do solicitante. Também costuma abordar como o certificado é revogado, quais obrigações tem o titular e quais responsabilidades cabem à Autoridade Certificadora e à Autoridade de Registro. ## Quais são os tipos de certificado definidos pelas políticas da ICP-Brasil? A ICP-Brasil organiza seus certificados em famílias. Os de assinatura levam a letra A (como A1 e A3), os de sigilo levam a letra S e os de carimbo do tempo levam a letra T. O número indica o nível de segurança exigido. Na emissão fiscal, os mais comuns são o A1, cuja chave é gerada e guardada em software, geralmente em um arquivo PFX, e o A3, cuja chave fica em hardware, como token, cartão ou HSM. O A1 tem validade mais curta, normalmente de um ano, enquanto o A3 pode ter validade maior. ## Qual a diferença entre Política de Certificado e Declaração de Práticas de Certificação? A Política de Certificado diz o que deve ser cumprido para um tipo de certificado. Já a Declaração de Práticas de Certificação (DPC) descreve como uma Autoridade Certificadora específica cumpre essas regras no dia a dia, detalhando seus processos internos, instalações e controles. De forma simples: a PC é a regra do jogo para o certificado, e a DPC é o manual de operação da certificadora que o emite. ## Por que a Política de Certificado importa na emissão fiscal por API? Plataformas que emitem documentos fiscais automaticamente precisam de um certificado que possa ser usado por servidores, sem intervenção humana. Por isso, o certificado A1 é o mais usado nesse cenário: sua política permite que a chave fique em arquivo, o que viabiliza o envio para uma API fiscal e a assinatura digital do XML de forma automatizada. Conhecer a política do certificado ajuda a planejar renovações, já que a validade é definida por ela, e a escolher o tipo adequado ao modelo de integração da empresa. ## Exemplos de Política de Certificado - Um ERP que emite NF-e por API orienta seus clientes a adquirir um e-CNPJ do tipo A1, porque essa política permite armazenar a chave em arquivo PFX e enviá-lo à plataforma de emissão. - Uma empresa com certificado A3 em token descobre que não consegue usá-lo em uma integração na nuvem, pois a política exige que a chave privada permaneça no dispositivo físico. - Ao validar um XML assinado, um sistema lê o OID presente no certificado e identifica que ele foi emitido sob a política A1 da ICP-Brasil. - Um time de TI cria alertas de vencimento com base no prazo de validade previsto na política do certificado A1, evitando bloqueio na emissão de notas. ## Perguntas frequentes ### Onde encontro a Política de Certificado do meu certificado? As Autoridades Certificadoras publicam suas Políticas de Certificado em seus sites, normalmente na área de documentos ou repositório. O identificador da política também aparece nos detalhes técnicos do próprio certificado. ### Posso usar um certificado A3 em uma API fiscal? Em geral não de forma direta, pois a política do A3 exige que a chave fique em hardware. Para emissão automatizada em servidores ou na nuvem, o certificado A1 é o mais indicado. ### A Política de Certificado define a validade do certificado? Sim. Ela estabelece o prazo máximo de validade para cada tipo de certificado. Dentro desse limite, a Autoridade Certificadora pode oferecer prazos menores. ### Toda Autoridade Certificadora tem a mesma política? Cada uma publica as suas, mas todas precisam respeitar os requisitos mínimos da ICP-Brasil. Por isso, certificados do mesmo tipo têm níveis de segurança equivalentes. ## Termos relacionados - [Declaração de Práticas de Certificação](https://conota.dev/glossario/declaracao-de-praticas-de-certificacao.md) - [Autoridade Certificadora](https://conota.dev/glossario/autoridade-certificadora.md) - [ICP-Brasil](https://conota.dev/glossario/icp-brasil.md) - [Certificado digital A1](https://conota.dev/glossario/certificado-digital-a1.md) - [Hierarquia de certificados digitais](https://conota.dev/glossario/hierarquia-de-certificados-digitais.md) - [Cadeia de certificação digital](https://conota.dev/glossario/cadeia-de-certificacao-digital.md) --- Fonte: [Política de Certificado](https://conota.dev/glossario/politica-de-certificado/) · Atualizado em 2026-10-22 --- # Polling de status fiscal > Polling de status fiscal é a técnica em que o sistema integrador consulta repetidamente, em intervalos definidos, uma API fiscal para saber em que situação está um documento enviado para emissão, como uma NF-e ou NFS-e, até receber uma resposta final de autorização, rejeição ou cancelamento. **Também conhecido como:** Consulta periódica de status, Consulta de status por polling, Polling de documentos fiscais, Fiscal status polling **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** P ## O que é polling de status fiscal? Polling vem do inglês e significa, de forma simples, perguntar de novo e de novo. No contexto fiscal, é quando o seu sistema envia um documento para emissão e, em vez de esperar ser avisado, volta de tempos em tempos à API para perguntar: essa nota já foi autorizada? Isso acontece porque a emissão de documentos fiscais nem sempre é instantânea. A SEFAZ ou a prefeitura pode levar alguns segundos, ou mais, para processar o pedido. Enquanto isso, o documento fica em um status intermediário, como em processamento, e o sistema precisa descobrir quando ele muda para um status final. ## Por que o polling é necessário na emissão fiscal? Muitas APIs fiscais trabalham com processamento assíncrono: elas recebem o pedido, devolvem um identificador e continuam o trabalho em segundo plano. Isso evita que a conexão fique aberta esperando a resposta do órgão autorizador, o que poderia causar timeout. Sem alguma forma de acompanhamento, o sistema que vendeu o produto ou o serviço não saberia se pode entregar o DANFE ao cliente, liberar a mercadoria ou se precisa corrigir um erro. O polling é uma das formas de fechar esse ciclo. ## Como funciona o polling na prática? O fluxo costuma seguir três passos. Primeiro, o sistema envia o payload de emissão e recebe um identificador do documento. Depois, consulta um endpoint de status usando esse identificador. Por fim, repete a consulta até o status deixar de ser intermediário e virar algo como autorizado ou rejeitado. Uma boa prática é não consultar sem parar. Em geral, usa-se um intervalo inicial curto que vai aumentando aos poucos, técnica conhecida como backoff exponencial, e define-se um limite máximo de tentativas. Assim, o sistema não desperdiça requisições nem esbarra no limite de requisições da API. ## Qual a diferença entre polling e webhook? No polling, o seu sistema pergunta. No webhook, a API avisa: quando o status muda, ela envia uma notificação automática para um endereço configurado por você. O webhook tende a ser mais eficiente, porque elimina consultas desnecessárias. Na prática, muitas integrações combinam os dois. O webhook é o caminho principal, e o polling funciona como rede de segurança, por exemplo para verificar documentos cuja notificação não chegou por falha de rede ou indisponibilidade temporária do servidor que deveria recebê-la. ## Quais cuidados tomar ao implementar polling? Defina intervalos razoáveis e um tempo máximo de espera, tratando como pendência os documentos que ultrapassarem esse limite. Registre cada consulta em log para facilitar a investigação de problemas. Também é importante tratar corretamente cada status retornado. Uma rejeição, por exemplo, exige leitura do motivo de rejeição fiscal e correção dos dados antes de um reenvio, enquanto um status intermediário indica apenas que é preciso aguardar mais um pouco. ## Exemplos de Polling de status fiscal - Um ERP envia uma NF-e pela API fiscal, recebe o identificador do documento e consulta o status a cada poucos segundos até receber a autorização e baixar o XML e o PDF. - Uma plataforma de serviços emite uma NFS-e para um município cujo processamento é mais lento e usa polling com backoff exponencial, espaçando as consultas para não exceder o limite de requisições. - Um marketplace recebe os status principalmente por webhook, mas roda uma rotina periódica de polling para conferir notas que ficaram em processamento por tempo acima do esperado. - Um agente de inteligência artificial conectado via MCP consulta o status de um CT-e a pedido do usuário e informa se o documento já foi autorizado ou se houve rejeição. ## Perguntas frequentes ### Polling deixa o sistema mais lento? Não necessariamente. Se feito com intervalos adequados e limite de tentativas, o impacto é pequeno. O problema surge quando o sistema consulta sem pausa, gerando requisições excessivas e podendo atingir o limite de requisições da API. ### De quanto em quanto tempo devo consultar o status? Não existe um valor único. O ideal é começar com intervalos curtos e aumentá-los progressivamente, respeitando as orientações da documentação da API e o tempo típico de resposta de cada órgão autorizador. ### Se eu uso webhook, ainda preciso de polling? É recomendável manter o polling como mecanismo de reserva. Ele ajuda a recuperar o status de documentos cuja notificação por webhook se perdeu, garantindo que nenhuma nota fique sem acompanhamento. ## Termos relacionados - [Status de documento fiscal](https://conota.dev/glossario/status-de-documento-fiscal.md) - [Fluxo assíncrono de emissão](https://conota.dev/glossario/fluxo-assincrono-de-emissao.md) - [Processamento assíncrono](https://conota.dev/glossario/processamento-assincrono.md) - [Backoff exponencial](https://conota.dev/glossario/backoff-exponencial.md) - [Limite de requisições](https://conota.dev/glossario/limite-de-requisicoes.md) - [Retry na integração fiscal](https://conota.dev/glossario/retry-na-integracao-fiscal.md) --- Fonte: [Polling de status fiscal](https://conota.dev/glossario/polling-de-status-fiscal/) · Atualizado em 2026-10-22 --- # Prefeitura autorizadora de NFS-e > Prefeitura autorizadora de NFS-e é o órgão municipal responsável por receber, validar e autorizar as notas fiscais de serviço eletrônicas emitidas pelos prestadores estabelecidos no município. Ela define o sistema, as regras e o leiaute de emissão, ou adere ao Padrão Nacional, e confirma a validade da nota para fins de cobrança do ISSQN. **Também conhecido como:** Município autorizador de NFS-e, Prefeitura emissora de NFS-e, Autorizador municipal de NFS-e **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** P ## O que faz uma prefeitura autorizadora de NFS-e? A prefeitura autorizadora é quem dá validade oficial à nota fiscal de serviço. Quando uma empresa presta um serviço e emite a NFS-e, os dados são enviados ao sistema indicado pelo município. Lá, a nota é conferida e, se estiver tudo certo, recebe um número e uma autorização. Só a partir desse momento ela passa a valer como documento fiscal. Além de autorizar, a prefeitura usa essas informações para fiscalizar e cobrar o ISSQN, o imposto municipal sobre serviços. Ela também define quem pode emitir, quais serviços são aceitos, quais alíquotas valem e como funcionam cancelamentos e substituições de notas. ## Por que cada prefeitura tem regras diferentes? O ISSQN é um imposto de competência municipal. Por isso, durante muito tempo, cada cidade pôde escolher seu próprio sistema de NFS-e, seja desenvolvido internamente, seja contratado de um fornecedor de tecnologia. O resultado foi uma grande variedade de leiautes, formas de autenticação, campos obrigatórios e mensagens de erro. Na prática, emitir uma nota em uma cidade pode exigir dados ou formatos diferentes de outra cidade vizinha. Algumas aceitam envio direto da nota, outras trabalham com RPS convertido em NFS-e, e algumas processam os envios em lote e de forma assíncrona. ## Qual a diferença entre prefeitura autorizadora e SEFAZ? A SEFAZ é a secretaria estadual que autoriza documentos ligados a mercadorias e transporte, como NF-e, NFC-e, CT-e e MDF-e, em que o principal imposto é o ICMS. Esses documentos seguem leiautes nacionais padronizados. A prefeitura autorizadora cuida da NFS-e, ligada à prestação de serviços e ao ISSQN. Uma mesma empresa pode, portanto, emitir notas de produto autorizadas pela SEFAZ do seu estado e notas de serviço autorizadas pela prefeitura do seu município. ## Como o Padrão Nacional muda o papel da prefeitura? O Padrão Nacional da NFS-e criou um leiaute único e um ambiente nacional para emissão e compartilhamento das notas de serviço. Municípios que aderem a esse modelo passam a receber as notas por essa estrutura comum, em vez de manter um sistema exclusivo. Mesmo assim, a prefeitura continua sendo a responsável pelo ISSQN do seu território: ela segue definindo parâmetros como alíquotas, regimes especiais e regras de retenção. A mudança está principalmente na forma técnica de emissão, que fica mais uniforme entre as cidades aderentes. ## Como saber qual prefeitura autoriza a minha NFS-e? Em regra, a nota é autorizada pela prefeitura do município onde o prestador de serviço está estabelecido e possui inscrição municipal. É nesse cadastro que a empresa obtém a habilitação para emitir NFS-e. Isso não deve ser confundido com o município de incidência do ISSQN. Em alguns serviços, o imposto é devido no local da prestação ou no município do tomador, mesmo que a nota seja emitida no sistema da cidade do prestador. ## Por que isso importa para quem integra a emissão por API? Para um ERP, marketplace ou plataforma de vendas, lidar diretamente com cada prefeitura significa manter várias integrações diferentes, acompanhar mudanças de leiaute e interpretar rejeições específicas de cada sistema. Quanto mais cidades atendidas, maior esse esforço. Uma API fiscal como a do Conota funciona como uma camada única entre o sistema do cliente e as prefeituras suportadas. O sistema envia os dados em um formato padronizado, e a API se encarrega da comunicação com o ambiente do município, do acompanhamento até a autorização e da devolução de XML, PDF e status. A disponibilidade depende do município e do ambiente suportado. ## Exemplos de Prefeitura autorizadora de NFS-e - Uma agência de marketing com sede em um município emite a NFS-e no sistema da prefeitura local, que valida os dados e autoriza a nota com número próprio. - Um ERP que atende clientes em várias cidades usa uma API fiscal para emitir NFS-e sem precisar programar uma integração diferente para cada prefeitura autorizadora. - Uma empresa recebe uma rejeição porque o código de serviço informado não consta na lista aceita pela prefeitura autorizadora e corrige o cadastro antes de reenviar. - Após o município aderir ao Padrão Nacional, uma clínica passa a emitir suas notas no novo leiaute, mas continua recolhendo o ISSQN conforme as regras da prefeitura. ## Perguntas frequentes ### A prefeitura autorizadora é sempre a da cidade do cliente? Não. Em geral, a NFS-e é autorizada pela prefeitura onde o prestador está estabelecido e inscrito. A cidade do cliente pode ser relevante para definir onde o ISSQN é devido, mas não costuma ser quem autoriza a nota. ### Preciso me cadastrar na prefeitura para emitir NFS-e? Sim. O prestador normalmente precisa ter inscrição municipal e estar habilitado no sistema da prefeitura ou no ambiente indicado por ela antes de emitir notas, mesmo quando a emissão é feita por API. ### Toda prefeitura usa o Padrão Nacional da NFS-e? Não necessariamente. A adesão vem crescendo, mas ainda há municípios com sistemas próprios ou de fornecedores específicos. Por isso é importante verificar qual modelo a prefeitura do prestador adota. ### Uma API fiscal substitui a prefeitura autorizadora? Não. A API apenas intermedeia o envio e o acompanhamento da nota. Quem autoriza e dá validade fiscal ao documento continua sendo a prefeitura ou o ambiente oficial ao qual ela aderiu. ## Termos relacionados - [NFS-e](https://conota.dev/glossario/nfs-e.md) - [Padrão Nacional da NFS-e](https://conota.dev/glossario/padrao-nacional-da-nfs-e.md) - [ISSQN](https://conota.dev/glossario/issqn.md) - [Inscrição municipal](https://conota.dev/glossario/inscricao-municipal.md) - [RPS](https://conota.dev/glossario/rps.md) - [SEFAZ](https://conota.dev/glossario/sefaz.md) --- Fonte: [Prefeitura autorizadora de NFS-e](https://conota.dev/glossario/prefeitura-autorizadora-de-nfs-e/) · Atualizado em 2026-10-22 --- # Prescrição tributária > Prescrição tributária é a perda do direito do Fisco de cobrar judicialmente um tributo já constituído, por não ter iniciado a cobrança dentro do prazo previsto em lei. No Brasil, a regra geral é de cinco anos, contados da constituição definitiva do crédito tributário. Depois desse prazo, o crédito é extinto e não pode mais ser exigido. **Também conhecido como:** Prescrição do crédito tributário, Prescrição da ação de cobrança do crédito tributário, Prescrição fiscal, Tax statute of limitations **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** P ## O que é prescrição tributária, em palavras simples? É um prazo que o governo tem para cobrar na Justiça um imposto que já sabe que é devido. Se o Fisco identifica a dívida, formaliza o valor e mesmo assim deixa passar o prazo sem agir, perde o direito de cobrá-la. A ideia por trás da prescrição é a segurança jurídica: nem o contribuinte nem o Estado devem ficar indefinidamente sujeitos a cobranças antigas. Pelo Código Tributário Nacional, a prescrição é uma das formas de extinção do crédito tributário. ## Como funciona o prazo da prescrição tributária? A regra geral é de cinco anos, contados a partir da constituição definitiva do crédito tributário. Em linguagem simples, o prazo começa quando o valor do tributo fica oficialmente definido, por exemplo, depois que o contribuinte declara o imposto e não paga, ou depois que um auto de infração deixa de poder ser contestado na esfera administrativa. Esse prazo pode ser interrompido, o que faz a contagem recomeçar do zero. Entre as situações previstas estão o despacho do juiz que ordena a citação do devedor em uma execução fiscal e qualquer ato inequívoco em que o devedor reconhece a dívida, como um pedido de parcelamento. ## Qual a diferença entre prescrição e decadência tributária? A decadência acontece antes: é a perda do direito do Fisco de constituir o crédito, ou seja, de lançar e formalizar o tributo devido. Se o Fisco nem chega a apurar e cobrar oficialmente o valor dentro do prazo, ocorre a decadência. A prescrição acontece depois: o crédito já foi constituído, mas o Fisco não ajuizou a cobrança a tempo. Ambas costumam ter prazo de cinco anos, mas com pontos de partida diferentes, e juntas definem por quanto tempo uma operação ainda pode gerar cobrança. ## O que é prescrição intercorrente? É a prescrição que ocorre durante um processo de execução fiscal já em andamento. Se a cobrança fica parada por muito tempo, por exemplo porque o devedor ou seus bens não são encontrados, e o Fisco não dá andamento ao caso dentro dos prazos legais, o juiz pode reconhecer que a dívida prescreveu mesmo com o processo aberto. ## Por que a prescrição importa para quem emite notas fiscais? Notas fiscais como NF-e, NFS-e, NFC-e e CT-e são a prova das operações que geram tributos. Enquanto os prazos de decadência e prescrição não terminam, o Fisco pode questionar essas operações e o contribuinte precisa conseguir comprovar o que fez. Por isso, a guarda dos arquivos XML e dos eventos de cada documento, como cancelamentos e cartas de correção, deve cobrir pelo menos esse período. Sistemas que recebem automaticamente XML, PDF e status de cada nota facilitam montar um histórico organizado e consultável quando houver fiscalização ou disputa. ## Exemplos de Prescrição tributária - Uma empresa declarou ISSQN de um mês, mas não pagou. O município não ajuizou a execução fiscal em cinco anos contados da constituição do crédito, nem houve causa de interrupção. A empresa pode alegar prescrição e pedir a extinção da dívida. - Um varejista recebe uma cobrança antiga de ICMS e, antes de completar cinco anos, pede parcelamento. Esse pedido reconhece a dívida e interrompe a prescrição, reiniciando a contagem do prazo. - Uma plataforma de vendas mantém os XMLs de NF-e e NFC-e organizados por CNPJ e período, o que permite comprovar operações antigas durante uma fiscalização ainda dentro do prazo de cobrança. - Em uma execução fiscal, o devedor não é localizado e o processo fica arquivado por anos sem providências do Fisco. O juiz reconhece a prescrição intercorrente. ## Perguntas frequentes ### Qual é o prazo de prescrição tributária no Brasil? A regra geral do Código Tributário Nacional é de cinco anos, contados da constituição definitiva do crédito tributário. Esse prazo pode ser interrompido em situações previstas em lei, fazendo a contagem recomeçar. ### Parcelar uma dívida tributária afeta a prescrição? Sim. O pedido de parcelamento é considerado reconhecimento da dívida pelo devedor, o que interrompe a prescrição. A contagem de cinco anos recomeça a partir desse ato. ### Dívida tributária prescrita pode ser cobrada? Não. No direito tributário, a prescrição extingue o próprio crédito. Por isso, o contribuinte pode alegar prescrição para se defender e, em regra, quem pagou tributo prescrito pode discutir a restituição do valor. ### Posso apagar os XMLs das notas depois de cinco anos da emissão? Não necessariamente. Os prazos de decadência e prescrição podem começar depois da emissão ou ser interrompidos. O ideal é avaliar cada caso com a contabilidade antes de descartar documentos. ## Termos relacionados - [Fiscalização tributária](https://conota.dev/glossario/fiscalizacao-tributaria.md) - [Guarda de documentos fiscais](https://conota.dev/glossario/guarda-de-documentos-fiscais.md) - [Fato gerador](https://conota.dev/glossario/fato-gerador.md) - [Juros de mora tributária](https://conota.dev/glossario/juros-de-mora-tributaria.md) - [Julgamento administrativo tributário](https://conota.dev/glossario/julgamento-administrativo-tributario.md) - [Fisco](https://conota.dev/glossario/fisco.md) --- Fonte: [Prescrição tributária](https://conota.dev/glossario/prescricao-tributaria/) · Atualizado em 2026-10-22 --- # Prestador de serviço > Prestador de serviço é a pessoa física ou jurídica que executa uma atividade para outra pessoa, chamada tomador, em troca de pagamento. Nos documentos fiscais, é quem emite a nota de serviço, como a NFS-e, informa seus dados cadastrais e, em regra, responde pelo recolhimento do ISSQN sobre o serviço prestado. **Também conhecido como:** Prestador, Prestador de serviços, Empresa prestadora, Prestadora de serviço, Service provider **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** P ## O que é o prestador de serviço na nota fiscal? Na nota fiscal de serviço, o prestador é a parte que realizou o trabalho e que está cobrando por ele. Pode ser uma empresa, como uma agência de marketing ou uma software house, ou um profissional autônomo, como um consultor ou um eletricista. Na maioria dos casos, o prestador também é o emitente do documento: é ele quem gera a NFS-e, informa o que foi feito, o valor cobrado e os tributos envolvidos. Por isso, os dados do prestador aparecem em destaque no documento e identificam quem é o responsável pela operação perante a prefeitura. ## Qual a diferença entre prestador e tomador de serviço? O prestador é quem faz o serviço; o tomador é quem contrata e paga por ele. Se uma empresa contrata uma consultoria contábil, a consultoria é a prestadora e a empresa contratante é a tomadora. Essa distinção importa porque define as responsabilidades fiscais. Em geral, o prestador emite a nota e recolhe o ISSQN. Em algumas situações previstas pela legislação municipal, porém, o tomador fica obrigado a reter o imposto e recolhê-lo no lugar do prestador, o que é chamado de retenção de ISSQN. ## Quais dados do prestador aparecem na NFS-e? Os dados mais comuns são CNPJ ou CPF, razão social ou nome, endereço, inscrição municipal e informações sobre o regime tributário, como se a empresa é optante pelo Simples Nacional. Esses dados ajudam a prefeitura a identificar quem prestou o serviço e qual tributação se aplica. Também entram na nota informações ligadas à atividade do prestador, como o código do serviço na lista de serviços, a alíquota do ISSQN e o município de incidência do imposto. Dados cadastrais errados ou desatualizados estão entre as causas frequentes de rejeição da nota. ## Quais são as obrigações fiscais do prestador de serviço? A obrigação principal é emitir o documento fiscal correspondente a cada serviço prestado e recolher os tributos devidos, especialmente o ISSQN, que é um imposto municipal. Dependendo do regime tributário, também podem incidir outros tributos federais. Além disso, o prestador costuma precisar estar cadastrado na prefeitura, manter a inscrição municipal regular, guardar os documentos emitidos e cumprir obrigações acessórias, como a escrituração fiscal. As regras exatas variam de acordo com o município e com o enquadramento da empresa. ## Como um prestador de serviço emite NFS-e por API? Antes de emitir, o prestador precisa estar habilitado para emissão na prefeitura do seu município ou no Padrão Nacional da NFS-e, conforme o caso, e geralmente precisa de um certificado digital, como o A1, para assinar os documentos. Com isso pronto, o sistema que registra a venda, como um ERP ou uma plataforma de gestão, envia os dados do serviço para uma API fiscal. A API monta o documento, envia à prefeitura autorizadora ou ao ambiente nacional, acompanha o processamento e devolve o XML, o PDF e o status da nota. Empresas que atendem vários prestadores podem gerenciar cada CNPJ como uma empresa emissora separada. ## Uma transportadora também é prestadora de serviço? Sim. Quem realiza transporte de cargas para terceiros presta um serviço de transporte. A diferença é que, no transporte interestadual e intermunicipal, o documento usado normalmente é o CT-e, e o tributo principal costuma ser o ICMS, não o ISSQN. Por isso, o termo prestador de serviço aparece tanto em notas de serviço municipais quanto em documentos de transporte, sempre indicando quem executou a atividade contratada. ## Exemplos de Prestador de serviço - Uma software house que vende assinaturas de sistema emite NFS-e mensalmente para cada cliente, figurando como prestadora de serviço e o cliente como tomador. - Uma plataforma de agendamento integra seu sistema a uma API fiscal para que cada clínica cadastrada, como prestadora de serviço, emita NFS-e automaticamente após cada consulta paga. - Um marketplace de serviços gerencia centenas de prestadores, cada um com seu CNPJ, inscrição municipal e certificado digital, emitindo notas em municípios diferentes por uma única integração. - Uma transportadora atua como prestadora de serviço de transporte e emite CT-e para documentar o frete contratado por uma indústria. ## Perguntas frequentes ### Pessoa física pode ser prestadora de serviço? Sim. Profissionais autônomos podem prestar serviços como pessoa física. As regras para emissão de nota e recolhimento de tributos variam conforme o município e o tipo de atividade, então é importante verificar a legislação local. ### O prestador sempre paga o ISSQN? Nem sempre. Em regra, o prestador recolhe o imposto, mas em situações previstas na legislação o tomador deve reter o ISSQN e recolhê-lo no lugar do prestador. Isso precisa ser indicado corretamente na NFS-e. ### Prestador de serviço precisa de inscrição municipal? Na maioria dos casos, sim. A inscrição municipal identifica o prestador na prefeitura e costuma ser exigida para emitir NFS-e e recolher o ISSQN. Os requisitos variam de município para município. ### MEI pode ser prestador de serviço? Sim. O MEI pode prestar serviços permitidos para sua categoria e emitir NFS-e, seguindo regras específicas de emissão e tributação aplicáveis a esse enquadramento. ## Termos relacionados - [Tomador de serviço](https://conota.dev/glossario/tomador-de-servico.md) - [NFS-e](https://conota.dev/glossario/nfs-e.md) - [ISSQN](https://conota.dev/glossario/issqn.md) - [Inscrição municipal](https://conota.dev/glossario/inscricao-municipal.md) - [Emitente de documento fiscal](https://conota.dev/glossario/emitente-de-documento-fiscal.md) - [Retenção de ISSQN](https://conota.dev/glossario/retencao-de-issqn.md) --- Fonte: [Prestador de serviço](https://conota.dev/glossario/prestador-de-servico/) · Atualizado em 2026-10-22 --- # Processamento assíncrono > Processamento assíncrono é uma forma de executar tarefas em que o sistema recebe o pedido, confirma o recebimento imediatamente e conclui o trabalho depois, sem deixar quem pediu esperando. Na emissão fiscal por API, significa enviar a nota, receber um identificador e acompanhar o resultado da autorização por consulta ou notificação. **Também conhecido como:** Processamento em segundo plano, Processamento não bloqueante, Processamento async, Asynchronous processing **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** P ## O que é processamento assíncrono na prática? Imagine deixar uma roupa na lavanderia. Você entrega a peça, recebe um comprovante e vai embora. A lavagem acontece depois, e você volta ou é avisado quando estiver pronta. Isso é processamento assíncrono: o pedido é aceito na hora, mas o resultado só fica disponível mais tarde. Em sistemas, a lógica é a mesma. Um programa envia uma requisição, recebe uma resposta rápida dizendo que o pedido foi registrado, geralmente com um número de identificação, e segue fazendo outras coisas. O trabalho pesado continua em segundo plano, normalmente organizado em uma fila. ## Qual a diferença entre processamento síncrono e assíncrono? No modelo síncrono, quem faz o pedido fica parado esperando a resposta final. É como pedir um café no balcão e aguardar ali até ele ficar pronto. Funciona bem para tarefas rápidas e previsíveis. No modelo assíncrono, a resposta imediata é apenas uma confirmação de recebimento. O resultado definitivo, como sucesso ou erro, chega depois. Esse modelo é mais adequado quando a tarefa pode demorar, depende de serviços externos ou precisa ser feita em grande volume. ## Por que a emissão de notas fiscais costuma ser assíncrona? Emitir um documento fiscal envolve várias etapas: validar os dados, montar o XML, assinar digitalmente e enviar ao órgão autorizador, como a SEFAZ ou a prefeitura. Esses órgãos podem demorar, ficar instáveis ou passar por manutenção, e o tempo de resposta varia bastante. Se o sistema de vendas ficasse travado esperando cada autorização, uma lentidão no órgão autorizador poderia derrubar o checkout ou atrasar o faturamento. Com o processamento assíncrono, o sistema do cliente registra o pedido de emissão, recebe um identificador e continua operando, enquanto a infraestrutura fiscal cuida das tentativas, das esperas e do retorno do resultado. ## Como saber quando o documento foi autorizado? Há duas formas principais. A primeira é o polling: o sistema consulta periodicamente o status do documento usando o identificador recebido, até que ele mude para autorizado, rejeitado ou outro estado final. A segunda é a notificação automática, geralmente via webhook: assim que o processamento termina, a plataforma envia uma mensagem ao sistema do cliente com o status e, quando aplicável, os links para o XML e o PDF. Muitas integrações combinam os dois métodos, usando a consulta como reforço caso alguma notificação se perca. ## Quais cuidados tomar ao integrar um fluxo assíncrono? O primeiro é não tratar a confirmação de recebimento como autorização. A nota só tem validade depois que o órgão autorizador a aprova, então o sistema deve aguardar o status final antes de, por exemplo, liberar a entrega ou enviar o documento ao cliente. Também é importante usar idempotência para evitar notas duplicadas quando uma requisição é reenviada, tratar timeouts com novas tentativas espaçadas e validar a autenticidade das notificações recebidas. Guardar o identificador de cada pedido facilita consultas, reprocessamentos e auditoria. ## Exemplos de Processamento assíncrono - Um e-commerce finaliza um pedido e envia os dados da NF-e para a API fiscal. Recebe na hora um identificador e o status de processamento, e alguns segundos depois um webhook informa que a nota foi autorizada, com links para o XML e o DANFE. - Um ERP precisa emitir centenas de NFS-e no fechamento do mês. Ele envia todos os pedidos de uma vez, e cada nota é processada em segundo plano conforme a prefeitura responde, sem travar o sistema. - Durante uma instabilidade na SEFAZ, uma plataforma de vendas continua registrando emissões normalmente. Os documentos ficam na fila e são autorizados quando o serviço volta, e o sistema do cliente acompanha tudo por consulta de status. - Uma transportadora emite um CT-e e o software de gestão consulta o status a cada poucos segundos até receber a autorização, para só então gerar o MDF-e da viagem. ## Perguntas frequentes ### Processamento assíncrono deixa a emissão mais lenta? Não necessariamente. O tempo de autorização depende principalmente do órgão autorizador. A diferença é que o sistema do cliente não fica parado esperando, o que torna a operação mais estável e permite lidar melhor com picos e instabilidades. ### Se recebi um identificador, a nota já está emitida? Não. O identificador apenas confirma que o pedido foi recebido. A nota só é válida quando o status indica autorização. Até lá, ela ainda pode ser rejeitada por erro de dados ou outros motivos. ### É melhor usar polling ou webhook? O webhook é mais eficiente, pois avisa assim que o resultado sai, sem consultas repetidas. O polling é mais simples de implementar. Uma prática comum é usar webhook como principal e polling como verificação de segurança. ## Termos relacionados - [Fluxo assíncrono de emissão](https://conota.dev/glossario/fluxo-assincrono-de-emissao.md) - [Polling de status fiscal](https://conota.dev/glossario/polling-de-status-fiscal.md) - [Fila de emissão fiscal](https://conota.dev/glossario/fila-de-emissao-fiscal.md) - [Status de documento fiscal](https://conota.dev/glossario/status-de-documento-fiscal.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) --- Fonte: [Processamento assíncrono](https://conota.dev/glossario/processamento-assincrono/) · Atualizado em 2026-10-22 --- # Procuração eletrônica > Procuração eletrônica é uma autorização digital em que uma pessoa ou empresa permite que outra, como um contador, acesse serviços online de órgãos públicos em seu nome. Ela é registrada no sistema do próprio órgão, geralmente com certificado digital, e define quais serviços o procurador pode usar e por quanto tempo. **Também conhecido como:** Procuração digital, Procuração eletrônica do e-CAC, Procuração RFB, Electronic power of attorney **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** P ## O que é procuração eletrônica? A procuração eletrônica é a versão digital da procuração tradicional em papel. Em vez de ir a um cartório ou entregar um documento físico, o responsável pela empresa registra a autorização diretamente no portal do órgão público, indicando quem poderá agir em seu nome. O caso mais conhecido no Brasil é a procuração eletrônica do e-CAC, o centro de atendimento virtual da Receita Federal. Alguns órgãos estaduais e municipais também oferecem mecanismos próprios de procuração ou de autorização de acesso de terceiros, com regras que variam de um lugar para outro. ## Para que serve a procuração eletrônica? Ela serve para que alguém de confiança, como um escritório de contabilidade, um advogado ou um funcionário, consulte informações e execute tarefas fiscais sem precisar usar o certificado digital da empresa. Assim, o dono do certificado não precisa compartilhar o arquivo nem a senha. Na prática, isso permite, por exemplo, consultar pendências, acompanhar processos, verificar a situação cadastral, acessar mensagens da caixa postal do contribuinte e transmitir declarações, conforme os serviços liberados na procuração. ## Como funciona a procuração eletrônica? O outorgante, que é quem concede a autorização, acessa o portal do órgão e indica o CPF ou CNPJ do procurador. Em seguida, escolhe os serviços que serão liberados e o prazo de validade. Normalmente esse processo exige autenticação forte, como certificado digital e-CNPJ ou e-CPF. Depois de registrada, o procurador entra no portal com a própria identificação, por exemplo o seu certificado digital, e passa a enxergar os serviços da empresa que o autorizou. A procuração pode ser cancelada pelo outorgante a qualquer momento, e o órgão mantém registro dos acessos realizados. ## A procuração eletrônica permite emitir notas fiscais em nome de outra empresa? Em geral, não. A emissão de documentos fiscais eletrônicos como NF-e, NFC-e, CT-e e MDF-e exige que o arquivo XML seja assinado digitalmente com um certificado da própria empresa emitente. A procuração eletrônica dá acesso a serviços em portais, mas não substitui essa assinatura. Por isso, quando um sistema emite notas por API, ele trabalha com o certificado digital de cada empresa emissora, e não com uma procuração. No caso da NFS-e, as formas de acesso e autorização podem variar conforme o município ou o padrão nacional adotado, então vale verificar as regras de cada caso. ## Qual a diferença entre procuração eletrônica e certificado digital? O certificado digital é a identidade eletrônica de uma pessoa ou empresa, emitido dentro da ICP-Brasil. Ele comprova quem está acessando um sistema ou assinando um documento. A procuração eletrônica é uma permissão. Ela não cria uma nova identidade: apenas diz ao órgão público que o titular de um certificado pode agir em nome de outro contribuinte, dentro dos limites definidos. Muitas vezes os dois são usados juntos, já que o procurador costuma acessar o portal com o próprio certificado. ## Exemplos de Procuração eletrônica - Uma loja virtual registra uma procuração eletrônica no e-CAC para que seu escritório de contabilidade consulte pendências fiscais e acompanhe a caixa postal da empresa na Receita Federal. - Um grupo com várias filiais concede procuração a um analista fiscal da matriz para que ele acompanhe a situação cadastral de todos os CNPJs sem precisar manusear os certificados de cada empresa. - Ao trocar de contador, uma empresa cancela a procuração eletrônica do escritório antigo e cria uma nova para o escritório atual, mantendo o controle de quem acessa seus dados. - Uma empresa que emite NF-e por API mantém seu certificado A1 cadastrado na plataforma de emissão e, separadamente, usa procuração eletrônica apenas para que o contador acesse os serviços da Receita. ## Perguntas frequentes ### Preciso de certificado digital para criar uma procuração eletrônica? Na maioria dos casos, sim. Portais como o e-CAC costumam exigir autenticação com certificado digital ou outro meio de segurança elevada. Quando isso não é possível, alguns órgãos aceitam um pedido presencial ou por formulário, conforme suas regras. ### A procuração eletrônica pode ser cancelada? Sim. O outorgante pode revogar a procuração a qualquer momento pelo próprio portal do órgão. Também é possível definir uma data de validade, após a qual a autorização deixa de valer automaticamente. ### Uma procuração do e-CAC vale para a SEFAZ ou a prefeitura? Não necessariamente. Cada órgão tem seus próprios sistemas e regras. A procuração registrada na Receita Federal vale para os serviços da Receita; para órgãos estaduais e municipais, é preciso verificar se existe um mecanismo próprio de autorização. ### Posso escolher quais serviços o procurador acessa? Sim. Ao registrar a procuração, o outorgante seleciona os serviços liberados. É recomendável conceder apenas o necessário para a função do procurador, reduzindo riscos de acessos indevidos. ## Termos relacionados - [Certificado digital A1](https://conota.dev/glossario/certificado-digital-a1.md) - [e-CNPJ](https://conota.dev/glossario/e-cnpj.md) - [ICP-Brasil](https://conota.dev/glossario/icp-brasil.md) - [Domicílio tributário eletrônico](https://conota.dev/glossario/domicilio-tributario-eletronico.md) - [Gestão de empresas emissoras](https://conota.dev/glossario/gestao-de-empresas-emissoras.md) --- Fonte: [Procuração eletrônica](https://conota.dev/glossario/procuracao-eletronica/) · Atualizado em 2026-10-22 --- # Protocolo de autorização > Protocolo de autorização é o número de registro que a SEFAZ ou outro órgão autorizador devolve quando aprova um documento fiscal eletrônico, como NF-e, NFC-e, CT-e ou MDF-e. Ele comprova que o documento foi validado e autorizado, informa a data e a hora do processamento e passa a fazer parte do XML oficial. **Também conhecido como:** Protocolo de autorização de uso, Número do protocolo, nProt, Protocolo de uso, Authorization protocol **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** P ## O que é o protocolo de autorização? Quando uma empresa emite uma nota fiscal eletrônica, o arquivo XML é enviado ao órgão autorizador, normalmente a SEFAZ do estado. Esse órgão verifica a assinatura digital, o leiaute, os dados do emitente e as regras fiscais. Se estiver tudo certo, ele responde com um protocolo de autorização. O protocolo funciona como um carimbo oficial. Ele registra que aquele documento específico, identificado pela chave de acesso, foi aceito em determinado momento. Sem esse registro, o documento não tem validade jurídica, mesmo que o XML tenha sido gerado e assinado corretamente. ## Quais informações o protocolo contém? Na NF-e, o protocolo fica em um grupo do XML chamado protNFe. Nele aparecem o número do protocolo (campo nProt), a chave de acesso do documento, a data e a hora do recebimento, o código de status e a mensagem de retorno. Também consta um resumo criptográfico (digest) do conteúdo autorizado, que vincula o protocolo exatamente àquela versão do arquivo. No caso da autorização, o código de status mais comum é o 100, acompanhado da mensagem de autorização de uso. CT-e e MDF-e seguem lógica parecida, com grupos equivalentes como protCTe e protMDFe. ## Para que serve o protocolo de autorização? Serve para comprovar a validade do documento. É com ele que o destinatário, a transportadora ou a fiscalização confirmam que a nota foi realmente autorizada, e não apenas gerada pelo sistema do emitente. O número do protocolo também aparece impresso nos documentos auxiliares, como o DANFE, o DACTE e o DAMDFE. Além disso, o XML de distribuição, que deve ser guardado e enviado ao destinatário, é formado pela união do documento assinado com o seu protocolo. ## Qual a diferença entre protocolo de autorização e recibo de lote? O recibo de lote é um comprovante de que o órgão autorizador recebeu o envio, mas ainda não decidiu se aprova ou rejeita. Ele é usado no processamento assíncrono para consultar o resultado depois. O protocolo de autorização é a resposta final positiva. Ou seja: o recibo diz "recebi", enquanto o protocolo diz "autorizei". Se houver erro, em vez do protocolo de autorização o sistema recebe uma rejeição com o motivo. ## Eventos também geram protocolo? Sim. Cancelamento, carta de correção, encerramento do MDF-e e outros eventos fiscais recebem um protocolo próprio quando são registrados. Esse protocolo comprova o evento, mas não substitui o protocolo de autorização original do documento, que continua sendo a referência da emissão. ## Como o protocolo chega ao sistema da empresa numa emissão por API? Em uma API fiscal, o sistema da empresa envia os dados da venda e a infraestrutura de emissão cuida da comunicação com o órgão autorizador. Quando a autorização sai, a API devolve o status do documento, o número do protocolo e o XML já com o protocolo anexado, geralmente por webhook ou por consulta de status. Para quem integra, o ponto importante é tratar o documento como válido somente após receber o protocolo de autorização, e guardar o XML completo, não apenas o arquivo enviado. ## Exemplos de Protocolo de autorização - Um ERP envia uma NF-e de venda por API, recebe o status autorizado com o número do protocolo e grava esse número junto ao pedido para consultas futuras. - Um cliente questiona a validade de uma nota e o atendimento informa a chave de acesso e o protocolo de autorização para que ele confirme a situação no portal da SEFAZ. - Uma transportadora imprime o DAMDFE e confere se o número do protocolo de autorização do MDF-e aparece antes de liberar o veículo. - Uma plataforma de vendas recebe uma rejeição em vez de protocolo, corrige o NCM do produto e reenvia a nota até obter a autorização. ## Perguntas frequentes ### Nota sem protocolo de autorização tem validade? Não. Sem protocolo, o documento foi apenas gerado ou enviado, mas não autorizado. A exceção são situações de contingência previstas na legislação, em que a autorização ocorre depois, dentro de prazos e regras específicas. ### Onde encontro o número do protocolo? No XML autorizado, dentro do grupo de protocolo (como protNFe, no campo nProt), e impresso no documento auxiliar, como o DANFE. Em emissões por API, ele também costuma vir na resposta de status. ### Protocolo de autorização é o mesmo que chave de acesso? Não. A chave de acesso identifica o documento e é gerada pelo emitente. O protocolo é gerado pelo órgão autorizador e comprova que aquele documento foi aprovado. ### Preciso guardar o protocolo separadamente? Não é necessário, desde que você guarde o XML de distribuição completo, que já reúne o documento assinado e o protocolo. Guardar só o XML enviado, sem o protocolo, é um erro comum. ## Termos relacionados - [Autorização de uso da NF-e](https://conota.dev/glossario/autorizacao-de-uso-da-nf-e.md) - [Chave de acesso da NF-e](https://conota.dev/glossario/chave-de-acesso-da-nf-e.md) - [Recibo de lote](https://conota.dev/glossario/recibo-de-lote.md) - [Status de documento fiscal](https://conota.dev/glossario/status-de-documento-fiscal.md) - [SEFAZ](https://conota.dev/glossario/sefaz.md) - [Arquivo XML fiscal](https://conota.dev/glossario/arquivo-xml-fiscal.md) --- Fonte: [Protocolo de autorização](https://conota.dev/glossario/protocolo-de-autorizacao/) · Atualizado em 2026-10-22 --- # Provedor municipal de NFS-e > Provedor municipal de NFS-e é o sistema usado por uma prefeitura para receber, validar, autorizar e armazenar as notas fiscais de serviço eletrônicas dos prestadores da cidade. Ele pode ser desenvolvido pelo próprio município ou por uma empresa de tecnologia contratada, e cada provedor tem regras, layouts e formas de integração próprias. **Também conhecido como:** Provedor de NFS-e, Sistema municipal de NFS-e, Padrão municipal de NFS-e, Webservice municipal de NFS-e, Municipal NFS-e provider **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** P ## O que faz um provedor municipal de NFS-e? Na NF-e, a nota de produtos, quem autoriza o documento é a SEFAZ de cada estado, seguindo um padrão nacional único. Na NFS-e, a nota de serviços, a responsabilidade é do município, porque o principal imposto envolvido, o ISSQN, é municipal. Para cumprir essa função, cada prefeitura usa um sistema: o provedor municipal de NFS-e. Esse sistema recebe os dados da nota enviados pelo prestador, confere se estão corretos (inscrição municipal, código do serviço, alíquota, tomador etc.), gera o número da nota, registra o documento e disponibiliza consulta, cancelamento e o documento auxiliar para impressão. Em resumo, ele é a porta de entrada da nota de serviço na prefeitura. ## Por que cada prefeitura tem um provedor diferente? Durante muito tempo não houve um sistema obrigatório e único para a NFS-e no país. Cada município decidiu sozinho como implantar a nota eletrônica: alguns criaram sistemas próprios e muitos contrataram empresas de software especializadas em gestão tributária municipal. O resultado é um cenário fragmentado. Mesmo quando dois provedores seguem um modelo de referência parecido, como o padrão proposto pela ABRASF, cada um costuma ter versões, campos obrigatórios, códigos de serviço e mensagens de erro diferentes. Uma empresa que presta serviços em várias cidades pode precisar lidar com vários provedores ao mesmo tempo. ## Como o provedor afeta a integração por API? Para um ERP, plataforma de vendas ou marketplace que emite NFS-e, o provedor define quase tudo na comunicação técnica: o formato do XML, o tipo de serviço web (SOAP ou REST), a forma de autenticação (certificado digital, usuário e senha ou token), se a emissão é síncrona ou em lote e como as rejeições são devolvidas. Por isso, integrar diretamente com cada prefeitura exige desenvolver e manter um conector para cada provedor, acompanhando mudanças de versão e instabilidades. Uma API fiscal como a do Conota funciona como camada intermediária: o sistema do cliente envia os dados em um formato único, e a API se encarrega de traduzi-los para o provedor do município, acompanhar o processamento e devolver XML, PDF e status. A cobertura depende de quais municípios e provedores estão suportados. ## Qual a diferença entre provedor municipal e o padrão nacional da NFS-e? O padrão nacional da NFS-e é uma iniciativa para unificar a emissão de notas de serviço em um modelo comum, com leiaute nacional e um ambiente centralizado. Nele, o prestador envia a DPS (Declaração de Prestação de Serviço) e a nota é gerada a partir dela. Os municípios podem aderir ao padrão nacional de formas diferentes: alguns usam diretamente o emissor nacional, outros mantêm seu provedor próprio e compartilham os dados com o ambiente nacional. Na prática, durante a transição, provedores municipais e padrão nacional convivem, e o integrador precisa saber qual caminho cada cidade adota. ## Como saber qual é o provedor do meu município? A informação costuma estar no site da prefeitura, na área de nota fiscal eletrônica ou de tributos, e muitas vezes aparece no próprio endereço do portal de emissão. O contador da empresa e a secretaria de finanças do município também podem informar. Quem emite por uma API fiscal normalmente não precisa descobrir isso manualmente: basta informar o município do prestador, e a plataforma identifica o provedor correspondente e as regras que se aplicam. ## Exemplos de Provedor municipal de NFS-e - Uma software house de gestão para clínicas atende clientes em cinco cidades e descobre que cada prefeitura usa um provedor municipal de NFS-e diferente, com campos e autenticação distintos. - Uma agência de marketing muda de sede para outro município e precisa refazer o cadastro e os testes de emissão, porque o novo provedor exige outro código de serviço e outro formato de envio. - Um marketplace de serviços usa uma API fiscal para emitir NFS-e em nome dos parceiros, sem precisar desenvolver uma integração para cada provedor municipal. - Uma nota de serviço é rejeitada porque o provedor municipal não aceita a alíquota de ISSQN informada para aquele item da lista de serviços. ## Perguntas frequentes ### O provedor municipal de NFS-e é a própria prefeitura? Não necessariamente. A prefeitura é a responsável pela NFS-e, mas o sistema que processa as notas pode ser desenvolvido por ela mesma ou por uma empresa de tecnologia contratada. Em ambos os casos, as regras fiscais são definidas pelo município. ### Preciso de certificado digital para emitir NFS-e? Depende do provedor. Muitos exigem certificado digital para assinar o XML ou autenticar a comunicação, enquanto outros aceitam usuário e senha ou token. O padrão nacional também tem requisitos próprios de autenticação. ### Se o município trocar de provedor, minha integração para de funcionar? Pode parar, já que endereços, layouts e regras mudam. Quem integra diretamente precisa adaptar o sistema. Quem usa uma API fiscal intermediária geralmente depende apenas da atualização feita pela plataforma, mantendo o mesmo formato de envio. ### Todo município tem provedor de NFS-e? A maioria dos municípios já adota alguma forma de NFS-e, seja por provedor próprio, por empresa contratada ou pelo emissor do padrão nacional. A forma de emissão varia de cidade para cidade. ## Termos relacionados - [ISSQN](https://conota.dev/glossario/issqn.md) - [DPS da NFS-e](https://conota.dev/glossario/dps-da-nfs-e.md) - [Inscrição municipal](https://conota.dev/glossario/inscricao-municipal.md) - [Documento auxiliar da NFS-e](https://conota.dev/glossario/documento-auxiliar-da-nfs-e.md) - [Emissão fiscal por API](https://conota.dev/glossario/emissao-fiscal-por-api.md) - [Ambiente de homologação](https://conota.dev/glossario/ambiente-de-homologacao.md) --- Fonte: [Provedor municipal de NFS-e](https://conota.dev/glossario/provedor-municipal-de-nfs-e/) · Atualizado em 2026-10-22