Coupon-Datenobjekt – Kundenabrechnung

Definiert eine Gutschein.

Syntax

XML

<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>

JSON

{
  "ActiveDuration": IntValueHere,
  "Amount": DoubleValueHere,
  "ClaimInfo": {
    "AccountId": "LongValueHere",
    "AccountNumber": "ValueHere",
    "ClaimDate": "ValueHere"
  },
  "ClassName": "ValueHere",
  "CouponCode": "ValueHere",
  "CouponType": "ValueHere",
  "CurrencyCode": "ValueHere",
  "EndDate": "ValueHere",
  "ExpirationDate": "ValueHere",
  "IsRedeemed": "ValueHere",
  "PercentOff": DoubleValueHere,
  "RedemptionInfo": {
    "AccountId": "LongValueHere",
    "AccountNumber": "ValueHere",
    "ActivationDate": "ValueHere",
    "Balance": DoubleValueHere,
    "CurrencyCode": "ValueHere",
    "ExpirationDate": "ValueHere",
    "RedemptionDate": "ValueHere",
    "SpendToThreshold": DoubleValueHere
  },
  "SendToDate": "ValueHere",
  "SendToEmail": "ValueHere",
  "SpendThreshold": DoubleValueHere,
  "StartDate": "ValueHere"
}

Elemente

Das Coupon-Objekt verfügt über die folgenden Elemente: ActiveDuration, Amount, ClaimInfo, ClassName, CouponCode, CouponType, CurrencyCode, EndDate, ExpirationDate, IsRedeemed, PercentOff, RedemptionInfo, SendToDate, SendToDate, SendToEmail, SpendThreshold, StartDate.

Element	Beschreibung	Datentyp
ActiveDuration	Aktive Tage seit Gutschein eingelöst wurden. Nach diesen Tagen kann die Gutschein nicht mehr genutzt werden.	int
Betrag	Der Wert des Gutschein. Das CurrencyCode-Element bestimmt die Währung.	doppelt
ClaimInfo	AccountId, AccountNumber und ClaimDate des Anspruchs.	CouponClaimInfo
Klassenname	Der Klassenname, aus dem das Gutschein wurde.	Zeichenfolge
CouponCode	Der Code, der zum Einlösen des Gutschein verwendet werden kann.	Zeichenfolge
CouponType	Der Typ des Gutschein. Folgende Typen werden unterstützt: Erwerb: Akquise Gutschein wird verwendet, um neue Kunden zu gewinnen. Nur Neukunden können diese Gutschein einlösen. Speicherung: Aufbewahrungscoupons können sowohl von neuen als auch von bestandskunden verwendet werden.	Zeichenfolge
CurrencyCode	Die Währung der Gutschein Betrag und Ausgabenschwellenwert. Mögliche Werte finden Sie unter Währungen.	Zeichenfolge
EndDate	Das letzte Datum, an dem die Gutschein eingelöst werden kann.	dateTime
ExpirationDate	Das Gutschein Ablaufdatum. Nach diesem Datum kann die Gutschein nicht mehr genutzt werden.	dateTime
IsRedeemed	Wurde die Gutschein eingelöst? Der Wert ist true, wenn die Gutschein eingelöst wurde, andernfalls ist der Wert false.	boolean
PercentOff	Der prozentsatzoffene Gutschein Wert. Dies gilt nur für einen Prozentsatz Gutschein. Beispielsweise stellt 10,0 einen Rabatt von 10 % dar.	doppelt
RedemptionInfo	Enthält Einlösungs- und Nutzungsdetails. Wird nur zurückgegeben, wenn das Konto, auf dem die Gutschein eingelöst wurde, dem Besitzerkunden des Gutschein in Rechnung gestellt wird.	CouponRedemption
SendToDate	Das Datum, an dem die Gutschein vom DispatchCoupons-Vorgang per E-Mail gesendet wurde.	dateTime
SendToEmail	Die E-Mail-Adresse, an die die Gutschein vom DispatchCoupons-Vorgang gesendet wurde.	Zeichenfolge
SpendThreshold	Die Gutschein kann erst verbraucht werden, wenn die Ausgaben des Kontos diesen Schwellenwert erreichen, nachdem Gutschein eingelöst wurde. Das CurrencyCode-Element bestimmt die Währung.	doppelt
StartDate	Die Gutschein kann nicht vor dem Startdatum eingelöst werden.	dateTime

Anforderungen

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

Verwendet von

SearchCoupons