Contenido
- Instalación y configuración inicial
- Configuración de ICML
- Sincronización inversa
- Exportación de datos
- Almacenes y existencias
- Scripts
- Metacampos
- Bloqueo de la aplicación
Instalación y configuración inicial
Para instalar la aplicación de Shopify e integrar la tienda con el sistema, vaya a la sección Apps del panel administrativo de Shopify y haga clic en «Visit the Shopify App Store».
En la barra de búsqueda de Shopify App Store, introduzca el nombre del módulo «Simla.com», abra la página del módulo y haga clic en «Add App».
Se abrirá una página de Shopify con la lista de funciones y permisos del módulo. Para continuar, haga clic en «Install app».
Primer paso: conexión con el sistema
En el primer paso se introducen los datos del sistema conectado. En el primer campo, especifique la clave de la interfaz de programación de aplicaciones (API) creada previamente. En el segundo, indique la URL completa del sistema, por ejemplo, https://demo.retailcrm.ru. Después, haga clic en «Save and Continue».
Segundo paso: ajustes adicionales
Seleccione la tienda cuyos datos se sincronizarán con el sistema.
En el ajuste «Empresa del cliente», que es opcional, se puede seleccionar un campo personalizado del sistema al que se enviará el valor del campo «Empresa» de la dirección del cliente. Un cliente de Shopify puede tener una dirección de facturación (Billing address) y otra de envío (Shipping address); se utilizará la dirección establecida como predeterminada en sus datos. Este valor se transmite únicamente de Shopify al sistema.
La opción «Transmitir información sobre los carritos de los clientes a Simla.com» permite guardar en la ficha del cliente la información sobre un carrito abandonado inmediatamente después de que se introduzca su correo electrónico. En Shopify, un pedido se considera abandonado desde que se introduce el correo electrónico durante la formalización hasta que se paga.
¡Importante!
Para que el sistema pueda hacer el seguimiento del carrito, el cliente debe estar registrado y haber iniciado sesión en el sitio.
Configure la correspondencia entre los estados de los pedidos del sistema y los de Shopify. La configuración de los estados se describe en el artículo correspondiente.
Al activar «Mostrar la lista ampliada de estados» (Enable extended statuses), también se muestran los estados de entrega y los motivos de cancelación.
Solo se pueden seleccionar estados del grupo del sistema relacionado con la acción que se realiza sobre el pedido. Por ejemplo, para un estado de Shopify relacionado con la entrega, únicamente estarán disponibles los estados del grupo de entrega del sistema.
¡Importante!
Las correspondencias no deben contener valores duplicados, ya que provocarían que el sistema recibiera datos incorrectos sobre los estados de los pedidos.
Es posible asignar el valor vacío Not selected. En ese caso, el estado no se sincronizará. Tampoco se realizará ninguna acción sobre un pedido si su estado en el sistema no tiene una correspondencia configurada en Shopify.
A continuación, asocie los servicios de entrega del sitio con los tipos de entrega del sistema. Los valores disponibles se cargan desde el directorio descrito en el artículo sobre los tipos de entrega.
La opción «Transmitir los códigos de seguimiento al campo personalizado de Simla.com» permite enviar al sistema los números de seguimiento. Para utilizarla, seleccione el campo personalizado correspondiente. Para desactivar esta transmisión, deje el campo sin seleccionar.
Los números de seguimiento se envían al sistema después de la expedición completa del pedido (fulfilled). Si el pedido tiene varias expediciones (fulfillment) o una expedición contiene varios números de seguimiento, se guardarán en el campo personalizado todos los números de las expediciones completadas correctamente, separados por comas.
La integración también procesa la adición, modificación y eliminación de números de seguimiento. Si se cancela una expedición, sus números de seguimiento se eliminarán del sistema.
¡Importante!
La integración no procesa los cambios manuales del número de seguimiento en el campo personalizado del sistema. El valor se sustituirá por el original la próxima vez que el pedido cambie en Shopify. Por este motivo, se recomienda que el campo no sea editable.
La opción «Enviar el código de seguimiento al comprador (en caso de entrega mediante la integración)» transmite a Tracking number de Shopify el número de seguimiento de una entrega creada en el sistema. El envío se realiza cuando el estado del pedido corresponde al estado configurado en el módulo para la expedición o finalización completa. La opción está desactivada de forma predeterminada.
Al guardar este paso puede aparecer el error Selected payment type "en efectivo" no está permitido para algunos tipos de entrega: "recoger desde la tienda/almacén". Esto sucede cuando el tipo de pago del sistema no está permitido para el tipo de entrega seleccionado en la configuración del directorio de entrega.
El ajuste «Transmitir todos los métodos de pago a Simla.com» está activado de forma predeterminada. Todos los tipos de pago creados en Shopify se exportarán automáticamente a Simla.com y aparecerán en la sección «Tipos de pago».
Si se desactiva este ajuste, aparecerá el campo «Cualquier pasarela de pago de Shopify». Cuando se selecciona un valor, los pedidos exportados de Shopify a Simla.com muestran únicamente ese tipo de pago.
Haga clic en «Guardar y continuar» para pasar al tercer paso de la configuración.
Tercer paso: webhooks y catálogo
En el tercer paso se crean los webhooks para transmitir los pedidos y clientes de Shopify al sistema y se genera un archivo ICML para cargar el catálogo. La URL del archivo ICML se añade automáticamente a la configuración de la tienda en el sistema. El catálogo se carga cada 4 horas.
Configuración de ICML
En la opción «Transmitir xmlId en ICML», seleccione el parámetro cuyo valor se escribirá en el archivo ICML del catálogo para vincular los productos de Shopify con MoySklad:
SKU: se especifica en la ficha del producto de Shopify.Barcode: se especifica en la ficha del producto de Shopify.GraphQL API ID: identificador externo del producto en Shopify generado a partir del código externo del producto de MoySklad. Es un valor oculto que no se muestra en la ficha del producto.
Sincronización inversa
Para transmitir a Shopify los cambios de clientes y pedidos realizados en el sistema, active la sincronización inversa en la pestaña correspondiente.
Después de activar las opciones, los cambios se envían del sistema a Shopify una vez por minuto. Si el volumen de cambios es elevado, el intervalo puede aumentar. Se recomienda activar ambas opciones.
Sincronización inversa de clientes
Esta opción exporta a Shopify los clientes nuevos creados en el sistema y actualiza los datos de los clientes existentes cuando se modifican en el sistema.
Si la sincronización inversa de clientes está desactivada y la de pedidos está activada, en Shopify solo se crearán los clientes que tengan pedidos en el sistema.
Sincronización inversa de pedidos
Esta opción exporta a Shopify los pedidos nuevos creados en el sistema. Debido a limitaciones técnicas de Shopify, las modificaciones de la composición de un pedido no se transmiten del sistema a Shopify.
Desactivación y activadores heredados
La sincronización inversa se puede desactivar en cualquier momento. Si se vuelve a activar, solo se transmitirán a Shopify los cambios de las últimas 24 horas. De esta manera se evita cargar datos obsoletos y ejecutar una sincronización inicial prolongada después de un periodo extenso de inactividad.
¡Importante!
El soporte de los activadores (
triggers) utilizados para transmitir clientes o pedidos del sistema a Shopify finalizó el 1 de abril de 2021. Para continuar exportando esta información, es necesario actualizar la aplicación y activar la sincronización inversa de clientes y pedidos.
Si ya hay activadores configurados, al habilitar la sincronización inversa de clientes o pedidos no se exportarán datos mediante esos activadores. Si se desactiva la opción correspondiente, la exportación mediante los activadores se reanudará siempre que se hubieran configurado previamente.
Exportación de datos
La aplicación de integración admite los siguientes modos de exportación de datos de Shopify al sistema:
- todos los pedidos y clientes;
- uno o varios pedidos seleccionados por su identificador;
- pedidos de una fecha determinada.
¡Importante!
La exportación de todos los pedidos y clientes puede tardar bastante tiempo. No cierre la página de configuración mientras se estén exportando los datos.
Almacenes y existencias
En esta sección se puede configurar la transmisión de las existencias de Shopify al sistema o del sistema a Shopify.
Seleccione la dirección de sincronización y configure las correspondencias con los almacenes del sistema que participarán en el intercambio. El intervalo de actualización de las existencias es de 15 minutos.
Nota
Las existencias solo se sincronizan para los almacenes que tienen una correspondencia seleccionada en el sistema.
Scripts
Si es necesario utilizar «Live Chat» en el sitio web, inserte en este bloque el script obtenido de la configuración del módulo Live Chat y guarde los cambios.
Metacampos
En Shopify, los metacampos (Metafields) son equivalentes a los campos personalizados del sistema. Se pueden configurar correspondencias entre los campos adicionales de Shopify y del sistema para sincronizar datos de pedidos y clientes. El intercambio comienza después de guardar los cambios.
Se admiten los siguientes tipos de datos: texto de varias líneas, cadena, número entero, número decimal, verdadero o falso, fecha y URL.
Para configurar el intercambio bidireccional de datos adicionales, cree campos equivalentes en Shopify y en el sistema.
Creación de metacampos en Shopify
Vaya a Configuración → Metacampos y seleccione el tipo de recurso, «Pedidos» o «Clientes», al que se añadirá el campo.
Haga clic en «Agregar definición». Introduzca el nombre del campo, el espacio de nombres y la clave y, si es necesario, una descripción. Después, seleccione el tipo de contenido. También se pueden establecer validaciones para los valores mínimo y máximo.
¡Importante!
Solo se pueden sincronizar campos de tipo «Valor único». Los campos de tipo «Lista de valores» no están disponibles para la sincronización con el sistema.
Creación de campos personalizados en el sistema
Vaya a Configuración → Sistema → Campos personalizados y haga clic en «Añadir». Cree un campo cuyo tipo corresponda al metacampo configurado en Shopify.
Correspondencia de tipos de campo
| Tipo de metacampo en Shopify | Tipo de campo personalizado en CRM |
|---|---|
Fecha |
Fecha |
Texto de varias líneas |
Texto |
Cadena |
Cadena |
Número entero |
Número entero |
Número decimal |
Número |
Verdadero o falso |
Casilla sí/no |
URL |
Texto |
Bloqueo de la aplicación
La sincronización de datos de Shopify con el sistema puede suspenderse si se superan los límites de solicitudes de la aplicación, por ejemplo, cuando se crean muchos pedidos en un periodo breve.
En ese caso, la configuración de la aplicación mostrará un mensaje sobre la suspensión temporal. Además, el campo personalizado Shopify errors del sistema recibirá la advertencia Service is unavailable.
Compruebe el funcionamiento de la integración 10 minutos después de que aparezca el mensaje. Si la transmisión de datos no se reanuda, póngase en contacto con el soporte técnico.