Price Checker

Conecte Salesforce Commerce Cloud

El envío automático actualiza sus 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é necesita

Acceso a Salesforce Account Manager para crear un cliente de API.
El código corto (short code), el ID de organización de su instancia y el ID de la lista de precios que quiere 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.

Configure un cliente de API en Account Manager

Inicie sesión en Account Manager con una cuenta de administrador de su organización de Salesforce.
Cree un cliente de API (o reutilice uno reservado para esto) y configure su tipo de concesión (grant type) como client_credentials.
Agregue el rol Salesforce Commerce API al cliente y limite ese rol a su tenant usando su filtro de tenant — restríjalo al realm y la instancia a los que se está conectando.
Otorgue 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.
Guarde el cliente y anote su ID de cliente y su secreto de cliente. Ingresará ambos al conectar.

Encuentre su código corto, ID de organización y lista de precios

Código corto (short code) — un código de 8 caracteres único para su instancia, por ejemplo kv7kzm78. Es la parte que va antes de .api.commercecloud.salesforce.com en el host de API de su instancia. Puede encontrarlo en Business Manager o en las URL que su 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 su 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éntrela en la lista de listas de precios de Business Manager.

Conecte

Vaya a Configuración → Integraciones.
Elija Salesforce Commerce Cloud.
Ingrese su código corto, ID de organización, ID de lista de precios, ID de cliente y secreto de cliente.
Verificamos todo antes de guardar cualquier cosa: solicitamos un token con sus credenciales y luego leemos la lista de precios que indicó. La conexión solo se guarda si ambos pasos tienen éxito — si algo está mal, no se guarda nada y verá exactamente qué corregir.

Una vez conectado, la integración muestra su código corto, ID de organización, lista de precios y su moneda, para que pueda 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 — conecte primero el producto a su 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 sus 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á	Qué significa
El código corto, el ID de organización o el ID de lista de precios no parece correcto	El valor que ingresó no coincide con el formato esperado — verifíquelo de nuevo en Business Manager.
Lista de precios no encontrada	El 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 externos	La lista de precios indicada está basada en feed; elija en su lugar una lista de precios estándar con moneda asignada.
La moneda no coincide	La moneda de la lista de precios no coincide con la moneda de su espacio de trabajo. Conecte una lista de precios en la moneda de su espacio de trabajo, o actualice la moneda de su espacio de trabajo para que coincida.
No se pudieron verificar sus credenciales	Se rechazó el ID/secreto de cliente o el alcance (scope). Confirme 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á	Qué significa
Se requiere reconectar	Sus credenciales, rol o alcance ya no funcionan — reconecte con un cliente de API válido.
Producto no encontrado en la lista de precios	El producto no tiene entrada en esta lista de precios, así que no hay nada que actualizar.
El precio no se puede leer de forma clara	La 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íselo en Business Manager.
Actualización rechazada	Salesforce rechazó la actualización de precio, o la entrada del producto se eliminó desde la última vez que verificamos.
Problema de conexión temporal	Un 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 su 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 necesita reconectarse. Verá un aviso de reconexión en la integración, y los cambios de precio no se aplicarán hasta que lo haga. Como la configuración antigua y la nueva usan clientes de API de Salesforce distintos, esto no se puede migrar de forma automática — siga Configure un cliente de API en Account Manager y Conecte, más arriba, para reconectarse usando SCAPI.

Consejos

Pruebe una conexión nueva con un solo producto de bajo riesgo antes de aprobar un lote completo de recomendaciones a través de ella.
Mantenga el filtro de tenant del cliente de API limitado a la instancia a la que se está conectando — un cliente que abarca varios tenants es más difícil de auditar y rotar.
Si la moneda de su espacio de trabajo cambia alguna vez, reconéctese 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úe explorando

Envíe los precios aceptados a su tienda — cómo funcionan el envío automático y las aprobaciones en todos los conectores.
Configure políticas de precios y límites de seguridad — las reglas que respeta el envío automático.
Invite a su equipo y asigne roles — asigne el rol de aprobador.