# Guía de Integración

# Resumen

Bienvenido a Chazki-Tiendanube docs.

Esta aplicación te permite conectar Chazki como medio de envío en tu tienda de Tiendanube y así poder seguir desde un solo lugar las operaciones logísticas de tu tienda.

Durante el siguiente recorrido obtendrás información sobre cada uno de los componentes más relevantes de la plataforma con el fin de brindar un soporte a mano sobre las diferentes etapas y procesos que esta integración posee.

# Requisitos

Para poder operar con Chazki los siguientes datos son requeridos:

  • Poseer unas API Key de Chazki (requerido)
  • Poseer una API Secret de Chazki (opcional)
  • Nombre del medio de envío como deseas que se visualice en la tienda. Si deseas mantener los nombres originales, puedes dejar los campos en blanco. En el calculador de envíos se visualizará el nombre que configuraron en el onboarding (opcional)
  • Dirección de retiro de los pedidos (requerido)
  • Piso / Departamento (requerido)
  • Teléfono de contacto (requerido)
  • Correo electrónico de contacto (requerido)
  • Persona de contacto (requerido)

Crear cuenta

NOTA

Si luego requieres modificar la leyenda del medio de envío y cómo deseas visualizarlo en la tienda, lo podrás hacer ingresando a la configuración del plugin instalado.

Una vez creada la cuenta serás redirigido a Conexiones, donde podrás completar las credenciales de las API tanto de Tiendanube, como de Chazki y una vez validadas poder operar.

# Credenciales

Al momento de ingresar a la sección de conexiones, se mostrarán dos formularios Chazki y Tiendanube.

El formulario de Chazki solicita los siguientes datos:

  • API Key (requerido) - Se obtiene via panel de Chazki ingresando en Integraciones y copiando el API Key para la versión 2.
  • Webhook Secret (opcional) - Se obtiene vía panel de Chazki ingresando en Integraciones
  • Modo de envío por defecto (opcional - REGULAR definido por defecto)

El formulario de Tiendanube requiere tres datos obligatorios

  • Tiendanube App Key y Tiendanube App Token (requeridas) - Las credenciales de Tiendanube se obtienen desde la tienda en producción, puedes seguir este Tutorial para saber cómo obtenerlas.
  • URL de la tienda (requerida) - Es la dirección de tu tienda en producción. Suele tener la siguiente forma https://mitienda.myTiendanube.com.
  • Nombre de la tienda (opcional) - Este valor sirve para darle un nombre a tu tienda legible desde los sistemas de Tiendanube (no confundir con el nombre de la tienda en la URL).

También observarás un mensaje en Transportista, en el cual se informa si Tiendanube recibió de forma exitosa la integración de Chazki como medio de envío.

# Configurar Webhook en Chazki

Un paso muy importante para que la aplicación pueda recibir los cambios de estados en las órdenes, envíados por Chazki es configurar la URL de entrada de estos mensajes. A continuación se indican los pasos a seguir.

  1. Ingrese al panel de Chazki vía Panel Producción con sus credenciales de acceso.

  2. Dirígase a Integraciones y luego a la sección Webhook > Estados.

  3. Copie esta dirección y péguela en el campo de texto Notificaciones-TdaNube:

    https://tiendanube.chazki.com/api/v1/webhook/order/status

  4. Presione el botón Guardar.

Con esto la aplicación ya está lista para recibir notificaciones desde Chazki.

# Configurar Chazki en Tiendanube

El registro de Chazki como transportista se realiza de forma automática una vez que se instala la aplicación tal como se muestra en las sección Aplicación.

NOTA

Por el momento la aplicación no dispone de la función de cotización dinámica, sin embargo, estos costos pueden ser asignados mediante el panel de administración de Tiendanube aplicados como costos adicionales de envío.

# Aplicación

La aplicación de Chazki para Tiendanube permite crear órdenes de envío de forma automática al momento de realizar una compra y elegir Chazki como transportista, también podés realizar el seguimiento de los paquetes y descargar las etiquetas relacionadas a los mismos.

# Instalación

Para instalar la aplicación de Chazki en Tiendanube podés hacerlo accediendo directamente desde la tienda de aplicaciones, para lo cuál debes navegar hasta Mis Aplicaciones y una vez ahí seleccionar Ver todas las aplicaciones en Tienda de Aplicaciones.

