system-objecttype-extensions-HW

Fichero de metadatos SFCC que extiende (type-extension) los tipos de objeto estándar del sistema. A diferencia de los Custom Object Types, estas extensiones añaden atributos a objetos que SFCC ya gestiona (pedidos, cestas, categorías, productos, etc.).

Atributos de sistema vs. personalizados

Cada extensión puede incluir system-attribute-definitions (configuración de UI para atributos estándar de SFCC) y custom-attribute-definitions (atributos nuevos propios del proyecto). Esta página se centra en los atributos personalizados y en los enums relevantes de atributos de sistema.

---

Resumen de extensiones

Tipo extendido	Attrs. personalizados	Propósito principal
Appeasement	—	Enums de reasonCode y status.
AppeasementItem	—	UI para líneas de compensación.
Basket	19	Pasarelas de pago, suscripción, identificación.
BonusDiscountLineItem	1	UUID del producto qualifying del bonus.
Campaign	—	UI para campañas.
Catalog	—	UI para catálogos.
Category	11	Assets PLP, hreflang, crawling, banners.
CategoryAssignment	—	UI para asignaciones de categoría.
Content	2	Body HTML localizable y hreflang.
Coupon	—	Enum de type.
CouponLineItem	—	UI para líneas de cupón.
CustomerActiveData	1	returnItems (artículos devueltos).
CustomerAddress	4	Email, prefijo tel., NIF/NIE, PayPal.
CustomerCDPData	—	Segmentos CDP.
CustomerGroup	—	UI para grupos de clientes.
CustomerPaymentInstrument	—	UI para instrumentos de pago.
Folder	—	UI para carpetas de biblioteca.
GiftCertificate	—	UI para vales regalo.
GiftCertificateLineItem	—	UI para líneas de vale regalo.
Invoice	—	Enums de status y type.
InvoiceItem	—	UI para líneas de factura.
Library	—	Integración Salesforce CMS.
Order	64	COD, GDPR, tracking, Klarna, Stripe, SSC, Mercado Pago, Multibanco, OXXO.
OrderAddress	4	Email, prefijo tel., isStore.
OrderItem	—	Enums de status y type.
OrderPaymentInstrument	26	Klarna, PayPal, Mercado Pago, Stripe.
OrganizationPreferences	5	Hreflang, locales, feeds de producto, sitemaps.
PaymentCard	—	UI solo.
PaymentMethod	1	stripe_pmc_configuration_id.
PaymentTransaction	19	Auth, Stripe, Klarna, historial.
PriceAdjustment	—	Enum de reasonCode.
PriceBook	—	UI solo.
Product	90+	Apparel, badges, colaboraciones, Creative, frame, lens, imagen, label, subtipo, tipo, promociones, suscripciones, medidas físicas, scores, Trustpilot, SEO.
ProductActiveData	—	Solo system attrs (UI). Datos de tráfico, conversión, precios y antigüedad.
ProductInventoryList	—	Solo system attrs (UI).
ProductInventoryRecord	—	Solo system attrs (UI).
ProductLineItem	12	Prescripción óptica, Creative composable, lentillas, suscripción, tipo de producto, pre-order.
ProductList	—	Solo system attrs (UI).
ProductListItem	—	Solo system attrs (UI).
ProductListItemPurchase	—	Solo system attrs (UI).
ProductListRegistrant	—	Solo system attrs (UI).
Profile	18	GDPR, TaxJar, SSC, Stripe, país, tienda, suscripción, PayPal.
Promotion	13	Label visual (fondo, texto, color), approaching promotion, applied promotion, product label.
Recommendation	—	Solo system attrs (UI).
Return	2	exportStatus, refundStatus.
ReturnCase	7	Razón de devolución, step de flujo, refund, importe, SSC case number.
ReturnCaseItem	1	desiredPrice.
ReturnItem	—	Solo system attrs (UI).
ServiceConfig	—	Solo system attrs (UI).
ServiceCredential	8	Credenciales PayPal, SSC (clientid/secret), Worldcoo.
ServiceProfile	—	Solo system attrs (UI).
Shipment	10	TaxJar sync, pickup en tienda, punto de recogida, tracking.
ShippingLineItem	—	Solo system attrs (UI).
ShippingMethod	8	Tiempo estimado de entrega, formato de fecha, pickup en tienda, mensaje de horas.
ShippingOrder	—	Solo system attrs (UI).
ShippingOrderItem	—	Solo system attrs (UI).
SitePreferences	100+	GTM, PayPal, TaxJar, Klarna VCN/Payments, Stripe (APM, Payment Elements, VCN), Mercado Pago, Marketing Cloud, Einstein, Trustpilot, Fittingbox VTO, Subpro, Foursixty, PDP/PLP assets, emails devoluciones, tiendas físicas, SFRA plugins, DebugBear, Google Places/reCaptcha, Worldcoo, SSC, accesibilidad, checkout. 38 grupos en BM.
SlotConfiguration	—	Solo system attrs (UI). Enum de rank (10–100, defecto 50).
SourceCodeGroup	—	Solo system attrs (UI).
Store	6	Google My Business URL, countryCodeValue, pickup enabled, óptica, booking Outlook, inventoryListId.
StoreGroup	—	Solo system attrs (UI).
TrackingInfo	—	Solo system attrs (UI).
TrackingRef	—	Type-extension vacío.

---

Appeasement y AppeasementItem

No añaden atributos personalizados. Configuran enums del sistema.

reasonCode de Appeasement:

Valor	Descripción
DISSATISFIED_CUSTOMER	Cliente insatisfecho
MANUFACTURING_DEFECT	Defecto de fabricación
DELAYED_DELIVERY	Entrega con retraso
PRODUCT_NOT_RECEIVED	Producto no recibido

status de Appeasement (inmutable): OPEN · COMPLETED

---

Basket

Configura channelType y businessType, y añade 19 atributos personalizados para las pasarelas de pago integradas.

channelType — canal de venta

Valor	Canal	Valor	Canal
1	Storefront	7	Twitter
2	Call Center	8	Facebook Ads
3	Marketplace	9	Subscriptions
4	DSS	10	Online Reservation
5	Store	11	Customer Service Center
6	Pinterest	12	Instagram Commerce

businessType: 1 B2C · 2 B2B

Atributos personalizados

Stripe

Atributo	Tipo	Descripción
stripePaymentIntentID	string	ID del Payment Intent activo.
stripePaymentIntentsID	string	IDs de Payment Intents (histórico).
stripePaymentSourceID	string	ID del Payment Source.
stripeBankAccountToken	string	Token de cuenta bancaria ACH Debit.
stripeCustomerID	string	Customer ID de Stripe.
stripeIsPaymentIntentInReview	boolean	true si el Payment Intent está en revisión antifraude.
stripeRiskLevel	string	Nivel de riesgo evaluado por Stripe.
stripeRiskScore	string	Puntuación de riesgo de Stripe.
stripeWeChatQRCodeURL	string	URL del QR para pago WeChat Pay.

PayPal

Atributo	Tipo	Descripción
paypalAlreadyHandledEmail	string	Email temporal del Express Checkout de PayPal.
paypalAlreadyHandledPayerID	string	PayerID temporal del Express Checkout.
paypalAlreadyHandledToken	string	Token temporal del Express Checkout.

Klarna

Atributo	Tipo	Descripción
kpClientToken	text	Client Token de la sesión Klarna.
kpSessionId	string	Session ID de Klarna.

Mercado Pago

Atributo	Tipo	Descripción
mp_externalReference	string	Referencia externa de la preferencia.
mp_init_point	string	URL de inicio del flujo de pago.

Amazon / Otros

Atributo	Tipo	Descripción
amazonExpressShopperDetails	text	Datos del comprador para Amazon Pay Express.
sessionAddressBook	text	Libreta de direcciones de sesión.
HW_customer_identification	string	Identificador de cliente Hawkers.
hk_subscription_id	string	ID de suscripción (SubscribePro).

---

BonusDiscountLineItem

Atributo	Tipo	Descripción
bonusProductLineItemUUID	string	UUID del line item del producto qualifying que activó el bonus.

---

Category

Añade 11 atributos personalizados organizados en grupos de Business Manager.

Atributo	Tipo	Grupo BM	Descripción
hreflangUrlsJSON	text	ExternalSearch	JSON con las URLs de la categoría por locale/site.
slotBannerImage	image (localizable)	Presentation	Banner desktop de la landing.
slotBannerImage_T_M	image (localizable)	Presentation	Banner tablet/móvil de la landing.
hk_category_asset	set-of-string	Presentation	IDs de content assets cargados en el listado.
hk_contentAssetIdForSeoContent	enum-of-string	Presentation	Content asset con el bloque SEO.
hk_contentAssetIdForShorcutAndToggleFilters	enum-of-string	Presentation	Content asset de filtros de acceso rápido.
hk_accordion	enum-of-string	Presentation	Content asset del acordeón de información adicional.
hk_template_asset	enum-of-string	Presentation	Template de renderizado personalizado.
alternativeUrl	html	customAttributes	URL alternativa en navegación (soporta $url(...)$).
HK_Crawlable	enum-of-string (multi)	customAttributes	Atributos de producto rastreables en esta categoría.
hk_isPromoCategory	boolean	customAttributes	Indica si es una categoría de tipo promoción.

Valores de HK_Crawlable: hk_gender, hk_targetgroup, hk_lensappearance, hk_photochromatic, hk_lenstype, hk_framematerial, hk_frameshape, hk_maincolor, hk_style, hk_seasonrelease, hk_collaboration, hk_framename

---

Content

Atributo	Tipo	Localizable	Descripción
body	html	Sí	Cuerpo HTML del content asset.
hreflangUrlsJSON	text	No	JSON con las URLs del asset por locale/site.

---

Coupon

No añade atributos personalizados. Define el enum de type:

SINGLE_CODE (por defecto) · MULTIPLE_CODES · SYSTEM_CODES

---

CustomerActiveData

Atributo	Tipo	Descripción
returnItems	int	Número de artículos devueltos por el cliente.

---

CustomerAddress

Atributo	Tipo	Obligatorio	Descripción
email	string	Sí	Email del cliente asociado a la dirección.
hk_phonePrefix	string	No	Prefijo telefónico.
hk_fiscalId	string	No	Identificación fiscal (NIF, NIE, etc.).
paypalDefaultShippingAddressCurrencyCode	string	No	Código de moneda de la dirección de envío PayPal.

Países disponibles: AD, AT, AU, BE, BG, CO, HR, CY, CZ, DE, DK, EE, ES, FI, FR, GB, GR, HU, IE, IT, LT, LU, LV, MT, MX, MY, NL, NZ, PL, PT, RO, SE, SG, SI, SK, US

---

Invoice

No añade atributos personalizados.

status (inmutable): NOT_PAID · MANUAL · PAID · FAILED

type (inmutable): SHIPPING · RETURN · RETURN_CASE · APPEASEMENT

---

Library

Configura la integración con Salesforce CMS mediante el atributo de sistema CMSChannelID. Sin atributos personalizados.

---

Order

La extensión más completa del fichero: 64 atributos personalizados organizados en 15 grupos de Business Manager.

Enums de sistema relevantes

status / payment / shipping

Atributo	Valores
status	0 CREATED · 3 NEW · 4 OPEN · 5 COMPLETED · 6 CANCELLED · 7 REPLACED · 8 FAILED
paymentStatus	0 NOTPAID · 1 PARTPAID · 2 PAID
shippingStatus	0 NOTSHIPPED · 1 PARTSHIPPED · 2 SHIPPED
confirmationStatus	0 NOTCONFIRMED · 2 CONFIRMED
exportStatus	0 NOTEXPORTED · 1 EXPORTED · 2 EXPORTREADY · 3 EXPORTFAILED

cancelCode / replaceCode

Ambos comparten los mismos valores (defecto: NONE_SPECIFIED):

