Introducción
El conector de Shopify para Bizagi se encuentra disponible para descargar en el Connectors Xchange.
Con este conector podrá enlazar sus procesos de Bizagi con una cuenta de www.shopify.com para usar los servicios del API de Shopify.
Para más información sobre este conector y sus funcionalidades, visite el Connectors Xchange.
|
Este conector se encuentra actualmente en versión Beta. Úselo en ambientes de producción bajo su propio riesgo. |
Antes de empezar
Para probar y usar este conector, necesitará:
1.Bizagi Studio previamente instalado.
2.Este conector previamente instalado, mediante el Connectors Xchange como se describe en https://help.bizagi.com/platform/en/index.html?Connectors_Xchange.htm, o producto de una instalación manual como se describe en https://help.bizagi.com/platform/es/index.html?connectors_setup.htm
3.Una cuenta en www.shopify.com.
4.Siga estos pasos en su cuenta de Shopify:
a.Vaya a Apps y seleccione la opción de Administrar apps privadas.
b.Cree su nueva app (si no tiene una) y seleccione los permisos que desea que tenga la aplicación.
c.Copie su api_key y su contraseña.
d.El procedimiento se muestra en la secesión de imágenes a continuación.
Configurar el conector
Para configurar el conector (por ejemplo sus parámetros de autenticación), siga los pasos presentados en el capítulo de configuración en https://help.bizagi.com/platform/es/index.html?connectors_setup.htm
Para esta configuración, considere los siguientes parámetros de autenticación:
•Método de autenticación: custom.
•API_KEY: La llave del API de su aplicación, obtenida en el proceso de configuración de su cuenta de Shopify descrito en la sección anterior.
•API_KEY_PASSWORD: La contraseña del API de su aplicación, obtenida en el proceso de configuración de su cuenta de Shopify descrito en la sección anterior.
Usar el conector
Este conector cuenta con 29 métodos disponibles del API de servicios de Shopify.
Para conocer en general cómo y dónde configurar el uso del conector, refiérase a https://help.bizagi.com/platform/en/index.html?Connectors_Studio.htm.
Al usar el conector, asegúrese de considerar los siguientes detalles para cada uno de los métodos disponibles.
Crear producto nuevo (Create new product)
Crea un nuevo producto con la variante por defecto.
Para configurar las entradas, considere:
•title: Título del producto. Este parámetro es requerido para una invocación exitosa del servicio.
•body-html: Descripción del producto en HTML.
•vendor: Proveedor del producto.
•product_type: Tipo de producto.
•variants: Arreglo de objetos con la siguiente estructura:
ooption1: Nombre de la variante.
oprice: Precio de la variante.
osku: Unidad de almacenamiento en inventario del producto.
obarcode: Código de barras (EAN13) de la variante.
oimage_id: ID de la imagen de la variante.
•Image_url: url de la imagen a cargar.
•image: Imagen en formato base 64.
•published: Especifica si el producto será público o no.
•tags: Etiquetas del producto.
•filename: Nombre del archivo de la imagen en base 64.
Para configurar las salidas, considere:
Obtener todos los productos (Get all products)
Trae una lista de productos.
Para configurar las salidas, considere:
Obtener producto (Get product)
Trae un solo producto.
Para configurar las entradas, considere:
•product_id: ID del producto que desea obtener. Este parámetro es requerido para una invocación exitosa del servicio.
Para configurar las salidas, considere:
Actualizar producto (Update product)
Actualiza un producto, sus variantes e imágenes.
Para configurar las entradas, considere:
•product_id: ID del producto que desea actualizar. Este parámetro es requerido para una invocación exitosa del servicio.
•body_html: Descripción del producto.
•vendor: Proveedor del producto.
•title: Título del producto.
•product_type: Tipo del producto.
•tags: Etiquetas del producto.
•published: Indica si el producto es público o no.
Para configurar las salidas, considere:
Eliminar producto (Delete product)
Eliminar un producto junto con sus variantes e imágenes.
Para configurar las entradas, considere:
•product_id: ID del producto que desea eliminar. Este parámetro es requerido para una invocación exitosa del servicio.
Para configurar las salidas, considere:
Crear nueva imagen de producto (Create new product image)
Crear una nueva imagen de producto con la información enviada como adjunto.
Para configurar las entradas, considere:
•product_id: ID del producto. Este parámetro es requerido para una invocación exitosa del servicio.
•main_image: Valor que indica si la imagen es la principal o no.
•image: Imagen en formato base 64.
•filename: Nombre del archivo de imagen.
•alt: Texto alternativo de la imagen (accesibilidad).
Para configurar las salidas, considere:
Crear un producto nuevo con URL de imagen (Create new product image with URL)
Crea un nuevo producto con la imagen incluida como adjunto.
Para configurar las entradas, considere:
•product_id: ID del producto. Este parámetro es requerido para una invocación exitosa del servicio.
•main_image: Valor indicando si la imagen será la principal o no.
•image_url: URL de la imagen.
•alt: Texto alternativo de la imagen (accesibilidad).
Para configurar las salidas, considere:
Obtener todas las imagenes del producto (Get all product images)
Obtiene todas las imágenes de un producto.
Para configurar las entradas, considere:
•product_id: ID del producto. Este parámetro es requerido para una invocación exitosa del servicio.
Para configurar las salidas, considere:
Obtener imagen de producto (Get product image)
Obtener la imagen de un solo producto.
Para configurar las entradas, considere:
•product_id: ID del producto. Este parámetro es requerido para una invocación exitosa del servicio.
•image_id: ID de la imagen. Este parámetro es requerido para una invocación exitosa del servicio.
Para configurar las salidas, considere:
Actualizar imagen de producto (Update product image)
Modifica la imagen de un producto.
Para configurar las entradas, considere:
•product_id: ID del producto. Este parámetro es requerido para una invocación exitosa del servicio.
•image_id: ID de la imagen. Este parámetro es requerido para una invocación exitosa del servicio.
•position: Nueva posición de la imagen.
•alt: Nuevo texto alternativo de la imagen.
Para configurar las salidas, considere:
Eliminar imagen de producto (Delete product image)
Eliminar la imagen de un producto.
Para configurar las entradas, considere:
•product_id: ID del producto. Este parámetro es requerido para una invocación exitosa del servicio.
•image_id: ID de la imagen. Este parámetro es requerido para una invocación exitosa del servicio.
Para configurar las salidas, considere:
Crear variante del producto (Create product variant)
Crear una nueva variante de producto.
Para configurar las entradas, considere:
•product_id: ID del producto. Este parámetro es requerido para una invocación exitosa del servicio.
•option1: Nombre de la variante.
•price: Precio de la variante.
•sku: Unidad de almacenamiento en inventario de la variable.
•barcode: Código de barras (EAN13) de la variante.
•image_id: ID de imagen de la variante.
Para configurar las salidas, considere:
(Get all product variants)
Obtener una lista de las variantes de producto.
Para configurar las entradas, considere:
•product_id: ID del producto. Este parámetro es requerido para una invocación exitosa del servicio.
Para configurar las salidas, considere:
Obtener variante (Get variant)
Obtiene una variante de producto.
Para configurar las entradas, considere:
•variant_id: ID de la variante. Este parámetro es requerido para una invocación exitosa del servicio.
Para configurar las salidas, considere:
Actualizar variante (Update variant)
Actualiza una variante de producto.
Para configurar las entradas, considere:
•variant_id: ID de la variante. Este parámetro es requerido para una invocación exitosa del servicio.
•option1: Nombre de la variante.
•price: Precio de la variante.
•barcode: Código de barras (EAN13) de la variante.
•image_id: ID de imagen de la variante.
Para configurar las salidas, considere:
Eliminar variante (Delete variant)
Eliminar una variante de producto.
Para configurar las entradas, considere:
•Product_id: ID del producto. Este parámetro es requerido para una invocación exitosa del servicio.
•variant_id: ID de la variante. Este parámetro es requerido para una invocación exitosa del servicio.
Para configurar las salidas, considere:
Crear nuevo cliente (Create new customer)
Envía una invitación de cuenta a un cliente.
Para configurar las entradas, considere:
•First_name: Nombre.
•Last_name: Apellido.
•Email.
•Phone: Teléfono.
•Verified_email: Valor que indica si el correo fue verificado.
•send_email_welcome: Valor que indica si se va a enviar un correo de bienvenida.
•send_email_invite: Valor indicando si se enviará una invitación por correo.
•address: Un objeto con la siguiente estructura:
oaddress1: Dirección del cliente.
ocity: Ciudad correspondiente a la dirección.
oprovince: Estado/provincia.
ocountry: País.
odefault: Valor que indica si esta es la dirección por defecto.
•password: Contraseña.
•password_confirmation: Confirmación de la contraseña.
•note: Cualquier información adicional.
Para configurar las salidas, considere:
Obtener todos los clientes (Get all customers)
Obtiene una lista de clientes.
Para configurar las salidas, considere:
Buscar clientes (Search customers)
Busca los clientes que satisfagan la consulta provista.
Para configurar las entradas, considere:
•query: Texto a buscar en la información de clientes.
Para configurar las salidas, considere:
Obtener cliente (Get customer)
Obtener un cliente específico.
Para configurar las entradas, considere:
•customer_id: ID del cliente que desea obtener.
Para configurar las salidas, considere:
Actualizar cliente (Update customer)
Actualiza la información de un cliente.
Para configurar las entradas, considere:
•customer_id: ID del cliente a actualizar. Este parámetro es requerido para que la invocación del servicio sea exitosa.
•First_name: Nombre del cliente.
•Last_name: Apellido del cliente.
•Phone: Teléfono del cliente.
•Verified_email: Valor que indica si el correo ha sido verificado o no.
•send_email_welcome: Valor que indica si se debe mandar o no un correo de bienvenida.
•send_email_invite: Valor que indica si se debe enviar una invitación por correo.
•address: Un objeto con la siguiente estructura.
oaddress1: Dirección del cliente.
ocity: Ciudad correspondiente a la dirección.
ocountry: País.
odefault: Valor que indica si esta es la dirección por defecto del cliente.
•note: Cualquier información adicional.
Para configurar las salidas, considere:
Eliminar cliente (Delete customer)
Elimina un cliente.
Para configurar las entradas, considere:
•customer_id: ID del cleinte a eliminar. This parameter is mandatory for the service execution to be successful.
Para configurar las salidas, considere:
Obtener lista de órdenes (get list of orders)
Trae una lista de órdenes.
Para configurar las salidas, considere:
Buscar órdenes de un cliente (Find orders of a customer)
Obtiene una lista de órdenes que perteneces a un cliente específico.
Para configurar las entradas, considere:
•customer_id: ID del cliente cuyas órdenes desea obtener. Este parámetro es requerido para una ejecución exitosa del servicio.
Para configurar las salidas, considere:
Obtener orden (Get order)
Trae una orden en específico.
Para configurar las entradas, considere:
•order_id: ID de la orden que desea traer. Este parámetro es obligatorio para una ejecución exitosa del servicio.
Para configurar las salidas, considere:
Cerrar orden (Close order)
Cierra una orden.
Para configurar las entradas, considere:
•order_id: ID de la orden a cerrar. Este parámetro es requerido para una ejecución exitosa del servicio.
Para configurar las salidas, considere:
Reabrir orden (Re-open order)
Reabre una orden.
Para configurar las entradas, considere:
•order_id: ID de la orden a reabrir. Este parámetro es requerido para una ejecución exitosa del servicio.
Para configurar las salidas, considere:
Cancelar orden (Cancel order)
Cancela una orden.
Para configurar las entradas, considere:
•order_id: ID de la orden a cancelar. Este parámetro es requerido para una ejecución exitosa del servicio.
Para configurar las salidas, considere:
Crear orden (Create an order)
Crea una orden.
Para configurar las entradas, considere:
•customer_id: ID del cliente que hace la orden.
•line_items: Objeto con la siguiente estructura. Este parámetro es requerido para una ejecución exitosa del servicio.
ovariant_id: ID de la variante que el cliente adquiere.
oquantity: Cantidad de unidades que adquiere el cliente.
Para configurar las salidas, considere:
Para mas información sobre el uso de estos métodos, refiérase a la documentación oficial de Shopify en https://help.shopify.com/en/api/reference.
Last Updated 10/28/2022 4:37:43 PM