# URL da API fiscal > URL da API fiscal é o endereço na internet usado por um sistema para se comunicar com um serviço de emissão de documentos fiscais. Ela indica onde enviar requisições para emitir, consultar ou cancelar NF-e, NFS-e, NFC-e, CT-e e MDF-e, e normalmente muda conforme o ambiente, como homologação ou produção. **Também conhecido como:** URL base da API fiscal, Endereço da API fiscal, Base URL da API fiscal, Fiscal API base URL **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** U ## O que compõe a URL de uma API fiscal? Uma URL de API fiscal costuma ter algumas partes fixas. Primeiro vem o protocolo, quase sempre HTTPS, que garante que os dados trafeguem criptografados. Depois vem o domínio, que identifica o servidor do provedor da API, como em api.exemplo.com.br. Em seguida, muitas APIs incluem a versão, por exemplo /v1, para que mudanças futuras não quebrem integrações antigas. Por fim, aparece o caminho do recurso, como /nfe ou /nfse, e, quando necessário, parâmetros de consulta depois do sinal de interrogação, como ?status=autorizado. ## Qual a diferença entre URL base e endpoint? A URL base é a parte comum a todas as chamadas, como https://api.exemplo.com.br/v1. Ela funciona como o endereço do prédio. O endpoint é o caminho específico de cada operação, como o número da sala: /nfe para emitir uma nota de produto ou /nfse/{id} para consultar uma nota de serviço. Na prática, o desenvolvedor configura a URL base uma única vez e o sistema monta as chamadas juntando essa base aos endpoints. Assim, se o endereço do servidor mudar, basta alterar a configuração em um só lugar. ## Por que existem URLs diferentes para homologação e produção? A maioria das APIs fiscais oferece dois ambientes. O de homologação serve para testes: as notas emitidas ali não têm validade jurídica. O de produção é o ambiente real, onde cada documento autorizado gera efeitos fiscais e tributários. Separar os ambientes por URL, ou por credenciais distintas, evita que um teste vire uma nota verdadeira por engano. Por isso, é comum o sistema ter uma configuração que define qual URL usar, e a troca para produção só acontece depois que a integração foi validada. ## Como configurar a URL da API fiscal com segurança? O ideal é guardar a URL em uma variável de ambiente ou arquivo de configuração, e não escrevê-la diretamente no código. Isso facilita alternar entre homologação e produção sem precisar alterar e publicar o sistema novamente. Também é importante usar sempre HTTPS e nunca colocar a API Key ou outros segredos na própria URL, pois endereços costumam ficar registrados em logs e históricos. As credenciais devem ir no header de autenticação da requisição. ## Qual a diferença entre a URL da API fiscal e os endereços da SEFAZ ou da prefeitura? As SEFAZ e as prefeituras disponibilizam seus próprios endereços de web services, geralmente diferentes por estado ou município e muitas vezes baseados em SOAP e XML. Integrar diretamente com cada um exige conhecer e manter vários endereços e padrões. Uma API fiscal intermediária oferece uma URL única e padronizada, normalmente REST com JSON. O sistema do cliente fala apenas com ela, e o provedor se encarrega de encaminhar cada documento ao órgão autorizador correto e devolver o resultado. ## Exemplos de URL da API fiscal - Um ERP armazena a variável FISCAL_API_URL com o endereço de homologação durante os testes e, após validar as emissões, troca o valor para o endereço de produção. - Uma plataforma de vendas envia um POST para a URL base seguida do endpoint /nfce para emitir o cupom fiscal de uma compra no varejo. - Um software de gestão de transportadora consulta o status de um MDF-e chamando a URL base acrescida de /mdfe/{id}, onde {id} é o identificador do documento. - Uma equipe de suporte identifica que notas de teste não estavam sendo geradas porque o sistema apontava para uma URL de versão antiga da API. ## Perguntas frequentes ### Posso usar a mesma URL para testes e para emissão real? Depende do provedor. Alguns usam URLs diferentes para cada ambiente; outros usam a mesma URL e diferenciam pelo tipo de credencial. Consulte a documentação da API para saber qual regra se aplica. ### O que acontece se eu errar a URL da API fiscal? A requisição falha, geralmente com erro de conexão ou código HTTP 404, indicando recurso não encontrado. Nenhum documento é emitido. Verifique domínio, versão e caminho do endpoint. ### Onde encontro a URL da API fiscal? Ela fica na documentação técnica do provedor, frequentemente publicada em formato OpenAPI ou em uma página de referência da API, junto com a lista de endpoints disponíveis. ## Termos relacionados - [Endpoint de API](https://conota.dev/glossario/endpoint-de-api.md) - [Ambiente de homologação](https://conota.dev/glossario/ambiente-de-homologacao.md) - [Ambiente de produção](https://conota.dev/glossario/ambiente-de-producao.md) - [HTTPS](https://conota.dev/glossario/https.md) - [Query parameter](https://conota.dev/glossario/query-parameter.md) - [API fiscal](https://conota.dev/glossario/api-fiscal.md) --- Fonte: [URL da API fiscal](https://conota.dev/glossario/url-da-api-fiscal/) · Atualizado em 2026-10-22