Configuración JSON

Referencia completa para el archivo de configuración JSON — estructura raíz, tipos de pregunta, validaciones, condicionales y perfiles de firma.

Localización y defaults

La plataforma asume Colombia por defecto en varios tipos. Algunos aceptan override vía el atributo country; otros están fijos.

Tipo	Default	Override
`currency`	COP	No soportado — siempre formatea en pesos colombianos
`nit`	Colombia	No soportado — formato NIT colombiano fijo (`XXXXXX-X`)
`identification`	CO	`country: "MX" \| "CL" \| "SV" \| ...` (ver la sección Identificación más abajo)
`phone`	Detecta automáticamente	`country: "co" \| "mx" \| ...` (ISO2 en minúscula)
`department`	CO	`country: "CO" \| "MX" \| ...`
`date`	Español, calendario gregoriano	No localizable — se renderiza como `"15 de enero de 2024"`

Mercados fuera de Colombia

Si tu caso de uso requiere USD u otro formato monetario, currency no es el tipo indicado — usa number y formatea el prefijo manualmente en el HTML. De forma similar, nit solo aplica a Colombia; para tax IDs de otros países usa text con una regex apropiada.

Propiedades Principales del Objeto Raíz

{
  "name": "Mi Primera Automatización",
  "description": "Contrato de servicios con un firmante, para el equipo comercial",
  "preBuild": false,
  "config": [],
  "signatureProfile": [],
  "sign": []
}

Propiedad	Tipo	Requerido	Descripción
`name`	string	Requerido	Nombre de la automatización
`description`	string	Opcional	Texto que describe la plantilla, máximo 500 caracteres. Solo informativo: lo devuelve `GET /template` y no afecta el diligenciamiento
`config`	array	Requerido	Array de preguntas para el usuario
`signatureProfile`	array	Requerido	Definición de firmantes y aprobadores
`sign`	array	Requerido	Nombres de preguntas obligatorias
`preBuild`	boolean	Opcional	Si es `true`, incluye prellenado automático
`files`	array	Opcional	Documentos adjuntos que se piden a los participantes con `package: true`. Ver Documentos adjuntos
`build`	number	Gestionado por el servidor	Versión de caché del SDK. No lo envíes: la API rechaza la petición si lo incluyes. El servidor lo incrementa automáticamente cuando actualizas la plantilla para invalidar la caché del SDK en clientes.

Propiedad `preBuild` — Prellenado Automático

Cuando preBuild es true, debes incluir preBuildData. Este campo habilita un prellenado automático de la plantilla: algunos campos se completan previamente para que el usuario solo termine de diligenciar el documento.

En preBuildData se declaran las preguntas que se prellenarán en esta primera instancia. El último elemento del arreglo debe ser el correo del usuario final, quien recibirá la solicitud de diligenciamiento por correo electrónico.

{
  "preBuild": true,
  "preBuildData": ["nombre_comprador", "email_comprador", "correo_usuario_final"]
}

Documentos adjuntos (`files`)

Lista los documentos que se le piden al participante que tenga package: true en signatureProfile: una copia de la cédula, un certificado, un comprobante.

"files": [
  { "name": "Copia de la cédula", "approve": "pending" },
  { "name": "Certificado bancario", "approve": "pending", "optional": true },
  { "name": "Cédula del codeudor", "approve": "pending", "preReq": "tiene_codeudor" }
]

Nombre	Tipo	Descripción
`name`	String requerido	Nombre del documento, tal como lo ve el participante.
`approve`	String requerido	Siempre `"pending"`.
`optional`	Boolean opcional	`true` para que el participante pueda continuar sin subirlo. Sin `optional`, el adjunto es obligatorio.
`preReq`	String opcional	Nombre de una pregunta `clausula` de Sí/No (opciones `s` y `n`). El adjunto solo se pide si la respuesta es `s`.

`config` y sus tipos de preguntas

En esta sección se agregan todas las preguntas que debe diligenciar el usuario para generar el documento para firma.

info

Cada pregunta en config es un objeto con propiedades específicas. Siempre requiere name, description y type.
Las preguntas también pueden tener un valor por defecto añadiendo el atributo value (solo tiene sentido en clausula, select y searchlist).

{
  "name": "identificador_unico",
  "description": "Texto que ve el usuario",
  "type": "tipo_pregunta"
}