NONE_SPECIFIED · WRONG_SIZE · WRONG_COLOR

Atributos personalizados

COD

Atributo	Tipo	Descripción
HW_codAmount	set-of-string	Cantidades pagadas vía COD.
HW_codDate	set-of-string	Fechas de actualización del COD.
HW_codId	set-of-string	Referencias COD.
HW_codJson	set-of-string	Datos completos del nodo codRefs en JSON.
HW_fullyPaid	boolean	true si el pedido COD está totalmente pagado.

GDPR

Atributo	Tipo	Descripción
HW_flag_privacy_policy_term_conditions	boolean	Política de privacidad y T&C.
HW_flag_gdpr_receive_commercial_information_from_brand	boolean	Comunicaciones comerciales personalizadas.
HW_flag_gdpr_receive_personalized_offers	boolean	Ofertas personalizadas.
HW_flag_eyewear_glasses_for_own_use_over_18	boolean	Uso propio de gafas y mayoría de edad.

Tracking

Atributo	Tipo	Descripción
HW_trackingId	set-of-string	IDs de tracking del envío.
HW_trackingUrl	set-of-string	URLs de seguimiento.
HW_trackingDate	set-of-string	Fechas de eventos de tracking.
HW_trackingJson	set-of-string	Datos completos de tracking en JSON.
HW_logisticProvider	set-of-string	Proveedor(es) logístico(s).

Klarna

Atributo	Tipo	Descripción
kpOrderID	string	Klarna Payments Order ID.
kpSessionId	string	Session ID de Klarna.
kpClientToken	text	Client Token de la sesión Klarna.
kpIsVCN	boolean	true si se usa tarjeta virtual (VCN).
kpVCNCardID	string	ID de la tarjeta virtual.
kpVCNAESKey	text	Clave AES para descifrar datos VCN.
kpVCNBrand	string	Esquema de la tarjeta virtual.
kpVCNHolder	string	Titular de la tarjeta virtual.
kpVCNIV	string	Vector de inicialización VCN.
kpVCNPCIData	string	Datos PCI cifrados.

Stripe

Atributo	Tipo	Ext. managed	Descripción
stripePaymentIntentID	string	No	ID del Payment Intent activo.
stripePaymentIntentsID	string	No	IDs históricos de Payment Intents.
stripePaymentSourceID	string	No	ID del Payment Source.
stripeBankAccountToken	string	No	Token bancario ACH Debit.
stripeCustomerID	string	No	Customer ID de Stripe.
stripeIsPaymentIntentInReview	boolean	No	true si está en revisión antifraude.
stripeRiskLevel	string	Sí	Nivel de riesgo.
stripeRiskScore	string	Sí	Puntuación de riesgo.
stripeWeChatQRCodeURL	string	No	URL QR para WeChat Pay.
stripe_installments	string	No	Número de cuotas.

Mercado Pago

Atributo	Tipo	Descripción
mp_externalReference	string	Referencia externa.
mp_merchantOrderId	string	ID de la orden en Mercado Pago.
mp_paymentType	string	Tipo de pago.
mp_paymentId	string	ID del pago.
mp_paymentMethodId	string	ID del método de pago.
mp_barcode	string	Código de barras para pago en efectivo.
mp_installments	string	Número de cuotas.

Multibanco / OXXO

Multibanco (Portugal): multibanco_entity · multibanco_reference · multibanco_url · multibanco_expiry_date (int)

OXXO (México): oxxo_reference · oxxo_url · oxxo_expiry_date (int)

Salesforce SSC

Atributo	Tipo	Descripción
sscid	string	Order ID en Salesforce Service Cloud.
sscid18	string	Account ID18 en SSC.
sscSyncStatus	enum-of-string	Estado de sincronización: exported · created · updated.
sccPaymentSyncStatus	enum-of-string	Estado de sincronización del pago: created · exported.
sscSyncResponseText	set-of-string	Respuesta del último intento de sincronización.

Otros

Atributo	Tipo	Descripción
HW_shippingCountry	string	País de envío seleccionado.
HW_paymentMethod	string	Método de pago (para exportación).
HW_customer_identification	string	NIF o NIE del cliente.
hasReturnsToExport	boolean	true si tiene devoluciones pendientes de exportar.
totalReturn	string	Importe total devuelto.
orderPreConfirmationSent	boolean	true si se envió el email de pre-confirmación.
paypalPaymentMethod	string	Tipo PayPal: express o directpayment.
externalStatus	enum-of-string	Estado externo: excluded_for_bi.
hk_subscription_id	string	ID de suscripción (SubscribePro).
hk_shippingStatus	enum-of-int	Estado de envío Hawkers (ver tabla).

Valores de hk_shippingStatus:

Valor	ES	EN
10 (defecto)	En preparación	In preparation
15	Parcialmente enviado	Partially shipped
20	Enviado	Shipped
25	Parcialmente entregado	Partially delivered
27	Listo para recoger	Ready for pickup
30	Entregado	Delivered

---

OrderAddress

Atributo	Tipo	Obligatorio	Descripción
email	string	Sí	Email del destinatario del pedido.
hk_phonePrefix	string	No	Prefijo telefónico.
customerId	string	No	ID de cliente SFCC asociado.
isStore	boolean	No	true si la dirección corresponde a una tienda física.

58 países en countryCode: AD, AT, AU, BA, BE, BG, BY, CA, CH, CL, CN, CO, CY, CZ, DE, DK, EE, ES, FI, FR, GB, GE, GG, GI, GR, HR, HU, IE, IM, IS, IT, JE, JP, LI, LT, LU, LV, MA, MC, ME, MT, MX, MY, NL, NO, NZ, PH, PL, PT, RO, RS, SE, SG, SI, SK, SM, US, VA

---

OrderItem

No añade atributos personalizados.

status (inmutable): NEW · OPEN · BACKORDER · CONFIRMED · WAREHOUSE · SHIPPED · CANCELLED

type (inmutable): PRODUCT · SERVICE

---

OrderPaymentInstrument

26 atributos personalizados para las pasarelas de pago a nivel de instrumento de pago del pedido.

PayPal

Atributo	Tipo	Descripción
paypalAck	string	Acknowledgement de la acción de pago (Auth, Order, Sale).
paypalBillingAgreement	boolean	true si se usa Billing Agreement.
paypalCorrelationId	string	ID de correlación de llamadas a la API de PayPal.
paypalEmail	string	Email de la cuenta PayPal del comprador.
paypalPayerID	string	Payer ID de PayPal (requerido para la integración).
paypalPaymentStatus	string	Estado del pago PayPal.
paypalToken	string	Token para identificar las llamadas Set/Get/Do ExpressCheckout.

Stripe

Atributo	Tipo	Descripción
stripeBankAccountToken	string	Token de cuenta bancaria ACH Debit.
stripeBankAccountTokenId	string	Token ID de cuenta bancaria ACH Debit.
stripeCardID	string	ID de la tarjeta Stripe.
stripeChargeID	string	ID del cargo Stripe.
stripeCustomerID	string	Customer ID de Stripe.
stripeDefaultCard	boolean	true si es la tarjeta predeterminada.
stripePRUsed	boolean	true si se usó Payment Request Button (Google Pay o Apple Pay).
stripeSavePaymentForReAuthorise	boolean	Guarda el instrumento para reautorizaciones pasados 7 días.
stripeSavePaymentInstrument	boolean	Guarda el instrumento de pago para usos futuros.
stripeSourceID	string	ID de Source / Payment Method de Stripe.
stripeWeChatQRCodeURL	string	URL del QR para WeChat Pay.

Klarna

Atributo	Tipo	Descripción
klarnaPaymentCategoryID	string	ID de la categoría de pago Klarna.
klarnaPaymentCategoryName	string	Nombre de la categoría de pago Klarna.

Mercado Pago

Atributo	Tipo	Descripción
mp_barcode	string	Código de barras para pago en efectivo.
mp_paymentMethodId	string	ID del método de pago.
mp_paymentType	string	Tipo de pago.
mp_preferenceId	string	ID de la preferencia de Mercado Pago.
mp_paymentDeadline	string	Fecha límite de pago.
mp_additionalData	text	Datos adicionales del pago en JSON.

---

OrganizationPreferences

Relación con Global Custom Preferences

Los tres primeros atributos (HW_localeDefinitionsHawkersco, HW_productCustomFeedsConfiguration, hreflangUrlsJSONHome) son los mismos JSONs documentados en la sección Global Custom Preferences. La configuración de Business Manager los gestiona desde aquí.

Atributo	Grupo BM	Descripción
HW_localeDefinitionsHawkersco	i18n	JSON con la definición de locales por site y país.
hreflangUrlsJSONHome	i18n	JSON con las URLs de home por locale para todos los sites.
HW_productCustomFeedsConfiguration	productCustomFeed	JSON de configuración de atributos para los feeds de producto personalizados.
HW_catalogBucketsMapping	sitemapFeed	JSON de mapeo de buckets de catálogo para sitemaps personalizados.
HW_customSitemapsLocaleMapping	sitemapFeed	JSON de mapeo de locales para sitemaps personalizados.

---

PaymentCard y PriceBook

Ambos solo configuran la UI de Business Manager para sus atributos de sistema estándar. Sin atributos personalizados.

---

PaymentMethod

Un único atributo personalizado:

Atributo	Tipo	Descripción
stripe_pmc_configuration_id	string	ID de configuración PMC de Stripe (Stripe Payment Method Configuration).

---

PaymentTransaction

19 atributos personalizados para el historial y gestión de transacciones de pago.

El atributo de sistema type define los tipos de transacción (inmutable): TYPE_AUTH · TYPE_AUTH_REVERSAL · TYPE_CAPTURE · TYPE_CREDIT

Stripe

Atributo	Tipo	Descripción
stripeAccountId	string	ID de la cuenta a la que pertenece la transacción.
stripeAccountType	string	Tipo de cuenta a la que pertenece la transacción.
stripeChargeId	string	ID del cargo en Stripe.
stripeChargeOutcomeData	text	Datos del resultado del cargo en Stripe.
stripeClientSecret	string	Client Secret del PaymentIntent.
stripeJsonData	text	JSON completo de la respuesta de Stripe.
stripeOrderNumber	string	Número de pedido en Stripe.
stripeSourceCanCharge	boolean	true si el Source puede ser cargado (fuentes seleccionadas).
stripeSourceId	string	ID del Source de Stripe.

Otros

Atributo	Tipo	Descripción
AmountPaid	double	Importe pagado en la transacción.
approvalStatus	string	Estado de aprobación.
authAmount	string	Importe autorizado.
authCode	string	Código de autorización.
cardType	string	Tipo de tarjeta.
eFundsTransactionHistory	set-of-string	Historial de transacciones eFunds.
kpFraudStatus	string	Estado de fraude del pedido Klarna Payments.
requestId	string	ID de la solicitud.
requestToken	string	Token de la solicitud.
transactionsHistory	set-of-string	Historial de todas las transacciones relacionadas con el pedido.

---

PriceAdjustment

No añade atributos personalizados. Define el enum de reasonCode:

Valor	Descripción
PRICE_MATCH	Igualación de precio
BACKORDER	Pedido pendiente
EVEN_EXCHANGE	Cambio igualado

---

Product

La extensión de Product añade atributos para variaciones de apparel, badges de marketing, colaboraciones y contenido específico del PDP.

Atributos de variación (Apparel)

Atributo	Tipo	Descripción
ap_category	enum-of-string (multi)	Categoría de apparel: SWEATERS · T-SHIRTS · TROUSERS · SPORTS-BRA
ap_color	string	Color de la variación de apparel.
ap_size	string	Talla de la variación de apparel.
ap_idContentAssetSizeGuide	string	ID del content asset con la guía de tallas.
color	string	Color del producto para el atributo de variación.

Atributos de marketing y contenido

