O botão Assinar é a parte fácil. O seu portal sabe qual foi o documento realmente aceite?

Uma empresa de serviços em Lisboa envia uma proposta pelo portal do cliente. Durante a revisão, altera o preço e acrescenta uma condição. O cliente tinha deixado a versão anterior aberta e conclui a assinatura nessa janela. O sistema recebe uma confirmação técnica. A equipa comercial vê “assinado”, mas ainda precisa de perceber a que proposta essa palavra se refere.

É neste ponto que a integração de assinatura digital se torna um projeto de software. O botão pode ser simples; a ligação entre documento, signatário, versão e próxima ação do negócio precisa de ser explícita. Para uma empresa portuguesa, a Chave Móvel Digital pode integrar esse percurso, desde que a adesão e as capacidades necessárias estejam confirmadas.

Defina o objeto da assinatura antes de escolher a interface

Descreva exatamente o que a pessoa está a assinar: uma proposta, um termo, uma autorização ou um conjunto de documentos. Registe também quem pode preparar esse conteúdo e em que momento deixa de poder ser alterado. Um resumo apresentado no ecrã não substitui a identificação do documento que será efetivamente assinado.

Cada tentativa deve apontar para uma versão imutável. Quando o conteúdo muda, crie uma nova versão e estabeleça o que acontece às tentativas anteriores. O cliente deve conseguir reconhecer o documento, descarregá-lo quando adequado e compreender se está a retomar um processo ou a iniciar outro.

A definição de quem pode vincular uma organização e do tipo de assinatura necessário pertence às regras do negócio e à avaliação jurídica aplicável. A implementação deve executar essas decisões de forma verificável. Não deve transformar a existência de um certificado numa autorização comercial que nunca foi analisada.

A integração com CMD tem um processo de adesão

A página oficial de integração com o Autenticação.gov apresenta funcionalidades de autenticação, assinatura com CMD e atributos profissionais certificados. Indica também que a integração está disponível para entidades públicas e privadas e requer um procedimento com a entidade responsável.

Inclua essa dependência no planeamento. Antes de contratar uma data de lançamento, confirme as condições de adesão, o ambiente de testes, as interfaces disponíveis e a forma de obter os acessos. Uma demonstração do fornecedor com outro serviço de assinatura não prova que a integração pretendida já pode operar em produção.

No desenho do portal, mantenha distintos o início de sessão e o ato de assinar. Um utilizador autenticado pode navegar na sua área reservada sem ter assinado o documento apresentado. A interface deve mostrar o ponto exato do percurso e o que falta para o concluir.

Trate interrupções como acontecimentos normais

O cliente pode fechar a janela, perder a ligação ou regressar mais tarde. O serviço externo pode enviar uma notificação repetida. O portal deve conseguir reconciliar estes acontecimentos com uma tentativa identificada, sem abrir uma nova proposta ou ativar duas vezes o mesmo serviço.

Registe separadamente o pedido de assinatura, o resultado recebido, a validação e a decisão de avançar no processo comercial. Cada passagem precisa de critérios claros. Se uma resposta não corresponder ao identificador e à versão esperados, encaminhe-a para análise em vez de tentar adivinhar a correspondência.

Desenhe ainda um percurso de recuperação compreensível. A pessoa deve saber se pode retomar, se precisa de iniciar uma nova tentativa ou se a equipa já está a analisar o caso. Mostrar apenas “ocorreu um erro” cria chamadas de apoio e incentiva novas tentativas sem contexto.

Valide o resultado e conserve o contexto necessário

A documentação do Digital Signature Service da Comissão Europeia descreve validação de assinaturas e relatórios com resultados distintos, incluindo situações indeterminadas. Isso é relevante para o produto: não conseguir concluir uma verificação não é o mesmo que demonstrar que o documento foi alterado.

Defina como o portal apresenta esses resultados e quem trata as exceções. Guarde o documento e a informação necessária para relacionar a verificação com a política aplicada e o processo de origem. Os detalhes de conservação e validade devem ser acordados com os responsáveis adequados, em vez de ficarem implícitos numa biblioteca instalada.

A aplicação de demonstração DSS é apresentada como ferramenta de testes, não como serviço de produção. Uma solução para documentos de clientes precisa de infraestrutura própria ou de um serviço contratado e aprovado para essa finalidade. Use documentos sintéticos no desenvolvimento e não encaminhe ficheiros reais para demonstrações públicas por conveniência.

Teste a proposta alterada, não apenas a assinatura bem-sucedida

Na aceitação, utilize um conjunto de cenários que ligue a assinatura ao trabalho posterior:

• A proposta muda enquanto o cliente mantém a versão antiga aberta.
• A mesma notificação chega duas vezes e não duplica a ativação.
• O cliente interrompe o percurso e regressa pelo portal.
• Um resultado não corresponde ao processo esperado e fica separado para análise.
• A validação é indeterminada e existe uma ação operacional definida.
• Um colaborador autorizado exporta o documento e o respetivo contexto.

O teste deve mostrar também quem consegue consultar e descarregar os documentos. Nem todos os colaboradores que acompanham um cliente precisam de aceder ao conteúdo integral. Permissões, registos de acesso e recuperação de contas fazem parte da entrega, mesmo quando o mecanismo de assinatura vem de um serviço externo.

Um primeiro projeto com fronteiras claras

Escolha um único tipo de documento e um percurso comercial. Uma empresa de manutenção no Porto, por exemplo, pode começar pela aceitação de propostas antes da abertura de uma ordem de trabalho. O objetivo é comprovar a ligação entre a versão aceite e o serviço criado, mantendo um processo manual para exceções.

Peça ao fornecedor que separe adesão ao serviço, preparação dos documentos, integração, validação e operação. Compare com as funcionalidades já existentes no CRM ou na plataforma de documentos. O desenvolvimento à medida justifica-se quando resolve a passagem entre sistemas ou regras que as opções instaladas não cobrem.

Os nossos guias sobre integração entre sistemas comerciais e revisão de documentos em portais ajudam a delimitar o âmbito. A Innovation T desenvolve portais de clientes e integrações. Traga um documento fictício e o percurso que pretende automatizar para transformar a assinatura numa etapa verificável do seu serviço.

Perguntas frequentes

Podemos integrar a Chave Móvel Digital num portal privado?

O Autenticação.gov disponibiliza integração para os setores público e privado, incluindo assinatura com CMD. É necessário confirmar o processo de adesão, as condições e as interfaces aplicáveis junto da entidade responsável.

A confirmação da assinatura deve ativar automaticamente o serviço?

Só depois de verificar que o resultado pertence ao processo e à versão esperados e de aplicar as regras de aprovação do negócio. Uma notificação recebida ou uma assinatura tecnicamente válida não prova todos esses elementos.

Podemos usar a demonstração pública DSS para validar documentos de clientes?

A Comissão Europeia apresenta essa aplicação como demonstração para testes, não como serviço de produção. A solução deve usar uma infraestrutura de validação adequada e aprovada para os documentos tratados.