Resumen de Tipos de Pregunta

Tipo	UI de entrada	Valor almacenado	Renderizado en el span
`text`	texto libre	`"str"`	tal cual
`name`	texto	`"str"`	EN MAYÚSCULAS
`email`	email	`"lower@x.com"`	tal cual
`phone`	teléfono internacional	`"+573001234567"`	tal cual
`number`	entrada numérica	`"50000"`	`"50.000"` (o con texto escrito si `addText`)
`currency`	entrada numérica	`"50000"`	`"$50.000 (CINCUENTA MIL PESOS)"`
`date`	selector de fecha	`"2024-01-15"`	`"15 de enero de 2024"`
`nit`	entrada numérica	`"9001234567"`	`"900123456-7"` (auto-formateado)
`identification`	país + tipo de doc + número	`"CC 1084340519"` (dos partes)	cadena completa
`department`	dropdown territorial	`"Antioquia"`	tal cual
`select`	dropdown simple	`"valor_opcion"`	`options[i].label` coincidente
`searchlist`	dropdown con búsqueda	`"valor_opcion"`	`options[i].label` coincidente
`clausula`	dropdown con spans condicionales	`"valor_opcion"`	muestra `<span name="pregunta_valor">`
`check`	checkboxes múltiples	`select: ["a","b"]` arreglo	`"a, b"` (unidos por coma)
`image`	subida de archivo	data URI base64	`<img src="..." class="object-contain"/>`
`signature`	firma dibujada / tipeada	base64 o cadena	`<img>` o `<span class="text-sign">`
`request`	texto + validación externa	`"str"`	tal cual (más los campos prellenados por el servicio)

request requiere integración adicional con un backend y se cubre en su propia página: consulta Tipo Request.

Texto Libre (`text`)

Acepta cualquier texto sin restricciones.

{
  "name": "descripcion_producto",
  "description": "Describa brevemente el producto",
  "type": "text"
}

Soporta las validaciones maxlength y regex (ver Propiedades de Validación).

Nombre (`name`)

Igual a texto, pero convierte a mayúsculas automáticamente en el HTML.

{
  "name": "nombre_comprador",
  "description": "Ingrese su nombre completo",
  "type": "name"
}

info

Ejemplo de salida:

Usuario ingresa: juan pérez
Se muestra en HTML: JUAN PÉREZ

Número (`number`)

Solo acepta valores numéricos. Se renderiza con separadores de miles.

{
  "name": "cantidad_articulos",
  "description": "¿Cuántos artículos desea?",
  "type": "number"
}

Con texto escrito (addText):

{
  "name": "cantidad_articulos",
  "description": "¿Cuántos artículos desea?",
  "type": "number",
  "addText": true
}

Soporta límites numéricos min y max.

`addText`	Usuario ingresa `5000`	Se renderiza como
(omitir)	`5000`	`5.000`
`true`	`5000`	`5.000 (CINCO MIL)`

Moneda (`currency`)

Formatea automáticamente como moneda (pesos colombianos por defecto) con el monto escrito en letras.

{
  "name": "monto_total",
  "description": "Ingrese el valor en pesos",
  "type": "currency"
}

Sin texto escrito (removeText):

{
  "name": "monto_total",
  "description": "Ingrese el valor en pesos",
  "type": "currency",
  "removeText": true
}

`removeText`	Usuario ingresa `50000`	Se renderiza como
(omitir)	`50000`	`$50.000 (CINCUENTA MIL PESOS)`
`true`	`50000`	`$50.000`

Correo Electrónico (`email`)

Valida que sea un email correcto.

{
  "name": "email_comprador",
  "description": "Ingrese su correo electrónico",
  "type": "email"
}

Teléfono (`phone`)

Valida el número telefónico según el indicativo seleccionado.

{
  "name": "telefono_comprador",
  "description": "Ingrese su número telefónico",
  "type": "phone"
}

Limitado a un país específico:

{
  "name": "telefono_comprador",
  "description": "Ingrese su teléfono colombiano",
  "type": "phone",
  "country": "co"
}

Cuando se define country, el input queda fijado al código de ese país.

Fecha (`date`)

Muestra un calendario para seleccionar una fecha.

{
  "name": "fecha_entrega",
  "description": "Seleccione la fecha de entrega",
  "type": "date"
}

Desde hoy en adelante (min: "now"):

