Descargar el PDF de una factura, guía o nota (beta)
Descarga desde el Facturador Gratuito del SII el PDF oficial de un documento emitido por la empresa de la conexión: factura 33 o 34, guía de despacho 52 o nota 56 o 61, por tipo, folio y fecha de emisión. Lo devuelve en base64 con su SHA-256. Sirve para documentos emitidos por Connect o directo en el portal; no emite ni guarda nada. Requiere la conexión de representante con el permiso sii:write.
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.dte.descargar/execute" \ -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \ -H "Content-Type: application/json" \ -d '{ "input": { "tipoDte": "33", "folio": "string", "fechaEmision": "string" } }'{ "data": { "tipoDte": "33", "folio": "string", "nombreArchivo": "string", "contentType": "application/pdf", "byteLength": 1, "sha256": "string", "contenidoBase64": "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 }}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 Connect 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.
Emitir DTE en el SII POST
Inicia una emisión en la beta habilitada del Facturador Gratuito: requiere previewRef vigente, Idempotency-Key explícita y autorización de la variante en la conexión. La confirmación de la preparación ocurre dentro de esta llamada cuando la hace el mismo actor que creó esa previsualización, sea una clave de API o una persona. La conexión debe tener guardada la clave del certificado, que se resuelve en el servidor y nunca viaja en la llamada ni en el resultado. Un resultado desconocido se consulta automáticamente; nunca autoriza repetir firma o envío.