KilaSifen Docs

Eventos

POST/v1/emitters/{emitter_id}/documents/{document_id}/cancel

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
document_id*Document Id

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Cancelación de un DTE aprobado.

Response Body

application/json

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/documents/string/cancel" \  -H "Content-Type: application/json" \  -d '{    "motivo": "string"  }'
{  "correlation_id": "string",  "data": {    "event": {      "created_at": "2019-08-24T14:15:22Z",      "document_id": "string",      "emitter_id": "string",      "event_type": "string",      "generated_xml": "string",      "id": "string",      "input_payload": {},      "sifen_request_xml": "string",      "sifen_response_raw": "string",      "sifen_result_code": "string",      "sifen_result_message": "string",      "signed_xml": "string",      "status": "string",      "updated_at": "2019-08-24T14:15:22Z"    },    "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}/documents/{document_id}/nominate

Nombra al receptor de una factura emitida a un innominado (evento de nominación, NT 14). Sólo para una factura aprobada, no cancelada, cuyo receptor sea innominado y que no tenga otra nominación aprobada o en curso. Sigue el mismo ciclo que la cancelación: SIFEN la registra con 0600, se publica document.nominated y las notas de crédito o débito sobre esa factura tienen que nombrar a este receptor (2442).

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
document_id*Document Id

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Nominación de una factura emitida a un receptor innominado (NT 14).

Response Body

application/json

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/documents/string/nominate" \  -H "Content-Type: application/json" \  -d '{    "motivo": "string",    "receptor": {}  }'
{  "correlation_id": "string",  "data": {    "event": {      "created_at": "2019-08-24T14:15:22Z",      "document_id": "string",      "emitter_id": "string",      "event_type": "string",      "generated_xml": "string",      "id": "string",      "input_payload": {},      "sifen_request_xml": "string",      "sifen_response_raw": "string",      "sifen_result_code": "string",      "sifen_result_message": "string",      "signed_xml": "string",      "status": "string",      "updated_at": "2019-08-24T14:15:22Z"    },    "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}/events

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

Path Parameters

emitter_id*Emitter Id

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Evento raw (deprecado, sólo platform:admin).

Response Body

application/json

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/events" \  -H "Content-Type: application/json" \  -d '{    "document_id": "string",    "event_type": "string"  }'
{  "correlation_id": "string",  "data": {    "event": {      "created_at": "2019-08-24T14:15:22Z",      "document_id": "string",      "emitter_id": "string",      "event_type": "string",      "generated_xml": "string",      "id": "string",      "input_payload": {},      "sifen_request_xml": "string",      "sifen_response_raw": "string",      "sifen_result_code": "string",      "sifen_result_message": "string",      "signed_xml": "string",      "status": "string",      "updated_at": "2019-08-24T14:15:22Z"    },    "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/emitters/{emitter_id}/events/{event_id}

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
event_id*Event Id

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/emitters/string/events/string"
{  "correlation_id": "string",  "data": {    "event": {      "created_at": "2019-08-24T14:15:22Z",      "document_id": "string",      "emitter_id": "string",      "event_type": "string",      "generated_xml": "string",      "id": "string",      "input_payload": {},      "sifen_request_xml": "string",      "sifen_response_raw": "string",      "sifen_result_code": "string",      "sifen_result_message": "string",      "signed_xml": "string",      "status": "string",      "updated_at": "2019-08-24T14:15:22Z"    },    "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}/inutilizations

Inutiliza un rango de números de un timbrado del emisor.

Se pueden inutilizar números sin documento, rechazados, fallidos por validación local o en cola abortados; nunca un DTE aprobado o cancelado ni un documento que pueda estar en el SIFEN. Pasado el día 15 del mes siguiente al consumo del número (plazo de 360 h, MT v150 §6.2.1), la respuesta trae el aviso inutilization.extemporaneous y la inutilización se envía igual: el MT v150 §11.6.2 no prevé un código de rechazo por plazo, pero cómo responde el SIFEN fuera de plazo no está verificado.

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

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Inutilización de un rango de números de un timbrado.

Response Body

application/json

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/inutilizations" \  -H "Content-Type: application/json" \  -d '{    "document_type": "factura",    "establishment": "string",    "motivo": "string",    "numero_desde": 1,    "numero_hasta": 1,    "point": "string",    "timbrado": "string"  }'
{  "correlation_id": "string",  "data": {    "event": {      "created_at": "2019-08-24T14:15:22Z",      "document_id": "string",      "emitter_id": "string",      "event_type": "string",      "generated_xml": "string",      "id": "string",      "input_payload": {},      "sifen_request_xml": "string",      "sifen_response_raw": "string",      "sifen_result_code": "string",      "sifen_result_message": "string",      "signed_xml": "string",      "status": "string",      "updated_at": "2019-08-24T14:15:22Z"    },    "inutilization": {      "created_at": "2019-08-24T14:15:22Z",      "document_type": "string",      "emitter_id": "string",      "establishment": "string",      "event_id": "string",      "id": "string",      "numero_desde": 0,      "numero_hasta": 0,      "point": "string",      "sifen_protocol": "string",      "timbrado": "string",      "updated_at": "2019-08-24T14:15:22Z"    },    "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"    },    "warnings": [      "string"    ]  }}