Suspención/Aprobación/Cancelación/Finalización/Copiado de Pautas

Suspensión de pauta

Suspende una pauta que está activa

URL: /admin/adnet/pub/admin/pautas.html?op=sus&o=xml 

Requisitos:

• La pauta debe estar activa

• Se debe conocer su identificador (pauta_id)

Parámetros obligatorios:

Se debe incluir el parámetro pauta_id, con el identificador de la pauta.  

Ejemplo de request:

URL: /admin/adnet/pub/admin/pautas.html?op=sus&o=xml

Parámetros:

• pauta_id=43242

Explicación de los parámetros:

• pauta_id: identificador de la pauta

Respuesta:

Contiene un objeto <operacion> que a su vez contiene un tag <resultado>.  El valor de resultado puede ser 1 (operación exitosa) o 0 (operación fallida).

Si la operación es fallida, se agrega además un listado de errores, mediante tags <error>, que contienen el atributo atributo, que especifica el nombre del atributo con error, y mensaje, con el mensaje de error.

Aprobación de pauta

Aprueba una pauta para que comience a ejecutarse.

URL: /admin/adnet/pub/admin/pautas.html?op=apr&o=xml 

Requisitos:

• La pauta debe estar en estado Inicial o Programada

• Se debe conocer su identificador (pauta_id)

• El usuario debe tener el permiso de aprobación de pautas

Parámetros obligatorios:

Se debe incluir el parámetro pauta_id, con el identificador de la pauta.  

Ejemplo de request:

URL: /admin/adnet/pub/admin/pautas.html?op=apr&o=xml

Parámetros:

pauta_id=43242

Explicación de los parámetros:

• pauta_id: identificador de la pauta

Respuesta:

Contiene un objeto <operacion> que a su vez contiene un tag <resultado>.  El valor de resultado puede ser 1 (operación exitosa) o 0 (operación fallida).

Si la operación es fallida, se agrega además un listado de errores, mediante tags <error>, que contienen el atributo atributo, que especifica el nombre del atributo con error, y mensaje, con el mensaje de error.

Cancelación de pauta

Cancela una pauta creada – la misma deja de correr.

URL: /admin/adnet/pub/admin/pautas.html?op=b&o=xml 

Requisitos:

• Se debe conocer el identificador (pauta_id)

• El usuario debe tener el permiso de borrado de pautas 

Parámetros obligatorios:

Se debe incluir el parámetro pauta_id, con el identificador de la pauta.  

Ejemplo de request:

URL: /admin/adnet/pub/admin/pautas.html?op=b&o=xml

Parámetros:

• pauta_id=43242

Explicación de los parámetros:

• pauta_id: identificador de la pauta

Respuesta:

Contiene un objeto <operacion> que a su vez contiene un tag <resultado>.  El valor de resultado puede ser 1 (operación exitosa) o 0 (operación fallida).

Si la operación es fallida, se agrega además un listado de errores, mediante tags <error>, que contienen el atributo atributo, que especifica el nombre del atributo con error, y mensaje, con el mensaje de error.

Finalización de pauta

Pasa una pauta al estado Completada – la pauta deja de correr

URL: /admin/adnet/pub/admin/pautas.html?op=completar&o=xml 

Requisitos:

• La pauta debe estar en estado Activa o Activa/Fuera de horario

• Se debe conocer el identificador (pauta_id)

• El usuario debe tener el permiso de completar/finalizar pautas 

Parámetros obligatorios:

Se debe incluir el parámetro pauta_id, con el identificador de la pauta.  

Ejemplo de request:

URL: /admin/adnet/pub/admin/pautas.html?op=completar&o=xml

Parámetros:

• pauta_id=43242

Explicación de los parámetros:

• pauta_id: identificador de la pauta

Respuesta:

Contiene un objeto <operacion> que a su vez contiene un tag <resultado>.  El valor de resultado puede ser 1 (operación exitosa) o 0 (operación fallida).

Si la operación es fallida, se agrega además un listado de errores, mediante tags <error>, que contienen el atributo atributo, que especifica el nombre del atributo con error, y mensaje, con el mensaje de error.

Reactivación de pauta

Pasa una pauta del estado Completada a Activa, siempre y cuando la misma haya sido completada dentro de los últimos 30 días.

URL: /admin/adnet/pub/admin/pautas.html?op=ap&o=xml 

Requisitos:

• La pauta debe estar en estado Completada

• Se debe conocer el identificador (pauta_id)

• El usuario debe tener el permiso de reactivar pautas 

Parámetros obligatorios:

Se debe incluir el parámetro pauta_id, con el identificador de la pauta.  

Ejemplo de request:

URL: /admin/adnet/pub/admin/pautas.html?op=ap&o=xml

Parámetros:

• pauta_id=43242

Explicación de los parámetros:

• pauta_id: identificador de la pauta

Respuesta:

Contiene un objeto <operacion> que a su vez contiene un tag <resultado>.  El valor de resultado puede ser 1 (operación exitosa) o 0 (operación fallida).

Si la operación es fallida, se agrega además un listado de errores, mediante tags <error>, que contienen el atributo atributo, que especifica el nombre del atributo con error, y mensaje, con el mensaje de error.

Copiado de pautas

URL: /admin/adnet/pub/admin/pautas.html?op=copy&o=xml 

Parámetro obligatorios:

• pauta_id: identificador de la pauta que se desea copiar.

• nombre: nombre de la nueva pauta.

• opcion_fecha_fin: se debe indicar cómo se quiere setear la duración de la pauta. Estas son las opciones: 5* >> Fecha de inicio y Fecha de fin / 2 >> Misma duración / 1 >> Misma fecha de fin

*Si se selecciona 5 se deben agregar los siguientes parámetros:

fecha_fin   
fecha_inicio   
hora_fin   
hora_inicio

Parámetros posibles:

• ptestado_id:  estado de la pauta.  Si no se especifica, muestra pautas de todos los estados. Ver valores posibles en  Referencias -  Estados de pautas.

• anunciante_id: identificador del anunciante.  Si no se especifica, muestra pautas de todos los anunciantes.

• mes_ano: para mostrar sólo las pautas de un período determinado.  Se indica mes y año con el siguiente formato: MM/AAAA.  Ejemplo: 03/2006. 

Ejemplos de URLs con parámetros:

/admin/adnet/pub/admin/pautas.html?op=copy&pauta_id=3903&nombre=TESTAPI1&opcion_fecha_fin=1&o=xml

/admin/adnet/pub/admin/pautas.html?op=copy&pauta_id=3903&nombre=TESTAPI2&opcion_fecha_fin=2&o=xml

/admin/adnet/pub/admin/pautas.html?op=copy&pauta_id=3903&nombre=TESTAPI3&opcion_fecha_fin=5&fecha_fin=18/04/2015&fecha_inicio=01/04/2015&hora_fin=10:00:00&hora_inicio=10:00:00:&o=xml

Respuesta:

Contiene un objeto <operacion> que a su vez contiene un tag <resultado>.  El valor de resultado puede ser 1 (operación exitosa) o 0 (operación fallida).

Si la operación es fallida, se agrega además un listado de errores, mediante tags <error>, que contienen el atributo atributo, que especifica el nombre del atributo con error, y mensaje, con el mensaje de error.