Connect
API REST

Previsualizar DTE en el SII

Valida y previsualiza un documento en el Facturador Gratuito del SII sin guardarlo ni emitirlo. El schema documenta factura afecta 33 y factura exenta 34 (de una a diez líneas y con hasta tres referencias opcionales, como orden de compra o HES), guía 52 con cualquiera de sus nueve motivos de traslado (motivoTraslado), hasta diez líneas con código, unidad y descripción, referencias, solicitante, transporte y contacto del receptor, dentro de una página impresa, y notas 56/61 de corrección de montos referidas a una factura 34 exenta. Cada variante requiere validación vigente del portal, habilitación para la organización, permiso de la conexión y perfil del emisor. Publicar su schema no habilita su ejecución. El 46 se rechaza antes de red.

POST
/v1/tools/sii.dte.previsualizar/execute

Authorization

AuthorizationBearer <token>

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

X-Connect-Connection*string

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.

Match^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.previsualizar/execute" \  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \  -H "Content-Type: application/json" \  -d '{    "input": {      "candidato": {        "tipoDte": "33",        "receptor": {          "rut": "string",          "razonSocial": "string",          "giro": "string",          "direccion": "string",          "comuna": "string",          "ciudad": "string"        },        "tipoVenta": "del_giro",        "tipoCompra": "del_giro",        "condicionPago": {          "formaPago": "credito"        },        "detalles": [          {            "nombre": "string",            "cantidad": 0,            "precioUnitario": 1          }        ]      }    }  }'
{  "data": {    "estado": "previsualizado",    "tipoDte": "33",    "variante": "33:del_giro:del_giro:credito",    "fechaEmision": "string",    "receptorRut": "string",    "totales": {      "tributacion": "afecta",      "neto": 0,      "iva": 0,      "total": 0    },    "advertencias": [      {        "codigo": "string",        "campo": "string"      }    ],    "previewRef": "string",    "expiraEn": "2019-08-24T14:15:22Z",    "contractVersion": 1  },  "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  }}

Emitir DTE en el SII POST

Inicia una emisión en el 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.

Consultar declaraciones F29 del SII POST

Lee las declaraciones mensuales (Formulario 29) ya sincronizadas para esta conexión, con sus códigos. Lectura pura: NO contacta al SII. Por defecto trae sólo las vigentes; con 'incluirNoVigentes' trae también las rectificadas y anuladas. Filtra por un 'periodo' o por un rango 'desde'/'hasta'. Los códigos vienen por número sin ceros a la izquierda y un código ausente venía en blanco en el formulario (vacío no es cero). El F29 se revisa solo después de cada vencimiento; para forzar una revisión usa 'sii.conexion.sincronizar' con alcances ['f29']. Pagina con 'cursor'.