# Glossário de A a Z — letra Z > 20 termos. Glossário compacto: https://conota.dev/glossario/llms-full.txt --- # Zero downtime na atualização de APIs > Zero downtime na atualização de APIs é a prática de publicar novas versões, correções ou mudanças de infraestrutura em uma API sem interromper o serviço. Durante a atualização, os sistemas integrados continuam enviando requisições e recebendo respostas normalmente, sem precisar pausar operações como a emissão de notas fiscais ou aguardar uma janela de manutenção. **Também conhecido como:** Deploy sem downtime, Atualização sem indisponibilidade, Implantação sem interrupção, Zero-downtime deployment **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** Z ## O que significa zero downtime na prática? Downtime é o tempo em que um serviço fica fora do ar. Zero downtime, portanto, quer dizer que a atualização acontece sem que ninguém perceba uma parada. A API continua aceitando chamadas enquanto a versão nova entra no lugar da antiga. Para quem consome a API, como um ERP ou uma plataforma de vendas, o efeito esperado é simples: as requisições seguem funcionando antes, durante e depois da atualização, sem mensagens de serviço indisponível e sem necessidade de reprogramar horários de envio. ## Por que isso é importante em uma API fiscal? A emissão de documentos fiscais costuma estar no meio de processos que não podem esperar. Uma NFC-e precisa ser autorizada enquanto o cliente está no caixa, uma NF-e precisa sair antes de a mercadoria deixar o estoque e um MDF-e precisa existir antes de o caminhão partir. Se a API fiscal parasse a cada atualização, o sistema do cliente teria que acumular pedidos, avisar operadores ou recorrer a contingências. Atualizar sem interrupção reduz esse risco e permite que correções e adaptações a novas notas técnicas sejam publicadas com mais frequência e menos impacto. ## Como funciona uma atualização sem interrupção? Em vez de desligar o servidor antigo e ligar o novo, a infraestrutura mantém as duas versões convivendo por um período. Técnicas comuns incluem a troca gradual de instâncias, uma de cada vez (rolling update), a preparação de um ambiente completo paralelo para depois redirecionar o tráfego (blue-green) e a liberação da versão nova para uma pequena parte das requisições antes de ampliar (canary). Alguns mecanismos sustentam essas técnicas: healthchecks confirmam que a nova instância está pronta antes de receber tráfego, o balanceador de carga só direciona chamadas para instâncias saudáveis e as instâncias antigas terminam as requisições em andamento antes de serem desligadas. Orquestradores como o Kubernetes automatizam boa parte desse processo. ## Qual a diferença entre zero downtime e janela de manutenção? Na janela de manutenção, o provedor avisa com antecedência que a API ficará indisponível ou instável em determinado horário, geralmente de madrugada, e os integradores se planejam para não enviar requisições nesse período. No zero downtime, a ideia é dispensar essa pausa. Ainda assim, alguns provedores mantêm janelas para mudanças muito profundas, como migrações de banco de dados, que são difíceis de fazer sem nenhum efeito. As duas abordagens podem conviver. ## Zero downtime garante que nenhuma emissão vai falhar? Não. A prática evita paradas causadas pela atualização da própria API, mas não controla fatores externos. Se a SEFAZ ou a prefeitura autorizadora estiver instável, a emissão pode demorar ou ser rejeitada, independentemente de como a API foi atualizada. Por isso, o sistema integrador continua precisando de boas práticas próprias: retry com backoff exponencial para erros temporários, idempotência para não emitir a mesma nota duas vezes e consulta de status para acompanhar documentos processados de forma assíncrona. ## O que muda para quem integra com a API? Para o integrador, zero downtime só funciona bem quando vem acompanhado de compatibilidade retroativa. Isso significa que a nova versão da API aceita os mesmos formatos de requisição da anterior, e mudanças que quebram contratos são publicadas em versões separadas, com prazo para migração. Na prática, vale manter timeouts razoáveis, tratar respostas de erro temporário sem interromper o fluxo e acompanhar os comunicados do provedor sobre versões e descontinuações. ## Exemplos de Zero downtime na atualização de APIs - Um ERP envia lotes de NF-e durante o horário comercial enquanto o provedor da API fiscal publica uma correção de validação; as instâncias são trocadas gradualmente e nenhuma requisição recebe erro de indisponibilidade. - Uma rede de varejo emite NFC-e em vários caixas ao mesmo tempo e não precisa ativar contingência porque a atualização da API ocorreu com o tráfego sendo redirecionado apenas para servidores já prontos. - Um provedor libera uma adaptação a uma nova nota técnica primeiro para uma pequena parcela das requisições, monitora as taxas de erro e só depois amplia para todos os clientes. - Uma transportadora mantém a emissão de CT-e e MDF-e rodando durante a madrugada sem precisar consultar um calendário de manutenção, pois a API é atualizada sem pausas programadas. ## Perguntas frequentes ### Zero downtime significa que a API nunca fica fora do ar? Não. Significa que as atualizações planejadas não causam paradas. Falhas inesperadas de infraestrutura, problemas de rede ou instabilidade nos órgãos autorizadores ainda podem afetar o serviço e devem ser tratados com retry, fallback e monitoramento. ### Preciso mudar algo no meu sistema para aproveitar o zero downtime? Em geral, não. Mas é recomendável tratar erros temporários com novas tentativas, usar idempotência nas emissões e acompanhar comunicados sobre novas versões da API para migrar quando houver mudanças incompatíveis. ### Qual a relação entre zero downtime e healthcheck? O healthcheck verifica se uma instância da API está pronta para atender. Durante a atualização, ele impede que o tráfego seja enviado a servidores novos que ainda não terminaram de iniciar, peça essencial para evitar erros. ## Termos relacionados - [Janela de manutenção da API](https://conota.dev/glossario/janela-de-manutencao-da-api.md) - [Healthcheck de API](https://conota.dev/glossario/healthcheck-de-api.md) - [Kubernetes na infraestrutura de APIs](https://conota.dev/glossario/kubernetes-na-infraestrutura-de-apis.md) - [Observabilidade da API fiscal](https://conota.dev/glossario/observabilidade-da-api-fiscal.md) - [Retry na integração fiscal](https://conota.dev/glossario/retry-na-integracao-fiscal.md) - [Idempotência na emissão fiscal](https://conota.dev/glossario/idempotencia-na-emissao-fiscal.md) --- Fonte: [Zero downtime na atualização de APIs](https://conota.dev/glossario/zero-downtime-na-atualizacao-de-apis/) · Atualizado em 2026-10-22 --- # Zero Trust na segurança de APIs > Zero Trust na segurança de APIs é uma abordagem que parte do princípio de que nenhuma requisição deve ser confiável por padrão, mesmo que venha de dentro da rede da empresa. Cada chamada precisa provar quem é, ter permissão específica para a ação pedida e ser registrada, reduzindo o risco de acessos indevidos a dados e operações. **Também conhecido como:** Confiança zero, Arquitetura Zero Trust, Modelo de confiança zero, ZTA, Zero Trust API security **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** Z ## O que significa Zero Trust? Zero Trust significa, literalmente, confiança zero. A ideia central é simples: nunca confiar automaticamente, sempre verificar. Em vez de considerar seguro tudo o que está dentro da rede da empresa, cada acesso é tratado como se viesse de um ambiente desconhecido. Aplicado a APIs, isso quer dizer que toda requisição precisa se identificar, ser autorizada para aquela ação específica e deixar rastro. Não importa se ela vem de um servidor interno, de um parceiro ou de um sistema na nuvem: as regras são as mesmas. ## Como o Zero Trust funciona em uma API? Na prática, o modelo se apoia em alguns pilares. O primeiro é a autenticação forte: cada chamada envia uma credencial, como uma API Key, um token JWT ou um certificado no mTLS, que comprova a identidade de quem está chamando. O segundo é o menor privilégio: cada credencial só pode fazer o mínimo necessário. Uma chave usada apenas para consultar notas não deveria conseguir cancelá-las. O terceiro é a verificação contínua: tokens expiram, chaves são trocadas periodicamente e permissões podem ser revogadas a qualquer momento. Por fim, há o monitoramento. Todas as ações ficam registradas em logs e trilhas de auditoria, o que permite identificar comportamentos estranhos e reconstruir o que aconteceu em caso de incidente. ## Qual a diferença entre Zero Trust e segurança de perímetro? No modelo tradicional, chamado de segurança de perímetro, a empresa protege a fronteira da rede, como um castelo com muralha. Quem consegue entrar passa a ser considerado confiável e circula com pouca restrição. O problema é que, se um invasor atravessa essa barreira, por exemplo com uma senha vazada, ele ganha acesso amplo. No Zero Trust não existe área livre: cada porta interna também pede identificação, o que limita o estrago caso uma credencial seja comprometida. ## Por que o Zero Trust é importante em APIs fiscais? Uma API fiscal lida com dados sensíveis, como CNPJs, valores de vendas, informações de clientes e certificados digitais. Além disso, ela executa ações com efeito legal, como emitir ou cancelar uma NF-e, uma NFS-e ou um MDF-e. Um acesso indevido pode gerar notas falsas, cancelamentos indesejados ou vazamento de informações. Em plataformas que atendem várias empresas ao mesmo tempo, o Zero Trust também reforça a segregação de dados: cada credencial deve enxergar apenas os documentos do seu próprio cliente ou CNPJ, nunca os de outro. ## Como o Zero Trust se aplica a agentes de inteligência artificial? Com o uso de protocolos como o MCP, agentes de IA passam a consultar documentos e executar ações em sistemas fiscais. Nesse cenário, o agente deve ser tratado como qualquer outro cliente da API: com identidade própria, permissões limitadas e registro de tudo o que faz. Assim, é possível autorizar um agente a consultar o status de notas ou listar rejeições sem dar a ele poder para emitir ou cancelar documentos. Se algo sair do esperado, a trilha de auditoria mostra exatamente qual ação foi executada e por qual credencial. ## Exemplos de Zero Trust na segurança de APIs - Um ERP usa uma API Key restrita à emissão de NFC-e de uma única loja; mesmo que a chave vaze, ela não permite cancelar notas nem acessar outros CNPJs. - Uma plataforma de marketplace troca suas credenciais de acesso à API fiscal periodicamente e revoga imediatamente uma chave que apareceu por engano em um repositório de código. - Um agente de IA conectado via MCP recebe permissão apenas para consultar o status de NFS-e e baixar XMLs, e todas as suas consultas ficam registradas para auditoria. - Um servidor interno da empresa, mesmo estando na mesma rede da API, precisa enviar token válido em cada requisição, sem exceções por estar dentro do ambiente corporativo. ## Perguntas frequentes ### Zero Trust é um produto que se compra? Não. Zero Trust é uma filosofia de segurança, colocada em prática com várias técnicas combinadas, como autenticação forte, permissões mínimas, rotação de chaves, criptografia em trânsito e registro de auditoria. ### Usar HTTPS já torna uma API Zero Trust? Não sozinho. O HTTPS protege os dados durante o transporte, mas o Zero Trust também exige identificar quem chama, limitar o que cada credencial pode fazer e monitorar as ações realizadas. ### O Zero Trust deixa a integração mais difícil? Exige um pouco mais de cuidado na configuração, como definir permissões e guardar segredos corretamente. Em troca, reduz muito o impacto de credenciais vazadas e facilita investigar problemas. ## Termos relacionados - [Permissão de acesso à API](https://conota.dev/glossario/permissao-de-acesso-a-api.md) - [mTLS](https://conota.dev/glossario/mtls.md) - [OAuth 2.0](https://conota.dev/glossario/oauth-2-0.md) - [Gerenciamento de segredos](https://conota.dev/glossario/gerenciamento-de-segredos.md) - [Key rotation](https://conota.dev/glossario/key-rotation.md) - [Trilha de auditoria fiscal](https://conota.dev/glossario/trilha-de-auditoria-fiscal.md) --- Fonte: [Zero Trust na segurança de APIs](https://conota.dev/glossario/zero-trust-na-seguranca-de-apis/) · Atualizado em 2026-10-22 --- # Zero-day em sistemas de emissão fiscal > Zero-day em sistemas de emissão fiscal é uma falha de segurança desconhecida pelo fornecedor do software, ou ainda sem correção disponível, que pode ser explorada por atacantes em ERPs, APIs, bibliotecas ou emissores de notas fiscais. O risco inclui roubo de certificados digitais, emissão indevida de documentos, vazamento de dados de clientes e interrupção do faturamento. **Também conhecido como:** Vulnerabilidade de dia zero, Falha zero-day, Exploit zero-day, Zero day, 0-day, Zero-day vulnerability **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** Z ## O que significa zero-day? A expressão vem do inglês e quer dizer algo como dia zero. Ela indica que o responsável pelo software teve zero dias para corrigir o problema antes que ele pudesse ser explorado. Em outras palavras, a falha existe, alguém já sabe dela, mas ainda não há atualização que a resolva. O termo pode se referir à própria vulnerabilidade (a brecha no código) ou ao ataque que se aproveita dela, chamado de exploit zero-day. Em sistemas fiscais, a brecha pode estar no próprio emissor, em uma biblioteca usada para assinar XML, no servidor web, no sistema operacional ou em qualquer componente de terceiros. ## Por que sistemas de emissão fiscal são alvo de ataques? Esses sistemas guardam ativos valiosos: certificados digitais A1 com suas senhas, chaves de API, dados de clientes e fornecedores, valores de vendas e acesso direto aos serviços da SEFAZ e das prefeituras. Quem controla um emissor pode assinar documentos em nome da empresa, emitir notas falsas, cancelar notas legítimas ou paralisar o faturamento. Como o certificado digital tem validade jurídica, o uso indevido pode gerar consequências fiscais e legais para o titular, e não apenas um prejuízo técnico. ## Quais são os principais riscos de um zero-day nesse contexto? O risco mais grave é o vazamento do certificado digital, que permite assinar XMLs como se fosse a própria empresa. Outros riscos comuns são a exposição de API Keys e tokens, o acesso a XMLs com dados sensíveis de destinatários, a alteração de valores ou tributos antes do envio e a interrupção do serviço, impedindo a emissão de NF-e, NFC-e, NFS-e, CT-e ou MDF-e. Em ambientes com agentes de inteligência artificial conectados por MCP, uma falha também pode ser usada para tentar disparar ações automatizadas. Por isso, permissões restritas e registros de auditoria ajudam a limitar o estrago. ## Qual a diferença entre zero-day e vulnerabilidade conhecida? Uma vulnerabilidade conhecida já foi divulgada e, em geral, tem correção publicada. Nesse caso, o risco depende de a empresa aplicar a atualização a tempo. Já o zero-day ainda não tem correção, então atualizar o sistema não resolve, porque a atualização não existe. Na prática, muitos incidentes acontecem com falhas antigas que nunca foram corrigidas pelas empresas. Ou seja, manter tudo atualizado protege contra a maior parte dos ataques, enquanto o zero-day exige defesas adicionais em camadas. ## Como reduzir o impacto de um zero-day na emissão fiscal? Como não é possível corrigir o que ainda não se conhece, a estratégia é limitar o que um atacante consegue fazer. Boas práticas incluem guardar certificados e senhas em um cofre de segredos ou HSM, nunca deixá-los em código-fonte, dar a cada sistema apenas as permissões necessárias e separar ambiente de homologação e de produção. Também ajudam: validar a origem de webhooks com HMAC, trocar periodicamente chaves de API, monitorar emissões fora do padrão (horários, volumes ou valores incomuns) e manter registros de quem fez cada ação. Usar uma infraestrutura de emissão especializada, que concentra certificados e comunicação com o fisco, reduz a quantidade de pontos expostos no sistema da empresa. ## O que fazer quando um zero-day é descoberto ou divulgado? O primeiro passo é verificar se algum componente usado pela empresa é afetado. Em seguida, aplicar medidas temporárias recomendadas pelo fornecedor, como desativar um recurso ou bloquear certos acessos, até a correção sair. Se houver suspeita de que o certificado digital foi exposto, a recomendação é revogá-lo junto à Autoridade Certificadora e emitir um novo, além de trocar chaves de API e senhas. Vale ainda revisar as notas emitidas no período para identificar documentos indevidos e, se necessário, cancelá-los dentro dos prazos permitidos. ## Exemplos de Zero-day em sistemas de emissão fiscal - Uma biblioteca de código aberto usada por um ERP para assinar XML de NF-e tem uma falha divulgada sem correção disponível; a equipe isola o servidor e restringe acessos até a nova versão ser publicada. - Um atacante explora uma brecha desconhecida no painel de um software de gestão e copia o arquivo PFX e a senha do certificado A1 de várias empresas clientes. - Um marketplace percebe, pelo monitoramento, uma sequência de NFC-e emitidas de madrugada com valores atípicos e descobre que um zero-day permitia chamar a API de emissão sem autenticação válida. - Após o anúncio de uma falha crítica em um servidor web, uma software house revisa seus logs, troca todas as API Keys de emissão fiscal e reforça as permissões dos agentes conectados via MCP. ## Perguntas frequentes ### Antivírus protege contra zero-day? Só parcialmente. Antivírus baseados em assinaturas reconhecem ameaças já conhecidas, então podem não detectar um zero-day. Ferramentas que analisam comportamento suspeito ajudam, mas a proteção real vem da combinação de permissões mínimas, segredos bem guardados e monitoramento. ### Se meu certificado A1 vazar, o que acontece? Quem tiver o arquivo e a senha pode assinar documentos fiscais em nome da empresa. O certificado deve ser revogado imediatamente na Autoridade Certificadora, substituído por um novo, e as emissões recentes devem ser revisadas. ### Ambiente de homologação também precisa de proteção? Sim. Embora as notas de homologação não tenham valor fiscal, o ambiente pode conter certificados reais, chaves de API e dados de clientes. Uma brecha ali pode servir de porta de entrada para a produção. ### Terceirizar a emissão elimina o risco de zero-day? Não elimina, mas reduz a superfície de ataque no sistema da empresa, já que certificados e comunicação com o fisco ficam concentrados em uma infraestrutura dedicada. Ainda é preciso proteger as credenciais de acesso à API. ## Termos relacionados - [Certificado digital A1](https://conota.dev/glossario/certificado-digital-a1.md) - [Gerenciamento de segredos](https://conota.dev/glossario/gerenciamento-de-segredos.md) - [API Key](https://conota.dev/glossario/api-key.md) - [HSM](https://conota.dev/glossario/hsm.md) - [HMAC em webhooks](https://conota.dev/glossario/hmac-em-webhooks.md) - [Biblioteca de emissão fiscal](https://conota.dev/glossario/biblioteca-de-emissao-fiscal.md) --- Fonte: [Zero-day em sistemas de emissão fiscal](https://conota.dev/glossario/zero-day-em-sistemas-de-emissao-fiscal/) · Atualizado em 2026-10-22 --- # Zero-padding de códigos fiscais > Zero-padding de códigos fiscais é o preenchimento com zeros à esquerda de códigos numéricos, como CNPJ, CEP, CST, NCM e código de município, para que tenham o número exato de dígitos exigido pelo leiaute oficial. Sem esses zeros, o documento pode ser rejeitado por erro de validação ou gerar dados incorretos. **Também conhecido como:** Preenchimento com zeros à esquerda, Zeros à esquerda, Zero padding, Padding de zeros, Zero-padding (leading zeros) **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** Z ## O que é zero-padding de códigos fiscais? Zero-padding significa completar um código com zeros à esquerda até que ele atinja um tamanho fixo. Por exemplo, um CST de valor zero deve ser enviado como "00", e não apenas "0". Um CEP como 01310-100 precisa manter o zero inicial e ser informado como "01310100". Nos documentos fiscais eletrônicos, muitos campos são tratados como texto com quantidade fixa de dígitos, mesmo parecendo números. O zero à esquerda faz parte do código e não pode ser descartado. ## Por que os zeros à esquerda desaparecem? O problema mais comum é tratar um código como número em vez de texto. Quando um sistema guarda o CNPJ ou o CEP em um campo numérico do banco de dados, em uma planilha ou em uma variável do tipo número, os zeros iniciais são eliminados automaticamente, porque matematicamente 00123 e 123 têm o mesmo valor. Isso também acontece ao converter dados para JSON: um CNPJ enviado como número, e não como string entre aspas, perde os zeros iniciais. Planilhas importadas e exportações de ERPs antigos são outras fontes frequentes desse erro. ## Quais códigos fiscais costumam exigir zero-padding? Entre os campos que normalmente exigem tamanho fixo estão o CNPJ (14 dígitos), o CPF (11 dígitos), o CEP (8 dígitos), o código de município do IBGE (7 dígitos), o NCM (8 dígitos), o CEST (7 dígitos), o CST do ICMS (2 dígitos) e o CSOSN (3 dígitos). Na chave de acesso da NF-e, que tem 44 dígitos, a série e o número da nota também aparecem completados com zeros para ocupar suas posições fixas. As regras exatas de cada campo estão no esquema XML e nos manuais oficiais de cada documento. ## Todo código numérico deve receber zeros à esquerda? Não. Alguns campos proíbem zeros à esquerda. Na NF-e, por exemplo, o número e a série da nota são informados nos seus próprios campos sem zeros iniciais, embora apareçam preenchidos com zeros dentro da chave de acesso. Por isso, a regra correta não é preencher tudo com zeros, e sim respeitar o formato definido para cada campo no leiaute oficial. Aplicar zero-padding onde não é permitido também causa rejeição. ## Como evitar erros de zero-padding na integração fiscal? A prática mais segura é armazenar e transmitir códigos fiscais sempre como texto (string), nunca como número. Antes do envio, o sistema pode validar o tamanho de cada campo e completar com zeros apenas quando o formato oficial exigir. Em integrações por API, vale testar no ambiente de homologação casos com zeros iniciais, como CNPJs e CEPs que começam com zero, e usar validações baseadas em JSON Schema ou no esquema XML para detectar o problema antes da emissão em produção. ## Exemplos de Zero-padding de códigos fiscais - Um ERP armazena o CEP de um cliente de São Paulo como número e envia 1310100 em vez de 01310100. A nota é rejeitada porque o CEP deve ter 8 dígitos. - Uma plataforma de vendas envia o CST do ICMS como 0 no JSON da API fiscal. O sistema converte para "00" ou retorna erro de validação, dependendo de como a integração trata o campo. - Um marketplace importa produtos de uma planilha e o NCM 01012100 vira 1012100, ficando com 7 dígitos e gerando rejeição na emissão da NF-e. - Ao montar a chave de acesso da NF-e, o número da nota 1234 é representado como 000001234 para ocupar as 9 posições reservadas a ele. ## Perguntas frequentes ### Zero-padding é a mesma coisa que formatar com pontos e traços? Não. Zero-padding apenas completa o código com zeros à esquerda até o tamanho exigido. Formatação com pontos, barras e traços, como em 00.000.000/0001-00, é outra coisa e geralmente não deve ser enviada nos campos do XML fiscal, que esperam somente dígitos. ### Por que um CNPJ começando com zero causa erro? Porque, se for tratado como número, os zeros iniciais são descartados e o CNPJ fica com menos de 14 dígitos. O validador do documento identifica o tamanho incorreto ou o dígito verificador inválido e rejeita a emissão. ### Devo enviar códigos fiscais como número ou texto na API? Como texto. Enviar CNPJ, CEP, NCM, CST e códigos semelhantes como string entre aspas preserva os zeros à esquerda e evita perdas durante conversões de dados entre sistemas. ## Termos relacionados - [Erro de validação fiscal](https://conota.dev/glossario/erro-de-validacao-fiscal.md) - [Esquema XML](https://conota.dev/glossario/esquema-xml.md) - [JSON Schema](https://conota.dev/glossario/json-schema.md) - [CST](https://conota.dev/glossario/cst.md) - [Chave de acesso da NF-e](https://conota.dev/glossario/chave-de-acesso-da-nf-e.md) --- Fonte: [Zero-padding de códigos fiscais](https://conota.dev/glossario/zero-padding-de-codigos-fiscais/) · Atualizado em 2026-10-22 --- # Zero-rating na tributação internacional > Zero-rating na tributação internacional é o tratamento em que uma operação, geralmente uma exportação, continua dentro do campo do imposto sobre consumo, mas com alíquota zero. Assim, o vendedor não cobra o tributo do comprador estrangeiro e, ao mesmo tempo, mantém o direito de recuperar os créditos dos impostos pagos nas etapas anteriores. **Também conhecido como:** Tributação à alíquota zero, Alíquota zero com manutenção de créditos, Desoneração das exportações, Zero-rating **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** Z ## O que significa zero-rating, em palavras simples? Zero-rating é uma expressão em inglês que pode ser traduzida como tributação à alíquota zero. Ela vem dos sistemas de imposto sobre valor agregado, conhecidos lá fora como VAT ou GST, que são impostos cobrados em cada etapa da cadeia de consumo. Na prática, a venda é considerada tributável, mas o percentual aplicado é 0%. O ponto central é que, por continuar sendo uma operação tributável, a empresa não perde os créditos dos impostos que pagou ao comprar insumos, matérias-primas e serviços usados para produzir o que vendeu. ## Para que serve o zero-rating nas exportações? O objetivo principal é evitar que impostos sobre consumo sejam exportados junto com o produto. Pela lógica do chamado princípio do destino, o imposto sobre consumo deve ser cobrado no país onde o bem ou serviço é consumido, e não onde foi produzido. Se o país de origem cobrasse o imposto na exportação e o país de destino também cobrasse na importação, o mesmo consumo seria tributado duas vezes. Com o zero-rating, a mercadoria sai do país de origem sem carga tributária embutida e é tributada apenas no destino, o que deixa o produto exportado mais competitivo. ## Qual a diferença entre zero-rating e isenção? Nas duas situações o cliente não paga imposto na venda. A diferença está nos créditos. No zero-rating, a empresa vendedora mantém o direito de aproveitar ou receber de volta os impostos pagos nas compras. Na isenção comum, em geral, esses créditos precisam ser estornados ou nem chegam a ser aproveitados. Por isso, a isenção sem manutenção de créditos pode deixar um custo tributário escondido no preço, enquanto o zero-rating desonera a operação por completo. Para quem exporta, essa diferença costuma ter impacto relevante no custo final. ## Como o zero-rating aparece no sistema tributário brasileiro? O Brasil não usa exatamente o rótulo zero-rating, mas aplica a mesma ideia de formas diferentes. Exportações de mercadorias contam com imunidade de ICMS e IPI prevista na Constituição, com manutenção dos créditos das etapas anteriores, e PIS e COFINS também não incidem sobre receitas de exportação, com possibilidade de aproveitamento de créditos conforme as regras de cada regime. Com a reforma tributária do consumo, IBS e CBS seguem a lógica de um IVA moderno e preveem a desoneração das exportações com manutenção e aproveitamento dos créditos, aproximando ainda mais o Brasil do modelo internacional de zero-rating. Os detalhes de ressarcimento e prazos dependem da regulamentação aplicável. ## Como isso aparece na emissão de nota fiscal? Na NF-e de exportação, o tratamento de desoneração é informado por meio de códigos específicos: o CFOP de operações com o exterior começa com o dígito 7, os campos de CST ou CSOSN indicam que não há tributação na saída e o grupo de informações de exportação traz dados como o local de embarque. Para sistemas que emitem notas por API, isso significa preencher corretamente esses campos e o destinatário estrangeiro. Erros de enquadramento podem gerar rejeição da SEFAZ ou, pior, uma nota autorizada com tributação indevida, que depois exige correção e pode comprometer o aproveitamento dos créditos. ## Exemplos de Zero-rating na tributação internacional - Uma indústria de calçados vende um lote para um importador europeu. A NF-e é emitida com CFOP de exportação e sem destaque de ICMS e IPI, e a empresa mantém os créditos de ICMS das compras de couro e insumos. - Uma empresa brasileira de software presta serviço a um cliente no exterior. Atendidas as condições legais de exportação de serviço, a nota não traz ISSQN, PIS e COFINS, seguindo a lógica de tributar o consumo apenas no país do cliente. - Um ERP integrado a uma API fiscal identifica que o destinatário está fora do país e preenche automaticamente o grupo de exportação, o CFOP iniciado por 7 e o enquadramento tributário de não incidência. - Um exportador que acumula créditos de ICMS por vender quase tudo ao exterior solicita ao estado a transferência ou o uso desses créditos, consequência direta da desoneração com manutenção de créditos. ## Perguntas frequentes ### Zero-rating é a mesma coisa que alíquota zero? Na essência, sim: a operação é tributável, mas com percentual de 0%. O termo zero-rating, porém, costuma enfatizar a manutenção dos créditos das etapas anteriores, característica que nem toda alíquota zero no Brasil garante automaticamente. ### Quem se beneficia do zero-rating? Principalmente exportadores de bens e serviços, que vendem sem embutir impostos de consumo no preço e recuperam os tributos pagos nas compras. Indiretamente, também o comprador estrangeiro, que recebe um produto mais barato. ### O zero-rating vale para qualquer venda ao exterior? Não necessariamente. É preciso cumprir requisitos legais, como comprovar a efetiva saída da mercadoria ou, no caso de serviços, que o resultado ocorre no exterior. Sem essa comprovação, a operação pode ser tributada normalmente. ### Exportação indireta também tem esse tratamento? Pode ter. Vendas a empresas comerciais exportadoras com fim específico de exportação costumam receber desoneração semelhante, desde que cumpridas as condições legais e de comprovação da exportação posterior. ## Termos relacionados - [Isenção tributária](https://conota.dev/glossario/isencao-tributaria.md) - [Imunidade tributária](https://conota.dev/glossario/imunidade-tributaria.md) - [Aproveitamento de crédito tributário](https://conota.dev/glossario/aproveitamento-de-credito-tributario.md) - [Exportação indireta](https://conota.dev/glossario/exportacao-indireta.md) - [Grupo de informações de exportação da NF-e](https://conota.dev/glossario/grupo-de-informacoes-de-exportacao-da-nf-e.md) - [IBS](https://conota.dev/glossario/ibs.md) --- Fonte: [Zero-rating na tributação internacional](https://conota.dev/glossario/zero-rating-na-tributacao-internacional/) · Atualizado em 2026-10-22 --- # Zero-touch provisioning de infraestrutura > Zero-touch provisioning de infraestrutura é a prática de configurar servidores, dispositivos, ambientes ou contas de forma totalmente automática, sem intervenção manual. Uma solicitação, um arquivo de configuração ou uma chamada de API dispara todo o processo, que entrega o recurso pronto para uso, de modo padronizado, rápido e com menos risco de erro humano. **Também conhecido como:** Provisionamento zero-touch, Provisionamento sem toque, Provisionamento automático, Provisionamento zero toque, ZTP, Zero-touch provisioning **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** Z ## O que significa zero-touch provisioning? A expressão vem do inglês e pode ser traduzida como provisionamento sem toque. Provisionar é preparar um recurso para funcionar: criar um servidor, instalar programas, aplicar configurações, liberar acessos. No modelo zero-touch, ninguém precisa entrar em uma tela ou executar passos à mão. Tudo acontece a partir de regras definidas previamente. O conceito surgiu com força em redes e equipamentos, quando roteadores e switches passaram a buscar a própria configuração assim que eram ligados. Hoje ele se aplica também a servidores em nuvem, contêineres, contas de usuários e integrações entre sistemas. ## Como funciona o zero-touch provisioning? O processo parte de um modelo, também chamado de template, que descreve como o recurso deve ficar. Quando surge a necessidade de um novo recurso, um gatilho automático aciona esse modelo. O gatilho pode ser um evento no sistema, uma chamada de API ou a conexão de um equipamento à rede. Em seguida, ferramentas de automação criam o recurso, aplicam as configurações, instalam credenciais de forma segura e fazem verificações de funcionamento, como um healthcheck. Se algo falhar, o sistema registra o erro e pode tentar de novo ou avisar a equipe responsável. ## Para que serve o zero-touch provisioning na emissão fiscal? Em empresas que emitem documentos fiscais por API, o conceito aparece principalmente no cadastro de novas empresas emissoras. Um ERP ou marketplace que atende muitos clientes não pode depender de alguém configurando cada CNPJ manualmente. Com provisionamento automático, o próprio sistema cadastra a empresa, envia o certificado digital, informa inscrição estadual ou municipal e define as configurações de emissão por chamadas de API. Assim, quando um novo cliente entra na plataforma, ele pode começar a emitir NF-e, NFC-e ou NFS-e em pouco tempo, desde que os dados e as habilitações junto ao fisco estejam corretos. A automação reduz erros de digitação, padroniza configurações e facilita escalar para centenas ou milhares de CNPJs. ## Quais cuidados o zero-touch provisioning exige? Automatizar não dispensa segurança. Certificados digitais, senhas e chaves de API precisam ser tratados com gerenciamento de segredos, trafegar apenas por HTTPS e ficar armazenados de forma protegida. Permissões devem ser mínimas: cada sistema só deve conseguir fazer o que realmente precisa. Também é importante testar o fluxo no ambiente de homologação antes de usar em produção, manter registros de cada ação para auditoria e garantir idempotência, ou seja, que uma mesma solicitação repetida não crie recursos duplicados. ## Qual a diferença entre zero-touch provisioning e provisionamento manual? No provisionamento manual, uma pessoa executa cada etapa, o que costuma ser lento, sujeito a esquecimentos e difícil de repetir de forma idêntica. No zero-touch, as etapas estão codificadas e acontecem sempre da mesma maneira. O manual pode ser suficiente para poucos casos; o automático se torna necessário quando o volume cresce ou quando a padronização é crítica. ## Exemplos de Zero-touch provisioning de infraestrutura - Um ERP, ao concluir a contratação de um novo cliente, chama a API fiscal para cadastrar o CNPJ, enviar o certificado A1 e configurar a série da NF-e, sem que a equipe de suporte precise intervir. - Uma plataforma de vendas cria automaticamente um ambiente de homologação para cada lojista novo, permitindo testes de emissão de NFC-e antes da liberação em produção. - Uma empresa de software sobe servidores em nuvem a partir de um template sempre que a fila de emissão fiscal ultrapassa determinado volume. - Um agente de inteligência artificial, com permissões controladas via MCP, verifica se a configuração de uma empresa emissora foi concluída e registra o resultado para auditoria. ## Perguntas frequentes ### Zero-touch provisioning elimina totalmente o trabalho humano? Não. Pessoas continuam definindo modelos, regras, permissões e tratando exceções. O que desaparece é a execução manual repetitiva de cada etapa do provisionamento. ### É possível cadastrar empresas emissoras de forma automática? Sim, quando o emissor fiscal oferece API para isso. O sistema envia dados cadastrais, certificado e configurações. Porém, habilitações junto à SEFAZ ou à prefeitura continuam sendo requisitos que dependem do fisco. ### Zero-touch provisioning é seguro? Pode ser mais seguro que o manual, pois evita erros e exposição de credenciais, desde que use gerenciamento de segredos, conexões criptografadas, permissões mínimas e registro de auditoria. ## Termos relacionados - [Gestão de empresas emissoras](https://conota.dev/glossario/gestao-de-empresas-emissoras.md) - [Habilitação para emissão fiscal](https://conota.dev/glossario/habilitacao-para-emissao-fiscal.md) - [Gerenciamento de segredos](https://conota.dev/glossario/gerenciamento-de-segredos.md) - [Certificado digital A1](https://conota.dev/glossario/certificado-digital-a1.md) - [Ambiente de homologação](https://conota.dev/glossario/ambiente-de-homologacao.md) - [Idempotência na emissão fiscal](https://conota.dev/glossario/idempotencia-na-emissao-fiscal.md) --- Fonte: [Zero-touch provisioning de infraestrutura](https://conota.dev/glossario/zero-touch-provisioning-de-infraestrutura/) · Atualizado em 2026-10-22 --- # Zeroização de chaves criptográficas > Zeroização de chaves criptográficas é o processo de apagar de forma definitiva e irrecuperável uma chave secreta ou privada, sobrescrevendo os locais de memória ou armazenamento onde ela estava. Serve para impedir que a chave seja reaproveitada por terceiros quando deixa de ser necessária, quando um equipamento é descartado ou diante de suspeita de violação. **Também conhecido como:** Zeroização, Zerização de chaves, Apagamento seguro de chaves, Destruição de chaves criptográficas, Cryptographic key zeroization **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** Z ## O que significa zeroizar uma chave criptográfica? Zeroizar é destruir uma chave de modo que ela não possa ser recuperada. O nome vem da técnica clássica de sobrescrever com zeros os bytes que guardavam a chave, mas o termo vale para qualquer método que elimine o conteúdo original, como gravar dados aleatórios por cima ou destruir fisicamente o componente. Isso é diferente de simplesmente excluir um arquivo. Quando um sistema apaga um arquivo do jeito comum, normalmente só remove a referência a ele, e os dados continuam no disco ou na memória até serem substituídos. Com ferramentas adequadas, alguém poderia recuperar essa chave. A zeroização existe justamente para fechar essa brecha. ## Por que a zeroização é importante para certificados digitais e emissão fiscal? Na emissão de documentos fiscais eletrônicos, como NF-e, NFC-e, CT-e e MDF-e, o XML precisa ser assinado com a chave privada do certificado digital da empresa, geralmente um e-CNPJ do tipo A1. Quem tem acesso a essa chave consegue assinar documentos em nome da empresa. Por isso, toda cópia da chave privada que não for mais necessária representa um risco. Uma cópia esquecida em um servidor antigo, em um backup descartado ou na memória de um processo pode ser usada indevidamente. A zeroização garante que essas cópias deixem de existir de verdade, reduzindo a chance de fraude e de uso não autorizado do certificado. ## Como funciona a zeroização na prática? Em software, a zeroização acontece principalmente na memória. Depois de usar a chave para assinar um XML, o sistema sobrescreve as variáveis e áreas temporárias que guardaram a chave ou a senha do arquivo PFX, em vez de esperar que a memória seja liberada sozinha. Em armazenamento, como discos e bancos de dados, envolve apagar a chave de forma segura e também tratar cópias em backups e logs. Uma prática comum é guardar a chave cifrada e, na hora de descartá-la, destruir a chave que a protege, tornando o conteúdo cifrado inútil. Em equipamentos dedicados, como um HSM, a zeroização pode ser acionada por comando de um administrador ou automaticamente, quando o dispositivo detecta tentativa de violação física, por exemplo abertura do gabinete. Nesse caso, as chaves internas são apagadas antes que possam ser extraídas. ## Quando a zeroização deve ser feita? As situações mais comuns são: substituição de um certificado vencido ou renovado, encerramento do relacionamento com um cliente ou de uma empresa emissora, desativação ou descarte de servidores e discos, e suspeita de que a chave foi exposta. Também é recomendada de forma rotineira em sistemas que manipulam chaves: toda vez que uma chave é carregada temporariamente na memória para assinar um documento, o ideal é que ela seja apagada assim que a operação termina. ## Qual a diferença entre zeroização e revogação do certificado? A revogação é feita junto à Autoridade Certificadora e informa publicamente que o certificado não deve mais ser considerado válido. Ela atua sobre a confiança no certificado em todo o ecossistema. A zeroização atua sobre as cópias da chave que estão sob controle de quem a guarda. As duas medidas são complementares: em caso de vazamento, revoga-se o certificado para invalidá-lo e zeroizam-se as cópias restantes para que ninguém mais tenha acesso ao material sensível. ## Exemplos de Zeroização de chaves criptográficas - Uma empresa renova seu certificado A1 e envia o novo arquivo PFX à plataforma de emissão fiscal; a plataforma passa a usar o novo certificado e zeroiza a chave privada antiga armazenada em seus sistemas. - O código de um serviço de assinatura de XML sobrescreve o buffer que continha a chave privada e a senha do certificado logo após assinar cada NF-e, evitando que esses dados fiquem expostos em memória. - Uma equipe de infraestrutura desativa um servidor que guardava certificados de clientes e executa a zeroização dos discos e das chaves de criptografia antes de devolver o equipamento. - Um HSM detecta a abertura indevida do seu gabinete e apaga automaticamente todas as chaves internas, impedindo que sejam extraídas. ## Perguntas frequentes ### Excluir o arquivo PFX do computador já é zeroização? Não necessariamente. A exclusão comum pode deixar os dados recuperáveis no disco. A zeroização exige sobrescrever o conteúdo ou destruir a chave que o protege, e também eliminar cópias em backups, pastas temporárias e anexos de e-mail. ### Depois de zeroizada, a chave pode ser recuperada? Não. Esse é o objetivo. Por isso, antes de zeroizar, é preciso ter certeza de que a chave não será mais necessária ou de que existe um novo certificado em uso para continuar assinando documentos fiscais. ### Zeroizar a chave substitui a revogação do certificado? Não. Se houver suspeita de vazamento, o certificado deve ser revogado junto à Autoridade Certificadora, porque uma cópia pode já estar com terceiros. A zeroização elimina apenas as cópias que você controla. ### Quem deve fazer a zeroização em uma integração fiscal? Cada parte que guarda uma cópia da chave: o sistema do cliente, a plataforma de emissão e provedores de armazenamento. Cada um deve apagar com segurança as cópias sob sua responsabilidade quando deixarem de ser necessárias. ## Termos relacionados - [HSM](https://conota.dev/glossario/hsm.md) - [Gerenciamento de segredos](https://conota.dev/glossario/gerenciamento-de-segredos.md) - [Geração de chave criptográfica](https://conota.dev/glossario/geracao-de-chave-criptografica.md) - [Certificado digital A1](https://conota.dev/glossario/certificado-digital-a1.md) - [Arquivo PFX](https://conota.dev/glossario/arquivo-pfx.md) - [Backup de certificado A1](https://conota.dev/glossario/backup-de-certificado-a1.md) --- Fonte: [Zeroização de chaves criptográficas](https://conota.dev/glossario/zeroizacao-de-chaves-criptograficas/) · Atualizado em 2026-10-22 --- # ZIP de documentos fiscais > ZIP de documentos fiscais é um arquivo compactado no formato ZIP que reúne vários documentos fiscais eletrônicos, como XMLs de NF-e, NFS-e, NFC-e, CT-e e MDF-e e seus PDFs (DANFE, DACTE etc.), em um único pacote. É usado para baixar, enviar ao contador ou arquivar grandes volumes de notas de uma só vez. **Também conhecido como:** Arquivo ZIP de XMLs, Pacote de XMLs fiscais, Exportação em lote de XML, ZIP de notas fiscais, Arquivo compactado de notas fiscais, ZIP archive of tax documents **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** Z ## O que vai dentro de um ZIP de documentos fiscais? Normalmente o ZIP contém os arquivos XML dos documentos autorizados, que são a versão oficial e com valor jurídico de cada nota. Também pode incluir os PDFs de representação visual, como DANFE, DANFCE, DACTE e DAMDFE, que facilitam a leitura por pessoas. Dependendo de como foi gerado, o pacote pode trazer ainda XMLs de eventos, como cancelamentos, cartas de correção e encerramentos de MDF-e, além de documentos de diferentes empresas, séries ou tipos. Muitas vezes os arquivos são organizados em pastas por CNPJ, mês ou modelo de documento e nomeados pela chave de acesso. ## Para que serve o ZIP de documentos fiscais? O uso mais comum é o envio mensal das notas para a contabilidade. Em vez de baixar centenas ou milhares de arquivos um por um, a empresa gera um único pacote com todos os XMLs do período e entrega ao contador para a escrituração fiscal. Ele também serve para backup e guarda de documentos fiscais, migração entre sistemas, atendimento a auditorias e fiscalizações, e para importar notas em outro software. Como o arquivo é compactado, ocupa menos espaço e é mais fácil de transferir por e-mail, link ou armazenamento em nuvem. ## Como funciona a geração de um ZIP em uma API fiscal? Em plataformas de emissão por API, o sistema do cliente costuma informar filtros, como período, CNPJ emitente, tipo de documento e status (autorizadas, canceladas etc.). Com base nesses critérios, a plataforma separa os arquivos correspondentes e monta o pacote. Como a montagem de um ZIP grande pode levar tempo, é comum que o processo seja assíncrono: a requisição é aceita, o arquivo é gerado em segundo plano e, ao final, o sistema recebe um link para download, seja consultando o status periodicamente (polling) ou recebendo um aviso por webhook. Isso evita timeouts em exportações volumosas. ## Qual a diferença entre ZIP e GZip na distribuição de DF-e? Os dois são formatos de compactação, mas com propósitos diferentes. O ZIP é um contêiner que agrupa vários arquivos em um só, pensado para exportação, download e arquivamento feitos pela empresa ou pela plataforma de emissão. Já o GZip aparece em serviços oficiais de distribuição de DF-e, nos quais cada documento retornado vem compactado e codificado dentro da resposta. Nesse caso, a compactação é parte do protocolo de comunicação, e o sistema precisa descompactar cada item para obter o XML original. ## Quais cuidados tomar ao gerar ou receber um ZIP de documentos fiscais? O ZIP em si não tem valor fiscal: o que vale é cada XML dentro dele. Por isso, os arquivos não devem ser editados após a extração, pois qualquer alteração invalida a assinatura digital do XML. Vale conferir se o pacote contém todos os documentos esperados, incluindo eventos de cancelamento, para que o contador não escriture uma nota que já foi cancelada. Também é importante proteger o arquivo, já que ele reúne dados de clientes e valores de vendas, e manter os XMLs originais guardados pelo prazo exigido pela legislação. ## Exemplos de ZIP de documentos fiscais - Um ERP gera, no início de cada mês, um ZIP com todos os XMLs de NF-e e NFS-e autorizados no mês anterior e envia o link automaticamente para o escritório de contabilidade. - Um marketplace que emite notas para vários lojistas exporta um ZIP separado por CNPJ, com pastas internas para notas autorizadas e canceladas, para que cada vendedor repasse ao seu contador. - Uma transportadora solicita via API um ZIP com os XMLs de CT-e e MDF-e de um trimestre para atender a uma auditoria interna, recebendo o aviso de conclusão por webhook. - Uma empresa que está trocando de software de gestão baixa um ZIP com todo o histórico de XMLs para importá-los no novo sistema. ## Perguntas frequentes ### O ZIP de documentos fiscais tem validade jurídica? Não. O ZIP é apenas uma forma de agrupar e compactar arquivos. A validade está em cada XML autorizado contido nele, que deve permanecer íntegro e sem alterações para preservar a assinatura digital. ### O contador precisa do XML ou basta o PDF dentro do ZIP? Para a escrituração, o contador geralmente precisa dos XMLs, que trazem todos os dados estruturados e são o documento oficial. O PDF, como o DANFE, é só uma representação visual e não substitui o XML. ### O ZIP deve incluir notas canceladas? Depende da finalidade. Para a contabilidade, é recomendável incluir os XMLs de cancelamento ou separar claramente as notas canceladas, evitando que sejam contabilizadas como vendas válidas. ### Por que a geração do ZIP às vezes demora? Pacotes com muitos documentos exigem buscar, organizar e compactar grande volume de arquivos. Por isso, muitas APIs processam a exportação de forma assíncrona e avisam quando o arquivo está pronto para download. ## Termos relacionados - [Download de XML fiscal](https://conota.dev/glossario/download-de-xml-fiscal.md) - [Arquivo XML fiscal](https://conota.dev/glossario/arquivo-xml-fiscal.md) - [Guarda de documentos fiscais](https://conota.dev/glossario/guarda-de-documentos-fiscais.md) - [GZip na distribuição de DF-e](https://conota.dev/glossario/gzip-na-distribuicao-de-df-e.md) - [Filtro de documentos fiscais](https://conota.dev/glossario/filtro-de-documentos-fiscais.md) - [Escrituração fiscal](https://conota.dev/glossario/escrituracao-fiscal.md) --- Fonte: [ZIP de documentos fiscais](https://conota.dev/glossario/zip-de-documentos-fiscais/) · Atualizado em 2026-10-22 --- # ZIP de XML e DANFE > ZIP de XML e DANFE é um arquivo compactado que reúne, em um único download, os arquivos XML de notas fiscais eletrônicas e os respectivos DANFEs em PDF. É usado para enviar documentos de um período ao contador, fazer backup, atender auditorias ou transferir notas entre sistemas sem baixar arquivo por arquivo. **Também conhecido como:** Pacote de XML e DANFE, ZIP de notas fiscais, Arquivo compactado de XML e PDF, Exportação em lote de XML e DANFE **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** Z ## O que é um ZIP de XML e DANFE? É um pacote compactado no formato ZIP que contém vários documentos fiscais de uma vez. Dentro dele costumam estar dois tipos de arquivo: o XML, que é a nota fiscal eletrônica propriamente dita, e o DANFE em PDF, que é a versão impressa e legível dessa nota. O formato ZIP reduz o tamanho total dos arquivos e junta tudo em um só item. Em vez de baixar centenas de notas uma a uma, a pessoa baixa um único arquivo e, ao descompactá-lo, encontra todos os documentos do período ou do filtro escolhido. Apesar do nome citar o DANFE, que é específico da NF-e, o mesmo conceito vale para outros documentos: um pacote pode trazer XMLs de NFC-e com seus DANFCEs, de CT-e com seus DACTEs ou de MDF-e com seus DAMDFEs. ## Para que serve o ZIP de XML e DANFE? O uso mais comum é o envio mensal de notas ao escritório de contabilidade, que precisa dos XMLs para fazer a escrituração fiscal e apurar os impostos. Mandar tudo em um único arquivo evita esquecimentos e economiza tempo. Ele também é útil para criar cópias de segurança, responder a pedidos de fiscalização ou auditoria interna, migrar documentos para outro ERP e compartilhar notas de uma filial ou de um cliente específico com quem precisar delas. ## Qual a diferença entre o XML e o DANFE dentro do ZIP? O XML é o documento fiscal com validade jurídica. Ele foi assinado digitalmente pelo emitente e autorizado pela SEFAZ, e é ele que sistemas contábeis e fiscais importam e leem automaticamente. O DANFE é apenas uma representação gráfica auxiliar, gerada a partir do XML para facilitar a leitura por pessoas, acompanhar a mercadoria e permitir a consulta pela chave de acesso. Ele não substitui o XML. Por isso, se o pacote tiver apenas PDFs, ele não serve para fins de guarda ou escrituração. ## Como o ZIP de XML e DANFE é gerado em uma integração por API? Em plataformas de emissão fiscal, o usuário ou o sistema integrado normalmente escolhe filtros, como período de emissão, CNPJ emitente, tipo de documento e status (autorizado, cancelado etc.). A plataforma então reúne os arquivos correspondentes e monta o pacote. Quando o volume é grande, a geração costuma ser feita de forma assíncrona: o sistema faz o pedido, a plataforma processa em segundo plano e depois disponibiliza um link de download ou avisa por webhook que o arquivo está pronto. Isso evita timeouts e não trava a integração. ## Quais cuidados tomar ao gerar e usar esse arquivo? Confira se o pacote inclui os eventos ligados às notas, como cancelamentos e cartas de correção, pois o contador precisa saber quais documentos deixaram de valer. Nomear cada arquivo pela chave de acesso também facilita a conferência e evita duplicidades. Lembre que o ZIP contém dados de clientes, valores e informações fiscais da empresa, então deve ser compartilhado por canais seguros e apenas com quem precisa. Além disso, enviar o ZIP ao contador não dispensa a empresa de guardar os XMLs originais pelo prazo exigido pela legislação. ## Exemplos de ZIP de XML e DANFE - Um ERP de varejo solicita, todo início de mês, o ZIP com os XMLs e DANFEs das NF-e autorizadas e canceladas do mês anterior e envia o link automaticamente ao escritório contábil. - Um marketplace que emite notas para vários lojistas gera um ZIP separado por CNPJ, para que cada vendedor receba apenas os seus próprios documentos. - Uma transportadora exporta em ZIP os XMLs de CT-e e MDF-e de um trimestre, junto com os DACTEs, para atender a uma auditoria interna. - Uma empresa que está trocando de sistema de gestão baixa o ZIP com todas as notas do ano para importá-las no novo ERP. ## Perguntas frequentes ### O DANFE em PDF substitui o XML no envio ao contador? Não. O documento com validade jurídica é o XML. O DANFE é só uma representação para leitura. O contador precisa dos XMLs para importar as notas no sistema contábil e fazer a escrituração. ### Notas canceladas devem ir no ZIP? Em geral, sim. Incluir as notas canceladas e o XML do evento de cancelamento permite que a contabilidade saiba quais documentos foram anulados e não os considere na apuração de impostos. ### Guardar apenas o ZIP é suficiente para cumprir a obrigação de guarda? Desde que o pacote contenha os XMLs originais, íntegros e sem alteração, ele pode servir como cópia. O importante é manter os XMLs autorizados acessíveis pelo prazo legal, com backups confiáveis. ### Por que o ZIP às vezes demora para ficar pronto? Com muitos documentos, a plataforma precisa buscar e compactar cada arquivo, e gerar PDFs que ainda não existiam. Por isso o processamento costuma ser assíncrono, com aviso quando o download estiver disponível. ## Termos relacionados - [Arquivo XML fiscal](https://conota.dev/glossario/arquivo-xml-fiscal.md) - [DANFE](https://conota.dev/glossario/danfe.md) - [Download de XML fiscal](https://conota.dev/glossario/download-de-xml-fiscal.md) - [Guarda de documentos fiscais](https://conota.dev/glossario/guarda-de-documentos-fiscais.md) - [Filtro de documentos fiscais](https://conota.dev/glossario/filtro-de-documentos-fiscais.md) - [Geração de DANFE](https://conota.dev/glossario/geracao-de-danfe.md) --- Fonte: [ZIP de XML e DANFE](https://conota.dev/glossario/zip-de-xml-e-danfe/) · Atualizado em 2026-10-22 --- # ZIP64 para arquivos fiscais > ZIP64 para arquivos fiscais é a extensão do formato ZIP que permite criar pacotes compactados com mais de 4 GB ou com mais de 65.535 arquivos. É usada quando uma empresa precisa exportar grandes volumes de XMLs e PDFs de documentos fiscais, como milhares de NF-e, NFC-e ou CT-e de um período, em um único arquivo. **Também conhecido como:** Zip64, ZIP 64, Formato ZIP64, Extensão ZIP64, ZIP64 **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** Z ## O que é ZIP64 e por que ele existe? O ZIP é o formato de compactação mais conhecido: ele junta vários arquivos em um só e reduz o espaço ocupado. Em sua versão original, porém, ele tem dois limites importantes. Cada arquivo e o pacote inteiro não podem passar de cerca de 4 GB, e o pacote não pode conter mais de 65.535 arquivos. O ZIP64 é uma extensão desse formato criada para superar esses limites. Ele amplia os campos internos que guardam tamanhos e quantidades, permitindo pacotes muito maiores e com muito mais arquivos. O arquivo continua com a extensão .zip, mas por dentro usa essa estrutura ampliada. ## Quando arquivos fiscais precisam de ZIP64? Cada documento fiscal costuma gerar pelo menos um arquivo XML e, muitas vezes, um PDF, como o DANFE ou o DANFCE. Uma rede de varejo que emite NFC-e em várias lojas pode facilmente ultrapassar 65.535 arquivos em um único mês. Somando XML e PDF, esse número dobra. Por isso, o ZIP64 aparece em situações como a exportação mensal de documentos para a contabilidade, o atendimento a uma fiscalização ou auditoria, a migração de dados entre sistemas e a cópia de segurança do acervo fiscal. Nesses casos, um ZIP comum pode falhar ou gerar um arquivo corrompido. ## Como o ZIP64 funciona na prática? Para quem usa, quase nada muda. As bibliotecas de programação e os programas de compactação mais atuais ativam o ZIP64 automaticamente quando o pacote ultrapassa os limites do ZIP tradicional, ou permitem que o desenvolvedor o habilite com uma opção. Em uma integração fiscal, o sistema geralmente busca os XMLs e PDFs, por exemplo por meio de um download de XML fiscal via API, e monta o pacote compactado. Se o volume for grande, o pacote é gerado no formato ZIP64. Os documentos dentro dele permanecem exatamente iguais aos originais. ## Qual a diferença entre ZIP64 e GZip na distribuição de DF-e? O GZip compacta um único conteúdo por vez. Ele é usado, por exemplo, na distribuição de DF-e, em que cada documento retornado vem compactado com GZip e codificado em Base64 dentro da resposta. O ZIP, e sua extensão ZIP64, servem para reunir muitos arquivos em um único pacote, mantendo nomes e organização em pastas. Em resumo: o GZip é comum no tráfego de documentos individuais entre sistemas, enquanto o ZIP64 é útil para empacotar grandes lotes para exportação ou arquivamento. ## Que cuidados tomar ao gerar ou abrir pacotes ZIP64 de documentos fiscais? O primeiro cuidado é a compatibilidade. Ferramentas antigas de descompactação podem não reconhecer ZIP64 e exibir erros ou abrir o pacote pela metade. Vale confirmar que quem vai receber o arquivo, como o escritório de contabilidade, usa um programa atualizado. Outro ponto é nunca alterar o conteúdo dos XMLs ao compactar. O XML fiscal tem assinatura digital, e qualquer mudança, até em espaços ou codificação, invalida o documento. Também é boa prática organizar o pacote por CNPJ, período e tipo de documento, e gerar um hash do arquivo final para conferir que ele chegou íntegro. Quando possível, dividir exportações muito grandes em pacotes menores, por mês ou por estabelecimento, facilita o envio, reduz o risco de falhas no download e simplifica a guarda de documentos fiscais. ## Exemplos de ZIP64 para arquivos fiscais - Uma rede de supermercados exporta todas as NFC-e do mês de 30 lojas, com XML e DANFCE, totalizando mais de 200 mil arquivos; o pacote precisa ser gerado em ZIP64. - Um ERP oferece ao cliente o botão 'Exportar XMLs do ano' e, como o volume passa de 4 GB, a biblioteca de compactação gera automaticamente um arquivo ZIP64. - Uma transportadora reúne os XMLs de CT-e e MDF-e de um ano para atender a uma auditoria e envia um único pacote ZIP64 acompanhado do hash para conferência. - Durante a migração de um sistema de gestão para outro, a equipe técnica empacota o acervo histórico de NF-e em ZIP64 para transferir os arquivos de uma só vez. ## Perguntas frequentes ### Um arquivo ZIP64 tem extensão diferente? Não. Ele continua usando a extensão .zip. A diferença está na estrutura interna, que suporta tamanhos e quantidades de arquivos maiores. Por isso, nem sempre é possível saber pelo nome se um pacote é ZIP64. ### Compactar o XML em ZIP64 invalida a nota fiscal? Não. A compactação não altera o conteúdo dos arquivos. Ao descompactar, o XML volta exatamente igual, com a assinatura digital válida. O problema só ocorre se alguém editar o XML antes ou depois de compactar. ### Preciso sempre usar ZIP64 para exportar notas fiscais? Não. Ele só é necessário quando o pacote passa de cerca de 4 GB ou de 65.535 arquivos. Para volumes menores, o ZIP comum funciona e tem compatibilidade ainda maior com ferramentas antigas. ### O que fazer se o pacote ZIP64 não abrir? Verifique se o programa de descompactação está atualizado e se o download foi concluído por completo, comparando o hash quando disponível. Se persistir, peça a exportação dividida em pacotes menores, por mês ou por CNPJ. ## Termos relacionados - [Download de XML fiscal](https://conota.dev/glossario/download-de-xml-fiscal.md) - [Arquivo XML fiscal](https://conota.dev/glossario/arquivo-xml-fiscal.md) - [GZip na distribuição de DF-e](https://conota.dev/glossario/gzip-na-distribuicao-de-df-e.md) - [Guarda de documentos fiscais](https://conota.dev/glossario/guarda-de-documentos-fiscais.md) - [Batch de documentos fiscais](https://conota.dev/glossario/batch-de-documentos-fiscais.md) - [Hash de documento fiscal](https://conota.dev/glossario/hash-de-documento-fiscal.md) --- Fonte: [ZIP64 para arquivos fiscais](https://conota.dev/glossario/zip64-para-arquivos-fiscais/) · Atualizado em 2026-10-22 --- # Zlib na compactação de dados > Zlib é uma biblioteca de software livre e um formato de dados usados para compactar e descompactar informações sem perda, com base no algoritmo DEFLATE. Ela reduz o tamanho de arquivos e mensagens, como XMLs fiscais, e está disponível na maioria das linguagens de programação, inclusive no tratamento de arquivos GZip. **Também conhecido como:** zlib, biblioteca zlib, formato zlib, compressão zlib, compactação zlib, zlib compression **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** Z ## O que é Zlib, em palavras simples? Zlib é uma ferramenta que diminui o tamanho de dados para que ocupem menos espaço ou trafeguem mais rápido pela internet. É como dobrar bem roupas para caberem numa mala menor: nada se perde, e ao desdobrar tudo volta exatamente como era. O nome Zlib se refere a duas coisas ao mesmo tempo: uma biblioteca de programação, usada por desenvolvedores, e um formato de dados compactados. A compactação é sem perda, ou seja, o arquivo descompactado é idêntico ao original, byte a byte. Isso é essencial para documentos fiscais, em que qualquer alteração invalidaria a assinatura digital. ## Como funciona a compactação com Zlib? A Zlib usa o algoritmo DEFLATE, que procura trechos repetidos no conteúdo e os substitui por referências curtas, além de representar os caracteres mais frequentes com menos bits. Arquivos XML, cheios de tags repetidas, costumam encolher bastante com essa técnica. No formato Zlib, os dados compactados recebem um pequeno cabeçalho no início e um código de verificação no final, chamado Adler-32. Esse código permite conferir, na descompactação, se o conteúdo chegou íntegro ou se foi corrompido no caminho. ## Qual a diferença entre Zlib e GZip? Zlib e GZip usam o mesmo algoritmo de compactação, o DEFLATE, mas embrulham os dados de formas diferentes. O GZip tem um cabeçalho maior, que pode guardar informações como nome do arquivo, e usa outro código de verificação, o CRC-32. Já o formato Zlib é mais enxuto. Na prática, a biblioteca Zlib consegue ler e gerar os dois formatos, desde que seja configurada corretamente. Um erro comum em integrações é tentar abrir um conteúdo GZip com a configuração padrão do formato Zlib, o que gera mensagens como cabeçalho incorreto. Existe ainda o DEFLATE puro, sem cabeçalho nenhum, que exige outra configuração. ## Onde a Zlib aparece na emissão de documentos fiscais? Na Distribuição de DF-e, os XMLs de documentos fiscais costumam ser devolvidos compactados em GZip e codificados em Base64. Para ler o conteúdo, o sistema decodifica o Base64 e depois descompacta o resultado, tarefa normalmente feita com a Zlib ou com funções construídas sobre ela. A compactação também é útil no envio de payloads grandes, no armazenamento de grandes volumes de XMLs para guarda fiscal e na transferência de dados por HTTP, em que servidores e clientes podem negociar respostas compactadas para reduzir o tráfego e a latência. ## Preciso usar Zlib ao integrar com uma API fiscal? Depende de como a API entrega os dados. Quando você se integra diretamente aos serviços dos órgãos autorizadores, lidar com conteúdo compactado é frequente e precisa ser tratado no seu código. Quando usa uma API fiscal intermediária, como o Conota, a camada de emissão costuma cuidar desses detalhes e devolver XML, PDF e status em formatos prontos para uso. Mesmo assim, entender a Zlib ajuda a diagnosticar problemas, como arquivos corrompidos, falhas de descompactação e confusão entre Base64, GZip e Zlib ao importar ou baixar XMLs fiscais. ## Exemplos de Zlib na compactação de dados - Um ERP consulta a Distribuição de DF-e, recebe o XML de uma NF-e compactado em GZip e codificado em Base64, decodifica o texto e usa a Zlib para descompactar e gravar o XML original. - Um desenvolvedor em Python recebe erro de cabeçalho incorreto ao descompactar um documento e resolve ajustando o parâmetro de janela da função da Zlib para aceitar o formato GZip. - Uma plataforma de vendas compacta lotes de XMLs fiscais antes de armazená-los, reduzindo o espaço ocupado na guarda de documentos sem alterar nenhum byte dos arquivos. - Em Node.js, uma integração usa o módulo nativo de compactação, baseado em Zlib, para descompactar respostas HTTP de uma API que envia conteúdo com codificação gzip. ## Perguntas frequentes ### A compactação com Zlib altera o XML fiscal? Não. A Zlib faz compactação sem perda. Após descompactar, o XML é idêntico ao original, incluindo a assinatura digital, que continua válida. ### Zlib e Base64 são a mesma coisa? Não. A Zlib reduz o tamanho dos dados. O Base64 transforma dados binários em texto, o que costuma até aumentar o tamanho. Em integrações fiscais, é comum usar os dois em sequência: compactar e depois codificar em Base64. ### Por que recebo erro de cabeçalho incorreto ao descompactar? Geralmente o conteúdo está em GZip ou DEFLATE puro, e o código está esperando o formato Zlib. Ajuste a configuração da função de descompactação para o formato correto. ### Preciso instalar a Zlib separadamente? Na maioria das vezes, não. Linguagens como Python, Java, PHP e JavaScript em Node.js já trazem funções de compactação baseadas em Zlib ou compatíveis com ela. ## Termos relacionados - [GZip na distribuição de DF-e](https://conota.dev/glossario/gzip-na-distribuicao-de-df-e.md) - [Distribuição de DF-e](https://conota.dev/glossario/distribuicao-de-df-e.md) - [Arquivo XML fiscal](https://conota.dev/glossario/arquivo-xml-fiscal.md) - [Download de XML fiscal](https://conota.dev/glossario/download-de-xml-fiscal.md) - [Payload de emissão fiscal](https://conota.dev/glossario/payload-de-emissao-fiscal.md) - [Guarda de documentos fiscais](https://conota.dev/glossario/guarda-de-documentos-fiscais.md) --- Fonte: [Zlib na compactação de dados](https://conota.dev/glossario/zlib-na-compactacao-de-dados/) · Atualizado em 2026-10-22 --- # Zona de disponibilidade da infraestrutura fiscal > Zona de disponibilidade da infraestrutura fiscal é um conjunto isolado de data centers, com energia, rede e refrigeração independentes, onde rodam os servidores de uma plataforma de emissão fiscal. Distribuir a API e os bancos de dados por várias zonas permite que a emissão de NF-e, NFS-e e outros documentos continue funcionando mesmo se uma delas falhar. **Também conhecido como:** Zona de disponibilidade, Availability zone, AZ, Availability Zone **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** Z ## O que é uma zona de disponibilidade, em termos simples? Imagine uma empresa que guarda tudo em um único prédio. Se faltar luz ali, tudo para. Uma zona de disponibilidade é como ter vários prédios separados na mesma cidade, cada um com sua própria energia, internet e refrigeração. Se um deles tiver problema, os outros continuam funcionando. O termo vem do mundo da computação em nuvem, em inglês availability zone, ou AZ. Quando se fala em infraestrutura fiscal, ele se refere aos locais físicos onde ficam os servidores que recebem pedidos de emissão, assinam o XML, conversam com a SEFAZ ou com a prefeitura e guardam os documentos autorizados. ## Para que serve uma zona de disponibilidade na emissão fiscal? Emitir nota fiscal é uma etapa obrigatória da venda. Se a plataforma de emissão sai do ar, o ERP, a loja virtual ou o marketplace não conseguem faturar, e a mercadoria pode ficar parada no estoque ou o caminhão sem documento para circular. Ao espalhar seus componentes por mais de uma zona, a infraestrutura reduz o risco de que uma falha localizada, como queda de energia, problema de rede ou defeito de hardware, interrompa a emissão. Isso aumenta a disponibilidade, ou seja, o tempo em que o serviço fica acessível para quem precisa dele. ## Como funciona a distribuição entre zonas? Normalmente, cópias da aplicação rodam ao mesmo tempo em zonas diferentes. Um balanceador de carga recebe as requisições e as direciona para as cópias que estão saudáveis, verificadas por meio de healthchecks periódicos. Se uma zona deixa de responder, o tráfego é desviado para as demais. Os dados também precisam estar protegidos: bancos de dados e filas de emissão costumam ser replicados entre zonas, para que um documento em processamento não se perca. Ferramentas de orquestração, como o Kubernetes, ajudam a recriar automaticamente serviços que caíram em uma zona em outra que esteja disponível. ## Zona de disponibilidade protege contra instabilidade da SEFAZ ou da prefeitura? Não. A zona de disponibilidade protege a infraestrutura da plataforma de emissão, não os sistemas do governo. Se o webservice da SEFAZ ou de uma prefeitura estiver fora do ar, a nota não será autorizada, não importa em quantas zonas a plataforma esteja. Para esses casos existem outros mecanismos, como a SVC e o EPEC na NF-e, além de filas que guardam o pedido e tentam novamente quando o órgão volta a responder. Uma infraestrutura resiliente combina as duas coisas: redundância própria e tratamento das falhas externas. ## Qual a diferença entre zona de disponibilidade e região? Uma região é uma área geográfica ampla, como uma cidade ou um país, onde o provedor de nuvem mantém seus data centers. Dentro de cada região existem várias zonas de disponibilidade, próximas o bastante para trocar dados rapidamente, mas separadas o suficiente para não falharem juntas. Usar várias zonas na mesma região protege contra falhas locais com baixa latência. Usar várias regiões protege contra eventos maiores, mas costuma ser mais complexo e caro de operar. ## O que o sistema integrador precisa fazer para aproveitar essa resiliência? Durante uma troca de zona, algumas requisições podem falhar ou demorar. Por isso, o sistema que consome a API fiscal deve ter retry com backoff exponencial, timeouts bem definidos e usar idempotência, para que uma nova tentativa não gere nota duplicada. Também é recomendável consultar o status do documento por webhook ou polling em vez de assumir que uma resposta perdida significa falha na emissão. ## Exemplos de Zona de disponibilidade da infraestrutura fiscal - Um ERP envia 500 NF-e por hora para uma API fiscal. Uma das zonas onde a API roda sofre queda de energia, e o balanceador passa a enviar as requisições para as outras zonas, sem que o ERP precise mudar nada. - Uma plataforma de e-commerce recebe um erro de timeout ao pedir a emissão de uma NFC-e durante uma troca de zona. Graças à chave de idempotência, o novo envio retorna o mesmo documento, sem duplicar a nota. - Uma transportadora emite CT-e e MDF-e de madrugada. A fila de emissão está replicada entre zonas, então os documentos que estavam aguardando autorização continuam sendo processados após a falha de um servidor. - Na documentação de uma API fiscal, a equipe técnica informa que o banco de dados é replicado em mais de uma zona de disponibilidade para garantir a guarda dos XMLs autorizados. ## Perguntas frequentes ### Zona de disponibilidade é o mesmo que backup? Não. Backup é uma cópia guardada para recuperar dados depois de um problema. Zona de disponibilidade mantém o serviço funcionando em tempo real em locais separados. As duas práticas se complementam. ### Preciso configurar zonas de disponibilidade no meu sistema para usar uma API fiscal? Em geral, não. A distribuição entre zonas é responsabilidade de quem opera a infraestrutura da API. Do lado do integrador, o importante é tratar erros temporários com retry, timeout e idempotência. ### Usar várias zonas garante que a API nunca saia do ar? Não existe garantia absoluta. Várias zonas reduzem bastante o risco de interrupção por falhas locais, mas problemas de software, manutenções ou indisponibilidade dos órgãos autorizadores ainda podem afetar a emissão. ## Termos relacionados - [Healthcheck de API](https://conota.dev/glossario/healthcheck-de-api.md) - [Fallback na integração fiscal](https://conota.dev/glossario/fallback-na-integracao-fiscal.md) - [Kubernetes na infraestrutura de APIs](https://conota.dev/glossario/kubernetes-na-infraestrutura-de-apis.md) - [Observabilidade da API fiscal](https://conota.dev/glossario/observabilidade-da-api-fiscal.md) - [Idempotência na emissão fiscal](https://conota.dev/glossario/idempotencia-na-emissao-fiscal.md) - [Janela de manutenção da API](https://conota.dev/glossario/janela-de-manutencao-da-api.md) --- Fonte: [Zona de disponibilidade da infraestrutura fiscal](https://conota.dev/glossario/zona-de-disponibilidade-da-infraestrutura-fiscal/) · Atualizado em 2026-10-22 --- # Zona de Processamento de Exportação > Zona de Processamento de Exportação (ZPE) é uma área delimitada e sob controle aduaneiro, criada pelo governo para abrigar empresas que produzem bens ou serviços voltados principalmente ao mercado externo. As empresas autorizadas a operar nela contam com suspensão de tributos federais na compra de insumos e equipamentos, desde que cumpram as regras do regime. **Também conhecido como:** Zona de Processamento de Exportações, Zonas de Processamento de Exportação, ZPE, Export Processing Zone **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** Z ## O que é uma Zona de Processamento de Exportação na prática? Uma ZPE é um distrito industrial com regras especiais. Ela tem limites físicos bem definidos, é cercada e fica sob fiscalização da Receita Federal, de forma parecida com um porto ou aeroporto alfandegado. Tudo o que entra e sai passa por controle aduaneiro. Para se instalar ali, a empresa precisa de autorização do governo federal, apresentando um projeto industrial. Depois de aprovada, ela passa a operar sob um regime tributário, cambial e administrativo diferente do aplicado às empresas comuns. ## Para que serve uma ZPE? O objetivo principal é estimular exportações, atrair investimentos e gerar empregos, em geral em regiões que o governo quer desenvolver. Ao reduzir o custo de produção, a ZPE torna os produtos brasileiros mais competitivos lá fora. Também facilita a entrada de novas tecnologias, já que a empresa pode importar máquinas e insumos com menos carga tributária e menos burocracia do que no regime comum. ## Quais benefícios fiscais uma empresa em ZPE recebe? O principal benefício é a suspensão de tributos federais na aquisição de bens e serviços, tanto importados quanto comprados no Brasil. Entre os tributos normalmente envolvidos estão o Imposto de Importação, o IPI e as contribuições PIS e Cofins. Suspensão não é o mesmo que isenção imediata: o imposto deixa de ser cobrado naquele momento e, se a empresa cumprir as condições do regime, como exportar o produto final, a suspensão se converte em alíquota zero ou isenção. Se as regras forem descumpridas, os tributos podem ser cobrados com acréscimos. Benefícios relativos ao ICMS dependem da legislação de cada estado, por isso precisam ser verificados caso a caso. ## Qual a diferença entre ZPE e Zona Franca de Manaus? A Zona Franca de Manaus é uma área de incentivo fiscal amplo, voltada também ao abastecimento do mercado interno brasileiro, e fica em uma região específica. Já as ZPEs podem existir em vários estados e têm foco no comércio exterior. Outra diferença é o controle: a ZPE funciona como área alfandegada fechada, enquanto a Zona Franca abrange uma região muito maior, com regras próprias de incentivo e fiscalização. ## Como a ZPE aparece na emissão de documentos fiscais? Quando um fornecedor brasileiro vende para uma empresa instalada em ZPE, a NF-e precisa refletir a suspensão dos tributos. Isso envolve escolher corretamente a natureza da operação, o CFOP, os códigos de situação tributária (CST) de IPI, PIS e Cofins e incluir no campo de informações complementares a indicação do benefício. Para sistemas que emitem notas por API, isso significa ter regras de tributação configuradas para esse tipo de cliente. Um ERP integrado a uma API fiscal pode identificar que o destinatário está em ZPE e montar o payload com os códigos adequados, evitando rejeições e erros de escrituração. A definição exata dos códigos deve ser validada com o contador da empresa. ## Exemplos de Zona de Processamento de Exportação - Uma fabricante de autopeças vende chapas de aço para uma montadora instalada em uma ZPE e emite a NF-e com IPI, PIS e Cofins suspensos, informando o benefício nas informações complementares. - Uma empresa em ZPE importa uma máquina industrial e não recolhe Imposto de Importação nem IPI no desembaraço, porque a operação está sob o regime suspensivo. - Um ERP integrado a uma API fiscal marca o cadastro de um cliente como empresa em ZPE e, a cada venda, aplica automaticamente os CSTs de suspensão no payload de emissão. - Uma indústria exportadora instalada em ZPE emite NF-e de exportação ao vender sua produção para um comprador no exterior, cumprindo a condição que mantém o benefício. ## Perguntas frequentes ### Qualquer empresa pode se instalar em uma ZPE? Não. A empresa precisa ter um projeto aprovado pelo governo federal e cumprir os requisitos do regime. Sem essa autorização, não pode usufruir dos benefícios, mesmo que esteja fisicamente próxima à área. ### A venda para empresa em ZPE é considerada exportação? Não exatamente. É uma venda no mercado interno com tributos federais suspensos. A emissão segue regras próprias, diferentes da NF-e de exportação direta para o exterior, e os códigos devem ser definidos com orientação contábil. ### O ICMS também fica suspenso em operações com ZPE? Depende do estado. O regime da ZPE trata principalmente de tributos federais. O tratamento do ICMS é definido pela legislação estadual, que pode ou não prever benefício para essas operações. ### O que acontece se a empresa em ZPE não cumprir as regras? Os tributos suspensos podem ser cobrados, com juros e multa, e a empresa pode sofrer outras penalidades previstas no regime, incluindo a perda da autorização para operar na zona. ## Termos relacionados - [Operação de exportação](https://conota.dev/glossario/operacao-de-exportacao.md) - [NF-e](https://conota.dev/glossario/nf-e.md) - [IPI](https://conota.dev/glossario/ipi.md) - [PIS](https://conota.dev/glossario/pis.md) - [CST](https://conota.dev/glossario/cst.md) - [Natureza da operação](https://conota.dev/glossario/natureza-da-operacao.md) --- Fonte: [Zona de Processamento de Exportação](https://conota.dev/glossario/zona-de-processamento-de-exportacao/) · Atualizado em 2026-10-22 --- # Zona de vigilância aduaneira > Zona de vigilância aduaneira é uma área demarcada pelo governo federal na orla marítima ou na faixa de fronteira, onde a circulação e a permanência de mercadorias, veículos e pessoas ficam sujeitas a controles, exigências e restrições especiais da Receita Federal, com o objetivo de prevenir contrabando, descaminho e outras irregularidades no comércio exterior. **Também conhecido como:** Zona de vigilância, ZVA, Customs surveillance zone **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** Z ## O que é uma zona de vigilância aduaneira? É uma faixa do território brasileiro, situada perto do litoral ou das fronteiras terrestres, onde a fiscalização aduaneira atua de forma mais intensa do que no restante do país. A previsão está na legislação aduaneira federal, que autoriza o Ministro responsável pela área da Fazenda a demarcar essas áreas. Dentro dela, as mercadorias que estão paradas ou em trânsito, assim como os veículos que as transportam, podem ser obrigados a cumprir regras extras, como comprovar a origem dos produtos com documentação fiscal válida. ## Para que serve a zona de vigilância aduaneira? A finalidade principal é combater a entrada ou saída irregular de mercadorias do país. Regiões de fronteira e de litoral são rotas naturais para contrabando (mercadorias proibidas) e descaminho (mercadorias permitidas, mas que entram sem pagar tributos). Ao concentrar controles nessas áreas, a Receita Federal consegue verificar cargas antes que elas se espalhem pelo interior, onde a fiscalização seria mais difícil. ## Qual a diferença entre zona primária, zona secundária e zona de vigilância aduaneira? O território aduaneiro brasileiro é dividido em duas partes. A zona primária abrange os locais alfandegados, como portos, aeroportos e pontos de fronteira onde ocorre o despacho de importação e exportação. A zona secundária é todo o restante do território, incluindo águas territoriais e espaço aéreo. A zona de vigilância aduaneira não é uma terceira divisão: ela fica dentro da zona secundária. É um recorte da zona secundária, perto do mar ou da fronteira, onde valem controles adicionais definidos pelo governo. ## O que muda para quem transporta mercadorias nessa área? Na prática, quem circula com carga em uma zona de vigilância aduaneira deve estar preparado para comprovar a regularidade da mercadoria a qualquer momento. Isso significa ter os documentos fiscais corretos acompanhando o transporte, como NF-e, CT-e e MDF-e, conforme o tipo de operação. Mercadorias estrangeiras sem prova de importação regular, ou cargas sem documentação compatível, podem ser retidas ou apreendidas, e o responsável pode sofrer penalidades previstas na legislação aduaneira, inclusive a perda da mercadoria. ## Qual a relação entre a zona de vigilância aduaneira e a emissão de documentos fiscais? A documentação fiscal eletrônica é a principal forma de provar, durante uma abordagem, que a carga é legítima. Dados como descrição do produto, NCM, origem, destinatário, transportador e chave de acesso permitem ao fiscal consultar a autenticidade do documento na hora. Para empresas que operam em cidades de fronteira ou portuárias, emitir os documentos com dados corretos e antes da saída da mercadoria reduz o risco de retenção. Sistemas que emitem notas por API, integrados ao ERP, ajudam a garantir que nenhum veículo saia sem NF-e autorizada e, quando exigido, sem CT-e e MDF-e vinculados. ## Exemplos de Zona de vigilância aduaneira - Uma distribuidora sediada em um município de fronteira emite NF-e e MDF-e pelo seu ERP antes de cada carregamento, pois os caminhões costumam ser parados em postos de fiscalização da região. - Um comerciante transporta eletrônicos importados por uma rodovia próxima à fronteira sem a documentação de importação; a carga é retida pela fiscalização aduaneira até que a origem seja comprovada. - Uma transportadora que atende portos marítimos configura sua integração para impedir a liberação de veículos enquanto o CT-e não estiver autorizado, evitando problemas em abordagens dentro da zona de vigilância. - Um marketplace com vendedores em cidades litorâneas orienta os lojistas a sempre enviarem a mercadoria acompanhada do DANFE da NF-e autorizada. ## Perguntas frequentes ### Quem define onde fica a zona de vigilância aduaneira? A demarcação é feita por ato do Ministro responsável pela área da Fazenda, com base na legislação aduaneira federal. Ela ocorre na orla marítima ou na faixa de fronteira e pode abranger municípios inteiros. ### Toda empresa de cidade de fronteira está na zona de vigilância aduaneira? Não necessariamente. Depende da demarcação oficial vigente. Ainda assim, empresas nessas regiões costumam ser fiscalizadas com mais frequência e devem manter a documentação fiscal sempre em ordem. ### O DANFE basta para comprovar a regularidade da carga? O DANFE acompanha o transporte e permite consultar a NF-e pela chave de acesso. Para mercadorias estrangeiras, porém, a fiscalização pode exigir também a comprovação da importação regular. ### Zona de vigilância aduaneira é o mesmo que Área de Livre Comércio? Não. A Área de Livre Comércio concede benefícios fiscais para estimular a economia local. A zona de vigilância aduaneira serve para intensificar o controle sobre mercadorias e combater irregularidades. ## Termos relacionados - [Fiscalização tributária](https://conota.dev/glossario/fiscalizacao-tributaria.md) - [Área de Livre Comércio](https://conota.dev/glossario/area-de-livre-comercio.md) - [Habilitação no Siscomex](https://conota.dev/glossario/habilitacao-no-siscomex.md) - [Grupo de informações de exportação da NF-e](https://conota.dev/glossario/grupo-de-informacoes-de-exportacao-da-nf-e.md) - [CT-e](https://conota.dev/glossario/ct-e.md) - [DAMDFE](https://conota.dev/glossario/damdfe.md) --- Fonte: [Zona de vigilância aduaneira](https://conota.dev/glossario/zona-de-vigilancia-aduaneira/) · Atualizado em 2026-10-22 --- # Zona Franca de Manaus > Zona Franca de Manaus é uma área do Amazonas com regime fiscal especial, criada para estimular a indústria, o comércio e a ocupação econômica da Amazônia. Empresas instaladas ali, ou que vendem para lá, podem ter isenções e reduções de tributos como IPI, ICMS, PIS e Cofins, que precisam constar corretamente na nota fiscal. **Também conhecido como:** ZFM, Zona Franca, Polo Industrial de Manaus, Manaus Free Trade Zone **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** Z ## O que é a Zona Franca de Manaus? A Zona Franca de Manaus, conhecida pela sigla ZFM, é um modelo de desenvolvimento regional que concede benefícios tributários a empresas que produzem ou comercializam mercadorias na região de Manaus, no Amazonas. A ideia é compensar a distância dos grandes centros consumidores e atrair investimentos para a Amazônia. O regime é administrado pela Suframa (Superintendência da Zona Franca de Manaus), órgão federal que cadastra as empresas beneficiárias, acompanha a entrada de mercadorias e controla o uso dos incentivos. Parte desses benefícios também se estende a outras áreas da Amazônia Ocidental e a Áreas de Livre Comércio. ## Quais tributos têm benefício na Zona Franca de Manaus? Os principais incentivos envolvem tributos federais e estaduais. Em linhas gerais, há isenção ou redução de IPI e de imposto de importação para produtos fabricados ou internados na região, alíquota zero de PIS e Cofins em determinadas vendas destinadas à ZFM e desoneração do ICMS em remessas de mercadorias nacionais vindas de outros estados. Cada benefício tem requisitos próprios, como o tipo de produto, a finalidade da operação e o cadastro do destinatário. Por isso, nem toda venda para Manaus é automaticamente beneficiada, e a análise deve ser feita caso a caso, de preferência com apoio contábil. ## Como a Zona Franca de Manaus aparece na NF-e? Quando uma empresa de outro estado vende para um destinatário cadastrado na Suframa, a NF-e precisa trazer a inscrição Suframa do destinatário, informada no grupo de dados do destinatário. Sem esse dado, a operação não é reconhecida como beneficiada. O benefício também se reflete na tributação de cada item: o ICMS desonerado costuma ser informado com o valor da desoneração e o motivo correspondente à Suframa, além de CST e CFOP compatíveis com a operação. PIS, Cofins e IPI também devem usar os códigos de situação tributária adequados ao benefício. Depois da emissão, a mercadoria passa por um procedimento de internamento, no qual a Suframa confirma que o produto realmente entrou na área incentivada. Esse controle é o que dá sustentação ao benefício concedido na nota. ## Por que a Zona Franca de Manaus importa para quem emite notas por API? Sistemas que emitem documentos fiscais automaticamente, como ERPs, marketplaces e plataformas de venda, precisam identificar quando o destinatário está na ZFM e montar o payload de emissão com os campos certos. Um dado faltando ou um código incompatível pode gerar rejeição na SEFAZ ou, pior, uma nota autorizada com tributação errada. Na prática, o sistema do cliente define as regras tributárias da venda e envia as informações para a API fiscal, que valida o leiaute, transmite o documento e devolve o status, o XML e o DANFE. Manter o cadastro do cliente com a inscrição Suframa atualizada é um passo essencial nesse fluxo. ## Qual a diferença entre Zona Franca de Manaus e Área de Livre Comércio? A Zona Franca de Manaus é o regime principal, com o conjunto mais amplo de incentivos, incluindo benefícios para a indústria instalada na região. As Áreas de Livre Comércio são localidades específicas, em geral em cidades de fronteira da Amazônia, que recebem benefícios parecidos, porém com regras e alcance próprios. Para a emissão fiscal, ambas exigem atenção semelhante: identificar o destinatário, informar a inscrição Suframa quando aplicável e aplicar a tributação correta para cada item. ## Exemplos de Zona Franca de Manaus - Uma distribuidora de São Paulo vende eletrodomésticos para uma loja em Manaus cadastrada na Suframa e emite a NF-e com a inscrição Suframa do destinatário e o ICMS desonerado informado nos itens. - Um ERP identifica, pelo cadastro do cliente, que o comprador está na Zona Franca de Manaus e ajusta automaticamente CST, CFOP e campos de desoneração antes de enviar o payload à API fiscal. - Uma nota para Manaus é rejeitada porque o motivo de desoneração foi informado, mas a inscrição Suframa do destinatário ficou em branco; o sistema corrige o cadastro e reenvia o documento. - Uma indústria instalada em Manaus emite NF-e de venda de produtos fabricados na região, aplicando os benefícios de IPI previstos para sua linha de produção. ## Perguntas frequentes ### Toda venda para Manaus tem benefício fiscal? Não. O benefício depende do destinatário estar cadastrado na Suframa, do tipo de mercadoria e da finalidade da operação. Alguns produtos são excluídos dos incentivos. Por isso, é preciso analisar cada operação antes de aplicar a desoneração na nota. ### O que é a inscrição Suframa? É o número de cadastro da empresa na Suframa, que comprova sua habilitação para usufruir dos incentivos da Zona Franca de Manaus. Ele deve ser informado nos dados do destinatário da NF-e quando a operação for beneficiada. ### O que é o internamento de mercadoria na ZFM? É o procedimento em que a Suframa confirma que a mercadoria vendida com benefício realmente entrou na área incentivada. Sem essa comprovação, o benefício pode ser questionado e os tributos dispensados podem ser cobrados. ### A reforma tributária acaba com a Zona Franca de Manaus? A reforma tributária prevê a manutenção de tratamento diferenciado para a Zona Franca de Manaus, com regras adaptadas aos novos tributos, como IBS e CBS. Os detalhes de transição devem ser acompanhados pela legislação e pelas notas técnicas fiscais. ## Termos relacionados - [ICMS](https://conota.dev/glossario/icms.md) - [IPI](https://conota.dev/glossario/ipi.md) - [Destinatário da NF-e](https://conota.dev/glossario/destinatario-da-nf-e.md) - [CST](https://conota.dev/glossario/cst.md) - [Operação interestadual](https://conota.dev/glossario/operacao-interestadual.md) - [NF-e](https://conota.dev/glossario/nf-e.md) --- Fonte: [Zona Franca de Manaus](https://conota.dev/glossario/zona-franca-de-manaus/) · Atualizado em 2026-10-22 --- # Zona primária aduaneira > Zona primária aduaneira é a parte do território nacional onde a Receita Federal exerce controle direto sobre a entrada e a saída de mercadorias, veículos e pessoas do país. Abrange portos, aeroportos e pontos de fronteira alfandegados, locais onde as cargas de importação e exportação passam por conferência e despacho aduaneiro. **Também conhecido como:** Zona primária, Zona aduaneira primária, Área alfandegada de zona primária, Primary customs zone **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** Z ## O que é a zona primária aduaneira? A zona primária aduaneira é o conjunto de áreas onde acontece o contato direto entre o Brasil e o exterior no fluxo de mercadorias. São os portos, os aeroportos e os pontos de fronteira terrestre que foram oficialmente alfandegados, ou seja, autorizados e equipados para operações de comércio exterior sob fiscalização da Receita Federal. Nesses locais, a autoridade aduaneira tem poder ampliado de fiscalização. Ela pode vistoriar cargas, conferir documentos, reter mercadorias e controlar o acesso de veículos e pessoas. As regras sobre a demarcação dessas áreas estão no Regulamento Aduaneiro. ## Qual a diferença entre zona primária e zona secundária? A zona primária é formada apenas pelas áreas alfandegadas de portos, aeroportos e fronteiras. A zona secundária é todo o restante do território aduaneiro, incluindo as águas territoriais e o espaço aéreo. Na zona secundária também existem recintos alfandegados, como os portos secos, que são terminais no interior do país onde cargas podem ser armazenadas e desembaraçadas. Mesmo com fiscalização aduaneira, esses recintos continuam classificados como zona secundária, e não primária. ## Para que serve a zona primária aduaneira? Ela serve para concentrar o controle das mercadorias que entram e saem do país em pontos específicos. Assim, a Receita Federal consegue verificar se a carga declarada corresponde à carga real, se os tributos de importação foram pagos e se não há produtos proibidos ou irregulares. Para as empresas, a zona primária é o ponto em que a mercadoria efetivamente cruza a fronteira. Na exportação, é ali que a carga é embarcada para o exterior; na importação, é onde ela chega e, em muitos casos, passa pelo desembaraço antes de seguir para o importador. ## Como a zona primária aparece nos documentos fiscais eletrônicos? Na NF-e de exportação, o emitente preenche o grupo de informações de exportação, indicando a UF de embarque e o local onde a mercadoria será embarcada ou transposta para fora do país, que normalmente é um porto, aeroporto ou ponto de fronteira da zona primária. Também pode informar o local de despacho, que às vezes fica em um recinto da zona secundária. No transporte, o CT-e e o MDF-e registram o trajeto da carga até o porto ou aeroporto de saída, ou dele até o destino no caso de importação. Na NF-e de importação, constam dados da declaração de importação, incluindo o local de desembaraço. ## Por que um sistema de emissão fiscal precisa considerar a zona primária? Erros no preenchimento dos locais de embarque e despacho podem gerar rejeição da nota pela SEFAZ ou divergências entre a NF-e e o registro no Siscomex, atrasando a comprovação da exportação. Isso afeta, por exemplo, o reconhecimento da não incidência de ICMS sobre a operação. Por isso, ERPs e plataformas que emitem notas por API costumam manter um cadastro dos portos, aeroportos e pontos de fronteira usados pela empresa, preenchendo esses campos de forma padronizada em cada documento. ## Exemplos de Zona primária aduaneira - Uma indústria de calçados do Rio Grande do Sul emite NF-e de exportação informando como local de embarque o porto de onde o contêiner sairá para o exterior, uma área da zona primária aduaneira. - Uma transportadora emite CT-e e MDF-e para levar uma carga de uma fábrica no interior de São Paulo até o aeroporto internacional de onde ela seguirá por via aérea. - Um importador recebe peças que chegam por um porto e são removidas para um porto seco no interior, onde ocorre o desembaraço; o porto é zona primária, e o porto seco é recinto alfandegado de zona secundária. - Uma empresa exporta produtos agrícolas por caminhão para um país vizinho, indicando na NF-e o ponto de fronteira alfandegado por onde a carga sairá do Brasil. ## Perguntas frequentes ### Porto seco é zona primária? Não. O porto seco é um recinto alfandegado localizado na zona secundária. Ele tem fiscalização aduaneira e permite desembaraço, mas não é classificado como zona primária, que reúne apenas portos, aeroportos e pontos de fronteira alfandegados. ### Toda área de um porto faz parte da zona primária? Não necessariamente. A zona primária corresponde às áreas demarcadas pela autoridade aduaneira dentro do porto, aeroporto ou ponto de fronteira. Partes sem operação de comércio exterior podem ficar fora dessa demarcação. ### Onde informo o local de embarque na NF-e de exportação? No grupo de informações de exportação da NF-e, que pede a UF de embarque e o local de embarque ou de transposição de fronteira. Opcionalmente, informa-se também o local de despacho da mercadoria. ## Termos relacionados - [Grupo de informações de exportação da NF-e](https://conota.dev/glossario/grupo-de-informacoes-de-exportacao-da-nf-e.md) - [Habilitação no Siscomex](https://conota.dev/glossario/habilitacao-no-siscomex.md) - [Exportação indireta](https://conota.dev/glossario/exportacao-indireta.md) - [Área de Livre Comércio](https://conota.dev/glossario/area-de-livre-comercio.md) - [CT-e](https://conota.dev/glossario/ct-e.md) - [Averbação de carga](https://conota.dev/glossario/averbacao-de-carga.md) --- Fonte: [Zona primária aduaneira](https://conota.dev/glossario/zona-primaria-aduaneira/) · Atualizado em 2026-10-22 --- # Zona secundária aduaneira > Zona secundária aduaneira é a parte do território aduaneiro brasileiro que fica fora dos portos, aeroportos e pontos de fronteira alfandegados, chamados de zona primária. Ela abrange o restante do território nacional, incluindo águas territoriais e espaço aéreo, onde a Receita Federal também exerce controle sobre mercadorias estrangeiras e destinadas à exportação. **Também conhecido como:** Zona secundária, Zona aduaneira secundária, Secondary customs zone **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** Z ## O que é a zona secundária aduaneira? Para fins de controle de comércio exterior, o território aduaneiro brasileiro é dividido em duas partes: a zona primária e a zona secundária. A zona primária é formada pelos locais onde as mercadorias entram ou saem do país, como portos, aeroportos e pontos de fronteira alfandegados. A zona secundária é todo o restante do território nacional. Isso inclui cidades do interior, áreas industriais e também recintos alfandegados instalados longe do litoral ou da fronteira, como os portos secos. Nesses locais a fiscalização aduaneira continua existindo, embora a mercadoria já não esteja no ponto de entrada ou saída do país. ## Qual a diferença entre zona primária e zona secundária? A zona primária é o ponto físico de fronteira com o exterior: o cais do porto, o terminal de cargas do aeroporto, o posto de fronteira terrestre. É ali que a mercadoria chega ou deixa o país. A zona secundária é o interior do território. Uma carga importada pode desembarcar em um porto (zona primária) e seguir, ainda sob controle aduaneiro, até um porto seco no interior (zona secundária), onde será desembaraçada. Essa possibilidade descongestiona portos e aproxima o despacho aduaneiro das empresas. ## O que são recintos alfandegados de zona secundária? São áreas autorizadas pela Receita Federal para armazenar e movimentar mercadorias sob controle aduaneiro fora da zona primária. O exemplo mais conhecido é o porto seco, também chamado no passado de EADI, que funciona como um terminal interior para importação e exportação. Nesses recintos podem ser feitos procedimentos como armazenagem, conferência, desembaraço aduaneiro e unitização de cargas para exportação. Eles costumam ser usados por empresas que querem resolver a parte aduaneira mais perto de onde produzem ou consomem as mercadorias. ## Como a zona secundária aparece na emissão de documentos fiscais? Na importação, a NF-e de entrada traz dados da declaração de importação, incluindo o local onde ocorreu o desembaraço aduaneiro. Se esse desembaraço foi feito em um porto seco, o local informado será um recinto de zona secundária, e não o porto onde o navio atracou. Na exportação, a NF-e tem um grupo próprio de informações de exportação, com dados como o local de embarque ou de despacho. Mercadorias enviadas a um recinto alfandegado no interior para formação de lote ou despacho de exportação também exigem notas fiscais com CFOP e informações adequadas a essa operação. No transporte, o trajeto entre a zona primária e um recinto de zona secundária, ou o caminho inverso, envolve documentos como CT-e e MDF-e, além dos controles aduaneiros de trânsito. Por isso, sistemas que emitem documentos por API precisam cadastrar corretamente os locais e recintos envolvidos. ## Por que isso importa para quem integra sistemas fiscais? ERPs e plataformas que atendem importadores, exportadores e transportadoras precisam distinguir onde cada etapa aconteceu. Informar um local de desembaraço ou de embarque incorreto pode gerar inconsistências entre a nota fiscal e as declarações aduaneiras, dificultando a comprovação da operação perante o fisco. Na prática, o sistema deve guardar dados do recinto alfandegado, do tipo de operação e dos documentos aduaneiros vinculados, para que a emissão da NF-e, do CT-e ou do MDF-e reflita fielmente o caminho da mercadoria. ## Exemplos de Zona secundária aduaneira - Uma indústria de Campinas importa máquinas que desembarcam no Porto de Santos e seguem em trânsito aduaneiro até um porto seco na região, onde ocorre o desembaraço; na NF-e de entrada, o local de desembaraço informado é o recinto de zona secundária. - Um exportador de café envia sacas a um porto seco no interior para formação de lote e despacho de exportação, emitindo a NF-e com os dados do grupo de exportação antes do embarque no porto. - Uma transportadora leva contêineres do terminal portuário até um recinto alfandegado no interior e emite CT-e e MDF-e para acobertar esse deslocamento, além dos documentos de trânsito aduaneiro. - Um ERP voltado a comércio exterior mantém um cadastro de recintos alfandegados de zona primária e secundária para preencher automaticamente os campos de local de desembaraço nas notas de importação. ## Perguntas frequentes ### Porto seco é zona primária ou secundária? Porto seco é um recinto alfandegado de zona secundária. Ele fica no interior do território, longe de portos e aeroportos, mas funciona sob controle da Receita Federal para armazenagem e despacho de mercadorias importadas ou destinadas à exportação. ### Mercadoria estrangeira pode circular na zona secundária antes do desembaraço? Sim, desde que esteja sob regime de trânsito aduaneiro autorizado, seguindo da zona primária até um recinto alfandegado de zona secundária, onde o desembaraço será concluído. ### A zona secundária muda os campos da NF-e? Não cria campos novos, mas influencia o preenchimento. O local de desembaraço na importação e as informações de exportação devem indicar o recinto onde a etapa realmente ocorreu, seja ele de zona primária ou secundária. ## Termos relacionados - [Grupo de informações de exportação da NF-e](https://conota.dev/glossario/grupo-de-informacoes-de-exportacao-da-nf-e.md) - [Habilitação no Siscomex](https://conota.dev/glossario/habilitacao-no-siscomex.md) - [Exportação indireta](https://conota.dev/glossario/exportacao-indireta.md) - [CT-e](https://conota.dev/glossario/ct-e.md) - [MDF-e](https://conota.dev/glossario/mdf-e.md) - [Fiscalização tributária](https://conota.dev/glossario/fiscalizacao-tributaria.md) --- Fonte: [Zona secundária aduaneira](https://conota.dev/glossario/zona-secundaria-aduaneira/) · Atualizado em 2026-10-22 --- # Zone apex no DNS de uma API > Zone apex no DNS de uma API é o nome de domínio raiz de uma zona DNS, sem nenhum subdomínio à frente, como empresa.com.br em vez de api.empresa.com.br. Nesse ponto ficam registros obrigatórios da zona, o que impede o uso de CNAME e influencia a forma de configurar e apontar o endereço de uma API. **Também conhecido como:** Domínio raiz, Domínio nu, Naked domain, Apex domain, Raiz da zona DNS, Domínio apex, Zone apex **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** Z ## O que é zone apex no DNS? O DNS funciona como uma grande lista telefônica da internet: ele traduz nomes, como empresa.com.br, em endereços que os computadores entendem. Cada domínio registrado tem uma zona DNS, que é o conjunto de registros que dizem para onde cada nome aponta. O zone apex é o topo dessa zona, ou seja, o próprio domínio sem nada antes dele. Em empresa.com.br, o apex é empresa.com.br. Já api.empresa.com.br, www.empresa.com.br e webhooks.empresa.com.br são subdomínios, que ficam abaixo do apex. Também é comum ouvir os nomes domínio raiz, domínio nu ou, em inglês, naked domain. Nos painéis de DNS, o apex costuma aparecer representado pelo símbolo @. ## Por que não se pode usar CNAME no zone apex? O registro CNAME diz que um nome é apenas um apelido de outro, por exemplo, que api.empresa.com.br é o mesmo que servidor.provedor.com. A regra do DNS determina que um nome com CNAME não pode ter nenhum outro registro junto. O problema é que o apex sempre precisa ter registros obrigatórios da zona, como o SOA, que identifica a zona, e os registros NS, que indicam quais servidores respondem por ela. Muitas vezes ele também tem registros MX, de e-mail, e TXT, de verificação. Como esses registros não podem conviver com um CNAME, o padrão do DNS não permite CNAME no apex. ## Como apontar o zone apex para uma API? A forma tradicional é usar registros A (para endereços IPv4) e AAAA (para IPv6), apontando o apex diretamente para os IPs do servidor. Isso funciona bem quando os IPs são fixos, mas se torna frágil quando a API roda em nuvem, atrás de balanceadores de carga cujos IPs podem mudar. Para contornar essa limitação, vários provedores de DNS oferecem recursos próprios, chamados de ALIAS, ANAME ou CNAME flattening. Eles se comportam como um CNAME por dentro, mas respondem ao público com registros A e AAAA comuns, respeitando a regra do DNS. O nome e o funcionamento exato variam de provedor para provedor. Outra saída simples é não servir a API no apex: o apex apenas redireciona para um subdomínio, como api.empresa.com.br, e esse subdomínio usa um CNAME normal. ## Por que APIs costumam usar subdomínio em vez do zone apex? Usar um subdomínio dedicado, como api.empresa.com.br, separa a API do site institucional e do e-mail da empresa. Assim, é possível trocar de provedor, mudar a infraestrutura ou fazer uma janela de manutenção na API sem mexer no restante do domínio. O subdomínio também facilita apontar para serviços em nuvem via CNAME, configurar certificados TLS específicos para HTTPS, aplicar regras de firewall e monitoramento próprios e montar estratégias de failover. Por isso, endpoints de API quase sempre ficam em subdomínios, e o apex fica reservado para o site principal. ## Onde o zone apex aparece em uma integração fiscal? Em uma integração com uma API fiscal, o sistema do cliente, como um ERP ou marketplace, normalmente chama os endpoints do emissor e também recebe notificações por webhook com o status de NF-e, NFS-e, CT-e ou MDF-e. A URL que recebe esses webhooks fica no domínio do próprio cliente, e é aí que a configuração de DNS importa. Se a URL de webhook estiver no apex e o DNS apontar para IPs fixos que mudaram, as notificações de autorização ou rejeição podem não chegar, e o sistema fica sem saber o resultado da emissão. Usar um subdomínio dedicado, com certificado HTTPS válido para aquele nome e um healthcheck monitorando o endereço, reduz esse risco. ## Exemplos de Zone apex no DNS de uma API - Uma software house que vende um ERP configura api.meuerp.com.br com um CNAME para o balanceador de carga em nuvem, deixando meuerp.com.br, o zone apex, apontado para o site institucional. - Um marketplace precisava receber webhooks de status de NF-e em marketplace.com.br, no zone apex. Como o provedor de DNS não aceitava CNAME ali, a equipe usou um registro ALIAS oferecido pelo próprio provedor de DNS. - Após migrar o servidor que recebia notificações fiscais, uma empresa esqueceu de atualizar o registro A do zone apex. As notificações de autorização de NFS-e deixaram de chegar até a correção do DNS, o que levou o time a mover a URL para o subdomínio webhooks.empresa.com.br. - Um time de infraestrutura configura o zone apex para redirecionar via HTTPS para www.empresa.com.br, mantendo a API isolada em api.empresa.com.br. ## Perguntas frequentes ### Zone apex e domínio raiz são a mesma coisa? Sim, no uso do dia a dia. Ambos se referem ao domínio sem subdomínio, como empresa.com.br. Nos painéis de DNS, ele costuma ser indicado pelo símbolo @. ### Posso hospedar minha API diretamente no zone apex? Pode, usando registros A e AAAA ou recursos como ALIAS e CNAME flattening, se o provedor de DNS oferecer. Ainda assim, um subdomínio dedicado, como api.empresa.com.br, costuma ser mais simples de manter e migrar. ### O que acontece se eu tentar criar um CNAME no zone apex? Muitos provedores de DNS bloqueiam a criação. Quando aceitam, o resultado pode ser comportamento imprevisível, como falhas na entrega de e-mails ou na resolução do domínio, porque o CNAME entra em conflito com os registros obrigatórios da zona. ### O certificado HTTPS do subdomínio vale para o zone apex? Não automaticamente. Um certificado para api.empresa.com.br não cobre empresa.com.br. É preciso incluir o apex no certificado ou emitir um certificado próprio para ele, senão as conexões HTTPS falham. ## Termos relacionados - [Endpoint de API](https://conota.dev/glossario/endpoint-de-api.md) - [HTTPS](https://conota.dev/glossario/https.md) - [Healthcheck de API](https://conota.dev/glossario/healthcheck-de-api.md) - [Fallback na integração fiscal](https://conota.dev/glossario/fallback-na-integracao-fiscal.md) - [Gateway de API fiscal](https://conota.dev/glossario/gateway-de-api-fiscal.md) - [Janela de manutenção da API](https://conota.dev/glossario/janela-de-manutencao-da-api.md) --- Fonte: [Zone apex no DNS de uma API](https://conota.dev/glossario/zone-apex-no-dns-de-uma-api/) · Atualizado em 2026-10-22 --- # Zoneamento fiscal municipal > Zoneamento fiscal municipal é a divisão do território de um município em zonas, setores ou regiões usadas pela prefeitura para organizar a administração dos tributos locais. Pode servir para avaliar imóveis no cálculo do IPTU, distribuir equipes de fiscalização e, em alguns municípios, aplicar regras ou incentivos diferentes conforme a localização do contribuinte. **Também conhecido como:** Zoneamento tributário municipal, Zonas fiscais, Setorização fiscal do município, Municipal tax zoning **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** Z ## O que é zoneamento fiscal municipal? É a forma como uma prefeitura divide o mapa da cidade para fins tributários. Em vez de tratar todo o território de maneira igual, o município separa bairros, quadras ou regiões em zonas fiscais, cada uma identificada por um código ou nome no cadastro municipal. Essa divisão é definida pela legislação de cada município. Por isso, não existe um modelo único no Brasil: cada prefeitura decide quantas zonas cria, quais critérios usa e para quais tributos ou atividades administrativas elas valem. ## Para que serve o zoneamento fiscal? O uso mais conhecido é no IPTU. As zonas ajudam a definir o valor de referência do metro quadrado dos imóveis, já que um terreno em área central costuma valer mais que um em área afastada. Isso influencia a base de cálculo do imposto. Outro uso é organizar a fiscalização tributária. A prefeitura pode distribuir fiscais por zona, acompanhar a arrecadação por região e identificar áreas com mais empresas irregulares ou sem inscrição municipal. Alguns municípios também usam zonas para conceder benefícios fiscais, como redução de ISSQN para empresas instaladas em regiões que a prefeitura quer desenvolver. Quando isso acontece, a regra precisa estar prevista em lei municipal. ## Qual a diferença entre zoneamento fiscal e zoneamento urbano? O zoneamento urbano trata do uso e da ocupação do solo: define onde podem funcionar indústrias, comércios ou residências e quais construções são permitidas. Ele está ligado ao planejamento da cidade. O zoneamento fiscal tem finalidade tributária: serve para calcular, cobrar e fiscalizar tributos. As duas divisões podem coincidir em alguns pontos, mas são instrumentos diferentes e podem ter limites e códigos distintos no mesmo município. ## O zoneamento fiscal afeta a emissão de NFS-e? Na maioria dos casos, a NFS-e trabalha com o município como unidade principal: o que importa é onde o prestador está estabelecido e onde o serviço foi prestado, informações que definem a jurisdição tributária e a exigibilidade do ISSQN. Ainda assim, o zoneamento pode ter efeito indireto. Se o município oferece alíquota reduzida de ISSQN para empresas de determinada zona, o cadastro do prestador na prefeitura precisa refletir essa condição. Um endereço desatualizado ou uma inscrição municipal incorreta pode levar a cálculos errados ou a rejeições na emissão. Para quem integra sistemas próprios a uma API fiscal, o ponto de atenção é manter os dados cadastrais de cada empresa emissora corretos e coerentes com o cadastro municipal, já que a regra aplicada depende do que a prefeitura tem registrado. ## Como descobrir em qual zona fiscal uma empresa está? A informação costuma constar no cadastro mobiliário ou imobiliário da prefeitura, em documentos como o carnê do IPTU, o cartão de inscrição municipal ou consultas no portal do contribuinte. Quando há dúvida, o caminho é consultar a secretaria de finanças do município ou o contador responsável pela empresa. ## Exemplos de Zoneamento fiscal municipal - Uma prefeitura divide a cidade em zonas fiscais e atribui a cada uma um valor de referência por metro quadrado, usado no cálculo do IPTU dos imóveis localizados naquela região. - Um município aprova lei que reduz a alíquota de ISSQN para empresas de tecnologia instaladas em uma zona de incentivo; o software de gestão de uma dessas empresas precisa emitir a NFS-e com a alíquota correta prevista para aquela situação. - A equipe de fiscalização de uma prefeitura organiza diligências por zona fiscal para identificar prestadores de serviço que atuam sem inscrição municipal. - Um ERP que emite notas para várias filiais de uma mesma empresa atualiza o endereço de uma unidade que mudou de bairro, evitando que o cadastro municipal e os dados enviados na emissão fiquem divergentes. ## Perguntas frequentes ### Todo município tem zoneamento fiscal? Não necessariamente. Cada prefeitura define, por legislação própria, se adota zonas fiscais, quantas são e para que servem. Muitos municípios usam algum tipo de divisão territorial para o IPTU, mas os critérios variam bastante. ### A zona fiscal aparece na NFS-e? Em geral, não. A NFS-e costuma trazer o município, o endereço e a inscrição municipal do prestador. A zona fiscal fica no cadastro da prefeitura e pode influenciar regras aplicadas, como incentivos de ISSQN, sem aparecer como campo específico na nota. ### Mudar de endereço pode alterar a zona fiscal da empresa? Sim. Ao mudar de bairro ou região, a empresa pode passar para outra zona, com efeitos no IPTU ou em eventuais benefícios. Por isso, é importante atualizar o cadastro municipal e os dados usados pelo sistema emissor. ## Termos relacionados - [ISSQN](https://conota.dev/glossario/issqn.md) - [Inscrição municipal](https://conota.dev/glossario/inscricao-municipal.md) - [Jurisdição tributária](https://conota.dev/glossario/jurisdicao-tributaria.md) - [Benefício fiscal](https://conota.dev/glossario/beneficio-fiscal.md) - [Base de cálculo do ISSQN](https://conota.dev/glossario/base-de-calculo-do-issqn.md) - [Fiscalização tributária](https://conota.dev/glossario/fiscalizacao-tributaria.md) --- Fonte: [Zoneamento fiscal municipal](https://conota.dev/glossario/zoneamento-fiscal-municipal/) · Atualizado em 2026-10-22 --- # Zstandard na compressão de dados > Zstandard é um algoritmo de compressão de dados sem perdas e de código aberto que reduz o tamanho de arquivos e mensagens com alta velocidade, principalmente na descompressão. Conhecido pela sigla zstd, é usado para armazenar e transmitir grandes volumes de informação, como arquivos XML fiscais, logs e backups, ocupando menos espaço e banda. **Também conhecido como:** Zstd, ZSTD, Z Standard, Compressão zstd, zstd, Zstandard **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** Z ## O que é Zstandard, em palavras simples? Zstandard é uma forma de "espremer" dados para que ocupem menos espaço, sem perder nenhuma informação. Quando o arquivo é descomprimido, ele volta exatamente igual ao original, bit a bit. Por isso se diz que é uma compressão sem perdas. O nome costuma aparecer abreviado como zstd, e os arquivos comprimidos com ele geralmente têm a extensão .zst. Ele é software livre e está disponível em muitas linguagens de programação, sistemas operacionais e ferramentas de banco de dados e armazenamento. ## Como funciona a compressão com Zstandard? Assim como outros compressores, o Zstandard procura trechos repetidos nos dados e os substitui por referências mais curtas. Textos estruturados, como XML e JSON, têm muitas repetições, por exemplo nomes de tags e campos, e por isso costumam encolher bastante. Um diferencial é o ajuste de níveis de compressão. Níveis baixos priorizam velocidade; níveis altos gastam mais tempo para gerar arquivos menores. Em quase todos os níveis, a descompressão continua rápida, o que é útil quando os dados são gravados uma vez e lidos muitas vezes. Ele também permite usar dicionários treinados com amostras de dados parecidos. Isso ajuda a comprimir melhor arquivos pequenos e semelhantes entre si, como milhares de documentos fiscais com a mesma estrutura. ## Para que serve o Zstandard em sistemas fiscais? Empresas que emitem muitas notas acumulam grandes volumes de XML, que precisam ser guardados por anos para fins de fiscalização. Comprimir esses arquivos com Zstandard reduz o custo de armazenamento e acelera backups e cópias entre servidores. Também é comum aplicá-lo a logs de integração, exportações em lote e transferências internas entre sistemas, como entre um ERP e um serviço de arquivamento. Importante: compressão não altera o conteúdo do documento, então o XML descomprimido mantém sua assinatura digital válida. ## Qual a diferença entre Zstandard e GZip? Os dois comprimem sem perdas, mas o Zstandard, em geral, oferece uma combinação melhor de velocidade e taxa de compressão, além de mais níveis de ajuste e suporte a dicionários. O GZip é mais antigo e tem compatibilidade praticamente universal. Na prática, a escolha depende de quem vai ler os dados. Quando um padrão externo exige GZip, como ocorre em serviços de distribuição de documentos fiscais, é preciso seguir o padrão. Já em armazenamento e processos internos, a empresa tem liberdade para adotar o Zstandard. ## Quais cuidados tomar ao usar Zstandard? Antes de adotar, verifique se todos os sistemas que vão ler os arquivos têm suporte a zstd. Em APIs HTTP, a compressão só deve ser usada quando cliente e servidor a negociam pelos cabeçalhos de codificação. Também vale testar o nível de compressão com dados reais: níveis muito altos podem consumir CPU demais sem ganho relevante. Se usar dicionários, guarde-os com segurança, pois sem o dicionário correto não é possível descomprimir os arquivos. ## Exemplos de Zstandard na compressão de dados - Um ERP que emite milhares de NF-e por mês comprime os XMLs autorizados com Zstandard antes de enviá-los ao armazenamento de longo prazo, reduzindo o espaço ocupado. - Uma equipe de tecnologia compacta os logs diários de integração fiscal em arquivos .zst, facilitando a guarda e a consulta posterior durante investigações de rejeições. - Um marketplace exporta mensalmente um lote de NFC-e e CT-e para o escritório contábil em um único arquivo comprimido com zstd, acelerando a transferência. - Um time treina um dicionário Zstandard com amostras de XML de NFS-e para comprimir melhor documentos pequenos e muito parecidos entre si. ## Perguntas frequentes ### Comprimir um XML fiscal com Zstandard invalida a assinatura digital? Não. A compressão é sem perdas: ao descomprimir, o XML volta idêntico ao original, e a assinatura digital continua válida. O que não pode acontecer é alterar o conteúdo do arquivo antes ou depois da compressão. ### Posso enviar arquivos zstd para a SEFAZ ou para prefeituras? Somente se o leiaute oficial permitir. Os órgãos definem formatos e compressões aceitos, e o Zstandard não é o padrão usual nesses serviços. Ele é mais indicado para armazenamento e processos internos. ### Zstandard é gratuito? Sim. É um projeto de código aberto, com bibliotecas e ferramentas de linha de comando disponíveis gratuitamente para diversas linguagens e sistemas operacionais. ### Qual nível de compressão devo usar? Depende do objetivo. Níveis baixos servem para compressão rápida em tempo real; níveis altos, para arquivamento em que o tamanho final importa mais que o tempo. O ideal é testar com seus próprios dados. ## Termos relacionados - [GZip na distribuição de DF-e](https://conota.dev/glossario/gzip-na-distribuicao-de-df-e.md) - [Arquivo XML fiscal](https://conota.dev/glossario/arquivo-xml-fiscal.md) - [Guarda de documentos fiscais](https://conota.dev/glossario/guarda-de-documentos-fiscais.md) - [Log de integração fiscal](https://conota.dev/glossario/log-de-integracao-fiscal.md) - [HTTP](https://conota.dev/glossario/http.md) - [Latência da API fiscal](https://conota.dev/glossario/latencia-da-api-fiscal.md) --- Fonte: [Zstandard na compressão de dados](https://conota.dev/glossario/zstandard-na-compressao-de-dados/) · Atualizado em 2026-10-22