{
  "name": "fecha_entrega",
  "description": "Seleccione la fecha de entrega",
  "type": "date",
  "min": "now"
}

Con min: "now" el calendario abre con la fecha de hoy ya seleccionada y no deja elegir fechas pasadas.

Soporta min, max, subYears, subDays y afterSubYears para restricciones de rango. Consulta Propiedades de Validación.

NIT (`nit`)

Entrada de NIT colombiano. Se formatea automáticamente como XXXXXX-X en el documento renderizado.

{
  "name": "nit_empresa",
  "description": "Ingrese el NIT de la empresa",
  "type": "nit"
}

Usuario ingresa	Se renderiza como
`9001234567`	`900123456-7`
`8301234`	`830123-4`

Identificación (`identification`)

Entrada estructurada de identificación del firmante. El usuario elige un país, un tipo de documento e ingresa el número. El valor almacenado tiene dos partes separadas por un espacio: "{TIPO_DOC} {NÚMERO}".

{
  "name": "cedula_comprador",
  "description": "Ingrese la identificación del comprador",
  "type": "identification",
  "country": "CO"
}

Acción del usuario	Valor almacenado	Renderizado en el span
Elige `CC`, ingresa `1084340519`	`"CC 1084340519"`	`CC 1084340519`
Elige `CE`, ingresa `A0123456`	`"CE A0123456"`	`CE A0123456`

Cuándo usarlo

Usa identification para documentos de firmantes en lugar de text o number. El runtime divide el valor en identificationType e identification al componer el perfil del firmante, lo cual es requerido para los flujos de verificación de identidad.

Países soportados: Colombia (CC, CE, PPT, DL, PASSPORT), México (CURP, PASSPORT), Chile (RUT, RUN, PASSPORT), El Salvador (DUI, PASSPORT), Costa Rica (CCCR, PASSPORT), Perú (DNI, PASSPORT), Uruguay (CI, PASSPORT), Venezuela (CI, PASSPORT), Honduras (DNI, PASSPORT), Panamá (CI, PASSPORT), España (DNI, PASSPORT), Ecuador (CI, PASSPORT), Aruba (CI, PASSPORT).

Departamento (`department`)

Dropdown de divisiones territoriales (departamentos / estados) para el país configurado. Por defecto Colombia.

{
  "name": "departamento_comprador",
  "description": "Seleccione el departamento del comprador",
  "type": "department",
  "country": "CO"
}

El valor almacenado es el nombre completo del departamento (p. ej. "Antioquia").

Lista Simple (`select`)

Dropdown simple. No activa visibilidad condicional de otras preguntas.

{
  "name": "tipo_documento",
  "description": "Seleccione el tipo de documento",
  "type": "select",
  "value": "cc",
  "options": [
    { "name": "Cédula de Ciudadanía", "label": "Cédula de Ciudadanía", "value": "cc" },
    { "name": "Cédula de Extranjería", "label": "Cédula de Extranjería", "value": "ce" }
  ]
}

HTML correspondiente:

<span name="tipo_documento">_______________</span>

El SDK coloca automáticamente el label de la opción en el span.

Lista con Búsqueda (`searchlist`)

Dropdown con input de búsqueda. Idéntico a select en el JSON — solo cambia la UX. Úsalo cuando la lista tiene más de ~10 opciones.

{
  "name": "pais_nacimiento",
  "description": "Seleccione su país de nacimiento",
  "type": "searchlist",
  "options": [
    { "name": "Argentina", "label": "Argentina", "value": "AR" },
    { "name": "Brasil",    "label": "Brasil",    "value": "BR" }
  ]
}

El HTML es un único <span name="pais_nacimiento"> igual que select.

Lista de Cláusulas (`clausula`)

Dropdown con opciones predefinidas. Permite limitar otras preguntas vía prereq.

{
  "name": "tipo_documento",
  "description": "Seleccione el tipo de documento",
  "type": "clausula",
  "value": "cc",
  "options": [
    { "name": "Cédula de Ciudadanía", "value": "cc" },
    { "name": "Cédula de Extranjería", "value": "ce" },
    { "name": "Pasaporte",            "value": "pasaporte" }
  ]
}

HTML correspondiente:

<span name="tipo_documento_cc">C.C.</span>
<span name="tipo_documento_ce" hidden>C.E.</span>
<span name="tipo_documento_pasaporte" hidden>PASAPORTE</span>

