Saltearse al contenido
Nappai Documentation

Holded Accounting Component

El Holded Accounting Component te permite interactuar con la contabilidad de Holded directamente desde tu dashboard de Nappai. Con él puedes consultar o crear registros en el Diario Diario (Daily Ledger) y en el Plan de Cuentas (Chart of Accounts) sin salir de la plataforma.

¿Cómo funciona?

El componente se conecta a la API de Holded usando la clave API que has guardado en la sección de credenciales de Nappai. Cuando lo activas, seleccionas el recurso (Daily Ledger o Chart of Accounts) y la operación que deseas realizar (List all entries o Create entry). Internamente llama a la función correspondiente de Holded y devuelve la respuesta en formato Message. Si el componente se usa como herramienta, también expone un objeto Tool que puede ser llamado por los agentes de IA.

Operaciones

Este componente ofrece varias operaciones que puedes seleccionar según lo que necesites hacer. Solo puedes usar una operación a la vez:

  • List all entries: Recupera todos los registros existentes del recurso seleccionado.
  • Create entry: Crea un nuevo registro en el recurso seleccionado.

Para usar el componente, primero selecciona la operación que necesitas en el campo “Operation” (Operación).

Entradas

Modo de Mapeo (Mapping Mode)

Este componente cuenta con un modo especial llamado “Mapping Mode” (Modo de Mapeo). Cuando activas este modo mediante el interruptor, se habilita una entrada adicional llamada “Mapping Data” y cada campo de entrada te ofrece tres formas diferentes de proporcionar datos:

  • Fixed (Fijo): Escribes el valor directamente en el campo.
  • Mapped (Mapeado): Conectas la salida de otro componente para usar su resultado como valor.
  • Javascript: Escribes código Javascript para calcular el valor dinámicamente.

Esta flexibilidad te permite crear flujos de trabajo más dinámicos y conectados.

Campos de Entrada

Los siguientes campos están disponibles para configurar este componente. Cada campo puede estar visible en diferentes operaciones:

  • Mapping Mode: Habilita el modo de mapeo para procesar múltiples registros en lote.
  • Resource: Selecciona el recurso de contabilidad que quieres gestionar (Daily Ledger o Chart of Accounts).
  • Operation: Escoge la acción que quieres ejecutar sobre el recurso (List all entries o Create entry).
  • Tool Name: El nombre que aparecerá ante el agente cuando el componente se utilice como herramienta.
  • Tool Description: Una descripción detallada de lo que hace el componente para que el agente lo entienda correctamente.
  • Tools arguments metadata: Define la metadata de los argumentos que la herramienta recibirá.

Importante: Este componente necesita una credencial de tipo Holded Task API.

  1. Configura primero la credencial en la sección de credenciales de Nappai.
  2. Luego selecciona esa credencial en el campo Credential del componente.
    La credencial debe contener la Holded Api Key que puedes obtener en https://app.holded.com/account/setup#settings:/api.

Salidas

  • Response: Devuelve la respuesta de la API de Holded en formato Message. Puedes usarla para ver los datos o para pasar la información a otro componente.
  • Tool: Devuelve un objeto Tool que permite que agentes de IA invoquen esta acción directamente.

Ejemplo de Uso

  1. Configura la credencial

    • Ve a Credenciales → Agregar credencial → Holded Task API.
    • Introduce tu Holded Api Key y guarda.

  2. Añade el componente al flujo

    • Selecciona Resource = Daily Ledger.
    • Selecciona Operation = List all entries.
    • En Credential elige la credencial que acabas de crear.

  3. Ejecuta

    • Haz clic en Ejecutar y el componente devolverá un Message con la lista de entradas del Diario Diario.

  4. Uso con Mapeo

    • Activa Mapping Mode.
    • Conecta la salida de un componente que genere un array de fechas a la entrada Mapping Data.
    • El componente procesará cada fecha y devolverá un array de respuestas, lo que permite obtener los diarios de varios días en una sola ejecución.

Componentes Relacionados

  • Holded API Component – Permite realizar llamadas genéricas a la API de Holded.
  • Nappai Base Component – Base común para todos los componentes de Nappai.

Consejos y Mejores Prácticas

  • Usa Mapping Mode cuando necesites procesar varios registros a la vez; evita ejecutar el componente repetidamente.
  • Mantén la clave API en la sección de credenciales y nunca la escribas directamente en el flujo.
  • Si vas a crear entradas, valida primero los datos con un componente de validación para evitar errores de formato.

Consideraciones de Seguridad

  • La clave API se almacena en la sección de credenciales de Nappai, lo que evita exponerla en el flujo.
  • Asegúrate de que solo usuarios autorizados tengan acceso a la credencial y al componente.
  • Revisa los logs de la API de Holded para detectar accesos inesperados.