Webhooks Certyneo : automatizar o relatório contábil em ERP

Quando um documento é assinado eletronicamente via Certyneo, o que acontece a seguir em sua cadeia contábil? Para a maioria das empresas, a resposta ainda é frequentemente: nada automático. Um colaborador baixa manualmente o PDF assinado, o envia por e-mail ao contador, que o reinsere em seu software de gerenciamento. Este processo fragmentado gera erros, atrasos e uma perda de rastreabilidade incompatível com os requisitos de um relatório contábil confiável. Os webhooks Certyneo respondem precisamente a este problema: eles permitem disparar automaticamente ações em seus sistemas de terceiros — ERP, software contábil, GED — assim que um evento de assinatura ocorre. Este artigo explica em detalhes como configurar e explorar esses webhooks para fluidificar seu ciclo contábil de ponta a ponta.

O que é um webhook e por que é essencial para a contabilidade

O princípio do webhook explicado simplesmente

Um webhook é um mecanismo de notificação HTTP em tempo real: em vez de perguntar regularmente a uma API "algo mudou?" (abordagem chamada polling), é a aplicação emissora — aqui Certyneo — que envia uma requisição HTTP POST para uma URL de sua escolha assim que um evento específico ocorre. Em contabilidade, isso significa que no momento exato em que uma ordem de compra, um contrato de fornecedor ou uma nota de despesa é assinado eletronicamente, seu ERP pode ser instantaneamente notificado, sem intervenção humana.

Ao contrário de uma simples exportação CSV ou de um relatório mensal, o webhook garante uma sincronização quase em tempo real dos dados. Para um contador gerenciando encerramentos mensais ou trimestrais, essa granularidade é determinante: os documentos justificativos estão disponíveis no sistema assim que são assinados, e não no final do mês durante uma recuperação laboriosa.

Os eventos Certyneo que disparam um relatório contábil

Certyneo expõe vários tipos de eventos via webhooks, diretamente exploráveis em um contexto contábil:

• `envelope.completed` : todas as partes assinaram o documento — este é o principal disparador para injetar um documento justificativo em seu ERP.
• `envelope.declined` : um signatário recusou — útil para alertar o departamento contábil de uma fatura contestada.
• `envelope.expired` : o prazo de assinatura foi excedido — permite relançar um procedimento e evitar uma lacuna na contabilidade.
• `signer.signed` : assinatura parcial de uma parte — relevante para contratos com múltiplos signatários (ex.: contrato de aluguel exigindo a assinatura do locador e do locatário).

Cada payload JSON enviado por Certyneo contém os metadados essenciais: identificador do documento, timestamp qualificado, nomes dos signatários, URL segura para baixar o PDF assinado e a trilha de auditoria. Esses dados estruturados são diretamente exploráveis por um ERP ou software contábil.

Configuração passo a passo dos webhooks Certyneo para um ERP

Criar e registrar um endpoint webhook

A configuração de um webhook Certyneo é feita no painel, seção Configurações > Integrações > Webhooks. Aqui estão as etapas principais:

1. Definir a URL de destino : esta é a endpoint exposta por seu ERP ou seu middleware de integração (ex.: uma endpoint dedicada em SAP, Sage, Cegid ou uma ferramenta iPaaS como n8n, Make ou Zapier).
2. Selecionar os eventos a ouvir : para um relatório contábil, privilegie no mínimo `envelope.completed` e `envelope.declined`.
3. Configurar o segredo de assinatura HMAC : Certyneo assina cada payload com uma chave secreta que você define. Sua endpoint deve verificar essa assinatura para garantir a autenticidade das notificações — etapa de segurança inegociável.
4. Testar com o modo simulação : Certyneo permite enviar um payload de teste sem criar um documento real. Verifique se sua endpoint responde adequadamente com um HTTP 200.

Mapear os dados do payload para seu plano contábil

Assim que a endpoint estiver operacional, é necessário mapear os campos do payload Certyneo para os campos esperados por seu ERP. Aqui está um exemplo de lógica de mapeamento para um contrato de fornecedor:

