Guía de configuración de TDIGITAL Sync for Zoho CRM & SAPB1

Antes de comenzar

El recorrido de configuración cubre:

• arranque técnico desde post-install
• reanudación del onboarding desde el Settings Widget
• selección o confirmación de plan desde el widget
• provisión o reconciliación del acceso inicial al panel
• notificación por correo al administrador con enlace y OTP para terminar el alta inicial del usuario cuando corresponde
• continuidad en el panel para validar Zoho Org, conexión SAP Business One, enlaces, mappings y prueba controlada

Los planes hoy visibles en Marketplace son:

• Standard y Professional

La prueba inicial de 15 días está asociada a Professional.

Recorrido de configuración

Paso 1. Confirmar el estado de onboarding

Abra el Settings Widget y confirme:

• que ZOHO.embeddedApp.init() finaliza correctamente
• que el widget puede consultar el estado actual del onboarding
• que la organización Zoho se resolvió correctamente
• que el administrador actual puede reanudar el flujo

Resultado esperado:

• el backend devuelve currentStep y nextStep
• el widget muestra el contexto del tenant y del acceso provisionado
• el flujo queda listo para confirmar el plan

Paso 2. Seleccionar o confirmar el plan

Desde el widget:

1. revise los planes disponibles
2. seleccione el plan objetivo
3. confirme la acción

Resultado esperado:

• el middleware persiste o actualiza la suscripción
• si corresponde, queda habilitada la prueba inicial de 15 días sobre la edición Professional
• el tenant queda alineado con el estado del onboarding
• el siguiente paso es continuar la configuración técnica desde el panel

Paso 3. Verificar acceso al panel

Una vez provisionado el acceso:

1. confirme que llegó el correo de notificación con enlace y OTP de acceso inicial
2. abra el enlace recibido y cree o termine de habilitar el usuario en TDIGITAL Sync for Zoho CRM & SAP B1
3. ingrese al panel unificado
4. confirme que el usuario visualiza el tenant correcto
5. si tiene más de una membresía activa, pruebe el selector de tenant
6. valide que puede establecer un tenant por defecto

Paso 4. Validar la organización Zoho

Desde el panel tenant-local:

1. abra la sección Conexiones
2. filtre o identifique el bloque Zoho CRM y confirme que la org instalada aparece vinculada al tenant correcto
3. use el botón que lleva a Zoho API Console
4. genere manualmente las credenciales del entorno deseado
5. recomendación:

• usar primero un entorno Sandbox de Zoho CRM antes de pasar a productivo

1. ingrese la llave o credenciales emitidas en el panel
2. revise estado, identificadores y metadata disponible
3. ejecute una validación de conectividad o autorización

Resultado esperado:

• la org de Zoho queda visible y operativa para el tenant activo
• no hay inconsistencias entre la org instalada y el contexto que ve el panel
• las credenciales creadas en API Console quedan asociadas al entorno correcto y validadas desde el panel

Paso 5. Crear y probar la conexión SAP Business One

Antes de activar cualquier sincronización, prepare:

• URL de SAP Business One Service Layer
• compañía objetivo de SAP Business One
• credenciales técnicas autorizadas
• política de red que permita conectar el middleware con Service Layer
• preferentemente un ambiente de test o QA de SAP para la primera validación

Luego:

1. abra la sección Conexiones
2. cree la conexión SAP Business One
3. ejecute la prueba de conexión
4. valide latencia, autenticación y disponibilidad mínima

Resultado esperado:

• la conexión queda registrada
• la prueba devuelve estado operativo válido
• la compañía objetivo queda lista para enlazarse con la org Zoho

Paso 6. Crear el enlace y definir el alcance funcional

Desde el panel tenant-local:

1. cree el enlace entre la org de Zoho CRM y la compañía de SAP Business One
2. defina qué módulos entran en alcance
3. confirme la dirección esperada por módulo
4. revise qué prerrequisitos operativos deben cumplirse antes de activar cada flujo

Resultado esperado:

• existe un enlace activo entre org y compañía
• el tenant tiene una definición explícita de alcance antes de mapear o sincronizar

Paso 7. Revisar los mappings antes de activarlos

Antes de activar un mapping:

1. abra la sección Enlaces y mappings
2. valide descriptores, campos requeridos y claves técnicas
3. confirme que no haya provisioning pendiente que impida activación
4. active solo los mappings consistentes con el alcance acordado

Resultado esperado:

• los mappings activos no dependen de campos faltantes
• no se habilitan flujos que todavía no estén cerrados técnica o funcionalmente

Paso 8. Ejecutar una prueba controlada

La primera prueba operativa debe ser acotada:

1. elegir un tenant de prueba
2. elegir un conjunto mínimo de módulos
3. validar autenticación y conectividad
4. ejecutar una sincronización controlada
5. revisar sync_jobs, eventos y correlación técnica
6. confirmar que el flujo responde correctamente antes de avanzar a productivo

Después de la prueba controlada

Si la validación es correcta, el siguiente paso es preparar la salida a productivo con el alcance funcional acordado y los mappings ya revisados.

Si el escenario requiere acompañamiento adicional, TDigital puede ofrecer:

• asistencia remota opcional
• packs de horas para configuración de campos personalizados
• packs de horas para configuración de módulos personalizados

Siguiente documento:

• user-guide.md