@wix/ecom 1.0.506 → 1.0.508

package/build/cjs/src/ecom-v1-order.types.d.ts

@@ -102,6 +102,11 @@ export interface Order {
     checkoutId?: string | null;
     /** Custom fields. */
     customFields?: CustomField[];
+    /**
+     * Order balance summary.
+     * @readonly
+     */
+    balanceSummary?: BalanceSummary;
     /** Additional fees applied to the order. */
     additionalFees?: AdditionalFee[];
     /**
@@ -158,6 +163,11 @@ export interface OrderLineItem {
      * To get fulfillment information, pass the order ID to [List Fulfillments For Single Order](https://dev.wix.com/docs/rest/api-reference/wix-e-commerce/order-fulfillments/list-fulfillments-for-single-order).
      */
     fulfillerId?: string | null;
+    /**
+     * Number of items that was already refunded
+     * @readonly
+     */
+    refundQuantity?: number | null;
     /**
      * quantity of inventory requested to be returned. Whether to restock or ignore the request is up the vertical.
      * @readonly
@@ -199,6 +209,8 @@ export interface OrderLineItem {
      * @readonly
      */
     depositAmount?: Price;
+    /** Total price **after** catalog-defined discount and line item discounts. */
+    lineItemPrice?: Price;
 }
 export interface ProductName {
     /**
@@ -403,6 +415,8 @@ export interface SubscriptionInfo {
 export interface SubscriptionSettings {
     /** Frequency of recurring payment. */
     frequency?: SubscriptionFrequency;
+    /** Interval of recurring payment */
+    interval?: number | null;
     /** Whether subscription is renewed automatically at the end of each period. */
     autoRenewal?: boolean;
     /** Number of billing cycles before subscription ends. Ignored if `autoRenewal: true`. */
@@ -698,6 +712,39 @@ export interface TaxSummary {
      */
     totalTax?: Price;
 }
+export interface OrderTaxInfo {
+    /** Calculated tax, added from line items. */
+    totalTax?: Price;
+    /** The summary of the tax breakdown for all the line items. It will hold for each tax name, the aggregated tax amount paid for it and the tax rate. */
+    taxBreakdown?: OrderTaxBreakdown[];
+}
+/**
+ * The summary of the tax breakdown for all the line items. It will hold for each tax name, the aggregated tax amount paid for it and the tax rate.
+ * Tax breakdown is the tax amount split to the tax authorities that applied on the line item.
+ */
+export interface OrderTaxBreakdown {
+    /** The name of the tax against which this tax amount was calculated. */
+    taxName?: string;
+    /** The type of tax that was calculated. Depends on the company's nexus settings as well as the jurisdiction's tax laws. */
+    taxType?: string;
+    /** The name of the jurisdiction in which this tax detail applies. */
+    jurisdiction?: string;
+    /** The type of the jurisdiction in which this tax detail applies (e.g. Country,State,County,City,Special). */
+    jurisdictionType?: JurisdictionType;
+    /** The rate at which this tax detail was calculated. */
+    rate?: string;
+    /** The sum of all the tax from line items that calculated by the tax identifiers. */
+    aggregatedTaxAmount?: Price;
+}
+/** JurisdictionType represents the type of the jurisdiction in which this tax detail applies (e.g. Country,State,County,City,Special). */
+export declare enum JurisdictionType {
+    UNDEFINED = "UNDEFINED",
+    COUNTRY = "COUNTRY",
+    STATE = "STATE",
+    COUNTY = "COUNTY",
+    CITY = "CITY",
+    SPECIAL = "SPECIAL"
+}
 export interface AppliedDiscount extends AppliedDiscountDiscountSourceOneOf {
     /** Applied coupon info. */
     coupon?: Coupon;
@@ -1052,6 +1099,17 @@ export interface BalanceSummary {
      * @readonly
      */
     balance?: Balance;
+    /**
+     * Sum of all historically approved (succeeded) payments
+     * including those which had been subsequently refunded or partially refunded
+     * @readonly
+     */
+    paid?: Price;
+    /**
+     * Sum of all refunded payments ( with status success )
+     * @readonly
+     */
+    refunded?: Price;
 }
 /**
  * Order balance. Reflects amount left to be paid on order and is calculated dynamically. Can be negative per balance definition.
@@ -2468,7 +2526,7 @@ export interface UpdateOrderResponse {
 }
 export interface BulkUpdateOrderRequest {
     /** Orders to be updated. */
-    orders: MaskedOrder[];
+    orders?: MaskedOrder[];
     /** Set to `true` if you wish to receive back the updated orders in the response */
     returnEntity?: boolean;
 }
@@ -2477,7 +2535,9 @@ export interface MaskedOrder {
     order?: Order;
 }
 export interface BulkUpdateOrderResponse {
+    /** Bulk action results. */
     results?: BulkOrderResult[];
+    /** Bulk action metadata. */
     bulkActionMetadata?: BulkActionMetadata;
 }
 export interface CommitDeltasRequest {
@@ -2590,6 +2650,8 @@ export interface OrderLineItemChangedDetails {
     taxDetails?: ItemTaxFullDetails;
     /** Additional description for the price. For example, when price is 0 but additional details about the actual price are needed - "Starts at $67". */
     priceDescription?: PriceDescription;
+    /** Total price **after** catalog-defined discount and line item discounts. */
+    lineItemPrice?: Price;
     /** Total price after all discounts excluding tax. */
     totalPriceBeforeTax?: Price;
 }
@@ -3275,6 +3337,21 @@ export interface RestockItem {
     /** Line item quantity being restocked. */
     quantity?: number;
 }
+export interface BulkUpdateOrderTagsRequest {
+    /** IDs of orders to update tags for. */
+    orderIds?: string[];
+    /** Tags to be added to orders */
+    assignTags?: Tags;
+    /** Tags to be removed from orders */
+    unassignTags?: Tags;
+}
+export interface BulkUpdateOrderTagsResponse {
+    results?: BulkUpdateOrderTagsResult[];
+    bulkActionMetadata?: BulkActionMetadata;
+}
+export interface BulkUpdateOrderTagsResult {
+    itemMetadata?: ItemMetadata;
+}
 /** Triggered when the the order status changes to approved */
 export interface OrderApproved {
     /** The order that was updated */
@@ -3911,6 +3988,23 @@ export interface GetOrderResponseNonNullableFields {
                 formattedAmount: string;
             };
         };
+        taxInfo?: {
+            totalTax?: {
+                amount: string;
+                formattedAmount: string;
+            };
+            taxBreakdown: {
+                taxName: string;
+                taxType: string;
+                jurisdiction: string;
+                jurisdictionType: JurisdictionType;
+                rate: string;
+                aggregatedTaxAmount?: {
+                    amount: string;
+                    formattedAmount: string;
+                };
+            }[];
+        };
         appliedDiscounts: {
             coupon?: {
                 id: string;
@@ -4443,6 +4537,23 @@ export interface SearchOrdersResponseNonNullableFields {
                 formattedAmount: string;
             };
         };
+        taxInfo?: {
+            totalTax?: {
+                amount: string;
+                formattedAmount: string;
+            };
+            taxBreakdown: {
+                taxName: string;
+                taxType: string;
+                jurisdiction: string;
+                jurisdictionType: JurisdictionType;
+                rate: string;
+                aggregatedTaxAmount?: {
+                    amount: string;
+                    formattedAmount: string;
+                };
+            }[];
+        };
         appliedDiscounts: {
             coupon?: {
                 id: string;
@@ -4975,6 +5086,23 @@ export interface CreateOrderResponseNonNullableFields {
                 formattedAmount: string;
             };
         };
+        taxInfo?: {
+            totalTax?: {
+                amount: string;
+                formattedAmount: string;
+            };
+            taxBreakdown: {
+                taxName: string;
+                taxType: string;
+                jurisdiction: string;
+                jurisdictionType: JurisdictionType;
+                rate: string;
+                aggregatedTaxAmount?: {
+                    amount: string;
+                    formattedAmount: string;
+                };
+            }[];
+        };
         appliedDiscounts: {
             coupon?: {
                 id: string;
@@ -5507,6 +5635,23 @@ export interface UpdateOrderResponseNonNullableFields {
                 formattedAmount: string;
             };
         };
+        taxInfo?: {
+            totalTax?: {
+                amount: string;
+                formattedAmount: string;
+            };
+            taxBreakdown: {
+                taxName: string;
+                taxType: string;
+                jurisdiction: string;
+                jurisdictionType: JurisdictionType;
+                rate: string;
+                aggregatedTaxAmount?: {
+                    amount: string;
+                    formattedAmount: string;
+                };
+            }[];
+        };
         appliedDiscounts: {
             coupon?: {
                 id: string;
@@ -5811,553 +5956,6 @@ export interface UpdateOrderResponseNonNullableFields {
         };
     };
 }
-export interface BulkUpdateOrderResponseNonNullableFields {
-    results: {
-        itemMetadata?: {
-            originalIndex: number;
-            success: boolean;
-            error?: {
-                code: string;
-                description: string;
-            };
-        };
-        item?: {
-            number: string;
-            lineItems: {
-                id: string;
-                productName?: {
-                    original: string;
-                };
-                catalogReference?: {
-                    catalogItemId: string;
-                    appId: string;
-                };
-                quantity: number;
-                totalDiscount?: {
-                    amount: string;
-                    formattedAmount: string;
-                };
-                descriptionLines: {
-                    plainText?: {
-                        original: string;
-                    };
-                    colorInfo?: {
-                        original: string;
-                    };
-                    plainTextValue?: {
-                        original: string;
-                    };
-                    color: string;
-                    name?: {
-                        original: string;
-                    };
-                    lineType: DescriptionLineType;
-                }[];
-                image?: {
-                    id: string;
-                    url: string;
-                    height: number;
-                    width: number;
-                };
-                physicalProperties?: {
-                    shippable: boolean;
-                };
-                itemType?: {
-                    preset: ItemTypeItemType;
-                    custom: string;
-                };
-                price?: {
-                    amount: string;
-                    formattedAmount: string;
-                };
-                priceBeforeDiscounts?: {
-                    amount: string;
-                    formattedAmount: string;
-                };
-                totalPriceBeforeTax?: {
-                    amount: string;
-                    formattedAmount: string;
-                };
-                totalPriceAfterTax?: {
-                    amount: string;
-                    formattedAmount: string;
-                };
-                paymentOption: PaymentOptionType;
-                taxDetails?: {
-                    taxableAmount?: {
-                        amount: string;
-                        formattedAmount: string;
-                    };
-                    taxRate: string;
-                    totalTax?: {
-                        amount: string;
-                        formattedAmount: string;
-                    };
-                };
-                digitalFile?: {
-                    fileId: string;
-                };
-                subscriptionInfo?: {
-                    cycleNumber: number;
-                    subscriptionOptionTitle: string;
-                    subscriptionSettings?: {
-                        frequency: SubscriptionFrequency;
-                        autoRenewal: boolean;
-                    };
-                };
-                priceDescription?: {
-                    original: string;
-                };
-                depositAmount?: {
-                    amount: string;
-                    formattedAmount: string;
-                };
-                locations: {
-                    id: string;
-                    quantity: number;
-                }[];
-                lineItemPrice?: {
-                    amount: string;
-                    formattedAmount: string;
-                };
-            }[];
-            buyerInfo?: {
-                visitorId: string;
-                memberId: string;
-            };
-            paymentStatus: PaymentStatus;
-            fulfillmentStatus: FulfillmentStatus;
-            weightUnit: WeightUnit;
-            taxIncludedInPrices: boolean;
-            priceSummary?: {
-                subtotal?: {
-                    amount: string;
-                    formattedAmount: string;
-                };
-                shipping?: {
-                    amount: string;
-                    formattedAmount: string;
-                };
-                tax?: {
-                    amount: string;
-                    formattedAmount: string;
-                };
-                discount?: {
-                    amount: string;
-                    formattedAmount: string;
-                };
-                totalPrice?: {
-                    amount: string;
-                    formattedAmount: string;
-                };
-                total?: {
-                    amount: string;
-                    formattedAmount: string;
-                };
-                totalWithGiftCard?: {
-                    amount: string;
-                    formattedAmount: string;
-                };
-                totalWithoutGiftCard?: {
-                    amount: string;
-                    formattedAmount: string;
-                };
-                totalAdditionalFees?: {
-                    amount: string;
-                    formattedAmount: string;
-                };
-            };
-            billingInfo?: {
-                address?: {
-                    streetAddress?: {
-                        number: string;
-                        name: string;
-                        apt: string;
-                    };
-                };
-                contactDetails?: {
-                    vatId?: {
-                        id: string;
-                        type: VatType;
-                    };
-                };
-            };
-            shippingInfo?: {
-                title: string;
-                logistics?: {
-                    shippingDestination?: {
-                        address?: {
-                            streetAddress?: {
-                                number: string;
-                                name: string;
-                                apt: string;
-                            };
-                        };
-                        contactDetails?: {
-                            vatId?: {
-                                id: string;
-                                type: VatType;
-                            };
-                        };
-                    };
-                    pickupDetails?: {
-                        address?: {
-                            streetAddress?: {
-                                number: string;
-                                name: string;
-                                apt: string;
-                            };
-                        };
-                        pickupMethod: PickupMethod;
-                    };
-                };
-                cost?: {
-                    price?: {
-                        amount: string;
-                        formattedAmount: string;
-                    };
-                    totalPriceBeforeTax?: {
-                        amount: string;
-                        formattedAmount: string;
-                    };
-                    totalPriceAfterTax?: {
-                        amount: string;
-                        formattedAmount: string;
-                    };
-                    taxDetails?: {
-                        taxableAmount?: {
-                            amount: string;
-                            formattedAmount: string;
-                        };
-                        taxRate: string;
-                        totalTax?: {
-                            amount: string;
-                            formattedAmount: string;
-                        };
-                    };
-                    discount?: {
-                        amount: string;
-                        formattedAmount: string;
-                    };
-                };
-            };
-            status: OrderStatus;
-            taxSummary?: {
-                totalTax?: {
-                    amount: string;
-                    formattedAmount: string;
-                };
-            };
-            appliedDiscounts: {
-                coupon?: {
-                    id: string;
-                    code: string;
-                    name: string;
-                    amount?: {
-                        amount: string;
-                        formattedAmount: string;
-                    };
-                };
-                merchantDiscount?: {
-                    discountReason: DiscountReason;
-                    amount?: {
-                        amount: string;
-                        formattedAmount: string;
-                    };
-                };
-                discountRule?: {
-                    id: string;
-                    name?: {
-                        original: string;
-                    };
-                    amount?: {
-                        amount: string;
-                        formattedAmount: string;
-                    };
-                };
-                discountType: DiscountType;
-                lineItemIds: string[];
-            }[];
-            activities: {
-                customActivity?: {
-                    appId: string;
-                    type: string;
-                };
-                merchantComment?: {
-                    message: string;
-                };
-                orderRefunded?: {
-                    manual: boolean;
-                    amount?: {
-                        amount: string;
-                        formattedAmount: string;
-                    };
-                    reason: string;
-                };
-                orderCreatedFromExchange?: {
-                    originalOrderId: string;
-                };
-                newExchangeOrderCreated?: {
-                    exchangeOrderId: string;
-                    lineItems: {
-                        lineItemId: string;
-                        quantity: number;
-                    }[];
-                };
-                draftOrderChangesApplied?: {
-                    draftOrderId: string;
-                    changes: {
-                        lineItemChanged?: {
-                            id: string;
-                            name?: {
-                                original: string;
-                            };
-                            quantity?: {
-                                originalQuantity: number;
-                                newQuantity: number;
-                                diff: number;
-                                deltaType: LineItemQuantityChangeType;
-                            };
-                            price?: {
-                                originalPrice?: {
-                                    amount: string;
-                                    formattedAmount: string;
-                                };
-                                newPrice?: {
-                                    amount: string;
-                                    formattedAmount: string;
-                                };
-                            };
-                        };
-                        lineItemAdded?: {
-                            id: string;
-                            name?: {
-                                original: string;
-                            };
-                            quantity: number;
-                        };
-                        lineItemRemoved?: {
-                            id: string;
-                            name?: {
-                                original: string;
-                            };
-                            quantity: number;
-                        };
-                        discountAdded?: {
-                            id: string;
-                            name?: {
-                                original: string;
-                            };
-                            affectedLineItems: {
-                                id: string;
-                                name?: {
-                                    original: string;
-                                };
-                                amount?: {
-                                    amount: string;
-                                    formattedAmount: string;
-                                };
-                            }[];
-                            totalAmount?: {
-                                amount: string;
-                                formattedAmount: string;
-                            };
-                        };
-                        discountRemoved?: {
-                            id: string;
-                            name?: {
-                                original: string;
-                            };
-                            affectedLineItems: {
-                                id: string;
-                                name?: {
-                                    original: string;
-                                };
-                                amount?: {
-                                    amount: string;
-                                    formattedAmount: string;
-                                };
-                            }[];
-                            totalAmount?: {
-                                amount: string;
-                                formattedAmount: string;
-                            };
-                        };
-                        additionalFeeAdded?: {
-                            id: string;
-                            name?: {
-                                original: string;
-                            };
-                            affectedLineItems: {
-                                id: string;
-                                name?: {
-                                    original: string;
-                                };
-                                amount?: {
-                                    amount: string;
-                                    formattedAmount: string;
-                                };
-                            }[];
-                            totalAmount?: {
-                                amount: string;
-                                formattedAmount: string;
-                            };
-                        };
-                        additionalFeeRemoved?: {
-                            id: string;
-                            name?: {
-                                original: string;
-                            };
-                            affectedLineItems: {
-                                id: string;
-                                name?: {
-                                    original: string;
-                                };
-                                amount?: {
-                                    amount: string;
-                                    formattedAmount: string;
-                                };
-                            }[];
-                            totalAmount?: {
-                                amount: string;
-                                formattedAmount: string;
-                            };
-                        };
-                        totalPriceChanged?: {
-                            originalTotal?: {
-                                amount: string;
-                                formattedAmount: string;
-                            };
-                            newTotal?: {
-                                amount: string;
-                                formattedAmount: string;
-                            };
-                        };
-                    }[];
-                };
-                type: ActivityType;
-            }[];
-            attributionSource: AttributionSource;
-            createdBy?: {
-                userId: string;
-                memberId: string;
-                visitorId: string;
-                appId: string;
-            };
-            channelInfo?: {
-                type: ChannelType;
-            };
-            customFields: {
-                title: string;
-            }[];
-            isInternalOrderCreate: boolean;
-            payNow?: {
-                subtotal?: {
-                    amount: string;
-                    formattedAmount: string;
-                };
-                shipping?: {
-                    amount: string;
-                    formattedAmount: string;
-                };
-                tax?: {
-                    amount: string;
-                    formattedAmount: string;
-                };
-                discount?: {
-                    amount: string;
-                    formattedAmount: string;
-                };
-                totalPrice?: {
-                    amount: string;
-                    formattedAmount: string;
-                };
-                total?: {
-                    amount: string;
-                    formattedAmount: string;
-                };
-                totalWithGiftCard?: {
-                    amount: string;
-                    formattedAmount: string;
-                };
-                totalWithoutGiftCard?: {
-                    amount: string;
-                    formattedAmount: string;
-                };
-                totalAdditionalFees?: {
-                    amount: string;
-                    formattedAmount: string;
-                };
-            };
-            balanceSummary?: {
-                balance?: {
-                    amount: string;
-                    formattedAmount: string;
-                };
-                paid?: {
-                    amount: string;
-                    formattedAmount: string;
-                };
-                refunded?: {
-                    amount: string;
-                    formattedAmount: string;
-                };
-            };
-            additionalFees: {
-                name: string;
-                price?: {
-                    amount: string;
-                    formattedAmount: string;
-                };
-                taxDetails?: {
-                    taxableAmount?: {
-                        amount: string;
-                        formattedAmount: string;
-                    };
-                    taxRate: string;
-                    totalTax?: {
-                        amount: string;
-                        formattedAmount: string;
-                    };
-                };
-                priceBeforeTax?: {
-                    amount: string;
-                    formattedAmount: string;
-                };
-                id: string;
-                lineItemIds: string[];
-            }[];
-            recipientInfo?: {
-                address?: {
-                    streetAddress?: {
-                        number: string;
-                        name: string;
-                        apt: string;
-                    };
-                };
-                contactDetails?: {
-                    vatId?: {
-                        id: string;
-                        type: VatType;
-                    };
-                };
-            };
-            tags?: {
-                privateTags?: {
-                    tagIds: string[];
-                };
-                tags?: {
-                    tagIds: string[];
-                };
-            };
-        };
-    }[];
-    bulkActionMetadata?: {
-        totalSuccesses: number;
-        totalFailures: number;
-        undetailedFailures: number;
-    };
-}
 export interface CancelOrderResponseNonNullableFields {
     order?: {
         number: string;
@@ -6586,6 +6184,23 @@ export interface CancelOrderResponseNonNullableFields {
                 formattedAmount: string;
             };
         };
+        taxInfo?: {
+            totalTax?: {
+                amount: string;
+                formattedAmount: string;
+            };
+            taxBreakdown: {
+                taxName: string;
+                taxType: string;
+                jurisdiction: string;
+                jurisdictionType: JurisdictionType;
+                rate: string;
+                aggregatedTaxAmount?: {
+                    amount: string;
+                    formattedAmount: string;
+                };
+            }[];
+        };
         appliedDiscounts: {
             coupon?: {
                 id: string;