```json { "event": "envelope.completed", "envelope_id": "env_01HX...", "completed_at": "2026-05-26T14:32:00Z", "document_url": "https://app.certyneo.com/documents/signed/...", "metadata": { "type": "contrat_fournisseur", "montant_ht": 12500, "compte_comptable": "607", "fournisseur_id": "F-2891" } } ```

O campo `metadata` é livremente configurável ao criar a envelope via API Certyneo. Esta é a chave para enriquecer cada assinatura com os dados de negócio necessários para a contabilização automática: número de conta, centro de custo, exercício contábil, etc. Para aprofundar as possibilidades de integração técnica, consulte o centro de ajuda Certyneo que lista o conjunto da documentação da API.

Gerenciar rejeitamentos e relançamentos automáticos

Um webhook pode falhar se sua endpoint estiver temporariamente indisponível. Certyneo implementa uma política de retry exponencial : em caso de ausência de resposta HTTP 2xx, o sistema tenta novamente em intervalos crescentes (5 min, 30 min, 2 h, 24 h) em uma janela de 72 horas. Além disso, o webhook é marcado como falha e um alerta é gerado no painel.

Para contabilidade, essa resiliência é crucial: um documento justificativo não recebido no ERP pode gerar uma discrepância de balanço. Portanto, é recomendável complementar o mecanismo webhook com um job de reconciliação diário que consulte a API Certyneo para listar as envelopes concluídas nas últimas 24 horas e verificar sua presença no sistema contábil.

Integração com os principais ERP e softwares contábeis

Conexão nativa com Cegid, Sage e Pennylane

Vários editores de softwares contábeis populares na França oferecem conectores ou APIs REST compatíveis com os webhooks Certyneo. Aqui estão os padrões de integração mais comuns:

Cegid XRP Flex : expõe uma API REST permitindo criar pièces contábeis e anexar arquivos. O webhook `envelope.completed` dispara uma chamada POST para a API Cegid para criar o registro e anexar o PDF assinado como justificativo digital.

Sage 100cloud / Sage 50 : a abordagem recomendada passa por um middleware leve (script Python ou Node.js hospedado em serverless) que recebe o webhook Certyneo, baixa o documento via URL segura e o deposita na pasta de importação automática do Sage.

Pennylane : solução cloud-nativa cuja API aceita diretamente documentos em anexo com seus metadados contábeis. A integração webhook-Pennylane é particularmente adequada para gabinetes de contadores que centralizam documentos de vários clientes — um caso de uso que detalhamos na seção de cenários.

Para as equipes que avaliam diferentes soluções antes de migrar para Certyneo, o comparativo de soluções de assinatura eletrônica oferece uma visão detalhada das capacidades de integração por plataforma.

Usar um iPaaS como Make ou n8n para não-desenvolvedores

Se sua organização não possui equipe técnica dedicada, as plataformas de automação no-code/low-code (Make, n8n, Zapier) constituem uma alternativa eficaz. O princípio é simples:

1. Crie um cenário com um webhook de disparo em Make ou n8n — a URL gerada funciona como endpoint Certyneo.
2. Configure as ações seguintes: download do documento assinado, análise dos metadados, envio para Google Drive / SharePoint, criação de uma linha em uma planilha de rastreamento, notificação Slack para o responsável contábil.
3. Opcionalmente, dispare uma chamada de API para seu software contábil para criar o registro.

Esta abordagem permite alcançar um alto nível de automação em menos de um dia, sem escrever uma única linha de código. É particularmente relevante para PMEs/TPEs ou para contadores que desejam automatizar a coleta de documentos para seus clientes sem mobilizar um desenvolvedor.

Boas práticas de segurança e auditoria para webhooks contábeis

Verificação de assinaturas HMAC e segurança de endpoints

Em um contexto contábil, a confiabilidade dos dados recebidos via webhook é crítica. Um atacante que conseguisse injetar falsos eventos `envelope.completed` poderia corromper sua contabilidade. Três medidas de segurança se impõem:

• Verificação HMAC-SHA256 : cada requisição Certyneo inclui um header `X-Certyneo-Signature`. Sua endpoint deve recalcular a assinatura com sua chave secreta e comparar — rejeite qualquer requisição cuja assinatura não corresponda.
• Validação do esquema JSON : antes de qualquer processamento, valide a estrutura e os tipos do payload recebido. Um campo `montant_ht` com valor `null` ou negativo deve disparar um alerta, não um registro contábil errado.
• Registro imutável : conserve cada payload recebido em um log com timestamp e não modificável por pelo menos 10 anos, em conformidade com as obrigações de conservação de documentos contábeis (artigo L123-22 do Código Comercial).

