Webhooks Certyneo: automatizar o balance contable en ERP

Cando un documento se asina electronicamente a través de Certyneo, que acontece despois na súa cadea contable? Para a maioría das empresas, a resposta é aínda con demasiada frecuencia: nada automático. Un colaborador descarga manualmente o PDF asinado, envíao por correo electrónico ao asesor contable, que o reintroduce no seu software de xestión. Este proceso fragmentado xera erros, atrasos e perda de trazabilidade incompatible coas esixencias dun balance contable fiable. Os webhooks Certyneo responden precisamente a este problema: permiten desencadear automaticamente accións nos seus sistemas de terceiros — ERP, software contable, GED — así que se produce un evento de sinatura. Este artigo lle explica en detalle como configurar e explotar estes webhooks para fluidificar o seu ciclo contable de extremo a extremo.

Que é un webhook e por que é esencial para a contabilidade

O principio do webhook explicado de forma sinxela

Un webhook é un mecanismo de notificación HTTP en tempo real: en lugar de solicitar regularmente a unha API "algo mudou?" (enfoque chamado polling), é a aplicación emisora — neste caso Certyneo — a que envía unha solicitude HTTP POST a un URL da súa elección así que se produce un evento específico. En contabilidade, isto significa que no momento exacto no que un pedido, un contrato de provedor ou un extracto de gastos se asina electronicamente, o seu ERP pode ser notificado instantaneamente, sen intervención humana.

A diferenza dunha simple exportación CSV ou dun informe mensual, o webhook garante una sincronización case-tempo-real dos datos. Para un asesor contable que xestiona peches mensuais ou trimestrais, esta granularidade é determinante: as pezas xustificativas están dispoñibles no sistema así que se asinen, e non a fin de mes cando se fai un axuste laborioso.

Os eventos Certyneo que desencadean un balance contable

Certyneo expón varios tipos de eventos a través de webhooks, directamente explotables nun contexto contable:

• `envelope.completed`: todas as partes asinaron o documento — este é o desencadeador principal para inxectar unha peza xustificativa no seu ERP.
• `envelope.declined`: un asinante rexeitou — útil para alertar ao servizo contable dunha factura contestada.
• `envelope.expired`: o prazo de sinatura foi superado — permite relanzar un procedemento e evitar un burato na contabilidade.
• `signer.signed`: sinatura parcial dunha parte — pertinente para contratos multiasinantes (ex.: arrendamento comercial que require a sinatura do propietario e do arrendatario).

Cada payload JSON enviado por Certyneo contén os metadatos esenciais: identificador do documento, marca de tempo cualificada, nomes dos asinantes, URL segura para descargar o PDF asinado e a pista de auditoría. Estos datos estruturados son directamente explotables por un ERP ou un software contable.

Configuración paso a paso dos webhooks Certyneo para un ERP

Crear e rexistrar un endpoint webhook

A configuración dun webhook Certyneo realízase desde o panel de control, sección Parámetros > Integracións > Webhooks. Aquí están os pasos clave:

1. Definir o URL de destino: este é o endpoint exposto polo seu ERP ou o seu middleware de integración (ex.: un endpoint dedicado en SAP, Sage, Cegid ou unha ferramenta iPaaS como n8n, Make ou Zapier).
2. Seleccionar os eventos a escoitar: para un balance contable, privilexie como mínimo `envelope.completed` e `envelope.declined`.
3. Configurar o secreto de sinatura HMAC: Certyneo asina cada payload coa chave secreta que define. O seu endpoint debe verificar esta sinatura para garantir a autenticidade das notificacións — paso de seguridade non negociable.
4. Probar co modo simulación: Certyneo permite enviar un payload de proba sen crear un documento real. Verifique que o seu endpoint responde ben cun HTTP 200.

Mapear os datos do payload ao seu plan contable

Unha vez que o endpoint está operativo, cómpre mapear os campos do payload Certyneo aos campos esperados polo seu ERP. Aquí está un exemplo de lóxica de mapeo para un contrato de provedor:

```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": "contrato_provedor", "montant_ht": 12500, "cuenta_contable": "607", "provedor_id": "F-2891" } } ```

