Referencia de modificaciones y reversiones por lotes

Cuando modifiques o reviertas datos de acciones en bloque, comienza descargando uno de los archivos de plantilla proporcionados por impact.com y reemplazando los datos de ejemplo por los tuyos. Al agregar tus propios datos, asegúrate de seguir las directrices de la tabla de referencia correspondiente para garantizar que el envío de tu archivo tenga el formato correcto. Una vez que tu archivo de envío esté listo, puedes continuar con el envío de tu archivo de modificaciones / reversiones por lotes.

Este artículo de referencia incluye los campos más utilizados para modificaciones y reversiones por lotes. Para ver una referencia completa y detallada que incluya descripciones de los campos, consulta Referencias de campos de acciones y conversiones.

Consulta las referencias a continuación para:

• Aprender qué campos usar en una modificación o reversión por lotes por FTP/SMTP
• Descargar archivos de plantilla con datos de ejemplo de marcador de posición
• Entender qué códigos de motivo aplicar y cuándo

Modificaciones a nivel de pedido

Esto es para cuando quieres actualizar datos de acciones en bloque a nivel de pedido en lugar de a nivel de artículo, por ejemplo, cambiar el importe del pedido para varios pedidos.

Parámetros aceptados

Campo	¿Requerido?	¿Editable?	Nota
ActionID	Requerido condicionalmente*	No editable	Se recomienda proporcionar este identificador cuando la ventana de deduplicación es corta.
Oid / OrderId	Requerido condicionalmente*	No editable	Proporcionar este identificador es obligatorio al usar ActionTrackerId.
ActionTrackerID	Requerido condicionalmente*	No editable	Proporcionar este identificador es obligatorio al usar OrderId/Oid.
Importe	Opcional	Editable	Establece el nuevo importe total del pedido.
currencyCode	Opcional	Editable	Establece la moneda de ingresos de la acción. De forma predeterminada, se usará la moneda de tu cuenta de impact.com si no se proporciona.
CustomerStatus	Opcional	Editable	Establece el estado del cliente en el momento de la conversión, por ejemplo, NUEVO / EXISTENTE.
Nota	Opcional	Editable	Campo general para fines de informes a nivel de evento. Si está vacío en la conversión original, al enviar un valor se inserta. Solo se acepta una vez por acción; envía cualquier otro cambio de campo en la misma solicitud.
LocationId	Opcional	Editable	Se utiliza principalmente para alojamientos; este es el identificador único de la ubicación especificada en esta conversión. Si está vacío en la conversión original, al enviar un valor se inserta.
LocationName	Opcional	Editable	Se utiliza principalmente para alojamientos; este es el nombre de la ubicación especificada en esta conversión. Si está vacío en la conversión original, al enviar un valor se inserta.
GiftPurchase	Opcional	Editable	Establécelo en true para marcar el pedido como compra de regalo, o en false para desmarcarlo. Si está vacío en la conversión original, al enviar un valor se inserta.
Text1–Text50	Opcional	Editable	Campos de texto generales que aceptan cadenas con cualquier dato de texto que desees enviar (Text1 a Text50). Si está vacío en la conversión original, al enviar un valor se inserta. Solo se acepta una vez por acción; envía cualquier otro cambio de campo en la misma solicitud.
Motivo	Requerido	Editable	Proporciona un código de motivo válido para la modificación.

*Debe proporcionarse al menos una ruta de identificador, es decir, ya sea ActionId o (*OrderId/Oid *+ ActionTrackerId)

Archivos de plantilla

• Plantilla de modificaciones a nivel de pedido
• Plantilla de aprobaciones a nivel de pedido

Reversiones a nivel de pedido

Esto es para cuando quieres revertir en bloque acciones impulsadas por partners a nivel de pedido en lugar de a nivel de artículo; por ejemplo, revertir varios pedidos.

Parámetros aceptados

Campo	¿Requerido?	¿Editable?	Nota
ActionID	Requerido condicionalmente*	No editable	Se recomienda proporcionar este identificador cuando la ventana de deduplicación es corta.
Oid / OrderId	Requerido condicionalmente*	No editable	Proporcionar este identificador es obligatorio al usar ActionTrackerId.
ActionTrackerID	Requerido condicionalmente*	No editable	Proporcionar este identificador es obligatorio al usar OrderId/Oid.
Importe	Requerido condicionalmente**	Editable	Establécelo en 0 para revertir el pedido, a menos que el importe original = 0**
Motivo	Requerido	Editable	Proporciona un código de motivo válido para la reversión.

*Debe proporcionarse al menos una ruta de identificador, es decir, ya sea ActionId o (OrderId/Oid + ActionTrackerId)

**Si el original Importe = 0, deja Importe sin cambios para evitar clasificarlo erróneamente como una modificación.

Archivos de plantilla

• Plantilla de reversiones a nivel de pedido

