Partilhar via


Objeto de Dados do Cupão - Faturação do Cliente

Define um cupão.

Sintaxe

<xs:complexType name="Coupon" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="CouponCode" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ClassName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="CouponType" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Amount" type="xs:double" />
    <xs:element minOccurs="0" name="SpendThreshold" type="xs:double" />
    <xs:element minOccurs="0" name="CurrencyCode" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="PercentOff" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="ActiveDuration" nillable="true" type="xs:int" />
    <xs:element minOccurs="0" name="ExpirationDate" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="StartDate" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="EndDate" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="SendToEmail" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="SendToDate" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="IsRedeemed" type="xs:boolean" />
    <xs:element minOccurs="0" name="RedemptionInfo" nillable="true" type="tns:CouponRedemption" />
    <xs:element minOccurs="0" name="ClaimInfo" nillable="true" type="tns:CouponClaimInfo">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
  </xs:sequence>
</xs:complexType>

Elementos

O objeto Cupão tem os seguintes elementos: ActiveDuration, Amount, ClaimInfo, ClassName, CouponCode, CouponType, CurrencyCode, EndDate, ExpirationDate, IsRedeemed, PercentOff, RedemptionInfo, SendToDate, SendToEmail, SpendThreshold, StartDate.

Elemento Descrição Tipo de Dados
ActiveDuration Dias ativos desde que o cupão foi resgatado.

Após estes dias, o cupão não pode ser consumido.
int
Montante O valor do cupão.

O elemento CurrencyCode determina a moeda.
duplo
ClaimInfo AccountId, AccountNumber e ClaimDate da afirmação. CouponClaimInfo
ClassName O nome da classe do qual o cupão foi cunhado. cadeia
CouponCode O código que pode ser utilizado para resgatar o cupão. cadeia
Tipo de Cupão O tipo do cupão.

Os tipos suportados incluem:
Aquisição: O cupão de aquisição é utilizado para adquirir novos clientes. Apenas os novos clientes podem resgatar este cupão.
Retenção: Os cupões de retenção podem ser utilizados por clientes novos e existentes.
cadeia
CurrencyCode A moeda do montante do cupão e do limiar de gastos.

Para valores possíveis, veja Moedas.
cadeia
DataDadosEncom efeitos Finais A última data em que o cupão pode ser resgatado. dateTime
ExpirationDate A data de expiração do cupão.

Após esta data, o cupão não pode ser consumido.
dateTime
IsRedeemed O cupão foi resgatado.

O valor será verdadeiro se o cupão tiver sido resgatado e, caso contrário, o valor for falso.
booleano
Percentagem Desativado A percentagem de desconto no valor do cupão.

Isto só é aplicável a um cupão de percentagem.
Por exemplo, 10,0 representa um desconto de 10%.
duplo
RedemptionInfo Contém resgate e detalhes de consumo.

Devolvido apenas quando a conta em que o cupão foi resgatado faturas para o cliente proprietário do cupão.
CouponRedemption
SendToDate A data em que o cupão foi enviado por e-mail pela operação DispatchCoupons . dateTime
SendToEmail O endereço de e-mail do cupão foi enviado por e-mail pela operação DispatchCoupons . cadeia
SpendThreshold O cupão não pode ser consumido até que os gastos da conta atinjam este limiar a partir do momento em que o cupão foi resgatado.

O elemento CurrencyCode determina a moeda.
duplo
Data De Início O cupão não pode ser resgatado antes da data de início. dateTime

Requisitos

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

Utilizado Por

SearchCoupons