MODO 3 |Consultar avance y resultado

GET 
/api/extractor/company/jobs/:job_id

3. Consultar avance y resultado

GET {{base_url}}/api/extractor/company/jobs/{{job_id}}

Se consulta por polling hasta que status sea done o error.

Headers

Authorization: Bearer {{token}}

Respuesta — en proceso

{
  "success": true,
  "status": "running",
  "stage": "enriching",
  "total": 9,
  "processed": 5,
  "log": [
    "🟢 CUFEs obtenidos: 9. Consultando la DIAN por cada uno…",
    "⬇️ Procesados 5/9 documento(s)…"
  ]
}

Respuesta — terminado

{
  "success": true,
  "status": "done",
  "stage": "done",
  "total": 9,
  "processed": 9,
  "log": ["...", "✅ Proceso terminado"],
  "data": [ ... ]
}

Campos de estado

Campo	Valores
status	running · done · error
stage	getting_cufes → enriching → done (o error)
total	CUFEs encontrados en el rango
processed	CUFEs ya consultados en la DIAN

Notas

• 🔁 Cada consulta hace avanzar el proceso (procesa 5 documentos por llamada).
  Sin polling, el job no progresa. Consultar cada 3–5 segundos.

• 404 si el job no existe, expiró (2 h) o pertenece a otra empresa.

• Con status: "error" viene además el campo message.

Request

Headers

Header	Valor
Accept	application/json
Authorization	Bearer <TU_TOKEN>

Responses

200

Respuesta — en proceso