Emitir DTE en el SII (no disponible)
Contrato futuro reservado.
| Tool ID | sii.dte.emitir |
| Nombre MCP | sii__dte__emitir |
| Conector | sii |
| Plano | action |
| Scope (permiso) | sii:write |
| Auth | connection_credentials |
| Versión | 1 |
| Sensible | sí |
| Deprecado | no |
| Comportamiento | readOnly=false, destructive=true, idempotent=true, openWorld=true |
Requiere conexión. Indica cuál en cada llamada: header
X-Connect-Connectionen REST, campoconnectionIden elexecute_writede MCP y en las opciones del SDK. No hay resolución implícita, ni siquiera con una sola conexión activa: la conexión es la empresa. El id sale deconexiones.estado.consultar.
Qué hace
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.
Entrada
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
previewToken | string | sí | Token opaco devuelto por sii.dte.previsualizar; debe estar vigente y pertenecer a la misma conexión. |
JSON Schema de entrada
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"previewToken": {
"type": "string",
"minLength": 1,
"description": "Token opaco devuelto por sii.dte.previsualizar; debe estar vigente y pertenecer a la misma conexión."
}
},
"required": [
"previewToken"
],
"additionalProperties": false
}Salida
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
resultado | valor | sí | Resultado terminal allowlisted de la operación de emisión. |
JSON Schema de salida
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"resultado": {
"oneOf": [
{
"type": "object",
"properties": {
"estado": {
"type": "string",
"const": "emitido",
"description": "El SII confirmó de manera concluyente la emisión."
},
"operacionId": {
"type": "string",
"pattern": "^req_[0-9a-z]{21}$",
"description": "Identificador estable de la operación regulada."
},
"tipoDte": {
"type": "string",
"enum": [
"33",
"34",
"52",
"56",
"61"
],
"description": "Tipo DTE contemplado por los contratos publicados: 33, 34, 52, 56 o 61. Su presencia no implica habilitación productiva."
},
"variante": {
"type": "string",
"enum": [
"33:del_giro:del_giro:credito",
"34:del_giro:del_giro:credito",
"52:constituye_venta",
"56:corregir_montos:34_exenta",
"61:corregir_montos:34_exenta"
],
"description": "Identidad exacta de la variante tributaria previsualizada."
},
"folio": {
"type": "string",
"minLength": 1,
"description": "Folio confirmado por el SII para el documento emitido."
},
"fechaEmision": {
"type": "string",
"description": "Fecha de emisión confirmada por el SII."
},
"confirmadoEn": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
"description": "Instante en que el SII confirmó la emisión."
}
},
"required": [
"estado",
"operacionId",
"tipoDte",
"variante",
"folio",
"fechaEmision",
"confirmadoEn"
],
"additionalProperties": false,
"description": "Resultado concluyente de una emisión confirmada."
},
{
"type": "object",
"properties": {
"estado": {
"type": "string",
"const": "rechazado",
"description": "El SII rechazó la operación de manera concluyente."
},
"operacionId": {
"type": "string",
"pattern": "^req_[0-9a-z]{21}$",
"description": "Identificador estable de la operación regulada."
},
"tipoDte": {
"type": "string",
"enum": [
"33",
"34",
"52",
"56",
"61"
],
"description": "Tipo DTE contemplado por los contratos publicados: 33, 34, 52, 56 o 61. Su presencia no implica habilitación productiva."
},
"variante": {
"type": "string",
"enum": [
"33:del_giro:del_giro:credito",
"34:del_giro:del_giro:credito",
"52:constituye_venta",
"56:corregir_montos:34_exenta",
"61:corregir_montos:34_exenta"
],
"description": "Identidad exacta de la variante tributaria previsualizada."
},
"codigo": {
"type": "string",
"minLength": 1,
"description": "Código normalizado del rechazo concluyente."
},
"puedeReintentar": {
"type": "boolean",
"const": false,
"description": "Siempre false: una operación regulada rechazada no se reintenta automáticamente."
}
},
"required": [
"estado",
"operacionId",
"tipoDte",
"variante",
"codigo",
"puedeReintentar"
],
"additionalProperties": false,
"description": "Resultado concluyente de una emisión rechazada."
},
{
"type": "object",
"properties": {
"estado": {
"type": "string",
"const": "resultado_desconocido",
"description": "No existe evidencia suficiente para afirmar emisión ni rechazo."
},
"operacionId": {
"type": "string",
"pattern": "^req_[0-9a-z]{21}$",
"description": "Identificador estable de la operación regulada."
},
"tipoDte": {
"type": "string",
"enum": [
"33",
"34",
"52",
"56",
"61"
],
"description": "Tipo DTE contemplado por los contratos publicados: 33, 34, 52, 56 o 61. Su presencia no implica habilitación productiva."
},
"variante": {
"type": "string",
"enum": [
"33:del_giro:del_giro:credito",
"34:del_giro:del_giro:credito",
"52:constituye_venta",
"56:corregir_montos:34_exenta",
"61:corregir_montos:34_exenta"
],
"description": "Identidad exacta de la variante tributaria previsualizada."
},
"puedeReintentar": {
"type": "boolean",
"const": false,
"description": "Siempre false: no se repite una operación cuyo resultado externo es desconocido."
},
"siguientePaso": {
"type": "string",
"const": "reconciliacion_automatica_o_soporte",
"description": "La única salida segura es reconciliar evidencia o escalar a soporte."
}
},
"required": [
"estado",
"operacionId",
"tipoDte",
"variante",
"puedeReintentar",
"siguientePaso"
],
"additionalProperties": false,
"description": "Resultado inconcluso que exige reconciliación antes de cualquier acción."
}
],
"description": "Resultado terminal allowlisted de la operación de emisión."
}
},
"required": [
"resultado"
],
"additionalProperties": false
}Errores de esta tool
| Código | HTTP | Reintentable | Qué hacer |
|---|---|---|---|
connection_disabled | 403 | no | Reactívala en /connections o usa otra conexión del mismo sistema. |
connection_credential_required | 428 | no | Crea un enlace con conexiones.enlace.crear (modo reconectar si la conexión ya existe) y pide a la persona que entregue la credencial de nuevo. No reintentes con la credencial anterior. |
connection_busy | 409 | sí | Espera unos segundos y reintenta. Es una espera transitoria: no necesitas volver a conectar ni ingresar la credencial otra vez. |
upstream_error | 502 | sí | Reintenta más tarde. Si persiste, el problema está en el sistema externo, no en tu integración. |
timeout | 504 | sí | Reintenta. Para sincronizaciones largas usa la vía asíncrona y consulta el estado del trabajo. |
Toda llamada puede devolver además los códigos transversales (validation_error, unauthorized, scope_not_granted, rate_limited, entre otros): el detalle vive en el catálogo de errores.
Detallar un documento respaldado del SII
Devuelve UN documento tributario respaldado, con su detalle completo: los ítems (nombre, cantidad, unidad, precio unitario y monto), los giros, direcciones y comunas de emisor y receptor, y la forma de pago.
Previsualizar DTE en el SII
Valida y previsualiza un documento en el Facturador Gratuito del SII sin guardarlo ni emitirlo.