Atributo	Tipo	Site-specific	Descripción
hk_badge_marketing	enum-of-string	Sí	Badge de marketing del producto (ver valores).
hk_badges_extra	enum-of-string (multi)	Sí	Badges adicionales: product-badge_free-shipping · product-badge_ultralight · product-badge_made-in-spain.
hk_carouselMultimediaPdp	string	No	Configuración del carrusel multimedia en la PDP.
hk_assetsIdsWithHtmlCustomContent	set-of-string	No	IDs de assets con contenido HTML personalizado.
hk_minLastPrice	double (localizable)	No	Precio mínimo más bajo en los últimos 30 días (directiva Omnibus).

Valores de hk_badge_marketing:

Valor	Etiqueta
product-badge_best-seller	Best Seller
product-badge_hawkers-choice	Hawkers Choice
product-badge_limited-edition	Limited Edition
product-badge_trending	Trending
product-badge_new-in	New In
product-badge_hot	Hot
product-badge_top-rated	Top Rated
product-badge_last-units	Last Units
product-badge_new-colors	New Colors
product-badge_limited-edition-new-in	Collaboration
product-badge_kids / product-badge_kids-new	Kids
product-badge_made-in-italy	Made in Italy
product-badge_made-in-spain	Made in Spain
SS25	SS25

Atributo hk_collaboration

49 colaboraciones históricas disponibles:

Valor	Nombre	Valor	Nombre
PAULA_ECHEVARRIA	Paula Echevarría	JORGE_MARTIN	Jorge Martín
ALEX_RINS	Alex Rins	MARIO_RUIZ	Mario Ruiz
PECCO	Pecco Bagnaia	ANUEL	Anuel AA
VR46_RIDERS_ACADEMY	VR46 Riders Academy	NUDE_PROJECT	Nude Project
RICARDO_TORMO	Circuito Ricardo Tormo	THEGREFG	TheGrefg
BALR	Balr	TINI	Tini
BJWT	Black Jaguar White Tiger	POLIMA	Polimá West Coast
JUANPA_ZURITA	Juanpa Zurita	MANUEL_TURIZO	Manuel Turizo
STEVE_AOKI	Steve Aoki	AUGUSTO_FERNANDEZ	Augusto Fernández
BOO_JOHNSON	Boo Johnson	BOB_ESPONJA	Bob Esponja
MIDNIGHT	Midnight Studios	NINJA_TURTLES	TMNT
KEITH_HAIRING	Keith Haring	SOUTH_PARK	South Park
LEO_MESSI	Leo Messi	RICK_MORTY	Rick & Morty
NYJAH_HUSTON	Nyjah Huston	FOROCOCHES	Forocoches
BASQUIAT	Basquiat	JUNIOR_FIRPO	Junior Firpo
SELECCION_NACIONAL_MX	Selección Nacional México	SPACE_JAM	Space Jam
DOPE	Dope	LOONEY_TUNES	Looney Tunes
LUIS_SUAREZ	Luis Suárez	RONALDINHO	Ronaldinho
IMAGINARIUM	Imaginarium	EL_GANSO	El Ganso
DIAMOND	Diamond Supply	LUCA_MARINI	Luca Marini
AARON_KAI	Aaron Kai	TRUENO	Trueno
UNO_ENTRE_CIEN_MIL	Uno Entre Cien Mil	MRDRIP	MrDrip
ESPARGARO	Pol Espargaró	SMILEY	Smiley
ALEX_MARQUEZ	Alex Márquez	CASETIFY	Casetify
PIERRE_GASLY	Pierre Gasly	—	—

Atributos Creative (producto composable)

El sistema Creative permite a los clientes configurar gafas eligiendo componentes por separado.

Atributo	Tipo	Descripción
hk_composableProduct	boolean	true si el producto es una gafa Creative (producto raíz composable).
hk_composableProductPart	enum-of-string	Indica qué parte de la gafa representa este producto: hk_creative_frontal_option (frontal) · hk_creative_right_temple_option · hk_creative_left_temple_option · hk_creative_lenses_option.
hk_creative_frontal_option	string	SKU o referencia de la opción frontal seleccionada.
hk_creative_right_temple_option	string	SKU o referencia de la varilla derecha seleccionada.
hk_creative_left_temple_option	string	SKU o referencia de la varilla izquierda seleccionada.
hk_creative_lenses_option	string	SKU o referencia de la opción de lentes seleccionada.

Atributos de scoring y comercio

Atributo	Tipo	Site-specific	Descripción
hk_daysonline	double	Sí	Días transcurridos desde que el producto está publicado online (usado en ordenación).
hk_elorating	double	Sí	Puntuación Elo del producto (sistema de ranking por comparación).
hk_foursixtyincluded	boolean	Sí	true si el producto aparece en el feed de Foursixty (social commerce UGC).

Atributos de frame (montura)

hk_framecolor — 24 colores (multi-valor):

BEIGE · BLACK · BLUE · BROWN · CAREY · CHAMPAGNE · CORAL · DEMI · GOLD · GREEN · GREY · LILA · ORANGE · PATTERN · PINK · PRINT · PURPLE · RED · ROSEGOLD · SILVER · TRANSPARENT · TURQUOISE · WHITE · YELLOW

hk_framematerial — 17 materiales (multi-valor):

PC · METAL · ACETATE · TR90 · POLYURETHANE · NYLON · RUBBER · ECO_ACETATE · BTR600 · BIO_MASS · TRITAN_RENEW · INJECTED_ACETATE · ACRYLIC · DOWN · POLYESTER · PVC · CP

Atributo hk_framename

Enum con todos los nombres de montura del catálogo. Los valores con prefijo NW_ corresponden a la marca Northweek.

Monturas Hawkers (A–K):

360 · ACTIVE · AERO · ALEMBERT_XL · ALL_IN · AMERICANO · AMOUR · APEROL · ARGENTA · ARTIK · AUDREY · AUDREY_NEUVE · AUDREY_RAW · AURA · B_PORTER · B_TOWN · BAT · BAVE · BEL_AIR · BEL_AIR_CROSSWALK · BEL_AIR_SPORT · BEL_AIR_X · BELAIR_KIDS · BELLA · BESSIE · BHANU · BLACKJACK · BLACKJACK_XL · BLAST · BLUEJAY · BOLT · BOO_JOHNSON · BOOST · BOUJEE · BOW · BOWIE · BREEZE · BRIGITTE · BRONY · BUBKA · BUTTERFLY · CAD · CALI · CAPTAIN · CHABLIS · CHAIN · CHAPTAL · CHARDON · CHAZARA · CHEEDO · CHENIN · CHILL · CINDY · CITYBREAK · CITYLIFE · CLASSIC · CLASSIC_BOLD · CLASSIC_BOLD_BB · CLASSIC_FLAT · CLASSIC_ROUNDED · CLASSIC_VALMONT · CLASSY · CLAUDIA · CODE · COLE · COLLINS · COMANECI · COOPER · CORE · CORE_RAW · COSMO · CROUPIER · CRUSH · CULTURE · CUORE · CYCLING · DEALER · DIVINE · DIVINE_KIDS · DIVER · DOT · DOUMU · DOURO · DOWNTOWN_MAX · DREAM · DUST · EAGLE · ECLIPSA · EDGE_XL · EJECTA · EREBIA · ETERNITY · EUPHORIA · F18 · FAINT · FAIRFAX · FALCON · FASTER · FASTER_RAW · FELINE · FLAT_LAX · FLECHAZO · FLUSH · FOXY · FRESH · G_LIST · GALA_BB · GELID · GEN · GIGI · GLAM · GRID · GRIP · HARLOW · HARLOW_BB · HAT_TRICK · HAWK · HELL · HF1 · HF2 · HILLS · HISTIDINE · HOWLIN · HUNTER · HYDE · HYLEG · HYPNOSE · IBIZA · ICY · IDLE · IDOL_BB · INFINITE · INK · INWOOD · IRIS · JACK · JACK_POT · JAM · JERKUM · JOKER · KATE · KIJAFA · KUIPER

Monturas Hawkers (L–Z):

LA_LOUVE · LACMA · LACMA_KIDS · LAGOON · LASH · LAUPER · LAVVU_BB · LAX · LAYOFF · LENOX · LINDA · LITTLE_PAPARAZZI · LOIRA · LONG_ISLAND · LUMINA · LUST · MAITAI · MANHATTAN · MARK · MATE · MAZE · MELROSE · METRO · MIA · MILADY · MINIMAL · MINIMAL_MAX · MIRANDA · MOMA · MOMA_CROSSTOWN · MOMA_MIDTOWN · MOONLY · MOTION · MUDDY · MUDSLIDE_XL · NARCISO · NEGRONI · NEIVE · NEW_CLASSIC · NEW_CLASSIC_ROUNDED · NO9 · NO35 · NO_LIMIT · NOBU · NOLITA · OASIS · OLLIE · OLWEN · OMNIA · ONE · ONE_COLT · ONE_CROSSWALK · ONE_DOWNTOWN · ONE_DREAM · ONE_KIDS · ONE_LS · ONE_LS_FLAT_TOP · ONE_LS_METAL · ONE_LS_RAW · ONE_LS_RODEO · ONE_PAIR · ONE_PAIR_XL · ONE_RAW · ONE_SPORT · ONE_UPTOWN · ONE_VENM_HYBRID · ONE_VENM_METAL · ONE_VENM_RAW · ONE_X · OUTER · OWENS · PARLAY · PEAK · PEAK_METAL · PETITE · PHANTOM · PILOTA · POINT · POKER · POLAR · POWER · PREMIER · RACE · RADIANTE · RAVE · RAVE_KIDS · REETZY · RESORT · RETRO · RIMY · RISE · ROUNDED_LOLITA · ROW · ROYAL_FLUSH · RUBIN · RUNWAY · RUSHHOUR · SALT · SAUVAGE · SENSE · SHADOW · SHOWDOWN_XL · SIDE_A · SIDE_B · SIGNAL · SIXGON · SIXGON_DRIVE · SKI_LENS · SLATER · SOUR · SOUTH_BEACH · SOUTHSIDE · SPAGO · SPEED · SQUARED_CHELLA · STACK · STEEZY · STONE · SUNSET · SUPERIOR · SWAG · TADAO · TANGO · TEARDROP · TOX · TRACK · TRAIL · TRAINING · TRENDSET · TRIBE · TRIBECA · TULUM · TWIST · USIL · VENT · VIGIL · VITAL · VUDOO · WAIMEA · WARWICK · WARWICK_CROSSWALK · WARWICK_KIDS · WARWICK_METAL · WARWICK_PAIR · WARWICK_RAW · WARWICK_UPTOWN · WARWICK_VENM_HYBRID · WARWICK_VENM_METAL · WARWICK_X · WARWICK_XS · WAVE · WEED · WEEKENDER · WHIMSY · WIND · WOODY · ZENITH · ZHANNA · AERATE · ARROYA · ATOM_BB

Monturas Hawkers (BB y nuevas colecciones):

MOMA_MIDTOWN_BB · OLLIE_BB · RIMON · ROSE · SLATER_BB · SUPERIOR_BB · TIBOUREN · TOKAY · ULLAGE · UMESHU · ONE_BB · WARWICK_BB · FLY · ASPEN · HEAVEN · FERVOR · MARS · CERES · FEROE · ONE_FLEX · TRACK_FLEX · TIGER · LION · SHARK · NEXUS · LYNX_BIG · LYNX_SMALL · ONE_SPORT_RAW · COVENT · PITLANE · HARE · MINIMAL_MAX_BB · BELAIR_BB · JAM_BB · LASH_BB · WARWICK_RAW_BB · ONE_RAW_BB · ARTIK_BIG · ARTIK_SMALL · ASTRO · FROSTIK · FROSTIK_KIDS · OLLIE_XS · ONE_VENM_XS · ONE_XS · UTTICA

