Detallar un documento respaldado del SII
Antes de pedir datos nuevos, consulta atenciones en conexiones.estado.consultar. Si sincronizarSirve es false, sigue hacer: las indicaciones para pedir datos nuevos que siguen no aplican hasta resolver esa atención. La consulta de datos ya guardados sigue disponible según el plan. Devuelve UN documento tributario respaldado, con su detalle completo: los ítems (nombre, cantidad, unidad, precio unitario y monto), los giros, direcciones y comunas de emisor y receptor, y la forma de pago. El documento se identifica con las tres partes que lo hacen único ('tipoDte', 'folio' y 'rutEmisor'), y las tres salen de una fila de 'sii.documentos.consultar'. Lectura pura: NO contacta al SII, lee el XML que ya se respaldó y lo parsea en el momento. Si Emisso no tiene ese XML guardado, devuelve 'documento: null'. Revisa si su período está sincronizado con el alcance 'documentos' y el resultado de esa carga. Si el respaldo del SII no ofrece el XML, repetir la sincronización no garantiza recuperarlo, aunque el DTE figure en el RCV. El XML firmado sólo viaja si se pide 'incluirXml: true'; sin eso la respuesta trae el detalle ya estructurado, que es lo que casi siempre se necesita. Un ítem con 'cantidad', 'unidad' o 'precioUnitario' en null es un ítem que no los declaró (un flete, un descuento): no debe leerse como cero.
API key de la organización, en 'Authorization: Bearer connect_sk_…'. Es la credencial para tu backend y tus agentes propios; se crea en el dashboard con permisos explícitos y su valor completo se muestra una sola vez. Autentica como agente: la bitácora atribuye la acción a la clave, nunca a la persona que la creó.
In: header
Header Parameters
Cuál conexión (conn_…) ejecuta esta llamada. Obligatoria en todo sistema conectable y sin resolución implícita, ni siquiera cuando la organización tiene una sola conexión activa: la conexión ES la empresa, y elegir por ti una que hoy acierta mañana acierta distinto sin que nadie cambie nada. Los ids salen de la tool 'conexiones.estado.consultar'. Si falta, la respuesta es 'validation_error' y no se contacta al sistema externo.
^conn_Request Body
application/json
La entrada de la tool, envuelta en 'input'. Manda '{"input": {}}' cuando la tool no toma argumentos: el sobre es obligatorio aunque esté vacío.
TypeScript Definitions
Use the request body type in TypeScript.
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/tools/sii.documentos.detallar/execute" \ -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \ -H "Content-Type: application/json" \ -d '{ "input": { "tipoDte": -9007199254740991, "folio": "string", "rutEmisor": "string" } }'{ "data": { "documento": { "tipoDte": -9007199254740991, "folio": "string", "rutEmisor": "string", "rutReceptor": "string", "razonSocialContraparte": "string", "perspectiva": "emitidos", "periodo": "string", "fechaEmision": "string", "montoNeto": -9007199254740991, "iva": -9007199254740991, "montoTotal": -9007199254740991, "estado": "string", "dteHash": "string", "ultimaLecturaEn": "string", "detalle": { "formaPago": "string", "fechaVencimiento": "string", "razonSocialEmisor": "string", "giroEmisor": "string", "dirEmisor": "string", "cmnaEmisor": "string", "razonSocialReceptor": "string", "giroReceptor": "string", "dirReceptor": "string", "cmnaReceptor": "string", "items": [ { "numeroLinea": -9007199254740991, "nombre": "string", "cantidad": 0, "unidad": "string", "precioUnitario": 0, "montoItem": 0 } ] } }, "xml": "string" }, "meta": { "request_id": "string", "operation_request_id": "733a3a71-b72d-4633-94b1-070c6664565f", "tool_id": "string", "plane": "action", "latency_ms": 0, "audit_status": "recorded", "idempotency": "replayed" }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}Consultar documentos respaldados del SII POST
Antes de pedir datos nuevos, consulta atenciones en conexiones.estado.consultar. Si sincronizarSirve es false, sigue hacer: las indicaciones para pedir datos nuevos que siguen no aplican hasta resolver esa atención. La consulta de datos ya guardados sigue disponible según el plan. Lista los documentos tributarios (DTE) cuyo XML firmado ya se respaldó para esta conexión, filtrables por período, perspectiva y tipo de documento. Devuelve SOLO las columnas de cabecera: ni el XML ni el detalle de ítems viaja aquí. Para el detalle de UN documento (sus ítems con cantidad, unidad y precio, los giros y direcciones de emisor y receptor, y la forma de pago) usa 'sii.documentos.detallar' con el 'tipoDte', el 'folio' y el 'rutEmisor' de la fila correspondiente. Lectura pura: NO dispara una sincronización nueva ni contacta al SII. Si el mes no está cargado, devuelve una lista vacía y 'sincronizacion: null': no es cero movimiento. Para traer datos nuevos usa 'sii.conexion.sincronizar' primero, con el alcance 'documentos'. La fuente es Respaldo de Información XML del SII: que un DTE figure en el RCV no garantiza que su XML esté disponible en ese respaldo. Una sincronización completa acredita la cobertura del índice del respaldo, no de todo el RCV. Emisso no filtra por el software de emisión del proveedor ni reconstruye XML desde el RCV. Este alcance requiere la clave tributaria de una persona que representa a la empresa; esa credencial no garantiza la disponibilidad de los XML. Pagina con 'cursor': cuando la respuesta trae 'cursor' distinto de null, hay más filas. Reenvía ese valor tal cual en 'cursor' para pedir la página siguiente; nunca lo construyas a mano.
Obtener el XML firmado de un documento emitido POST
Entrega el XML firmado, con su timbre electrónico (TED), de una factura, nota o nota de crédito de anulación que Emisso emitió en esta conexión, por el operacionId que devolvió la emisión. Lo lee de lo guardado al emitir: no contacta al SII y responde aunque el documento todavía no aparezca en sii.cl. Sólo para documentos emitidos.