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:restriction>
</xs:simpleType>

Values

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.

Requirements

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

Used By

InsertionOrder