Monturas Northweek (NW_):

NW_ARTIK · NW_BOLD · NW_BRIGHTON · NW_CYCLING · NW_DEMON · NW_FALCON · NW_GRAVITY · NW_HALE · NW_HAYES · NW_JENSEN · NW_KATE · NW_KIDS · NW_MILLS · NW_REGIS · NW_REGULAR · NW_REGULAR_GRADIANT · NW_REGULAR_PHANTOM · NW_SHELTER · NW_VESCA · NW_WALL · NW_WALL_BB · NW_WALL_PHANTOM

Atributo hk_frameshape

12 formas de montura (multi-valor): AVIATOR · BROWLINE · BUTTERFLY · CATEYE · GEOMETRIC · HEXAGONAL · MASK · OTHER · OVAL · RECTANGLE · ROUNDED · SQUARE

Otros atributos de frame y producto

Atributo	Tipo	Site-specific	Descripción
hk_framesize	string	Sí	Talla de la montura.
hk_gender	enum-of-string	No	Género: MALE · FEMALE · UNISEX · KIDS.
hk_idContentAssetForSubscriptionPlans	string	No	ID del content asset con los planes de suscripción.
hk_lastBestPrice	double (localizable)	No	Mejor precio histórico del producto (distinto de hk_minLastPrice).
hk_madein	enum-of-string	No	País de fabricación: CHINA · SPAIN · ITALY · PORTUGAL · TAIWAN.

Atributos de imagen — sufijos

Los tres atributos comparten el mismo enum de 17 sufijos. Definen qué tipo de imagen se muestra en cada contexto:

Atributo	Contexto	Defecto
hk_imageSuffixLineItem	Carrito, checkout y notificaciones	F
hk_imageSuffixTilePrimary	Tile de producto (imagen principal)	F
hk_imageSuffixTileSecondary	Tile de producto (imagen hover)	F

Valores de sufijo: F Frontal · L Lateral · P Packaging · D1–D4 Detalle · B1–B3 Bodegón · LS1–LS5 Lifestyle · T Trasera · C Campaña

Atributo hk_label2 — etiqueta promocional

Etiqueta en la esquina superior derecha de la imagen del producto. Site-specific y visible en BM.

Valor	Etiqueta	Notas
Discount	Discount	—
2x1	2×1	EN: 2for1
35PCT-70PCT	35% – 70%	—
FREESHIPPING	FREE SHIPPING	—
NEW	NEW	—
2x40	2×40€	EN-GB: 2×£40 · EN: 2for40
30PCT / 40PCT / 50PCT / 60PCT	30% / 40% / 50% / 60%	—
BLACK MARKET	BLACK MARKET	—
3X1	3×1	EN: 3for1
35-60	35%–60%	—
KIDS	KIDS	—
PREORDER	PRE-ORDER	Localizado: DE VORVERKAUF · ES RESÉRVALAS · FR RÉSERVE MAINTENANT
SOLD_OUT	SOLD OUT	ES: AGOTADO
2X50	2×50€	EN-AU 2×$85 · EN-GB 2×£50 · EN-US ICONS · CO 2×$230K · MX 2×$1200
MADEINITALY	MADE IN ITALY	—

Atributos auxiliares de hk_label2 (site-specific, visibles):

• hk_label2_background — color de fondo en hexadecimal
• hk_label2_color — color de texto en hexadecimal

Atributos de lente (óptica)

Pares visible/interno — cada propiedad óptica tiene dos atributos: el visible en BM (que muestra la etiqueta) y el interno no visible (que almacena el valor de referencia del Custom Object de lentes):

Atributo visible	Atributo interno	Propiedad
hk_lens_color	hk_lens_color_option	Color de lente seleccionado
hk_lens_treatment	hk_lens_treatment_option	Tratamiento de lente seleccionado
hk_lens_type	hk_lens_type_option	Tipo de lente seleccionado

hk_lensappearance — apariencia de la lente: COSMETHIC (Cosmetic) · GRADIENT · MIRROR · SOLID · BLUELIGHT

note

El valor COSMETHIC tiene un typo en el XML original (debería ser COSMETIC). Al estar ya en producción, se documenta tal cual.

hk_lenscategory — categoría de protección UV: 0 (C0) · 1 (C1) · 2 (C2) · 3 (C3) · S1 · S2 · S3

hk_lenscolor — color de lente (multi-valor, mismos 24 colores que hk_framecolor)

hk_lensmaterial — material de lente (multi-valor): BIO_PC · BIO_TAC_POLARIZED · NYLON · PC · PC_POLARIZED · POLYCARBONATE_ZEISS · TAC_ECO · TAC_POLARIZED · TR18 · TR18_ECO · TRITAN_RENEW

hk_lenstype — tipo de lente: POLARIZED · STANDARD · BLUE_BLOCKING

Atributo hk_maincolor

Color principal del producto (multi-valor, misma paleta de 24 colores que hk_framecolor y hk_lenscolor):

BEIGE · BLACK · BLUE · BROWN · CAREY · CHAMPAGNE · CORAL · DEMI · GOLD · GREEN · GREY · LILA · ORANGE · PATTERN · PINK · PRINT · PURPLE · RED · ROSEGOLD · SILVER · TRANSPARENT · TURQUOISE · WHITE · YELLOW

Límites de cantidad

Atributo	Tipo	Descripción
hk_maxLineItemQuantity	int	Cantidad máxima por línea de pedido.
hk_maxOrderQuantity	int	Cantidad máxima total por pedido.

Medidas físicas de la montura

Todos los atributos son double, no localizables, no visibles en BM.

Atributo	Descripción
hk_measureBridge	Puente (distancia entre lentes).
hk_measureFrameHeight	Altura del frame.
hk_measureFrontal	Anchura del frontal.
hk_measureLensWidth	Ancho de la lente.
hk_measureRod	Varilla (longitud de la patilla).

Atributos booleanos y flags de producto

Atributo	Tipo	Descripción
hk_notincludedinpromotions	enum-of-string (localizable)	Excluye el producto de promociones: TRUE / FALSE.
hk_polarized	enum-of-string (localizable)	El producto lleva lente polarizada: TRUE / FALSE.
hk_showProductAbTest	boolean	Mostrar el producto en la web durante un test A/B.
hk_showVirtualTryOn	boolean	Mostrar el probador virtual en el PDP.

Atributos de suscripción y opciones graduadas

Todos son string, no visibles en BM, usados internamente por el sistema de suscripciones y óptica.

Atributo	Descripción
hk_option_eye	Ojo seleccionado (graduación).
hk_option_eye_graduation	Graduación del ojo.
hk_option_frequency_subscription_plan	Frecuencia de la suscripción, en meses.
hk_option_payment_by_subscription	Indica si el pago es por suscripción.
hk_option_subscription_unique_id	ID único de la suscripción.
hk_phonecase_color	Color de la funda de móvil (Phone Case).
hk_phonecase_model	Modelo de la funda de móvil.

Atributo hk_product_subtype — subtipo de producto

Enum con 32 valores para clasificar el producto en subcategoría de negocio. No localizable, no visible en BM.

Valor	Descripción
SUNGLASSES	Gafas de sol
GLASSES	Gafas (óptica)
BLUE_LIGHT	Gafas filtro luz azul
SPORT_SUNGLASSES	Gafas de sol deportivas
SKI_GOGGLES	Gafas de esquí
SKI_LENS	Lente para gafas de esquí
CONTACT_LENSES	Lentillas
WATCH	Reloj
T_SHIRT	Camiseta
HOODIE	Sudadera con capucha
SWEATSHIRT	Sudadera sin capucha
CROP_TOP	Crop top
CROP_HODDIE	Crop hoodie (typo en XML: HODDIE)
CROP_SWEATSHIRT	Crop sweatshirt
JOGGER	Pantalón jogger
SPORTS_BRA	Sujetador deportivo
ZIPPER	Cremallera / chaqueta
LONGSLEEVE	Manga larga
TEE	Camiseta básica
PANTS	Pantalón
KNIT / KNITWEAR	Tejido de punto
POLO	Polo
JACKET	Chaqueta
CASE	Estuche / funda
CLEANING_KIT	Kit de limpieza
CORD	Cordón / cadena
BAG	Bolsa
CAPS	Gorras
GIFT_BAG / GIFTBAG	Bolsa regalo
DONATION	Donación

Atributo hk_producttype — tipo de producto

Categorización de alto nivel del producto (13 valores):

SUNGLASSES · GLASSES · BLUE_LIGHT · SPORT_SUNGLASSES · SKI_GOGGLES · SKI_LENS · CONTACT_LENSES · CLOTHES · WATCH · ADDON · PHONE_CASE · CAPS · DONATION

note

CLOTHES agrupa toda la ropa (valor CLOTHES en XML), y ADDON agrupa los accesorios (valor ADDON en XML, display "Accesories").

Atributo hk_promotions — categoría de promoción

Multi-valor, site-specific, no visible en BM. Clasifica el producto en la promoción activa para habilitar descuentos automáticos.

Combos y unidades: 2X1 · 3X1 · 1-2-3

Porcentajes de descuento: 15PCT · 20PCT · 25PCT · 30PCT · 35PCT · 40PCT · 45PCT · 50PCT · 55PCT · 60PCT · 65PCT · 70PCT · 75PCT · 80PCT

Importes fijos (2 por X€): 2X30 · 2X40 · 2X50 · 2X60

note

2X40 tiene display multilingüe: DE 2 für 40€ · EN-AU 2 for $75 · EN-GB 2 for £40 · EN-MY 2 for RM300 · EN-SG 2 for S$90 · EN-US 2 for $50 · ES-CL 2X$50.000 · ES-CO 2X$200K · ES-MX 2X$900.

Precios fijos únicos: 20E · 25E · 30E · 35E · 40E · 45E

Combinados: 2x50PCT · 2x45PCT · 2X60PCT

Especiales: OUTLET · SALES · HOTSALE

Scores y rankings

Atributo	Tipo	Site-specific	Descripción
hk_quality_score	int	No	Puntuación de calidad del producto (interna).
hk_relevance	double	Sí	Relevancia para el ranking de búsqueda/listado.
hk_relevance_alternative	double	Sí	Relevancia alternativa (para pruebas o variantes).
hk_relevance_family_rank	double	Sí	Ranking del producto dentro de su familia.
hk_trend_score	int	No	Puntuación de tendencia (1–4).
hk_elorating (ya doc.)	double	—	Ver sección anterior.

Atributo hk_sale-price

Precio de oferta. double, site-specific, unidad €, escala 2 decimales, rango 1.00 – 999999.00.

Atributo hk_seasonrelease — temporada de lanzamiento

Valor	Display
01_SS2021	New In
02_CARRY_OVER	Carry Over
03_PHASE_OUT	Phase Out
04_MADE_IN_SPAIN	MADE IN SPAIN
01_SS2022	01_SS2022
01_SS2022-BLOQUE1	2022 Block 1
01_SS2022-BLOQUE2	2022 Block 2
01_SS2022-BLOQUE3	2022 Block 3
01_SS2022-BLOQUE4	2022 Block 4
01_SS2022-BLOQUE5	2022 Block 5

Atributos de texto y variación

Atributo	Tipo	Localizable	Descripción
hk_size	string	No	Talla del producto (complementaria a hk_framesize).
hk_subtitle	string	Sí	Subtítulo del producto (PDP).
hk_title	string	Sí	Título del producto (PDP).
hk_variation_color	string	No	Color de variación en el selector de variantes.
hk_variation_size	string	No	Talla de variación en el selector de variantes.
hk_variation_type	string	No	Tipo de variación.

Atributo hk_style — estilo

5 valores: FASHION · PERFORMANCE · SPORTWEAR · LIFESTYLE · SPORT

Atributo hk_targetgroup — público objetivo

5 valores: BABY · KIDS · TEEN · JUNIOR · ADULT

