Compartir a través de

Objeto de datos de cupón: facturación del cliente

  • Artículo

Define un cupón.

<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

El objeto Coupon tiene los siguientes elementos: ActiveDuration, Amount, ClaimInfo, ClassName, CouponCode, CouponType, CurrencyCode, EndDate, ExpirationDate, IsRedeemed, PercentOff, RedemptionInfo, SendToDate, SendToEmail, SpendThreshold, StartDate.

Elemento Descripción Tipo de datos
ActiveDuration Días activos desde que se ha canjeado el cupón.

Después de estos días, el cupón no se puede consumir.		 int
Amount Importe del valor del cupón.

El elemento CurrencyCode determina la moneda.		 doble
ClaimInfo AccountId, AccountNumber y ClaimDate de la notificación. CouponClaimInfo
ClassName Nombre de clase desde el que se acuñaba el cupón. string
CouponCode Código que se puede usar para canjear el cupón. string
CouponType Tipo del cupón.

Entre los tipos admitidos se incluyen:
Adquisición: El cupón de adquisición se usa para adquirir nuevos clientes. Solo los nuevos clientes pueden canjear este cupón.
Retención: Los cupones de retención los pueden usar tanto los clientes nuevos como los existentes.		 string
CurrencyCode La moneda del importe del cupón y el umbral de gasto.

Para ver los valores posibles, consulte Monedas.		 string
EndDate La última fecha en la que se puede canjear el cupón. dateTime
ExpirationDate Fecha de expiración del cupón.

Después de esta fecha, no se puede consumir el cupón.		 dateTime
IsRedeemed ¿Se ha canjeado el cupón?

El valor será true si el cupón se ha canjeado y, de lo contrario, el valor es false.		 boolean
PercentOff Valor del porcentaje de descuento del cupón.

Esto solo es aplicable para un cupón de porcentaje.
Por ejemplo, 10,0 representa un descuento del 10 %.		 doble
RedemptionInfo Contiene detalles de canje y consumo.

Solo se devuelve cuando la cuenta en la que se canjeó el cupón factura al cliente propietario del cupón.		 CouponRedemption
SendToDate La fecha en que la operación DispatchCoupons envió el cupón por correo electrónico. dateTime
SendToEmail La dirección de correo electrónico del cupón ha sido enviada por correo electrónico por la operación DispatchCoupons . string
SpendThreshold El cupón no se puede consumir hasta que el gasto de la cuenta alcanza este umbral desde el momento en que se canjeó el cupón.

El elemento CurrencyCode determina la moneda.		 doble
StartDate El cupón no se puede canjear antes de la fecha de inicio. dateTime

Requisitos

Servicio: CustomerBillingService.svc v13
Namespace: https://bingads.microsoft.com/Customer/v13/Entities

Usado por

SearchCoupons