Ejemplos — Consulta masiva de folios

Este archivo contiene únicamente ejemplos del endpoint de consulta masiva de folios. Se utiliza cuando ya existe una operación de firma masiva y se desea conocer el estado de todos los folios asociados.

---

Endpoint

GET https://www.sandboxadmin.firmaris.co/api/integrations/consult_massive_sign?massiveId={massiveId}

---

Headers utilizados en todos los ejemplos

x-api-key: Bearer {TOKEN_EMPRESA}
Content-Type: application/json

---

Ejemplo básico de solicitud

GET https://www.sandboxadmin.firmaris.co/api/integrations/consult_massive_sign?massiveId=a1b2c3d4e5f6g7h8i9j0

---

Ejemplo de solicitud en Postman

{
  "method": "GET",
  "url": "https://www.sandboxadmin.firmaris.co/api/integrations/consult_massive_sign?massiveId=a1b2c3d4e554deh8i9j0",
  "headers": {
    "x-api-key": "Bearer sandbox_token_empresa_123",
    "Content-Type": "application/json"
  }
}

---

Respuesta exitosa (200 OK)

{
  "success": true,
  "status": 200,
  "message": "Consulta de folios completada con éxito.",
  "data": [
    {
      "folioData": {
        "folioId": "5aff20374bf33a5afed79dc67ad1f0b5a4519eb387d9edd7136692f11f4a6358",
        "name": "CP-CPRUEB2-MSAAYUDA-AC-25-00023",
        "message": "Para poder continuar con el proceso se debe firmar el documento",
        "observation": null,
        "dateCreate": "2025-08-14 15:49:25",
        "dateLastUpdate": "2025-08-14 16:08:17",
        "state": "1",
        "flag_drop": "0",
        "stateName": "FIRMADO",
        "signatureType": "1",
        "signatureTypeName": "OTP Básico"
      },
      "documents": [
        {
          "documentId": "9d451754702d3a2c27447c61ffsdf6475hcf7ef7989f7266eee33c29402a5b27",
          "name": "EJEMPLO.pdf",
          "dateCreate": "2025-08-14 15:49:25"
        }
      ],
      "signers": [
        {
          "name": "Nombre Completo",
          "documentType": "CC",
          "documentNumber": "1111111111",
          "email": "correo@ejemplo.com",
          "cellPhoneNumber": "3001254768",
          "folioState": "1",
          "folioStateName": "FIRMADO",
          "ipSignatureAddress": "25.150.60.100",
          "dateLastUpdate": "2025-08-14 15:50:09"
        }
      ]
    }
  ]
}

---

Ejemplo de error — massiveId inválido (400)

{
  "success": false,
  "status": 400,
  "message": "El massiveId proporcionado no es válido."
}

---

Ejemplo de error — Acceso denegado (403)

{
  "success": false,
  "status": 403,
  "message": "Acceso denegado. No tiene los permisos necesarios para acceder a este recurso."
}

---

Ejemplo de error — Operación no encontrada (404)

{
  "success": false,
  "status": 404,
  "message": "La operación masiva solicitada no existe."
}