1. Getting Started
DIGISAN
  • Getting Started
    • Introdução
    • Ambiente
    • Autenticação
    • Certificado Digital
    • Exemplo de requisições
    • Reforma Tributária
    • Suporte e SLA
  • Webhooks
    • Eventos disponíves
    • Cadastra webhook
      POST
    • Atualiza o cadastro de webhook
      PUT
    • Ativa/desativa um webhook
      PUT
    • Retorna os dados do webhook cadastrado
      GET
    • Lista histórico de webhooks enviados
      GET
  • Empresas
    • Cadastro de emitente/prestador
      POST
    • Atualização de emitente/prestador
      PUT
    • Obtém um emitente/prestador por CNPJ
      GET
    • Upload do certificado digital do emitente/prestador em multipart-form-data.
      POST
    • Deleta o certificado digital do emitente/prestador
      DELETE
  • NFSe
    • Emitir nota de serviço
      POST
    • Baixar XML da nota
      GET
    • Baixar PDF da nota
      GET
    • Consulta nota pelo ID
      GET
    • Solicitar cancelamento da nota
      POST
    • Consulta dados de um município homologado para emissão de NFSe
      GET
    • Consulta municípios homologados para emissão de NFSe
      GET
  • NFe
    • Emitir nota de produto
    • Baixar XML da nota
    • Baixar PDF da nota
    • Consulta nota pelo ID
    • Solicitar Carta de Correção
    • Solicitar cancelamento da nota
    • Inutilizar numeração de nota fiscal (NF-e)
  • NFC-e
    • Emitir nota de consumidor
    • Consulta nota pelo ID
    • Baixar XML da nota
    • Baixar PDF da nota
    • Solicitar cancelamento da nota
    • Inutilizar numeração de nota fiscal (NFC-e)
  • CT-e (Beta)
    • Emitir conhecimento de transporte eletrônico
    • Consulta CT-e pelo ID
    • Baixar XML do CT-e
    • Baixar PDF do DACTE
    • Solicitar Carta de Correção do CT-e
    • Solicitar cancelamento do CT-e
  • CT-e OS (Beta)
    • Emitir CT-e OS
    • Consulta CT-e OS pelo ID
    • Baixar XML do CT-e OS
    • Baixar PDF do DACTE OS
    • Solicitar Carta de Correção do CT-e OS
    • Solicitar cancelamento do CT-e OS
  • MDF-e (Beta)
    • Solicitar inclusão de DF-e no MDF-e
    • Solicitar inclusão de condutor no MDF-e
    • Solicitar encerramento do MDF-e
    • Solicitar cancelamento do MDF-e
    • Emitir Manifesto Eletrônico de Documentos Fiscais
    • Baixar XML do manifesto
    • Baixar PDF do manifesto
    • Baixar XML da última inclusão de DF-e do MDF-e
    • Baixar PDF da última inclusão de DF-e do MDF-e
    • Baixar XML da última inclusão de condutor do MDF-e
    • Baixar PDF da última inclusão de condutor do MDF-e
    • Baixar XML de encerramento do MDF-e
    • Baixar PDF de encerramento do MDF-e
    • Consulta MDF-e pelo ID
  • Raiz
  • Esquemas
    • Schemas
      • Mensagem
      • Resposta
      • ObterWebhookResponseDTO
    • Raiz
    • NovoWebhookDTO
    • WebhookResponseDTO
    • AtivarEDesativarWebHookDTO
    • AlterarCompanhiaInput
    • EnderecoCompanhia
    • CadastrarEmpresaOutput
    • CancelarNFSe
    • Endereco
    • IBSCBS do Servico
    • Municipio
    • NFSe
    • NFSeIbptDTO
    • Pais
    • Prestador
    • Servico
    • ServicoInformacaoExterior
    • Tomador
    • deducao
    • obra
    • servicoAtividadeEvento
    • tributacaoTotal
    • tributacaoTotalConteudo
    • Evento
    • InutilizarDTO
    • NumeracaoDTO
    • CBS
    • CBS Total
    • Emitente
    • Frete
    • IBS Município
    • IBS Total
    • IBS UF
    • IBSCBS Total
    • IBSCBS do Item
    • ICMS
    • IPI
    • Imposto
    • Item
    • NFe
    • NFeAjusteCompetenciaDTO
    • NFeApropriacaoCreditoPresumidoIbsZfmDTO
    • NFeCompraGovernamentalDTO
    • NFeCreditoPresumidoDTO
    • NFeCreditoPresumidoOperacaoDTO
    • NFeDuplicataDTO
    • NFeEstornoCreditoDTO
    • NFeFaturaDTO
    • NFeItemDFeReferenciadoDTO
    • NFeItemISDTO
    • NFeMonofasicoDTO
    • NFeMonofasicoDiferimentoDTO
    • NFeMonofasicoPadraoDTO
    • NFeMonofasicoRetencaoDTO
    • NFeMonofasicoRetidoDTO
    • NFePagamentoAntecipadoDTO
    • NFeReferenciada
    • NFeRetencaoICMSTransporteDTO
    • NFeTransferenciaCreditoDTO
    • NFeVeiculoDTO
    • NFeVolumeDTO
    • Pagamento
    • Total
    • Transportadora
    • Destinatario NFCe
    • NFCe
    • MDFeInclusaoDFe
    • MDFeInclusaoDFeDocumento
    • MDFeInclusaoCondutor
    • MDFeEncerramento
    • MDFeEncerramentoEvento
    • MDFeEvento
    • MDFeInclusaoCondutorEvento
    • MDFeInclusaoDocumentoFiscalEvento
    • CargaLotacao
    • DocumentoCTe
    • DocumentoMDFe
    • DocumentoNFe
    • EmbarcacaoCombinada
    • EntregaParcial
    • LocalizacaoCarga
    • MDFETotalizadores
    • MDFe
    • MDFeAereo
    • MDFeAquaviario
    • MDFeAutorizadoXml
    • MDFeCiot
    • MDFeComponentePagamento
    • MDFeCondutor
    • MDFeContratante
    • MDFeContrato
    • MDFeDadosBancarios
    • MDFeDispositivoValePedagio
    • MDFeEmitente
    • MDFeFerroviario
    • MDFeInformacoesANTT
    • MDFeInformacoesModal
    • MDFeMunicipioCarregamento
    • MDFeMunicipioDescarregamento
    • MDFePagamentoContrato
    • MDFeParcelaPagamento
    • MDFeProdutoPerigoso
    • MDFeProdutoPredominante
    • MDFeProprietarioVeiculo
    • MDFeResponsavelTecnico
    • MDFeRodoviario
    • MDFeSeguro
    • MDFeUnidadeCarga
    • MDFeUnidadeTransporte
    • MDFeValePedagio
    • MDFeVeiculoReboque
    • MDFeVeiculoTracao
    • TerminalCarregamento
    • TerminalDescarregamento
    • Trem
    • UnidadeVazia
    • Vagao
    • CadastrarCompaniaInput
    • CTeEvento
    • Correcao
    • CTeCobranca
    • CTeComponenteValor
    • CTeCompraGovernamental
    • CTeContainer
    • CTeCreditoPresumido
    • CTeDevolucaoTributo
    • CTeDiferimento
    • CTeDocumentoNFe
    • CTeDocumentosOriginarios
    • CTeDuplicata
    • CTeEmitente
    • CTeFatura
    • CTeFerrovia
    • CTeIBSCBS
    • CTeICMS
    • CTeImposto
    • CTeInformacoesCarga
    • CTeInformacoesModal
    • CTeLacre
    • CTeModalAereo
    • CTeModalAquaviario
    • CTeModalDutoviario
    • CTeModalFerroviario
    • CTeModalMultimodal
    • CTeModalRodoviario
    • CTeOS
    • CTeOSDocumentoReferenciado
    • CTeOSFretamento
    • CTeOSInformacoesServico
    • CTeOSModalRodoviario
    • CTeOSProprietarioVeiculo
    • CTeOSVeiculo
    • CTeOrdemColeta
    • CTeOutroDocumento
    • CTeParticipante
    • CTeProdutoPerigoso
    • CTeQuantidadeCarga
    • CTeReducaoAliquota
    • CTeSeguro
    • CTeTomador
    • CTeTributacaoRegular
    • CTeTributoCompartilhado
    • CTeTributosFederais
    • CTeVagao
    • CTeValePedagio
    • CTeValoresPrestacao
    • CTeVeiculo
    • CTeVeiculoNovo
    • CTe
    • ConsultaPaginadaHistoricoWebhookInput
    • NFSeCancelamentoDTO
    • NFSeResponseDTO
    • CidadeDTO
    • NFeCancelamentoDTO
    • NFeCartaCorrecaoDTO
    • NFeResponseDTO
    • NFCeResponseDTO
    • MDFeCancelamento
    • MDFeEncerramentoResponse
    • MDFeInclusaoCondutorResponse
    • MDFeInclusaoDFeDocumentoResponse
    • MDFeInclusaoDFeResponse
    • MDFeResponse
    • CTeCancelamentoDTO
    • CTeCartaCorrecaoDTO
    • CTeResponse
    • CTeOSResponse
  1. Getting Started

