# 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 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:

  • API Keys de Chazki (requerido): las puedes encontrar ingresando a tu cuenta Chazki.
  • API Secret de Chazki (opcional): las puedes encontrar ingresando a tu cuenta Chazki.
  • Nombre del medio de envío: nombre con el que deseas que se visualice el medio de envío en la tienda, si deseas mantener los nombres originales puedes dejar los campos en blanco.
  • Dirección de retiro de los pedidos (requerido): dirección donde los repartidores podrán recoger los pedidos.
  • Piso / Departamento (requerido): piso, nro o departamento de la dirección de retiro.
  • 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 de la app.

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.

# Video tutorial

En el siguiente vídeo te explicamos detalladamente cómo integrar Chazki a tu Tiendanube.

# 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 en el Panel Chazki. Una vez en el panel ingresa a la sección Integraciones y allí podrás encontrar la API Key para la versión 2 (v2).

  • Webhook Secret (opcional): se obtiene en el Panel Chazki. Una vez en el panel ingresa a la sección 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): puedes obtenerlas desde la tienda en producción, si no sabes como hacerlo puedes seguir este Tutorial.

  • URL de la tienda (requerida): es la dirección de tu tienda en producción. Suele tener la 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 con 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 Chazki con sus credenciales de acceso.

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

  3. Copie la siguiente dirección y péguela en el campo de texto Notificaciones-Tiendanube:

    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 app, debe iniciar sesión con su cuenta de Tiendanube. Seguidamente busque Chazki desde la tienda de aplicaciones de Tiendanube y haga clic en el botón Instalar aplicación.

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 presionando el botón Siguiente con el cual luego se llega al siguiente formulario donde se piden los datos básicos para poder operar con 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, presionar sobre Editar y una vez ahí agregar el costo adicional por cada tipo. Luego de haber agregado los valores correspondientes no olvides presionar el botón 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 clic en Mis Aplicaciones, una vez ahí debes ubicar la aplicación de Chazki y presionar el botón 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 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 MERCHANTS 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 cada tienda.