O campo `metadata` é libremente configurábel cando se crea o sobre a través da API Certyneo. Esta é a clave para enriquecer cada sinatura cos datos de negocio necesarios para a contabilización automática: número de conta, centro de custo, exercicio contable, etc. Para profundar nas posibilidades de integración técnica, consulte o centro de axuda Certyneo que recorda o conxunto da documentación API.

Xestionar as rexeicións e os relanzamentos automáticos

Un webhook pode fallar se o seu endpoint non está dispoñible temporalmente. Certyneo implementa unha política de reintento exponencial: en caso de ausencia de resposta HTTP 2xx, o sistema reintenta o envío a intervalos crecentes (5 min, 30 min, 2 h, 24 h) nunha ventá de 72 horas. Máis aló, o webhook está marcado en falla e unha alerta aparece no panel de control.

Para a contabilidade, esta resiliencia é crucial: unha peza xustificativa non recibida no ERP pode xerar un desequilibrio de balance. Por iso recoméndase complementar o mecanismo webhook cun traballo de reconciliación diaria que consulta a API Certyneo para listar os sobres completados nas últimas 24 horas e verificar a súa presenza no sistema contable.

Integración cos principais ERP e softwares contables

Conexión nativa con Cegid, Sage e Pennylane

Varios editores de softwares contables populares en Francia ofrecen conectores ou APIs REST compatibles cos webhooks Certyneo. Aquí están os patróns de integración máis comúns:

Cegid XRP Flex: expón unha API REST que permite crear pezas contables e adxuntar ficheiros. O webhook `envelope.completed` desencadea unha chamada POST á API Cegid para crear a entrada e adxuntar o PDF asinado como xustificativo dixital.

Sage 100cloud / Sage 50: o enfoque recomendado pasa por un middleware lixeiro (script Python ou Node.js aloxado en serverless) que recibe o webhook Certyneo, descarga o documento a través do URL seguro e o deposita na carpeta de importación automática de Sage.

Pennylane: solución nativa en nube cuxa API acepta directamente documentos en PJ cos seus metadatos contables. A integración webhook-Pennylane é particularmente axustada aos despachos de asesores contables que centralizan as pezas de varios clientes — un caso de uso que detallamos na sección escenarios.

Para os equipos que avalían diferentes solucións antes de migrar hacia Certyneo, o comparativa das solucións de sinatura electrónica ofrece unha vista detallada das capacidades de integración por plataforma.

Usar un iPaaS como Make ou n8n para os que non son desenvolvedores

Se a súa organización non ten un equipo técnico dedicado, as plataformas de automatización no-code/low-code (Make, n8n, Zapier) constitúen unha alternativa eficaz. O principio é sinxelo:

1. Cree un escenario cun trigger webhook en Make ou n8n — o URL xerado serve como endpoint Certyneo.
2. Configure as accións seguintes: descarga do documento asinado, análise dos metadatos, envío a Google Drive / SharePoint, creación dunha liña nun táboa de seguimento, notificación Slack ao responsable contable.
3. Opcionalmente, desencadee unha chamada API ao seu software contable para crear a entrada.

Este enfoque permite alcanzar un alto nivel de automatización en menos dun día, sen escribir unha liña de código. É particularmente pertinente para PEMES ou para asesores contables que desexan automatizar a recopilación de pezas para os seus clientes sen mobilizar un desenvolvedor.

Boas prácticas de seguridade e auditoría para os webhooks contables

Verificación das sinaturas HMAC e aseguramento dos endpoints

Nun contexto contable, a fiabilidade dos datos recibidos a través de webhook é crítica. Un atacante que conseguise inxectar falsos eventos `envelope.completed` podería corromper a súa contabilidade. Tres medidas de seguridade son imprescindibles:

• Verificación HMAC-SHA256: cada solicitude Certyneo inclúe un encabezado `X-Certyneo-Signature`. O seu endpoint debe recalcular a sinatura coa súa chave secreta e comparar — rexeitar calquera solicitude cuxa sinatura non corresponda.
• Validación do esquema JSON: antes de calquera procesamento, valide a estructura e os tipos do payload recibido. Un campo `montant_ht` con valor `null` ou negativo debe desencadear unha alerta, non unha entrada contable erronea.
• Rexistro inmutable: conserve cada payload recibido nun rexistro horodatado e non modificábel durante polo menos 10 anos, de acordo coas obrigacións de conservación das pezas contables (artigo L123-22 do Código de Comercio).

