Documentos
/v1/emitters/{emitter_id}/documentsScope: tenant:read (también platform:admin).
Authorization
KilaApiKey Credencial privada del consumidor. Nunca la expongas en un navegador ni en una app cliente.
In: header
Path Parameters
Query Parameters
1 <= value <= 100500 <= value0Estado 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.
factura, nota_credito o nota_debito.
Identificador del documento en el ERP.
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 } }}Crear documento raw (sólo plataforma)
Deprecated/v1/emitters/{emitter_id}/documentsDeprecado 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 Credencial privada del consumidor. Nunca la expongas en un navegador ni en una app cliente.
In: header
Path Parameters
Header Parameters
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" } }}/v1/emitters/{emitter_id}/documents/facturasScope: fiscal:write (también platform:admin).
Authorization
KilaApiKey Credencial privada del consumidor. Nunca la expongas en un navegador ni en una app cliente.
In: header
Path Parameters
Header Parameters
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" } }}/v1/emitters/{emitter_id}/documents/notas-creditoScope: fiscal:write (también platform:admin).
Authorization
KilaApiKey Credencial privada del consumidor. Nunca la expongas en un navegador ni en una app cliente.
In: header
Path Parameters
Header Parameters
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" } }}/v1/emitters/{emitter_id}/documents/notas-debitoScope: fiscal:write (también platform:admin).
Authorization
KilaApiKey Credencial privada del consumidor. Nunca la expongas en un navegador ni en una app cliente.
In: header
Path Parameters
Header Parameters
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" } }}/v1/emitters/{emitter_id}/documents/{document_id}Scope: tenant:read (también platform:admin).
Authorization
KilaApiKey Credencial privada del consumidor. Nunca la expongas en un navegador ni en una app cliente.
In: header
Path Parameters
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" } }}/v1/emitters/{emitter_id}/documents/{document_id}/kudeKuDE 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 Credencial privada del consumidor. Nunca la expongas en un navegador ni en una app cliente.
In: header
Path Parameters
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"/v1/emitters/{emitter_id}/documents/{document_id}/kude/dataDatos 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 Credencial privada del consumidor. Nunca la expongas en un navegador ni en una app cliente.
In: header
Path Parameters
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": {} } }}/v1/emitters/{emitter_id}/documents/{document_id}/xmlScope: tenant:read (también platform:admin).
Authorization
KilaApiKey Credencial privada del consumidor. Nunca la expongas en un navegador ni en una app cliente.
In: header
Path Parameters
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"