Conector de Channable

Primeros pasos

Para empezar a sincronizar pedidos primero tienes que activar la API de tu compañía en tu cuenta de Channable, sigue los siguientes pasos para generar la API de Channable de tu cuenta, en este paso necesitas tener guardado los siguientes valores generados, el Company ID y el API Token:

Configurar una conexión

En Odoo ve al módulo de Ventas, luego al apartado Configuración ‣ Conector Channable - Conexiones, haz click en el botón de arriba a la izquierda Nuevo. En este formulario defines la conexión con los siguientes campos obligatorios con los datos obtenidos previamente aquí:

• Nombre: Nombre de tu compañía.
• API Token: Identificador o token de la API.
• ID de la empresa: Número identificador de la compañía.

Configurar un proyecto

En Odoo dirígete al módulo de Ventas, luego al apartado Configuración ‣ Conector Channable - Proyectos, haz click en el botón de arriba a la izquierda Nuevo. Aquí defines el proyecto, con los siguientes campos obligatorios:

• Nombre del proyecto.
• Identificador: este número lo puedes obtener en Channable, entrando en el proyecto que estás configurando y copiando el identificador, como se muestra en la siguiente imagen, haz click en copiar e introducelo en este campo en Odoo:
  
• Conexión: Conexión o compañía a la que está asociada este proyecto, si no tienes ninguna conexión configurada puedes crear una aquí.

Configurar un mercado

En Odoo dirígete al módulo de Ventas, luego al apartado Configuración ‣ Conector Channable - Mercados, haz click en el botón de arriba a la izquierda Nuevo. Aquí defines el mercado del que quieres importar sus pedidos a Odoo, con los siguientes campos obligatorios:

• Nombre: Nombre del mercado desde dónde se importarán los pedidos, ejemplo: Amazon, eBay, AliExpress, ManoMano Fullfilment, etc.
• ID de configuración del pedido: Identificador del mercado en Channable, primero accede al proyecto donde pertence la conexión y sigue estos pasos:
• • Proyecto ‣ Setup ‣ Orders ‣ Haz click en el botón de Settings del mercado que estás configurando:
    
  • En la URL, copia el último número y pégalo en Odoo:
    
• Proyecto: Proyecto al que este mercado está asignado, si no tienes ningún proyecto configurado puedes crear uno aquí.
• Asignar errores a este usuario: Usuario al que se le asignarán los errores al intentar sincronizar los pedidos de este mercado con Channable.
• Almacén: El almacén desde dónde se retirará el stock de los pedidos de este mercado.
• Operador predeterminado: Método de envío por defecto que se le asignará a los pedidos de este mercado, para que sea un método de envío válido configura uno haciendo click aquí.
• Lista de precios: Lista de precios que se aplicará a los pedidos.
• Proveedor de pagos: Proveedor que se usará para crear los pagos.
• Método de pago (v17.0 en adelante): Método de pago según el prooverdor seleccionado.
  
  

Configurar transportista

En Odoo dirígete al módulo de Ventas, luego al apartado Configuración ‣ Métodos de envío, selecciona un método de envío y dirígete a la pestaña llamaba Channable, en este apartado hay un campo llamado transportador, este es el transportista que se usará cuando el albarán del pedido se envíe y notificar a Channable de que el pedido ha sido enviado, para crear un transpotador sigue estos pasos:

1. Haz click en el siguiente enlace aquí, una vez dentro despliega la lista de transportistas haciendo click como se muestra en la siguiente imagen:
   
2. Busca el transportador que quieres integrar en Odoo, en la primera columna se muestra el código y en la segunda columna el nombre del transportador, copia el texto de la primera columna que equivale al código.
3. En Odoo pega el código del transportador y el nombre, tal como se muestra en la siguiente imagen:
   

Configurar un mercado - descripción de campos

En cada mercado puedes configurar distintos parámetros según las necesidades de tu empresa, a continuación se describirán todos los campos y las funciones que otorgan:

• Orden
• •  Activo: Un condicional que indica si el mercado está activo para importar pedidos o no.
  • Campo de producto de sincronización: Qué campo de producto en Odoo utilizar al importar los pedidos.
  • Estados válidos: Cada pedido de Channable tiene asignado un estado, puedes definir aquí qué estados se usarán de filtro al importar pedidos de Channable.
  • Asignar errores a este usuario: Usuario al que se le asignarán los errores al intentar sincronizar los pedidos de este mercado con Channable.
  • Notificar como enviado automáticamente: Al tener activo este campo, los pedidos de este mercado se notificarán como enviado al confirmalos, con el transportador asignado, en caso que tenga uno y la referencia de seguimiento vacía.
  • Guardar archivos adjuntos: Los pedidos de Channable pueden tener archivos adjuntos, estos archivos adjuntos se guardan en los mensajes del pedido, y puede guardarse la URL que hace referencia al documento en Channable, o descargarlo en la base de datos, dependiendo de su estrcutura y limitación de su base de datos eliga una opción u otra.
  • Auto validar cotizaciones: Si esta opción está activada, al importar un pedido con éxito de Channable en Odoo, se confirmará automáticamente.
  • Órdenes de validación automática:  Si esta opción está activada, al importar un pedido con éxito de Channable en Odoo, se confirmará, se crearán y validarán la factura y los albaranes.
  • Validar automáticamente las facturas al confirmar el pedido: Validar automáticamente las facturas al confirmar el pedido.
  • Permitir diferencia de totales para validar automáticamente la cotización: Al importar un pedido de Channable a Odoo, puede que haya una diferencia entre los totales que tiene Channable y los que calcula el Odoo con los impuestos definidos, aquí puedes definir un umbral de diferencia entre el total de Channable y lo que ha calculado Odoo, si se excede del valor definido aquí, saltará un error y no se confirmará automáticamente en el caso de que estuviese activado.
  • Posición fiscal predeterminada: La posición fiscal que se aplicarán en los pedidos de este mercado.
  • Equipo de ventas: El equipo de ventas que se le asignarán a los pedidos.
  • Lista de precios: Lista de precios que se aplicará a los pedidos.
  • Posición Fiscal para Órdenes Intracomunitarias: Posición fiscal que se usará al detectar un pedido como intra comunitario, para más detalles haz click aquí.
  • Proveedor de pagos: Proveedor que se usará para crear los pagos.
  • Método de pago (v17.0 en adelante): Método de pago según el prooverdor seleccionado.
  • Almacén: El almacén desde dónde se retirará el stock de los pedidos de este mercado.
  • Operador predeterminado: Método de envío por defecto que se le asignará a los pedidos de este mercado, para que sea un método de envío válido haz click aquí.
• Cliente
• • Idioma: El idioma que se le asignarán a los nuevos clientes.
  • Etiquetas: Etiquetas que se le asignarán a los nuevos clientes.
  • Número de IVA del socio predeterminado: Puedes definir un NIF/VAT predeterminado en caso de que el pedido de Channable no lo tenga definido.
• Pedido - Transportista por método de entrega (en este campo puedes definir un transportista según el país de la dirección de envío del pedido).
• Orden - Posición Fiscal por país (en este campo puedes definir una posición fiscal según el país de la dirección fiscal del pedido).

Vista de mercado

Cada mercado tiene una vista y botónes de acción, a continuación se explicará con detalles la funcionalidad de cada botón y vista de los mercados, en la siguiente imagen se muestra los elementos que compone un mercado:

1. Botón que al hacer click se mostrá todos los pedidos del mercado.
2. Botón para importar manualmente pedidos, para más detalles haz click aquí.
3. Notificar manualmente a Channable todos los pedidos que han sido enviados, para más detalles haz click aquí.
4. Botón para ver los pedidos pendientes por validar.
5. Botón para ver los pedidos pendientes por entregar.
6. Botón para abrir menú:
   
7. 1. Botón para ver todos los pedidos.
   2. Botón para ver todos los errores, para más detalles haz click aquí.
   3. Definir color para la vista kanban.
   4. Botón para acceder a la configuración del mercado.

Vista de pedido

Cada pedido contiene botónes de acción, a continuación se explicará con detalles la funcionalidad de cada botón y componente en el pedido, en la siguiente imagen se muestra los elementos:

1. Botón para acceder a los errores generados al sincronizar el pedido con Channable, para más detalles haz click aquí.
2. Acceso directo del pedido a la web de Channable.
3. Sincronizar manualmente datos del pedido de Channable, actualizará y remplazará todos los datos del pedido como si se hubiera importado de nuevo.
4. Sincronizar manualmente estado de pedido, para más detalles haz click aquí.
5. Sincronizar manualmente los archivos adjuntos de pedido.
6. Mercado al que está asignado este pedido.
7. Estado actual del pedido en Channable.
8. Referencia del mercado en Channable.
9. Identificador del pedido en Channable.

