KilaSifen Docs

Jobs

GET/v1/emitters/{emitter_id}/jobs/{job_id}

Scope: tenant:read (también platform:admin).

Authorization

KilaApiKey
X-API-Key<token>

Credencial privada del consumidor. Nunca la expongas en un navegador ni en una app cliente.

In: header

Path Parameters

emitter_id*Emitter Id
job_id*Job Id

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/emitters/string/jobs/string"
{  "correlation_id": "string",  "data": {    "job": {      "attempts": 0,      "created_at": "2019-08-24T14:15:22Z",      "emitter_id": "string",      "error_snapshot": {},      "finished_at": "2019-08-24T14:15:22Z",      "id": "string",      "job_type": "string",      "related_entity_id": "string",      "related_entity_type": "string",      "scheduled_at": "2019-08-24T14:15:22Z",      "started_at": "2019-08-24T14:15:22Z",      "status": "string",      "updated_at": "2019-08-24T14:15:22Z",      "worker_correlation_id": "string"    }  }}
POST/v1/emitters/{emitter_id}/jobs/{job_id}/retry

Vuelve a encolar un job de documento, evento o webhook del emisor que no terminó bien: failed, trabado en queued o processing (por ejemplo, porque se cayó el worker) o con un reintento programado. Es el mismo reintento del operador en la consola y responde el job en queued. El worker aplica las reglas de siempre: si el documento pudo llegar al SIFEN, consulta el CDC antes de decidir y sólo reenvía el mismo XML firmado, así que reintentar no duplica el documento. Nunca corren dos intentos a la vez: si el job sigue corriendo, vale lo que decida esa corrida (si termina en failed, se puede volver a pedir); si su worker se cayó, el job vuelve a correr cuando la cola da por muerta esa corrida, en unos minutos. Responde 409 (jobs.retry_not_allowed) un job succeeded y el de un documento que ya no admite intentos: aprobado, cancelado, inutilizado o rechazado en firme por el SIFEN.

Scope: fiscal:write (también platform:admin).

Authorization

KilaApiKey
X-API-Key<token>

Credencial privada del consumidor. Nunca la expongas en un navegador ni en una app cliente.

In: header

Path Parameters

emitter_id*Emitter Id
job_id*Job Id

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/emitters/string/jobs/string/retry"
{  "correlation_id": "string",  "data": {    "job": {      "attempts": 0,      "created_at": "2019-08-24T14:15:22Z",      "emitter_id": "string",      "error_snapshot": {},      "finished_at": "2019-08-24T14:15:22Z",      "id": "string",      "job_type": "string",      "related_entity_id": "string",      "related_entity_type": "string",      "scheduled_at": "2019-08-24T14:15:22Z",      "started_at": "2019-08-24T14:15:22Z",      "status": "string",      "updated_at": "2019-08-24T14:15:22Z",      "worker_correlation_id": "string"    }  }}
GET/v1/jobs

Scope: platform:admin.

Authorization

KilaApiKey
X-API-Key<token>

Credencial privada del consumidor. Nunca la expongas en un navegador ni en una app cliente.

In: header

Query Parameters

limit?Limit
Range1 <= value <= 100
Default50
offset?Offset
Range0 <= value
Default0
emitter_id?string|null
status?string|null
job_type?string|null
related_entity_type?string|null

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/jobs"
{  "correlation_id": "string",  "data": {    "jobs": [      {        "attempts": 0,        "created_at": "2019-08-24T14:15:22Z",        "emitter_id": "string",        "error_snapshot": {},        "finished_at": "2019-08-24T14:15:22Z",        "id": "string",        "job_type": "string",        "related_entity_id": "string",        "related_entity_type": "string",        "scheduled_at": "2019-08-24T14:15:22Z",        "started_at": "2019-08-24T14:15:22Z",        "status": "string",        "updated_at": "2019-08-24T14:15:22Z",        "worker_correlation_id": "string"      }    ],    "pagination": {      "count": 0,      "limit": 0,      "offset": 0    }  }}