# Listar los DTEs recientes > Lista los DTEs MÁS RECIENTES emitidos por esta empresa en Notta (del más nuevo al más antiguo). {/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */} | | | | ------------------- | ----------------------------------------------------------------- | | **Tool ID** | `notta.dte.listar` | | **Nombre MCP** | `notta__dte__listar` | | **Conector** | `notta` | | **Plano** | `action` | | **Scope (permiso)** | `notta:read` | | **Auth** | `connection_credentials` | | **Versión** | `1` | | **Sensible** | sí | | **Deprecado** | no | | **Comportamiento** | readOnly=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`](../conexiones/estado-consultar). ## Qué hace [#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 [#entrada] | Campo | Tipo | Requerido | Descripción | | -------- | ------------ | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `limite` | entero 1-100 | no | 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ú. |
JSON Schema de entrada ```json { "$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 [#salida] | Campo | Tipo | Requerido | Descripción | | | ----------------------- | --------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `dtes` | lista de objeto | sí | 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. | | | `dtes[].id` | string | sí | El identificador del documento en Notta. Es lo que reciben notta.dte.consultar, notta.dte.descargar y notta.dte.reenviar. | | | `dtes[].tipo_dte` | entero | sí | 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). | | | `dtes[].folio` | entero | null | sí | 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ó. | | `dtes[].estado` | string | sí | 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'. | | | `dtes[].estado_legible` | string | sí | 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'. | | | `dtes[].monto_total` | entero | null | sí | El total del documento. Viene en null cuando Notta no lo informó, que no es lo mismo que un documento por cero. | | `dtes[].fecha_emision` | string | sí | La fecha de emisión declarada en el documento, en formato AAAA-MM-DD. | | | `dtes[].rut_receptor` | string | no | El RUT de quien recibe el documento, sin puntos y con guion. Ausente cuando Notta no lo informó. | |
JSON Schema de salida ```json { "$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 [#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. El candado es por conexión y se suelta solo. | | `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](../errores).