Estado de una aprobación pendiente
Devuelve en qué quedó una aprobación pendiente.
| Tool ID | notta.dte.aprobacion |
| Nombre MCP | notta__dte__aprobacion |
| 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 y campoconnectionIden elexecutede MCP. 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 id NO es el del documento: lo devuelve la emisión cuando el documento queda esperando que una persona lo apruebe en Notta. Dice si sigue pendiente, si se aprobó, se rechazó o venció, el documento que salió de ella cuando lo hay, y qué le toca hacer a quien llama.
Entrada
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string `^([0-9a-fA-F]8-[0-9a-fA-F]4-[1-8][0-9a-fA-F]3-[89abAB][0-9a-fA-F]3-[0-9a-fA-F]12 | 00000000-0000-0000-0000-000000000000 | ffffffff-ffff-ffff-ffff-ffffffffffff)$` |
JSON Schema de entrada
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "UUID de la solicitud de aprobación: el `pending_id` que devolvió el 202 de `POST /dtes`. NO es el `id` del documento, que aparece en `result_ref` cuando la aprobación termina."
}
},
"required": [
"id"
]
}Salida
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string `^([0-9a-fA-F]8-[0-9a-fA-F]4-[1-8][0-9a-fA-F]3-[89abAB][0-9a-fA-F]3-[0-9a-fA-F]12 | 00000000-0000-0000-0000-000000000000 | ffffffff-ffff-ffff-ffff-ffffffffffff)$` |
status | "pending" · "approved" · "rejected" · "expired" | sí | pending = esperando a una persona, no hay nada emitido todavía. approved = alguien aprobó y el documento siguió su curso (míralo en result_ref). rejected = alguien lo rechazó y no se emitió nada; el motivo va en rejection_reason. expired = venció expires_at sin que nadie decidiera, y tampoco se emitió nada. Los tres últimos son finales: reintentar esta solicitud no la revive. |
kind | "emit_dte" · "recepcion_evento" | sí | Qué está esperando aprobación: emit_dte (emitir un documento) o recepcion_evento (aceptar o reclamar un documento recibido). |
result_ref | string `^([0-9a-fA-F]8-[0-9a-fA-F]4-[1-8][0-9a-fA-F]3-[89abAB][0-9a-fA-F]3-[0-9a-fA-F]12 | 00000000-0000-0000-0000-000000000000 | ffffffff-ffff-ffff-ffff-ffffffffffff)$` |
rejection_reason | string | null | sí |
expires_at | string | sí | Instante ISO-8601 en que la solicitud vence si nadie decide. Pasado ese punto queda en expired y hay que volver a pedir la operación desde cero. |
resolved_at | string | null | sí |
created_at | string | sí | Instante en que se creó la solicitud. |
next_action | "wait_for_human_approval" · "get_dte" · "fix_and_retry" · "emit_dte_again" | sí | Qué le toca al llamante en este estado, en el vocabulario que el resto de la API ya usa. |
links | objeto | no | Presente solo cuando hay result_ref. |
links.dte | string | sí | Ruta del documento que salió de la aprobación. |
JSON Schema de salida
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "UUID de esta solicitud de aprobación (el `pending_id` del 202). NO es el `id` del documento: ese llega en `result_ref` cuando la aprobación termina."
},
"status": {
"type": "string",
"enum": [
"pending",
"approved",
"rejected",
"expired"
],
"description": "`pending` = esperando a una persona, no hay nada emitido todavía. `approved` = alguien aprobó y el documento siguió su curso (míralo en `result_ref`). `rejected` = alguien lo rechazó y no se emitió nada; el motivo va en `rejection_reason`. `expired` = venció `expires_at` sin que nadie decidiera, y tampoco se emitió nada. Los tres últimos son finales: reintentar esta solicitud no la revive."
},
"kind": {
"type": "string",
"enum": [
"emit_dte",
"recepcion_evento"
],
"description": "Qué está esperando aprobación: `emit_dte` (emitir un documento) o `recepcion_evento` (aceptar o reclamar un documento recibido)."
},
"result_ref": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
{
"type": "null"
}
],
"description": "El DTE que salió de la aprobación. Presente TAMBIÉN si el SII lo rechazó (D36)."
},
"rejection_reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "El motivo que escribió la persona al rechazar (D41). null si no dijo por qué."
},
"expires_at": {
"type": "string",
"description": "Instante ISO-8601 en que la solicitud vence si nadie decide. Pasado ese punto queda en `expired` y hay que volver a pedir la operación desde cero."
},
"resolved_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Instante en que una persona aprobó o rechazó. null mientras siga `pending`."
},
"created_at": {
"type": "string",
"description": "Instante en que se creó la solicitud."
},
"next_action": {
"type": "string",
"enum": [
"wait_for_human_approval",
"get_dte",
"fix_and_retry",
"emit_dte_again"
],
"description": "Qué le toca al llamante en este estado, en el vocabulario que el resto de la API ya usa."
},
"links": {
"type": "object",
"properties": {
"dte": {
"type": "string",
"description": "Ruta del documento que salió de la aprobación."
}
},
"required": [
"dte"
],
"additionalProperties": false,
"description": "Presente solo cuando hay `result_ref`."
}
},
"required": [
"id",
"status",
"kind",
"result_ref",
"rejection_reason",
"expires_at",
"resolved_at",
"created_at",
"next_action"
],
"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_not_found | 404 | no | Usa uno de los connectionId que lista el error, o revisa la conexión en /connections. No hace falta reactivar nada. |
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.
Verificar conexión Notta
Prueba las credenciales de la conexión contra Notta haciendo un login real (y su logout, a cargo del pipeline).
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; su folio_ref va en TEXTO, tal como lo devuelve sii.rcv.consultar).