HMAC-SHA256
Webhooks con marca de tiempo dentro de la firma
Se firma <timestamp>.<cuerpo> con un secreto cifrado por cliente. Fuera de 5 minutos, se rechaza: el replay no depende de ti.
Para desarrolladores
La interfaz, la API REST, el servidor MCP y el agente salen de una sola definición por comando. Lo que puedes hacer en pantalla, lo puedes hacer por código, con la misma validación y la misma auditoría.
API REST
Cada comando es POST /api/v1/commands/<dominio>/<acción>. Los errores siguen RFC 9457 con códigos estables. Los montos viajan como enteros CLP o decimales en texto, nunca como punto flotante.
POST /api/v1/commands/dte/draft Authorization: Bearer erp_test_… X-Erp-Company-Id: 0192… Idempotency-Key: draft-0042 X-Erp-Dry-Run: true X-Erp-As-Of: 2026-10-07 { "dte_type": 33, "receiver_rut": "76123456-7", "receiver_name": "Comercial Andes SpA", "items": [{ "description": "Consultoría", "quantity": "1", "unit_price_clp": "2000000" }] }
POST /api/v1/commands/dte/issue → 409 application/problem+json { "code": "approval_required", "title": "Esta acción requiere aprobación", "proposal_id": "0192…", "correlation_id": "0192…" } # una persona decide con proposal.decide # y el reintento lleva el token de un solo uso: X-Erp-Approval-Token: apr_…
Ilustrativo. El contrato exacto de cada comando está en openapi.json.
MCP
El servidor MCP de Zentru usa el transporte Streamable HTTP en https://app.zentru.ai/mcp. Cada comando aparece como herramienta erp.* con anotaciones derivadas de su nivel de riesgo.
approval_required.{
"mcpServers": {
"zentru": {
"type": "http",
"url": "https://app.zentru.ai/mcp",
"headers": {
"Authorization": "Bearer erp_live_…",
"X-Erp-Company-Id": "0192…"
}
}
}
}Webhooks y conexiones
HMAC-SHA256
Se firma <timestamp>.<cuerpo> con un secreto cifrado por cliente. Fuera de 5 minutos, se rechaza: el replay no depende de ti.
OAuth + PKCE
Tu aplicación abre /app/autorizar, la persona entra con su sesión y su segundo factor, elige la empresa y vuelve un código de un solo uso que tu servidor canjea por una llave revocable.
manifest
GET /api/v1/integrations/manifest lista acciones y disparadores, y marca cuáles requieren confirmación humana, para que tu producto no prometa lo que no hará.
import hmac, hashlib, time def verificar(cuerpo: bytes, ts: str, firma: str, secreto: bytes) -> bool: if abs(time.time() - int(ts)) > 300: # ventana de 5 minutos return False esperado = hmac.new(secreto, ts.encode() + b"." + cuerpo, hashlib.sha256).hexdigest() return hmac.compare_digest(esperado, firma)
Cabeceras X-Erp-Signature, X-Erp-Timestamp y X-Erp-Event-Id. El contrato completo está en el manifest público.
Eventos
Los eventos llevan prefijo erp_, versión de esquema explícita y cambios solo aditivos. Por webhook salen nueve hechos de ventas, documentos, pagos y cartera; remuneraciones y declaraciones no salen.
Ambiente de pruebas
Te damos una empresa de prueba con datos de ejemplo para que integres sin tocar nada real.
Preguntas
Sí. Más de 400 comandos por API REST con contrato OpenAPI 3.1, en https://app.zentru.ai/openapi.json, con idempotencia, vista previa y errores RFC 9457.
Por MCP, con el transporte Streamable HTTP en https://app.zentru.ai/mcp y una llave de API. Cada comando aparece como herramienta erp.* con las mismas reglas de aprobación.
Cada aviso va firmado con HMAC-SHA256 sobre la marca de tiempo y el cuerpo, en las cabeceras X-Erp-Signature y X-Erp-Timestamp, con una ventana de 5 minutos.