Reglas:

Se crea un <span> por cada opción, con name = {nombre_pregunta}_{valor_opcion}.
El elemento que coincide con el value por defecto no debe tener hidden.
Todas las demás opciones deben tener hidden.
El SDK alterna la visibilidad a medida que el usuario selecciona distintas opciones.

Múltiples Opciones (`check`)

Campo de selección múltiple que se renderiza como una lista unida por comas.

{
  "name": "servicios_incluidos",
  "description": "Seleccione los servicios incluidos",
  "type": "check",
  "values": ["limpieza", "mantenimiento", "seguro"]
}

values es un arreglo de strings — NO options con objetos

El tipo check es el único tipo que usa un arreglo plano values: ["a", "b"] en lugar de una estructura options: [{...}]. Usar options aquí no renderizará nada.

Salida renderizada: <span name="servicios_incluidos">limpieza, mantenimiento</span> (si el usuario marca esas dos).

Imagen (`image`)

Input de subida de archivo (PNG o JPEG, máx. 8 MB). El valor almacenado es un data URI en base64, y el span se reemplaza por un elemento <img>.

{
  "name": "foto_documento",
  "description": "Suba una foto de su documento",
  "type": "image"
}

HTML correspondiente:

<span name="foto_documento">___________</span>

Al diligenciar, el span se convierte en:

<span name="foto_documento"><img src="data:image/png;base64,..." class="object-contain"/></span>

Firma (`signature`)

Captura una firma dibujada en canvas o tipeada con una fuente tipo firma. Siempre obligatoria (no puede dejarse vacía).

{
  "name": "firma_comprador",
  "description": "Dibuje su firma",
  "type": "signature",
  "allow": ["draw", "font"]
}

El arreglo allow restringe los modos de captura disponibles para el usuario:

["draw"] — solo dibujada a mano en canvas
["font"] — solo tipeada en una fuente tipo firma
["draw", "font"] — ambas permitidas

Tipo signature vs firma del firmante

Es distinto al placeholder de firma usado por signatureProfile. Usa preguntas signature cuando necesitas una segunda firma inline dentro del cuerpo del documento (p. ej., iniciales en cada cláusula). Para la firma principal del firmante usa <div name="comprador" class="sign-margin"> junto con signatureProfile — consulta Configuración del HTML.

La excepción es la firma en el momento: si referencias la pregunta desde signatureProfile[].signature, esa firma pasa a ser la del firmante, capturada dentro del formulario. Consulta Perfiles de Firma.

Request (`request`)

Entrada de texto que valida su valor contra un endpoint HTTP externo y usa la respuesta para prellenar otros campos del documento.

Se cubre en una página dedicada porque requiere integración con backend: Tipo Request →.

Propiedades de Validación

Todos los tipos de pregunta soportan un conjunto de propiedades opcionales de validación para restringir la entrada del usuario.

Propiedad	Tipo	Aplica a	Descripción
`maxlength`	Number (entero ≥ 1)	`text`, `name`, `email`, `nit`, `request`, `phone`	Número máximo de caracteres.
`regex`	String	cualquier input de texto	Expresión regular de JavaScript que debe cumplir el valor. Ejemplo: `"^[A-Z]{3}\\d{3}$"`
`min`	String o Number	`number`, `currency`, `date`	En `number` y `currency`, valor mínimo. En `date`, fecha mínima (`"2024-01-15"`) o `"now"`: preselecciona la fecha de hoy y bloquea las fechas pasadas.
`max`	String o Number	`number`, `currency`, `date`	En `number` y `currency`, valor máximo. En `date`, fecha máxima (`"2024-12-31"`).
`subYears`	Number (entero ≥ 0)	`date`	Edad mínima en años (p. ej. `18` significa que la fecha debe ser ≥ 18 años atrás).
`subDays`	Number (entero ≥ 0)	`date`	La fecha debe ser al menos esta cantidad de días anterior a hoy.
`afterSubYears`	Number (entero ≥ 0)	`date`	La fecha no puede ser anterior a esta cantidad de años atrás (p. ej. `5` bloquea las fechas de hace más de 5 años).
`addText`	Boolean	`number`	Agrega el valor escrito en letras: `5.000 (CINCO MIL)`. Ver Número.
`country`	String	`phone`, `identification`, `department`	Código ISO2 del país (p. ej. `"CO"`, `"MX"`).
`allow`	Array<String>	`signature`	Modos de captura permitidos: `"draw"`, `"font"` o ambos. Al menos uno. Ver Firma.
`groupQuestion`	Object	`number`	Valida que un grupo de campos sume hasta un máximo: `id` y `max` obligatorios, `errorMessage` opcional. Ver abajo.