Una vez que seleccionás la aplicación de Chazki serás dirigido a una pantalla de confirmación donde se muestra un breve onboarding y los permisos que requiere la misma. En este punto el proceso se completa haciendo click en en el botón Siguiente con el cual luego se llega al siguiente formulario donde se piden los datos básicos para poder operar cn Chazki como medio de envío.

IMPORTANTE

Al momento de ser redirigido al formulario es recomendable poseer los datos a mano, debido a que el código de validación que envía Tiendanube expira luego de 30 segundos.

Instalación Instalación Instalación

# Configuración

Luego de instalar Chazki como medio de envío es necesario realizar algunos ajustes en la sección de costos adicionales. Este paso es muy importante debido a que por defecto Chazki agrega los envíos como gratuitos. Para configurar el costo adicional por cada tipo de envío debes ubicar en la parte inferior del menú principal la opción Configuraciones, luego seleccionar dentro de los medios de envíos a Chazki, hacer click en Editar y una vez ahí agregar el costo adicional por cada tipo. Luego de haber agregado los valores correspondientes no olvides hacer click en Guardar cambios.

Configuración

# Desinstalación

Para desinstalar la aplicación debes navegar hasta la sección Potenciar del menú principal del panel de administración de tu tienda y luego hacer click en Mis Aplicaciones, una vez ahí debes ubicar la aplicación de Chazki y hacer click en Desinstalar.

# Tracking de órdenes

El rastreo de envíos puede realizarse desde la vista de detalle de cada orden en el menú Mis aplicaciones, seleccionando la opción Chazki: Rastrear envío. Tracking

Esto te llevará a la siguiente pantalla Tracking

# Descarga de Etiquetas

La descarga de etiqueta se realiza de la misma manera que el rastreo de envíos, accediendo a la opción Chazki: Descargar etiqueta desde el menú Mis aplicaciones en el detalle de la orden. Descarga de Etiquetas

# Tipos de envíos disponibles

Chazki cuenta con los siguientes tipos de envíos disponibles:

  • Chazki Same Day (Se entrega el mismo día en la franja horaria de 9:00 a 18:00hs)
  • Chazki Next Day (Se entrega al día siguiente)

# Estados

Las órdenes registradas en el panel son obtenidas vía Tiendanube API y se toma como punto de partida el momento cuando una orden es actualizada a Lista para embalaje en tu tienda Tiendanube.

NOTA

Aunque existe un flujo más complejo, con una variedad de estados, el panel fue desarrollado con la intención de proveer facilidad de uso a los MARCHANTS por este motivo aunque podrías ver muchos más estados durante el ciclo de vida de un envío esta documentación cubrirá los estados claves.

# En Cola

Las órdenes en En cola son aquellas en las que Chazki se encuentra lista para recoger el paquete a envíar.

# Canceladas

Las Canceladas son aquellas que por motivos ajenos a Tiendanube fueron anuladas por el medio de envío.

# Con errores

Las órdenes Con errores habitualmente corresponden a aquellas en las que alguna las direcciones fueron registradas de forma errónea y requieren la corrección de estos datos desde el panel de administración de Chazki. Si en la sección de órdenes aparece alguna con este estado, puedes posar el mouse sobre el texto donde aparece el mensaje y al hacer click te abrirá una nueva ventana en el panel de Chazki donde podrás posteriormente presionar el botón Arreglar y corregir los datos necesarios.

# Preguntas Frecuentes

A continuación dejamos algunas respuestas a preguntas frecuentes.

# ¿Puedo operar sin configurar los costos adicionales en Tiendanube?

Si, pero el no configurar los costos adicionales de envío mostrará los distintos envíos disponibles para Chazki como gratuitos, por ende es necesario configurarlos.

# ¿Puedo acceder desde el móvil?

Si, la experiencia de usuario es tan buena como en la versión de escritorio por lo cual no tendrás problemas en usar la app desde tu teléfono o tablet.

# ¿Puedo registrar más de un usuario?

No. Actualmente la aplicación fue pensada para funcionar con un único usuario MERCHANT por tienda Tiendanube.