Catálogo de Productos Custom Source
Trae tu propio catálogo de productos
En Bird, puedes crear una fuente de catálogo de productos personalizada utilizando un endpoint de API. La respuesta de la API debe adherirse a un formato específico que incluya detalles del producto, variantes, imágenes y más. A continuación, se presenta una guía sobre cómo estructurar los datos de tu catálogo de productos y cómo crearlo utilizando la API.
Creando un Catálogo de Productos Custom
Catálogo de Producto Source API Format
La respuesta del punto final de la API debe ser un arreglo de objetos de producto, cada uno conteniendo varios campos. Aquí está la estructura y valores de ejemplo para cada campo:
Campos requeridos:
id (string): Un identificador único para el producto. Ejemplo:
"8890650190078"
name (string): El nombre del producto. Ejemplo:
"My Test Product"
description (string): Una descripción del producto. Ejemplo:
"Un producto genial con luces disponibles en diferentes colores"
status (string): El estado actual del producto. Los valores válidos son:
active
: El producto está en vivo y disponible.archived
: El producto está archivado.draft
: El producto es un borrador. Ejemplo:"active"
created_at (string): La fecha y hora en que el producto fue creado, en formato ISO-8601. Ejemplo:
"2022-05-25T10:55:16+02:00"
updated_at (string): La fecha y hora en que el producto fue actualizado por última vez, en formato ISO-8601. Ejemplo:
"2022-05-25T10:55:16+02:00"
published_at (string): La fecha y hora en que el producto fue publicado, en formato ISO-8601. Ejemplo:
"2022-05-25T10:55:16+02:00"
vendor (string): El nombre del distribuidor del producto. Ejemplo:
"My Vendor"
deleted_at (string): La fecha y hora en que el producto fue eliminado (si aplica), en formato ISO-8601. Ejemplo:
"2022-05-25T10:55:16+02:00"
o una cadena vacía""
si el producto no ha sido eliminado.
Campos opcionales:
url (string): La URL del producto. Ejemplo:
"https://www.myproduct.com"
type (string): El tipo de producto, que puede ser usado para filtrar y buscar productos. Ejemplo:
"color"
variants (array): Un arreglo de variantes del producto. Si se especifica, cada variante debe incluir
id
,name
,sku
, y precio.
Ejemplo:
images (array): Un arreglo de imágenes del producto. Si se especifica, cada imagen debe incluir
id
,position
,url
,alt
,width
, yheight
. El arreglovariant_ids
también puede vincular imágenes con variantes específicas del producto.
variant_ids (array): Un arreglo de ids de variantes asociadas con la imagen del producto.
Instrucciones paso a paso para crear un catálogo de productos personalizado Source
Prepare Your Data: Da formato a tu respuesta de catálogo de productos de acuerdo con la estructura descrita anteriormente. Asegúrate de incluir todos los campos requeridos, y añade campos opcionales como
variants
,images
, yurl
según sea necesario.Create the API Endpoint: Utiliza la API de BirdCRM para enviar los datos de los productos. El endpoint espera una respuesta que cumpla con la estructura mencionada anteriormente. Asegúrate de que los datos estén en un formato JSON válido.
Test the Endpoint: Antes de integrar la fuente del catálogo de productos en tu flujo de trabajo, es importante probar el endpoint de la API para verificar que los datos se estén procesando correctamente. Esto asegura que todos los productos y su información relacionada (como variantes e imágenes) se estén recopilando correctamente.
Monitor and Maintain: Una vez que se crea la fuente del catálogo de productos, puedes monitorear su rendimiento a través de las funciones de informes de BirdCRM. Si necesitas actualizar algún detalle del producto o agregar nuevos productos, simplemente actualiza los datos usando la API.
Ejemplo de Respuesta de API:
Siguiendo estos pasos, puedes crear y gestionar una fuente de catálogo de productos personalizada dentro de Bird. Asegúrate de que la respuesta de la API cumpla con el formato requerido, y podrás integrar tus productos en la plataforma sin problemas.