diff --git a/reference/orders.sf.yml b/reference/orders.sf.yml
index 20719ac44..6c9ecd2f9 100644
--- a/reference/orders.sf.yml
+++ b/reference/orders.sf.yml
@@ -146,11 +146,18 @@ components:
           type: string
           description: Shopperʼs provided message for the order.
         shippingCostTotal:
-          type: integer
+          type: number
         shippingCostBeforeDiscount:
-          type: integer
+          type: number
+          description: Estimated total shipping cost before any shipping discounts have been applied.
+        comparisonShippingCost:
+          type: number
+          description: |
+            The total shipping cost to be shown to shopper in the summary as struck-through.
+            - If the entered-price and display-price have the same tax setting (e.g.: both are tax-inclusive), this field will be the estimated total shipping cost before any coupons applied (but after automatic promotions applied).
+            - If the entered-price and display-price have different tax setting (e.g.: one is tax-inclusive, and one is tax-exclusive), this field will be the estimated total shipping cost before any discounts applied, similar to the `shippingCostBeforeDiscount`.
         handlingCostTotal:
-          type: integer
+          type: number
         customerCanBeCreated:
           type: boolean
         taxes:
@@ -907,6 +914,15 @@ components:
         costTaxClassId:
           type: integer
           example: 2
+        shippingCostBeforeDiscount:
+          type: number
+          description: Estimated consignment shipping cost before any shipping discounts have been applied.
+        comparisonShippingCost:
+          type: number
+          description: |
+            The consignment shipping cost to be shown to shopper in the summary as struck-through.
+            - If the entered-price and display-price have the same tax setting (e.g.: both are tax-inclusive), this field will be the estimated shipping cost before any coupons applied (but after automatic promotions applied).
+            - If the entered-price and display-price have different tax setting (e.g.: one is tax-inclusive, and one is tax-exclusive), this field will be the estimated shipping cost before any discounts applied, similar to the `shippingCostBeforeDiscount`.
         baseHandlingCost:
           type: number
           example: 0.00
@@ -958,6 +974,8 @@ components:
           costIncTax: 16.7
           costTax: 1.2
           costTaxClassId: 2
+          shippingCostBeforeDiscount: 17.5
+          comparisonShippingCost: 16.5
           baseHandlingCost: 0
           handlingCostExTax: 0
           handlingCostIncTax: 0