Para la integración necesitamos estos datos:
Url del sitio (eCommerce)
Token (Access Token)
Access Token Secret
Consumer Key
Consumer Secret
Para crear la integración tenemos que ir al menú lateral: System > Extension > Integration.
Luego hacer click en Add Integration:
En el menú lateral hacer click en Integrations: solo hay que completar en nombre ej Data4sales y solicita el password del usuario actual para verificar la creación.
Nota: Este paso debe ser realizado por un usuario con rol de Administrador en Magento.
En la pestaña API de la integración, dejar el desplegable "Resource Access" en "Custom" y tildar los siguientes recursos. Cada uno de estos permisos habilita la información que Data4Sales necesita leer de tu eCommerce:
Sección a tildar | Para qué la usa Data4Sales |
Ventas → Operaciones → Pedidos (todo el árbol) | Lectura de órdenes. |
Ventas → Operaciones → Pedidos → Acciones → Crear | Generación de carritos para recuperación. |
Catálogo → Inventario → Productos | Lectura del catálogo. |
Catálogo → Inventario → Categorías | Lectura de la jerarquía de categorías. |
Clientes → Todos los clientes | Lectura de la base de clientes. |
Carritos → Administrar carritos | Lectura de carritos abandonados. |
Marketing → Promociones → Reglas | Lectura de promociones y cupones. |
Tiendas → Configuración | Lectura de la configuración general y store views. |
Tiendas → Inventario → Stocks | Lectura de stock disponible. |
Tiendas → Atributos | Lectura de atributos personalizados de productos. |
Al finalizar de seleccionar todos los recursos, volver arriba y hacer click en SAVE.
Vamos a poder ver los 4 códigos que necesitamos (Token, Access Token Secret, Consumer Key y Consumer Secret).
Importante: Magento muestra estos 4 códigos (Token, Access Token Secret, Consumer Key y Consumer Secret) una única vez. Si no se copian en este momento, no hay forma de volver a verlos y se deberá generar la integración de nuevo. Recomendamos guardarlos de inmediato en un archivo de texto plano.
Activar la Integración
Después de guardar y visualizar el token, la integración aparecerá como "Inactive" en la grilla principal (System → Extensions → Integrations).
Haz clic en Activate en la columna de acciones.
Acepta el popup de permisos que se abre.
Recién después de este paso el Access Token queda operativo.
Cómo enviarnos el Access Token
Para evitar errores de conexión por caracteres invisibles o espacios extras, por favor envíen los 4 códigos (Token, Access Token Secret, Consumer Key y Consumer Secret) de la siguiente manera:
Preferentemente en un archivo de texto plano (.txt).
O copiados entre triple comillas en su mensaje.
Nota sobre cambios de contraseña: Si el usuario administrador que creó la integración cambia su contraseña de Magento, la integración puede quedar inactiva automáticamente. En ese caso, deberás entrar a la configuración de la integración, hacer clic en Reissue Access Token y enviarnos el nuevo token generado.
Qué hacer si la conexión falla
Si el token es rechazado: Verifica en la grilla de integraciones que el estado figure como Active. Si cambiaste la contraseña de admin recientemente, recuerda que debes hacer un Reissue del token.
Si falta un permiso: No necesitas borrar la integración. Ve a la pestaña API, tilda el recurso que falte y guarda los cambios. No hace falta volver a activar la integración tras editar permisos.
Si tienes cualquier consulta puedes contactarte con nuestro chat de soporte dentro de Data4sales o nuestro email: customer.success@data4sales.com