Modificar o revertir en lote mediante API

Realiza el curso PXA

Si algo acerca de una acción cambia (p. ej., un pedido fue cancelado, un artículo fue devuelto, etc.), puedes usar la API para modificarla (o revertirla), cambiando el monto de la comisión de la acción.

¿Qué método de envío es el adecuado para ti?

Si quieres...	Usa este método...
Envía un archivo manual único, sin programación	​Correo electrónico procesamiento por lotes o subir archivo mediante FTP
Configura informes automáticos de conversiones	​Conversiones / Acciones API, enviar archivo mediante FTP, o extraer archivo mediante FTP

Opciones de reversión de la API:

• Modifica o revierte uno o más elementos de una acción mediante la API
• Revierte una acción completa mediante la API

Requisito previo: Recupera el ActionId valor

Para modificar los datos de una acción mediante la API, necesitarás su ActionId valor. Luego puedes usar esto para encontrar la acción que deseas modificar mediante la API.

• Puedes especificar un rango de fechas en tu llamada; de lo contrario, el endpoint mostrará de forma predeterminada los últimos 30 días de acciones.
• Límites de tasa se aplican.
• Ver la Lista todas las acciones documentación del endpoint de la API para obtener más información.

Preguntas frecuentes

¿Cómo restablezco una modificación / reversión realizada a una acción (o a elementos de la acción)?

Si una acción se ha modificado o revertido antes de su fecha de bloqueo, puedes enviar RESET como motivo para devolver la acción a su estado predeterminado:

curl 'https://api.impact.com/Advertisers/{AccountSID}/Actions' \
  -X PUT \
  -u '{AccountSID}:{AuthToken}' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'ActionId={ActionId}' \
  -d 'Reason=RESET'

Las acciones que se han restablecido a través del RESET código pueden no aparecer correctamente en los informes (p. ej., los valores de ingresos pueden calcularse incorrectamente).

¿Cuál es la diferencia entre un código de disposición y un motivo?

Ambos Códigos de disposición y Motivos se utilizan en el mismo contexto — Motivos son códigos predefinidos que la API aceptará de forma predeterminada, mientras que Códigos de disposición son motivos personalizados que puedes configurar. Obtén más información sobre los Códigos de disposición.

Códigos de motivo compatibles:

Código	Descripción
CONS_FRAUD	Fraude del consumidor
CONS_ERROR	Error del consumidor
ITEM_RETURNED	El artículo fue devuelto
APROBADO	La acción está aprobada Nota: Si estás intentando 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	Otra razón

¿Cómo puedo ver cuándo se aplican modificaciones / reversiones a una acción?

Puede usar los actualizaciones de la acción endpoint para ver cuándo se actualizó por última vez una acción y cuál es su estado actual.

Nota: Un ActionUpdatesID valor es diferente de un ActionId valor — debes usar el ActionUpdatesID valor para recuperar actualizaciones de una acción.