MODO 2 | Iniciar extracción (asíncrono)

POST 
/api/certificate

2. Iniciar extracción (asíncrono)

POST {{base_url}}/api/extractor/company

Arranca el proceso y devuelve un jobId al instante. El resultado se consulta con
el endpoint 3.

Headers

Authorization: Bearer {{token}}
Content-Type: application/json

Body

Idéntico al endpoint 1.

{
  "url": "{{dian_url}}",
  "tipo": "Received",
  "fechaDesde": "2026-01-01",
  "fechaHasta": "2026-01-31"
}

Respuesta 202

{
  "success": true,
  "jobId": "3f2a1b8c-...",
  "statusUrl": "https://api.tu-dominio.com/api/extractor/company/jobs/3f2a1b8c-...",
  "message": "Extracción iniciada. Consulte statusUrl para el avance y el resultado."
}

Script de test (guardar el jobId)

const r = pm.response.json();
if (r.jobId) pm.collectionVariables.set("job_id", r.jobId);

Notas

• ⚠️ Un body inválido devuelve 502****, no 422****. Si aparece
  "No se pudo iniciar la extracción: ...", revisar primero el formato de las
  fechas (YYYY-MM-DD) y el valor de tipo.

• El job vive 2 horas en caché.

Request

Headers

Header	Valor
Content-Type	application/json
Accept	application/json
Authorization	Bearer <TU_TOKEN>

Responses

200

success