Modificaciones a nivel de artículo

Esto es para cuando quieres actualizar datos de acciones en bloque a nivel de artículo en lugar de a nivel de pedido, por ejemplo, cambiar el importe de varios artículos de un pedido.

Parámetros aceptados

Campo	¿Requerido?	¿Editable?	Nota
ActionID	Requerido condicionalmente*	No editable	Se recomienda proporcionar este identificador cuando la ventana de deduplicación es corta.
Oid / OrderId	Requerido condicionalmente*	No editable	Proporcionar este identificador es obligatorio al usar ActionTrackerId.
ActionTrackerID	Requerido condicionalmente*	No editable	Proporcionar este identificador es obligatorio al usar OrderId/Oid.
SKU**	Requerido	No editable	Proporciona el valor SKU del artículo que deseas modificar.
Importe**	Requerido condicionalmente	Editable	Establece el nuevo importe del artículo, es decir, precio*cantidad. Si modificas la cantidad, este campo también debe modificarse.
Cantidad**	Opcional	Editable	Establece la nueva cantidad de artículos del pedido.
Categoría**	Opcional	Editable	Establece la categoría del artículo.
Motivo**	Requerido	Editable	Proporciona un código de motivo válido para la reversión.

*Debe proporcionarse al menos una ruta de identificador, es decir, ya sea ActionId o (OrderId/Oid + ActionTrackerId)

**Estos campos deben incluirse para cada artículo que modifiques. Los campos identificadores solo se incluyen una vez por pedido.

Archivos de plantilla

• Plantilla de modificaciones a nivel de artículo
• Plantilla de aprobaciones a nivel de artículo

Reversiones a nivel de artículo

Esto es para cuando quieres revertir datos de acciones en bloque a nivel de artículo en lugar de a nivel de pedido; por ejemplo, revertir varios artículos de un pedido.

Parámetros aceptados

Campo	¿Requerido?	¿Editable?	Nota
ActionID	Requerido condicionalmente*	No editable	Se recomienda proporcionar este identificador cuando la ventana de deduplicación es corta.
Oid / OrderId	Requerido condicionalmente*	No editable	Proporcionar este identificador es obligatorio al usar ActionTrackerId.
ActionTrackerID	Requerido condicionalmente*	No editable	Proporcionar este identificador es obligatorio al usar OrderId/Oid.
SKU**	Requerido	No editable	Proporciona el valor SKU del artículo que deseas modificar.
Importe**	Requerido condicionalmente	Editable	Establece el nuevo importe del artículo, es decir, precio*cantidad. Si modificas la cantidad, este campo también debe modificarse.
Cantidad**	Opcional	Editable	Establece la nueva cantidad de artículos del pedido.
Motivo**	Requerido	Editable	Proporciona un código de motivo válido para la modificación.

*Debe proporcionarse al menos una ruta de identificador, es decir, ya sea ActionId o (OrderId/Oid + ActionTrackerId)

**Estos campos deben incluirse para cada artículo que modifiques. Los campos identificadores solo se incluyen una vez por pedido.

Archivos de plantilla

• Plantilla de reversiones a nivel de artículo

El SKU O7427540 aparece dos veces en este ejemplo porque una línea está revirtiendo (Amount=0) y otra está modificando (Amount=15).

Nota: Si prevés tener duplicados OrderIds y optas por usar la combinación de OrderId + ActionTrackerId, impact.com aplica tu actualización al más reciente ActionId de forma predeterminada. Usa el antiguo ActionId si quieres aplicar la actualización al más antiguo ActionId.

Códigos de motivo

Cada vez que modifiques o reviertas datos de acciones, debes proporcionar un motivo. Usa el código de motivo correspondiente a continuación para explicar por qué se está actualizando la acción.

Advertencia: Proporcionar un valor no aceptado hará que la entrada no se procese y, en su lugar, se devuelva un error. Si necesitas códigos de motivo personalizados, ponte en contacto con tu CSM o contacta con soporte para hablar sobre los códigos de disposición.

Código	Descripción
CONS_FRAUD	Fraude del consumidor
CONS_ERROR	Error del consumidor
ITEM_RETURNED	El artículo fue devuelto
APPROVED	La acción está aprobada Nota: Si intentas aprobar acciones, Aprobar debe configurarse como un código de disposición personalizado.
ORDER_ERROR	Error del pedido
ORDER_UPDATE	El pedido fue actualizado
PUB_ACT_DISPUTE	Disputa de actividad del socio
ADV_ACT_DISPUTE	Disputa de actividad de la marca
NOT_COMPLIANCE_TERMS	No cumple con los términos
ITEM_OUT_OF_STOCK	El artículo está agotado
TEST_ACTION	Acción de prueba
PARTNER_NOT_ACTIVE	Cuenta de socio desactivada
CREDITED_DIFFERENT_MP	Acreditado a otro socio
OTRO	Otro motivo