Objeto de datos InsertionOrderPendingChanges: facturación del cliente
Define un objeto que se puede usar para administrar los cambios de un orden de inserción aprobado.
Si el elemento Status de InsertionOrder se establece en PendingUserReview, no se puede actualizar el orden de inserción a través del objeto InsertOrderPendingChanges . Inicialmente debe aprobar, rechazar o cancelar a través del elemento Status de InsertionOrder. Una vez que el estado del pedido de inserción es Activo, Agotado, Expirado o NotStarted, puede realizar nuevos cambios o aprobar o rechazar los cambios pendientes actuales a través del objeto InsertionOrderPendingChanges .
Sintaxis
<xs:complexType name="InsertionOrderPendingChanges" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:sequence>
<xs:element minOccurs="0" name="Comment" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="EndDate" nillable="true" type="xs:dateTime" />
<xs:element minOccurs="0" name="RequestedByUserId" nillable="true" type="xs:int" />
<xs:element minOccurs="0" name="ModifiedDateTime" nillable="true" type="xs:dateTime" />
<xs:element minOccurs="0" name="NotificationThreshold" nillable="true" type="xs:double" />
<xs:element minOccurs="0" name="ReferenceId" nillable="true" type="xs:long" />
<xs:element minOccurs="0" name="SpendCapAmount" nillable="true" type="xs:double" />
<xs:element minOccurs="0" name="StartDate" nillable="true" type="xs:dateTime" />
<xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="PurchaseOrder" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="ChangeStatus" nillable="true" type="tns:InsertionOrderPendingChangesStatus" />
</xs:sequence>
</xs:complexType>
Elementos
El objeto InsertionOrderPendingChanges tiene los siguientes elementos: ChangeStatus, Comment, EndDate, ModifiedDateTime, Name, NotificationThreshold, PurchaseOrder, ReferenceId, RequestedByUserId, SpendCapAmount, StartDate.
| Elemento | Descripción | Tipo de datos |
|---|---|---|
| ChangeStatus | Se puede usar para aceptar o rechazar el orden de inserción pendiente de cambios. Al llamar a UpdateInsertionOrder , puede establecer este elemento ChangeStatus o modificar otros elementos de este objeto, pero no puede cambiar el estado en paralelo con otras actualizaciones de propiedades. |
InsertionOrderPendingChangesStatus |
| Comentario | Descripción del orden de inserción. La descripción está limitada a 100 caracteres. Agregar: Solo lectura Actualizar: Opcional |
string |
| EndDate | Fecha de expiración del pedido de inserción. La fecha de finalización debe ser posterior a la fecha de inicio. La fecha se almacena en hora universal coordinada (UTC). Solo se usan el mes, el día y el año de la cadena especificada. Si especifica la hora, los minutos y los segundos de una fecha, se omitirán. Para obtener información sobre el formato de la fecha y hora, vea la entrada dateTime en Tipos de datos XML primitivos. Este elemento está vacío si el orden de inserción no tiene fecha de finalización. Agregar: Solo lectura Actualizar: Opcional |
dateTime |
| ModifiedDateTime | Fecha y hora en que se envió la solicitud de cambio de pedido de inserción. La fecha se almacena en hora universal coordinada (UTC). Para obtener información sobre el formato de la fecha y hora, vea la entrada dateTime en Tipos de datos XML primitivos. Agregar: Solo lectura Actualizar: Solo lectura |
dateTime |
| Nombre | Nombre descriptivo que se puede usar para hacer referencia a este orden de inserción. El nombre puede contener un máximo de 100 caracteres. No es necesario que el nombre sea único en comparación con otros pedidos de inserción para el cliente. Agregar: Solo lectura Actualizar: Opcional |
string |
| NotificationThreshold | Porcentaje del presupuesto que se ha gastado. Especifique el porcentaje como un valor de 0 a 100. La notificación se envía cuando se alcanza el umbral. Por ejemplo, si establece el umbral en 70, el servicio de facturación envía una notificación cuando se ha gastado el 70 por ciento del presupuesto. Si no desea recibir una notificación, establezca en NULL. Reservado para uso interno. Agregar: Solo lectura Actualizar: Opcional |
doble |
| PurchaseOrder | Valor de pedido de compra que se puede usar para hacer referencia a este pedido de inserción en facturas mensuales. Este valor se imprimirá como pedido de compra en las facturas mensuales. El pedido de compra puede contener un máximo de 50 caracteres. Agregar: Solo lectura Actualizar: Opcional |
string |
| ReferenceId | Uso interno únicamente. Agregar: Solo lectura Actualizar: Opcional |
largo |
| RequestedByUserId | Identificador del último usuario en solicitar un cambio en el orden de inserción. Agregar: Solo lectura Actualizar: Solo lectura |
int |
| SpendCapAmount | Presupuesto de esta orden de inserción. El presupuesto es un límite difícil. Cuando la cuenta alcanza este límite y no hay otro pedido de inserción disponible, el valor de estado del ciclo de vida de la cuenta se establece en Pausar. Este elemento está vacío si el orden de inserción tiene presupuesto ilimitado. Agregar: Solo lectura Actualizar: Opcional |
doble |
| StartDate | Fecha en la que la orden de inserción puede comenzar a acumular cargos. La fecha de inicio debe ser posterior a la fecha actual. La fecha se almacena en hora universal coordinada (UTC). Solo se usan el mes, el día y el año de la cadena especificada. Si especifica la hora, los minutos y los segundos de una fecha, se omitirán. Para obtener información sobre el formato de la fecha y hora, vea la entrada dateTime en Tipos de datos XML primitivos. Agregar: Solo lectura Actualizar: Opcional. Solo puede actualizar la fecha de inicio a través de este elemento si el elemento Status de InsertionOrder es NotStarted. Si la fecha de inicio ya ha pasado, no puede cambiarla. |
dateTime |
Requisitos
Servicio: CustomerBillingService.svc v13
Namespace: https://bingads.microsoft.com/Customer/v13/Entities