# Estado de una aprobación pendiente > Devuelve en qué quedó una aprobación pendiente. {/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */} | | | | ------------------- | ----------------------------------------------------------------- | | **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-Connection` en REST y campo `connectionId` en el `execute` de MCP. 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`](/docs/referencia/conexiones/estado-consultar). ## Qué hace [#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 [#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)$\` | sí | 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. |
JSON Schema de entrada ```json { "$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 [#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)$\` | sí | 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` | `"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)$\` | null | sí | El DTE que salió de la aprobación. Presente TAMBIÉN si el SII lo rechazó (D36). | | `rejection_reason` | string | null | sí | El motivo que escribió la persona al rechazar (D41). null si no dijo por qué. | | | | `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í | Instante en que una persona aprobó o rechazó. null mientras siga `pending`. | | | | `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 ```json { "$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 [#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](/docs/referencia/errores).