Acceso anticipado abierto · Facturación electrónica en proceso de certificación ante el SII.Acceso anticipado · SII en certificación. Ver hoja de ruta
PlataformaAgentesNormativaContadoresPreciosRecursosDesarrolladoresSeguridadPreguntasIngresarPide tu demo

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.

400+comandos en la API REST, cada uno con su esquema
3.1versión de OpenAPI del contrato publicado
5 minventana de los webhooks firmados con marca de tiempo
S256PKCE 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_createderp_quote_senterp_quote_decidederp_quote_invoicederp_dte_issuederp_dte_receivederp_payment_registerederp_receivable_due_soonerp_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.

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

Pide tu demo →