Agnotiq MarginTide Pricing Intelligence
Empezar
Centro de ayuda
Price Checker

Conecta Salesforce Commerce Cloud

El envío automático actualiza tus precios de Salesforce B2C Commerce a través de la API de Commerce actual de Salesforce (SCAPI) — específicamente la API de administración de listas de precios (Price Books Admin API). La antigua API de datos de la que dependía esto ya no está disponible y no puede escribir precios, así que ahora toda conexión usa SCAPI.

Qué necesitas

  • Acceso a Salesforce Account Manager para crear un cliente de API.
  • El código corto (short code), el ID de organización de tu instancia y el ID de la lista de precios que quieres que el envío automático actualice.
  • El plan Max o Enterprise — el envío automático de Salesforce Commerce Cloud, como los demás conectores de plataforma, está disponible en Max y Enterprise.

Configura un cliente de API en Account Manager

  1. Inicia sesión en Account Manager con una cuenta de administrador de tu organización de Salesforce.
  2. Crea un cliente de API (o reutiliza uno reservado para esto) y configura su tipo de concesión (grant type) como client_credentials.
  3. Agrega el rol Salesforce Commerce API al cliente y limita ese rol a tu tenant usando su filtro de tenant — restríngelo al realm y la instancia a los que te estás conectando.
  4. Otorga al cliente el alcance (scope) sfcc.price-books.rw. Es el único alcance que necesita el envío automático: puede leer y actualizar entradas de listas de precios, y nada más.
  5. Guarda el cliente y anota su ID de cliente y su secreto de cliente. Ingresarás ambos al conectar.

Encuentra tu código corto, ID de organización y lista de precios

  • Código corto (short code) — un código de 8 caracteres único para tu instancia, por ejemplo kv7kzm78. Es la parte que va antes de .api.commercecloud.salesforce.com en el host de API de tu instancia. Puedes encontrarlo en Business Manager o en las URL que tu equipo de Salesforce ya usa para esta instancia.
  • ID de organización — tiene una forma como f_ecom_zzte_053 (un código de realm/instancia de comercio electrónico, con prd, stg, dev o un sufijo de sandbox numerado). Business Manager muestra esto junto con los demás datos de tu instancia.
  • ID de lista de precios — el ID de la lista de precios cuyos precios debe actualizar el envío automático. Debe ser una lista de precios estándar con una moneda asignada — no una lista de precios basada en feed, que no admite escritura de entradas individuales. Encuéntrala en la lista de listas de precios de Business Manager.

Conecta

  1. Ve a Configuración → Integraciones.
  2. Elige Salesforce Commerce Cloud.
  3. Ingresa tu código corto, ID de organización, ID de lista de precios, ID de cliente y secreto de cliente.
  4. Verificamos todo antes de guardar cualquier cosa: solicitamos un token con tus credenciales y luego leemos la lista de precios que indicaste. La conexión solo se guarda si ambos pasos tienen éxito — si algo está mal, no se guarda nada y verás exactamente qué corregir.

Una vez conectado, la integración muestra tu código corto, ID de organización, lista de precios y su moneda, para que puedas confirmar que apunta a la instancia correcta.

Qué precios puede actualizar el envío automático

El envío automático actualiza un precio por producto en la lista de precios elegida — un monto único y sin fecha de vencimiento, sin niveles por cantidad, sin rango de fechas y sin descuento porcentual. Esa es la forma que tiene un "precio actual" sencillo en el modelo de listas de precios de Salesforce.

  • Si la entrada de un producto en la lista de precios ya tiene esa forma simple, el envío automático puede leerla y actualizarla.
  • Si un producto aún no tiene entrada en la lista de precios, el envío automático no puede crear una — conecta primero el producto a tu lista de precios en Business Manager.
  • Si la entrada de un producto usa precios por cantidad, un cambio de precio programado o un descuento porcentual, el envío automático la deja tal cual y la marca, en lugar de arriesgarse a sobrescribir tus otras reglas de precios.
  • Las variantes de producto tienen sus propias entradas en la lista de precios, así que el precio de cada variante se lee y se escribe de forma independiente al de su producto principal.

Solución de problemas

Al conectar:

Lo que verásQué significa
El código corto, el ID de organización o el ID de lista de precios no parece correctoEl valor que ingresaste no coincide con el formato esperado — verifícalo de nuevo en Business Manager.
Lista de precios no encontradaEl ID de la lista de precios no existe para esta organización, o el cliente de API no puede verla.
La lista de precios usa precios externosLa lista de precios indicada está basada en feed; elige en su lugar una lista de precios estándar con moneda asignada.
La moneda no coincideLa moneda de la lista de precios no coincide con la moneda de tu espacio de trabajo. Conecta una lista de precios en la moneda de tu espacio de trabajo, o actualiza la moneda de tu espacio de trabajo para que coincida.
No se pudieron verificar tus credencialesSe rechazó el ID/secreto de cliente o el alcance (scope). Confirma que el cliente usa la concesión (grant) client_credentials, que tiene el rol Salesforce Commerce API limitado a este tenant, y que tiene el alcance sfcc.price-books.rw.

Ya conectado, en cambios de precio individuales:

Lo que verásQué significa
Se requiere reconectarTus credenciales, rol o alcance ya no funcionan — reconecta con un cliente de API válido.
Producto no encontrado en la lista de preciosEl producto no tiene entrada en esta lista de precios, así que no hay nada que actualizar.
El precio no se puede leer de forma claraLa entrada del producto en la lista de precios tiene niveles por cantidad, un rango de fechas o un descuento porcentual, así que no hay un precio único que actualizar automáticamente — revísalo en Business Manager.
Actualización rechazadaSalesforce rechazó la actualización de precio, o la entrada del producto se eliminó desde la última vez que verificamos.
Problema de conexión temporalUn problema de red o del lado de Salesforce interrumpió la solicitud. Por lo general es seguro intentarlo de nuevo en un momento.

Reconectar desde OCAPI

Si tu conexión de Salesforce Commerce Cloud se configuró antes de esta actualización, todavía usa la antigua API de datos que ya no está disponible y necesitas reconectarte. Verás un aviso de reconexión en la integración, y los cambios de precio no se aplicarán hasta que lo hagas. Como la configuración antigua y la nueva usan clientes de API de Salesforce distintos, esto no se puede migrar de forma automática — sigue Configura un cliente de API en Account Manager y Conecta, más arriba, para reconectarte usando SCAPI.

Consejos

  • Prueba una conexión nueva con un solo producto de bajo riesgo antes de aprobar un lote completo de recomendaciones a través de ella.
  • Mantén el filtro de tenant del cliente de API limitado a la instancia a la que te estás conectando — un cliente que abarca varios tenants es más difícil de auditar y rotar.
  • Si la moneda de tu espacio de trabajo cambia alguna vez, reconéctate con una lista de precios en la nueva moneda; una moneda que no coincide bloquea los cambios de precio en lugar de escribir el monto equivocado.

Continúa explorando