Partilhar via


InsertionOrderPendingChanges Data Object – Faturação do Cliente

Define um objeto que pode ser utilizado para gerir as alterações de uma ordem de inserção aprovada.

Se o elemento Estado da InsertionOrder estiver definido como PendingUserReview, não poderá atualizar a ordem de inserção através do objeto InsertionOrderPendingChanges . Tem de aprovar, recusar ou cancelar inicialmente através do elemento Estado da InsertionOrder. Assim que o Estado da ordem de inserção estiver Ativo, Esgotado, Expirado ou Não Iniciado, pode fazer novas alterações ou aprovar ou recusar as alterações pendentes atuais através do objeto InsertionOrderPendingChanges .

Sintaxe

<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

O objeto InsertionOrderPendingChanges tem os seguintes elementos: ChangeStatus, Comment, EndDate, ModifiedDateTime, Name, NotificationThreshold, PurchaseOrder, ReferenceId, RequestedByUserId, SpendCapAmount, StartDate.

Elemento Descrição Tipo de Dados
ChangeStatus Pode ser utilizado para aceitar ou recusar a ordem de inserção com alterações pendentes.

Quando chama UpdateInsertionOrder , pode definir este elemento ChangeStatus ou modificar outros elementos deste objeto, mas não pode alterar o estado em paralelo com outras atualizações de propriedade.
InsertionOrderPendingChangesStatus
Comentar Uma descrição da ordem de inserção. A descrição está limitada a 100 carateres.

Adicionar: Só de leitura
Atualização: Opcional
cadeia
DataDadosEncom efeitos Finais A data em que a ordem de inserção expira. A data de fim tem de ser posterior à data de início.

A data é armazenada na Hora Universal Coordenada (UTC). Apenas são utilizados o mês, o dia e o ano da cadeia especificada. Se especificar a hora, os minutos e os segundos de uma data, estes serão ignorados.

Para obter informações sobre o formato da data e hora, veja a entrada dateTime em Tipos de Dados XML Primitivos.

Este elemento está vazio se a ordem de inserção não tiver uma data de fim.

Adicionar: Só de leitura
Atualização: Opcional
dateTime
ModifiedDateTime A data e hora em que o pedido de alteração da ordem de inserção foi submetido.

A data é armazenada na Hora Universal Coordenada (UTC).

Para obter informações sobre o formato da data e hora, veja a entrada dateTime em Tipos de Dados XML Primitivos.

Adicionar: Só de leitura
Atualização: Só de leitura
dateTime
Nome O nome amigável que pode ser utilizado para referenciar esta ordem de inserção.

O nome pode conter um máximo de 100 carateres.

O nome não tem de ser exclusivo em comparação com outras encomendas de inserção para o cliente.

Adicionar: Só de leitura
Atualização: Opcional
cadeia
NotificationThreshold Uma percentagem do orçamento que foi gasto. Especifique a percentagem como um valor de 0 a 100. A notificação é enviada quando o limiar é atingido. Por exemplo, se definir o limiar para 70, o Serviço de faturação envia uma notificação quando tiver gasto 70% do orçamento.

Se não quiser receber a notificação, defina como NULL.

Reservado para utilização interna.

Adicionar: Só de leitura
Atualização: Opcional
duplo
PurchaseOrder Um valor de nota de encomenda que pode ser utilizado para referenciar esta ordem de inserção em faturas mensais. Este valor será impresso como a nota de encomenda nas faturas mensais.

A nota de encomenda pode conter um máximo de 50 carateres.

Adicionar: Só de leitura
Atualização: Opcional
cadeia
ReferenceId Apenas utilização interna.

Adicionar: Só de leitura
Atualização: Opcional
Longo
RequestedByUserId Um identificador do último utilizador a pedir uma alteração à ordem de inserção.

Adicionar: Só de leitura
Atualização: Só de leitura
int
SpendCapAmount O orçamento para esta ordem de inserção. O orçamento é um limite rígido. Quando a conta atinge este limite e não existe outra ordem de inserção disponível, o valor do estado do ciclo de vida da conta é definido como Pausa.

Este elemento está vazio se a ordem de inserção tiver um orçamento ilimitado.

Adicionar: Só de leitura
Atualização: Opcional
duplo
Data De Início A data em que a ordem de inserção pode começar a acumular custos. A data de início tem de ser posterior à data atual.

A data é armazenada na Hora Universal Coordenada (UTC). Apenas são utilizados o mês, o dia e o ano da cadeia especificada. Se especificar a hora, os minutos e os segundos de uma data, estes serão ignorados.

Para obter informações sobre o formato da data e hora, veja a entrada dateTime em Tipos de Dados XML Primitivos.

Adicionar: Só de leitura
Atualização: Opcional. Só pode atualizar a data de início através deste elemento se o elemento Estado da InsertionOrder for NotStarted. Se a data de início já tiver passado, não poderá alterá-la.
dateTime

Requisitos

Serviço: CustomerBillingService.svc v13
Espaço de nomes: https://bingads.microsoft.com/Customer/v13/Entities

Utilizado Por

InsertionOrder