Cancelar un pedido

Desde Odoo puedes notificar que un pedido ha sido cancelado a Channable, y Channable automáticamente actualizará el estado en el mercado conectado, para ello tienes que seguir los siguientes pasos en Odoo:

1. Primero el pedido tiene que estar en estado Cancelado, haz click en el botón de Cancelar:
   
2. Al tener el estado del pedido en Cancelado, aparecerá un botón llamado Cancelar pedido Channable, haz click en el botón y confirma para notificar a Channable del cambio de estado:
   

Estado de Channable de un pedido

En Odoo se guarda y se actualiza el estado que tiene asignado el pedido en Channable, este estado indica si el pedido ha sido enviado, cancelado, etc:

El estado en un pedido puede actualizarse de 2 formas, a continuación se explica:

Actualizar estado de pedido manualmente

Puedes actualizar el estado de Channable de uno o varios pedidos manualmente, siguiendo estos pasos:

1. Dirígete al módulo de Ventas, luego al apartado Pedidos ‣ Pedidos de Channable, selecciona los pedidos que quieres actualizar y haz click en el botón Estado de sincronización​:
   
2. Se actualizarán los estados automáticamente.

Actualizar estado de pedido automáticamente

Cada 6 horas Odoo automáticamente actualizará el estado de Channable de los pedidos confirmados desde hace 15 días, y que su estado de Channable no sea Shipped (shipped) o Manual (manual).

Gestión de errores de un pedido

Al intentar importar o sincronizar un pedido en Odoo y ocurra un error inesperado, se generará un error con todos los detalles que se vinculará al pedido y se le asignará una tarea al usuario que previamente ha sido configurado en el mercado, a continuación se detallará la funcionalidad y como acceder a los errores de un pedido:

Acceder a un error através de una actividad

Los errores generados al importar un pedido, se asignarán al usuario configurado en el mercado, para configurar este usuario haz click aquí, para acceder a las actividades sigue los siguientes pasos:

1. Ve a tus actividades:
   
2. Las actividades generadas se ven de esta manera:
   
3. Al hacer click en el link, se te redirigirá a los detalles del error, para ver más detalles haz click aquí.

Acceder a todos los errores de un pedido

Los errores generados al importar un pedido, se vincularán al pedido, para acceder a todos los errores de un pedido de Channable sigue los siguientes pasos:

1. Ve a un pedido de Channable, y si tiene errores asignados aparecerá un botón arriba llamado Errores:
   
2. Al hacer click en el botón listarán todos los errores que se han asignado a este pedido, puedes filtrar por fecha, descripción del error, etc.
3. Para ver más detalles de un error haz click en uno, para ver más detalles haz click aquí.

Acceder a todos los errores de un mercado

Puedes ver todos los errores generados de los pedidos de un mercado, para ello sigue los siguientes pasos:

1. Dirígete al módulo de Ventas, luego al apartado Configuración ‣ Conector Channable - Mercados.
2. En el mercado, abre el menú y accede a Errores:
   
3. Al hacer click en el botón se listarán todos los errores que se han asignado a los pedidos de este mercado, puedes filtrar por pedido, fecha de creación, descripción del error, etc.
4. Para ver más detalles de un error haz click en uno, para ver más detalles haz click aquí.

Detalles de un error

Al acceder a un error de un pedido, se mostrarán los siguientes campos:

1. Botón para acceder al pedido en Odoo.
2. Descripción breve del error.
3. Referencia única generada al crear el error.
4. Acción que se intentó realizar y generó el error, los posibles valores son los siguientes:
5. 1. Crear pedido: Al crear el pedido.
   2. Orden de sincronización: Al sincronizar el pedido.
   3. Actualizar información de envío: Al notificar como enviado el pedido.
   4. Estado del pedido de sincronización: Al intentar actualizar el estado del pedido.
   5. Código de seguimiento de pedidos de sincronización: Al intentar enviar la referencia de seguimiento. 
   6. Confirmar pedido: Al intentar confirmar el pedido.
6. Descripción detallada del error, solo es posible verlo activando el modo desarrollador.
7. Momento en el que se generó el error.
8. Quién intentó realizar la acción sobre el pedido.

Configurar posición fiscal para pedidos intra comunitarios

Al importar un pedido de Channable, Odoo puede detectar si es un pedido intracomunitario y asignar un posción fiscal específica, a continuación se describirá como configurarlo:

