Kuenta Docs

Appearance

Plantillas de Documentos ​

Las plantillas de documentos en Kuenta te permiten crear y gestionar documentos personalizados para tus operaciones crediticias.

Tipos de plantillas ​

1. Contratos de crédito ​

  • Términos y condiciones
  • Tablas de amortización
  • Cláusulas personalizadas

2. Documentos de identidad ​

  • Formularios de solicitud
  • Declaraciones juradas
  • Autorizaciones

3. Documentos legales ​

  • Pagarés
  • Garantías
  • Avales

4. Recibos de pago ​

  • Comprobantes de pago aplicados a créditos
  • Incluyen información del pago, aplicación de montos y datos del miembro que registró el pago
  • Para documentación detallada, consulta el Manual de Plantilla de Recibo de Pago

Configuración de una plantilla ​

1. Estructura básica ​

json
{
  "name": "Contrato de Crédito Personal",
  "type": "contract",
  "version": "1.0",
  "language": "es",
  "sections": [
    {
      "id": "header",
      "type": "text",
      "content": "CONTRATO DE CRÉDITO PERSONAL"
    },
    {
      "id": "parties",
      "type": "dynamic",
      "fields": ["borrower_name", "borrower_id", "lender_name", "lender_id"]
    }
  ]
}

2. Campos dinámicos ​

json
{
  "fields": {
    "borrower_name": {
      "type": "text",
      "required": true,
      "label": "Nombre del prestatario"
    },
    "loan_amount": {
      "type": "currency",
      "required": true,
      "label": "Monto del préstamo",
      "format": "COP"
    },
    "interest_rate": {
      "type": "percentage",
      "required": true,
      "label": "Tasa de interés",
      "decimals": 2
    }
  }
}

Endpoints de la API ​

Crear plantilla ​

http
POST /v1/document-templates
Content-Type: application/json
Config-Organization-ID: tu-id-de-organizacion
Organization-ID: tu-id-de-organizacion

{
  "name": "Contrato de Crédito Personal",
  "type": "contract",
  "version": "1.0",
  "language": "es",
  "sections": [
    {
      "id": "header",
      "type": "text",
      "content": "CONTRATO DE CRÉDITO PERSONAL"
    }
  ]
}

Listar plantillas ​

http
GET /v1/document-templates
Config-Organization-ID: tu-id-de-organizacion
Organization-ID: tu-id-de-organizacion

Obtener detalles de una plantilla ​

http
GET /v1/document-templates/{id}
Config-Organization-ID: tu-id-de-organizacion
Organization-ID: tu-id-de-organizacion

Generación de documentos ​

Endpoint de generación ​

http
POST /v1/document-templates/{id}/generate
Content-Type: application/json
Config-Organization-ID: tu-id-de-organizacion
Organization-ID: tu-id-de-organizacion

{
  "borrower_name": "Juan Pérez",
  "loan_amount": 5000000,
  "interest_rate": 1.5,
  "term": 12,
  "term_unit": "months"
}

Respuesta de generación ​

json
{
  "documentId": "doc_123",
  "status": "generated",
  "url": "https://api.kuenta.co/v1/documents/doc_123",
  "expiresAt": "2024-03-27T10:00:00Z"
}

Firma digital ​

Endpoint de firma ​

http
POST /v1/documents/{id}/sign
Content-Type: application/json
Config-Organization-ID: tu-id-de-organizacion
Organization-ID: tu-id-de-organizacion

{
  "signerId": "user_123",
  "signatureType": "digital",
  "position": {
    "page": 1,
    "x": 100,
    "y": 200
  }
}

Verificación de firma ​

http
GET /v1/documents/{id}/signatures
Config-Organization-ID: tu-id-de-organizacion
Organization-ID: tu-id-de-organizacion

Próximos pasos ​

Soporte ​

Si necesitas ayuda con la configuración de plantillas de documentos:

  • Consulta la documentación técnica
  • Contacta al equipo de soporte
  • Revisa las preguntas frecuentes