Emisso Connect

Listar los DTEs recientes

Lista los DTEs MÁS RECIENTES emitidos por esta empresa en Notta (del más nuevo al más antiguo).

Tool IDnotta.dte.listar
Nombre MCPnotta__dte__listar
Conectornotta
Planoaction
Scope (permiso)notta:read
Authconnection_credentials
Versión1
Sensible
Deprecadono
ComportamientoreadOnly=true, destructive=false, idempotent=true, openWorld=true

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

El API de Notta NO ofrece filtros por tipo, fecha, estado ni receptor: solo un límite de cuántos traer, así que si buscas uno concreto pide más documentos y descarta tú los que no son. Úsalo como red antes de reintentar una emisión que falló por transporte o timeout: si el documento ya aparece entre los recientes, no lo vuelvas a emitir. Devuelve menos campos que notta.dte.consultar (sin neto, IVA ni ambiente): para el detalle completo consulta por id.

Entrada

CampoTipoRequeridoDescripción
limiteentero 1-100noCuántos documentos traer, entre 1 y 100; si se omite, Notta trae 20. Es el único filtro que el API ofrece: no hay filtro por tipo, fecha, estado ni receptor, así que para encontrar uno concreto pide más y descarta tú.
JSON Schema de entrada
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "limite": {
      "description": "Cuántos documentos traer, entre 1 y 100; si se omite, Notta trae 20. Es el único filtro que el API ofrece: no hay filtro por tipo, fecha, estado ni receptor, así que para encontrar uno concreto pide más y descarta tú.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  }
}

Salida

CampoTipoRequeridoDescripción
dteslista de objetoLos documentos, del más nuevo al más antiguo. Traen menos campos que notta.dte.consultar: sin neto, exento, IVA ni ambiente del SII.
dtes[].idstringEl identificador del documento en Notta. Es lo que reciben notta.dte.consultar, notta.dte.descargar y notta.dte.reenviar.
dtes[].tipo_dteenteroEl código de tipo de documento del catálogo del SII. Los que esta conexión emite son 33 (factura afecta), 34 (factura exenta), 56 (nota de débito) y 61 (nota de crédito).
dtes[].folioenteronull
dtes[].estadostringEl estado del documento. 'queued' es recién encolado con el folio ya asignado; 'EPR' es aceptado por el SII; 'RPR' y 'aceptado_con_reparos' son aceptado con reparos; 'RFR', 'RCT' y 'RSC' son rechazos terminales que ya no cambian. Decide por este campo, nunca por 'estado_legible'.
dtes[].estado_legiblestringEl 'estado' traducido a una frase en español para mostrarle a una persona. Es texto de presentación, no contrato: para decidir usa 'estado'.
dtes[].monto_totalenteronull
dtes[].fecha_emisionstringLa fecha de emisión declarada en el documento, en formato AAAA-MM-DD.
dtes[].rut_receptorstringnoEl RUT de quien recibe el documento, sin puntos y con guion. Ausente cuando Notta no lo informó.
JSON Schema de salida
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "dtes": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "El identificador del documento en Notta. Es lo que reciben notta.dte.consultar, notta.dte.descargar y notta.dte.reenviar."
          },
          "tipo_dte": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991,
            "description": "El código de tipo de documento del catálogo del SII. Los que esta conexión emite son 33 (factura afecta), 34 (factura exenta), 56 (nota de débito) y 61 (nota de crédito)."
          },
          "folio": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "El folio del documento: el correlativo que sale de los folios autorizados (CAF) y con el que el SII lo identifica. Se consume una sola vez y no se reutiliza, así que emitir dos veces por error gasta dos. Viene en null cuando Notta todavía no lo informó."
          },
          "estado": {
            "type": "string",
            "description": "El estado del documento. 'queued' es recién encolado con el folio ya asignado; 'EPR' es aceptado por el SII; 'RPR' y 'aceptado_con_reparos' son aceptado con reparos; 'RFR', 'RCT' y 'RSC' son rechazos terminales que ya no cambian. Decide por este campo, nunca por 'estado_legible'."
          },
          "estado_legible": {
            "type": "string",
            "description": "El 'estado' traducido a una frase en español para mostrarle a una persona. Es texto de presentación, no contrato: para decidir usa 'estado'."
          },
          "monto_total": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "El total del documento. Viene en null cuando Notta no lo informó, que no es lo mismo que un documento por cero."
          },
          "fecha_emision": {
            "type": "string",
            "description": "La fecha de emisión declarada en el documento, en formato AAAA-MM-DD."
          },
          "rut_receptor": {
            "description": "El RUT de quien recibe el documento, sin puntos y con guion. Ausente cuando Notta no lo informó.",
            "type": "string"
          }
        },
        "required": [
          "id",
          "tipo_dte",
          "folio",
          "estado",
          "estado_legible",
          "monto_total",
          "fecha_emision"
        ],
        "additionalProperties": false
      },
      "description": "Los documentos, del más nuevo al más antiguo. Traen menos campos que notta.dte.consultar: sin neto, exento, IVA ni ambiente del SII."
    }
  },
  "required": [
    "dtes"
  ],
  "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. El candado es por conexión y se suelta solo.
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