Atributo hk_template_asset

Content asset para renderizar una plantilla personalizada de categoría. 3 valores: new-in · collaborations · stories-collections

Atributo hk_threshold-price

set-of-int, rango 20–120. Define umbrales de precio para reglas de merchandising.

Atributos de Trustpilot

Atributo	Tipo	Descripción
hk_trustpilotNumberOfReviews	double	Número total de reseñas en Trustpilot.
hk_trustpilotStarsAverage	double	Puntuación media de Trustpilot.

Otros atributos de Product

Atributo	Tipo	Site-specific	Descripción
hreflangUrlsJSON	text	No	JSON con las URLs del producto por locale y site (hreflang SEO).
subproSubscriptionEnabled	boolean	No	Activa la suscripción (integración Subpro).
hk_urlDeclarationOfConformity	string	Sí	URL a la declaración de conformidad del producto.

Grupos de atributos (BM)

El tipo Product organiza sus atributos en los siguientes grupos en Business Manager:

Grupo	Atributos destacados
ExternalSearch	pageTitle, pageDescription, pageKeywords, pageURL, hreflangUrlsJSON
SiteMap	siteMapIncluded, siteMapChangeFrequency, siteMapPriority
Presentation	thumbnail, image, template
SearchRanking	searchPlacement, searchRank
Order	unit, minOrderQuantity, stepQuantity, taxClassID, EAN, UPC, localizedTaxClassID, unitQuantity, unitMeasure, hk_maxLineItemQuantity, hk_maxOrderQuantity
Store	storeNonDiscountableEnabled, storeTaxClass, storeNonRevenueEnabled, storeNonInventoryEnabled, storeReceiptName, storeForcePriceEnabled
ChannelIntegration	pinterestEnabled, facebookEnabled
inStorePickup	availableForInStorePickup
donation	isDonation
pdp	hk_assetsIdsWithHtmlCustomContent, hk_urlDeclarationOfConformity, hk_minLastPrice
composable	hk_composableProduct, hk_composableProductPart
trustpilot	hk_trustpilotStarsAverage, hk_trustpilotNumberOfReviews
contactLenses	subproSubscriptionEnabled, hk_idContentAssetForSubscriptionPlans
Type	hk_producttype, hk_product_subtype
images	hk_carouselMultimediaPdp, hk_imageSuffixLineItem, hk_imageSuffixTilePrimary, hk_imageSuffixTileSecondary

---

ProductActiveData, ProductInventoryList, ProductInventoryRecord, ProductList, ProductListItem, ProductListItemPurchase, ProductListRegistrant

Estos tipos solo configuran system-attribute-definitions (longitudes de campo, constraints de UI) sin añadir atributos personalizados. ProductActiveData expone métricas de tráfico, conversión, precios medios y antigüedad del producto agrupadas en BM (Traffic, Conversion, PricesAndRates, Freshness).

---

ProductLineItem

La extensión de ProductLineItem añade 12 atributos custom para los ítems de carrito/pedido en el contexto de productos ópticos, Creative composable y suscripciones.

Atributo	Tipo	Descripción
bonusProductLineItemUUID	string	UUID del line item que contiene el producto cualificante (bonus products).
fromStoreId	string	ID de tienda asociada al line item para agrupación de envíos en checkout.
hk_prescription	text	JSON con los datos de prescripción óptica del cliente.
hk_composable	text	JSON con los datos de composición del producto Creative (frontal, varillas, lentes).
hk_contactLensesInfo	text	JSON con las opciones seleccionadas para productos de lentillas.
hk_option_lenses_per_unit	string	Número de lentes por caja (lentillas).
hk_option_payment_by_subscription	string	Indica si el pago es por suscripción.
hk_option_subscription_unique_id	string	ID único de la suscripción asociada al line item.
hk_product_subtype	string	Subtipo de producto desnormalizado desde Product (para uso en lógica de checkout).
hk_product_uuid	string	UUID único del line item expuesto para transacciones Pi.
hk_producttype	string	Tipo de producto desnormalizado desde Product.
preOrderUUID	string	UUID original del line item antes de convertirse en pedido (flujo pre-order).

---

Profile

La extensión de Profile (cliente registrado) añade 18 atributos custom agrupados en GDPR, TaxJar, SSC, Stripe y datos operativos.

GDPR

Atributo	Tipo	Descripción
HW_flag_privacy_policy_term_conditions	boolean	Consentimiento: Política de Privacidad y Términos y Condiciones.
HW_flag_privacy_policy_term_conditions_accepted_at	datetime (externally-managed)	Fecha/hora de aceptación de los T&C.
HW_flag_gdpr_receive_commercial_information_from_brand	boolean	Consentimiento: recibir comunicaciones comerciales personalizadas de la marca.
familyStatus	enum-of-string	Estado familiar (valores no definidos en el XML).

TaxJar (exención fiscal USA)

Atributo	Tipo	Descripción
TaxJarCustomerExemptionType	enum-of-string	Tipo de exención fiscal: non_exempt (defecto) · wholesale · government · marketplace · other.
TaxJarCustomerExemptionRegions	enum-of-string (multi-select)	Estados de EE. UU. donde aplica la exención (51 valores, de AL a WY).

Salesforce Service Cloud Connector

Atributo	Tipo	Descripción
sscSyncStatus	enum-of-string	Estado de sincronización con SSC: exported · created · updated.
sscSyncResponseText	set-of-string	Respuesta del último intento de sincronización con SSC.
sscid	string	ContactId / AccountId de Salesforce Service Cloud.
sscid18	string	Account Id18 de Salesforce Service Cloud.

Stripe

Atributo	Tipo	Descripción
stripeCustomerID	string	ID de cliente en Stripe.

Datos operativos y preferencias

Atributo	Tipo	Descripción
hk_countryCode	enum-of-string	País del cliente (37 países: AD, AU, AT, BE, BG, CO, HR, CY, CZ, DK, EE, FI, FR, DE, GR, HU, IE, IT, LV, LT, LU, MY, MT, MX, NL, NZ, PL, PT, RO, SG, SK, SI, ES, SE, GB, US).
hk_phonePrefix	string	Prefijo telefónico internacional.
hk_preferred_store	string	Tienda preferida del cliente.
hk_original_preferred_store	string	Tienda preferida original (antes de cambios).
hk_real_time_orders	int	Número de pedidos realizados por el usuario (tiempo real).
hk_subscribepro_id	string	ID de cliente en la plataforma Subpro (suscripciones).
paypalBillingAgreementData	string	Datos del Billing Agreement de PayPal del cliente.

Grupos de atributos en BM (Profile)

Grupo	Atributos destacados
Standard	salutation, firstName, lastName, gender, birthday, email, hk_countryCode, hk_preferred_store
Phone	hk_phonePrefix, phoneMobile, phoneHome, phoneBusiness, fax
ServiceCloudConnector	sscSyncStatus, sscid, sscid18, sscSyncResponseText
Stripe	stripeCustomerID
TaxJar	TaxJarCustomerExemptionType, TaxJarCustomerExemptionRegions
LegalTermsAndConditions	HW_flag_privacy_policy_term_conditions, HW_flag_privacy_policy_term_conditions_accepted_at
GDPR	HW_flag_gdpr_receive_commercial_information_from_brand
subscribePro	hk_subscribepro_id
customerOrders	hk_real_time_orders

---

Promotion

La extensión de Promotion añade 13 atributos para controlar la visualización de la promoción en el storefront (badge aplicado, approaching promotion y label de producto).

Applied Promotion — badge de descuento aplicado

Atributo	Tipo	Localizable	Descripción
appliedText	string	Sí	Texto HTML opcional que se muestra en el badge de promoción aplicada.
appliedBackgroundColor	string	No	Color de fondo del badge (p.ej. red, black).
appliedTextColor	string	No	Color del texto del badge.
isVisibleInCustomerArea	boolean	No	Si false, la promoción no se muestra en el área de cliente.

Approaching Promotion — barra de progreso hacia descuento

Atributo	Tipo	Descripción
approachingPromotionContentAssetName	string	Prefijo del content asset para el mensaje de aproximación (p.ej. 2x1_). Se concatena con los valores X e Y de la condición.
approachingPromotionLocale	enum-of-string (multi)	Locales donde se muestra el approaching promotion (26 valores: en, de, fr, es_ES, es_MX, es_CO, es_CL, it_IT, fr_FR, pt_PT, el_GR, en_GB, de_DE, en_AU, en_US, en_SG, en_MY, fr_BE, en_NL, fr_LU, en_PL, en_BG, en_SE, en_CZ, en_DK, en_RO).
approachingPromotionType	enum-of-string	Tipo de regla de promoción: 1 Sin productos cualificantes · 2 Con N productos · 3 Buy X Get Y · 4 Buy X for Total · 5 Order con N productos · 6 Shipping.
approachingPromotionVisibleInPdp	boolean	Si false, no se muestra en el PDP.

Label 2 — etiqueta secundaria en tile de producto

Atributo	Tipo	Localizable	Descripción
label2Text	string	Sí	Texto del label 2 en el tile de producto.
label2BackgroundColor	string	No	Color de fondo del label 2.
label2TextColor	string	No	Color del texto del label 2.

Product Label — label de importe mínimo

Atributo	Tipo	Localizable	Descripción
productLabelContentAssetId	string	Sí	ID del content asset con el label que se muestra en el producto.
productLabelMinAmountToShowLabel	double	Sí	Precio mínimo del carrito para mostrar el label.

---

Recommendation, ReturnItem, ServiceConfig, ServiceProfile, ShippingLineItem

Estos tipos solo configuran system-attribute-definitions sin añadir atributos personalizados.

---

Return

Atributo	Tipo	Descripción
exportStatus	enum-of-string	Estado de exportación: EXPORTED · EXPORT_READY · EXPORT_FAILED.
refundStatus	enum-of-string	Estado del reembolso: NOT_USED · REFUND_REQUESTED · REFUND_FAILED · REFUNDED.

---

ReturnCase

Gestiona los casos de devolución iniciados por el cliente. 7 atributos custom.

Atributo	Tipo	Descripción
returnReason	enum-of-string	Motivo de devolución: RR_1 Cancelar · RR_2 Sin stock · RR_3 Retrasos · RR_4 Error logístico · RR_5 Devuelto al almacén · RR_6 Defectos · RR_7 Devolución · RR_8 Otros.
returnReasonOpen	string	Texto libre complementario al motivo.
step	enum-of-string	Paso en el flujo de devolución: NEW · DRAFT · APPROVED · REFUND_REJECTED · REFUND_REQUESTED · CANCELLED · REFUNDED · EXPORTED.
refundStatus	enum-of-string	Estado del reembolso (mismos valores que en Return).
totalAmount	double	Importe total de la devolución.
orderRefund	double	Reembolso a nivel de pedido sin línea de artículo asociada.
scCaseNumber	string	Número del caso en Salesforce Service Cloud.

---

ReturnCaseItem

Atributo	Tipo	Descripción
desiredPrice	double	Precio deseado por el cliente para el artículo devuelto.

---

ServiceCredential

Extiende las credenciales de servicio SFCC para almacenar tokens y claves de integraciones externas.

Atributo	Tipo	Integración	Descripción
PP_API_IsProduction	boolean	PayPal	Indica si las credenciales son de producción.
PP_API_Signature	string	PayPal	Firma de la API de PayPal.
PP_API_UseCertificate	boolean	PayPal	Usar certificado en lugar de firma.
PP_RESTAPI_TempToken	string	PayPal	Token temporal de la REST API de PayPal.
PP_RESTAPI_TempTokenExpiredTime	string	PayPal	Fecha de expiración del token temporal.
clientid	string	SSC	Consumer Key del Connected App de Service Cloud.
clientsecret	password	SSC	Consumer Secret del Connected App de Service Cloud.
worldcooToken	string	Worldcoo	Token de autenticación del servicio Worldcoo (donaciones).

