Solo Platinum
El acceso a la Public API necesita el plan Platinum en una tienda activa, o Enterprise en un plan heredado. Una clave por tienda.
BSS B2B Solution: Public API
Integración ERP con la Public API de BSS B2B Solution: claves, endpoints y límites
La Public API de BSS B2B Solution permite que su ERP, PIM o herramienta propia cree, actualice y elimine reglas de Custom Pricing, Volume Pricing, Price List y Discount Code, gestione formularios de registro, y consulte clientes, productos y colecciones. Necesita el plan Platinum en una tienda activa y una clave de API por tienda. No hay endpoint de pedidos.
Instalar BSS B2B Solution Volver a BSS B2B Solution Requiere el Plan Platinum. BSS B2B Solution tiene prueba gratuita de 14 días (planes de pago). 4,9 de 5 con 1.190 reseñas en Shopify App Store (a fecha de 19 de octubre de 2026).
¿Cómo obtengo una clave de API y hago la primera llamada?
La clave se configura dentro de la app. Las llamadas las hace su desarrollador o su socio de integración, siguiendo las páginas de endpoints de la guía de usuario.
-
Compruebe el plan
La Public API necesita el plan Platinum, o el plan Enterprise en un plan heredado. La clave no se puede crear en otros planes.
-
Abra la tarjeta Public API
En el menú de la app, haga clic en Integrations y busque la tarjeta Public API. Haga clic en Get API key.
-
Genere la clave y guárdela
Genere la clave y haga clic de inmediato en Copy o Download. La app la muestra una sola vez. Trátela como una contraseña: quien la tenga puede leer sus datos B2B y llamar a los endpoints de escritura.
-
Active la función Public API
La página que contiene la clave tiene un control Public API function con un botón Enable. Las solicitudes, de la versión 1 y de la versión 2, se aceptan solo mientras la función está activa.
-
Envíe la clave con cada solicitud
En la versión 1, pase `accessKey` en el cuerpo de la solicitud o el encabezado `x-bss-b2b-api-key`, junto con el `domain` de su tienda. La versión 2 usa el encabezado `x-api-key`. Algunos endpoints de la versión 1 leen la clave solo del cuerpo: los endpoints de carga de Custom Pricing, Volume Pricing y Price List, `PUT /rule/delete-items`, `PUT /pl/delete-items` y `PUT /pl/update-items`. El endpoint de carga de Discount Code lee la clave solo del encabezado `x-bss-b2b-api-key`.
-
Escriba las reglas y luego cárguelas
Cree o actualice reglas con los endpoints de Custom Pricing, Volume Pricing o Price List. Después llame al endpoint de carga del módulo para que las reglas activas lleguen al tema activo.
-
Revise Logs and usage
En la tarjeta Public API, haga clic en Logs and usage. Muestra las solicitudes recientes con su estado, método y ruta, y puede abrir una fila para ver la solicitud y la respuesta completas.
Genere una clave de API y haga su primera llamada con el plan Platinum. La ficha muestra una prueba gratuita de 14 días (planes de pago).
Qué cubre la Public API
Esto es lo que documentan la guía de usuario y el código de la app, agrupado por módulo. La guía de usuario tiene una página con los payloads de los grupos Custom Pricing, Volume Pricing, Price List, Registration Form y carga.
| Módulo | Qué puede hacer | Notas |
|---|---|---|
| Custom Pricing | Obtener reglas por dominio o ID, guardar, guardar en lote, eliminar, eliminar en masa, cargar, y consultar reglas por productos o por clientes. | Versión 1, ruta /rule/*. |
| Volume Pricing | El mismo conjunto que Custom Pricing, sin las consultas por productos y por clientes y sin delete-items. La versión 2 añade GET /vp/rules. | Versión 1, ruta /qb/*. |
| Price List | El conjunto de Custom Pricing más update status, update, delete-items y update-items. | Versión 1, ruta /pl/*. |
| Discount Code | Obtener, crear y eliminar reglas, además de un endpoint de carga. | Versión 1, ruta /dc/*. |
| Registration Form | Obtener el esquema de un formulario, enviar un registro de mayorista, filtrar solicitudes y cambiar el estado de solicitudes pendientes. | Los cambios de estado funcionan solo en cuentas pendientes. Los formularios de varios pasos siempre necesitan un email. |
| Order Limit | Leer las reglas y actualizar una regla. | Versión 1, ruta /ol/*. |
| Clientes, productos, colecciones | Consultar etiquetas de cliente, buscar clientes, obtener clientes por IDs o etiquetas, listar productos y colecciones. | Solo lectura. No puede crear ni editar clientes ni productos mediante la API. |
| Pedidos | No disponible. | No hay endpoint de pedidos. |
Fuente: el código de la Public API de BSS B2B Solution y la guía de usuario de BSS sobre Public APIs, revisados el 9 de octubre de 2026.
Claves, encabezados y versiones de la API
Cada tienda tiene una clave de API. Si ya existe una clave, la app no crea una segunda. Para rotarla, elimine la clave en la tarjeta Public API, lo que detiene de inmediato a todos los clientes que la usan, y luego genere una nueva.
Las dos versiones de la API usan nombres de encabezado distintos. La versión 1 (`/api/v1/...`) lee `x-bss-b2b-api-key`, o `accessKey` en el cuerpo. La versión 2 (`/api/v2/...`) lee `x-api-key`. Si integra varios grupos, compruebe el encabezado en cada endpoint. No envíe la clave como `Authorization: Bearer`. La versión 2 responde a eso con `401 ACCESS_KEY_MISSING`. La versión 1 responde con HTTP 200 y `success: false`, así que lea el campo `success` y no solo el estado HTTP.
- Versión 1: Custom Pricing, Volume Pricing, Price List, Discount Code, Registration Form, Order Limit y consultas.
- Versión 2: GET /vp/rules para Volume Pricing (el endpoint documentado).
- Los resultados parciales de carga también llegan con HTTP 200: compruebe `status` o `success`.
¿Cuáles son los límites de la Public API?
Límite de la versión 2
60 solicitudes por 60 segundos por tienda, con encabezados X-RateLimit. Si se supera, la respuesta es 429.
Carga: una vez cada 5 minutos
Cada endpoint de carga permite una solicitud por módulo cada 5 minutos. Agrupe sus cambios y luego cargue una vez.
Escrituras masivas de una en una
Mientras una llamada de guardado masivo, eliminación masiva, bulk delete, delete-items o update-items se ejecuta para una tienda, otras escrituras masivas en Custom Pricing, Price List y Volume Pricing devuelven 429 con el mensaje de que el dominio está ejecutando otro proceso. Después de un error del servidor, espere hasta 3 minutos.
Límite de almacenamiento en el tema
Las reglas cargadas viven en metafields de Shopify: 10 claves, 2.000.000 de caracteres por clave, unos 20.000.000 en total. Las reglas por encima del límite se omiten y aparecen en un informe partial_success. Solo se cargan las reglas activas.
Sin endpoint de pedidos
La API gestiona reglas, registros y consultas. No puede crear, leer ni cambiar pedidos.
Clientes y productos de solo lectura
Puede buscarlos y leerlos. Para cambiar una etiqueta de cliente por evento, use Auto Tag en la app.
Revise el cuerpo de la respuesta
La versión 1 devuelve HTTP 200 en algunos errores, y las cargas parciales también devuelven 200. Pruebe el campo success en su tarea.
Cómo encaja con el resto de la app
La API escribe los mismos tipos de regla que crea en el admin, así que las reglas de Custom Pricing, Volume Pricing y Price List siguen el orden habitual en el carrito. Las reglas de Price List se revisan primero, luego Custom Pricing, con Volume Pricing encima. Las reglas creadas por la API aparecen en las listas de la app junto a las hechas a mano.
Enviar reglas para compradores etiquetados combina bien con Auto Tag, que añade las etiquetas de cliente a las que apuntan esas reglas. Si su lista de precios cambia unas pocas veces al año, una importación CSV es más sencilla que una integración.
Quién debería usarla
Distribuidores y fabricantes cuyos precios, clases de precio o grupos de clientes ya viven en un ERP, un PIM o un proceso de datos, y que tienen un desarrollador o un socio de integración para escribir una tarea programada. La API encaja con catálogos grandes donde cambiar reglas a mano tarda demasiado.
Si nadie de su lado escribe código, use las pantallas del admin o la importación CSV. La guía de usuario describe la API como un conjunto de herramientas para desarrolladores y socios de integración, no como un conector para un ERP concreto.
¿Qué plan incluye la Public API?
La Public API está en el plan Platinum. En la ficha de la App Store de Shopify, al 9 de octubre de 2026, el plan Platinum cuesta 99 USD al mes, o 1.069,20 USD al año con un 10 % de descuento en la facturación anual. La ficha muestra una prueba gratuita de 14 días en los planes de pago.
Casos de uso de la Public API
Cada caso de uso muestra una configuración con capturas de pantalla. Ver todos los casos de uso.
Sincronizar reglas y clientes B2B con su ERP mediante API
Use la API pública de BSS B2B Solution para crear y actualizar reglas de Custom Pricing, Price List, Volume Pricing y datos de registro desde su ERP o PIM con una clave de API, en lugar de editar las reglas a mano.
Explorar caso de uso: Sincronizar reglas y clientes B2B con su ERP mediante API
Importar precios mayoristas desde CSV
Exporte sus reglas de precio, edite los precios en una hoja de cálculo e importe el archivo de nuevo. El mismo flujo CSV funciona con Custom Pricing, Price Lists y Volume Pricing, así que los catálogos grandes y los muchos grupos de clientes siguen siendo manejables.
Explorar caso de uso: Importar precios mayoristas desde CSVGuías y glosario
Lea después estas páginas para ver todos los detalles.
Auto Tag
Etiquete compradores por evento para que se apliquen las reglas basadas en etiquetas.
Manual Orders
Los pedidos se toman en el admin, no mediante la API.
Precios mayoristas
Muestre a sus clientes comerciales sus propios precios con listas de precios, precios por cliente y precios por escalones.
Incorporación de clientes
Convierta a los interesados en clientes mayoristas aprobados con un formulario de registro, aprobación y etiquetas de cliente.
Glosario
Integración ERPLista de preciosEtiqueta de cliente
Guías de usuario en docs.bss-b2b.solutions
Más funciones de BSS B2B Solution
Cada función tiene su propia página. Vea también todas las funciones de BSS B2B Solution.
Auto Tag
Añada o quite etiquetas de cliente y de pedido cuando un evento de Shopify cumpla sus reglas, para que los precios y accesos por etiqueta sigan al comprador.
Discount Code
Dé a los compradores mayoristas un código privado que introducen en el carrito, con reglas sobre quién puede usarlo, a qué se aplica y con qué frecuencia.
Cargos por manipulación y tarifas de envío
Añada un cargo por manipulación según cantidad o importe, y fije tarifas de envío mayoristas por cliente, producto, mercado y peso.
Manual Orders
Cree un pedido preliminar de Shopify para un cliente en el admin, con sus precios mayoristas ya aplicados.
Visualización multimoneda
Muestre precios mayoristas en la moneda del comprador con un selector. El pago se mantiene en la moneda de su tienda o de Markets.
Precios en Shopify POS
El mosaico B2B Price de Shopify POS muestra el descuento mayorista del carrito. El personal lo aplica o lo quita desde ese mosaico.
Conecte su ERP con sus precios mayoristas
Instale BSS B2B Solution desde la App Store de Shopify, con una prueba gratuita de 14 días (planes de pago).
También: BSS B2B Lock para precios ocultos para invitados y BSS B2B Quote para presupuestos y Quick Order.
Preguntas frecuentes
¿Qué plan incluye la Public API de BSS B2B Solution?
El plan Platinum, o Enterprise en un plan heredado. Al 9 de octubre de 2026, la ficha de la App Store muestra Platinum a 99 USD al mes. Cada tienda tiene una clave de API, que la app muestra solo una vez.
¿Qué puedo enviar a la Public API?
Reglas de Custom Pricing, Volume Pricing, Price List y Discount Code, envíos de formularios de registro y cambios de estado, y actualizaciones de Order Limit. Los clientes, productos y colecciones se pueden leer y buscar, pero no cambiar.
¿Puede la Public API crear o leer pedidos?
No. No hay endpoint de pedidos. La API gestiona reglas de precio, registros y consultas. Para hacer un pedido a un comprador, use Manual Orders en el admin de la app, que crea un pedido preliminar de Shopify con los precios del comprador.
¿Cuáles son los límites de solicitudes?
La versión 2 permite 60 solicitudes por 60 segundos por tienda. Cada endpoint de carga permite una solicitud por módulo cada 5 minutos. Las escrituras masivas de una tienda se ejecutan una a una, y las llamadas adicionales reciben una respuesta 429.
¿Cómo me autentico, y puedo usar un token Bearer?
Envíe la clave como `accessKey` en el cuerpo o en un encabezado: x-bss-b2b-api-key para la versión 1, x-api-key para la versión 2. Los tokens Bearer no se admiten, así que Authorization: Bearer falla con un 401 en la versión 2.
¿Qué hago si pierdo la clave de API o se filtra?
Elimine la clave en la tarjeta Public API. Los clientes que la usan dejan de funcionar de inmediato. Luego genere una clave nueva y cópiela en el momento, porque solo se muestra una vez.
Fuentes, método y registro de cambios
El comportamiento de las funciones se basa en nuestra revisión del código de BSS B2B Solution del 3 de octubre de 2026 y en las guías de usuario de BSS. Los precios y valoraciones proceden de la ficha de la App Store en la fecha indicada. Creamos BSS B2B Solution, BSS B2B Lock y BSS B2B Quote.
Fuentes
- Guía de usuario de BSS: Public APIs, leído . Plan, pasos de la clave, encabezados, límites de uso, registros, límites de metafields.
- Guía de usuario de BSS: Public APIs para carga, leído . Endpoints de carga, capacidad e informe parcial.
- Guía de usuario de BSS: Public APIs para Registration form, leído . Endpoints de formulario y de mayoristas, cambios de estado solo para pendientes.
- Ficha de la App Store de Shopify: BSS B2B Wholesale Pricing, leído . Precios de los planes y prueba gratuita.
Registro de cambios
- : Primera versión.
- : Se añadió un botón de instalación a mitad de página.
Instalar BSS B2B Solution prueba gratuita de 14 días (planes de pago)