Trazabilidade e pista de auditoría para o asesor contable

Un das grandes vantaxes do enfoque webhook é a trazabilidade de extremo a extremo que xera. Certyneo produce para cada documento asinado unha pista de auditoría (audit trail) conforme ás esixencias eIDAS, incluíndo a marca de tempo cualificada, os enderezos IP dos asinantes e os certificados utilizados.

Asociando esta pista de auditoría co payload webhook, o seu ERP pode armazenar non só a peza xustificativa senón tamén a proba da súa validez xurídica. Para un comisario de contas ou un asesor contable, esta dupla capa — documento + proba — simplifica considerablemente as verificacións durante unha auditoría ou unha revisión. O sinatura electrónica na empresa detalla os niveis de sinatura e o seu valor probatorio en diferentes contextos de negocio.

Para calcular o retorno da inversión desta automatización antes de iniciarse, o calculador ROI de Certyneo permite estimar precisamente as ganancias de tempo e custos segundo o seu volume de documentos asinados.

Marco legal aplicábel aos webhooks e á contabilidade dixital

A automatización da cadea contable a través de webhooks de sinatura electrónica inscrívese nun marco regulatorio preciso que cómpre dominar.

Regulamento eIDAS n°910/2014 (e a súa revisión eIDAS 2.0): o regulamento europeo sobre identificación electrónica e servizos de confianza establece o valor xurídico das sinaturas electrónicas. O artigo 25 establece que unha sinatura electrónica non pode ser rexeitada os seus efectos xurídicos polo simple feito de presentarse en forma electrónica. As sinaturas cualificadas (QES) gozan dunha presunción de fiabilidade equivalente á sinatura manuscrita. Para as pezas contables, o nivel de sinatura apropiado depende da natureza do documento: unha factura sinxela pode recorrer a unha sinatura avanzada (AES), mentres que un contrato de arrendamento financeiro ou un acto notarial electrónico require unha sinatura cualificada.

Código Civil, artigos 1366 e 1367: o artigo 1366 recoñece o escrito electrónico como proba no mesmo grao que o escrito en soporte papel, baixo a condición de que poida ser debidamente identificada a persoa de quen emana e que sexa establecido e conservado en condicións que garantan a súa integridade. O artigo 1367 define a sinatura electrónica como o uso dun procedemento fiable de identificación que garanta a relación coa acta á que se adxunta. O webhook Certyneo, transmitindo a pista de auditoría con cada documento asinado, satisfai esta esixencia de identificación e integridade.

Artigo L123-22 do Código de Comercio: os documentos contables e as pezas xustificativas deben ser conservados durante dez anos. Os documentos recibidos a través de webhook e almacenados nun ERP deben, polo tanto, estar suxeitos a unha política de conservación conforme, incluíndo a imutabilidade e a lexibilidade a longo prazo dos formatos (recomendase PDF/A pola norma ISO 19005).

RGPD n°2016/679: os payloads webhook conteñen datos de carácter persoal (nomes dos asinantes, enderezos de correo electrónico, marcas de tempo relacionadas con individuos). O seu endpoint e o seu ERP son destinatarios destes datos — vostede é responsable do tratamento ou coresponsable segundo as modalidades contractuais con Certyneo. O DPA (Data Processing Agreement) debe ser formalizado. Os datos transmitidos deben ser minimizados ao estrictamente necesario para a finalidade contable.

Directiva NIS2 (2022/2555): para as empresas que entran no perímetro NIS2 (operadores de servizos esenciais, entidades importantes), a seguridade das interfaces API e webhooks constitúe unha medida de seguridade de rede obrigatoria. A verificación HMAC, o cifrado TLS 1.3 mínimo e o rexistro dos accesos impóñense.

Norma ETSI EN 319 132: define o formato XAdES para as sinaturas electrónicas avanzadas. As sinaturas producidas por Certyneo respectan estas normas ETSI, garantindo a súa interoperabilidade cos sistemas de arquivo a valor probatorio conformes ao referencial xeral de seguridade (RGS) francés.

