Usted estĆ” aquĆ:
ConfiguraciĆ³n de eventos en B2C Commerce (piloto)
Use eventos en B2C Commerce para recibir notificaciones cuando ocurran ciertos datos o eventos de procesamiento en su entorno de Commerce Cloud. Los tipos de eventos y los conectores se habilitan en Business Manager; B2C Commerce enruta los eventos directamente a los conectores configurados.
Ediciones necesarias
| Disponible en: B2C Commerce |
Los eventos proporcionan notificaciones cuando se producen cambios especĆficos en B2C Commerce para que pueda activar procesos comerciales en sistemas externos, por ejemplo, invalidar la cachĆ© fuera de la plataforma, sincronizar datos con sistemas externos de bĆŗsqueda o pedidos, o ejecutar flujos de trabajo posteriores de pedidos o marketing. Ayuda a mantener la precisiĆ³n de los escaparates, reduce el seguimiento manual de cuĆ”ndo se completan las operaciones de la plataforma y desacopla la lĆ³gica empresarial de las operaciones de la plataforma. Esto es especialmente Ćŗtil para implementaciones de escaparates hĆbridos o sin encabezado. Los eventos estĆ”n pensados para desarrolladores de clientes y comerciantes que reaccionan a los eventos de la plataforma.
La creaciĆ³n de eventos admite dos casos de uso principales: notificar a sus propios sistemas (o servicios externos) cuando se producen eventos de datos o procesamiento en B2C Commerce y notificar a otros servicios de Commerce Cloud. B2C Commerce entrega eventos solo a los destinos que usted configure. Para el piloto, no hay un bus de eventos separado; B2C Commerce enruta los eventos directamente a los conectores configurados (como webhooks) desde la plataforma.
Habilite los tipos de eventos que le interesen para su inquilino y, a continuaciĆ³n, configure uno o mĆ”s conectores, por ejemplo, una URL de webhook, en Business Manager. Cuando se produce un evento habilitado, B2C Commerce lo envĆa de forma asincrĆ³nica a cada conector configurado. Solo se envĆan los tipos de eventos habilitados y solo a los conectores que configure. Si no configura ningĆŗn conector para un tipo de evento, no se envĆan notificaciones para ese tipo.
Tipos de eventos: el marco admite eventos de datos y eventos de procesamiento. Para el Ć”mbito piloto actual, los tipos de eventos iniciales son eventos de procesamiento de replicaciĆ³n. Los dos tipos de eventos de replicaciĆ³n estĆ”n disponibles con la versiĆ³n 26.6 de B2C Commerce.
| Id. de evento | DescripciĆ³n | Cuando se despide |
|---|---|---|
sf.cc.replication.completed |
ReplicaciĆ³n completada con Ć©xito | Cuando un proceso de replicaciĆ³n alcanza el estado COMPLETADO |
sf.cc.replication.failed |
Error de replicaciĆ³n | Cuando un proceso de replicaciĆ³n alcanza el estado FAILED |
Encabezados HTTP: todos los eventos de replicaciĆ³n incluyen encabezados estĆ”ndar de la plataforma Commerce Cloud.
| Encabezado | DescripciĆ³n | Ejemplo |
|---|---|---|
X-SF-CC-TIMESTAMP |
Marca de tiempo ISO-8601 cuando se generĆ³ el evento | 2026-03-11T13:31:13.755934395Z |
x-sf-cc-id-de-instancia |
Identificador de instancia (minĆŗscula) | zzzz_prd |
x-sf-cc-site-id |
Identificador del sitio (vacĆo para operaciones a nivel de organizaciĆ³n) | RefArch o "" |
x-sf-cc-correlation-id |
ID de correlaciĆ³n para el seguimiento entre sistemas | 550E8400-E29B-41D4-A716-446655440000 |
x-sf-cc-event-id |
Identificador de tipo de evento | sf.cc.replication.completed |
Estructura de carga JSON: todos los eventos de replicaciĆ³n incluyen estos campos comunes.
| Campo | Tipo | Obligatorio | DescripciĆ³n |
|---|---|---|---|
processId | string | SĆ | Identificador Ćŗnico para el proceso de replicaciĆ³n |
UUID | string | SĆ | UUID del proceso de replicaciĆ³n |
type | string | SĆ | Tipo de proceso de replicaciĆ³n (consulte Tipos de procesos) |
targetSystem | string | SĆ | Nombre del sistema de destino, normalmente Desarrollo o ProducciĆ³n |
Estado | string | SĆ | Estado actual del proceso (consulte Estados del proceso) |
isDataReplication | boolean | SĆ | verdadero para la replicaciĆ³n de datos, falso para la replicaciĆ³n de cĆ³digo |
Ćxito | boolean | SĆ | verdadero para eventos completados, falso para eventos fallidos |
description | string | No | DescripciĆ³n proporcionada por el usuario del proceso de replicaciĆ³n |
codeVersion | string | No | Identificador de versiĆ³n de cĆ³digo para replicaciones de cĆ³digo |
replicationGroups | Matriz | SĆ | Lista de grupos de replicaciĆ³n incluidos (consulte Grupos de replicaciĆ³n) |
Fecha de inicio | string | SĆ | Marca de tiempo ISO-8601 cuando se iniciĆ³ el proceso |
fecha de finalizaciĆ³n | string | SĆ | Marca de tiempo ISO-8601 cuando finalizĆ³ el proceso |
Campo especĆfico del error: los eventos fallidos (sf.cc.replication.failed) incluyen errorState, un cĆ³digo de estado de error legible por mĆ”quina.
Tipos de proceso: el campo de tipo indica la operaciĆ³n de replicaciĆ³n.
| Valor de replicaciĆ³n de datos | DescripciĆ³n |
|---|---|
ReplicationPublication (ReplicaciĆ³nPublication) | Transferencia de datos y publicaciĆ³n inmediata |
ReplicaciĆ³n | Solo transferencia de datos (replicaciĆ³n en dos etapas) |
PublicaciĆ³n | PublicaciĆ³n de datos transferidos previamente |
Deshacer | Deshacer una replicaciĆ³n anterior |
| Valor de replicaciĆ³n de cĆ³digo | DescripciĆ³n |
|---|---|
CodeReplicationPublication | Transferencia de cĆ³digo y publicaciĆ³n inmediata |
ReplicaciĆ³n de cĆ³digo | Solo transferencia de cĆ³digo |
CodePublication | PublicaciĆ³n de cĆ³digo transferido previamente |
CodeUndo | Deshacer una replicaciĆ³n de cĆ³digo anterior |
Estados del proceso: el campo Estado indica el estado del proceso.
| Valor | DescripciĆ³n |
|---|---|
ESPERANDO | El proceso estĆ” creado y listo para comenzar |
INICIALIZACIĆN | El proceso se estĆ” preparando para ejecutarse |
CORRER | El proceso estĆ” en curso |
FINALIZANDO | El proceso estĆ” finalizando |
COMPLETADO | Proceso completado con Ć©xito |
FALLĆ | Error en el proceso |
CANCELED estĆ” en desuso y no deberĆa aparecer en eventos nuevos.Grupos de replicaciĆ³n: la matriz replicationGroups describe lo que se ha replicado.
| Campo | Tipo | Obligatorio | DescripciĆ³n |
|---|---|---|---|
identificaciĆ³n | string | SĆ | Identificador de grupo legible por mĆ”quina |
type | string | SĆ | Alcance del grupo: ORGANIZACIĆN, SITIO o REPOSITORIO |
Dominio | string | No | Nombre de dominio para grupos con Ɣmbito de repositorio |
Identificadores de grupo a nivel de organizaciĆ³n
| IdentificaciĆ³n | DescripciĆ³n |
|---|---|
ORGANIZATION_CATALOG | Todos los catƔlogos |
ORGANIZATION_CATALOG_STATIC | Contenido estƔtico para todos los catƔlogos |
ORGANIZATION_CSC_SETTINGS | ConfiguraciĆ³n de Customer Service Center |
ORGANIZATION_CSRF_WHITELIST_PIPELINES | Nodos de inicio/pipeline de la lista permitida de CSRF |
ORGANIZATION_CUSTOMERLIST | Todas las listas de clientes |
ORGANIZATION_CUSTOM_OBJECT | Objetos personalizados de la organizaciĆ³n |
ORGANIZATION_TYPE_DEFINITION | Tipos de objetos personalizados y extensiones del sistema |
ORGANIZATION_REFERENCE_DATA | Datos de geolocalizaciĆ³n |
ORGANIZATION_LIBRARY | Todas las bibliotecas compartidas |
ORGANIZATION_OAUTH_PROVIDERS | Proveedores de OAuth |
ORGANIZACIĆN_OCAPI_CONFIGURACIĆN | ConfiguraciĆ³n de OCAPI global |
ORGANIZATION_PAGE_META_TAGS | Definiciones de la etiqueta META de la pƔgina |
ORGANIZATION_PREFERENCE | Preferencias de la organizaciĆ³n |
ORGANIZATION_PREFERENCE_CUSTOM | Solo preferencias personalizadas |
ORGANIZATION_PREFERENCE_SYSTEM | Solo preferencias del sistema |
ORGANIZATION_PRICE_BOOK | Todos los libros de precios |
ORGANIZATION_SITE | Todos los sitios |
ORGANIZATION_STATIC_CONTENT | Contenido estƔtico global |
ORGANIZATION_WEBDAV_CLIENT_PERMISSIONS | Permisos del cliente de WebDAV |
ORGANIZATION_SORTING | Reglas de clasificaciĆ³n globales |
ORGANIZATION_PAYMENTS_CONFIG | ConfiguraciĆ³n de pagos |
ORGANIZATION_ASSIGNMENT | Asignaciones y calificadores |
Identificaciones de grupo a nivel de sitio
| IdentificaciĆ³n | DescripciĆ³n |
|---|---|
SITE_ABTEST | Experiencias y tests A/B |
SITE_ABTEST_ONLY | Solo Tests A/B |
SITE_ACTIVEDATAFEED | Definiciones de fuentes de datos activos |
SITE_CACHE_SETTINGS | ConfiguraciĆ³n de cachĆ© |
SITE_CONTENT | Biblioteca de contenido |
SITE_COUPON | Cupones |
SITE_CUSTOMER_GROUP | Grupos de clientes |
SITE_CUSTOM_OBJECT | Objetos personalizados especĆficos del sitio |
SITE_DYNAMIC | Contenido dinƔmico |
SITIO_OCAPI_CONFIGURACIĆN | ConfiguraciĆ³n de OCAPI del sitio |
SITE_PAYMENT_METHOD | ConfiguraciĆ³n de pago |
SITE_PREFERENCE | Preferencias del sitio |
SITE_PREFERENCE_SYSTEM | Preferencias del sistema del sitio |
SITE_PREFERENCE_CUSTOM | Preferencias personalizadas del sitio |
SITE_PROMOTION | CampaƱas y promociones |
SITE_SEARCH_INDEX | Ćndices de bĆŗsqueda |
SITE_SHIPPING_METHOD | MĆ©todos de envĆo |
SITE_SLOT | Slots de contenido |
SITE_SORTING | ClasificaciĆ³n especĆfica del sitio |
SITE_SOURCECODE | CĆ³digos fuente |
SITE_STORE | mejor nota |
SITE_TAX | ConfiguraciĆ³n de impuestos |
SITE_URL | URL de Storefront |
SITE_URL_CATEGORY | URL de catƔlogos |
SITE_URL_FOLDER | URL de contenido |
SITE_URL_PIPELINE | URL del pipeline |
SITE_URL_REDIRECT | Redireccionamientos de URL |
Identificadores de grupo a nivel de repositorio
| IdentificaciĆ³n | DescripciĆ³n |
|---|---|
CATĆLOGO | CatĆ”logo especĆfico (el dominio contiene el nombre del catĆ”logo) |
CATALOG_STATIC | Contenido estĆ”tico del catĆ”logo especĆfico |
SITIO | Sitio especĆfico (el dominio contiene el nombre del sitio) |
BIBLIOTECA | Biblioteca especĆfica (el dominio contiene el nombre de la biblioteca) |
PRICE_BOOK | Libro de precios especĆfico (el dominio contiene el nombre del libro de precios) |
Estados de error: los eventos fallidos incluyen valores errorState legibles por mƔquina.
| Valor | DescripciĆ³n |
|---|---|
ERROR_INITIALIZATION | No se pudo inicializar el proceso de replicaciĆ³n |
ERROR_STAGING_PROCESS_CREATION | No se pudo crear el proceso de ensayo |
ErrorInternalLive | Error interno en el sistema de destino |
ErrorInternalEdit | Error interno en el sistema de origen |
ErrorNonStagedParentSites | El contenido seleccionado pertenece a sitios que aĆŗn no se han replicado |
ErrorConnectLiveSystem | No se pudo conectar al sistema de destino |
ErrorCreatingLiveStagingProcess | No se pudo inicializar el proceso en el sistema de destino |
ErrorExecutingEditingStagingPipeline | Error interno en la canalizaciĆ³n del sistema de origen |
ErrorLiveStagingProcessKilled | Proceso anulado en el sistema de destino |
ErrorEditingStagingProcessKilled | Proceso anulado en el sistema de origen |
ErrorStagingProcessCancelled | El proceso fue cancelado |
NoStagingProcessCreated | No se pudo inicializar el proceso |
ErrorStagingProcessModeNotSupported | No se admite el modo de proceso |
ErrorTableLocked | Tabla de base de datos bloqueada |
ErrorInitializingStagingProcessors | No se pudieron inicializar los procesadores |
ErrorCallingLivePipeline | Error en la conexiĆ³n con el sistema de destino |
ErrorSynonymState | Estado interno crĆtico no vĆ”lido en el destino |
ErrorAcquiringEditingLocks | No se pudieron adquirir bloqueos en el sistema de origen |
ErrorAcquiringLiveLocks | No se pudieron adquirir bloqueos en el sistema de destino |
ErrorPreparation (PreparaciĆ³n de errores) | Error de preparaciĆ³n en el sistema de origen |
ErrorRefreshCache | Error en la actualizaciĆ³n de cachĆ© en el sistema de destino |
ReplicaciĆ³n de errores | Error en la transferencia de datos al sistema de destino |
ErrorPublication | Error en la publicaciĆ³n de los datos transferidos |
Configurar tipos de eventos
DespuĆ©s de configurar los conectores, revise y habilite los tipos de eventos para el inquilino. Las siguientes cargas Ćŗtiles de ejemplo muestran los datos de eventos que recibe el conector para eventos de replicaciĆ³n de cĆ³digo y completados.
Evento de replicaciĆ³n correcto
{
"eventType": "sf.cc.replication.completed",
"timestamp": "2026-03-11T13:31:13.755934395Z",
"tenantId": "zzzz_stg",
"payload": {
"processId": "12345",
"uuid": "550E8400-E29B-41D4-A716-446655440000",
"Tipo": "ReplicationPublication",
"targetSystem": "ProducciĆ³n",
"Estado": "COMPLETED",
"isDataReplication": true,
"success": true,
"description": "ActualizaciĆ³n semanal del catĆ”logo",
"replicationGroups": [
{
"id": "ORGANIZATION_CATALOG",
"type": "ORGANIZATION"
},
{
"id": "CATĆLOGO",
"tipo": "REPOSITORY",
"domain": "storefront-catalog-m-en"
}
],
"startDate": "2026-03-11T13:31:03Z",
"endDate": "2026-03-11T13:31:13.727Z"
}
}
Evento de replicaciĆ³n fallido
{
"eventType": "sf.cc.replication.failed",
"timestamp": "2026-03-11T14:22:18.442Z",
"tenantId": "zzzz_prd",
"payload": {
"processId": "12346",
"uuid": "660E8400-E29B-41D4-A716-446655440001",
"Tipo": "ReplicaciĆ³n",
"targetSystem": "ProducciĆ³n",
"Estado": "FAILED",
"isDataReplication": true,
"success": false,
"description": "ActualizaciĆ³n de contenido de emergencia",
"errorState": "ErrorConnectLiveSystem",
"replicationGroups": [
{
"id": "SITE_CONTENT",
"type": "SITIO"
},
{
"id": "SITIO",
"tipo": "REPOSITORIO",
"dominio": "RefArch"
}
],
"startDate": "2026-03-11T14:22:15Z",
"endDate": "2026-03-11T14:22:18.442Z"
}
}
Evento de replicaciĆ³n de cĆ³digo
{
"eventType": "sf.cc.replication.completed",
"timestamp": "2026-03-11T15:05:32.118Z",
"tenantId": "zzzz_prd",
"payload": {
"processId": "12347",
"uuid": "770E8400-E29B-41D4-A716-446655440002",
"Tipo": "CodeReplicationPublication",
"targetSystem": "Desarrollo",
"Estado": "COMPLETED",
"isDataReplication": false,
"success": true,
"codeVersion": "version1",
"replicationGroups": [],
"startDate": "2026-03-11T15:00:00Z",
"endDate": "2026-03-11T15:05:32.118Z"
}
}
Notas de implementaciĆ³n
- Todas las marcas de tiempo utilizan el formato ISO-8601 con indicador de zona horaria.
- Las identificaciones de instancia se normalizan a minĆŗsculas.
- La identificaciĆ³n del sitio estĆ” vacĆa para las operaciones de nivel de organizaciĆ³n (los procesos de replicaciĆ³n son de nivel de organizaciĆ³n).
- El campo
de descripciĆ³nes texto opcional proporcionado por el usuario. - Una matriz
replicationGroupsvacĆa indica replicaciĆ³n de solo cĆ³digo. - Los estados de error son cĆ³digos legibles por mĆ”quina, no texto localizado.
Conectores: Los conectores son los destinos a los que B2C Commerce envĆa notificaciones de eventos (por ejemplo, un webhook HTTP a una URL que usted proporciona). La entrega es asincrĆ³nica a travĆ©s de un componente interno de envĆo de eventos casi en tiempo real. Para el piloto, la plataforma garantiza la entrega en el mejor esfuerzo. MĆ”s allĆ” de la prueba piloto, Salesforce planea agregar mecanismos para reintentos y un manejo de errores mĆ”s sĆ³lido. Los controles de autenticaciĆ³n y seguridad rigen el acceso a los eventos. Solo los tipos de eventos habilitados generan notificaciones, y los eventos se envĆan solo a los conectores que ha configurado. El diseƱo actual utiliza un modelo de empuje: B2C Commerce inicia la solicitud HTTP a su punto de conexiĆ³n. Confirme que el punto de conexiĆ³n devuelve una respuesta correcta (por ejemplo, HTTP 200) cuando haya aceptado y procesado el evento. Para obtener mĆ”s informaciĆ³n sobre el conector de B2C Commerce, consulte Conector de B2C Commerce.
Para configurar los eventos, realice los siguientes pasos:
-
En Business Manager, abra el Ć”rea de eventos o integraciones (la ruta puede variar segĆŗn la versiĆ³n).
Agregue la informaciĆ³n requerida para un conector (webhook) en el que desea que B2C Commerce entregue notificaciones de eventos. Configure mĆ”s de un conector para que los diferentes eventos se envĆen a diferentes sistemas:
- URL ā URL: introduzca la URL completa del punto de conexiĆ³n (por ejemplo, ). Commerce Cloud requiere acceso al punto de conexiĆ³n; configure reglas de firewall para permitir que Commerce Cloud llame a su URL. Marcador de posiciĆ³n: ejemplo de solicitud HTTP que recibe tu webhook. ReemplĆ”celo con una muestra real cuando estĆ© disponible. POST /events HTTP/1.1 Host: your-system.example.com Tipo de contenido: application/json
- AutenticaciĆ³n: si su punto final requiere autenticaciĆ³n, configure el mĆ©todo (por ejemplo, clave de API, OAuth o seguridad mutua de la capa de transporte (TLS)) y las credenciales o tokens segĆŗn lo proporcionado por la interfaz de usuario de Business Manager. Almacene las credenciales de forma segura. No los compartas.
-
Encabezados: si su punto de conexiĆ³n espera encabezados HTTP especĆficos (por ejemplo, un encabezado de clave de API personalizado), configĆŗrelos en la configuraciĆ³n del conector. La plataforma puede agregar automĆ”ticamente encabezados estĆ”ndar (por ejemplo,
Content-Type: application/json).
-
Revise la lista de tipos de eventos disponibles y sus descripciones.
-
Para cada tipo de evento que desee usar, habilĆtelo para su inquilino.
Solo los tipos de eventos habilitados generan notificaciones; Los tipos deshabilitados no envĆan eventos. Habilite o deshabilite los tipos de eventos en cualquier momento. Simplemente especifique el conector existente deseado (webhook) para el tipo de evento que le interese. Nota: Solo puede elegir entre un webhook existente al habilitar un tipo de evento, asĆ que asegĆŗrese de que el paso 1 estĆ© completo antes de esto.Guarde los cambios.
Use el Log Center de B2C Commerce para monitorear y diagnosticar problemas de entrega o de punto de conexiĆ³n. Consulte Log Center.
