Configuración de la verificación automática a través de XML

Puedes leer más sobre la verificación y sus tipos en este artículo.

Para configurar la verificación automática a través de XML, tienes que crear un archivo XML con el conjunto de datos que se describen debajo y proporcionar a los especialistas del departamento de seguimiento de Admitad el enlace a este archivo. Ellos comprobarán si la estructura del archivo es correcta, si los estados y los importes de los pedidos se transfieren sin errores, realizarán los ajustes necesarios y te informarán el resultado.

Privacidad

Para ocultar el archivo a los terceros, te sugerimos que uses la autenticación básica HTTP para acceder al archivo (recomendado) o que simplemente encriptes el nombre del archivo, por ejemplo: gdsfkl4tkerlgsfd.xml

Frecuencia de actualización

Tienes que actualizar el fichero por lo menos una vez al día para que el departamento de seguimiento pueda compararlo con los datos de Admitad.

Contenido del fichero de autoverificación

Nosotros recomendamos almacenar los datos de la acción durante 3 meses.
Los espacios en el nombre son obligatorios, el espacio en el nombre de un elemento principal tiene que ser xmlns=”http://admitad.com/payments-revision”.
El elemento principal Payments puede contener cualquier número de elementos Payment.
Cada Payment tiene que tener dos elementos secundarios obligatorios:
- OrderID
- Status.
Elementos no obligatorios:
- OrderAmount y Reward, son necesarios si se ha modificado el importe del pedido o el importe de la remuneración.
- currency_code para pasar el pedido y la moneda de la remuneración:
  - si no pasas currency_code, se usará por defecto la moneda indicada en el programa de afiliación para currency_code;
  - Si pasas currency_code y la moneda que aparece en él es distinta a la del programa de afiliación, los importes de los parámetros "amount" y "reward" se convertirán a la moneda del programa usando el tipo de cambio del sistema en el momento en que se ha registrado la acción de conversión.
- Otro elemento no obligatorio es Comment que se usa para explicar por qué has rechazado el pedido.

El pedido puede ser rechazado si:

El pedido ha sido anulado,
El pedido ha sido rechazado,
El pedido ha sido devuelto,
El pedido no se ha realizado,
Los datos se han rellenado de forma incorrecta.

Ten en cuenta que:

Los nombres de todos los elementos se diferencian entre mayúsculas y minúsculas;
No se permiten estas etiquetas:
<OrderAmount>None</OrderAmount> — no se ajusta al tipo de valor;
<Comment/> — etiquetas vacías.

Ejemplo del contenido del fichero

Ejemplo 1:

Si solo quieres confirmar o rechazar las acciones, el archivo tiene que llevar la siguiente información:

Parámetro	Descripción
OrderID	Número del pedido
Status	Estado del pedido (1 - confirmado, 2 - rechazado)
Comment	En este parámetro puedes escribir el motivo por el que se rechaza el pedido (hasta 30 caracteres)

<Payments xmlns=”http://admitad.com/payments-revision”>
<Payment>
<OrderID>123456</OrderID>
<Status>2</Status>
<Comment>Devuelto</Comment>
</Payment>
</Payments>

Ejemplo 2:

Si quieres confirmar las acciones y cambiar el importe del pedido para que el sistema vuelva a calcular por sí mismo la remuneración de los afiliados, es necesario acordar previamente este ajuste con el departamento de seguimiento. Este ajuste solo se usa en programas con tarifas de porcentaje.

Parámetros obligatorios:

Parámetro	Descripción
OrderID	Número del pedido
Status	Estado del pedido (1 - confirmado, 2 - rechazado)
Order amount	Importe del pedido (número decimal no negativo con un punto como separador)

<Payments xmlns=”http://admitad.com/payments-revision”>
<Payment>
<OrderID>123456</OrderID>
<OrderAmount>1000</OrderAmount>
<Status>1</Status>
</Payment>
</Payments>

Ejemplo 3:

Si quieres cambiar las remuneraciones de los afiliados, tienes que acordar previamente esta configuración con el departamento de seguimiento.

Parámetros obligatorios:

Parámetro	Descripción
OrderID	Número del pedido
Status	Estado del pedido (1 - confirmado, 2 - rechazado)
Remuneración	Remuneración del afiliado (número decimal no negativo con un punto como separador)

<Payments xmlns=”http://admitad.com/payments-revision”>
<Payment>
<OrderID>123456</OrderID>
<OrderAmount>1000</OrderAmount>
<Reward>100</Reward>
<Status>1</Status>
</Payment>
</Payments>

Conseguir información sobre los pedidos pendientes de Admitad

Puedes solicitar al especialista de Admitad que te facilite un enlace al fichero XML donde podrás encontrar la información sobre las acciones pendientes.

Ejemplo del enlace:
https://www.admitad.com/sid103584/ru/advertiser/advcampaign/5441/payments/xml_export/?uid=rksNfWrTIQesLvZ

Si quieres recibir información sobre las acciones realizadas durante un período determinado, puedes añadir al enlace los siguientes parámetros:

start-date – límite inferior del período en formato de fecha ISO (por ejemplo, 2014-01-01)
end-date – límite superior del período en formato de fecha ISO (por ejemplo, 2014-01-31)

Entonces el enlace se verá así
https://www.admitad.com/sid103584/ru/advertiser/advcampaign/5441/payments/xml_export/?uid=rksNfWrTIQesLvZ
&start-date=2014-01-01&end-date=2014-01-31

Puedes utilizar esta información para verificar el estado de los pedidos para ciertas acciones y después enviarlas a la parte de Admitad dentro del archivo de verificación automática.