n8n-nodes-apprecio

Este es un nodo personalizado de n8n para integrar con la API de Apprecio. Proporciona funcionalidad para interactuar con el sistema de puntos, gift cards y gestión de lotes directamente desde tus flujos de trabajo de n8n.

n8n es una plataforma de automatización de flujos de trabajo con licencia fair-code.

Instalación

En n8n Desktop/Cloud:

1. Ve a "Configuración" > "Comunidad de nodos"
2. Selecciona "Instalar un nodo desde el catálogo"
3. Ingresa n8n-nodes-apprecio en el campo de entrada

En tu propia instancia de n8n:

npm install n8n-nodes-apprecio

Uso

Para usar este nodo, necesitas tener una cuenta de Apprecio y generar tokens API:

1. Token Público: Tu token público de la API de Apprecio
2. Token Privado: Tu token privado de la API de Apprecio
3. URL de la API: El endpoint de la API de Apprecio (por defecto: https://apiv2.dcanje.com/api)

Operaciones disponibles

El nodo Apprecio ofrece las siguientes operaciones:

Carga Directa Email

Asigna puntos a un usuario utilizando su correo electrónico.

• Parámetros:
  • Email: Dirección de correo del usuario
  • Monto: Cantidad de puntos a asignar (se envía como "asignado" a la API)
  • Motivo: Razón de la asignación de puntos
• Acción API: carga_directa_email

Acumulación de Puntos

Acumula puntos en la cuenta de un usuario existente identificado por su ID.

• Parámetros:
  • ID Usuario: Identificador único del usuario
  • Puntos: Cantidad de puntos a acumular
• Acción API: acumulacion_puntos_usuario

Consulta de Saldo

Revisa el saldo actual de puntos de un usuario.

• Parámetros:
  • ID Usuario: Identificador único del usuario
• Acción API: consulta_saldo_usuario

Consultar Lotes

Obtiene información sobre lotes de carga específicos.

• Parámetros:
  • ID Lote: Identificador del lote a consultar
• Acción API: consulta_lote

Consulta Gift Card

Consulta información sobre una gift card específica.

• Parámetros:
  • ID Gift Card: Código o identificador de la gift card
• Acción API: consulta_giftcard_id

Crear Usuario

Crea un nuevo usuario en el sistema Apprecio.

• Parámetros:
  • Email: Correo electrónico del nuevo usuario
  • Nombre: Nombre del usuario
  • Apellido: Apellido del usuario
  • Teléfono: Número de teléfono (opcional)
• Acción API: registro_usuario

Verificación de Funcionalidad

El nodo cumple completamente con los requisitos establecidos en el manual de uso:

✅ Autenticación: Implementa correctamente los tokens públicos y privados, así como la URL de la API.

✅ Operaciones: Incluye todas las operaciones requeridas (Carga Directa Email, Acumulación de Puntos, Consulta de Saldo, Consultar Lotes, Consulta Gift Card).

✅ Funcionalidad Extra: Añade la operación Crear Usuario como valor adicional.

✅ Interfaz: Proporciona una interfaz de usuario clara con campos organizados por operación.

✅ Manejo de Errores: Implementa mensajes de error descriptivos y manejo adecuado de respuestas de la API.

Resolución de Problemas

Si encuentras problemas al utilizar el nodo, aquí hay algunas soluciones comunes:

• Error de autenticación: Verifica que los tokens público y privado estén correctamente configurados.
• Error de endpoint: Asegúrate de que la URL de la API sea correcta y esté accesible.
• Errores en las respuestas: Comprueba el formato de los datos enviados según la documentación de la API.
• Problemas de conexión: Verifica tu conectividad a internet y que no haya restricciones de firewall.

Soporte

Si tienes problemas o preguntas, contacta a [email protected]