Finanzas y Comisiones

Coordinalo automatiza el cálculo de comisiones y revenue share entre la organización y los proveedores (profesionales).

El modelo de revenue share permite definir cómo se distribuyen los ingresos de cada sesión entre la organización y el proveedor.

Configurar comisión de proveedor

PUT /api/v1/providers/:providerId/commission

{
  "type": "percentage",
  "value": 70
}

En este ejemplo, el proveedor recibe el 70% del valor de cada sesión y la organización retiene el 30%.

Tipos de comisión

Tipo	Descripción	Ejemplo
`percentage`	Porcentaje del valor de la sesión	70% para el proveedor
`fixed`	Monto fijo por sesión	$15.000 CLP por sesión
`tiered`	Porcentaje escalonado por volumen	60% hasta 20 sesiones, 70% después

Cálculo automático

Las comisiones se calculan automáticamente cuando una sesión se marca como entregada (completed).

interface SessionPayment {
  sessionId: string;
  servicePrice: number;        // Precio del servicio
  providerCommission: number;  // Monto para el proveedor
  organizationAmount: number;  // Monto para la organización
  calculatedAt: string;        // Timestamp del cálculo
}

Ejemplo de cálculo

{
  "sessionId": "sess_123abc",
  "servicePrice": 50000,
  "providerCommission": 35000,
  "organizationAmount": 15000,
  "calculatedAt": "2026-01-15T11:05:00Z"
}

El cálculo se dispara automáticamente via webhook session.completed. No requiere intervención manual.

Reportes financieros

Resumen por proveedor

GET /api/v1/reports/providers/:providerId/earnings

Parámetros:

Parámetro	Tipo	Descripción
`from`	`string`	Fecha inicio (ISO 8601)
`to`	`string`	Fecha fin (ISO 8601)
`format`	`string`	`json`, `excel`, `pdf`

Respuesta:

{
  "providerId": "prov_456def",
  "providerName": "María González",
  "period": {
    "from": "2026-01-01",
    "to": "2026-01-31"
  },
  "summary": {
    "totalSessions": 45,
    "completedSessions": 42,
    "totalRevenue": 2100000,
    "providerEarnings": 1470000,
    "organizationEarnings": 630000
  }
}

Resumen de organización

GET /api/v1/reports/organization/earnings

Retorna el consolidado de todos los proveedores con totales de la organización.

Facturación automática (Chile)

Coordinalo genera boletas electrónicas automáticamente vía integración con el SII.

Configurar facturación

POST /api/v1/organization/billing/setup

{
  "provider": "sii",
  "rut": "76.XXX.XXX-X",
  "certificatePath": "/path/to/certificate.pfx",
  "environment": "production"
}

Generar boleta

POST /api/v1/billing/boleta

{
  "sessionId": "sess_123abc",
  "clientRut": "12.345.678-9",
  "emitOnComplete": true
}

La integración con SII requiere certificado digital vigente y estar habilitado como emisor electrónico.

Pagos con MercadoPago

Coordinalo integra MercadoPago para cobros online.

Crear preferencia de pago

POST /api/v1/payments/preference

{
  "sessionId": "sess_123abc",
  "amount": 50000,
  "currency": "CLP",
  "description": "Sesión de kinesiología - María González"
}

Webhook de pago completado

{
  "event": "payment.approved",
  "data": {
    "sessionId": "sess_123abc",
    "paymentId": "pay_xyz789",
    "amount": 50000,
    "method": "credit_card",
    "approvedAt": "2026-01-15T09:30:00Z"
  }
}

Ver la guía de integración con MercadoPago para configuración detallada.

Liquidación de pagos

Obtener liquidación pendiente

GET /api/v1/providers/:providerId/settlement

{
  "providerId": "prov_456def",
  "pendingAmount": 350000,
  "sessionsCount": 10,
  "oldestSession": "2026-01-10",
  "sessions": [
    {
      "id": "sess_123abc",
      "date": "2026-01-15",
      "amount": 35000
    }
  ]
}

Marcar como liquidado

POST /api/v1/providers/:providerId/settlement/mark-paid

{
  "sessionIds": ["sess_123abc", "sess_456def"],
  "paymentMethod": "transfer",
  "reference": "Transferencia 15/01/2026"
}

Finanzas y Comisiones

On this page