# Desarrolladores: API REST, MCP y webhooks

> La API de Zentru: más de 400 comandos con contrato OpenAPI 3.1, servidor MCP Streamable HTTP, webhooks firmados con HMAC-SHA256 y conexión OAuth con PKCE.

URL canónica: https://zentru.ai/desarrolladores · Actualizado: 2026-10-30

[Inicio](https://zentru.ai/) / Desarrolladores

Para desarrolladores

## Un comando. Cuatro puertas.

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.
Ver el contrato OpenAPI → [Pedir llave de prueba](https://zentru.ai/contacto?interes=api)

400+ comandos en la API REST, cada uno con su esquema

**3.1** versión de OpenAPI del contrato publicado

5 min ventana de los webhooks firmados con marca de tiempo

**S256** PKCE obligatorio para conectar otra aplicación

API REST

## Vista previa, idempotencia y aprobación, en HTTP.

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.

**1 · vista previa sin escribir**
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" }] }

**2 · lo que tiene efecto legal espera**
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

## Tu agente, con nuestros controles.

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.

- **Misma identidad** y mismo sobre que la API: ninguna herramienta acepta un identificador de cliente como argumento.

- **Lecturas marcadas** como de solo lectura; escrituras con efecto legal marcadas como destructivas.

- **Sin atajos:** el agente externo también recibe approval_required .

**config del cliente MCP**
{
"mcpServers" : {
"zentru" : {
"type" : "http" ,
"url" : "https://app.zentru.ai/mcp" ,
"headers" : {
"Authorization" : "Bearer erp_live_…" ,
"X-Erp-Company-Id" : "0192…"
}
}
}
}

Webhooks y conexiones

## Avisos firmados. Llaves que no viajan.

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.

OAuth + PKCE

## Conectar sin ver la clave
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

## Descubrimiento público
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á.

**verificar un webhook (Python)**
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

## Hechos de negocio, sin datos personales.

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.

**erp_quote_created** **erp_quote_sent** **erp_quote_decided** **erp_quote_invoiced** **erp_dte_issued** **erp_dte_received** **erp_payment_registered** **erp_receivable_due_soon** **erp_receivable_overdue**

Ambiente de pruebas

## Pide una llave erp_test_ .

Te damos una empresa de prueba con datos de ejemplo para que integres sin tocar nada real.

[Pedir acceso →](https://zentru.ai/contacto?interes=api)

Preguntas

## Preguntas sobre desarrolladores.

¿Zentru tiene API?

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.
¿Cómo conecto mi agente de IA a Zentru?

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.
¿Cómo verifico los webhooks de Zentru?

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.
[Todas las preguntas](https://zentru.ai/preguntas)
