Shopify Plugin Setup Guide

[Daniel]

See below for English, Spanish & French versions of this guide

English

Prerequisites

Please make sure you have a Stuart account before using the plugin. You can create one from here.

Shopify plan:

• If you have an Advanced Shopify or Shopify Plus plan no further action is required.

• If you have an annual billing plan in order to use the Stuart Delivery plugin you need to contact Shopify support and ask them to activate the feature called CCS for free.

If you are on the Shopify plan or lower you can either:

• Switch from monthly to yearly billing and contact Shopify Support as explained above.
• Contact Shopify support and add this feature for a monthly fee (which will cost 20 additional dollars per month).

Installation

Find Stuart Delivery within the Shopify app store and click “Add app”.

Configuration

• Within your Shopify admin dashboard go to Apps and then open the Stuart Delivery app.
  Here you will need to add your Stuart API credentials and activate your pickup locations.

• To input your authentication, you will need to use your “API Client ID” and “API Secret” found in the Stuart Dashboard Admin page of your Sandbox or Production account, more information on our API authentication can be found here OAuth Authentication.

  Please note, if you’re using the plugin for testing purposes, please use your Stuart sandbox API account details with the “Use the sandbox environment (pre-production)” checkbox ticked.
  If not, please use your Production API credentials with the checkbox unticked.

• Below under the “Locations” section, you will see the list of your pickup locations. These are the locations that you defined in your general Shopify settings.
  If you want to update or activate a specific location you must do it directly in your Shopify settings. Alternatively, you can activate all existing locations by clicking on the “Activation” button.

• Now we need to make Stuart delivery a shipping option for your customers. To begin go to the Shopify Settings page, then to the Shipping & delivery option and select manage shipping rates.

• We will now add a new carrier shipping rate to your existing shipping zones,
  Please note, if required please create a new shipping zone matching your Shopify Market.

• Next, within your shipping zone select “add rate” and then “Use carrier or app to calculate rates”, from the drop-down menu please use Stuart Delivery. The Stuart delivery service check-box button must be selected for the Stuart delivery shipping option to appear. Once that has been done, you can then save the changes made.

• Lastly, you must ensure that in your plugin configuration, you activated the Stuart delivery option.
  You can find this information on top of the plugin configuration page. By clicking on the activate/deactivate button you can choose whether or not you want to make the Stuart Delivery option available to end customers.
  For example, when testing the plugin, you should deactivate the option.

Confirmation

You have now successfully installed and configured our official Stuart delivery Shopify plugin. Once on the checkout page, if you have entered a drop-off location within range for a Stuart delivery, you should see the Stuart delivery shipping option available for an instant delivery job.

Additional features

• Order tags

You can define tags that will be associated with all orders delivered by Stuart. This is useful to differentiate and filter your orders.

• Carrier service name

By default, your customers will see “Stuart Delivery” as the shipping service. You can modify this name as well as the description in the “white label” section of the plugin configuration page.

Please leave a comment or raise a query in the Q&A section with any issues you are facing with Stuart’s Shopify plugin.

Español

Requisitos previos

Plan de Shopify:

Por favor, asegúrese de tener una cuenta de Stuart antes de usar el plugin. Puede crear una desde aquí.

• Si tiene un plan Advanced Shopify o Shopify Plus, no se requiere ninguna otra acción.

• Si tiene un plan de facturación anual para usar el plugin Stuart Delivery, debe comunicarse con soporte de Shopify y pedirles que activen la función llamada CCS gratis.

Si tiene el plan Shopify o uno inferior, puede:

• Cambiar de facturación mensual a anual y contactar al Soporte de Shopify como se explicó anteriormente.
• Ponerse en contacto con el soporte de Shopify y agregar esta función por una tarifa mensual (que costará 20 dólares adicionales por mes).

Instalación

Busque Stuart Delivery dentro de la tienda de aplicaciones de Shopify y haga clic en “Añadir aplicación”.

Configuración

• Dentro de su panel de administración de Shopify vaya a Apps y luego abra la aplicación Stuart Delivery.
  Aquí tendrá que añadir sus credenciales de la API de Stuart y activar sus ubicaciones de recogida (locations).

• Para introducir su autenticación, tendrá que utilizar su “API Client ID” y “API Secret” que se encuentra en la página de administración del panel de Stuart de su cuenta de Sandbox o de Producción , más información sobre nuestra autenticación de la API se puede encontrar aquí.

*Por favor, tenga en cuenta que si está usando el plugin para propósitos de prueba, por favor use los detalles de su cuenta de API de Stuart con la casilla “Use the sandbox environment (pre-production)” marcada. En caso contrario, utilice sus credenciales de la API de producción sin marcar la casilla.

• Abajo en la sección “Locations” verás la lista de todos los puntos de recogida. Estas son las ubicaciones que definió en su configuración general de Shopify.
  Si desea modificar o activar una ubicación específica tiene que ir directamente a su configuración de Shopify.
  También puede activar todas las ubicaciones existentes haciendo clic en el botón “Activation”.

• Para hacer que la entrega de Stuart sea una opción de envío: vaya a la página de configuración de Shopify Setting , luego a la opción Shipping & delivery y seleccione "manage shipping rates”.

• Tiene que añadir una tarifa de envío del transportista a sus zonas de envío existentes.
  Por favor, tenga en cuenta que si es necesario, cree una nueva zona de envío que coincida con su mercado de Shopify.

• Por último, dentro de su zona de envío seleccione “add rate” y luego “Use carrier or app to calculate rates”, en el menú desplegable por favor utilice Stuart Delivery. Para que aparezca la opción de envío de Stuart Delivery debe estar seleccionada la casilla del servicio de entrega de Stuart. Una vez hecho esto, puede guardar los cambios realizados.

