Comprobantes emitidos

Restricciones de fecha: fechaEmision es obligatoria, admite YYYY-MM-DD o DD/MM/YYYY y debe ser anterior al día actual en America/Guayaquil. El SRI rechaza la fecha de hoy y no se sustituye por otra.

Diferencias con Demo: el contrato JSON es idéntico. Lo único que cambia es el prefijo de ruta (/comercial) y que los jobs de una modalidad no pueden leerse desde la otra.

curl -X POST "https://apis.davycorp.ec/v2/docs-emitidos/comercial" \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ruc": "1790000000001",
    "clave": "TU_CLAVE_SRI",
    "fechaEmision": "2026-09-14",
    "tipo": "factura,retencion"
  }'

await fetch("https://apis.davycorp.ec/v2/docs-emitidos/comercial", {
  method: "POST",
  headers: {
    Authorization: "Bearer TU_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    ruc: "1790000000001",
    clave: "TU_CLAVE_SRI",
    fechaEmision: "2026-09-14",
    tipo: "factura,retencion"
  })
});

import requests
requests.post(
    "https://apis.davycorp.ec/v2/docs-emitidos/comercial",
    headers={"Authorization": "Bearer TU_API_KEY"},
    json={
        "ruc": "1790000000001",
        "clave": "TU_CLAVE_SRI",
        "fechaEmision": "2026-09-14",
        "tipo": "factura,retencion",
    },
)

{
  "job_id": "8c1d0c2e-4b1a-4f0e-9c2a-6e5b1a0d4f11",
  "estado": "pendiente",
  "mensaje": "Descarga iniciada. Consulta el estado con el mismo prefijo de modalidad."
}

{
  "id": "JOB_ID",
  "estado": "completado",
  "modalidad": "comercial",
  "zip_url": "/v2/docs-emitidos/comercial/JOB_ID/archivo",
  "archivoUrl": "/v2/docs-emitidos/comercial/JOB_ID/archivo",
  "comprobantesUrl": "/v2/docs-emitidos/comercial/JOB_ID/comprobantes",
  "resultadoUrl": "/v2/docs-emitidos/comercial/JOB_ID",
  "error": null,
  "creado": "2026-10-26T18:00:00.000Z",
  "terminado": "2026-10-26T18:04:12.000Z"
}

// 400 — cuerpo incompleto
{ "error": "ruc y clave son obligatorios" }

// 400 — fecha inválida
{ "error": "La fecha ingresada debe ser menor a la fecha actual" }

// 401 — sin header Authorization
{ "error": "API Key requerida" }

// 403 — API key inválida
{ "success": false, "error": "Api user inválido" }

// 404 — job inexistente o de otro dueño/modalidad
{ "error": "Job no encontrado" }

// 409 — consultar comprobantes/archivo en ejecución
{ "error": "El trabajo sigue en ejecución" }

// 429 — cupo del API user
{ "error": "Límite de consultas alcanzado", "status": false }

// 500 — fallo interno
{ "error": "Error interno del servidor", "status": false }

Estado, archivo y cancelación repiten la cadena de verifyApiUser y la comprobación de dueño. Cruzar modalidad o dueño responde 404 con {"error":"Job no encontrado"} o {"error":"Archivo no disponible"}.

1. Enviar el POST a la modalidad elegida (/demo o /comercial).
2. Leer el identificador devuelto en job_id.
3. Consultar el estado con el prefijo de la misma modalidad: GET /v2/docs-emitidos/{modalidad}/:jobId.
4. Consultar los comprobantes cuando el estado lo permita: GET .../:jobId/comprobantes.
5. Descargar el ZIP cuando archivoUrl esté disponible: GET .../:jobId/archivo.
6. Cancelar si todavía se puede: POST .../:jobId/cancelar.

# 1) Crear trabajo
curl -X POST "https://apis.davycorp.ec/v2/docs-emitidos/demo" \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ruc":"1790000000001","clave":"TU_CLAVE_SRI","fechaEmision":"2026-09-14","tipo":"factura"}'

# 2) Consultar estado (usa el job_id devuelto)
curl "https://apis.davycorp.ec/v2/docs-emitidos/demo/JOB_ID" \
  -H "Authorization: Bearer TU_API_KEY"

# 3) Listado JSON de comprobantes
curl "https://apis.davycorp.ec/v2/docs-emitidos/demo/JOB_ID/comprobantes" \
  -H "Authorization: Bearer TU_API_KEY"

# 4) Descargar ZIP
curl -L "https://apis.davycorp.ec/v2/docs-emitidos/demo/JOB_ID/archivo" \
  -H "Authorization: Bearer TU_API_KEY" \
  -o comprobantes.zip

# 5) Cancelar (si sigue pendiente/procesando)
curl -X POST "https://apis.davycorp.ec/v2/docs-emitidos/demo/JOB_ID/cancelar" \
  -H "Authorization: Bearer TU_API_KEY"

Reintentos. INTENTOS vale 6. No se reintenta un rechazo explícito de credenciales ni un Chromium que no arranca. Dentro de una página, SRI_XML_WORKERS vale 2. SRI_JOB_TIMEOUT_MS en 0 no corta el trabajo.

Archivos. XML, TXT y ZIP viven en un directorio temporal por trabajo (os.tmpdir()), no en el repo. El listado JSON se guarda en PostgreSQL (metadatos, no el XML). El ZIP incluye xml/, comprobantes.json y resultado.json. Se borra al terminar la transmisión o al vencer SRI_TMP_TTL_MS (30 min por defecto). El nombre del ZIP es comprobantes_<TIPO>_<anio>_<mes>.zip.

Modo esperar. Si se omite esperar vale true y el POST espera el trabajo real. Con esperar=false responde 202 de inmediato. Si el tiempo HTTP se agota, 202 con esperaAgotada: true y el mismo jobId. Hay que seguir consultando el GET de estado.

Reinicio. Al arrancar, lo que quedó pendiente o procesando pasa a fallido. La clave no está en PostgreSQL, así que el proceso no puede volver a entrar al SRI por su cuenta.

Estado, archivo y cancelación repiten la misma cadena. Cruzar modalidad o dueño responde 404 con {"error":"Job no encontrado"} o {"error":"Archivo no disponible"}.

No todos los endpoints devuelven todos los códigos. Los GET de estado, comprobantes y archivo no atraviesan verifyLicense; aplican 401, 403, 404, 409 y 500. El POST de creación añade 400 y 429 según el cuerpo y el cupo del API user.

Un fallo del portal queda en error del trabajo y no detiene el proceso de las otras APIs. La descarga masiva contra el SRI no forma parte de esta integración: un trabajo, un período.