Eventos de replicación granular

Disponible en: B2C Commerce versión 26.7 y posteriores.

IDs de eventos

Encabezados HTTP

Los eventos de replicación granular usan los encabezados estándar de plataforma Commerce Cloud documentados en Common HTTP Headers for B2C Commerce Events, con x-sf-cc-event-id configurado al ID granular del evento de replicación (por ejemplo, sf.cc.replication.granular.completed).

Estructura de carga útil JSON — campos comunes

Campos específicos de eventos

Estados granulares del proceso

El campo de estado indica el estado final del trabajo de replicación granular.

Cubos de objetos

Los campos de carga útil de objetos, successfulObjects y failedObjects comparten la misma estructura de tres cubos, uno por cada tipo rastreable.

Las entradas exitosas (en objetos y successfulObjects) contienen una cadena id. Las entradas fallidas (en failedObjects) contienen una cadena de id y un código de estado legible por la máquina.

Valores de estado de falla

El campo de estado en cada entrada failedObjects contiene un código legible por máquina.

Nota NOT_INVALIDATED objetos no aparecen en failedObjects. Cuando un objeto se importa con éxito pero el paso de invalidación de caché no termina, el objeto sigue siendo reportado en las listas de éxito (objetos o successfulObjects). Un conteo no invalidado a nivel de trabajo distinto de cero es lo que hace que el trabajo emita un evento sf.cc.replication.granular.incomplete en lugar de un evento completado.

Ejemplo: evento exitoso de replicación granular

{
"processId": 456,
"type": "GRANULAR",
"Sistemaobjetivo": "Producción",
"Estado": "COMPLETADO",
"éxito": true,
"objects": {
"products": [
{ "id": "prod-001" }
],
"priceTables": [
{ "id": "prod-001@usd-prices" }
],
"contentAssets": []
},
"startDate": "2026-03-11T22:13:20Z",
"finFecha": "2026-03-11T22:13:25Z"
}

Ejemplo: evento fallido de replicación granular

{
"processId": 456,
"type": "GRANULAR",
"Sistemaobjetivo": "Producción",
"Estado": "REPROBADO",
 "éxito": falso,
 "errorEstado": "GRANULAR_REPLICATION_FAILURE",
"failedObjects": {
"products": [
{ "id": "prod-001", "status": "TARGET_ERROR" }
],
"TablasPrecio": [],
"ActivosDeContenido": []
},
"FechaInicio": "2026-03-11T22:13:20Z",
"finFecha": "2026-03-11T22:13:25Z"
}

Ejemplo: evento de replicación granular incompleta

{
"processId": 456,
"type": "GRANULAR",
"Sistemaobjetivo": "Producción",
"Estado": "INCOMPLETO",
 "éxito": falso,
 "errorEstado": "GRANULAR_REPLICATION_INCOMPLETE",
"successfulObjects": {
"products": [
{ "id": "prod-001" }
],
"priceTables": [
{ "id": "prod-001@usd-prices" }
],
"contentAssets": []
},
"failedObjects": {
"products": [
{ "id": "prod-002", "status": "IMPORT_ERROR" }
],
"Tablas de precios": [
{ "id": "prod-003@eur-prices", "status": "NOT_FINISHED" }
],
"contentAssets": []
},
"startDate": "2026-03-11T22:13:20Z",
"finFecha": "2026-03-11T22:13:25Z"
}

Notas de implementación de replicación granular

• el tipo es la cadena literal GRANULAR; el flujo de replicación granular por objeto es distinto de los tipos de eventos de Replicación, Publicación y Código * a nivel de proceso.
• processId es el ID de ejecución granular del trabajo de replicación, no un UUID de proceso.
• EndDate refleja cuándo se emitió el evento, no la hora final del trabajo.
• errorState es GRANULAR_REPLICATION_FAILURE para eventos fallidos y GRANULAR_REPLICATION_INCOMPLETE para eventos incompletos.
• Cada cubo de objetos (productos, priceTables, contentAssets) está siempre presente en la carga útil, incluso cuando está vacío.
• Los valores de estado de falla son códigos legibles por máquina, no texto localizado.
• Cada tipo de evento está limitado tanto por la propiedad global de evento de replicación como por un interruptor de función por evento (uno para los eventos completados, fallidos e incompletos). Si alguno de los dos está deshabilitado, el evento no se envía.