Emisso Connect

Emitir DTE en el SII (no disponible)

Contrato futuro reservado.

Tool IDsii.dte.emitir
Nombre MCPsii__dte__emitir
Conectorsii
Planoaction
Scope (permiso)sii:write
Authconnection_credentials
Versión1
Sensible
Deprecadono
ComportamientoreadOnly=false, destructive=true, idempotent=true, openWorld=true

Requiere conexión. Indica cuál en cada llamada: header X-Connect-Connection en REST, campo connectionId en el execute_write de 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 de conexiones.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

CampoTipoRequeridoDescripción
previewTokenstringToken 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

CampoTipoRequeridoDescripción
resultadovalorResultado 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ódigoHTTPReintentableQué hacer
connection_disabled403noReactívala en /connections o usa otra conexión del mismo sistema.
connection_credential_required428noCrea 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_busy409Espera unos segundos y reintenta. Es una espera transitoria: no necesitas volver a conectar ni ingresar la credencial otra vez.
upstream_error502Reintenta más tarde. Si persiste, el problema está en el sistema externo, no en tu integración.
timeout504Reintenta. 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.

On this page