Connect

Estado de una aprobación pendiente

Devuelve en qué quedó una aprobación pendiente.

Tool IDnotta.dte.aprobacion
Nombre MCPnotta__dte__aprobacion
Conectornotta
Planoaction
Scope (permiso)notta:read
Authconnection_credentials
Versión1
Sensiblesí
Deprecadono
ComportamientoreadOnly=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.

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

CampoTipoRequeridoDescripción
idstring `^([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]1200000000-0000-0000-0000-000000000000ffffffff-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

CampoTipoRequeridoDescripción
idstring `^([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]1200000000-0000-0000-0000-000000000000ffffffff-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_refstring `^([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]1200000000-0000-0000-0000-000000000000ffffffff-ffff-ffff-ffff-ffffffffffff)$`
rejection_reasonstringnullsí
expires_atstringsí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_atstringnullsí
created_atstringsí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.
linksobjetonoPresente solo cuando hay result_ref.
links.dtestringsí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ódigoHTTPReintentableQué hacer
connection_disabled403noReactívala en /connections o usa otra conexión del mismo sistema.
connection_not_found404noUsa uno de los connectionId que lista el error, o revisa la conexión en /connections. No hace falta reactivar nada.
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_busy409síEspera unos segundos y reintenta. Es una espera transitoria: no necesitas volver a conectar ni ingresar la credencial otra vez.
upstream_error502síReintenta más tarde. Si persiste, el problema está en el sistema externo, no en tu integración.
timeout504sí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.

En esta página