1. Dirígete al módulo de Ventas, luego al apartado Configuración ‣ Conector Channable - Mercados, accede a la configuración del mercado y define una posición fiscal en el campo Posición Fiscal para Órdenes Intracomunitarias, esta será la posición fiscal que se le asignará a los pedidos intracomunitarios de este mercado:
   
2. Para definir esta posición fiscal, el pedido en Channable tiene que cumplir 2 condiciones:
3. 1. El campo Business order tiene que tener como valor: True.
      
   2. El monto total de los impuestos de las líneas del pedido, tienen que sumar 0.
      

Importar pedidos manualmente

Puedes importar nuevos pedidos manualmente de un mercado, para ello sigue los siguientes puntos:

1. Dirígete al módulo de Ventas, luego al apartado Configuración ‣ Conector Channable - Mercados, en el mercado haz click en el botón Sincronizar pedidos:
   
2. Se abrirá un pop-up, donde puedes filtrar por fecha inicio y fecha final de creación de los pedidos y filtrar por los estados válidos de los pedidos:
   
3. Puedes filtrar por el identificador de Channable de los pedidos, activando la opción Importar pedidos por id, se mostrará un campo de texto dónde puedes introducir los identificadores separados por comas:
   
4. Por último haces click en el botón Órdenes de importación, y se importan los pedidos del mercado seleccionado según los filtros que hayas definido.

Enviar pedidos manualmente

Puedes notificar manualmente a Channable si un pedido ha sido envíado y actualizar su estado en el mercado, hay 2 opciones para realizar esta acción:

Enviar pedidos de un mercado

Puedes notificar como enviado todos los pedidos pendientes de un mercado, para ello sigue los siguientes pasos:

1. Dirígete al módulo de Ventas, luego al apartado Configuración ‣ Conector Channable - Mercados, en el mercado haz click en el botón Envío de pedidos sincronizados​:
   
2. Se obtendrán todos los pedidos pendientes por enviar, y actualizará el estado en Channable, para ver cuales son las condiciones para que un pedido esté pendiente de enviar haz click aquí.

Enviar un pedido manualmente

Puedes notificar como enviado uno o varios pedidos, para ello sigue los siguientes pasos:

1. Dirígete al módulo de Ventas, luego al apartado Pedidos ‣ Pedidos de Channable, en la lista de pedidos de Channable, selecciona los pedidos que quieras actualizar​:
   
2. Una vez seleccionados los pedidos, hac click en el botón Notificar como enviado.
3. Para ver cuales son las condiciones para que un pedido esté pendiente de enviar haz click aquí.

Enviar un pedido automáticamente

Cada hora Odoo automáticamente notificará como enviado aquellos pedidos que su fecha de confirmación sea menor a 5 días, que su estado de Channable no sea Shipped (shipped) y que contengan un albarán de entrega con el estado Estado de sincronización Channable con valor Pendiente.

Pedido pendiente de enviar

Para que un pedido de Channable esté pendiente notificar como enviado en Odoo, tiene que cumplir los siguientes puntos:

1. El estado del pedido no puede ser ni cancelado ni en borrador.
2. El estado de Channable en el pedido no puede ser Manual (manual).
   
3. Tiene que tener albaranes de salida hechos.
4. El campo Estado de sincronización Channable en los albaranes de salida tiene que tener como valor Pendiente.
   

Permisos en el conector

Puedes asignarle ciertos permisos a los usuarios de Odoo para que puedan crear o no nuevos mercados, o para realizar acciones en los pedidos de Channable o no, esto lo puedes asignar siguiendo los pasos:

1. Dirígete al módulo de Ajustes, luego al apartado Usuarios y Compañías ‣ Usuarios, accede a la ficha de un usuario y modifica el siguiente grupo:
   
2. Puedes asignar 3 tipos de permiso a un usuario:
3. 1. Usuario: Permitir ver pedidos: Estos usuarios solo pueden ver datos, no pueden crear, importar o cancelar pedidos de Channable.
   2. Usuario: Permitir gestionar pedidos: Estos usuarios pueden importar pedidos, notificar como enviado, pero no pueden crear nuevos mercados, proyectos y conexiones en Odoo.
   3. Administrator: Estos usuarios pueden crear nuevos mercados, conexiones, importar pedidos, etc. 

   Puedes quitarle acceso completo del conector al usuario dejando el campo vacío.

Preguntas frecuentes