Rastreabilidade e trilha de auditoria para o contador

Uma das principais vantagens da abordagem webhook é a rastreabilidade de ponta a ponta que ela gera. Certyneo produz para cada documento assinado uma trilha de auditoria (audit trail) em conformidade com os requisitos eIDAS, incluindo o timestamp qualificado, os endereços IP dos signatários e os certificados usados.

Ao associar essa trilha de auditoria ao payload webhook, seu ERP pode armazenar não apenas o documento justificativo, mas também a prova de sua validade legal. Para um auditor independente ou um contador, essa dupla camada — documento + prova — simplifica consideravelmente as verificações durante uma auditoria ou revisão. A assinatura eletrônica na empresa detalha os níveis de assinatura e seu valor probatório em diferentes contextos de negócio.

Para calcular o retorno sobre investimento dessa automação antes de começar, o calculador de ROI da Certyneo permite estimar com precisão os ganhos de tempo e custos de acordo com seu volume de documentos assinados.

Marco legal aplicável aos webhooks e contabilidade digital

A automação da cadeia contábil via webhooks de assinatura eletrônica se inscreve em um marco regulatório preciso que convém dominar.

Regulamento eIDAS n°910/2014 (e sua revisão eIDAS 2.0) : o regulamento europeu sobre identificação eletrônica e serviços de confiança estabelece o valor jurídico das assinaturas eletrônicas. O artigo 25 dispõe que uma assinatura eletrônica não pode ter seus efeitos jurídicos recusados apenas por se apresentar sob forma eletrônica. As assinaturas qualificadas (QES) se beneficiam de uma presunção de confiabilidade equivalente à assinatura manuscrita. Para documentos contábeis, o nível apropriado de assinatura depende da natureza do documento: uma fatura simples pode recorrer a uma assinatura avançada (AES), enquanto um contrato de locação-venda ou um ato notarial eletrônico requer uma assinatura qualificada.

Código Civil, artigos 1366 e 1367 : o artigo 1366 reconhece o escrito eletrônico como prova no mesmo nível que o escrito em suporte de papel, sob reserva de que possa ser devidamente identificada a pessoa de quem emana e que seja estabelecido e conservado em condições que garantam sua integridade. O artigo 1367 define assinatura eletrônica como o uso de um procedimento confiável de identificação que garanta a ligação com o ato ao qual se anexa. O webhook Certyneo, ao transmitir a trilha de auditoria com cada documento assinado, satisfaz este requisito de identificação e integridade.

Artigo L123-22 do Código Comercial : os documentos contábeis e os documentos justificativos devem ser conservados por dez anos. Os documentos recebidos via webhook e armazenados em um ERP devem, portanto, estar sujeitos a uma política de conservação conforme, incluindo a imutabilidade e a legibilidade de longo prazo dos formatos (PDF/A recomendado pela norma ISO 19005).

RGPD n°2016/679 : os payloads webhook contêm dados de caráter pessoal (nome dos signatários, endereços de e-mail, timestamps relacionados a indivíduos). Sua endpoint e seu ERP são destinatários desses dados — você é responsável pelo tratamento ou co-responsável conforme os termos contratuais com Certyneo. O DPA (Data Processing Agreement) deve ser formalizado. Os dados transmitidos devem ser minimizados ao estritamente necessário para a finalidade contábil.

Diretiva NIS2 (2022/2555) : para empresas no escopo NIS2 (operadores de serviços essenciais, entidades importantes), a segurança das interfaces de API e webhooks constitui uma medida obrigatória de segurança de rede. A verificação HMAC, criptografia TLS 1.3 mínima e registro de acessos são obrigatórios.

Norma ETSI EN 319 132 : define o formato XAdES para assinaturas eletrônicas avançadas. As assinaturas produzidas por Certyneo respeitam essas normas ETSI, garantindo sua interoperabilidade com sistemas de arquivamento com valor probatório conformes ao referencial geral de segurança (RGS) francês.

