A API DIGISAN opera em produção com suporte a emissão em ambiente de homologação da SEFAZ diretamente pelo body da requisição. A autenticação é a mesma nos dois casos; o que muda é o atributo ambiente no payload e o efeito fiscal das operações.Endereço do servidor#
| Ambiente | URL base |
|---|
| Produção | https://api.digisan.com.br |
Todas as rotas documentadas neste portal usam o prefixo /api/v1. Exemplo: https://api.digisan.com.br/api/v1/nfe.
Homologação da SEFAZ (NF-e e NFC-e)#
A DIGISAN não possui um ambiente de sandbox separado. Para NF-e e NFC-e, a escolha entre produção e homologação da SEFAZ é feita diretamente no body da requisição pelo atributo ambiente:| Valor | Descrição |
|---|
1 | Produção — emite documento com validade fiscal e tributária |
2 | Homologação — emite documento de teste sem validade fiscal |
Exemplo — emitindo NF-e em homologação#
Documentos emitidos com ambiente: 2 não têm validade fiscal nem tributária. Use esse modo apenas para testes de integração. Para NFS-e, o ambiente de homologação não está disponível.
SSL / TLS#
Verifique na sua linguagem ou runtime se é necessária alguma configuração extra para HTTPS — versão mínima de TLS, trust store, etc. Em alguns ambientes, especialmente Java, pode ser preciso importar a cadeia de certificados da autoridade certificadora no truststore.Para inspecionar o certificado do servidor em produção, use no Linux ou macOS:Copie cada bloco entre -----BEGIN CERTIFICATE----- e -----END CERTIFICATE----- para arquivos separados e importe-os no keystore que sua aplicação utiliza.
Próximo passo: entenda como acompanhar o status das emissões em tempo real com Webhooks