pypresscart

Order Items¶

Team-wide order-item reporting. For per-profile order items, see Profiles.

client.order_items  # OrderItemsResource

Methods overview¶

Method	HTTP	Scope
`list`	`GET /order-items`	`orders.lists`

`list`¶

def list(
    *,
    limit: int = 25,
    page: int = 1,
    sort_by: str | None = None,
    order_by: str | None = None,
    as_json: bool | None = None,
) -> Paginated[OrderItem] | dict

Returns a Paginated envelope of OrderItem. Each item has the purchased product, the associated article and campaign (if any), outlet, commission/accounting fields, and refund status.

Example

page = client.order_items.list(limit=50, sort_by="created_at", order_by="desc")
for oi in page.records:
    print(oi.product_name, oi.sale_price, oi.commission_status)

What’s visible¶

internal_cost and reseller_price will always be null on the API. Don’t rely on them in your integration.

Recipes¶

Pending publisher payouts¶

unpaid = [
    oi for oi in client.order_items.list(limit=100).records
    if not oi.is_publisher_paid and oi.commission_status != "NOT_APPLICABLE"
]

Link order items back to orders¶

Each OrderItem.order_id points to the parent order. Pair with client.orders.get(...) to get full context:

oi = client.order_items.list(limit=1).records[0]
parent = client.orders.get(oi.order_id)
print(parent.status, parent.total)