• Por último, debe asegurarse que en la configuración del plugin esté activada la opción “Stuart delivery”. Puede encontrar esta información en la parte superior de la página de configuración del plugin. Haciendo clic en el botón activar/desactivar puede elegir si desea que la opción “Stuart Delivery” esté disponible o no para los clientes finales.
  Por ejemplo, cuando esté probando el plugin, debería desactivar la opción.

Confirmación

Ahora ha instalado y configurado con éxito nuestro plugin oficial de Stuart delivery para Shopify. Una vez en la página de pago, si ha introducido una ubicación de entrega dentro del rango para una entrega de Stuart, debería ver la opción de envío de entrega de Stuart disponible para un pedido de entrega instantánea.

Funcionalidades adicionales

• Etiquetas de pedido

Puede definir etiquetas que serán asociadas a todos los pedidos entregados por Stuart. Esto es útil para diferenciar y filtrar los pedidos.

• Nombre del servicio de entrega

Por defecto, sus clientes verán “Stuart Delivery” como nombre del servicio de entrega. Puede cambiar el nombre y la descripción del servicio en la sección “White label” de la página de configuración del plugin.

Por favor, deje un comentario o plantee una consulta en la sección de preguntas y respuestas con cualquier problema que esté enfrentando con el plugin de Stuart para Shopify.

Français

Conditions préalables

Assurez-vous d’avoir un compte Stuart avant d’utiliser notre plugin. Vous pouvez en créer un içi.

Plan Shopify:

• Si vous avez un plan Advanced Shopify ou Shopify Plus, aucune autre action n’est requise

• Si vous avez un plan de facturation annuel pour utiliser le plugin Stuart Delivery, vous devez contacter l’assistance Shopify et leur demander d’activer la fonctionnalité appelée CCS gratuitement.

Si vous avez souscrit au forfait Shopify ou à un forfait inférieur, vous pouvez soit :

• Passez d’une facturation mensuelle à une facturation annuelle et contactez l’assistance Shopify comme expliqué ci-dessus
• Contactez le support Shopify et ajoutez cette fonctionnalité moyennant des frais mensuels (qui coûteront 20 dollars supplémentaires par mois)

Installation

Cherchez Stuart Delivery dans l’app store Shopify et cliquez sur “Ajouter l’application”.

Configuration

• Dans votre page d’accueil, cliquez sur la section Applications et ouvrez l’application Stuart Delivery. Vous devez alors renseigner vos clés d’API Stuart et activer vos différents points de collecte (locations).

• Pour l’authentification, veuillez utiliser votre “API Client ID” et “API secret” qui se trouvent dans la section “settings” du dashboard Stuart de votre compte Sandbox ou Production. Pour plus d’informations concernant notre authentification API veuillez vous rendre sur la page OAuth Authentication.

Si vous utilisez le plugin dans le cadre de tests, veuillez utiliser les informations API de votre compte Stuart sandbox et cochez la case “Use the sandbox environment (pre-production).”
Dans le cas contraire, utilisez vos informations API de production en décochant la case.

• Plus bas, dans la section “Locations”, vous verez la liste de tous vos points de collecte. Il s’agit de ceux que vous avez défini dans vos paramètres généraux Shopify.
  Si vous souhaitez mettre à jour ou activer un point de collecte spécifique vous devez le faire directement dans vos paramètres Shopify.
  Vous pouvez par ailleurs activer toutes les points de collecte existants en cliquant sur le bouton “Activation”.

• Ensuite, vous devez faire de la livraison Stuart une option d’expédition pour vos clients. Pour commencer, rendez-vous sur la page Paramètres, puis sur l’option Expédition & livraison et sélectionnez Gérer dans la section Tarifs d’expédition généraux.

• Nous allons maintenant ajouter un nouveau taux d’expédition de transporteur à vos zones d’expédition existantes,
  Veuillez noter que si nécessaire, vous pouvez créer une nouvelle zone d’expédition correspondant à votre marché Shopify.

• Enfin, dans votre zone d’expédition, sélectionnez Ajouter un tarif et ensuite Utiliser un transporteur ou une application pour calculer les tarifs, dans le menu déroulant, veuillez utiliser Stuart Delivery. La case Stuart Delivery de la section Services doit être cochée pour que l’option d’expédition de la livraison Stuart apparaisse. Une fois que cela est fait, vous pouvez alors enregistrer les modifications apportées.

• Pour finir, vous devez vous assurer que dans la configuration du plugin l’option de livraison Stuart est activée. Vous trouverez cette information en haut de la page de configuration du plugin. En cliquant sur le bouton “activate/desactivate” vous pourrez choisir si vous voulez rendre l’option de livraison Stuart disponible pour vos clients.
  Par exemple, lorsque vous effectuez des tests vous devez désactiver l’option.

Confirmation

Vous avez maintenant installé et configuré avec succès notre plugin officiel Stuart delivery Shopify. Une fois sur la page de paiement, si vous avez saisi un lieu de livraison à portée pour une “livraison Stuart”, vous devriez voir l’option de “livraison Stuart” disponible pour une livraison instantanée.

Informations additionnelles

• Tags
  Vous pourrez définir des tags qui seront associés à toutes les commandes livrées par Stuart. Cela est notamment utile si vous souhaitez différencier ou filtrer vos commandes.

• Nom du service de livraison

Par défaut, vos clients verront affiché “Stuart Delivery” comme nom du service de livraison. Vous pouvez changer le nom ainsi que la description du service dans la section “white label” de la page de configuration du plugin.

Veuillez laisser un commentaire ou poser une question dans la section “Questions&Réponses” pour tout problème que vous rencontrez avec le plugin Shopify de Stuart.