Para sincronizar precios B2B desde un ERP hacia Shopify, use la API pública de BSS B2B Solution: genere una clave de API en el plan Platinum y luego haga que su desarrollador o su socio de integración cree, actualice y elimine reglas de Custom Pricing, Price List y Volume Pricing desde su sistema de registro, y llame al endpoint de carga para que las reglas activas lleguen al tema publicado. Su equipo deja de volver a escribir precios en una pantalla del admin.
Esta guía es para distribuidores y fabricantes cuyos precios, clases de precio o grupos de clientes ya viven en un ERP, un PIM o un flujo de datos. Explica quién se beneficia, qué cubre y qué no cubre la API, un esquema de integración de cinco pasos, un ejemplo práctico y los límites que conviene tener en cuenta, incluido que no hay endpoint de pedidos. Está escrita para quien decide si construye la integración, y remite a la documentación para desarrolladores para los payloads exactos.
Para quién es esto
La API pública le conviene si la mayoría de estas situaciones describe su tienda:
- Sus precios se mantienen en un ERP, un PIM o una hoja maestra, y la tienda de Shopify es una segunda copia.
- Tiene varias clases de precio o grupos de clientes, y un cambio de precio afecta a cientos o miles de variantes.
- Los precios cambian cada semana o cada día, así que una actualización manual se queda atrás entre una ejecución y la siguiente.
- Tiene un desarrollador, una agencia o un socio de integración que puede escribir un trabajo programado.
- Ya exporta datos de precios en CSV y quiere que esos datos fluyan sin que nadie abra la app.
Si su lista de precios cambia unas pocas veces al año, una importación CSV es más sencilla. Vea importar precios mayoristas desde CSV.
Por qué importa
Dos copias de una lista de precios se separan. Alguien actualiza el ERP el lunes, se olvida de la tienda, y el martes un comprador ve el precio del trimestre pasado. El comprador pide al precio equivocado y usted absorbe la diferencia o cancela el pedido, o el comprador pierde la confianza en el portal y llama al equipo de ventas. Cuanto más grande es el catálogo y más clases de precio maneja, con más frecuencia ocurre.
Un flujo de datos corrige la causa y no el síntoma. El ERP sigue siendo el sistema de registro, un trabajo programado escribe los cambios en BSS B2B Solution, y la tienda los sigue. Las tiendas reales quieren esta flexibilidad. Alpha Coffee, un tostador de café, señala que, con acceso a la API, puede mantener Shopify como capa central de comercio y ampliarla hacia plataformas de ERP, CRM o finanzas, y DermaplanePro informa de menos trabajo manual gracias a conexiones de API pública con sistemas externos. Vea los casos de Alpha Coffee y DermaplanePro.
Cómo configurarlo con BSS B2B Solution
Esta sección describe la integración desde el lado del comerciante. Su desarrollador necesita la guía de la API pública para los endpoints y los payloads.
Paso 1: Confirme el plan
La API pública forma parte del plan Platinum. Una tienda puede tener una clave de API a la vez, y el plan también desbloquea Price Lists, que muchas integraciones con ERP usan para precios específicos por cliente. Confirme el plan antes de definir el alcance de cualquier trabajo de integración.
Paso 2: Genere la clave de API
En la app, abra Integrations, busque la tarjeta Public API y elija Get API key. La clave se muestra una sola vez, así que cópiela o descárguela en ese momento y guárdela en un gestor de contraseñas o en una variable de entorno del servidor. Si se filtra, elimínela en la misma tarjeta, lo que detiene a todos los clientes que la usan, y luego genere una nueva.
Paso 3: Autentique su primera solicitud
Los endpoints de la versión 1 reciben su dominio `myshopify.com` y la clave, ya sea como `accessKey` en el cuerpo de la solicitud o en el encabezado `x-bss-b2b-api-key`. El endpoint de volume pricing de la versión 2 usa el encabezado `x-api-key`. No se admite un token Bearer y devuelve 401, así que no construya el cliente alrededor del encabezado `Authorization`.
Paso 4: Escriba reglas a partir de los datos de su ERP
Asigne cada clase de precio del ERP a un destino de regla, como una etiqueta de cliente, y llame al grupo de endpoints del módulo que use. La API gestiona reglas de Custom Pricing, Price List y Volume Pricing, reglas de códigos de descuento, registros del formulario de registro y reglas de límite de pedido, con operaciones de crear, actualizar, eliminar y en lote donde el endpoint lo permite. Los endpoints de clientes y productos son consultas de solo lectura que ayudan a construir los payloads de reglas, por ejemplo para buscar clientes por etiqueta o listar productos y colecciones. Las solicitudes se procesan una a la vez, así que el cliente debe poner sus llamadas en cola.
Paso 5: Suba una vez y luego verifique
Después de un lote de cambios, llame al endpoint de carga del módulo para que todas las reglas activas se escriban en su tema publicado. Los endpoints de carga permiten una solicitud por módulo cada cinco minutos, así que suba una vez al final de la ejecución de sincronización, no después de cada fila. Una solicitud por encima del límite devuelve `429`, y solo se suben las reglas activas. Si sus reglas superan la capacidad de los metafields, la API guarda lo que cabe y devuelve un informe `partial_success` con HTTP 200, así que lea el cuerpo de la respuesta y no solo el código de estado. Luego revise el resultado en la tarjeta Logs and usage bajo Advanced Settings > Public API, que muestra las solicitudes recientes con hora, método, ruta y estado, y muestra la solicitud y la respuesta completas cuando algo falla. La API también puede devolver el precio que obtiene un cliente determinado por ciertos productos, lo que sirve para comparar la app con el ERP.
Ejemplo: un distribuidor con tres clases de precio
Este ejemplo usa cifras ilustrativas, no resultados de una tienda real. Un distribuidor mantiene tres clases de precio en su ERP: Retail Partner, Trade y Key Account. En BSS B2B Solution, cada clase es una regla de Price List que apunta a una etiqueta de cliente. Un trabajo nocturno exporta las filas de precio cambiadas, las agrupa por clase y llama al endpoint de guardado en lote para cada Price List. Cuando las tres terminan, el trabajo llama una vez al endpoint de carga de Price List.
Un lunes, el ERP muestra 3.200 precios cambiados. En lugar de que un analista los vuelva a escribir, el trabajo se ejecuta a las 02:00, sube una vez y revisa la tarjeta Logs and usage por si hay solicitudes fallidas. Por la mañana, un comprador Trade que inicia sesión ve los precios del lunes en las páginas de producto y de colección. Una solicitud fallida deja una entrada en el registro con su estado y su cuerpo, y el trabajo la reintenta tras una breve espera.
Funciona bien con
La API es una vía de entrada para el motor de precios. Otras páginas explican qué pasa con esas reglas una vez que existen:
- CSV en lugar de código: importar precios mayoristas desde CSV cubre la ventana de importación para catálogos más pequeños.
- Listas de precios por grupo de compradores: lista de precios B2B por grupo de compradores muestra el tipo de regla que escriben la mayoría de las sincronizaciones con ERP.
- Cortes por cantidad: precios por escalones y cortes por cantidad explica las reglas de Volume Pricing que la API también puede gestionar.
- Orden de las reglas: qué regla B2B gana explica la prioridad, para que una regla sincronizada no choque con una creada a mano.
La página de precios mayoristas reúne las guías de precios. Entradas útiles del glosario son lista de precios, precio mayorista y etiqueta de cliente.
Límites y errores comunes
- No hay endpoint de pedidos. La API gestiona reglas de precios y descuentos, registros del formulario de registro y reglas de límite de pedido, además de consultas de solo lectura de clientes, productos y colecciones. Mantenga la sincronización de pedidos en el conector de su ERP para Shopify, y use esta API para precios y grupos de clientes.
- Una clave por tienda. Eliminar la clave detiene a todos los clientes que la usan, así que, si la rota, actualice la integración de inmediato.
- La carga tiene límite de frecuencia. Los endpoints de carga permiten una solicitud por módulo cada cinco minutos. El endpoint de volume pricing de la versión 2 permite 60 solicitudes por cada 60 segundos para cada tienda.
- Los datos de precios tienen topes. Las reglas se guardan en metafields de Shopify con un máximo de 10 claves y 2.000.000 de caracteres por clave. El contenido por encima de los topes se omite y se informa como `partial_success`, así que elimine las reglas inactivas o divida un conjunto de reglas muy grande antes de volver a subir.
- Los reintentos necesitan una pausa. Las solicitudes se procesan una a la vez, y tras un error del servidor la guía indica que espere hasta tres minutos antes de reintentar.
- La API no reemplaza el diseño de reglas. La segmentación, la prioridad y las exclusiones siguen las mismas reglas que las reglas creadas a mano, así que pruebe primero una regla en el admin.
- La API alimenta una tienda con tema. Los precios aparecen a través del app embed de BSS B2B Solution en su tema de Shopify, así que confirme que el embed esté activado después de cualquier cambio de tema.
Lista de verificación de configuración
- Confirme que la tienda está en el plan Platinum.
- Decida el sistema de registro de cada clase de precio y a qué etiqueta de cliente corresponde cada clase.
- Genere la clave de API y guárdela en un gestor de contraseñas o en una variable de entorno.
- Construya el cliente con `accessKey` o con el encabezado `x-bss-b2b-api-key`, y ponga las solicitudes en cola.
- Pruebe una regla de principio a fin en una tienda de desarrollo y luego revísela en el admin.
- Planifique una llamada de carga por módulo al final de cada ejecución de sincronización.
- Añada alertas para `429` y errores del servidor, y lea la tarjeta Logs and usage tras las primeras ejecuciones.
- Mantenga la sincronización de pedidos en un conector separado.
Planes y requisitos
La API pública necesita el plan Platinum de BSS B2B Solution, una clave por tienda y el app embed en su tema. Los demás planes y la prueba gratuita de 14 días en los planes de pago están en la página de precios de BSS B2B. Los payloads exactos están en la guía de la API pública, la guía de la API de carga y la guía de la API de Custom Pricing. Instale BSS B2B Solution desde la Shopify App Store y pida a su desarrollador que empiece con una sola Price List.
