Emisso 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, factura exenta 34, guía 52 que constituye venta y notas 56/61 de corrección de montos referidas a una factura 34 exenta. Solo 33 y 34 son elegibles en la matriz productiva (preview:true), y se ejecutan únicamente cuando están abiertas todas las compuertas de rollout, organización, scope, credencial y perfil. 52, 56 y 61 se rechazan 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"      }    ],    "previewToken": "string",    "expiraEn": "2019-08-24T14:15:22Z",    "contractVersion": 1  },  "meta": {    "request_id": "string",    "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 (no disponible) POST

Contrato futuro reservado. La emisión productiva está deshabilitada para todas las variantes: toda llamada falla cerrada antes de tocar el SII. Cuando se habilite exigirá un previewToken vigente, una Idempotency-Key explícita y la capability de emisión de la variante en la conexión.

Consultar guías de despacho del SII POST

Lee las guías de despacho electrónicas (DTE 52) ya sincronizadas para esta conexión, filtradas por período y/o perspectiva (emitidas = las que emitió esta empresa; recibidas = las que le emitieron). Lectura pura: NO dispara una sincronización nueva ni contacta al SII. Si el período nunca se sincronizó, devuelve una lista vacía y 'sincronizacion: null'. Para traer datos nuevos, use 'sii.conexion.sincronizar' primero. Ojo: el SII solo conserva el detalle de guías de los últimos 6 meses, así que un período más viejo no se puede sincronizar aunque exista. 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.