InsertionOrderStatus Value Set - Customer Billing

Defines the possible status values of an InsertionOrder.

Syntax

<xs:simpleType name="InsertionOrderStatus" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:restriction base="xs:string">
    <xs:enumeration value="PendingUserReview">
      <xs:annotation>
        <xs:appinfo>
          <EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/">1</EnumerationValue>
        </xs:appinfo>
      </xs:annotation>
    </xs:enumeration>
    <xs:enumeration value="Active">
      <xs:annotation>
        <xs:appinfo>
          <EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/">2</EnumerationValue>
        </xs:appinfo>
      </xs:annotation>
    </xs:enumeration>
    <xs:enumeration value="Declined">
      <xs:annotation>
        <xs:appinfo>
          <EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/">3</EnumerationValue>
        </xs:appinfo>
      </xs:annotation>
    </xs:enumeration>
    <xs:enumeration value="Expired">
      <xs:annotation>
        <xs:appinfo>
          <EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/">4</EnumerationValue>
        </xs:appinfo>
      </xs:annotation>
    </xs:enumeration>
    <xs:enumeration value="Canceled">
      <xs:annotation>
        <xs:appinfo>
          <EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/">5</EnumerationValue>
        </xs:appinfo>
      </xs:annotation>
    </xs:enumeration>
    <xs:enumeration value="NotStarted">
      <xs:annotation>
        <xs:appinfo>
          <EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/">6</EnumerationValue>
        </xs:appinfo>
      </xs:annotation>
    </xs:enumeration>
    <xs:enumeration value="Exhausted">
      <xs:annotation>
        <xs:appinfo>
          <EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/">7</EnumerationValue>
        </xs:appinfo>
      </xs:annotation>
    </xs:enumeration>
    <xs:enumeration value="Queued">
      <xs:annotation>
        <xs:appinfo>
          <EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/">11</EnumerationValue>
        </xs:appinfo>
      </xs:annotation>
    </xs:enumeration>
  </xs:restriction>
</xs:simpleType>

Values

The InsertionOrderStatus value set has the following values: Active, Canceled, Declined, Exhausted, Expired, NotStarted, PendingUserReview, Queued.

Value	Description
Active	You have an approved insertion order, and your ads are eligible to run. You can also use this value on update to approve an insertion order if its Status is PendingUserReview. Once approved, the insertion order can only be updated via the InsertionOrderPendingChanges object.
Canceled	You have canceled an order that you created or that was created by Microsoft Advertising. A canceled order cannot be reactivated. You can use this value on update to cancel an insertion order if its Status is Active, Exhausted, or NotStarted. If the insertion order Status is PendingUserReview, then only an internal Microsoft Advertising system admin can use this value on update to cancel an insertion order.
Declined	You have declined an order created by Microsoft Advertising, or the order you created has been declined. Submit a new order, contact your Microsoft Advertising account manager, or contact support. You can also use this value on update to decline an insertion order if its Status is PendingUserReview. An internal Microsoft Advertising system admin cannot use this value on update.
Exhausted	Your balance has been depleted and the order is no longer active. This status is read-only and only the system can set the status to Exhausted.
Expired	Your order has reached its end date and is no longer valid. To reenable an expired insertion order you can extend the end date via the EndDate element of the InsertionOrderPendingChanges object. Note that the StartDate of an expired insertion order cannot be updated. This status is read-only and only the system can set the status to Expired.
NotStarted	You have an approved order that has not reached its start date yet. This status is read-only and only the system can set the status to NotStarted.
PendingUserReview	You need to approve or decline an order that Microsoft Advertising created for your account. This status is read-only and can only be set by Microsoft Advertising.
Queued	Reserved for future use.

Requirements

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

Used By

InsertionOrder