Reconcilia Logo
Programa de Fundadores
Conocer integraciones

MCP y API de integración

Cree integraciones de Reconcilia con contexto preparado para agentes.

Use el MCP de Reconcilia para proporcionar a agentes de programación compatibles contexto revisado del producto y conecte los datos financieros autorizados mediante la API de integración. MCP no recibe claves de API ni datos del espacio de trabajo.

Abrir documentación de la APIDescargar OpenAPI JSON
Contexto para agentes de programación
Acceso a la API por organización
MCP nunca recibe claves de API

Contexto MCP

Ayuda a agentes de programación compatibles a comprender la arquitectura, los flujos de datos, los ciclos de vida y los controles de la API de integración. Es informativo y no accede a datos del cliente.

API de integración

Utiliza credenciales específicas de cada organización para incorporar datos de origen compatibles y proporcionar acceso de lectura autorizado, con validación, idempotencia y resultados trazables.

Cómo funcionan en conjunto

Del contexto revisado a un conector autorizado

MCP ayuda a un agente de programación compatible a comprender la integración. El conector se comunica directamente con la API de integración bajo la autorización de su organización.

01

Conecte MCP para proporcionar contexto

Proporcione al agente de programación orientación revisada sobre la arquitectura, los ciclos de vida, los flujos de datos y los límites operativos de Reconcilia.

02

Desarrolle el conector de API

Use el contrato de la API de integración para conectar datos compatibles de bancos, ERP, proveedores de pagos, posición de caja y proyecciones.

03

Mantenga la autorización separada

Guarde la clave de API de la organización en el almacén de secretos aprobado del conector. La API de integración controla la selección de la organización, la validación, la idempotencia y los resultados de cada solicitud.

Ejemplos de solicitudes

Valide los datos de origen antes de incorporarlos a la operación

Estos ejemplos muestran las principales formas de integración: datos de referencia, lotes de estados, documentos ERP, efectivo esperado, datos de proyección y visibilidad de conciliación.

curl "https://reconcilia-api.azurewebsites.net/integration/v1/statements/direct" \
  -H "x-api-key: rca_test.example.secret" \
  -H "idempotency-key: direct-json-2026-04-27" \
  -H "content-type: application/json" \
  -d '{
    "bankAccountId": "00000000-0000-0000-0000-000000000000",
    "statementType": "TRANSACTION_BATCH",
    "processingMode": "VALIDATE_ONLY",
    "statementDate": "2026-04-27",
    "currency": "USD",
    "statementReference": "direct-json-2026-04-27",
    "transactions": [{
      "transactionDate": "2026-04-27",
      "amount": "1250.00",
      "direction": "INFLOW",
      "description": "Customer payment",
      "bankTransactionReference": "BNK-001"
    }]
  }'

Cobertura

Grupos de API para datos financieros de origen

El contrato público se centra en los datos que Reconcilia utiliza para explicar posiciones de caja, clasificar movimientos, revisar excepciones, proyectar liquidez y generar informes con referencias de origen y contexto trazable.

Datos de referencia

  • GET/POST /integration/v1/entities
  • GET/PATCH/DELETE /integration/v1/entities/{id}
  • GET/POST /integration/v1/bank-accounts
  • GET/PATCH/DELETE /integration/v1/bank-accounts/{id}

Carga de estados

  • POST /integration/v1/statements
  • POST /integration/v1/statements/direct
  • POST /integration/v1/files
  • GET /integration/v1/files, /jobs, /logs

Datos fuente contables

  • GET/POST /integration/v1/gl/accounts
  • GET/POST /integration/v1/counterparties
  • GET/POST /integration/v1/erp-documents
  • GET/POST /integration/v1/payment-journals

Datos esperados de posición de caja y proyecciones

  • POST /integration/v1/cash-position-entries
  • POST /integration/v1/forecast-inputs

Visibilidad de conciliación

  • GET /integration/v1/reconciliation/suggestions
  • GET /integration/v1/reconciliation/match-groups

Idempotencia y seguridad en los reintentos

Use idempotency-key en las escrituras. Los estados prefieren statementReference o externalReference; los documentos ERP prefieren entityId + docType + docNo; la posición de caja y las proyecciones prefieren requestReference o identificadores externos. La misma clave con un cuerpo diferente devuelve 409.

Límites operativos

  • Las claves de la API de integración son específicas de cada organización y están separadas de las sesiones de usuario de la aplicación.
  • ERP docType=PAYMENT es solo dato fuente. No mueve dinero ni inicia transferencias.
  • La incorporación de entradas esperadas de posición de caja crea únicamente registros de planificación; no ejecuta pagos ni publica capturas finales.
  • La incorporación de datos de proyección crea únicamente entradas manuales administradas por la fuente; no publica versiones de proyecciones ni modifica la posición de caja.
  • Los endpoints de conciliación priorizan la visibilidad. Las API de aprobación, rechazo, reversión y ajustes aún no son públicas.
  • DELETE desactiva los registros de forma segura cuando está disponible; no elimina el historial financiero.

¿Está planificando una conexión mediante MCP o la API de integración?

Comparta sus sistemas de origen, formatos de archivo, caso de uso con agentes, necesidades de validación y requisitos de acceso. Le ayudaremos a definir el camino de integración adecuado.

Definir el alcance de integraciónAbrir documentación de la API