Un atributo desconocido rechaza toda la plantilla

La API valida cada pregunta contra una lista cerrada de atributos: los de esta tabla, más name, description, type, value, help, options, select, values, endpoint, removeText, prereq y prereqOptionals. Si una pregunta trae cualquier otro atributo —un nombre mal escrito, como maxLength—, POST y PUT /template responden 400 y no guardan nada. Lo mismo pasa con un valor fuera de rango, como un maxlength de 0 o un allow vacío.

Ejemplo: fecha de nacimiento solo para mayores de edad

{
  "name": "fecha_nacimiento",
  "description": "Ingrese su fecha de nacimiento",
  "type": "date",
  "subYears": 18
}

Ejemplo: código alfanumérico estricto

{
  "name": "codigo_referencia",
  "description": "Ingrese el código de referencia (formato ABC-1234)",
  "type": "text",
  "regex": "^[A-Z]{3}-\\d{4}$",
  "maxlength": 8
}

Ejemplo: `groupQuestion` (los campos deben sumar ≤ 100)

[
  {
    "name": "porcentaje_propietario",
    "description": "Porcentaje del propietario",
    "type": "number",
    "groupQuestion": {
      "id": "participacion",
      "max": 100,
      "errorMessage": "Los porcentajes no deben superar el 100%"
    }
  },
  {
    "name": "porcentaje_socio",
    "description": "Porcentaje del socio",
    "type": "number",
    "groupQuestion": {
      "id": "participacion",
      "max": 100,
      "errorMessage": "Los porcentajes no deben superar el 100%"
    }
  }
]

Todas las preguntas que comparten el mismo groupQuestion.id se validan en conjunto: su suma no debe superar max.

Preguntas Condicionales con `prereq`

La propiedad prereq controla la visibilidad condicional de una pregunta:

k (key): nombre de la pregunta de referencia
v (value): valor requerido en la pregunta de referencia para mostrar la pregunta actual

Estructura

"prereq": [
  { "k": "nombre_pregunta_referencia", "v": "valor_requerido" }
]

Varias entradas se combinan con AND (todas deben cumplirse).

Importante

La pregunta referenciada en k debe ser de tipo clausula. Solo clausula dispara visibilidad condicional.

Ejemplo Completo

[
  {
    "name": "tipo_documento",
    "description": "Seleccione el tipo de documento del comprador",
    "type": "clausula",
    "value": "cc",
    "options": [
      { "name": "Cédula de Ciudadanía", "value": "cc" },
      { "name": "Cédula de Extranjería", "value": "ce" }
    ]
  },
  {
    "name": "numero_cc",
    "description": "Ingrese el número de cédula de ciudadanía",
    "type": "number",
    "prereq": [{ "k": "tipo_documento", "v": "cc" }]
  },
  {
    "name": "numero_ce",
    "description": "Ingrese el número de cédula de extranjería",
    "type": "number",
    "prereq": [{ "k": "tipo_documento", "v": "ce" }]
  }
]

`prereqOptionals` — Lógica OR

Para mostrar una pregunta cuando la referencia coincide con cualquiera de varios valores, usa prereqOptionals junto con prereq. Cada entrada tiene el formato {nombre_pregunta}_{valor_opcion}.

{
  "name": "nit_empresa",
  "description": "NIT de la empresa",
  "type": "nit",
  "prereq": [{ "k": "tipo_cliente", "v": "empresa" }],
  "prereqOptionals": [
    "tipo_cliente_empresa",
    "tipo_cliente_consorcio"
  ]
}

La pregunta aparece cuando tipo_cliente es empresa o consorcio.

Perfiles de Firma (`signatureProfile`)

Define quiénes firman el documento y sus datos asociados. Este objeto no guarda los datos crudos del firmante — guarda referencias a las preguntas que contienen la información de cada firmante.

