Antes de configurar su GSX Integración, revise la lista de verificación para confirmar que tiene toda la información requerida disponible antes de comenzar. 

Si esta no es la primera vez que completa este proceso, asegúrese de guardar sus archivos actuales yendo a Configuración del Sistema > Integraciones > GSX > Herramienta de Certificados y haciendo clic en el ícono de archivos en la esquina superior derecha. También copie la Frase de Contraseña.

Una vez que haya descargado los archivos, complete el restablecimiento del certificado. Las instrucciones para esto se pueden encontrar al final de este artículo. 

Una vez que haya comenzado el proceso y enviado su solicitud a Apple NO restablezca la herramienta de certificados. 

Accediendo a la Herramienta de Certificados GSX

1. Usando una cuenta de Administrador, navegue a la Fixably.
   
    
2. Seleccione su Menú de Nombre de Usuario y luego haga clic en Configuración del Sistema.
   
   
   
    
3. Desde el Menú de Configuración, seleccione Integraciones y luego haga clic en GSX.
   
   
   
    
4. Desplácese hacia abajo y haga clic en el botón Herramienta de Certificados.
   
   

Generar Archivos CSR

1. Una vez que se haya abierto la herramienta de certificados, complete todos los campos como se muestra a continuación. Luego haga clic en Crear Solicitud de Certificado cuando haya terminado.
   
   
   
    
2. Después de que la información ingresada sea validada, se genera un archivo de solicitud de certificado: certreq_rest.csr. Haga clic en el enlace para descargar la solicitud de certificado de la API REST.
   
   
    
3. Haga clic en la plantilla de correo electrónico. Siga las instrucciones en la plantilla para completar la solicitud de correo electrónico. Asegúrese de copiar a su gerente de cuenta de Apple, al administrador de GSX (si no es el GSX Admin nombrado), y a su Gerente de Éxito del Cliente de Fixably. Asegúrese de que el archivo .csr que descargue esté adjunto al correo electrónico. 
   
   Nota: La plantilla de correo electrónico se abrirá en su cliente de correo electrónico predeterminado. Asegúrese de enviar el correo electrónico desde la misma dirección de correo electrónico registrada con GSX.

***** INICIO DE INSTRUCCIONES

*

*     1. Adjunte los archivos de solicitud de certificado `certreq_rest.csr` y `certreq_soap.csr` de la herramienta de certificados a este correo electrónico.

*     2. Agregue su gsxws@apple.com en el campo Para.

*     3. Agregue a su gerente de país de Apple en el campo Cc.

*     4. Agregue a su administrador de cuenta de GSX en el campo Cc (si no lo es).

*     5. Elimine estas instrucciones de la plantilla.

*     6. Envíe el correo electrónico.

*

***** FIN DE INSTRUCCIONES

 

Entorno: Producción (REST, SOAP)

GSX Número de cuenta vendido a: 0000123456

Nombre del contacto de TI principal: [NOMBRE DE CONTACTO]

Correo electrónico del contacto de TI principal: [DIRECCIÓN DE CORREO AQUÍ]

Número de teléfono del contacto de TI principal: [NÚMERO DE TELÉFONO AQUÍ]

Nombre(s) del contacto comercial principal para comunicaciones relacionadas con la API: [NOMBRE DE CONTACTO]

Dirección(es) de correo electrónico del contacto comercial principal para comunicaciones relacionadas con la API: [DIRECCIÓN DE CORREO AQUÍ]

 

Dirección(es) IP del servidor saliente estático que envía solicitudes al entorno de producción de GSX Web Services: 209.50.52.238

Dirección(es) IP del servidor saliente estático que envía solicitudes al entorno de prueba de GSX Web Services: 209.50.52.238

Dirección(es) IP del servidor saliente estático que envía solicitudes a Appointment Scheduler Producción: 209.50.52.238

Dirección(es) IP del servidor saliente estático que envía solicitudes al entorno de prueba de Appointment Scheduler: 209.50.52.238

Descripción general del diseño del sistema: [Aplicable y requerido para desarrollo interno/personalizado]

Lista de API a integrar: [Aplicable y requerido para desarrollo interno/personalizado]

Solución de Integración de Terceros: Nombre de la empresa y del producto: Fixably

Completar la Solicitud de Certificado

Una vez que haya recibido el(los) certificado(s) completado(s) de Apple, los archivos deben ser subidos a la herramienta de certificados para generar archivos de certificado que se pueden utilizar con Fixably.
 

1. Navegue de regreso a la herramienta de certificados yendo a Configuración del Sistema > Integraciones > GSX > Herramienta de Certificados. Seleccione el archivo .pem haciendo clic en el ícono de documento a la derecha del campo y haga clic en Subir cuando haya terminado.
   
    
2. Nota: No renombre ni edite el nombre del archivo. Apple lo proporciona en el formato esperado. 
    

Instalando los Certificados

