Plantilla digital

Esta guía explica cómo preparar el archivo Word (.docx) que se usará como plantilla para generar contratos digitales. La plantilla debe ser creada por el cliente y enviada a Kambia para su configuración y carga en el sistema.

Tipos de placeholders

El archivo Word debe contener dos tipos de marcadores especiales:

1. Campos de datos dinámicos

Son los textos que se reemplazan automáticamente con la información del contrato al momento de crearlo (nombre del socio, monto, fecha, etc.).

Sintaxis: {{nombre_del_campo}}

Ejemplo dentro del documento:

El presente contrato se celebra entre {{nombre_socio}}, con documento N° {{numero_documento}}, por un monto de {{monto_credito}} pagadero en {{numero_cuotas}} cuotas mensuales a partir del {{fecha_inicio}}.

2. Campos de firma

Son los espacios donde los firmantes colocarán su firma electrónica. Se insertan directamente en el texto del documento, en el lugar exacto donde debe aparecer el campo de firma.

Sintaxis: [[firma_1]]

Ejemplo dentro del documento:

[[firma_socio]]
___________________

[[firma_garante]]
___________________

Reglas para los nombres de los campos

Regla	Detalle
Solo letras minúsculas, números y guión bajo (`_`)	`nombre_socio` ✓ — `Nombre Socio` ✗
Deben empezar con una letra	`monto_credito` ✓ — `1_monto` ✗
Sin espacios ni caracteres especiales	`fecha_inicio` ✓ — `fecha-inicio` ✗
Máximo 32 caracteres

Ejemplo de plantilla

CONTRATO DE CRÉDITO N° {{numero_contrato}}

Celebrado en {{ciudad}}, el día {{fecha_contrato}}.

PARTES:

PRESTAMISTA: {{nombre_empresa}}

PRESTATARIO: {{nombre_socio}}, con DNI N° {{numero_documento}}, con domicilio en {{domicilio_socio}}.

CONDICIONES:

Monto del crédito : {{monto_credito}}
Número de cuotas  : {{numero_cuotas}}
Cuota mensual     : {{monto_cuota}}
Tasa de interés   : {{tasa_interes}}
Fecha de inicio   : {{fecha_inicio}}

...cuerpo del contrato...


[[firma_socio]]                 [[firma_garante]]
_______________                 _________________
Firma del socio                 Firma del garante

Información que debe entregar a Kambia

Una vez preparada la plantilla, el cliente debe enviarnos:

1. El archivo DOCX

El archivo Word con todos los placeholders {{...}} y [[...]] ya insertados.

2. Lista de campos de datos (`{{...}}`)

Una tabla con cada campo dinámico usado en la plantilla:

Campo	Descripción	Tipo
`{{nombre_socio}}`	Nombre completo del socio	`Juan Pérez López`
`{{numero_documento}}`	Número de DNI o documento	`12345678`
`{{monto_credito}}`	Monto total del crédito	`S/ 5,000.00`
`{{numero_cuotas}}`	Cantidad de cuotas	`12`
`{{fecha_inicio}}`	Fecha de inicio del crédito	`1 de abril de 2026`

3. Lista de campos de firma (`[[...]]`)

Una tabla con cada campo de firma usado en la plantilla:

Campo	Firmante	Descripción
`[[firma_socio]]`	Socio titular	Firma principal del contrato
`[[firma_garante]]`	Garante	Firma del garante solidario

Preguntas frecuentes

¿Puedo usar el mismo campo de firma en varias páginas?
Sí. Un mismo firmante puede tener múltiples campos [[...]] a lo largo del documento.

¿Puedo tener más de un firmante?
Sí. Se admite hasta un máximo de 10 firmantes por contrato digital.

¿Qué pasa si un campo {{...}} no se envía al crear el contrato?
El sistema rechazará la solicitud indicando qué campos faltan. Todos los campos declarados como requeridos deben enviarse con un valor.

¿El archivo puede tener imágenes, tablas y formato?
Sí. El documento puede tener cualquier formato visual. Los placeholders se insertan como texto normal dentro del contenido.

Tipos de placeholders#

1. Campos de datos dinámicos#

2. Campos de firma#

Reglas para los nombres de los campos#

Ejemplo de plantilla#

Información que debe entregar a Kambia#

1. El archivo DOCX#

2. Lista de campos de datos ({{...}})#

3. Lista de campos de firma ([[...]])#

Preguntas frecuentes#