2025-02-18: Order Service - deprecated fields

Overview

Several fields in order's response have been deprecated in favor of new calculatedPrice and unitPrice fields. The new fields provide a more comprehensive and consistent way to access price calculations.

Deprecated order-level fields:

• totalPrice - use calculatedPrice.finalPrice instead
• subTotalPrice - use calculatedPrice.price or calculatedPrice.discountedPrice instead
• taxAggregate - use calculatedPrice.finalPrice.taxAggregate instead
• subtotalAggregate - use calculatedPrice.price instead
• totalDiscount - use calculatedPrice.totalDiscount instead
• feeYrnAggregate - use calculatedPrice.totalFees and items[].calculatedPrice.fees instead
• shipping - use calculatedPrice.totalShipping instead
• itemFeesTotal - use calculatedPrice.totalFee instead
• paymentFeesTotal - use calculatedPrice.paymentFees instead
• totalAuthorizedAmount - use calculatedPrice.upliftValue instead

Deprecated order item-level fields:

• price - use unitPrice instead
• itemPrice - use unitPrice instead
• itemTaxInfo - use calculatedPrice.price instead
• fees - use calculatedPrice.fees instead
• authorizedAmount - use calculatedPrice.upliftValue instead
• totalDiscount - use calculatedPrice.totalDiscount instead
• externalFees - use calculatedPrice.fees instead
• couponDiscounts - use calculatedPrice.totalDiscounts.appliedDiscounts instead

Updated endpoints

Endpoint	Description
Creating a new order as employee	Deprecated response fields in favor of calculatedPrice and unitPrice
Creating a new order as customer	Deprecated response fields in favor of calculatedPrice and unitPrice
Retrieving order details	Deprecated response fields in favor of calculatedPrice and unitPrice
Retrieving a specific order by ID	Deprecated response fields in favor of calculatedPrice and unitPrice

Known problems

There are no known problems.