Escenarios de uso concretos

Escenario 1: un despacho de asesoría contable xestionando 40 expedientes de clientes

Un despacho de asesoría contable dunha decena de colaboradores xestiona as letras de encargo, os mandatos SEPA e as contas anuais de 40 sociedades clientes. Antes da integración dos webhooks Certyneo, cada documento asinado era recollido manualmente por un xestor de expediente, renomeado segundo unha convención de nomeación, e despois depositado na carpeta cliente do software de produción contable. Este procedemento representaba aproximadamente 15 a 20 minutos por documento, é dicir, varias horas por semana en período de peche.

Despois de configurar un webhook `envelope.completed` conectado á súa ferramenta de GED a través de Make, o despacho automatizou a integridade desta cadea: así que se asina, o PDF asinado se clasifica automaticamente na carpeta cliente correspondente co nome de ficheiro correcto, envíase unha notificación ao xestor correspondente, e créase unha liña no táboa de seguimento das pezas recibidas. A ganancia de tempo estimada é da orde do 70 a 80% nesta tarefa, é dicir, aproximadamente 6 a 8 horas recuperadas por semana en período de balance — unha cifra coherente cos puntos de referencia publicados pola Orde de Asesores Contables nos seus informes sobre a transformación dixital dos despachos.

Escenario 2: unha PEME industrial cun ERP Sage e 300 contratos de provedores anuais

Unha PEME do sector industrial asina aproximadamente 300 contratos de provedores ao ano (pedidos-marco, avenencias, acordos de confidencialidade). Cada contrato asinado debe ser vinculado a unha folla de provedor en Sage 100cloud e archivado como xustificativo de compromiso. Sen automatización, o servizo de compras transmitía os contratos asinados por correo electrónico ao servizo contable cun atraso medio de 3 a 5 días laborais.

Despois do despregamento dun middleware Node.js que recibe os webhooks Certyneo e chama á API Sage, o atraso de vinculación caíu a uns poucos segundos. Os compromisos fóra de balance agora están contabilizados en tempo real, o que permitiu mellorar a fiabilidade das situacións intermedias presentadas ao DAF. O proxecto foi realizado en menos de dúas semanas por un desenvolvedor interno, apoiándose na documentación webhook do centro de axuda Certyneo.

Escenario 3: un grupo de sociedades xestionando fluxos intercompañía complexos

Un grupo constituído por unha decena de filiais usa Certyneo para asinar os seus acordos de tesorería intercompañía e os seus contratos de prestacións intragrupo. A consolidación contable impón que cada acordo asinado sexa simultáneamente rexistrado no sistema da filial emisora e da filial receptora, cun mesmo identificador de documento para facilitar a eliminación dos fluxos recíprocos.

Ao configurar un webhook único que notifica en paralelo os endpoints das dúas filiais implicadas (identificadas a través dos metadatos do sobre), o grupo eliminou os desequilibrios de consolidación relacionados con pezas faltantes ou mal referenciadas. O atraso de peche consolidado foi reducido de 2 días en media, o que representa unha ganancia significativa para unha dirección financeira de grupo que pecha trimestralmente. Os equipos que contemplan unha migración desde outra solución pueden consultar o guía de migración a Certyneo para evaluar a viabilidade técnica.

Conclusión

Os webhooks Certyneo constitúen un potente motor de automatización para calquera actor que desexe integrar a sinatura electrónica no núcleo do seu procedemento contable. Ao eliminar os pasos manuais entre a sinatura dun documento e o seu rexistro no ERP ou no software contable, reducen os atrasos, os erros de entrada e os riscos de pezas faltantes durante un balance ou unha auditoría. Sexa un despacho de asesoría contable, unha PEME ou un grupo multientidades, a configuración webhook é accesíbel — con ou sen desenvolvedor — e o retorno da inversión mídese xa nas primeiras semanas de uso.

Para ir máis lonxe, consulte o centro de axuda Certyneo para acceder á documentación completa da API e dos webhooks. Preparado para automatizar o seu balance contable? Cree a súa conta Certyneo gratuitamente e conecte os seus primeiros documentos asinados ao seu ERP hoxe mesmo.