Cenários de uso concretos

Cenário 1: um gabinete de contabilidade gerenciando 40 pastas de clientes

Um gabinete de contabilidade com aproximadamente dez colaboradores gerencia cartas de missão, mandatos SEPA e contas anuais de 40 sociedades clientes. Antes da integração dos webhooks Certyneo, cada documento assinado era recuperado manualmente por um gerenciador de pasta, renomeado conforme uma convenção de nomenclatura, e depois depositado na pasta do cliente do software de produção contábil. Este processo representava aproximadamente 15 a 20 minutos por documento, ou várias horas por semana em período de encerramento.

Após configuração de um webhook `envelope.completed` conectado à sua ferramenta GED via Make, o gabinete automatizou totalmente esta cadeia: assim que assinado, o PDF assinado é automaticamente classificado na pasta do cliente correspondente com o nome correto de arquivo, uma notificação é enviada ao gerenciador responsável, e uma linha é criada na planilha de rastreamento de documentos recebidos. O ganho de tempo estimado é da ordem de 70 a 80% nesta tarefa, ou aproximadamente 6 a 8 horas recuperadas por semana em período de balanço — um número consistente com os benchmarks publicados pela Ordem dos Contadores em seus relatórios sobre transformação digital dos gabinetes.

Cenário 2: uma PME industrial com um ERP Sage e 300 contratos de fornecedor anuais

Uma PME do setor industrial assina aproximadamente 300 contratos de fornecedor por ano (ordens-quadro, termos aditivos, acordos de confidencialidade). Cada contrato assinado deve ser anexado a uma ficha de fornecedor em Sage 100cloud e arquivado como documento justificativo de compromisso. Sem automação, o departamento de compras transmitia os contratos assinados por e-mail ao departamento contábil com atraso médio de 3 a 5 dias úteis.

Após implantação de um middleware Node.js recebendo os webhooks Certyneo e chamando a API Sage, o tempo de anexação caiu para alguns segundos. Os compromissos fora do balanço são agora contabilizados em tempo real, o que permitiu melhorar a confiabilidade das situações intermediárias apresentadas ao CFO. O projeto foi realizado em menos de duas semanas por um desenvolvedor interno, apoiando-se na documentação webhook do centro de ajuda Certyneo.

Cenário 3: um grupo de sociedades gerenciando fluxos intercompanhias complexos

Um grupo constituído de aproximadamente dez filiais usa Certyneo para assinar seus acordos de tesouraria intercompanhias e seus contratos de prestação intra-grupo. A consolidação contábil exige que cada acordo assinado seja simultaneamente registrado no sistema da filial emissora e da filial receptora, com o mesmo identificador de documento para facilitar a eliminação dos fluxos recíprocos.

Ao configurar um webhook único que notifique em paralelo as endpoints das duas filiais envolvidas (identificadas via metadados da envelope), o grupo eliminou as discrepâncias de consolidação relacionadas a documentos faltando ou mal referenciados. O prazo de encerramento consolidado foi reduzido em 2 dias em média, o que representa um ganho significativo para uma diretoria financeira que encerra trimestralmente. As equipes que consideram uma migração desde outra solução podem consultar o guia de migração para Certyneo para avaliar a viabilidade técnica.

Conclusão

Os webhooks Certyneo constituem uma alavanca poderosa de automação para qualquer ator que deseje integrar a assinatura eletrônica no cerne de seu processo contábil. Ao eliminar as etapas manuais entre a assinatura de um documento e seu registro no ERP ou software contábil, eles reduzem atrasos, erros de entrada de dados e riscos de documentos faltando durante um balanço ou auditoria. Seja um gabinete de contabilidade, uma PME ou um grupo multi-entidades, a configuração webhook é acessível — com ou sem desenvolvedor — e o retorno sobre investimento se mede a partir das primeiras semanas de uso.

Para aprofundar, consulte o centro de ajuda Certyneo para acessar a documentação completa da API e dos webhooks. Pronto para automatizar seu balanço contábil? Crie sua conta Certyneo gratuitamente e conecte seus primeiros documentos assinados ao seu ERP hoje mesmo.