Aparência
Integrador ISP
Onde fica: Menu › Loja de Plugins › Integrador ISPDesde a v3.5.0
O ASSINA consulta o Integrador ISP a cada minuto atrás das O.S. de assinatura, recebe o contrato já preenchido, cria o documento e devolve o link. Quando o cliente assina, o ASSINA avisa o ISP e a O.S. conclui sozinha.
Antes de começar
Observação
O contrato assinado fica guardado no ASSINA. O ISP não guarda cópia: quando alguém abre o contrato na aba Arquivos do cliente, o ISP busca o PDF aqui na hora.
Pré-requisitos: ser administrador; responsável e testemunha cadastrados; no ISP, uma chave de API com as permissões leitura e assinatura e o assunto de O.S. marcado como O.S. de assinatura digital.
Passo a passo
- Abra a ficha em Loja de Plugins › Integrador ISP › Configurar.
- Aba Integração. Ligue a integração, informe o Endereço do ISP e a Chave da API do ISP (o ícone de olho revela). Clique em Testar conexão: o resultado mostra a versão do ISP, as permissões e as filiais.
- Aba Assinatura de contrato. Escolha o Representante e a Testemunha da empresa. Os dois são obrigatórios e carimbam todos os documentos vindos do ISP.
- Aba Acesso do ISP. Copie a Chave de API do ASSINA (X-API-Key) e cole no ISP, em Loja de Plugins › ASSINA. Preencha a URL do webhook e o Segredo do webhook (é o aviso de volta, de "o cliente assinou").
- Clique em Salvar integração ISP.
Regras que a tela aplica
Atenção
Sem Representante e Testemunha, a rotina não roda. O cartão só diz Em operação quando a ida (a chave do ISP) e a volta (o aviso de assinatura) estão de pé; sem a volta, o ISP nunca fica sabendo da assinatura. Gerar nova chave invalida a anterior na hora.
- Ao ligar, a rotina Polling do Integrador ISP é ligada sozinha; ao desligar, pausa. Veja Rotinas automáticas.
- A O.S. pode ter vários signatários, cada um com o seu link (desde a v3.7.0). Exemplo: troca de titularidade, com titular anterior e novo titular. O documento só conclui, e o ISP só é avisado, quando todos assinam.
- Documento do ISP assina em paralelo, mesmo com assinatura sequencial ligada.
- Regerar link de assinatura (no ISP) troca o contrato do documento e renova o prazo de todos, mantendo os mesmos links. Não vale para documento já assinado ou com assinatura em andamento.
O que acontece depois
O documento aparece em Todos os documentos. Falha de entrega ao ISP marca Falha no envio ao ISP e libera o botão Reenviar ao ISP.
Perguntas frequentes
O teste deu OK, mas nada chega. Confira se o assunto da O.S. está marcado como assinatura digital no ISP.
Posso usar o ISP e o IXC juntos? Cada um tem a sua ficha e a sua rotina.