Certificado Digital

O Certificado Digital é a identificação virtual de uma empresa. Assim como o CPF e RG representam a identidade de uma pessoa física, o Certificado Digital é representado pelo e-CNPJ (CNPJ eletrônico) para pessoa jurídica. Pessoas físicas também podem obter o documento — neste caso, o certificado adquirido é o e-CPF (CPF eletrônico).

Tipos de Certificado Digital#

Para emissão de notas através da API DIGISAN, você precisará do certificado A1. Existem 4 tipos de Certificado Digital:
A1 — certificado digital em forma de arquivo guardado no computador
A3 — certificado digital em forma de cartão ou token criptográfico
S3 — certificado digital de sigilo e confidencialidade
T3 — certificado tipo "T", chamado de Carimbo do Tempo, atesta temporalidade de eventos ocorridos dentro de determinado prazo
Os mais comuns são o A1 e o A3. O A1 é baixado pelo cliente e usado diretamente no computador. O A3 é entregue em cartão ou token pela autoridade reguladora.
Importante: O certificado digital é pago. Para adquirir qualquer modelo junto a uma Autoridade Certificadora, o interessado deverá optar por um plano de pagamento oferecido pela empresa. Cada AC pratica valores diferentes — pesquise e encontre o modelo mais adequado ao seu perfil.

