apacuana-sdk-core 0.14.0 → 0.15.0

package/README.md

@@ -1,9 +1,11 @@
 # Apacuana SDK Core
 
 ## Descripción
+
 `Apacuana SDK Core` es una biblioteca de JavaScript que proporciona una interfaz para interactuar con los servicios de Apacuana, permitiendo la generación de certificados digitales, firma de documentos, y otras operaciones relacionadas con la identidad digital.
 
 ## Tabla de Contenidos
+
 - [Instalación](#instalación)
 - [Inicialización](#inicialización)
 - [Conceptos Clave](#conceptos-clave)
@@ -12,11 +14,13 @@
 - [Licencia](#licencia)
 
 ## Instalación
+
 ```bash
 npm install apacuana-sdk-core
 ```
 
 ## Inicialización
+
 Antes de utilizar el SDK, debes inicializarlo con tu configuración.
 
 ```javascript
@@ -40,7 +44,9 @@ try {
 ```
 
 ## Conceptos Clave
+
 ### Tipos de Integración
+
 El SDK soporta dos tipos de integración (`integrationType`) que determinan cómo se interactúa con la plataforma de Apacuana:
 
 - **`ONBOARDING`**: En este modo, Apacuana gestiona la mayor parte del proceso, como el registro de usuarios y la generación de certificados. Es el modo recomendado y soportado para la mayoría de las integraciones.
@@ -49,101 +55,267 @@ El SDK soporta dos tipos de integración (`integrationType`) que determinan cóm
 
 La elección del `integrationType` en la `init` es fundamental, ya que afecta a la disponibilidad y el comportamiento de muchos de los métodos del SDK.
 
+### Inicialización y acceso a funciones públicas/privadas
+
+El SDK puede inicializarse sin el parámetro `customerId`, lo que permite el acceso únicamente a las funciones públicas. Para acceder a las funciones privadas, es necesario inicializar el SDK incluyendo el `customerId` en la configuración.
+
+**Funciones públicas disponibles sin `customerId`:**
+
+- `getConfig()`
+- `getCertTypes()`
+- `getRequerimentsByTypeUser(params)`
+- `createApacuanaUser(userData)`
+
+**Funciones privadas (requieren `customerId`):**
+
+- `getCustomer()`
+- `generateCert(encryptedCSR)`
+- `getCertStatus(isCertificateInDevice)`
+- `addSigner(signerData)`
+- `getDocs(data)`
+- `getDigest(signData)`
+- `signDocument(signData)`
+- `uploadSignatureVariant(data)`
+- `getSignatureVariant()`
+- `deleteSignatureVariant()`
+- `createFaceLivenessSession()`
+- `validateFaceLiveness({ sessionId })`
+- `requestRevocation(params)`
+- `getRevocationReasons()`
+
+El SDK valida automáticamente si tienes acceso a cada función según la configuración actual, y lanzará un error si intentas acceder a una función privada sin haber inicializado correctamente con el `customerId`.
+
 ## Interfaz Pública
+
 Todas las funciones asíncronas devuelven una instancia de `ApacuanaSuccess` si tienen éxito, o lanzan una `ApacuanaAPIError` si fallan.
 
 ### `init(config)`
+
 Inicializa el SDK.
 
-- `config`: Objeto de configuración.
+#### Parámetros requeridos en `config`:
+
+| Propiedad         | Tipo   | Descripción                                                              |
+| ----------------- | ------ | ------------------------------------------------------------------------ |
+| `apiUrl`          | String | URL base de la API de Apacuana.                                          |
+| `secretKey`       | String | Clave secreta proporcionada por Apacuana.                                |
+| `apiKey`          | String | API Key proporcionada por Apacuana.                                      |
+| `verificationId`  | String | Identificador de verificación del cliente.                               |
+| `integrationType` | String | Tipo de integración. Valores permitidos: `ONBOARDING`, `ONPREMISE`.      |
+| `customerId`      | String | (Opcional) Identificador del usuario. Requerido para funciones privadas. |
+
+#### Comportamiento:
+
+- Si se inicializa **sin** `customerId`, el SDK solo permite el uso de funciones públicas.
+- Si se inicializa **con** `customerId`, el SDK obtiene el token y los datos del usuario, permitiendo el acceso a funciones privadas.
+- Si falta algún campo obligatorio o el `integrationType` no es válido, se lanzará un error.
+
+#### Ejemplo:
+
+```javascript
+import apacuana from "apacuana-sdk-core";
+
+const config = {
+  apiUrl: "https://api.url",
+  secretKey: "tu-secret-key",
+  apiKey: "tu-api-key",
+  verificationId: "tu-verification-id",
+  integrationType: "ONBOARDING", // o "ONPREMISE"
+  customerId: "tu-customer-id", // Opcional
+};
+
+try {
+  await apacuana.init(config);
+  console.log("SDK inicializado correctamente.");
+} catch (error) {
+  console.error("Error al inicializar el SDK:", error);
+}
+```
 
 ### `close()`
+
 Cierra la sesión del SDK y limpia la configuración.
 
 **Ejemplo:**
+
 ```javascript
 apacuana.close();
 console.log("Sesión del SDK cerrada.");
 ```
 
 ### `getConfig()`
+
 Devuelve la configuración actual.
 
 **Ejemplo:**
+
 ```javascript
 const currentConfig = apacuana.getConfig();
 console.log("Configuración actual:", currentConfig);
 ```
 
 ### `getCustomer()`
-Obtiene los datos del cliente. Este método es el punto de entrada para iniciar una sesión y obtener el token y la información del usuario.
 
-**Ejemplo:**
-```javascript
-try {
-  const response = await apacuana.getCustomer();
-  console.log("Datos del cliente:", response.data);
-} catch (error) {
-  console.error("Error al obtener el cliente:", error.message);
-}
+Obtiene los datos del usuario autenticado (customer) y su token de sesión. Este método solo está disponible si el SDK fue inicializado con customerId. No requiere parámetros de entrada. El resultado vendrá en el objeto `data` del response, incluyendo información relevante del usuario y el token de autenticación.
+
+**Ejemplo de uso:**
+
+```js
+const result = await apacuana.getCustomer();
+// result.data contendrá los datos del usuario y el token
 ```
 
 ### `generateCert(encryptedCSR)`
+
 Genera un nuevo certificado digital.
 
-- `encryptedCSR`: Objeto con la CSR encriptada.
-  - `csr` (String): El Certificate Signing Request encriptado.
+#### Parámetros:
+
+- `encryptedCSR`: Objeto con la propiedad obligatoria:
+  - `csr` (String): Certificate Signing Request encriptado (por ejemplo, en formato Base64).
+
+#### Comportamiento:
+
+- Solo disponible para `integrationType: ONBOARDING`. Si se usa con `ONPREMISE`, lanzará un error `NOT_IMPLEMENTED`.
+- Realiza una solicitud a la API y devuelve una instancia de `ApacuanaSuccess`.
+
+#### Respuesta:
+
+```js
+{
+  success: true,
+  data: {
+    cert: "...", // Certificado generado en formato string
+    certifiedid: "..." // ID del certificado generado
+  }
+}
+```
+
+#### Ejemplo:
 
-**Ejemplo:**
 ```javascript
 try {
   const csr = { csr: "MIIC...==" }; // CSR en formato Base64
   const response = await apacuana.generateCert(csr);
-  console.log("Certificado generado:", response.data);
+  console.log("Certificado generado:", response.data.cert);
+  console.log("ID del certificado:", response.data.certifiedid);
 } catch (error) {
   console.error("Error al generar el certificado:", error.message);
 }
 ```
 
 ### `getCertStatus(isCertificateInDevice)`
+
 Obtiene el estado del certificado del usuario.
 
-- `isCertificateInDevice` (Boolean): Indica si el certificado ya está almacenado localmente.
+#### Parámetros:
+
+- `isCertificateInDevice` (Boolean): Indica si el certificado ya está almacenado localmente en el dispositivo.
+
+#### Respuesta:
+
+```js
+{
+  success: true,
+  data: {
+    status: {
+      text: "...", // Estado legible del certificado
+      descriptionText: "..." // Descripción adicional (puede ser undefined)
+    }
+  }
+}
+```
+
+Los posibles valores de `text` incluyen:
+
+- "Por verificar"
+- "En revisión"
+- "Por generar"
+- "Vigente"
+- "Por revocar"
+- "Revocado"
+- "Verificado"
+- "Certificado expirado"
+
+#### Ejemplo:
 
-**Ejemplo:**
 ```javascript
 try {
   const response = await apacuana.getCertStatus(false);
-  console.log("Estado del certificado:", response.data);
+  console.log("Estado del certificado:", response.data.status.text);
+  if (response.data.status.descriptionText) {
+    console.log("Descripción:", response.data.status.descriptionText);
+  }
 } catch (error) {
   console.error("Error al obtener el estado del certificado:", error.message);
 }
 ```
 
 ### `getCertTypes()`
+
 Obtiene los tipos de certificados disponibles.
 
-**Ejemplo:**
+#### Comportamiento:
+
+- Solo disponible para `integrationType: ONBOARDING`. Si se usa con `ONPREMISE`, lanzará un error `NOT_IMPLEMENTED`.
+- Devuelve una instancia de `ApacuanaSuccess` con la propiedad `types`, que es un array de tipos de certificado.
+
+#### Respuesta:
+
+```js
+{
+  success: true,
+  data: {
+    types: [
+      { ... },
+      // ...otros tipos de certificado
+    ]
+  }
+}
+```
+
+#### Ejemplo:
+
 ```javascript
 try {
   const response = await apacuana.getCertTypes();
-  console.log("Tipos de certificados:", response.data);
+  console.log("Tipos de certificados:", response.data.types);
 } catch (error) {
   console.error("Error al obtener los tipos de certificado:", error.message);
 }
 ```
 
 ### `getRequerimentsByTypeUser(params)`
+
 Obtiene los requisitos para un tipo de certificado y usuario.
 
-- `params`: Objeto con los parámetros de la consulta.
+#### Parámetros:
+
+- `params`: Objeto con la propiedad obligatoria:
   - `type` (Number): El tipo de certificado.
 
-**Ejemplo:**
+#### Comportamiento:
+
+- Solo disponible para `integrationType: ONBOARDING`. Si se usa con `ONPREMISE`, lanzará un error `NOT_IMPLEMENTED`.
+- Devuelve una instancia de `ApacuanaSuccess`
+
+#### Respuesta:
+
+```js
+{
+  success: true,
+  data: {
+    ...
+  }
+}
+```
+
+#### Ejemplo:
+
 ```javascript
 try {
   const response = await apacuana.getRequerimentsByTypeUser({ type: 1 });
-  console.log("Requisitos:", response.data);
+  console.log("Requisitos:", response.data.requirements);
 } catch (error) {
   console.error("Error al obtener los requisitos:", error.message);
 }
@@ -151,170 +323,203 @@ try {
 
 ### `addSigner(signerData)`
 
-Añade un firmante a un documento. El comportamiento de esta función y sus campos obligatorios dependen del `integrationType` configurado durante la inicialización.
-
-- **Para `integrationType: 'ONBOARDING'`**:
-  Esta integración requiere que el documento se envíe como un archivo (`File` object). La validación de los datos se realiza a través de un helper que exige los siguientes campos:
-
-  - **`signerData`**: Objeto con los datos del firmante y el documento.
-    - `name` (String, **obligatorio**): Nombre del documento.
-    - `document` (File, **obligatorio**): El archivo del documento a firmar (ej. un PDF). No se puede usar junto con `reference`.
-    - `reference` (String, **obligatorio**): Referencia única para un documento ya existente en la plataforma. No se puede usar junto con `document`.
-    - `typedoc` (String, **obligatorio**): Tipo de documento de identidad del firmante. Valores permitidos: `"V"`, `"P"`, `"E"`.
-    - `doc` (String, **obligatorio**): Número de documento de identidad del firmante.
-    - `signature` (Array, **obligatorio**): Un array de objetos que definen la posición de la firma. Debe contener al menos un objeto con:
-      - `page` (Number, **obligatorio**): Página donde se estampará la firma (entero positivo).
-      - `x` (Number, **obligatorio**): Coordenada X (de 0 a 1).
-      - `y` (Number, **obligatorio**): Coordenada Y (de 0 a 1).
-
-  **Ejemplo (`ONBOARDING`):**
-  ```javascript
-  try {
-    // documentFile debe ser una instancia de File
-    const documentFile = new File(["contenido"], "contrato.pdf", { type: "application/pdf" });
-
-    const signer = {
-      name: "Contrato",
-      document: documentFile,
-      typedoc: "V",
-      doc: "12345678",
-      signature: [{ page: 1, x: 0.5, y: 0.5 }],
-    };
-    const response = await apacuana.addSigner(signer);
-    console.log("Firmante añadido:", response.data);
-  } catch (error) {
-    console.error("Error al añadir firmante:", error.message);
-  }
-  ```
-
-- **Para `integrationType: 'onpremise'`**:
-  En esta integración, el `signerData` se envía como un objeto JSON. El documento no se envía como un archivo. La validación es más flexible en el lado del cliente.
-
-  - **`signerData`**: Objeto con los datos del firmante.
-    - `name` (String): Nombre del documento.
-    - `reference` (String): Referencia única para el documento.
-    - `typedoc` (String): Tipo de documento de identidad del firmante.
-    - `doc` (String): Número de documento de identidad del firmante.
-    - `signature` (Array): Posición de la firma.
-
-  **Ejemplo (`onpremise`):**
-  ```javascript
-  try {
-    const signer = {
-      name: "Contrato",
-      reference: "REF-001",
-      typedoc: "V",
-      doc: "12345678",
-      signature: [{ page: 1, x: 0.5, y: 0.5 }],
-    };
-    const response = await apacuana.addSigner(signer);
-    console.log("Firmante añadido:", response.data);
-  } catch (error) {
-    console.error("Error al añadir firmante:", error.message);
-  }
-  ```
+Añade un firmante a un documento. El comportamiento y los campos obligatorios dependen del `integrationType` configurado durante la inicialización.
 
-### `getDocs(data)`
-Obtiene una lista paginada de documentos.
+#### Parámetros:
 
-- `data`: Objeto con parámetros de paginación (`page`, `size`) y filtro (`status`).
+- **`signerData`**: Objeto con los datos del firmante y el documento.
+  - `name` (String, **obligatorio**): Nombre del documento.
+  - `document` (File, **opcional**): El archivo del documento a firmar (ej. un PDF). No puede coexistir con `reference`.
+  - `reference` (String, **opcional**): Referencia única para un documento ya existente en la plataforma. No puede coexistir con `document`.
+  - `typedoc` (String, **obligatorio**): Tipo de documento de identidad del firmante. Valores permitidos: "V", "P", "E".
+  - `doc` (String, **obligatorio**): Número de documento de identidad del firmante.
+  - `signature` (Array, **obligatorio**): Un array de objetos que definen la posición de la firma. Debe contener al menos un objeto con:
+    - `page` (Number, **obligatorio**): Página donde se estampará la firma (entero positivo).
+    - `x` (Number, **obligatorio**): Coordenada X (de 0 a 1, porcentual respecto al ancho del PDF).
+    - `y` (Number, **obligatorio**): Coordenada Y (de 0 a 1, porcentual respecto al alto del PDF).
 
-**Ejemplo:**
-```javascript
-try {
-  const params = { page: 1, size: 10, status: 0 };
-  const response = await apacuana.getDocs(params);
-  console.log("Documentos:", response.data);
-} catch (error) {
-  console.error("Error al obtener los documentos:", error.message);
-}
-```
+**Notas sobre `document` y `reference`:**
 
-### `getDigest(signData)`
-Obtiene el digest de un documento para ser firmado. Un helper valida que se incluyan los siguientes campos obligatorios:
+- Solo uno de estos parámetros debe ser enviado. Si el cliente tiene integración con el gestor documental de Apacuana, se debe usar `reference` para referenciar el documento existente en la plataforma.
+- Si no existe integración documental, se debe enviar el archivo `document` (File). Este archivo será posteriormente solicitado para la firma del documento luego de ser asignado.
 
-- **`signData`**: Objeto con los siguientes datos:
-  - `cert` (String, **obligatorio**): El certificado en formato Base64.
-  - `signatureId` (String, **obligatorio**): El ID de la firma que se está procesando.
+**Notas sobre posicionamiento:**
+
+- Las coordenadas `x` e `y` son porcentuales y van de 0 a 1.
+- El origen (0,0) está en la esquina superior izquierda del PDF.
+- Ejemplos de posicionamiento:
+  - Esquina superior izquierda: `{ x: 0, y: 0 }`
+  - Esquina superior derecha: `{ x: 1, y: 0 }`
+  - Esquina inferior izquierda: `{ x: 0, y: 1 }`
+  - Centro de la página: `{ x: 0.5, y: 0.5 }`
+
+#### Ejemplo:
 
-**Ejemplo:**
 ```javascript
 try {
-  const params = {
-    cert: "MIIC...==", // Certificado en Base64
-    signatureId: "sig-123",
+  const signer = {
+    name: "Contrato",
+    document: documentFile, // Instancia de File
+    typedoc: "V",
+    doc: "12345678",
+    signature: [
+      { page: 1, x: 0, y: 0 }, // Esquina superior izquierda
+      { page: 1, x: 1, y: 0 }, // Esquina superior derecha
+      { page: 1, x: 0, y: 1 }, // Esquina inferior izquierda
+      { page: 1, x: 0.5, y: 0.5 }, // Centro de la página
+    ],
   };
-  const response = await apacuana.getDigest(params);
-  console.log("Digest del documento:", response.data);
+  const response = await apacuana.addSigner(signer);
+  console.log("Firmante añadido:", response.data);
 } catch (error) {
-  console.error("Error al obtener el digest:", error.message);
+  console.error("Error al añadir firmante:", error.message);
 }
 ```
 
-### `signDocument(signData)`
-Firma un documento utilizando el digest firmado. Un helper valida que se incluyan los siguientes campos obligatorios:
+### `getDocs(data)`
+
+Obtiene una lista paginada de documentos asociados al usuario autenticado, permitiendo aplicar filtros avanzados.
 
-- **`signData`**: Objeto con los siguientes datos:
-  - `signature` (Object, **obligatorio**): Objeto que contiene el ID de la firma y las posiciones.
-    - `id` (String, **obligatorio**): El ID de la firma.
-    - `positions` (Array, **obligatorio**): Un array de objetos para ajustar la posición de la firma.
-  - `cert` (String, **obligatorio**): El certificado en formato Base64.
-  - `signedDigest` (String, **obligatorio**): El digest del documento ya firmado.
-  - `document` (File, opcional): El archivo del documento, si es necesario para la integración.
+- `data`: Objeto con parámetros de paginación (`page`, `size`) y filtros opcionales (`status`, `type`, `dateFrom`, `dateTo`, `reference`, etc.). Puedes combinar estos filtros para obtener solo los documentos que cumplan con los criterios deseados.
 
 **Ejemplo:**
+
 ```javascript
 try {
   const params = {
-    signature: { 
-      id: "sig-123",
-      positions: [{ page: 1, x: 0.5, y: 0.5, status: 1 }]
-    },
-    cert: "MIIC...==",
-    signedDigest: "abc...",
+    page: 1,
+    size: 10,
+    status: 0, // Estado del documento
   };
-  const response = await apacuana.signDocument(params);
-  console.log("Documento firmado:", response.data);
+  const response = await apacuana.getDocs(params);
+  console.log("Documentos filtrados:", response.data);
 } catch (error) {
-  console.error("Error al firmar el documento:", error.message);
+  console.error("Error al obtener los documentos:", error.message);
 }
 ```
 
+**Notas:**
+
+- Si no se especifican filtros, se devolverán todos los documentos paginados.
+- Los filtros disponibles pueden variar según la integración y la versión de la API.
+
+### `getDigest(signData)`
+
+Obtiene el digest (resumen criptográfico) de un documento para el usuario autenticado. Este método requiere que el SDK esté inicializado con customerId.
+
+El parámetro `signData` debe incluir:
+
+- `cert` (String, obligatorio): Certificado en formato Base64.
+- `signatureId` (String, obligatorio): ID de la firma que se está procesando.
+- `document` (File, opcional): Archivo del documento a firmar.
+
+**Importante:**
+
+- Si en el método `addSigner` se utilizó el parámetro `reference`, no es necesario incluir el archivo `document` al obtener el digest, ya que el documento está referenciado en la plataforma.
+- Si en `addSigner` se utilizó el parámetro `document` (archivo), será necesario proporcionar nuevamente el archivo en este método para obtener el digest.
+
+Ejemplo de uso:
+
+```js
+// Caso con documento referenciado
+const result = await apacuana.getDigest({
+  cert: "MIIC...==",
+  signatureId: "sig-123",
+  // No se requiere document
+});
+
+// Caso con documento por archivo
+const result = await apacuana.getDigest({
+  cert: "MIIC...==",
+  signatureId: "sig-123",
+  document: documentFile, // Instancia de File
+});
+// result.data contendrá el digest y detalles para la firma
+```
+
+### `signDocument(signData)`
+
+Firma un documento utilizando el digest firmado y los datos de la firma. Este método requiere que el SDK esté inicializado con customerId.
+
+El parámetro `signData` debe incluir:
+
+- `signature` (Object, obligatorio):
+  - `id` (String): ID de la firma.
+  - `positions` (Array): Posiciones de la firma en el documento.
+- `cert` (String, obligatorio): Certificado en formato Base64.
+- `signedDigest` (String, obligatorio): Digest firmado del documento.
+- `document` (File, opcional): Archivo del documento a firmar.
+
+**Importante:**
+
+- Si en el método `addSigner` se utilizó el parámetro `reference`, no es necesario incluir el archivo `document` al firmar, ya que el documento está referenciado en la plataforma.
+- Si en `addSigner` se utilizó el parámetro `document` (archivo), será necesario proporcionar nuevamente el archivo en este método para completar la firma.
+
+Ejemplo de uso:
+
+```js
+// Caso con documento referenciado
+const result = await apacuana.signDocument({
+  signature: { id: "sig-123", positions: [{ page: 1, x: 0.5, y: 0.5 }] },
+  cert: "MIIC...==",
+  signedDigest: "abc...",
+  // No se requiere document
+});
+
+// Caso con documento por archivo
+const result = await apacuana.signDocument({
+  signature: { id: "sig-123", positions: [{ page: 1, x: 0.5, y: 0.5 }] },
+  cert: "MIIC...==",
+  signedDigest: "abc...",
+  document: documentFile, // Instancia de File
+});
+// result.data contendrá la información del documento firmado
+```
+
 ### `uploadSignatureVariant(data)`
-Sube una imagen de firma.
 
-- `data`: Objeto con la propiedad `file` (instancia de `File`, tipo `image/png`).
+Sube una imagen de variante de firma para el usuario autenticado. Este método requiere que el SDK esté inicializado con customerId.
 
-**Ejemplo:**
-```javascript
-// Este código se ejecutaría en un entorno de navegador
-const imageFile = new File(["..."], "firma.png", { type: "image/png" });
-try {
-  const response = await apacuana.uploadSignatureVariant({ file: imageFile });
-  console.log(response.data);
-} catch (error) {
-  console.error("Error al subir la firma:", error.message);
-}
+El parámetro `data` debe incluir:
+
+- `file` (File, obligatorio): Archivo de imagen en formato PNG (`image/png`).
+
+**Notas importantes:**
+
+- El archivo debe ser una instancia de `File` y tener el tipo MIME `image/png`.
+
+Ejemplo de uso:
+
+```js
+// En un entorno de navegador
+const imageFile = new File(
+  [
+    /* datos */
+  ],
+  "firma.png",
+  { type: "image/png" }
+);
+const result = await apacuana.uploadSignatureVariant({ file: imageFile });
+// result.data contendrá la información de la variante subida
 ```
 
 ### `getSignatureVariant()`
-Obtiene la imagen de la firma del usuario.
 
-**Ejemplo:**
-```javascript
-try {
-  const response = await apacuana.getSignatureVariant();
-  // La imagen viene en Base64
-  console.log("Firma obtenida (Base64):", response.data);
-} catch (error) {
-  console.error("Error al obtener la firma:", error.message);
-}
+Obtiene la imagen de la variante de firma registrada para el usuario autenticado. Este método solo está disponible si el SDK fue inicializado con customerId. No requiere parámetros de entrada. El resultado vendrá en el objeto `data` del response, normalmente como una cadena en formato Base64 que representa la imagen de la firma.
+
+Ejemplo de uso:
+
+```js
+const result = await apacuana.getSignatureVariant();
+// result.data contendrá la imagen en Base64
 ```
 
 ### `deleteSignatureVariant()`
-Elimina la imagen de la firma del usuario.
+
+Elimina la variante de firma almacenada para el usuario autenticado. Este método solo está disponible si el SDK fue inicializado con un customerId. No requiere parámetros de entrada. Si la operación es exitosa, el resultado vendrá en el objeto `data` del response. Si no existe una variante de firma registrada, la operación no tendrá efecto y el resultado indicará el estado actual.
 
 **Ejemplo:**
+
 ```javascript
 try {
   const response = await apacuana.deleteSignatureVariant();
@@ -325,27 +530,29 @@ try {
 ```
 
 ### `createFaceLivenessSession()`
-Crea una sesión de prueba de vida.
 
-**Ejemplo:**
-```javascript
-try {
-  const response = await apacuana.createFaceLivenessSession();
-  console.log("ID de sesión de prueba de vida:", response.data);
-} catch (error) {
-  console.error("Error al crear la sesión:", error.message);
-}
+Crea una nueva sesión de prueba de vida (face liveness) para el usuario autenticado. Este método solo está disponible si el SDK fue inicializado con customerId. No requiere parámetros de entrada. El resultado vendrá en el objeto `data` del response, incluyendo el identificador único de la sesión creada.
+
+Ejemplo de uso:
+
+```js
+const result = await apacuana.createFaceLivenessSession();
+// result.data contendrá el ID de la sesión de prueba de vida
 ```
 
 ### `validateFaceLiveness({ sessionId })`
+
 Valida el resultado de una sesión de prueba de vida.
 
 - `sessionId` (String, **obligatorio**): El ID de la sesión de prueba de vida que se va a validar.
 
 **Ejemplo:**
+
 ```javascript
 try {
-  const response = await apacuana.validateFaceLiveness({ sessionId: "your-session-id" });
+  const response = await apacuana.validateFaceLiveness({
+    sessionId: "your-session-id",
+  });
   console.log("Resultado de la validación:", response.data);
 } catch (error) {
   console.error("Error al validar la sesión de prueba de vida:", error.message);
@@ -353,11 +560,109 @@ try {
 ```
 
 ### `requestRevocation(params)`
-Solicita la revocación de un certificado.
 
-- `params`: Objeto con la propiedad `reasonCode` (numérico).
+Solicita la revocación de un certificado. Este método puede llamarse varias veces para ir completando la información de forma parcial; no es necesario enviar todos los documentos en una sola llamada. Sin embargo, en cada actualización es obligatorio enviar el número de documento de identidad (`doc`). El registro inicial debe incluir el documento de identidad.
+
+Los documentos requeridos se obtienen previamente usando el método `getRequerimentsByTypeUser`. Deben enviarse bajo la estructura `{ file-ID: File }`, donde cada clave corresponde al identificador del documento y el valor es el archivo correspondiente.
+
+Ejemplo de estructura de parámetros:
+
+```js
+{
+  reasonCode: 1, // Código de la razón de revocación
+  doc: "12345678", // Documento de identidad (obligatorio en cada llamada)
+  files: {
+    "file-1": file1, // Instancia de File
+    "file-2": file2
+    // ...otros documentos según los requerimientos
+  }
+}
+```
+
+El objeto completo de usuario que puede acompañar la solicitud es:
+
+```js
+{
+  email: "usuario@correo.com",
+  typeuser: 1,
+  name: "Nombre",
+  lastname: "Apellido",
+  kinddoc: "V",
+  doc: 12345678,
+  birthdate: "1990-01-01",
+  kindrif: "V",
+  gender: "M",
+  rif: 12345678,
+  phone: 4121234567,
+  kindphone: "0424",
+  state: "Estado",
+  municipality: "Municipio",
+  parish: "Parroquia",
+  postalcode: "1010",
+  address: "Dirección",
+  fiscaladdress: "Dirección fiscal",
+  fiscalkindphone: "0424",
+  fiscalphone: 4121234567,
+  occupation: "Ocupación",
+  degree: "Título",
+  university: "Universidad",
+  graduationyear: "2010",
+  collegiatenumber: "12345",
+  collegiateyear: "2011",
+  companyname: "Empresa",
+  companykindrif: "J",
+  companyrif: "J12345678",
+  companystate: "Estado",
+  companymunicipality: "Municipio",
+  companyparish: "Parroquia",
+  companyaddress: "Dirección empresa",
+  companykindphone: "0212",
+  companyphone: "2121234567",
+  companypostalcode: "1010",
+  companywebpage: "https://empresa.com",
+  companycommercialregister: "Registro comercial",
+  companyregisterdate: "2015-01-01",
+  companyregisternumber: "123456",
+  companyconstitutiondate: "2015-01-01",
+  companypublishdate: "2015-01-01",
+  companyconstitutiondecree: "Decreto",
+  companynumberdecree: "123",
+  positionprivate: "Cargo privado",
+  departmentprivate: "Departamento privado",
+  authorizedprivate: "Autorizado privado",
+  functionsprivate: "Funciones privado",
+  publishprivate: "2015-01-01",
+  issuedateprivate: "2015-01-01",
+  kindphoneprivate: "0424",
+  phoneprivate: 4121234567,
+  positionpublic: "Cargo público",
+  departmentpublic: "Departamento público",
+  authorizedpublic: "Autorizado público",
+  functionspublic: "Funciones público",
+  publishpublic: "2015-01-01",
+  issuedatepublic: "2015-01-01",
+  kindphonepublic: "0424",
+  phonepublic: 4121234567,
+  companyid: "uuid-empresa"
+}
+```
+
+#### Comportamiento:
+
+- Solo disponible para `integrationType: ONBOARDING`. Si se usa con `ONPREMISE`, lanzará un error `NOT_IMPLEMENTED`.
+- Realiza una solicitud a la API y devuelve una instancia de `ApacuanaSuccess` con un mensaje de confirmación.
+
+#### Respuesta:
+
+```js
+{
+  success: true,
+  data: {}
+}
+```
+
+#### Ejemplo:
 
-**Ejemplo:**
 ```javascript
 try {
   const response = await apacuana.requestRevocation({ reasonCode: 1 });
@@ -368,39 +673,160 @@ try {
 ```
 
 ### `getRevocationReasons()`
-Obtiene la lista de razones para la revocación.
 
-**Ejemplo:**
+Obtiene la lista de razones para la revocación de certificados.
+
+#### Comportamiento:
+
+- Solo disponible para `integrationType: ONBOARDING`. Si se usa con `ONPREMISE`, lanzará un error `NOT_IMPLEMENTED`.
+- Devuelve una instancia de `ApacuanaSuccess` con un array de razones.
+
+#### Respuesta:
+
+```js
+{
+  success: true,
+  data: {
+    reasons: [ /* array de razones de revocación proporcionadas por la API */ ]
+  }
+}
+```
+
+#### Ejemplo:
+
 ```javascript
 try {
   const response = await apacuana.getRevocationReasons();
-  console.log("Razones de revocación:", response.data);
+  console.log("Razones de revocación:", response.data.reasons);
 } catch (error) {
   console.error("Error al obtener las razones de revocación:", error.message);
 }
 ```
 
+### `createApacuanaUser(userData)`
+
+Crea un nuevo usuario en la plataforma de Apacuana. Este método puede llamarse varias veces para ir completando la información de forma parcial; no es necesario enviar todos los datos en una sola llamada. Sin embargo, en cada actualización es obligatorio enviar el número de documento de identidad (`kinddoc+doc`). El registro inicial debe incluir el documento de identidad.
+
+Los documentos requeridos para el usuario se obtienen previamente usando el método `getRequerimentsByTypeUser` y deben enviarse bajo la estructura `{ file-ID: File }`, donde cada clave corresponde al identificador del documento y el valor es el archivo correspondiente.
+
+El objeto completo de usuario que puede acompañar la solicitud es:
+
+```js
+{
+  email: "usuario@correo.com",
+  typeuser: 1,
+  name: "Nombre",
+  lastname: "Apellido",
+  kinddoc: "V",
+  doc: 12345678,
+  birthdate: "1990-01-01",
+  kindrif: "V",
+  gender: "M",
+  rif: 12345678,
+  phone: 4121234567,
+  kindphone: "0424",
+  state: "Estado",
+  municipality: "Municipio",
+  parish: "Parroquia",
+  postalcode: "1010",
+  address: "Dirección",
+  fiscaladdress: "Dirección fiscal",
+  fiscalkindphone: "0424",
+  fiscalphone: 4121234567,
+  occupation: "Ocupación",
+  degree: "Título",
+  university: "Universidad",
+  graduationyear: "2010",
+  collegiatenumber: "12345",
+  collegiateyear: "2011",
+  companyname: "Empresa",
+  companykindrif: "J",
+  companyrif: "J12345678",
+  companystate: "Estado",
+  companymunicipality: "Municipio",
+  companyparish: "Parroquia",
+  companyaddress: "Dirección empresa",
+  companykindphone: "0212",
+  companyphone: "2121234567",
+  companypostalcode: "1010",
+  companywebpage: "https://empresa.com",
+  companycommercialregister: "Registro comercial",
+  companyregisterdate: "2015-01-01",
+  companyregisternumber: "123456",
+  companyconstitutiondate: "2015-01-01",
+  companypublishdate: "2015-01-01",
+  companyconstitutiondecree: "Decreto",
+  companynumberdecree: "123",
+  positionprivate: "Cargo privado",
+  departmentprivate: "Departamento privado",
+  authorizedprivate: "Autorizado privado",
+  functionsprivate: "Funciones privado",
+  publishprivate: "2015-01-01",
+  issuedateprivate: "2015-01-01",
+  kindphoneprivate: "0424",
+  phoneprivate: 4121234567,
+  positionpublic: "Cargo público",
+  departmentpublic: "Departamento público",
+  authorizedpublic: "Autorizado público",
+  functionspublic: "Funciones público",
+  publishpublic: "2015-01-01",
+  issuedatepublic: "2015-01-01",
+  kindphonepublic: "0424",
+  phonepublic: 4121234567,
+  companyid: "uuid-empresa"
+}
+```
+
+**Ejemplo:**
+
+```javascript
+try {
+  const userData = {
+    usr: "usuario@correo.com",
+    pwd: "contraseñaSegura123",
+    kinddoc: "V",
+    doc: "12345678",
+    // ...otros campos opcionales
+    files: {
+      "file-1": file1, // Instancia de File
+      "file-2": file2,
+      // ...otros documentos según los requerimientos
+    },
+  };
+  const response = await apacuana.createApacuanaUser(userData);
+  console.log("Usuario creado:", response.data);
+} catch (error) {
+  console.error("Error al crear el usuario:", error.message);
+}
+```
+
 ## Manejo de Errores
+
 El SDK utiliza dos clases personalizadas para gestionar los resultados: `ApacuanaSuccess` para éxitos y `ApacuanaAPIError` para fallos.
 
 ### `ApacuanaSuccess`
+
 Cuando una operación se completa correctamente, la promesa se resuelve con una instancia de `ApacuanaSuccess`.
 
 **Propiedades:**
+
 - `success` (Boolean): Siempre `true`.
 - `statusCode` (Number): El código de estado HTTP de la respuesta (ej. `200`).
 - `data` (Object): El cuerpo de la respuesta de la API.
 
 ### `ApacuanaAPIError`
+
 Cuando la API devuelve un error, la promesa es rechazada con una instancia de `ApacuanaAPIError`.
 
 **Propiedades:**
+
 - `success` (Boolean): Siempre `false`.
 - `statusCode` (Number): El código de estado HTTP del error (ej. `400`, `404`, `500`).
 - `errorCode` (String): Un código de error específico de Apacuana (ej. `INVALID_PARAMS`).
 - `message` (String): Una descripción legible del error.
 
 **Ejemplo de manejo de errores:**
+
 ```javascript
 try {
   // Forzamos un error
@@ -419,19 +845,20 @@ try {
 
 ### Listado de Códigos de Error
 
-| `errorCode` | Descripción |
-| :--- | :--- |
-| `CONFIGURATION_ERROR` | Error en la configuración del SDK (ej. falta `apiKey`). |
-| `INVALID_API_RESPONSE` | La respuesta de la API no tiene el formato esperado. |
-| `INVALID_PARAMETER` | Uno o más parámetros de la función son inválidos. |
-| `INVALID_PARAMETER_FORMAT` | El formato de un parámetro es incorrecto. |
-| `LOGICAL_API_ERROR` | Error lógico devuelto por la API. |
-| `NETWORK_ERROR` | Error de red, CORS o timeout. |
-| `NOT_IMPLEMENTED` | La funcionalidad no está implementada para el `integrationType` actual. |
-| `UNSUPPORTED_HTTP_METHOD` | Se utilizó un método HTTP no soportado. |
-| `UNSUPPORTED_INTEGRATION_TYPE` | El `integrationType` no es válido. |
-| `UNKNOWN_REQUEST_ERROR` | Error desconocido durante la petición. |
-| `API_RESPONSE_ERROR` | La respuesta de la API contiene un error. |
+| `errorCode`                    | Descripción                                                             |
+| :----------------------------- | :---------------------------------------------------------------------- |
+| `CONFIGURATION_ERROR`          | Error en la configuración del SDK (ej. falta `apiKey`).                 |
+| `INVALID_API_RESPONSE`         | La respuesta de la API no tiene el formato esperado.                    |
+| `INVALID_PARAMETER`            | Uno o más parámetros de la función son inválidos.                       |
+| `INVALID_PARAMETER_FORMAT`     | El formato de un parámetro es incorrecto.                               |
+| `LOGICAL_API_ERROR`            | Error lógico devuelto por la API.                                       |
+| `NETWORK_ERROR`                | Error de red, CORS o timeout.                                           |
+| `NOT_IMPLEMENTED`              | La funcionalidad no está implementada para el `integrationType` actual. |
+| `UNSUPPORTED_HTTP_METHOD`      | Se utilizó un método HTTP no soportado.                                 |
+| `UNSUPPORTED_INTEGRATION_TYPE` | El `integrationType` no es válido.                                      |
+| `UNKNOWN_REQUEST_ERROR`        | Error desconocido durante la petición.                                  |
+| `API_RESPONSE_ERROR`           | La respuesta de la API contiene un error.                               |
 
 ## Licencia
+
 Este SDK está distribuido bajo una licencia propietaria. Para más detalles, contacte con el equipo de Apacuana.

package/coverage/clover.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<coverage generated="1758635127388" clover="3.2.0">
-  <project timestamp="1758635127388" name="All files">
+<coverage generated="1758816883044" clover="3.2.0">
+  <project timestamp="1758816883044" name="All files">
     <metrics statements="563" coveredstatements="324" conditionals="388" coveredconditionals="134" methods="95" coveredmethods="49" elements="1046" coveredelements="507" complexity="0" loc="563" ncloc="563" packages="6" files="12" classes="12"/>
     <package name="src">
       <metrics statements="57" coveredstatements="15" conditionals="15" coveredconditionals="3" methods="20" coveredmethods="1"/>

package/coverage/lcov-report/index.html

@@ -176,7 +176,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-09-23T13:45:27.346Z
+                at 2025-09-25T16:14:42.985Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/coverage/lcov-report/src/api/certs.js.html

@@ -835,7 +835,7 @@ export const requestCertificate = async (params) => {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-09-23T13:45:27.346Z
+                at 2025-09-25T16:14:42.985Z
             </div>
         <script src="../../prettify.js"></script>
         <script>

package/coverage/lcov-report/src/api/faceLiveness.js.html

@@ -508,7 +508,7 @@ export const validateFaceLiveness = async ({ sessionId }) => {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-09-23T13:45:27.346Z
+                at 2025-09-25T16:14:42.985Z
             </div>
         <script src="../../prettify.js"></script>
         <script>

package/coverage/lcov-report/src/api/index.html

@@ -161,7 +161,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-09-23T13:45:27.346Z
+                at 2025-09-25T16:14:42.985Z
             </div>
         <script src="../../prettify.js"></script>
         <script>

package/coverage/lcov-report/src/api/revocations.js.html

@@ -397,7 +397,7 @@ export const getRevocationReasons = async () => {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-09-23T13:45:27.346Z
+                at 2025-09-25T16:14:42.985Z
             </div>
         <script src="../../prettify.js"></script>
         <script>

package/coverage/lcov-report/src/api/signatures.js.html

@@ -1405,7 +1405,7 @@ export const deleteSignatureVariant = async () => {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-09-23T13:45:27.346Z
+                at 2025-09-25T16:14:42.985Z
             </div>
         <script src="../../prettify.js"></script>
         <script>

package/coverage/lcov-report/src/api/users.js.html

@@ -433,7 +433,7 @@ export const createApacuanaUser = <span class="fstat-no" title="function not cov
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-09-23T13:45:27.346Z
+                at 2025-09-25T16:14:42.985Z
             </div>
         <script src="../../prettify.js"></script>
         <script>

package/coverage/lcov-report/src/config/index.html

@@ -101,7 +101,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-09-23T13:45:27.346Z
+                at 2025-09-25T16:14:42.985Z
             </div>
         <script src="../../prettify.js"></script>
         <script>

package/coverage/lcov-report/src/config/index.js.html

@@ -241,7 +241,7 @@ export const close = <span class="fstat-no" title="function not covered" >()</sp
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-09-23T13:45:27.346Z
+                at 2025-09-25T16:14:42.985Z
             </div>
         <script src="../../prettify.js"></script>
         <script>

package/coverage/lcov-report/src/errors/index.html

@@ -101,7 +101,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-09-23T13:45:27.346Z
+                at 2025-09-25T16:14:42.985Z
             </div>
         <script src="../../prettify.js"></script>
         <script>

package/coverage/lcov-report/src/errors/index.js.html

@@ -133,7 +133,7 @@ export default ApacuanaAPIError;
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-09-23T13:45:27.346Z
+                at 2025-09-25T16:14:42.985Z
             </div>
         <script src="../../prettify.js"></script>
         <script>

package/coverage/lcov-report/src/index.html

@@ -101,7 +101,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-09-23T13:45:27.346Z
+                at 2025-09-25T16:14:42.985Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/src/index.js.html

@@ -577,7 +577,7 @@ export default apacuana;
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-09-23T13:45:27.346Z
+                at 2025-09-25T16:14:42.985Z
             </div>
         <script src="../prettify.js"></script>
         <script>

package/coverage/lcov-report/src/success/index.html

@@ -101,7 +101,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-09-23T13:45:27.346Z
+                at 2025-09-25T16:14:42.985Z
             </div>
         <script src="../../prettify.js"></script>
         <script>

package/coverage/lcov-report/src/success/index.js.html

@@ -91,7 +91,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-09-23T13:45:27.346Z
+                at 2025-09-25T16:14:42.985Z
             </div>
         <script src="../../prettify.js"></script>
         <script>

package/coverage/lcov-report/src/utils/constant.js.html

@@ -241,7 +241,7 @@ export const INTEGRATION_TYPE = {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-09-23T13:45:27.346Z
+                at 2025-09-25T16:14:42.985Z
             </div>
         <script src="../../prettify.js"></script>
         <script>

package/coverage/lcov-report/src/utils/helpers.js.html

@@ -1108,7 +1108,7 @@ export default {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-09-23T13:45:27.346Z
+                at 2025-09-25T16:14:42.985Z
             </div>
         <script src="../../prettify.js"></script>
         <script>

package/coverage/lcov-report/src/utils/httpClient.js.html

@@ -607,7 +607,7 @@ export const httpRequest = <span class="fstat-no" title="function not covered" >
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-09-23T13:45:27.346Z
+                at 2025-09-25T16:14:42.985Z
             </div>
         <script src="../../prettify.js"></script>
         <script>

package/coverage/lcov-report/src/utils/index.html

@@ -131,7 +131,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-09-23T13:45:27.346Z
+                at 2025-09-25T16:14:42.985Z
             </div>
         <script src="../../prettify.js"></script>
         <script>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apacuana-sdk-core",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "Core SDK para interacciones con las APIs de Apacuana.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",