Nombre	Tipo	Descripción
`name`	String requerido	Nombre de la pregunta con el nombre del firmante.
`identification`	String opcional	Nombre de la pregunta para la identificación. Puede tener múltiples opciones con `\|`.
`email`	String condicional	Nombre de la pregunta de tipo `email` con el correo del firmante, o de un campo de `preFill`. Envía `email`, `phone` o ambos, salvo que el firmante tenga `signature`.
`phone`	String condicional	Nombre de la pregunta de tipo `phone` con el teléfono del firmante (recomendado para OTP), o de un campo de `preFill`. Envía `email`, `phone` o ambos, salvo que el firmante tenga `signature`.
`type`	String requerido	Identificador único del firmante. Es el `name` de su espacio de firma en el Complete HTML: `<div name="…" class="sign-margin">`.
`role`	String opcional	`"APPROVER"` hace que el participante apruebe el documento en vez de firmarlo. Sin `role`, es firmante.
`order`	Number opcional	Turno de firma. Con `order`, la firma es secuencial: el participante recibe su invitación cuando firman los de turno anterior.
`package`	Boolean opcional	`true` si a este participante se le piden documentos adjuntos. La plantilla debe declarar cuáles en `files`.
`country`	String opcional	Valor fijo, no el nombre de una pregunta: código ISO2 del país del documento del firmante (p. ej. `"CO"`). Úsalo junto con `identificationType` cuando la identificación se pide con una pregunta que no es de tipo `identification`, que ya trae país y tipo.
`identificationType`	String opcional	Valor fijo, no el nombre de una pregunta: tipo de documento del firmante (p. ej. `"CC"`). Mismo caso que `country`.
`signature`	String opcional	Nombre de una pregunta `type: "signature"` de `config` con la que el firmante firma dentro del formulario (firma en el momento). Con `signature`, `email` y `phone` dejan de ser obligatorios.

name es una sola pregunta

name debe ser un string. La API rechaza un arreglo de nombres de preguntas con "signatureProfile[0].name" must be a string. Si el documento captura el nombre en varios campos (primer nombre, segundo nombre, apellido), agrega una pregunta de tipo name que pida el nombre completo y úsala como name del firmante.

Ejemplo — Un Firmante

{
  "name": "nombre_comprador",
  "identification": "cedula_comprador",
  "email": "email_comprador",
  "phone": "telefono_comprador",
  "type": "comprador"
}

Ejemplo — Múltiples Identificaciones

Si tienes varias preguntas de identificación (C.C, C.E, Pasaporte), sepáralas con | (pipe). El runtime toma la que tenga valor.

{
  "name": "nombre_vendedor",
  "identification": "cedula_vendedor|cedulae_vendedor|pasaporte_vendedor",
  "email": "email_vendedor",
  "phone": "telefono_vendedor",
  "type": "vendedor"
}

Correo y teléfono del firmante

email y phone no llevan el dato del firmante: llevan el nombre del campo de donde Auco lo toma al crear el proceso. Por eso POST y PUT /template validan cada uno contra la plantilla:

Debe ser el name de una pregunta de config del tipo correspondiente —email para email, phone para phone—, o el name de un campo de preFill, el arreglo de valores fijos (name y value) de la plantilla.
Si el nombre no es ni una pregunta ni un campo de preFill, la API responde 400 con PROFILE_FIELD_NOT_FOUND: <campo>.
Si la pregunta existe pero es de otro tipo —por ejemplo, un email que apunta a una pregunta text—, responde 400 con PROFILE_FIELD_TYPE_INVALID: <campo> must be type email (o phone).
Un firmante sin email ni phone y sin signature se rechaza con el mensaje del validador: "signatureProfile[0]" must contain at least one of [email, phone].

Pregunta text para el correo

Si tu plantilla pide el correo del firmante con una pregunta text, la API la rechaza con PROFILE_FIELD_TYPE_INVALID. Cambia el tipo de esa pregunta a email: además de pasar la validación, el formulario revisa que el correo tenga un formato válido.

Firma en el momento (`signature`)

Un firmante con signature firma mientras diligencia el formulario, con la pregunta de firma que referencias. Como no se le envía nada, no necesita email ni phone; si los trae, se validan igual.

La pregunta debe existir en config con type: "signature". La API no lo comprueba, así que revísalo antes de guardar.
La convención es usar el mismo valor en los tres lugares: el name de la pregunta, el type y el signature del firmante.
El formulario debe abrirse con la firma en el momento habilitada (signNow). Sin eso, la pregunta de firma no tiene efecto sobre el firmante.

