KilaSifen Docs

Documentos

GET/v1/emitters/{emitter_id}/documents

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

Query Parameters

limit?Limit
Range1 <= value <= 100
Default50
offset?Offset
Range0 <= value
Default0
internal_status?|

Estado exacto: queued, processing, submitting, submitted, retry_pending, reconciliation_required, approved, approved_with_observation, rejected, failed, cancelled o inutilized. Un valor desconocido devuelve una página vacía.

document_type?|

factura, nota_credito o nota_debito.

external_id?|

Identificador del documento en el ERP.

cdc?|

CDC de 44 dígitos.

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/documents"
{  "correlation_id": "string",  "data": {    "documents": [      {        "document": {          "cdc": "string",          "created_at": "2019-08-24T14:15:22Z",          "document_number": 0,          "document_type": "string",          "emitter_id": "string",          "establishment": "string",          "external_id": "string",          "fiscal_warnings": [            "string"          ],          "generated_xml": "string",          "id": "string",          "idempotency_key": "string",          "internal_status": "string",          "last_query_at": "2019-08-24T14:15:22Z",          "last_query_request_xml": "string",          "last_query_response_raw": "string",          "payload_snapshot": {},          "point": "string",          "sifen_request_xml": "string",          "sifen_response_raw": "string",          "sifen_result_code": "string",          "sifen_result_message": "string",          "sifen_status": "string",          "signed_xml": "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"        },        "nomination": {          "event_id": "string",          "receptor": {},          "status": "string"        }      }    ],    "pagination": {      "count": 0,      "limit": 0,      "offset": 0    }  }}
POST/v1/emitters/{emitter_id}/documents

Deprecado y sólo para platform:admin. payload.generated_xml debe ser un rDE sin firmar que valide contra el XSD oficial; la plataforma lo firma con el certificado del emisor. signed_xml se rechaza con 422.

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

Header Parameters

X-Kila-Test-Outcome?|

Fuerza un resultado determinístico del SIFEN. Sólo en un despliegue con KILA_SIFEN_ENVIRONMENT=test; en otro responde 422 sandbox.test_runtime_required.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Documento 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

application/json

