{
  "info": {
    "name": "Wapi Firma API",
    "description": "Collection oficial de la API de Wapi Firma.\n\nConfigurá las variables de la collection antes de usarla:\n\n- `api_key`: tu API key (header x-api-key)\n- `id_seguimiento`: ID de seguimiento de un documento tuyo\n- `id_custom`: identificador de un firmante (lo devuelve Solicitar Documento)\n- `photo_type`: `selfie` o `dni`\n\nLos archivos (PDF firmado, reporte, fotos) se devuelven como bytes binarios: en Postman usá \"Send and Download\" (Ctrl/Cmd + Alt + Enter) para guardarlos.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    { "key": "base_url", "value": "https://api.wapifirma.com" },
    { "key": "api_key", "value": "TU_API_KEY" },
    { "key": "id_seguimiento", "value": "d4dc281aceb48e11fa" },
    { "key": "id_custom", "value": "F5384BECE0574D809CC129F90C90253B" },
    { "key": "photo_type", "value": "selfie" }
  ],
  "item": [
    {
      "name": "Solicitar Documento",
      "request": {
        "method": "POST",
        "header": [
          { "key": "x-api-key", "value": "{{api_key}}" },
          { "key": "Content-Type", "value": "application/json" }
        ],
        "url": {
          "raw": "{{base_url}}/api/v2/documentSet",
          "host": ["{{base_url}}"],
          "path": ["api", "v2", "documentSet"]
        },
        "body": {
          "mode": "raw",
          "raw": "{\n    \"document\": \"https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf\",\n    \"firma_en_todas_las_hojas\": true,\n    \"document_name\": \"dummy\",\n    \"validate_photos\": true,\n    \"request_photos\": true,\n    \"custom_parameters\": {\n        \"poliza\": 210,\n        \"codigo_interno\": \"A-21\"\n    },\n    \"webhook_url\": \"https://tu-servidor.com/webhook\",\n    \"webhook_key\": { \"key\": \"value\" },\n    \"wpp\": true,\n    \"datos_firmantes\": [\n        {\n            \"name\": \"Luis Lacoste\",\n            \"dni\": \"43795269\",\n            \"dni_country\": \"AR\",\n            \"phone\": \"5493586005012\",\n            \"position\": 1\n        }\n    ]\n}"
        },
        "description": "Solicita el envío de un documento a firmar. El documento y sus archivos asociados quedan en almacenamiento privado (sin URL pública)."
      }
    },
    {
      "name": "Carga Masiva",
      "request": {
        "method": "POST",
        "header": [
          { "key": "x-api-key", "value": "{{api_key}}" },
          { "key": "Content-Type", "value": "application/json" }
        ],
        "url": {
          "raw": "{{base_url}}/api/sendCargaMasiva",
          "host": ["{{base_url}}"],
          "path": ["api", "sendCargaMasiva"]
        },
        "body": {
          "mode": "raw",
          "raw": "{\n  \"document_type\": \"docx\",\n  \"document\": \"<base64-del-documento>\",\n  \"request_photos\": true,\n  \"validate_photos\": true,\n  \"df\": [\n    {\n      \"id\": 123,\n      \"nombre y apellido\": \"Juan Pérez\",\n      \"dni\": \"12345678\",\n      \"whatsapp\": \"5491122334455\",\n      \"estado_civil\": \"soltero\"\n    }\n  ],\n  \"firmante\": {\n    \"page\": 1,\n    \"position_x\": 120,\n    \"position_y\": 450\n  },\n  \"webhook_url\": \"https://tu-servidor.com/webhook\",\n  \"webhook_key\": { \"key\": \"value\" }\n}"
        },
        "description": "Envío masivo de documentos DOCX para firma vía WhatsApp, con reemplazo de variables por firmante ({variable} en el DOCX)."
      }
    },
    {
      "name": "Listar Documentos",
      "request": {
        "method": "GET",
        "header": [
          { "key": "x-api-key", "value": "{{api_key}}" }
        ],
        "url": {
          "raw": "{{base_url}}/api/v2/list?page=1",
          "host": ["{{base_url}}"],
          "path": ["api", "v2", "list"],
          "query": [
            { "key": "page", "value": "1" },
            { "key": "dni", "value": "43795269", "disabled": true },
            { "key": "id_seguimiento", "value": "{{id_seguimiento}}", "disabled": true },
            { "key": "start_date", "value": "1736900000", "disabled": true },
            { "key": "end_date", "value": "1737000000", "disabled": true },
            { "key": "label", "value": "mi-etiqueta", "disabled": true },
            { "key": "is_finished", "value": "true", "disabled": true },
            { "key": "not_signed", "value": "false", "disabled": true }
          ]
        },
        "description": "Lista paginada de documentos enviados. Sin links a archivos: para el PDF usá Descargar Documento."
      }
    },
    {
      "name": "Descargar Documento Firmado",
      "request": {
        "method": "GET",
        "header": [
          { "key": "x-api-key", "value": "{{api_key}}" }
        ],
        "url": {
          "raw": "{{base_url}}/api/v2/documents/{{id_seguimiento}}",
          "host": ["{{base_url}}"],
          "path": ["api", "v2", "documents", "{{id_seguimiento}}"]
        },
        "description": "Devuelve el PDF firmado en binario. En Postman usá \"Send and Download\" para guardarlo."
      }
    },
    {
      "name": "Descargar Reporte",
      "request": {
        "method": "GET",
        "header": [
          { "key": "x-api-key", "value": "{{api_key}}" }
        ],
        "url": {
          "raw": "{{base_url}}/api/v2/reporte/{{id_seguimiento}}",
          "host": ["{{base_url}}"],
          "path": ["api", "v2", "reporte", "{{id_seguimiento}}"]
        },
        "description": "Devuelve el reporte legal del documento firmado en PDF binario. En Postman usá \"Send and Download\" para guardarlo."
      }
    },
    {
      "name": "Foto del Firmante (DNI / Selfie)",
      "request": {
        "method": "GET",
        "header": [
          { "key": "x-api-key", "value": "{{api_key}}" }
        ],
        "url": {
          "raw": "{{base_url}}/api/v2/signers/{{id_custom}}/photo/{{photo_type}}",
          "host": ["{{base_url}}"],
          "path": ["api", "v2", "signers", "{{id_custom}}", "photo", "{{photo_type}}"]
        },
        "description": "Devuelve la foto (JPEG binario) del firmante. Variable photo_type: selfie o dni."
      }
    },
    {
      "name": "Estado de Firma",
      "request": {
        "method": "GET",
        "header": [
          { "key": "x-api-key", "value": "{{api_key}}" }
        ],
        "url": {
          "raw": "{{base_url}}/api/v2/signatureStatus/{{id_seguimiento}}",
          "host": ["{{base_url}}"],
          "path": ["api", "v2", "signatureStatus", "{{id_seguimiento}}"]
        },
        "description": "Estado de firma del documento. También acepta un id_custom de firmante para consultar el estado de ese firmante."
      }
    },
    {
      "name": "Validar Imagen (DNI / Selfie)",
      "request": {
        "method": "POST",
        "header": [
          { "key": "x-api-key", "value": "{{api_key}}" },
          { "key": "Content-Type", "value": "application/json" }
        ],
        "url": {
          "raw": "{{base_url}}/api/validateImage",
          "host": ["{{base_url}}"],
          "path": ["api", "validateImage"]
        },
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id_custom\": \"{{id_custom}}\",\n  \"type\": \"selfie\",\n  \"image\": \"https://midominio.com/selfie.jpg\"\n}"
        },
        "description": "Valida la selfie o el DNI/CI de un firmante con reconocimiento facial. Validá la selfie primero; máximo 3 intentos por tipo."
      }
    },
    {
      "name": "Eliminar Documento",
      "request": {
        "method": "DELETE",
        "header": [
          { "key": "x-api-key", "value": "{{api_key}}" }
        ],
        "url": {
          "raw": "{{base_url}}/api/deleteDocument/{{id_seguimiento}}",
          "host": ["{{base_url}}"],
          "path": ["api", "deleteDocument", "{{id_seguimiento}}"]
        },
        "description": "Elimina un documento no firmado."
      }
    },
    {
      "name": "Cambiar Nombre Comercial",
      "request": {
        "method": "PUT",
        "header": [
          { "key": "x-api-key", "value": "{{api_key}}" },
          { "key": "Content-Type", "value": "application/json" }
        ],
        "url": {
          "raw": "{{base_url}}/api/account/changeBusinessName",
          "host": ["{{base_url}}"],
          "path": ["api", "account", "changeBusinessName"]
        },
        "body": {
          "mode": "raw",
          "raw": "{\n  \"business_name\": \"Mi Empresa S.A.\"\n}"
        },
        "description": "Actualiza el nombre comercial que ven los firmantes en WhatsApp."
      }
    }
  ]
}