{
  "config": [
    {
      "name": "nombre_cliente",
      "description": "Ingrese su nombre completo",
      "type": "name"
    },
    {
      "name": "cliente",
      "description": "Firme aquí",
      "type": "signature",
      "allow": ["draw"]
    }
  ],
  "signatureProfile": [
    {
      "name": "nombre_cliente",
      "type": "cliente",
      "signature": "cliente"
    }
  ]
}

Posicionamiento de firmas

Para la ubicación de los elementos <div> en el Complete HTML, consulta Configuración del HTML → Ubicación de Firmas.

Preguntas Obligatorias

La propiedad sign es un arreglo con los nombres de las preguntas que el usuario no puede saltar:

"sign": [
  "nombre_comprador",
  "email_comprador",
  "cedula_comprador"
]

info

El usuario debe completar obligatoriamente las preguntas registradas en sign.
Las preguntas de tipo signature son obligatorias automáticamente — no necesitas listarlas en sign.

Diferencias Clave: `clausula` vs `select` vs `searchlist`

Característica	Clausula	Select	Searchlist
¿Dropdown?	Sí	Sí	Sí, con input de búsqueda
Elementos HTML necesarios	Un `<span>` por opción	Un `<span>`	Un `<span>`
¿Puede limitar otras preguntas?	✅ Sí	❌ No	❌ No
¿Referenciable en `prereq.k`?	✅ Sí	❌ No	❌ No
Estructura de `options`	`{name, value}`	`{name, label, value}`	`{name, label, value}`
Cantidad recomendada de opciones	2–8	2–10	10+

Localización y defaults​

Propiedades Principales del Objeto Raíz​

Propiedad preBuild — Prellenado Automático​

Documentos adjuntos (files)​

config y sus tipos de preguntas​

Resumen de Tipos de Pregunta​

Texto Libre (text)​

Nombre (name)​

Número (number)​

Moneda (currency)​

Correo Electrónico (email)​

Teléfono (phone)​

Fecha (date)​

NIT (nit)​

Identificación (identification)​

Departamento (department)​

Lista Simple (select)​

Lista con Búsqueda (searchlist)​

Lista de Cláusulas (clausula)​

Múltiples Opciones (check)​

Imagen (image)​

Firma (signature)​

Request (request)​

Propiedades de Validación​

Ejemplo: fecha de nacimiento solo para mayores de edad​

Ejemplo: código alfanumérico estricto​

Ejemplo: groupQuestion (los campos deben sumar ≤ 100)​

Preguntas Condicionales con prereq​

Estructura​

Ejemplo Completo​

prereqOptionals — Lógica OR​

Perfiles de Firma (signatureProfile)​

Ejemplo — Un Firmante​

Ejemplo — Múltiples Identificaciones​

Correo y teléfono del firmante​

Firma en el momento (signature)​

Preguntas Obligatorias​

Diferencias Clave: clausula vs select vs searchlist​

Localización y defaults

Propiedades Principales del Objeto Raíz

Propiedad `preBuild` — Prellenado Automático

Documentos adjuntos (`files`)

`config` y sus tipos de preguntas

Resumen de Tipos de Pregunta

Texto Libre (`text`)

Nombre (`name`)

Número (`number`)

Moneda (`currency`)

Correo Electrónico (`email`)

Teléfono (`phone`)

Fecha (`date`)

NIT (`nit`)

Identificación (`identification`)

Departamento (`department`)

Lista Simple (`select`)

Lista con Búsqueda (`searchlist`)

Lista de Cláusulas (`clausula`)

Múltiples Opciones (`check`)

Imagen (`image`)

Firma (`signature`)

Request (`request`)

Propiedades de Validación

Ejemplo: fecha de nacimiento solo para mayores de edad

Ejemplo: código alfanumérico estricto

Ejemplo: `groupQuestion` (los campos deben sumar ≤ 100)

Preguntas Condicionales con `prereq`

Estructura

Ejemplo Completo

`prereqOptionals` — Lógica OR

Perfiles de Firma (`signatureProfile`)

Ejemplo — Un Firmante

Ejemplo — Múltiples Identificaciones

Correo y teléfono del firmante

Firma en el momento (`signature`)

Preguntas Obligatorias

Diferencias Clave: `clausula` vs `select` vs `searchlist`