Connect
API REST

Emitir DTE en el SII

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.

POST
/v1/tools/sii.dte.emitir/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_
Idempotency-Key*string

UUID v4 canónica generada por el caller para esta acción destructiva. Es obligatoria: el gateway no la autogenera. Reenvía exactamente la misma UUID para consultar o reconciliar el mismo intento; una UUID distinta identifica otra operación.

Match^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
Formatuuid

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.emitir/execute" \  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \  -H "Idempotency-Key: 9d1f4c2a-7b30-4e58-9c11-2f6a8de5b743" \  -H "Content-Type: application/json" \  -d '{    "input": {      "previewRef": "string"    }  }'
{  "data": {    "resultado": {      "estado": "emitido",      "operacionId": "string",      "tipoDte": "33",      "variante": "33:del_giro:del_giro:credito",      "folio": "string",      "fechaEmision": "string",      "confirmadoEn": "2019-08-24T14:15:22Z",      "xmlFirmado": "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  }}

Descargar el PDF de una factura, guía o nota POST

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.

Previsualizar DTE en el SII POST

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.