{
  "info": {
    "name": "Nubex Certificados — API casas de software",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "description": "Importar este JSON en Postman (Import → File). En Variables de la colección configurar base_url, token (clave entregada por el administrador) y house_code (código asignado). Mantener token solo local y secreto, preferiblemente en Postman Vault; nunca compartir valores reales ni exportarlos. Todas las solicitudes heredan Authorization: Bearer {{token}} y X-Software-House-Code: {{house_code}}. Sin claves reales ni archivos privados incluidos.\n\nSeleccionar los cuatro archivos File para emisión y solo Cámara para renovación. Cambiar las referencias para cada nueva operación. El ID de emisión se guarda automáticamente en request_id; renovación/revocatoria usan variables separadas. La consulta por referencia permite recuperar un ID perdido. Ejemplos de datos ficticios.\n\nCamerfirma sigue simulado: la API recibe solicitudes; un administrador registra estados y carga P12/PFX. Publicar la versión antes de consumir los endpoints de producción.\n\nCada empresa solo accede a sus solicitudes: ajenas devuelven 404. Clave incorrecta/revocada o empresa inactiva: 401; sin permiso de contraseña: 403; certificado no disponible: 404/409; referencia duplicada/operación incompatible: 409; tamaño excesivo: 413; formato inválido: 415; campos inválidos: 422; máximo 60 peticiones/minuto/clave: 429 con Retry-After: 60; indisponibilidad temporal: 503. Errores JSON: {\"error\":{\"code\":\"unauthorized\",\"message\":\"Credenciales inválidas.\"}}.\n\nWebhooks: el administrador configura la dirección HTTPS en Integración API; no enviar callback_url. Las notificaciones firmadas solo incluyen ID, referencia y estado. La guía web documenta validación HMAC y reintentos."
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{token}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "base_url",
      "value": "https://nubexcertificados.lovable.app",
      "type": "string"
    },
    {
      "key": "token",
      "value": "",
      "type": "string"
    },
    {
      "key": "house_code",
      "value": "",
      "type": "string"
    },
    {
      "key": "request_id",
      "value": "",
      "type": "string"
    },
    {
      "key": "renewal_request_id",
      "value": "",
      "type": "string"
    },
    {
      "key": "revocation_request_id",
      "value": "",
      "type": "string"
    },
    {
      "key": "reference",
      "value": "SOL-2026-001",
      "type": "string"
    },
    {
      "key": "renewal_reference",
      "value": "REN-2026-001",
      "type": "string"
    },
    {
      "key": "revocation_reference",
      "value": "REV-2026-001",
      "type": "string"
    },
    {
      "key": "holder_document",
      "value": "79845123",
      "type": "string"
    },
    {
      "key": "company_nit",
      "value": "900123456-1",
      "type": "string"
    },
    {
      "key": "desde",
      "value": "2026-01-01",
      "type": "string"
    },
    {
      "key": "hasta",
      "value": "2026-12-31",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "1. Solicitar certificado por primera vez",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "X-Software-House-Code",
            "value": "{{house_code}}",
            "type": "text"
          }
        ],
        "url": "{{base_url}}/api/public/v1/solicitudes",
        "description": "Enviar Body → form-data. No fijar Content-Type manualmente: Postman genera multipart/form-data y el boundary. PDF/JPG/JPEG/PNG, máximo 20 MB por archivo y 25 MB en total. Los archivos se envían como bytes, no JSON ni base64. 201 confirma recepción, no aprobación ni emisión. 409: referencia duplicada; consultar por referencia antes de reintentar. Requiere los ocho campos de texto y los cuatro archivos. Guarda el ID recibido en request_id.",
        "body": {
          "mode": "formdata",
          "formdata": [
            {
              "key": "reference",
              "value": "{{reference}}",
              "type": "text",
              "description": "Referencia única dentro de la casa de software; 1–100 caracteres: letras, números, guion, punto o guion bajo."
            },
            {
              "key": "cert_type",
              "value": "representacion_legal",
              "type": "text",
              "description": "representacion_legal, persona_natural o persona_juridica."
            },
            {
              "key": "holder_name",
              "value": "Carlos Alberto Gómez Restrepo",
              "type": "text",
              "description": "Nombre completo del titular (3–200 caracteres). Ejemplo ficticio."
            },
            {
              "key": "holder_document",
              "value": "{{holder_document}}",
              "type": "text",
              "description": "Documento del titular (3–50 caracteres)."
            },
            {
              "key": "company_nit",
              "value": "{{company_nit}}",
              "type": "text",
              "description": "NIT de la empresa (3–30 caracteres); ejemplo ficticio."
            },
            {
              "key": "company_name",
              "value": "Empresa de ejemplo S.A.S.",
              "type": "text",
              "description": "Razón social (3–200 caracteres); ejemplo ficticio."
            },
            {
              "key": "camara_comercio",
              "type": "file",
              "src": [],
              "description": "Cámara expedida máximo 30 días antes de la solicitud; representante legal o suplente coincide con la cédula. Seleccionar un archivo local en Postman (tipo File); no enviar rutas ni URLs como texto."
            },
            {
              "key": "rut",
              "type": "file",
              "src": [],
              "description": "Representante legal o suplente coincide con Cámara y cédula. Seleccionar un archivo local en Postman (tipo File); no enviar rutas ni URLs como texto."
            },
            {
              "key": "cedula_frontal",
              "type": "file",
              "src": [],
              "description": "Frente de la cédula, todos sus datos legibles. Seleccionar un archivo local en Postman (tipo File); no enviar rutas ni URLs como texto."
            },
            {
              "key": "cedula_trasera",
              "type": "file",
              "src": [],
              "description": "Reverso de la cédula, todos sus datos legibles. Seleccionar un archivo local en Postman (tipo File); no enviar rutas ni URLs como texto."
            }
          ]
        }
      },
      "event": [
        {
          "listen": "test",
          "script": {
            "type": "text/javascript",
            "exec": [
              "if (pm.response.code === 201) {",
              "  const result = pm.response.json();",
              "  if (result.id) pm.collectionVariables.set(\"request_id\", result.id);",
              "}"
            ]
          }
        }
      ]
    },
    {
      "name": "2. Solicitar renovación",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "X-Software-House-Code",
            "value": "{{house_code}}",
            "type": "text"
          }
        ],
        "url": "{{base_url}}/api/public/v1/solicitudes/{{request_id}}/renovacion",
        "description": "Enviar Body → form-data. No fijar Content-Type manualmente: Postman genera multipart/form-data y el boundary. PDF/JPG/JPEG/PNG, máximo 20 MB por archivo y 25 MB en total. Los archivos se envían como bytes, no JSON ni base64. 201 confirma recepción, no aprobación ni emisión. 409: referencia duplicada; consultar por referencia antes de reintentar. request_id identifica el certificado original, emitido o entregado, no una revocatoria. Solo enviar reference nueva y Cámara actualizada (máximo 30 días); reutiliza RUT, cédula y datos del original. Guarda el nuevo ID en renewal_request_id sin reemplazar request_id.",
        "body": {
          "mode": "formdata",
          "formdata": [
            {
              "key": "reference",
              "value": "{{renewal_reference}}",
              "type": "text",
              "description": "Nueva referencia única."
            },
            {
              "key": "camara_comercio",
              "type": "file",
              "src": [],
              "description": "Cámara de comercio actualizada, máximo 30 días. Seleccionar un archivo local en Postman (tipo File); no enviar rutas ni URLs como texto."
            }
          ]
        }
      },
      "event": [
        {
          "listen": "test",
          "script": {
            "type": "text/javascript",
            "exec": [
              "if (pm.response.code === 201) {",
              "  const result = pm.response.json();",
              "  if (result.id) pm.collectionVariables.set(\"renewal_request_id\", result.id);",
              "}"
            ]
          }
        }
      ]
    },
    {
      "name": "3. Solicitar revocatoria",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "X-Software-House-Code",
            "value": "{{house_code}}",
            "type": "text"
          },
          {
            "key": "Content-Type",
            "value": "application/json",
            "type": "text"
          }
        ],
        "url": "{{base_url}}/api/public/v1/solicitudes/{{request_id}}/revocatoria",
        "description": "request_id identifica el certificado original emitido o entregado. Body → raw → JSON: reference nueva y reason de 10–500 caracteres. Solo una revocatoria abierta por certificado. Requiere aprobación administrativa: 201 no revoca automáticamente. Al aprobarse, original y revocatoria pasan a revocada; al rechazarse, la revocatoria queda rechazada. Guarda el nuevo ID en revocation_request_id.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"reference\": \"{{revocation_reference}}\",\n  \"reason\": \"Cambio de representante legal de la empresa\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      },
      "event": [
        {
          "listen": "test",
          "script": {
            "type": "text/javascript",
            "exec": [
              "if (pm.response.code === 201) {",
              "  const result = pm.response.json();",
              "  if (result.id) pm.collectionVariables.set(\"revocation_request_id\", result.id);",
              "}"
            ]
          }
        }
      ]
    },
    {
      "name": "4. Copia del último certificado vigente",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "X-Software-House-Code",
            "value": "{{house_code}}",
            "type": "text"
          }
        ],
        "url": "{{base_url}}/api/public/v1/certificados/ultimo?holder_document={{holder_document}}&company_nit={{company_nit}}",
        "description": "holder_document es obligatorio; company_nit es opcional (eliminar ese parámetro si no se necesita). Devuelve bytes P12/PFX application/x-pkcs12, solo emitido o entregado, no revocado, de esta empresa, incluidas renovaciones. Usar Send and Download / guardar respuesta en archivo, no interpretar como JSON. X-Request-Id identifica la solicitud de origen; usar ese ID para consultar la contraseña."
      }
    },
    {
      "name": "5. Solicitar estado de cuenta",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "X-Software-House-Code",
            "value": "{{house_code}}",
            "type": "text"
          }
        ],
        "url": "{{base_url}}/api/public/v1/estado-cuenta?desde={{desde}}&hasta={{hasta}}",
        "description": "Fechas opcionales AAAA-MM-DD (eliminar parámetros para omitirlos); desde debe ser anterior o igual a hasta. JSON: total, by_operation, by_status, active_certificates y pending, limitado a esta casa de software. Solo cantidades; no incluye dinero."
      }
    },
    {
      "name": "6. Consultar estado actual de la solicitud",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "X-Software-House-Code",
            "value": "{{house_code}}",
            "type": "text"
          }
        ],
        "url": "{{base_url}}/api/public/v1/solicitudes/{{request_id}}",
        "description": "request_id: UUID de una emisión, renovación o revocatoria; reemplazarlo con renewal_request_id o revocation_request_id cuando corresponda. JSON con id, reference, status, operation, parent_request_id, updated_at y certificate.available/download_url. La URL de descarga es relativa y protegida: conservar ambas cabeceras. Estados: recibida, enviada, en_validacion, emitida, entregada, rechazada, error, revocada."
      }
    },
    {
      "name": "Consulta por referencia y listado",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "X-Software-House-Code",
            "value": "{{house_code}}",
            "type": "text"
          }
        ],
        "url": "{{base_url}}/api/public/v1/solicitudes?reference={{reference}}&limit=20&offset=0",
        "description": "Respuesta JSON con data, limit, offset. reference es opcional: eliminar para listar todas las solicitudes propias. limit: 1–100; offset: 0–100000. Si un POST pierde su respuesta, buscar por referencia antes de reenviar; copiar el ID encontrado a request_id."
      }
    },
    {
      "name": "Consultar documentos recibidos",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "X-Software-House-Code",
            "value": "{{house_code}}",
            "type": "text"
          }
        ],
        "url": "{{base_url}}/api/public/v1/solicitudes/{{request_id}}/documentos",
        "description": "JSON con nombres y tamaños por categoría: camara_comercio, rut, cedula_frente, cedula_reverso. Los nombres de envío son cedula_frontal y cedula_trasera. No expone enlaces públicos a documentos privados."
      }
    },
    {
      "name": "Descargar certificado P12/PFX por solicitud",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "X-Software-House-Code",
            "value": "{{house_code}}",
            "type": "text"
          }
        ],
        "url": "{{base_url}}/api/public/v1/solicitudes/{{request_id}}/certificado",
        "description": "Requiere estado emitida/entregada y archivo cargado. Respuesta binaria application/x-pkcs12: usar Send and Download / guardar respuesta. Descargar no cambia el estado a entregada. Mantener las dos cabeceras de autenticación."
      }
    },
    {
      "name": "Consultar contraseña del certificado",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "X-Software-House-Code",
            "value": "{{house_code}}",
            "type": "text"
          }
        ],
        "url": "{{base_url}}/api/public/v1/solicitudes/{{request_id}}/clave",
        "description": "Requiere credencial con permiso explícito de contraseña, certificado cargado y estado emitida/entregada. JSON: {id, password}. Cache-Control: no-store. No guardar respuestas, contraseña ni credenciales en colecciones compartidas, registros o variables persistentes. Sin permiso: 403."
      }
    }
  ]
}