# Ambiente de produção > Ambiente de produção é o ambiente oficial dos sistemas fiscais em que os documentos emitidos, como NF-e, NFS-e, NFC-e, CT-e e MDF-e, têm validade jurídica e efeitos tributários reais. Tudo o que é autorizado nele é registrado pela Secretaria da Fazenda ou pela prefeitura e gera obrigações para o emitente. **Também conhecido como:** Ambiente produtivo, Ambiente real, Produção, Production environment **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** A ## O que é o ambiente de produção na emissão fiscal? Na emissão de documentos fiscais eletrônicos, os órgãos autorizadores mantêm dois ambientes separados: um para testes e outro para uso real. O ambiente de produção é o real. Quando uma nota é autorizada nele, ela passa a existir oficialmente, com validade jurídica, e entra nos registros do fisco. Isso significa que a nota pode ser consultada pelo destinatário, gera tributos a recolher e precisa ser escriturada pela empresa. Não se trata de uma simulação: cada documento conta de verdade. ## Qual a diferença entre ambiente de produção e ambiente de homologação? O ambiente de homologação serve para testes. Nele, a empresa ou o desenvolvedor envia documentos para verificar se a integração funciona, se os dados estão corretos e como o sistema reage a rejeições. Os documentos emitidos ali não têm valor fiscal. No ambiente de produção, ao contrário, tudo tem efeito real. Por isso, o caminho recomendado é validar a integração primeiro em homologação e só depois passar a emitir em produção. Nos documentos eletrônicos, essa escolha costuma aparecer em um campo do próprio XML que indica o tipo de ambiente, e os endereços de envio também costumam ser diferentes. ## Quais cuidados tomar antes de emitir em produção? Antes de virar a chave, é importante conferir se o certificado digital está válido e corretamente cadastrado, se a empresa está habilitada como emitente junto ao estado ou ao município e se dados como CFOP, CST ou CSOSN e alíquotas estão configurados de acordo com a orientação contábil. Também vale testar em homologação os cenários mais comuns da operação, como vendas, devoluções e cancelamentos, além do tratamento de rejeições. Um erro em produção pode exigir cancelamento, carta de correção ou nova emissão, o que dá trabalho e pode ter prazos limitados. ## Como funciona o ambiente de produção em uma API fiscal? Em uma API fiscal, o ambiente geralmente é definido por configuração, por exemplo com credenciais ou chaves de API distintas para teste e para produção. Assim, o mesmo código de integração pode apontar para um ambiente ou outro sem grandes mudanças. No Conota, o sistema do cliente envia os dados da venda pela API e a plataforma acompanha o documento até a autorização no ambiente indicado, devolvendo XML, PDF e status. A disponibilidade de cada ambiente pode variar conforme o tipo de documento e o município, algo importante especialmente na NFS-e. ## É possível desfazer uma nota emitida em produção? Uma nota autorizada em produção não pode simplesmente ser apagada. O que existe são procedimentos previstos na legislação, como o cancelamento dentro do prazo permitido, a carta de correção para alguns tipos de erro ou a emissão de um documento de devolução ou estorno. As regras e prazos variam conforme o tipo de documento e o órgão autorizador. ## Exemplos de Ambiente de produção - Um ERP que acabou de concluir os testes de emissão de NF-e em homologação troca a configuração para o ambiente de produção e começa a emitir as notas reais de venda dos clientes. - Uma plataforma de e-commerce usa uma chave de API de testes durante o desenvolvimento e, no lançamento, passa a usar a chave de produção para que as NFC-e e NF-e emitidas tenham validade fiscal. - Uma transportadora emite um CT-e no ambiente de produção e percebe um erro no valor do frete; como o documento já é oficial, ela precisa seguir o procedimento de cancelamento ou correção previsto. - Uma software house mantém dois cadastros no Console da plataforma fiscal: um para homologação, onde roda testes automatizados, e outro para produção, onde ficam as emissões reais dos clientes. ## Perguntas frequentes ### Nota emitida em homologação vale como nota fiscal? Não. Documentos emitidos em homologação servem apenas para testes e não têm validade jurídica nem efeito tributário. Somente as notas autorizadas no ambiente de produção são oficiais. ### Preciso de certificado digital para emitir em produção? Na maioria dos documentos fiscais eletrônicos, sim. O XML precisa ser assinado com um certificado digital válido, geralmente do tipo A1 em integrações por API. Algumas prefeituras podem ter regras próprias para a NFS-e. ### Posso testar algo diretamente em produção? Não é recomendado. Qualquer documento autorizado em produção gera efeitos reais e pode precisar ser cancelado depois. Testes devem ser feitos no ambiente de homologação. ### Todos os municípios oferecem ambiente de produção e homologação para NFS-e? Nem sempre. Alguns municípios não disponibilizam ambiente de testes ou o oferecem com limitações. Por isso, é importante verificar a disponibilidade de cada município antes de planejar a integração. ## Termos relacionados - [Ambiente de homologação](https://conota.dev/glossario/ambiente-de-homologacao.md) - [API fiscal](https://conota.dev/glossario/api-fiscal.md) - [Autorização de uso da NF-e](https://conota.dev/glossario/autorizacao-de-uso-da-nf-e.md) - [Certificado digital A1](https://conota.dev/glossario/certificado-digital-a1.md) - [Cancelamento de documento fiscal](https://conota.dev/glossario/cancelamento-de-documento-fiscal.md) - [API Key](https://conota.dev/glossario/api-key.md) --- Fonte: [Ambiente de produção](https://conota.dev/glossario/ambiente-de-producao/) · Atualizado em 2026-10-22