Esta guía asume que ya ha instalado el conector. Si no es así, consulte primero la Guía de instalación.

Abrir la pantalla de configuración

Desde Gateway of Tally, seleccione SurveyAnalytica Connector. La pantalla de configuración tiene dos secciones: Global Settings en la parte superior y una tabla de Transaction Types a continuación.

Paso 1 — Elija su entorno

En la parte superior de la pantalla, use el menú desplegable Environment para seleccionar:

• Test — envía datos al entorno de staging de SurveyAnalytica. Úselo mientras configura y realiza pruebas.
• Production — envía datos a su cuenta de SurveyAnalytica en producción. Cambie a esta opción una vez finalizadas las pruebas.

Paso 2 — Obtenga su URL de webhook y su clave API de SurveyAnalytica

1. En SurveyAnalytica, abra el workflow en el que desea recibir los datos de Tally.
2. Haga clic en el paso Trigger y asegúrese de que el tipo de trigger esté configurado como Webhook.
3. Anote el valor de KEY: esta es su clave API para el conector.
4. Anote el Workflow ID: este es el identificador único que se muestra en la URL del webhook después de /webhook/.

Paso 3 — Configure los tipos de transacción

La tabla de Transaction Types enumera todos los tipos de comprobante y registros maestros disponibles en su empresa de Tally, incluidos los tipos personalizados agregados por otros módulos TDL.

Para cada tipo de transacción que desee sincronizar:

1. Configure Enable en Yes.
2. Ingrese el Workflow ID de SurveyAnalytica (la parte después de /webhook/ en su URL de webhook).
3. Ingrese la API Key (el valor KEY del panel de trigger).
4. Elija un Auth Type:
   • API Key — opción estándar para la mayoría de los workflows.
   • Basic Auth — use el nombre de usuario y la contraseña separados por dos puntos en el campo API Key.
   • OAuth 2.0 — ingrese sus credenciales de cliente OAuth; el conector obtiene y renueva los tokens automáticamente.
   • HMAC-SHA256 — genera una firma de solicitud para mayor seguridad.
5. Elija un Trigger Mode:
   • Realtime — envía datos inmediatamente cada vez que se guarda un comprobante de este tipo.
   • Batch — recopila comprobantes y los envía juntos a un intervalo establecido (5, 15, 30 o 60 minutos). Úselo para reducir el tráfico de red en tipos de transacción de alto volumen.
   • Scheduled — ejecuta una sincronización completa a diario, semanal o mensualmente a la hora que especifique. Adecuado para informes de fin de día.
   • One-time — use el botón manual Sync Now en el menú del conector para exportaciones puntuales.

Puede configurar diferentes Workflow ID, Auth Type y Trigger Mode para cada tipo de transacción de forma independiente.

Paso 4 — Guarde la configuración

Presione Ctrl+A o haga clic en Save Config. Su configuración se guarda dentro de Tally y persiste entre reinicios.

Paso 5 — Pruebe la conexión

1. Desde el menú Gateway of Tally → SurveyAnalytica Connector, seleccione Test Connection.
2. El conector envía un ping de prueba a cada workflow habilitado y muestra un mensaje de éxito o error por cada tipo de transacción.
3. En SurveyAnalytica, vaya al trigger del workflow y haga clic en Check Status para confirmar que se recibió el payload de prueba.

Envío de un comprobante de prueba

Guarde cualquier comprobante de un tipo habilitado en Tally (por ejemplo, cree un Sales Voucher de prueba). Si el modo de trigger es Realtime, los datos aparecen en su workflow de SurveyAnalytica en cuestión de segundos. Puede verlo en el panel Check Status del workflow, dentro del panel de trigger.

Solución de problemas

Los datos no llegan a SurveyAnalytica

• Verifique que el workflow esté en estado Active en SurveyAnalytica.
• Verifique que el Workflow ID y la API Key estén ingresados correctamente — cópielos y péguelos en lugar de escribirlos.
• Confirme que el entorno correcto (Test o Production) esté seleccionado en el conector.
• Si usa el modo Batch, espere a que transcurra el intervalo, o cambie temporalmente a Realtime para confirmar que la conexión funciona.

El menú de SurveyAnalytica Connector no aparece en Gateway of Tally

• Confirme que el archivo TDL esté listado y habilitado en F12 → TDL & Add-On.
• Verifique si hay errores de carga de TDL en Help → TDL & Add-On.
• Asegúrese de que su versión de Tally Prime sea 7.0 o posterior.

Test Connection muestra un error

• Verifique que su PC con Tally tenga acceso a internet y pueda alcanzar integration.surveyanalytica.com (Production) o la URL de prueba.
• Si su empresa usa un proxy o firewall, pida a su equipo de TI que permita el tráfico HTTPS saliente hacia esos dominios.