Archivo de entrada XML de promociones
Puede utilizar un archivo de entrada XML para crear o cambiar promociones para una tienda. Cuando está creando un archivo de entrada para cargar datos de promociones, puede incluir varios valores y elementos XML en el archivo. Los elementos XML que debe incluir en el archivo de entrada dependen de las propiedades, la descripción, las condiciones de compra, las bonificaciones y los métodos de canje para las promociones que está cargando.
- <Base>
- Los elementos dentro de este elemento padre definen las propiedades de identificación y generales para una promoción.
- <Descripción>
- La información de descripción de promoción. Incluya un elemento
<Description>
distinto por cada idioma definido al que la tienda da soporte para la promoción. - <Elementos>
- La información de bonificación y condición de compra de promoción. Cada elemento hijo directo
<Type>
en el elemento<Elements>
es un tipo separado de condición o bonificación.
Cuando se crea el archivo de entrada para cargar datos de promoción, debe utilizar el nombre correcto para los elementos XML hijos en los elementos <Base>
y <Description>
. No es necesario establecer un valor para cada uno de los siguientes elementos. Si no establece un valor para uno de los siguientes elementos, el programa de utilidad de carga de datos establece el valor para la columna de base de datos correspondiente para que sea nulo.
Elementos XML dentro de la sección <Base>
Cuando se crea el archivo de entrada para cargar datos de promoción, debe utilizar el nombre correcto para los elementos XML hijos en la sección <Base>
. No es necesario establecer un valor para cada uno de los siguientes elementos. Si no establece un valor para uno de los siguientes elementos, el programa de utilidad de carga de datos establece el valor para la columna de base de datos correspondiente para que sea nulo.
PromotionId
- El ID exclusivo para la promoción. Debe incluir este elemento cuando está cambiando promociones. Si está creando una promoción con el programa de utilidad de carga de datos, no incluya este valor. Al crear una promoción, utilice el elemento AdministrativeName.
Este elemento se correlaciona con PX_PROMOTION.PX_PROMOTION_ID
AdministrativeName
- El nombre administrativo de la promoción. Debe incluir este elemento cuando esté creando promociones. El programa de utilidad de carga de datos utiliza este elemento para resolver un ID para la promoción. Si la operación de carga encuentra un valor duplicado para el nombre administrativo, el programa de utilidad de carga de datos no carga la promoción con el nombre duplicado.
Se correlaciona con PX_PROMOAUTH.ADMINSTVENAME
PromotionGroupIdentifier
- El nombre del grupo de promociones al que pertenece la promoción.
Se correlaciona con PX_GROUP.GRPNAME
PromotionGroupStoreIdentifier
- El identificador de la tienda que es propietaria del grupo de promociones al que pertenece la promoción.
Se correlaciona con PX_GROUP.STOREENT_ID
Comments
- Los comentarios de la promoción
Se correlaciona con PX_PROMOAUTH.COMMENTS
Priority
- La prioridad de la promoción.
Se correlaciona con PX_PROMOTION.PRIORITY
Exclusive
- La exclusividad de la promoción. Puede incluir los siguientes valores para este elemento.
- 0
- La promoción puede combinarse con cualquier otra promoción.
- 1
- La promoción no puede combinarse con cualquier otra promoción que esté en el mismo grupo de promociones.
- 2
- La promoción no puede combinarse con ninguna otra promoción.
- 3
- La promoción no puede combinarse con ninguna promoción que se encuentre en el grupo de promociones a nivel de producto.
- 4
- La promoción puede acumularse a otras promociones que están en el mismo grupo de promociones.
Se correlaciona con PX_PROMOTION.EXCLSVE
LastUpdateByLogonId
- El ID de inicio de usuario del usuario de negocio que ha modificó la promoción por última vez.
Se correlaciona con PX_PROMOTION.LOGONID
PerOrderLimit
- El número de veces que la promoción se puede aplicar a un solo pedido. El valor predeterminado es
-1
, que no establece límite.Se correlaciona con PX_PROMOTION.PERORDLMT
PerShopperLimit
- El número de veces que un comprador puede canjear esta promoción. El valor predeterminado es
-1
, que no establece límite.Se correlaciona con PX_PROMOTION.PERSHOPPERLMT
ApplicationLimit
- El límite general que la promoción puede canjearse. El valor predeterminado es
-1
, que no establece límite.Se correlaciona con PX_PROMOTION.TOTALLMT
TargetSales
- La cifra de ventas de destino para la promoción.
Se correlaciona con PX_PROMOTION.TGTSALES
PromotionTypeName
- El tipo de regla de promoción.
Se correlaciona con PX_PROMOAUTH.PROMOTIONTYPE
ControlParameter
- Información de control para la interfaz de usuario.
Se correlaciona con PX_PROMOAUTH.CTLPARAM
StartDate
- La fecha de inicio de la promoción.
Se correlaciona con PX_PROMOTION.STARTDATE
EndDate
- La fecha de finalización de la promoción.
Se correlaciona con PX_PROMOTION.ENDDATE
DailyStartTime
- La hora de inicio diaria para la promoción (por ejemplo: 2000/01/01).
Se correlaciona con PX_PROMOAUTH.DAILYSTARTTIME
DailyEndTime
- La hora de finalización diaria para la promoción (por ejemplo: 2000/01/01).
Se correlaciona con PX_PROMOAUTH.DAILYENDTIME
Sunday
- Indica si la promoción está disponible los domingos. Puede incluir los siguientes valores para este elemento.
- 0
- La promoción no está disponible.
- 1
- La promoción está disponible.
Se correlaciona con PX_PROMOAUTH.WEEKDAY_SUN
Monday
- Indica si la promoción está disponible los lunes. Puede incluir los siguientes valores para este elemento.
- 0
- La promoción no está disponible.
- 1
- La promoción está disponible.
Se correlaciona con PX_PROMOAUTH.WEEKDAY_MON
Tuesday
- Indica si la promoción está disponible los martes. Puede incluir los siguientes valores para este elemento.
- 0
- La promoción no está disponible.
- 1
- La promoción está disponible.
Se correlaciona con PX_PROMOAUTH.WEEKDAY_TUE
Wednesday
- Indica si la promoción está disponible los miércoles. Puede incluir los siguientes valores para este elemento.
- 0
- La promoción no está disponible.
- 1
- La promoción está disponible.
Se correlaciona con PX_PROMOAUTH.WEEKDAY_WED
Thursday
- Indica si la promoción está disponible los jueves. Puede incluir los siguientes valores para este elemento.
- 0
- La promoción no está disponible.
- 1
- La promoción está disponible.
Se correlaciona con PX_PROMOAUTH.WEEKDAY_THU
Friday
- Indica si la promoción está disponible los viernes. Puede incluir los siguientes valores para este elemento.
- 0
- La promoción no está disponible.
- 1
- La promoción está disponible.
Se correlaciona con PX_PROMOAUTH.WEEKDAY_FRI
Saturday
- Indica si la promoción está disponible en los sábados. Puede incluir los siguientes valores para este elemento.
- 0
- La promoción no está disponible.
- 1
- La promoción está disponible.
Se correlaciona con PX_PROMOAUTH.WEEKDAY_SAT
Type
- El tipo de promoción. Puede incluir los siguientes valores para este elemento.
- 0
- La promoción se puede aplicar a los clientes que pertenecen a uno o varios de los perfiles de cliente de destino. Si la lista de archivos de perfiles de destino está vacía, la promoción se aplica a todos los clientes
- 1
- La promoción se aplica únicamente a los clientes a los que se ha otorgado la promoción de forma explícita, como por ejemplo a través de un cupón.
Se correlaciona con PX_PROMOTION.TYPE
Effectivedays
- Si la promoción es una promoción privada, este elemento indica cuántos días después de emitirse el cupón éste pasa a estar activo.
Se correlaciona con PX_PROMOTION.EFFECTIVE
Expirationdays
- Si la promoción es una promoción privada, este elemento indica cuántos días después de emitirse el cupón éste caducará.
Se correlaciona con PX_PROMOTION.EXPIRE
AllowTransfer
- Si esta promoción es una promoción privada, este elemento indica si los cupones para la promoción pueden transferirse. Puede incluir los siguientes valores para este elemento.
- 0
- Los cupones de la promoción no pueden transferirse.
- 1
- Los cupones de la promoción pueden transferirse.
Se correlaciona con PX_PROMOTION.TRANSFER
PromotionCodeRequired
- Indica si un código de promoción es necesario para canjear la promoción. Puede incluir los siguientes valores para este elemento.
- 0
- No es necesario un código de promoción para canjear la promoción.
- 1
- Es necesario un código de promoción.
Se correlaciona con PX_PROMOTION.CDREQUIRED
PromotionCodeCue
- El código de promoción público para la promoción.
Se correlaciona con PX_PROMOTION.CODE
DisplayLevel
- Indica donde se visualizarán las cantidades calculadas por el código de cálculo. Puede incluir los siguientes valores para este elemento.
- 0
- Artículo de pedido
- 1
- Orden
- 2
- Producto
- 3
- Artículo
- 4
- Contract
Se correlaciona con CALCODE.DISPLAYLEVEL
CodeType
- El tipo o código de promoción que es necesario para canjear la promoción.
- 0
- Código de promoción público.
- 1
- Código generado.
- 2
- Código importado.
Se correlaciona con PX_CDSPEC.CODETYPE
Pattern
- El patrón de generación de código de promoción para generar códigos de promoción avanzados.
Se correlaciona con PX_CDSPEC.PATTERN
Count
- El número de códigos de promoción que se van a generar para la promoción.
Se correlaciona con PX_CDSPEC.COUNT
CodeStatus
- El estado de los códigos de promoción para la promoción. Puede incluir los siguientes valores para este elemento.
- 0
- No se rellena.
- 1
- Se ha rellenado.
- 2
- En proceso.
- 3
- Se ha cancelado.
- 4
- La generación ha sido errónea.
- 5
- La importación ha sido errónea.
Se correlaciona con PX_CDSPEC.CODESTATUS
Transferable
- Indica si los códigos de promoción pueden transferirse. Puede incluir los siguientes valores para este elemento.
- 0
- Los códigos de promoción pueden transferirse.
- 1
- Los códigos de promoción no pueden transferirse.
Se correlaciona con PX_CDSPEC.TRANSFERABLE
Elementos XML dentro de la sección <Description>
Cuando se crea el archivo de entrada para cargar datos de promoción, debe utilizar el nombre correcto para los elementos XML hijos en la sección <Description>
. No es necesario establecer un valor para cada uno de los siguientes elementos. Si no establece un valor para uno de los siguientes elementos, el programa de utilidad de carga de datos establece el valor para la columna de base de datos correspondiente para que sea nulo.
LanguageId
- El idioma para la información de descripción.
Se correlaciona con PX_DESCRIPTION.LANGUAGE_ID
AdminDescription
- La descripción administrativa de la promoción.
Se correlaciona con PX_DESCRIPTION.ADMINDESC
ShortDescription
- La descripción breve de la promoción.
Se correlaciona con PX_DESCRIPTION.SHORTDESC
LongDescription
- La descripción detallada de la promoción.
Se correlaciona con PX_DESCRIPTION.LONGDESC
Field1
- Un campo de descripción personalizado para utilizarlo para la información de promoción.
Se correlaciona con PX_DESCRIPTION.FIELD1
Field2
- Un campo de descripción personalizado para utilizarlo para la información de promoción.
Se correlaciona con PX_DESCRIPTION.FIELD2
Field3
- Un campo de descripción personalizado para utilizarlo para la información de promoción.
Se correlaciona con PX_DESCRIPTION.FIELD3
Field4
- Un campo de descripción personalizado para utilizarlo para la información de promoción.
Se correlaciona con PX_DESCRIPTION.FIELD4
Field5
- Un campo de descripción personalizado para utilizarlo para la información de promoción.
Se correlaciona con PX_DESCRIPTION.FIELD5
Elementos XML dentro de la sección <Elements>
La denominación de los elementos secundarios para la sección <Elements>
es diferente de las secciones <Base>
y <Description>
. Dentro del elemento <Elements>
, debe utilizar el nombre correcto solo para los elementos secundarios <SubType>
, <Sequence>
y <Data>
. Para los elementos <Type>
y <Name>
, que puede incluir varias veces para una promoción, debe sustituir los nombres de elementos por el nombre de identificación adecuado.
<Elements>
del archivo de entrada.<Elements>
<Type>
<SubType>...</SubType>
<Sequence>...</Sequence>
<Data>
<name>value</name>
<name>value</name>
</Data>
<Type>
<SubType>...</SubType>
<Sequence>...</Sequence>
<Data>
<name>value</name>
<name>value</name>
</Data>
</Type>
...
</Type>
<Elements>
<Type>
- El nombre de una bonificación o condición de promoción. Sustituya
<Type>
con el nombre de la condición o bonificación. Por ejemplo,<PurchaseCondition>
.Puede incluir varios elementos
<Type>
para una promoción. Un elemento<Type>
se puede anidar dentro de otro elemento<Type>
. Por ejemplo, el siguiente código incluye un elemento<Type>
que se denomina<IncludePaymentTypeIdentifier>
, que está anidado dentro de un elemento<Type>
que se denomina<PurchaseCondition>
.<Elements> <PurchaseCondition> ... <IncludePaymentTypeIdentifier> ... </IncludePaymentTypeIdentifier> </PurchaseCondition> ... <Elements>
Se correlaciona con PX_ELEMENT.TYPE.
SubType
- El subtipo de un elemento de promoción
<Type>
. Cada<Type>
puede tener un<SubType>
. Por ejemplo, un elemento<Type>
que se denomina<PurchasingCondition>
puede tener un elemento<SubType>
que se llama<OrderLevelPercentDiscountPurchaseCondition>
.Se correlaciona con PX_ELEMENT.SUBTYPE
Sequence
- La secuencia que el elemento de bonificación o de condición de compra de promoción visualiza para una promoción. Cada elemento
<Type>
puede incluir un elemento<Sequence>
.Se correlaciona con PX_ELEMENT.SEQUENCE
Data
- Indica que la información de par nombre-valor existe para un elemento
<Type>
padre (bonificación o condición de compra). Todos los elementos XML hijo en este elemento<Data>
son pares nombre-valor. Incluya cada par nombre-valor como un elemento aparte. Este elemento no está correlacionado con ninguna columna y lo utiliza el programa de utilidad de carga de datos para leer el XML del archivo de entrada de promoción e identificar elementos de pares nombre-valor. <Name>
- El nombre de un par nombre-valor. Sustituya
<Name>
por el nombre adecuado. Por ejemplo, en el siguiente fragmento de código de un archivo de entradaCurrency
,MinimumPurchase
,<FixedCost>
y<AdjustmentType>
, se utilizan todos como elementos<Name>
:<Elements> <PurchaseCondition> ... <Data> <Currency>USD</Currency> <MinimumPurchase>70</MinimumPurchase> <FixedCost>0</Fixed Cost> <AdjustmentType>IndividualAffectedItems</AdjustmentType> </Data> </PurchaseCondition> ... <Elements>
Se correlaciona con PX_ELEMENTNVP.NAME
El valor para cada elemento
<Name>
, como por ejemploUSD
en el fragmento de código anterior, se correlaciona con PX_ELEMENTNVP.VALUE