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

Fecha de actualización: 2026-04-20

Objetivo: guiar al administrador de Zoho CRM en la instalación inicial de la extensión desde Marketplace o desde un enlace privado de instalación.

Antes de instalar

Verifique lo siguiente:

• dispone de una org de Zoho CRM compatible con la edición objetivo del release
• para la primera submission pública, la edición objetivo recomendada es:
• Professional, Enterprise o Ultimate
• el usuario que instalará la extensión tiene permisos administrativos sobre la org
• cuenta con una instancia de SAP Business One y acceso a Service Layer para la etapa de setup
• conoce la URL pública del entorno de TDIGITAL Sync for Zoho & SAPB1 que se usará para onboarding y operación
• revisó los documentos legales y de ayuda asociados a la extensión

Qué instala la extensión

La instalación incorpora componentes de Zoho CRM que habilitan:

• post-install
• Functions Deluge para onboarding
• Settings Widget para reanudar el flujo desde Zoho CRM

La lógica sensible y persistente no queda en el frontend; se ejecuta en el middleware de TDIGITAL Sync for Zoho & SAPB1.

Instalación desde Zoho Marketplace

1. Abra la ficha pública de TDIGITAL Sync for Zoho & SAPB1.
2. Haga clic en Install.
3. Revise los permisos y componentes que la extensión agregará a su org.
4. Confirme la instalación.
5. Espere a que finalice la acción de post-install.

Instalación desde enlace privado

Si la instalación se realiza por enlace privado:

1. abra el enlace provisto por TDigital
2. seleccione la org destino
3. confirme la instalación
4. espere la finalización del flujo post-install

Nota:

• la instalación privada y su compatibilidad exacta con ediciones de Zoho CRM deben validarse contra el release final y la guía vigente de Zoho al momento del envío
• para la primera submission pública se recomienda una estrategia single DC

Qué ocurre inmediatamente después

Durante post-install, la extensión intenta:

• resolver el zohoOrgId
• disparar POST /api/v1/onboarding/start
• crear o reanudar el tenant
• registrar la sesión de onboarding
• provisionar o reconciliar el acceso inicial del administrador cuando Zoho expone el email

En términos operativos y comerciales, este onboarding:

• guía al administrador en la activación inicial desde Zoho Marketplace
• permite seleccionar una edición Free con mismo alcance base que Estándar y límite diario previsto de 100 registros, sujeto a validación final
• habilita la prueba inicial de 15 días sobre la edición Profesional
• deja preparado el acceso para continuar con la configuración necesaria para la puesta en marcha

Referencias técnicas:

• zoho-extension.md
• SIGMA_SETUP.md

Primera validación recomendada

Después de instalar:

1. abra el Settings Widget de la extensión
2. confirme que el widget carga correctamente
3. verifique que el flujo de onboarding reanuda el estado esperado
4. valide que el plan disponible puede seleccionarse sin error

Señales de error frecuentes

• el widget no carga
• revisar que la extensión haya publicado correctamente el widget y sus permisos
• el onboarding aparece como not_started
• revisar si post-install falló o si la org variable no quedó persistida
• el usuario no obtiene acceso al panel
• validar si Zoho entregó email del administrador y si el middleware pudo reconciliar la identidad

Qué sigue después de instalar

La instalación no equivale a un setup funcional completo. Después de instalar debe continuarse con:

• selección o confirmación del plan
• preparación de conectividad con SAP Business One
• definición o validación de mapeos
• prueba controlada del flujo operativo

Para esta etapa posterior, el cliente puede:

• seguir la guía de configuración para administradores
• solicitar asistencia remota opcional
• contratar packs de horas si necesita apoyo en configuraciones con campos personalizados o módulos personalizados

Siguiente documento:

• setup-guide.md