Vantagens do Certificado Digital#

Muitas empresas obtêm o Certificado Digital principalmente para emitir nota fiscal, mas o arquivo vai além dessa finalidade. Ele também autentica atividades operacionais, financeiras e administrativas da empresa.
Principais benefícios:
Aplicações no comércio eletrônico
Assinatura de contratos digitais
Realização de operações bancárias
Assinatura de notas fiscais eletrônicas
Acesso ao sistema de notas fiscais pela internet

Obrigatoriedade do Certificado Digital#

Empresas que desejam emitir notas fiscais via API são obrigadas a ter um certificado digital. Além do uso na emissão de documentos fiscais eletrônicos, o certificado é exigido em diversas outras situações junto ao fisco e a órgãos públicos.

Certificado Digital e NF-e#

O Certificado Digital é utilizado para dar validade jurídica às Notas Fiscais Eletrônicas, garantindo a autenticidade e integridade do documento emitido. Ter o certificado digital para emissão de nota fiscal eletrônica agiliza tarefas como o envio e despacho de mercadorias, além de reduzir custos operacionais.

Como adquirir um Certificado Digital para emitir nota fiscal eletrônica?#

O Certificado Digital usado na emissão de nota fiscal eletrônica é do tipo A1, e deve ser adquirido através de empresas chamadas de Autoridades Certificadoras (AC).
Toda AC é credenciada junto ao Instituto Nacional de Tecnologia da Informação (ITI) e tem como função ser uma terceira parte confiável, gerando e assinando documentos eletrônicos para garantir a autenticidade junto ao governo.
Você pode obter seu Certificado e-CNPJ A1 com desconto clicando aqui.

Como enviar o certificado A1 para a DIGISAN#

Com o arquivo .pfx em mãos, faça o upload diretamente via API usando o endpoint Upload do certificado digital do emitente/prestador em multipart-form-data..
Atenção: a senha do certificado é sensível. Nunca a exponha em logs, repositórios ou variáveis de ambiente sem criptografia.

Como exportar .pfx no Windows#

Se você não sabe exportar o arquivo pfx instalado no Windows utilize o Guia: Como exportar pfx no Windows

Como exportar .pfx no Mac#

1.
Abra o “Finder” no seu MAC;
2.
Acesse a pasta Application" em seguida;
3.
Acesse a pasta "Utilities";
4.
Abra o "Access Keys";
5.
Clique em "Login";
6.
Clique em "Meus certificados";
7.
Selecione o certificado que deseja exportar;
8.
Sobre o certificado A1 pressione a tecla "control" e clique sobre o certificado a ser exportado;
9.
Selecione a opção export "nome do certificado";
10.
Nomeie o arquivo e indique o local para exportação;
11.
Ao clicar em "Save", será solicitado uma senha para o certificado e em seguida a senha do computador;
12.
Após a exportação, confira o arquivo no local indicado.
Modificado em 2026-05-21 14:13:18
Página anterior
Autenticação
Próxima página
Exemplo de requisições
Built with