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 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-Connectionen REST, campoconnectionIden elexecutede 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
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
| 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
{
"$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
| 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í |
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í |
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
{
"$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ó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.
Emitir DTE (factura o nota)
Emite un DTE ante el SII vía Notta: factura afecta (33), exenta (34), nota de débito (56) o nota de crédito (61, que exige references[] al documento original, y este solo puede ser una factura 33 o 34).
Reenviar un DTE por correo
Reenvía el PDF y el XML de un DTE ya emitido al correo del receptor.