1. Una vez que se haya subido el archivo de certificado, descargue los archivos de certificado .p12 del Paso 4 y copie la frase de contraseña del certificado.
   
   
   
    
2. Navegue de regreso a Configuración del Sistema.
3. Desde el Menú de Configuración, seleccione Integraciones y luego GSX.
4. Complete la información de Vendido a y Enviado a. Asegúrese de que se seleccione el entorno GSX correcto, típicamente Producción. Suba el certificado REST generado en el Paso 3 e ingrese la frase de contraseña proporcionada en el botón “Cambiar Contraseña”.
   
   
    
5. Si está en una localidad que utiliza estados o provincias, seleccione la casilla junto a Estado utilizado si no está marcada.
   
    
6. Seleccione los Tipos de Reparación utilizados por su negocio. Cualquier tipo de reparación que no esté marcado no será visible al crear una reparación. 
   
   
7. Cuando haya terminado, haga clic en Guardar Configuración.
    

Configurar la Configuración de Usuario de GSX

1. Desde la Fixably, navegue a Configuración de Usuario.
   
   
   
    
2. Haga clic en Expandir junto al encabezado GSX para ver la configuración de GSX basada en el usuario. 
   
   
   
    
3. Ingrese su Apple ID y ID de Tecnología como se muestra arriba. Genere un Token de Activación haciendo clic en el enlace Solicitar nuevo token de activación haciendo clic aquí.
   
    
4. Haga clic en Guardar Configuración cuando haya terminado.
   
   Nota: Los Tokens de Activación caducarán y deberán regenerarse periódicamente.

Configurar Acceso Compartido a GSX

Si un usuario no tiene acceso personal a GSX, Fixably permite la búsqueda de dispositivos e información compartiendo GSX. Active esta función si utiliza el Portal del Cliente o tiene personal interno que puede no tener una cuenta personal de GSX. 

1. Navegue a Configuración del Sistema/Integraciones/GSX.
   
    
2. Haga clic en el triángulo de divulgación junto a la cuenta del usuario que desea compartir. Luego haga clic en Compartir esta cuenta.
   
   
3. Si su negocio tiene múltiples Ubicaciones, asegúrese de que la Cuenta Compartida tenga acceso a todas las ubicaciones en Apple MyAccess. 

Probar la Integración de GSX

Una vez que se configuren todos los ajustes, el último paso es confirmar que Fixably se comunique correctamente con GSX. 

1. Navegue a Configuración del Sistema/Integraciones/GSX.
   
    
2. A continuación, haga clic en Probar Conexión para iniciar el Tester de Integración.
   
   
   
    
3. Revise el estado junto a cada paso de conexión. 
    

Configurar la configuración de GSX basada en la ubicación

1. Navegue a Configuración del Sistema/Ubicaciones.
   
    
2. Haga clic en el nombre de la Ubicación.
   
    
3. Ingrese el GSX Vendido a y Enviado a números en los campos proporcionados. 
   
   
    
4. Cuando haya terminado, haga clic en Guardar.
    

Solucionar Errores Comunes

• Error:1. Sold-to está configurado, número de sold-to inválido o faltante.
  • Confirme que el número de Sold-to correcto ha sido ingresado en el Paso 4. Reintente la prueba después de validar el número de Sold-to.
• Error: 2. El entorno está seleccionado. Configuración de entorno inválida o faltante.
  • Confirme que la configuración de entorno correcta esté configurada en el Paso 4. Típicamente esto debe estar configurado en Producción a menos que se indique lo contrario por Fixably Soporte.
• Error: 3. El certificado está cargado. Falta el certificado.
  • El archivo del certificado del Paso 3 es inválido o falta. Confirme que el certificado correcto ha sido cargado y que la frase de paso es correcta.
• Error: 4. Probando conexión al servidor GSX en Probar Conexión.
  • Esto ocurre típicamente porque Apple no ha incluido en la lista blanca las direcciones IP de Fixably. Contacte al equipo de Servicios Web de GSX para verificar la solicitud de inclusión en la lista blanca presentada en el Paso 2. 
• Error: 5. Prueba de autenticación usando una cuenta compartida de GSX.
  • No hay un usuario configurado para la cuenta compartida de GSX. Navegue a Configuración del Sistema/Integraciones/Cuentas de GSX para habilitar al menos una cuenta compartida.
• Error: El token de activación es inválido. Se debe solicitar uno nuevo.
  • Esto puede ocurrir porque el ID de Apple del usuario no tiene permisos de servicios web asignados. Verifique a través de MyAccess que los permisos correctos han sido asignados y luego solicite un nuevo token de activación.
     

Restableciendo la Herramienta de Certificados

1. Si se requiere un nuevo certificado o si se le indica hacerlo por el soporte de Fixably, los administradores pueden restablecer la herramienta de certificados haciendo clic en Restablecer esta herramienta.
   
   
    
2. Esta acción elimina de forma irreversible todos los datos almacenados de la herramienta de certificados.
   
    
3. Asegúrese de descargar y guardar cualquier archivo de certificado y frases de paso en un lugar seguro antes de restablecer la herramienta.