Instabilidade na assinatura digital com multidocumentos na jornada do By Unico

Update timeline

1. identified Feb 05, 2026, 08:28 PM UTC

   Impacto O incidente afetou diretamente a experiência do assinante final. Durante o período de impacto, 100% dos envelopes contendo múltiplos documentos apresentaram erro no momento da submissão da assinatura. Período: De 02/02 às 10h até 04/02 às 18h.Volume de Impacto: Foram registradas 17.381 tentativas de assinatura que falharam devido a este comportamento.Escopo: O erro ocorreu exclusivamente no funil de assinatura (interface do usuário) para qualquer cliente que utilizasse jornadas multidocumentos. Causa Raiz A investigação técnica identificou um erro de lógica no processamento de dados do back-end após uma atualização de sistema realizada na manhã de segunda-feira (02/02). O bug causava uma divergência na comunicação com o front-end: o sistema sinalizava incorretamente que todos os documentos do envelope já haviam sido lidos e aceitos pelo assinante, sem que o evento de aceite real fosse registrado. No momento da submissão final, a camada de validação de segurança bloqueava a transação por detectar a ausência desses aceites obrigatórios, resultando em erro para o usuário. Compromisso Unico: Lamentamos o impacto causado aos assinantes e à fluidez dos negócios de nossos clientes. A transparência sobre nossas falhas é o que nos permite fortalecer nossos processos e garantir um ambiente cada vez mais robusto. Atenciosamente, Equipe Unico

2. resolved Feb 05, 2026, 08:29 PM UTC

   Relatório Pós-Incidente: Falha na Finalização de Assinaturas Multidocumentos Resumo Executivo Entre os dias 02 e 04 de fevereiro de 2026, identificamos uma instabilidade que afetou usuários em jornadas de assinatura digital. O incidente impediu a conclusão de assinaturas em envelopes que continham dois ou mais documentos. O fluxo de assinatura para envelopes com documento único permaneceu operacional e não houve impacto na criação de novos processos via API. A correção foi aplicada através de um rollback de versão, normalizando o serviço integralmente. Impacto O incidente afetou diretamente a experiência do assinante final. Durante o período de impacto, 100% dos envelopes contendo múltiplos documentos apresentaram erro no momento da submissão da assinatura. Período: De 02/02 às 10h até 04/02 às 18h.Volume de Impacto: Foram registradas 17.381 tentativas de assinatura que falharam devido a este comportamento.Escopo: O erro ocorreu exclusivamente no funil de assinatura (interface do usuário) para qualquer cliente que utilizasse jornadas multidocumentos. Causa Raiz A investigação técnica identificou um erro de lógica no processamento de dados do back-end após uma atualização de sistema realizada na manhã de segunda-feira (02/02). O bug causava uma divergência na comunicação com o front-end: o sistema sinalizava incorretamente que todos os documentos do envelope já haviam sido lidos e aceitos pelo assinante, sem que o evento de aceite real fosse registrado. No momento da submissão final, a camada de validação de segurança bloqueava a transação por detectar a ausência desses aceites obrigatórios, resultando em erro para o usuário. Resolução e Ações Corretivas Assim que a causa raiz foi isolada e vinculada à última atualização, a equipe de engenharia executou um rollback imediato para a versão estável anterior. Ação de Contorno: Reversão da versão de produção concluída às 18h do dia 04/02.Medida Preventiva: Estamos reforçando nossas camadas de testes de integração e validação de jornadas ponta a ponta (e2e), com foco específico em cenários de múltiplos documentos, para garantir que falhas de sincronia entre serviços sejam detectadas antes de qualquer deploy em ambiente produtivo. Compromisso Unico: Lamentamos o impacto causado aos assinantes e à fluidez dos negócios de nossos clientes. A transparência sobre nossas falhas é o que nos permite fortalecer nossos processos e garantir um ambiente cada vez mais robusto. Atenciosamente, Equipe Unico

3. postmortem Feb 25, 2026, 11:36 AM UTC

   # Postmortem: Instabilidade na assinatura digital com multidocumentos na jornada do By Unico ## Resumo Na segunda-feira, 2 de fevereiro de 2026, uma atualização de rotina na plataforma de assinaturas digitais introduziu um comportamento inesperado que impedia a conclusão de envelopes contendo mais de um documento. O incidente foi identificado e mitigado através da reversão da atualização \(rollback\), restabelecendo a estabilidade total do serviço. ## Impacto O incidente afetou usuários que tentavam realizar assinaturas em fluxos que envolviam múltiplos arquivos em um único envelope. ‌ * **Duração do Impacto:** Aproximadamente 56 horas entre a implantação e a mitigação. * **Volume de Erros:** Foram registrados 17.381 erros de validação durante o processo de tentativa de assinatura. * **Experiência do Usuário:** O sistema permitia incorretamente que o usuário avançasse para a etapa final de assinatura sem o aceite formal de todos os documentos, resultando em uma falha de "pré-condição" no momento da submissão. ## Causa Raiz A falha foi originada por um erro na lógica de processamento de dados do backend na versão implantada. ‌ * **Falha de Comunicação Interna:** O sistema passou a retornar apenas os eventos de aceite relativos ao primeiro documento do envelope, ignorando os demais. * **Inconsistência na Interface:** Devido a essa resposta incompleta do servidor, a interface do usuário \(front-end\) interpretava erroneamente que todos os documentos já haviam sido aceitos. * **Erro de Validação:** Como o aceite real não havia ocorrido para todos os itens, o motor de regras de segurança bloqueava a finalização da assinatura para garantir a conformidade e integridade do processo. ## Resolução Após a identificação do padrão de erros em envelopes multi-documentos, a equipe de engenharia optou pelo **rollback imediato** para a versão estável anterior. ‌ * **Início do Impacto:** 02/02/2026 às 10:00. * **Identificação:** 04/02/2026 às 16:20. * **Correção \(Rollback\):** 04/02/2026 às 18:00. ## Lições Aprendidas ‌ * **Refinamento de Monitoramento:** Identificamos a necessidade de melhorar os indicadores de nível de serviço \(SLIs\) especificamente para os métodos de assinatura, permitindo uma detecção mais rápida de anomalias em fluxos complexos. * **Testes de Regressão:** O incidente destacou a importância de ampliar a cobertura de testes automatizados para cenários que envolvam múltiplos documentos, garantindo que a paridade de dados entre backend e frontend seja validada em todas as condições. * **Visibilidade de Erros de Validação:** A análise dos logs de erro foi fundamental para isolar a causa raiz, reforçando o valor de manter logs detalhados e estruturados para diagnósticos rápidos. Estamos comprometidos com a estabilidade de nossos ambientes e atuaremos nas ações preventivas, mitigando impactos similares no futuro. Agradecemos a compreensão e estamos à disposição para esclarecer quaisquer dúvidas.