---

Shipment

La extensión de Shipment añade 10 atributos para TaxJar, recogida en tienda, puntos de recogida y tracking.

TaxJar

Atributo	Tipo	Descripción
TaxJarOrderLastSyncDateTime	datetime (externally-managed)	Fecha/hora de la última sincronización con TaxJar.
TaxJarOrderLastSyncHash	string (externally-managed)	Hash del último envío a TaxJar (evita llamadas redundantes).

Recogida en tienda (Store Pickup)

Atributo	Tipo	Descripción
fromStoreId	string	ID de la tienda física asociada al envío.
storePickupMessage	string	Mensaje del cliente para la tienda sobre el envío.
shipmentType	string	Cuando vale instore, el checkout asigna el método de envío sin cargo (005).

Punto de recogida (Pick-Up Point)

Atributo	Tipo	Descripción
hk_pickUpPointId	string	ID del punto de recogida.
hk_pickUpPointCarrier	string	Transportista del punto de recogida.

Tracking

Atributo	Tipo	Descripción
hk_shippingStatus	enum-of-int	Estado de envío: 10 En preparación · 20 Enviado · 27 Listo para recoger · 30 Entregado. Multilingual.
hk_trackingUrl	string	URL de seguimiento del envío.
hk_idTracking	string	Número de seguimiento (tracking number).

note

El atributo hk_shippingStatus de Shipment tiene los valores 10/20/27/30. El atributo homónimo en Order tiene valores adicionales (15, 25) para estados intermedios del flujo de pedido.

---

ShippingMethod

La extensión de ShippingMethod añade 8 atributos para configurar la presentación del método de envío en el storefront.

Atributo	Tipo	Localizable	Obligatorio	Descripción
estimatedArrivalTime	string	Sí	Sí	Días estimados de entrega (texto libre, p.ej. "2-3 días").
additionalInfo	string	Sí	No	Información adicional del método de envío.
description2	string	Sí	No	Segunda descripción (complementa al campo description del sistema).
customPatternDate	string	Sí	Sí	Formato de fecha personalizado por locale (p.ej. EEEE d' de 'MMMM' de 'yyyy para España).
warehouseClosingTime	string	Sí	Sí	Hora de cierre del almacén en formato 24h (p.ej. 18:30). Usado para calcular el mensaje "pide en X horas".
hoursMessageDuration	int	Sí	No	Número de horas durante las que se muestra el mensaje de entrega urgente.
storePickupEnabled	boolean	No	Sí	Indica si el método de envío permite recogida en tienda.
hideShippingMethod	boolean	No	No	Oculta el método de envío en el storefront (para productos virtuales sin envío físico).

---

ShippingOrder y ShippingOrderItem

Solo configuran system-attribute-definitions. ShippingOrder gestiona el estado CONFIRMED → WAREHOUSE → SHIPPED → CANCELLED. Sin atributos personalizados.

---

SitePreferences (parcialmente recibido)

SitePreferences es el tipo de preferencias a nivel de site en SFCC. Sus atributos custom configuran todas las integraciones de terceros y parámetros de comportamiento del storefront.

Google / GTM

Atributo	Tipo	Descripción
GoogleTagManagerID	string	ID del contenedor GTM (p.ej. GTM-XXXXXXX).
GoogleTagManagerUrl	string	URL base de GTM. Defecto: https://www.googletagmanager.com/gtm.js?id=
GoogleVerificationTag	string	Content attribute para la verificación de Google Search Console.

PayPal

Express Checkout:

Atributo	Tipo	Defecto	Descripción
PP_API_BrandName	string	—	Nombre de marca mostrado en las páginas de PayPal.
PP_API_LogoImageUrl	string	—	URL del logo (debe incluir protocolo https).
PP_API_ExpressCheckoutLandingPage	enum	Login	Página de aterrizaje: Login (cuenta PayPal) · Billing (sin cuenta).
PP_API_ExpressCheckoutSolutionType	enum	Sole	Sole = cuenta opcional · Mark = cuenta obligatoria.
PP_API_ExpressPaymentAction	enum	Authorization	Acción de pago Express: Authorization · Sale · Order.
PP_API_NoShipping	enum	0	0 Muestra dirección · 1 No muestra campos · 2 Usa la cuenta del comprador.
PP_API_ReqConfirmShipping	boolean	false	Solo aceptar direcciones confirmadas por PayPal.
PP_API_ShippingAddressOverride	boolean	false	true = dirección desde SFCC · false = dirección desde PayPal.
PP_API_RequestBillingAddressFromPayPal	boolean	true	Guardar la dirección de facturación de PayPal en el pedido.
PP_AuthorizationInCaseOfOrder	boolean	false	Ejecutar DoAuthorization inmediatamente tras PaymentAction=Order.
PP_ShowExpressCheckoutButtonOnCart	boolean	false	Mostrar botón PayPal Express en la página de carrito.
PP_LogIpnNotifications	boolean	—	Escribir notificaciones IPN en los logs (formato JSON, fichero notification).
PP_MultipleCapture	boolean	false	Permitir múltiples capturas sobre la misma autorización.
PP_SiteServiceDefinition	string	int_paypal.http.nvp.payment.PayPal	Servicio SFCC específico del site para contactar con PayPal.

Billing Agreement:

Atributo	Tipo	Defecto	Descripción
PP_BillingAgreementState	enum	DoNotCreate	DoNotCreate · RequireAllBuyers · BuyersChoose.
PP_API_BillingAgreementDescription	string	—	Descripción del Billing Agreement (máx. 126 caracteres).
PP_API_BillingAgreementPaymentType	enum	Any	Tipos de pago aceptados: Any · InstantOnly.
PP_API_BillingAgreementType	enum	MerchantInitiatedBilling	Tipo de Billing Agreement: MerchantInitiatedBilling · MerchantInitiatedBillingSingleAgreement.
PP_API_ReferenceTransactionPaymentAction	enum	Sale	Acción de pago para transacciones de referencia: Sale · Authorization · Order.
PP_Billing_Button_Config	string	—	Configuración del botón de Billing Agreement (notación JS object literal).
PP_Cart_Button_Config	string	—	Configuración del botón de carrito (notación JS object literal).

PayPal Credit / Marketing:

Atributo	Tipo	Defecto	Descripción
PP_ShowCreditFinancialBanners	boolean	false	Activar banners de PayPal UK Credit Financial Options.
PP_CreditFinancialOptionsPassword	string	—	Password para habilitar banners UK Credit (proporcionado por PayPal).
PP_CreditBannerHeight	string	100	Altura del banner de crédito (valores permitidos por PayPal).
PP_CreditBannerWidth	string	190	Anchura del banner de crédito.
PP_Credit_Campaign_ID	string	—	ID de campaña para el banner de crédito.
PP_MarketingSolutionsId	string	—	ID de PayPal Marketing Solutions.
PP_Merchant_Publisher_ID	string	—	MerchantPublisher ID para banners de financiación.

TaxJar

Atributo	Tipo	Defecto	Descripción
TaxJarEnable	boolean	true	Activa la integración con TaxJar.
TaxJarLastSyncTime	datetime	—	Timestamp de la última ejecución del job de sincronización TaxJar.
TaxJarShipFromAddress	string	—	Dirección de origen de los envíos (calle).
TaxJarShipFromCity	string	—	Ciudad de origen.
TaxJarShipFromCountryCode	string	—	Código ISO de 2 letras del país de origen.
TaxJarShipFromState	string	—	Código de estado de 2 letras (EE. UU.).
TaxJarShipFromZip	string	—	Código postal de origen (5 dígitos o ZIP+4).

Otras integraciones

Portal de devoluciones (InPost/IF Returns):

Atributo	Tipo	Defecto	Descripción
if_returns_base_url	string	—	URL base del portal de devoluciones.
if_returns_enable_return_button	boolean	true	Mostrar el botón de devolución.
if_returns_merchant_code	string	—	Código de comercio en el portal de devoluciones.

Chat online (Salesforce Chat):

Atributo	Tipo	Descripción
HW_onlineChatPreferences	text	Preferencias del chat SC en formato JSON.

Worldcoo / donaciones — credencial en ServiceCredential.worldcooToken.

Storefront

A/B Testing:

Atributo	Tipo	Descripción
abTestHideTopSalesProducts_idTest	string	ID del test A/B para ocultar productos top venta.
abTestHideTopSalesProducts_idFilter	string	ID del filtro del test A/B.
abTestHideTopSalesProducts_idSegment	string	ID del segmento del test A/B.
abTestHideTopSalesProducts_productIds	text	Lista de SKUs a ocultar (SKU_1,SKU_2,...).

Accesibilidad:

Atributo	Tipo	Defecto	Descripción
accessibilityWidgetInHeader	boolean	false	Mostrar el icono de accesibilidad en la cabecera.
accessibilityWidgetInFooter	boolean	false	Mostrar el widget de accesibilidad en el footer.
accessibilityWidgetPreferences	text	—	Configuración del widget (JSON).

Checkout y registro:

Atributo	Tipo	Defecto	Descripción
checkoutAllowFastSignUpAndLogin	boolean	false	Permitir registro rápido y login durante el checkout.
checkoutAllowFastSignUpAndLoginThankYouPage	boolean	false	Permitir registro rápido en la Thank You page.
checkTLS	boolean	false	Activar verificación TLS basada en cookie dw_TLSWarning.

Lentillas y suscripciones:

Atributo	Tipo	Defecto	Descripción
contactLensesMasterProductId	string	—	ID del producto master de lentillas.
contactLensesProductIdToAddSubscription	string	—	SKU del producto para redirigir al usuario al añadir nueva suscripción.

Carrito y contenidos:

Atributo	Tipo	Defecto	Descripción
cartContentAssetIdForAddExtraItem	string	cart-add-extra-item	ID del content asset con info para añadir producto extra en carrito.
contactPageContentAssetId	string	page-contact	ID del content asset de la página de Contacto.
applePayVerificationString	text	—	String de verificación de Apple Pay (obtenido desde Stripe console).
buildNotificationEmailList	string	—	Lista de emails para notificaciones de build (separados por ;).
bulkCallThreshold	double	10	Nº de objetos por llamada bulk en jobs de SSC. Mín. 1.
basketExcludedSubtypesForMeasurableItems	enum-of-string (multi)	—	Subtipos de producto excluidos al calcular el límite de ítems del carrito.

Área de cliente

Atributo	Tipo	Defecto	Descripción
countryCode	enum	ES	País por defecto para búsquedas de tienda: ES · GB · IT · PT · DE · GR · FR.
customerAreaEnabled	boolean	false	Habilitar acceso al área de usuario.
customerAreaMenuPaymentMethodsVisible	boolean	false	Mostrar la sección de métodos de pago en el menú del área de usuario.
customerAreaMenuContactLensesSubscriptionsVisibleByCountry	enum (multi)	es	Países donde se muestra la sección de suscripciones a lentillas: de · es · fr · eu · gr · it · gb · pt.
customerAreaMessageAcceptTermsAndConditionsForContest	string	—	Mensaje de aceptación de T&C para concurso.
customerAreaContentAssetIdForPromos	string	customer-area-promos	ID del content asset con información de promos del área de usuario.
customerServiceEmail	string	noreply@salesforce.com	Email del servicio al cliente.

Imagen, DIS y UI