curl -X POST "https://example.com/v1/emitters/string/documents" \  -H "Content-Type: application/json" \  -d '{    "document_type": "string"  }'
{  "correlation_id": "string",  "data": {    "document": {      "cdc": "string",      "created_at": "2019-08-24T14:15:22Z",      "document_number": 0,      "document_type": "string",      "emitter_id": "string",      "establishment": "string",      "external_id": "string",      "fiscal_warnings": [        "string"      ],      "generated_xml": "string",      "id": "string",      "idempotency_key": "string",      "internal_status": "string",      "last_query_at": "2019-08-24T14:15:22Z",      "last_query_request_xml": "string",      "last_query_response_raw": "string",      "payload_snapshot": {},      "point": "string",      "sifen_request_xml": "string",      "sifen_response_raw": "string",      "sifen_result_code": "string",      "sifen_result_message": "string",      "sifen_status": "string",      "signed_xml": "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/facturas

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

Header Parameters

X-Kila-Test-Outcome?|

Fuerza un resultado determinístico del SIFEN. Sólo en un despliegue con KILA_SIFEN_ENVIRONMENT=test; en otro responde 422 sandbox.test_runtime_required.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Emisión de una factura.

Response Body

application/json

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/facturas" \  -H "Content-Type: application/json" \  -d '{    "factura": {      "cliente": {},      "items": [        {          "cantidad": 1,          "descripcion": "string",          "precio_unitario": 0        }      ]    }  }'
{  "correlation_id": "string",  "data": {    "document": {      "cdc": "string",      "created_at": "2019-08-24T14:15:22Z",      "document_number": 0,      "document_type": "string",      "emitter_id": "string",      "establishment": "string",      "external_id": "string",      "fiscal_warnings": [        "string"      ],      "generated_xml": "string",      "id": "string",      "idempotency_key": "string",      "internal_status": "string",      "last_query_at": "2019-08-24T14:15:22Z",      "last_query_request_xml": "string",      "last_query_response_raw": "string",      "payload_snapshot": {},      "point": "string",      "sifen_request_xml": "string",      "sifen_response_raw": "string",      "sifen_result_code": "string",      "sifen_result_message": "string",      "sifen_status": "string",      "signed_xml": "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/notas-credito

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

Header Parameters

X-Kila-Test-Outcome?|

Fuerza un resultado determinístico del SIFEN. Sólo en un despliegue con KILA_SIFEN_ENVIRONMENT=test; en otro responde 422 sandbox.test_runtime_required.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Emisión de una nota de crédito.

Response Body

application/json

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/notas-credito" \  -H "Content-Type: application/json" \  -d '{    "nota_credito": {      "cliente": {},      "documento_asociado": {},      "items": [        {          "cantidad": 1,          "descripcion": "string",          "precio_unitario": 0        }      ]    }  }'
{  "correlation_id": "string",  "data": {    "document": {      "cdc": "string",      "created_at": "2019-08-24T14:15:22Z",      "document_number": 0,      "document_type": "string",      "emitter_id": "string",      "establishment": "string",      "external_id": "string",      "fiscal_warnings": [        "string"      ],      "generated_xml": "string",      "id": "string",      "idempotency_key": "string",      "internal_status": "string",      "last_query_at": "2019-08-24T14:15:22Z",      "last_query_request_xml": "string",      "last_query_response_raw": "string",      "payload_snapshot": {},      "point": "string",      "sifen_request_xml": "string",      "sifen_response_raw": "string",      "sifen_result_code": "string",      "sifen_result_message": "string",      "sifen_status": "string",      "signed_xml": "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/notas-debito

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

Header Parameters

X-Kila-Test-Outcome?|

Fuerza un resultado determinístico del SIFEN. Sólo en un despliegue con KILA_SIFEN_ENVIRONMENT=test; en otro responde 422 sandbox.test_runtime_required.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Emisión de una nota de débito.

Response Body

application/json

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/notas-debito" \  -H "Content-Type: application/json" \  -d '{    "nota_debito": {      "cliente": {},      "documento_asociado": {},      "items": [        {          "cantidad": 1,          "descripcion": "string",          "precio_unitario": 0        }      ]    }  }'
{  "correlation_id": "string",  "data": {    "document": {      "cdc": "string",      "created_at": "2019-08-24T14:15:22Z",      "document_number": 0,      "document_type": "string",      "emitter_id": "string",      "establishment": "string",      "external_id": "string",      "fiscal_warnings": [        "string"      ],      "generated_xml": "string",      "id": "string",      "idempotency_key": "string",      "internal_status": "string",      "last_query_at": "2019-08-24T14:15:22Z",      "last_query_request_xml": "string",      "last_query_response_raw": "string",      "payload_snapshot": {},      "point": "string",      "sifen_request_xml": "string",      "sifen_response_raw": "string",      "sifen_result_code": "string",      "sifen_result_message": "string",      "sifen_status": "string",      "signed_xml": "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}/documents/{document_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
document_id*Document 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/documents/string"
{  "correlation_id": "string",  "data": {    "document": {      "cdc": "string",      "created_at": "2019-08-24T14:15:22Z",      "document_number": 0,      "document_type": "string",      "emitter_id": "string",      "establishment": "string",      "external_id": "string",      "fiscal_warnings": [        "string"      ],      "generated_xml": "string",      "id": "string",      "idempotency_key": "string",      "internal_status": "string",      "last_query_at": "2019-08-24T14:15:22Z",      "last_query_request_xml": "string",      "last_query_response_raw": "string",      "payload_snapshot": {},      "point": "string",      "sifen_request_xml": "string",      "sifen_response_raw": "string",      "sifen_result_code": "string",      "sifen_result_message": "string",      "sifen_status": "string",      "signed_xml": "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"    },    "nomination": {      "event_id": "string",      "receptor": {},      "status": "string"    }  }}
GET/v1/emitters/{emitter_id}/documents/{document_id}/kude

KuDE en PDF del XML firmado, con el código QR en la primera página. Disponible para documentos aprobados y para los que siguen en camino al SIFEN (queued, processing, submitting, submitted, retry_pending, reconciliation_required): con validación posterior el KuDE puede entregarse antes de la aprobación, pero sólo vale si el SIFEN aprueba el DE (MT v150 §6.2 y §6.4). Un documento rejected, failed, inutilized o cancelled, o en cualquier otro estado, responde 409 documents.kude_not_available con el estado en details.internal_status.

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

Response Body

application/pdf

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/documents/string/kude"
"string"
GET/v1/emitters/{emitter_id}/documents/{document_id}/kude/data

Datos del KuDE leídos del XML firmado; montos y fechas van con el texto literal del XML. Disponible para documentos aprobados y para los que siguen en camino al SIFEN (queued, processing, submitting, submitted, retry_pending, reconciliation_required): con validación posterior el KuDE puede entregarse antes de la aprobación, pero sólo vale si el SIFEN aprueba el DE (MT v150 §6.2 y §6.4). Un documento rejected, failed, inutilized o cancelled, o en cualquier otro estado, responde 409 documents.kude_not_available con el estado en details.internal_status.

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
document_id*Document 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/documents/string/kude/data"
{  "correlation_id": "string",  "data": {    "kude": {      "ambiente": "test",      "ambiente_warning": "string",      "cdc": {},      "consulta_publica": {},      "datos_generales": {},      "documento_asociado": {},      "emisor": {},      "informacion_adicional": "string",      "informacion_emisor": "string",      "items": [        {}      ],      "nota_credito": {},      "nota_debito": {},      "qr": {},      "receptor": {},      "timbrado": {},      "tipo": "string",      "tipo_label": "string",      "totales": {}    }  }}
GET/v1/emitters/{emitter_id}/documents/{document_id}/xml

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

Response Body

application/xml

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/documents/string/xml"
"string"