# Vendor Purchase Orders

- BigQuery table name: `amazon_vendor_purchase_orders`
- Available in: Vendor Central
- Data scheme index: https://api.datadoe.com/api/v1/spec/data-scheme.md

Vendor Retail Procurement purchase order line items. One row per line item with purchase order header fields repeated. ordered_quantity is Amazon-to-vendor PO quantity, not customer retail demand (manufacturing_retail_ordered_units). Acknowledgement and Amazon fulfillment-center received quantity are on amazon_vendor_purchase_orders_status.

- Source type: `VENDOR_CENTRAL`
- Source ID: `6f9b8159d659a68c2274cdf881f4c18cdbf917e32a0b853f6b01ed7f106e4a06`
- Requires a date period: yes
- Contains PII: no
- Premium table: no
- User-managed: no
- Default dataset: no
- Rows count towards billing: yes
- Hub: https://www.datadoe.com/hub/data-scheme?source=VENDOR_CENTRAL&table=6f9b8159d659a68c2274cdf881f4c18cdbf917e32a0b853f6b01ed7f106e4a06

## Fetch periods

- `INITIAL` (30 days)
- `CONTINUOUS`

## Data availability

- `INTRADAY` — DataDoe checks for new and changed purchase orders every 2 hours. Availability depends on when Amazon provides the orders and on sync and export processing. Refresh: Every 2 hours.

## Search aliases

- purchase order
- po quantity

## Columns (33)

- `marketplace_id` (`TEXT`, required) — Amazon provided ID that represents a specific country where the Seller or Vendor operates.
- `marketplace_country_code` (`TEXT`, required) — ISO country code for the Amazon marketplace.
- `marketplace_country_name` (`TEXT`, required) — Human-readable country name for the marketplace (derived from marketplace_id).
- `seller_or_vendor_id` (`TEXT`, required) — DataDoe account identifier used by MCP/API calls (sellers_and_vendors_list, exports). Not unique in amazon_sellers_and_vendors_context when one account has multiple connection contexts — join that table on connection_context_id instead.
- `seller_or_vendor_name` (`TEXT`, required) — DataDoe connection context display name for the seller or vendor.
- `marketplace_seller_id` (`TEXT`, nullable) — Amazon Seller Central seller ID from the connection (connection_seller_id). Null when the connection has no seller ID.
- `date` (`DATE`, nullable) — Calendar day of purchase_order_date. Use for date filtering.
- `purchase_order_number` (`TEXT`, required)
- `item_sequence_number` (`TEXT`, required) — Line number within the purchase order. Grain key with purchase_order_number.
- `purchase_order_state` (`TEXT`, nullable) — Amazon purchaseOrderState: New, Acknowledged, or Closed.
- `purchase_order_type` (`TEXT`, nullable) — Amazon purchaseOrderType: RegularOrder, ConsignedOrder, NewProductIntroduction, or RushOrder.
- `payment_method` (`TEXT`, nullable) — Amazon paymentMethod: Invoice, Consignment, CreditCard, or Prepaid.
- `deal_code` (`TEXT`, nullable) — Deal code when the purchase order is tied to a special deal.
- `purchase_order_date` (`DATE`, nullable) — When Amazon created the purchase order.
- `purchase_order_changed_date` (`DATE`, nullable) — When Amazon last changed the purchase order.
- `purchase_order_state_changed_date` (`DATE`, nullable) — When purchase_order_state last changed.
- `ship_window` (`TEXT`, nullable) — Amazon ship window as start--end timestamps. The vendor must ship inside this window. Not a single date.
- `delivery_window` (`TEXT`, nullable) — Amazon delivery window as start--end timestamps. Not a single date and not ship_window.
- `selling_party_id` (`TEXT`, nullable) — Vendor party id.
- `buying_party_id` (`TEXT`, nullable) — Amazon buying party id.
- `ship_to_party_id` (`TEXT`, nullable) — Amazon fulfillment center the vendor ships to.
- `bill_to_party_id` (`TEXT`, nullable) — Amazon bill-to party id.
- `asin` (`TEXT`, nullable)
- `vendor_product_identifier` (`TEXT`, nullable)
- `ordered_quantity` (`NUMBER`, nullable) — Quantity Amazon ordered from the vendor on this purchase-order line. Not customer retail demand; that is manufacturing_retail_ordered_units. Read with ordered_quantity_unit_of_measure (often Cases) and ordered_quantity_unit_size.
- `ordered_quantity_unit_of_measure` (`TEXT`, nullable) — Unit of measure for ordered_quantity, such as Cases or Eaches. Do not sum Cases with customer-ordered units.
- `ordered_quantity_unit_size` (`NUMBER`, nullable) — Case size when ordered_quantity_unit_of_measure is Cases.
- `is_back_order_allowed` (`LOGIC`, nullable) — Amazon allows the vendor to backorder this line.
- `net_cost_amount` (`NUMBER`, nullable) — Cost Amazon pays the vendor per unit. Not list_price_amount.
- `net_cost_currency` (`TEXT`, nullable)
- `list_price_amount` (`NUMBER`, nullable) — List price on the purchase order. Not the net cost Amazon pays.
- `list_price_currency` (`TEXT`, nullable)
- `last_seen_at` (`DATE`, required) — Timestamp when DataDoe last received this row from the Vendor API.

---

Query live via DataDoe MCP `exports_source_get` (connected accounts only), or request rows with `exports_create`.