Atributo	Tipo	Defecto	Descripción
disImageSourceEnvironment	enum	—	Entorno origen de imágenes DIS: PRD · STG · DEV · s01–s05.
disableResponsiveDesign	boolean	false	Desactivar el diseño responsive del storefront.
headerLogoImage	image	—	Imagen del logo del header.
faviconsContentAssetId	string	favicons	ID del content asset con el código de favicons.
footerIdContentAssetForContent	string	footer-content	ID del content asset con la configuración del footer.
hideLegalCheckboxInCart	boolean	false	Ocultar el checkbox legal en la página de carrito.
hk_showSearchIconInHeader	boolean	true	Mostrar el icono de búsqueda en la cabecera.
hk_showStoreLocatorIconInHeader	enum (multi)	—	Países donde se muestra el icono de localizador de tiendas en la cabecera (23 valores: eu · de · au · be · bg · cz · co · dk · es · us · fr · gr · it · lu · my · mx · nl · pl · pt · gb · ro · sg · se).
debugBearRUMEnabled	boolean	false	Activar Real User Monitoring de Web Vitals (DebugBear).

Configuración general del site

Atributo	Tipo	Defecto	Descripción
enableHrefLang	boolean	false	Activar etiquetas hreflang en el storefront.
enableLogin	boolean	false	Activar el login de usuarios.
enableMultiShipping	boolean	true	Activar checkout multi-envío.
enableStorePickUp	boolean	true	Activar la funcionalidad de recogida en tienda.
gcMaxSiteAmount	int	5000	Importe máximo de un gift certificate.
gdprShowPopup	boolean	false	Mostrar popup GDPR en el carrito.
dataFeedId	string	—	ID del data feed de Instagram (Foursixty).
mapAPI	string	—	API key de Google Maps.
mastersPlpCategoryId	string	—	ID de la categoría para la PLP de masters.
maxLimitCart	int	10	Límite máximo de ítems totales en el carrito (máx. 50).
maxLimitCartForUnmeasurableItems	int	60	Límite para productos que no computan en el total del carrito.

Google Places y reCaptcha

Atributo	Tipo	Defecto	Descripción
googlePlacesEnabled	boolean	true	Activar autocompletado de direcciones con Google Places.
googlePlacesMinCharactersToAutocompleteAddressesStarted	int	3	Mínimo de caracteres para iniciar el autocompletado.
googleRecaptchaApiKey	string	—	API key de Google reCaptcha.
googleRecaptchaId	string	—	ID de Google reCaptcha.
googleRecaptchaProjectId	string	—	ID del proyecto en Google reCaptcha.

Donaciones (Worldcoo)

Atributo	Tipo	Descripción
donationsEnabled	boolean	Mostrar el módulo de donaciones.
donationProductID	set-of-string	SKU(s) del producto de donación.
donationsCountriesAvailables	enum (multi)	Países donde está disponible la donación: es · eu · it · de · co · mx · pt · gr · fr · us · gb · au.

Einstein Recommender

Atributo	Tipo	Defecto	Descripción
hw_enableSimilarProductsRecommender	boolean	false	Activar el recomendador de productos similares.
hw_recommenderPDP	string	product-to-product-test	ID de Einstein para el recomendador de la PDP.
hw_recommenderPDPForAddons	string	—	ID de Einstein para complementos en la PDP.
hw_recommenderAfterProductAddedToCart	string	—	ID de Einstein para el recomendador tras añadir al carrito.
hw_recommenderCartForAddons	string	—	ID de Einstein para complementos en el carrito.
hw_recommenderErrorPage	string	error-page	ID de Einstein para la página de error.
hw_recommenderSearcher	string	—	ID de Einstein para el buscador.

Klarna Payments (kp*)

Configuración general:

Atributo	Tipo	Defecto	Descripción
klarnaMessagingEnabled	boolean	false	Activar mensajes de Klarna en la PDP.
klarnaMessagingClientId	string	—	Client ID para el messaging de Klarna.
kpServiceName	string	klarna.http.defaultendpoint	Nombre del servicio SFCC para el site.
kpAttachments	boolean	false	Incluir EMD (customer_account_info, other_delivery_address) en el pedido.
kpAutoCapture	boolean	false	Captura automática del importe total al crear el pedido.
kpPromoTaxation	enum	price	Cálculo de impuestos sobre promociones: price · adjustment.
kpRejectedMethodDisplay	enum	no	Comportamiento tras rechazo duro de Klarna: no · hide · greyout.
kpNotAvailableMessage	text	—	JSON con mensajes por país cuando Klarna no está disponible.
merchant_reference2_mapping	string	—	Campo del objeto LineItemCtnr mapeado a merchant_reference2 en la API de Klarna.

VCN (Virtual Card Number):

Atributo	Tipo	Defecto	Descripción
kpVCNEnabled	boolean	false	Generar un Virtual Card Number por cada pedido Klarna.
kpVCNRetryEnabled	boolean	false	Reintentar la liquidación VCN en caso de error de servicio.
kpVCNkeyId	string	—	UUIDv4 del par de claves VCN (proporcionado por Klarna para PRD y Playground).

Estilos del iFrame de Klarna — todos son string con valor CSS hexadecimal:

kpColorBorder · kpColorBorderSelected · kpColorButton · kpColorButtonText · kpColorCheckbox · kpColorCheckboxCheckmark · kpColorDetails · kpColorHeader · kpColorLink · kpColorText · kpColorTextSecondary · kpRadiusBorder (píxeles)

Marketing Cloud (mc*)

Atributo	Tipo	Defecto	Descripción
mcMID	string	—	Member ID (MID) del Business Unit de Marketing Cloud.
mcEnableAnalytics	boolean	true	Activar tracking de Marketing Cloud Analytics.
mcIncludeTrackingLink	boolean	true	Incluir el tracking link de MC Analytics en el storefront.
mcEnableMailingLists	boolean	true	Activar funcionalidad de mailing lists de Marketing Cloud.
mcUnsubscribeAllowed	boolean	false	Usar Unsubscribe en lugar de Delete al dar de baja de listas.
mcCollectJsUrl	string	//MCMID.collect.igodigital.com/collect.js	URL del script collect.js (debe contener MCMID).
mcSiteServiceDefinition	string	marketingcloud.rest.auth	Servicio SFCC específico del site para Marketing Cloud.
mcDefaultMailingLists	set-of-int	—	IDs de listas de correo por defecto al suscribirse.
mcMailingListsWhitelist	set-of-int	—	Whitelist de listas de correo (vacío = todas).

Mercado Pago (mp*)

Atributo	Tipo	Descripción
mpEnabled	boolean	Activar Mercado Pago.
mpPublicKey	string	Public Key de Mercado Pago.
mpClientId	string	Client ID de Mercado Pago.
mpAccessToken	password	Access Token de Mercado Pago (producción).
mpClientSecret	password	Client Secret de Mercado Pago.
mpInstallments	int	Número máximo de cuotas disponibles.
mpExcludedPaymentMethods	text	JSON con métodos de pago excluidos: [{"id":"Master"},...].

Logs, caché y seguridad

Atributo	Tipo	Defecto	Descripción
orderFlowLogEnabled	enum	false	Activar logs personalizados en el flujo de creación de pedidos: false No · true Yes.
promoCacheIsActive	boolean	true	Activar la caché de promociones.
rateLimiterThreshold	int	5	Nº de fallos permitidos en login, gift cert y order tracking antes de mostrar CAPTCHA. Mín. 0.
qrUserCodeVisible	boolean	false	Mostrar el código QR de usuario.
setTrueGdprFlagsUponOrder	boolean	false	Marcar automáticamente los flags GDPR como true al crear un pedido.
sscIsAsync	boolean	—	Modo asíncrono para SSC: true = jobs sincronizan · false = tiempo real + jobs como fallback.
sendProductAndImageURLs	boolean	true	Incluir product_url e image_url en las llamadas de Klarna (mejora post-compra).

PDP — content assets y configuración

Atributo	Tipo	Defecto	Descripción
pdpCarouselMultimediaDefault	string	image-F,image-L,image-D1,image-D2,image-D3,image-LS1,image-LS2,image-LS3,image-P	Orden por defecto de los archivos en el carrusel multimedia de la PDP.
pdpFastSignUpEnable	boolean	false	Mostrar el formulario de registro rápido en la PDP.
pdpIdContentAssetContactLensesDetails	string	pdp-contact-lenses-details	Content asset con info sobre lentillas y suscripciones.
pdpIdContentAssetForDeliveryInformation	string	product_delivery_text	Content asset con información sobre tipos de envío.
pdpIdContentAssetForFastSignUp	string	pdp-fast-sign-up-form	Content asset con el formulario de registro rápido.
pdpIdContentAssetForPaymentDetails	string	footer-payment-method-icons	Content asset con información sobre métodos de pago.
pdpIdContentAssetForShippingDetails	string	pdp-details-shipping	Content asset con detalles de envío.
pdpIdContentAssetForWarrantyAndReturnsDetails	string	pdp-details-warranty-and-returns	Content asset con información de garantía y devoluciones.

PLP

Atributo	Tipo	Defecto	Descripción
plpIdSortingRulePersonalizedByCustomer	string	PersonalizedByCustomer	ID de la regla de ordenación personalizada por usuario en la PLP.

Emails de devoluciones

Atributo	Tipo	Descripción
returnsEmailMessageEnabled	boolean	Activar el envío de emails durante el flujo de devoluciones.
returnsEmailMessageApproved	string	Mensaje del email cuando la devolución es aprobada.
returnsEmailMessageConfirmed	string	Mensaje del email cuando la devolución es confirmada.
returnsEmailMessageRefunded	string	Mensaje del email cuando el reembolso se ha procesado.
returnsEmailMessageRejected	string	Mensaje del email cuando la devolución es rechazada.

SFRA Plugins

Estos flags activan/desactivan los plugins del SFRA Unified Feature Cartridge. Todos son boolean con defecto true.

Atributo	Plugin (cartridge)
sfraEnableOverlayApplePay	plugin_applepay
sfraEnableOverlayDataDownload	plugin_datadownload
sfraEnableOverlayGiftRegistry	plugin_giftregistry
sfraEnableOverlayInStorePickup	plugin_instorepickup
sfraEnableOverlayProductCompare	plugin_productcompare
sfraEnableOverlayWishlist	plugin_wishlists

Tiendas físicas y localización

Atributo	Tipo	Defecto	Descripción
storeDeliveryEnabled	enum (multi)	—	Países donde está activo el envío a tiendas (23 países, misma lista que hk_showStoreLocatorIconInHeader).
storeDeliveryIncludesPickUpPoints	boolean	—	Incluir puntos de recogida en el envío a tiendas.
shippingMethodsIdForStoreDelivery	string	—	ID del método de envío para entrega en tienda.
storeAvailabilityEnabled	enum (multi)	—	Países donde se muestra la disponibilidad en tienda en la PDP (23 países).
storeLookupMaxDistance	enum-of-int	75	Distancia máxima de búsqueda de tienda: 50 · 75 · 100 · 150 · 200.
storeLookupUnit	enum	mi	Unidad de distancia: km · mi.
storeRadiusToSearch	int	6371	Radio (en km) para buscar tiendas y puntos de recogida.

Stripe

Configuración general:

Atributo	Tipo	Defecto	Descripción
stripeEnabled	boolean	true	Activar la integración con Stripe.
stripeAccountType	enum	STRIPE_TEST	Modo de cuenta: STRIPE_TEST · STRIPE_LIVE.
stripeAccountId	string	—	ID de cuenta de Stripe.
stripePublicKey	string	—	Publishable Key de Stripe.
stripeApiKey	string	—	API Key (secret) de Stripe.
stripeApiURL	string	https://js.stripe.com/v3/	URL del script JS de Stripe.
stripeApiVersion	string	2020-08-27	Versión de la API de Stripe.
stripeWebhookSigningSecret	string	—	Signing Secret para validar los webhooks de Stripe.
stripeIsSFRA	boolean (obligatorio)	false	Indica si es una instalación SFRA.
stripeKlarnaApiURL	string	https://x.klarnacdn.net/kp/lib/v1/api.js	URL del script de Klarna usado por Stripe.

Comportamiento de pago:

Atributo	Tipo	Defecto	Descripción
stripeChargeCapture	boolean	true	true = captura inmediata · false = solo autorización.
stripeConfirmPaymentIntent	boolean	true	Confirmar automáticamente el Payment Intent.
stripeCustomCreditCardForm	boolean	false	Usar formulario de tarjeta personalizado.
stripeSaveCustomerCards	enum	disabled	Guardar tarjetas: always · ask · disabled.
stripePaymentElementsSavePayments	boolean	true	Permitir guardar métodos de pago para compras futuras.
stripeDisplayRiskScoreData	boolean	true	Mostrar datos de puntuación de riesgo en BM.
stripeUpdateInvoiceOnRefundWebhook	boolean	false	Actualizar la factura SFCC al recibir el webhook charge.refunded.
stripeAccountCountryCode	string	US	Código de país para el Payment Request Button.
stripeAllowedWebHookStatuses	set-of-string	—	Estados de webhook que se almacenan en Custom Objects.
stripePaymentMethodsInBeta	set-of-string	—	Métodos de pago de Stripe aún en early release.
stripeAllowedAPMMethods	text	—	JSON con los métodos APM permitidos por locale (p24, eps, sepa_debit, ideal, sofort…).

Estilos CSS de los elementos Stripe — todos son string:

stripeCardElementCSSStyle · stripePaymentElementStyle · stripeEpsElementCSSStyle · stripeIdealElementCSSStyle · stripeP24ElementCSSStyle · stripeSepaDebitCSSStyle · stripePaymentRequestButtonStyle

Subpro (suscripciones)

Atributo	Tipo	Descripción
subproClientID	string	Client ID de la plataforma Subpro.
subproClientSecret	string	Client Secret de la plataforma Subpro.

Trustpilot (site)

Atributo	Tipo	Defecto	Descripción
trustpilotEnabled	boolean	false	Activar la integración con Trustpilot.
trustpilotBusinessUnitId	string	—	ID del Business Unit en Trustpilot.
trustpilotScore	double	—	TrustScore del site (sincronizado desde Trustpilot).
trustpilotStars	double	—	Puntuación en estrellas del site.
trustpilotTotalReviews	int	—	Total de reseñas del site.

Klarna VCN — claves SSL

Atributo	Tipo	Descripción
vcnPrivateKey	text	Clave SSL privada para desencriptar la información del Virtual Card Number.
vcnPublicKey	text	Clave SSL pública para la integración VCN.

Virtual Try-On — Fittingbox (vto*)

Atributo	Tipo	Defecto	Descripción
vtoApiKey	string	—	API Key de Fittingbox (probador virtual).
vtoScriptUrl	string	—	URL del script de la librería de Fittingbox.
vtoProductAttributeId	string	hk_showVirtualTryOn	Atributo de producto que determina si se muestra el probador virtual.
vtoMaxProductsPerCall	int	15	Máximo de productos por llamada al abrir el VTO.
vtoSortingRuleId	string	—	ID de la regla de ordenación de productos dentro del VTO.
vtoUrlParameterNameToInitVirtualTryOnInPdp	string	openVtoAfterLoad	Nombre del parámetro URL para abrir el VTO al cargar la PDP.
vtoUrlParameterValueToInitVirtualTryOnInPdp	string	yes	Valor del parámetro URL para abrir el VTO.

Mercado Pago — adicionales

Atributo	Tipo	Defecto	Descripción
mpRedirectFlag	boolean	false	Si true, redirige al usuario a la página de Mercado Pago en lugar de mostrar el popup de checkout.
mpAutoreturnConfig	enum	—	Configuración de autoretorno: approved · all.

Precios

Atributo	Tipo	Defecto	Descripción
roundPrices	boolean	false	Activar el redondeo de precios (por defecto, redondeo a la baja).

Grupos de Business Manager

SitePreferences tiene 38 grupos en BM:

Grupo (group-id)	Atributos incluidos
Storefront Configs	GTM, countryCode, customerServiceEmail, mapAPI, googlePlaces, gcMaxSiteAmount, enableHrefLang, promoCacheIsActive, orderFlowLogEnabled, hideLegalCheckboxInCart, roundPrices, faviconsContentAssetId, debugBearRUMEnabled, basketExcludedSubtypes, maxLimitCart(s)
Returns	returnsEmailMessage* (5 attrs)
iF returns Configuration	if_returns_base_url · if_returns_enable_return_button · if_returns_merchant_code
Dynamic Imaging Service	disImageSourceEnvironment
FourSixty	dataFeedId
Paypal_Branding	PP_Merchant_Publisher_ID · PP_API_BrandName · PP_API_LogoImageUrl · PP_Credit_Campaign_ID · PP_CreditBanner* · PP_MarketingSolutionsId · PP_ShowCreditFinancialBanners · PP_CreditFinancialOptionsPassword
Paypal_Express_Checkout	PP_SiteServiceDefinition · PP_ShowExpressCheckoutButtonOnCart · PP_API_ExpressPaymentAction · PP_API_ReferenceTransactionPaymentAction · PP_AuthorizationInCaseOfOrder · PP_BillingAgreement* · PP_API_ShippingAddressOverride · PP_API_Request* · PP_API_ExpressCheckout* · PP_API_NoShipping · PP_MultipleCapture · PP_LogIpnNotifications · PP_Cart_Button_Config · PP_Billing_Button_Config
Marketing Cloud	mcSiteServiceDefinition · mcEnableAnalytics · mcMID · mcIncludeTrackingLink · mcCollectJsUrl · mcEnableMailingLists · mcDefaultMailingLists · mcMailingListsWhitelist · mcUnsubscribeAllowed
SFRA Unified Feature Cartridge	sfraEnableOverlay* (6 plugins)
ServiceCloudConnector	sscIsAsync · bulkCallThreshold
Stripe Configs	stripeApiKey · stripePublicKey · stripeIsSFRA · stripeChargeCapture · stripeCardElementCSSStyle · stripeApiURL · stripePaymentRequestButtonStyle · applePayVerificationString · stripeAccountCountryCode · stripeWebhookSigningSecret · stripeAllowedWebHookStatuses · stripeAllowedAPMMethods · stripeSaveCustomerCards · stripeEnabled · stripeCustomCreditCardForm · stripeUpdateInvoiceOnRefundWebhook · stripePaymentMethodsInBeta · stripeApiVersion · stripeAccountId · stripeAccountType · stripePaymentElementStyle · stripePaymentElementsSavePayments · stripeDisplayRiskScoreData
PDP	pdpIdContentAsset* (7 attrs) · pdpFastSignUpEnable · pdpCarouselMultimediaDefault
chat	HW_onlineChatPreferences
Donations_Worldcoo	donationsCountriesAvailables · donationsEnabled · donationProductID
TaxJar	TaxJarEnable · TaxJarShipFromCountryCode · TaxJarShipFromState · TaxJarShipFromZip · TaxJarShipFromCity · TaxJarShipFromAddress · TaxJarLastSyncTime
Klarna_Payments	kpAutoCapture · sendProductAndImageURLs · merchant_reference2_mapping · kpColor* (11 colores + kpRadiusBorder) · kpAttachments · kpNotAvailableMessage · kpVCNEnabled · kpVCNkeyId · vcnPrivateKey · vcnPublicKey · kpVCNRetryEnabled · kpPromoTaxation · kpRejectedMethodDisplay
Mercadopago	mpEnabled · mpPublicKey · mpAccessToken · mpClientId · mpClientSecret · mpRedirectFlag · mpExcludedPaymentMethods · mpInstallments
ContactLenses	contactLensesMasterProductId · contactLensesProductIdToAddSubscription
CustomerArea	customerAreaEnabled · customerAreaMenuPaymentMethodsVisible · customerAreaMenuContactLensesSubscriptionsVisibleByCountry · qrUserCodeVisible · customerAreaMessageAcceptTermsAndConditionsForContest · customerAreaContentAssetIdForPromos
Google_Recaptcha	googleRecaptchaId · googleRecaptchaProjectId · googleRecaptchaApiKey
Accessibility_Widget	accessibilityWidgetInHeader · accessibilityWidgetInFooter · accessibilityWidgetPreferences
Checkout	checkoutAllowFastSignUpAndLogin · checkoutAllowFastSignUpAndLoginThankYouPage
Contact_Page	contactPageContentAssetId
Footer	footerIdContentAssetForContent
GDPR	setTrueGdprFlagsUponOrder · gdprShowPopup
Header	headerLogoImage · hk_showSearchIconInHeader · hk_showStoreLocatorIconInHeader
Prices	roundPrices
Recommenders	hw_recommender* (7 attrs)
KlarnaMessaging	klarnaMessagingEnabled
subscribePro	subproClientID · subproClientSecret
MasterPLP	mastersPlpCategoryId
PLP	plpIdSortingRulePersonalizedByCustomer
ShippingMethods	shippingMethodsIdForStoreDelivery
abTestHideTopSalesProducts	abTestHideTopSalesProducts_idTest · _idSegment · _productIds · _idFilter
cart	cartContentAssetIdForAddExtraItem
stores	storeDeliveryEnabled · storeAvailabilityEnabled · storeRadiusToSearch · storeDeliveryIncludesPickUpPoints
trustpilot	trustpilotEnabled · trustpilotBusinessUnitId · trustpilotStars · trustpilotScore · trustpilotTotalReviews
VirtualTryOn	vtoScriptUrl · vtoApiKey · vtoProductAttributeId · vtoMaxProductsPerCall · vtoSortingRuleId · vtoUrlParameterName/ValueToInitVirtualTryOnInPdp

---

SlotConfiguration

Solo system attrs (UI). Configura el enum del campo rank:

rank — valores permitidos: 10 · 20 · 30 · 40 · 50 (defecto) · 60 · 70 · 80 · 90 · 100.

---

SourceCodeGroup

Solo system attrs (UI): ID, UUID, creationDate, lastModified. Sin atributos personalizados.

---

Store

System attrs

Extiende el enum de countryCode con la lista completa de países donde Hawkers opera tiendas físicas (59 valores):

US · CA · ES · FR · IT · JP · CN · GB · DE · AD · GR · VA · PT · AT · BY · BE · BA · BG · HR · CY · CZ · DK · EE · FI · GE · HU · IS · IE · LV · LI · LT · LU · MT · MC · ME · MA · NL · NO · PL · RO · SM · RS · SK · SI · SE · CH · GI · GG · JE · IM · AU · NZ · CO · CL · MY · SG · MX · EU

Otros system attrs: creationDate · email · fax · image · inventoryListID · lastModified · latitude · longitude · name · phone · posEnabled · postalCode · stateCode · storeEvents · storeHours · storeLocatorEnabled

Custom attrs

Atributo	Tipo	Descripción
HK_MYBUSINESS	string	URL del perfil de Google My Business de la tienda.
countryCodeValue	string	Código de país en formato para los valores del formulario.
hk_storePickUpEnabled	boolean	Activar la recogida en tienda (in-store pickup).
hk_optics	boolean	La tienda tiene servicio de óptica.
hk_outlookBookingUrl	string	URL de la página de reserva de citas en Outlook.
inventoryListId	string	ID de la lista de inventario de la tienda.

Grupos de Business Manager

Grupo	Atributos
Basic	ID · name · inventoryListID · hk_storePickUpEnabled
Address	address1 · address2 · postalCode · city · stateCode · countryCode · longitude · latitude · countryCodeValue
Contact	phone · fax · email
Details	storeHours · storeEvents · image · longitude · posEnabled · latitude · HK_MYBUSINESS · hk_optics · hk_outlookBookingUrl
Inventory	inventoryListId

---

StoreGroup

Solo system attrs (UI): ID, UUID, creationDate, lastModified, name. Sin atributos personalizados.

---

TrackingInfo

Solo system attrs (UI): ID, carrier, carrierService, trackingNumber, warehouseID. Sin atributos personalizados.

---

TrackingRef

Type-extension vacío — no añade ni system attrs ni custom attrs.