apacuana-sdk-core 1.26.4 → 1.26.6

package/.env

@@ -4,5 +4,6 @@ APACUANA_API_KEY=07NTZW6cCgSCKjhzSe1UJ2uJ6fTXHaAFKcfDtJqV5Vnhg0h2BitNr6iYCeM7ZZ7
 APACUANA_VERIFICATION_ID=53d1daa5-cc7a-4a70-ae46-1a3e8a405f7a
 APACUANA_INTEGRATION_TYPE=ONBOARDING
 APACUANA_CUSTOMER_ID=0f313054-f923-4905-98bb-0158c2f59a91
-APACUANA_DOCUMENT_ID=cc3ff044-966b-412d-af48-7ccc628b8cb8
-APACUANA_DOCUMENT_REFERENCE=reunion-bdt-2
+APACUANA_DOCUMENT_ID="cec8223c-8082-4fc5-9f5d-d92fe54273b5"
+APACUANA_DOCUMENT_REFERENCE=reunion-bdt-2
+APACUANA_SIGNATURE_ID="ac858b65-da56-4a4f-9401-fcccfca67b79"

package/README.md

@@ -67,6 +67,7 @@ El SDK puede inicializarse sin el parámetro `customerId`, lo que permite el acc
 - `createApacuanaUser(params)`
 - `createDocument(params)`
 - `lockDocument(documentId)`
+- `deleteSignature(params)`
 
 **Funciones privadas (requieren `customerId`):**
 
@@ -414,9 +415,10 @@ try {
 
 Obtiene una lista paginada de documentos asociados al usuario autenticado, permitiendo aplicar filtros avanzados.
 
-- `data`: Objeto con parámetros de paginación (`page`, `size`) y filtros opcionales (`status`). Puedes combinar estos filtros para obtener solo los documentos que cumplan con los criterios deseados.
+- `data`: Objeto con parámetros de paginación (`page`, `size`) y filtros opcionales (`status`, `blocked`). Puedes combinar estos filtros para obtener solo los documentos que cumplan con los criterios deseados.
 
 - `filtros` : (`status`) 0 pendiente, 1 = completado/firmado, -1 rechazado
+- `filtros` : (`blocked`) 0 = no bloqueados, 1 = bloqueados. Si se omite, retorna todos independientemente de su estado de bloqueo.
 
 **Ejemplo:**
 
@@ -426,6 +428,7 @@ try {
     page: 1,
     size: 10,
     status: 0, // Estado del documento
+    blocked: 0, // Solo documentos no bloqueados
   };
   const response = await apacuana.getDocs(params);
   console.log("Documentos filtrados:", response.data);
@@ -595,6 +598,36 @@ try {
 
 `````
 
+### `deleteSignature(params)`
+
+Elimina la firma de un firmante de un documento existente. Este método **no requiere `customerId`** para ser invocado y se autentica únicamente con las API keys (`apiKey` y `secretKey`).
+
+#### Parámetros:
+
+- **`params`**: Objeto con los identificadores requeridos.
+  - `documentId` (String, **obligatorio**): ID (UUID) del documento del que se eliminará la firma.
+  - `signatureId` (String, **obligatorio**): ID (UUID) de la firma que se desea eliminar.
+
+#### Comportamiento:
+
+- Solo disponible para `integrationType: ONBOARDING`. Si se usa con `ONPREMISE`, lanzará un error `NOT_IMPLEMENTED`.
+- Realiza una solicitud DELETE al endpoint `services/api/documents/signature` enviando `{ documentid, signatureid }` en el cuerpo, sin enviar el header `Authorization`.
+- Si la firma ya fue eliminada, la API responde con `"Firma no encontrada"`. Si la operación es exitosa, responde con `"Firma eliminada"`.
+
+#### Ejemplo:
+
+```javascript
+try {
+  const response = await apacuana.deleteSignature({
+    documentId: "cc3ff044-966b-412d-af48-7ccc628b8cb8",
+    signatureId: "cc3ff044-966b-412d-af48-7ccc628b8cb8",
+  });
+  console.log("Firma eliminada:", response.data);
+} catch (error) {
+  console.error("Error al eliminar la firma:", error.message);
+}
+```
+
 ### `deleteSignatureVariant()`
 
 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.