Connect
API REST

Emitir boleta en e-Boleta

Emite en E-Boleta del SII la boleta de un previewRef vigente. Quien la preparó la confirma al emitir; exige Idempotency-Key UUID v4 explícita. Si E-Boleta devuelve el folio, responde emitida en la misma llamada. Si la respuesta se pierde, responde resultado_desconocido y la reconciliación lo resuelve: repite la MISMA clave para consultarlo; una clave nueva emitiría otra boleta.

POST
/v1/tools/sii.boleta.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.boleta.emitir/execute" \  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \  -H "Idempotency-Key: 9d1f4c2a-7b30-4e58-9c11-2f6a8de5b743" \  -H "Content-Type: application/json" \  -d '{    "input": {      "previewRef": "stringstringstringstring"    }  }'
{  "data": {    "resultado": {      "tipoDte": "39",      "puedeReintentar": false,      "estado": "emitida",      "folio": "string",      "pdfUrl": "http://example.com"    }  },  "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 boleta POST

Descarga desde E-Boleta del SII el PDF oficial de una boleta 39 o 41 de la empresa de la conexión, por tipo, folio y fecha de emisión, y lo devuelve en base64 con su SHA-256 y con su enlace oficial de E-Boleta (pdfUrl). No emite ni guarda nada. Requiere las boletas encendidas en la conexión (acceso de representante) y el permiso sii:boletas:write.

Preparar boleta en e-Boleta POST

Prepara una boleta 39 o 41 en E-Boleta del SII sin emitir y devuelve previewRef, vigente 15 minutos. Requiere la conexión de representante con las boletas activas y el permiso sii:boletas:write. Si la empresa tiene varias sucursales en E-Boleta, indica en `sucursal` desde cuál se emite esta boleta (los códigos salen de sii.boleta_sucursales.listar); con una sola se usa esa. La respuesta dice qué sucursal se usó.