@shipengine/elements 2.14.0 → 2.15.0

package/src/elements/manage-funding/manage-funding-element.d.ts

@@ -102,16 +102,18 @@ export declare const Element: ({ resources, ...props }: ManageFundingProps & {
                 vatNumber: string;
                 vatRegistrationTooltip: string;
                 vatFormText: string;
-                vatFormRegisterLater: string;
                 vatNumberInputHint: string;
                 vatNumberInputPlaceholder: string;
                 verifiedVat: string;
+                vatNumberFieldLabel: string;
+                vatTypePlaceholder: string;
+                issuingAuthorityPlaceholder: string;
+                issuingAuthorityFieldLabel: string;
                 vatFormErrors: {
                     invalidFieldValue: string;
                     verificationFailure: string;
                     forbidden: string;
                     connectionNotSupported: string;
-                    genericTitle: string;
                     genericText: string;
                 };
             };
@@ -803,6 +805,7 @@ export declare const Element: ({ resources, ...props }: ManageFundingProps & {
                         taxIssuingAuthority: string;
                         entityType: string;
                     };
+                    hsCode: string;
                     nonDelivery: {
                         returnToSender: string;
                         treatAsAbandoned: string;
@@ -840,6 +843,7 @@ export declare const Element: ({ resources, ...props }: ManageFundingProps & {
                         shipments: string;
                         warehouses: string;
                     };
+                    labelHasBeenPurchased: string;
                     emailIsRequired: string;
                     unknown: string;
                     noRatesAvailable: string;

package/src/elements/manage-warehouses/manage-warehouses.d.ts

@@ -119,16 +119,18 @@ export declare const Element: ({ resources, ...props }: object & {
                 vatNumber: string;
                 vatRegistrationTooltip: string;
                 vatFormText: string;
-                vatFormRegisterLater: string;
                 vatNumberInputHint: string;
                 vatNumberInputPlaceholder: string;
                 verifiedVat: string;
+                vatNumberFieldLabel: string;
+                vatTypePlaceholder: string;
+                issuingAuthorityPlaceholder: string;
+                issuingAuthorityFieldLabel: string;
                 vatFormErrors: {
                     invalidFieldValue: string;
                     verificationFailure: string;
                     forbidden: string;
                     connectionNotSupported: string;
-                    genericTitle: string;
                     genericText: string;
                 };
             };
@@ -837,6 +839,7 @@ export declare const Element: ({ resources, ...props }: object & {
                         taxIssuingAuthority: string;
                         entityType: string;
                     };
+                    hsCode: string;
                     nonDelivery: {
                         returnToSender: string;
                         treatAsAbandoned: string;
@@ -874,6 +877,7 @@ export declare const Element: ({ resources, ...props }: object & {
                         shipments: string;
                         warehouses: string;
                     };
+                    labelHasBeenPurchased: string;
                     emailIsRequired: string;
                     unknown: string;
                     noRatesAvailable: string;

package/src/elements/payment-method-settings/payment-method-settings-element.d.ts

@@ -102,16 +102,18 @@ export declare const Element: ({ resources, ...props }: PaymentMethodSettingsPro
                 vatNumber: string;
                 vatRegistrationTooltip: string;
                 vatFormText: string;
-                vatFormRegisterLater: string;
                 vatNumberInputHint: string;
                 vatNumberInputPlaceholder: string;
                 verifiedVat: string;
+                vatNumberFieldLabel: string;
+                vatTypePlaceholder: string;
+                issuingAuthorityPlaceholder: string;
+                issuingAuthorityFieldLabel: string;
                 vatFormErrors: {
                     invalidFieldValue: string;
                     verificationFailure: string;
                     forbidden: string;
                     connectionNotSupported: string;
-                    genericTitle: string;
                     genericText: string;
                 };
             };
@@ -803,6 +805,7 @@ export declare const Element: ({ resources, ...props }: PaymentMethodSettingsPro
                         taxIssuingAuthority: string;
                         entityType: string;
                     };
+                    hsCode: string;
                     nonDelivery: {
                         returnToSender: string;
                         treatAsAbandoned: string;
@@ -840,6 +843,7 @@ export declare const Element: ({ resources, ...props }: PaymentMethodSettingsPro
                         shipments: string;
                         warehouses: string;
                     };
+                    labelHasBeenPurchased: string;
                     emailIsRequired: string;
                     unknown: string;
                     noRatesAvailable: string;

package/src/elements/purchase-label/configure-shipment.d.ts

@@ -2,7 +2,7 @@ import { SE } from "@shipengine/react-api";
 import { RateFormProps } from "../../components/templates/rate-form";
 import { ShipmentFormProps } from "../../components/templates/shipment-form";
 import { UseShippingPresetsOptionsProps } from "../../hooks";
-import { PreferredRatesResponse, ShipFromAddress } from "../../types";
+import { HarmonizedTariffCode, PreferredRatesResponse, ShipFromAddress } from "../../types";
 import { PurchaseLabelFeatures } from "../../utilities";
 import { UseRatesFormProps, UseShipmentFormProps } from "./hooks";
 export type ShipmentFormMode = "browse_rates" | "select_service";
@@ -11,6 +11,7 @@ export type ConfigureShipmentProps = {
     errors?: ShipmentFormProps["errors"];
     features?: PurchaseLabelFeatures;
     getPreferredRates?: (shipment: SE.SalesOrderShipment, isInternational: boolean) => Promise<PreferredRatesResponse | undefined>;
+    harmonizedTariffCodes?: HarmonizedTariffCode[];
     insuranceAccount?: SE.InsuranceAccount;
     isLoading?: ShipmentFormProps["isLoading"];
     onAddressValidation?: UseShipmentFormProps["onAddressValidation"];

package/src/elements/purchase-label/hooks/index.d.ts

@@ -1,5 +1,3 @@
-export * from "./use-configure-shipment";
-export * from "./use-import-sales-order";
 export * from "./use-address";
 export * from "./use-customs";
 export * from "./use-presets";

package/src/elements/purchase-label/hooks/use-shipment-form.d.ts

@@ -1,9 +1,10 @@
 import { SE } from "@shipengine/react-api";
-import { ShipFromAddress, ShippingPreset } from "../../../types";
+import { HarmonizedTariffCode, ShipFromAddress, ShippingPreset } from "../../../types";
 import { UseAddressProps } from "./use-address";
 import { UsePresetsProps } from "./use-presets";
 export type UseShipmentFormProps = {
     compatibleCountryCodes?: UseAddressProps["compatibleCountryCodes"];
+    harmonizedTariffCodes?: HarmonizedTariffCode[];
     onAddressValidation?: UseAddressProps["onValidation"];
     onApplyPreset?: UsePresetsProps["onApply"];
     onChangeAddress?: UseAddressProps["onChange"];

package/src/elements/purchase-label/purchase-label.d.ts

@@ -1,9 +1,9 @@
 import React from "react";
 import { SE } from "@shipengine/react-api";
-import { UseShippingPresetsOptionsProps } from "../../hooks";
+import { UseConfigureShipmentProps, UseImportSalesOrderProps, UseShippingPresetsOptionsProps } from "../../hooks";
+import { HarmonizedTariffCode } from "../../types";
 import { PurchaseLabelFeatures } from "../../utilities";
 import { ConfigureShipmentProps } from "./configure-shipment";
-import { UseConfigureShipmentProps, UseImportSalesOrderProps } from "./hooks";
 /**
  * # Purchase Label Component Props
  *
@@ -45,6 +45,10 @@ export type PurchaseLabelCommonProps = {
      * flag and green checkmark when the rate is selected.
      */
     getPreferredRates?: ConfigureShipmentProps["getPreferredRates"];
+    /**
+     * `harmonizedTariffCodes` is an array of objects that contain the Harmonized Tariff Codes and descriptions used to populate the HS Codes dropdown within the Customs Form.
+     */
+    harmonizedTariffCodes?: HarmonizedTariffCode[];
     /**
      * `onAddressValidation` is an async/sync callback function that will be invoked on each Address
      * validation request. For example, whenever you update the `Ship To Address` or
@@ -262,10 +266,7 @@ export declare const Element: ({ resources, ...props }: PurchaseLabelCommonProps
                 refund_process: string;
                 refund_rules: string;
                 resultTitles: {
-                    approved: string; /**
-                     * A unique ID assigned during the creation of a sales order. It can be used to locate the
-                     * sales order and any subsequent shipments related to that order.
-                     */
+                    approved: string;
                     rejected: string;
                 };
                 voidedOn: string;
@@ -324,16 +325,18 @@ export declare const Element: ({ resources, ...props }: PurchaseLabelCommonProps
                 vatNumber: string;
                 vatRegistrationTooltip: string;
                 vatFormText: string;
-                vatFormRegisterLater: string;
                 vatNumberInputHint: string;
                 vatNumberInputPlaceholder: string;
                 verifiedVat: string;
+                vatNumberFieldLabel: string;
+                vatTypePlaceholder: string;
+                issuingAuthorityPlaceholder: string;
+                issuingAuthorityFieldLabel: string;
                 vatFormErrors: {
                     invalidFieldValue: string;
                     verificationFailure: string;
                     forbidden: string;
                     connectionNotSupported: string;
-                    genericTitle: string;
                     genericText: string;
                 };
             };
@@ -445,14 +448,6 @@ export declare const Element: ({ resources, ...props }: PurchaseLabelCommonProps
                     location_fee: string;
                     oversize: string;
                     returns: string;
-                    /**
-                     * # Purchase Label Component Props
-                     *
-                     * These are the shared props that will be passed into the `<PurchaseLabel.Element />`, and work
-                     * for either shipment-based or sales order-based label purchasing.
-                     *
-                     * @see {@link PurchaseLabel.Element | This prop types usage in `<PurchaseLabel.Element />`}
-                     */
                     notifications: string;
                     tip: string;
                     duties_and_taxes: string;
@@ -530,7 +525,9 @@ export declare const Element: ({ resources, ...props }: PurchaseLabelCommonProps
                 };
                 hints: {
                     contentDescription: string;
-                };
+                }; /**
+                 * `harmonizedTariffCodes` is an array of objects that contain the Harmonized Tariff Codes and descriptions used to populate the HS Codes dropdown within the Customs Form.
+                 */
                 loading: {
                     calculatingRates: string;
                 };
@@ -538,7 +535,11 @@ export declare const Element: ({ resources, ...props }: PurchaseLabelCommonProps
                     browseRates: string;
                     selectService: string;
                 };
-                multipleShippingServices: string;
+                multipleShippingServices: string; /**
+                 * `onAddressValidation` is an async/sync callback function that will be invoked on each Address
+                 * validation request. For example, whenever you update the `Ship To Address` or
+                 * `Ship From Address` for a given shipment.
+                 */
                 schemaErrors: {
                     shipFromUnitedStatesOnly: string;
                     shipFromAddressRequired: string;
@@ -549,10 +550,7 @@ export declare const Element: ({ resources, ...props }: PurchaseLabelCommonProps
                     uspsMediaMailAcknowledgement: string;
                     uspsFirstClassMailAcknowledgement_leof: string;
                     rateSavings: string;
-                    upsGroundSaverTermsAcknowledgement: string; /**
-                     * `onChangeShipmentFormMode` is an async/sync callback function that will be invoked each time
-                     * the user toggles the `Shipment Form Mode` between `Browse Rates` and `Selected Rate`.
-                     */
+                    upsGroundSaverTermsAcknowledgement: string;
                     dhlExpressTermsAcknowledgement: string;
                     noRateService: string;
                 };
@@ -562,10 +560,7 @@ export declare const Element: ({ resources, ...props }: PurchaseLabelCommonProps
                         b2c: string;
                         c2b: string;
                         c2c: string;
-                        b2b: string; /**
-                         * `onLabelCreateSuccess` is an async/sync callback provided by the client that is invoked if the
-                         * label is successfully created/purchased.
-                         */
+                        b2b: string;
                     };
                     notAtRisk: string;
                     notAtRiskShipmentTootip: string;
@@ -603,9 +598,7 @@ export declare const Element: ({ resources, ...props }: PurchaseLabelCommonProps
                     windsorFramework: string;
                     shipment: string;
                     rate_one: string;
-                    rate_other: string; /**
-                     * A unique Id refering the API code used to identify the type of order source, e.g. "amazon_ca"
-                     */
+                    rate_other: string;
                     payment: string;
                 };
             };
@@ -938,15 +931,15 @@ export declare const Element: ({ resources, ...props }: PurchaseLabelCommonProps
                     subFields: {
                         optional: string;
                     };
-                    /**
-                     * The Currency used through out the label purchase process. Default to USD
-                     */
                     parserFields: {
                         fullAddress: string;
                     };
                     paste: string;
                     preference: {
-                        confirm: string;
+                        confirm: string; /**
+                         * A unique ID assigned during the creation of a sales order. It can be used to locate the
+                         * sales order and any subsequent shipments related to that order.
+                         */
                         addressNotValidated: string;
                         modified: string;
                         title: string;
@@ -1044,6 +1037,7 @@ export declare const Element: ({ resources, ...props }: PurchaseLabelCommonProps
                         taxIssuingAuthority: string;
                         entityType: string;
                     };
+                    hsCode: string;
                     nonDelivery: {
                         returnToSender: string;
                         treatAsAbandoned: string;
@@ -1053,12 +1047,6 @@ export declare const Element: ({ resources, ...props }: PurchaseLabelCommonProps
                         recipientPays: string;
                         tooltip: {
                             title: string;
-                            /**
-                             * `onToggleAddressPreferenceDisclosure` is an async/sync callback function that will be invoked
-                             * each time the user toggles the `Address Preference` disclosure. This disclosure component
-                             * allows the user to select whether they would like to use the address they entered, or
-                             * the formatted address that we return after validation.
-                             */
                             restriction: string;
                             requirement1: string;
                             requirement2: string;
@@ -1087,6 +1075,7 @@ export declare const Element: ({ resources, ...props }: PurchaseLabelCommonProps
                         shipments: string;
                         warehouses: string;
                     };
+                    labelHasBeenPurchased: string;
                     emailIsRequired: string;
                     unknown: string;
                     noRatesAvailable: string;

package/src/elements/select-label-layout/select-label-layout-element.d.ts

@@ -101,16 +101,18 @@ export declare const Element: ({ resources, ...props }: object & {
                 vatNumber: string;
                 vatRegistrationTooltip: string;
                 vatFormText: string;
-                vatFormRegisterLater: string;
                 vatNumberInputHint: string;
                 vatNumberInputPlaceholder: string;
                 verifiedVat: string;
+                vatNumberFieldLabel: string;
+                vatTypePlaceholder: string;
+                issuingAuthorityPlaceholder: string;
+                issuingAuthorityFieldLabel: string;
                 vatFormErrors: {
                     invalidFieldValue: string;
                     verificationFailure: string;
                     forbidden: string;
                     connectionNotSupported: string;
-                    genericTitle: string;
                     genericText: string;
                 };
             };
@@ -802,6 +804,7 @@ export declare const Element: ({ resources, ...props }: object & {
                         taxIssuingAuthority: string;
                         entityType: string;
                     };
+                    hsCode: string;
                     nonDelivery: {
                         returnToSender: string;
                         treatAsAbandoned: string;
@@ -839,6 +842,7 @@ export declare const Element: ({ resources, ...props }: object & {
                         shipments: string;
                         warehouses: string;
                     };
+                    labelHasBeenPurchased: string;
                     emailIsRequired: string;
                     unknown: string;
                     noRatesAvailable: string;

package/src/elements/shipment-summary/shipment-summary.d.ts

@@ -192,16 +192,20 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                 vatNumber: string;
                 vatRegistrationTooltip: string;
                 vatFormText: string;
-                vatFormRegisterLater: string;
                 vatNumberInputHint: string;
                 vatNumberInputPlaceholder: string;
                 verifiedVat: string;
+                vatNumberFieldLabel: string;
+                vatTypePlaceholder: string;
+                issuingAuthorityPlaceholder: string;
+                issuingAuthorityFieldLabel: string; /**
+                 * `features` is a set of feature flags you would like to enable or disable in this component.
+                 */
                 vatFormErrors: {
                     invalidFieldValue: string;
                     verificationFailure: string;
                     forbidden: string;
                     connectionNotSupported: string;
-                    genericTitle: string;
                     genericText: string;
                 };
             };
@@ -933,6 +937,7 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                         taxIssuingAuthority: string;
                         entityType: string;
                     };
+                    hsCode: string;
                     nonDelivery: {
                         returnToSender: string;
                         treatAsAbandoned: string;
@@ -970,6 +975,7 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                         shipments: string;
                         warehouses: string;
                     };
+                    labelHasBeenPurchased: string;
                     emailIsRequired: string;
                     unknown: string;
                     noRatesAvailable: string;

package/src/elements/shipments-grid/hooks/use-shipments-grid.d.ts

@@ -84,6 +84,7 @@ export declare const useShipmentsGrid: ({ shipmentStatus, showShipmentIdFilter,
             currentPageSize: number;
             onPageSelect: (page: number) => void;
             onPageSizeSelect: (pageSize: number) => void;
+            resetCurrentPage: () => void;
         };
         pagesAmount: number;
         pageSize: number;

package/src/elements/shipments-grid/shipments-grid.d.ts

@@ -173,19 +173,18 @@ export declare const Element: ({ resources, ...props }: ShipmentsGridProps & {
                 vatNumber: string;
                 vatRegistrationTooltip: string;
                 vatFormText: string;
-                vatFormRegisterLater: string;
                 vatNumberInputHint: string;
                 vatNumberInputPlaceholder: string;
                 verifiedVat: string;
+                vatNumberFieldLabel: string;
+                vatTypePlaceholder: string;
+                issuingAuthorityPlaceholder: string;
+                issuingAuthorityFieldLabel: string;
                 vatFormErrors: {
                     invalidFieldValue: string;
                     verificationFailure: string;
                     forbidden: string;
                     connectionNotSupported: string;
-                    genericTitle: string;
-                    /**
-                     * `onRowClick` callback invoked when a row is clicked.
-                     */
                     genericText: string;
                 };
             };
@@ -937,6 +936,7 @@ export declare const Element: ({ resources, ...props }: ShipmentsGridProps & {
                         taxIssuingAuthority: string;
                         entityType: string;
                     };
+                    hsCode: string;
                     nonDelivery: {
                         returnToSender: string;
                         treatAsAbandoned: string;
@@ -974,6 +974,7 @@ export declare const Element: ({ resources, ...props }: ShipmentsGridProps & {
                         shipments: string;
                         warehouses: string;
                     };
+                    labelHasBeenPurchased: string;
                     emailIsRequired: string;
                     unknown: string;
                     noRatesAvailable: string;

package/src/elements/theme-creator/theme-creator.d.ts

@@ -114,16 +114,18 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                 vatNumber: string;
                 vatRegistrationTooltip: string;
                 vatFormText: string;
-                vatFormRegisterLater: string;
                 vatNumberInputHint: string;
                 vatNumberInputPlaceholder: string;
                 verifiedVat: string;
+                vatNumberFieldLabel: string;
+                vatTypePlaceholder: string;
+                issuingAuthorityPlaceholder: string;
+                issuingAuthorityFieldLabel: string;
                 vatFormErrors: {
                     invalidFieldValue: string;
                     verificationFailure: string;
                     forbidden: string;
                     connectionNotSupported: string;
-                    genericTitle: string;
                     genericText: string;
                 };
             };
@@ -815,6 +817,7 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                         taxIssuingAuthority: string;
                         entityType: string;
                     };
+                    hsCode: string;
                     nonDelivery: {
                         returnToSender: string;
                         treatAsAbandoned: string;
@@ -852,6 +855,7 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                         shipments: string;
                         warehouses: string;
                     };
+                    labelHasBeenPurchased: string;
                     emailIsRequired: string;
                     unknown: string;
                     noRatesAvailable: string;

package/src/elements/transaction-history/transaction-history-element.d.ts

@@ -101,16 +101,18 @@ export declare const Element: ({ resources, ...props }: object & {
                 vatNumber: string;
                 vatRegistrationTooltip: string;
                 vatFormText: string;
-                vatFormRegisterLater: string;
                 vatNumberInputHint: string;
                 vatNumberInputPlaceholder: string;
                 verifiedVat: string;
+                vatNumberFieldLabel: string;
+                vatTypePlaceholder: string;
+                issuingAuthorityPlaceholder: string;
+                issuingAuthorityFieldLabel: string;
                 vatFormErrors: {
                     invalidFieldValue: string;
                     verificationFailure: string;
                     forbidden: string;
                     connectionNotSupported: string;
-                    genericTitle: string;
                     genericText: string;
                 };
             };
@@ -802,6 +804,7 @@ export declare const Element: ({ resources, ...props }: object & {
                         taxIssuingAuthority: string;
                         entityType: string;
                     };
+                    hsCode: string;
                     nonDelivery: {
                         returnToSender: string;
                         treatAsAbandoned: string;
@@ -839,6 +842,7 @@ export declare const Element: ({ resources, ...props }: object & {
                         shipments: string;
                         warehouses: string;
                     };
+                    labelHasBeenPurchased: string;
                     emailIsRequired: string;
                     unknown: string;
                     noRatesAvailable: string;

package/src/elements/unit-settings/unit-settings-element.d.ts

@@ -101,16 +101,18 @@ export declare const Element: ({ resources, ...props }: object & {
                 vatNumber: string;
                 vatRegistrationTooltip: string;
                 vatFormText: string;
-                vatFormRegisterLater: string;
                 vatNumberInputHint: string;
                 vatNumberInputPlaceholder: string;
                 verifiedVat: string;
+                vatNumberFieldLabel: string;
+                vatTypePlaceholder: string;
+                issuingAuthorityPlaceholder: string;
+                issuingAuthorityFieldLabel: string;
                 vatFormErrors: {
                     invalidFieldValue: string;
                     verificationFailure: string;
                     forbidden: string;
                     connectionNotSupported: string;
-                    genericTitle: string;
                     genericText: string;
                 };
             };
@@ -802,6 +804,7 @@ export declare const Element: ({ resources, ...props }: object & {
                         taxIssuingAuthority: string;
                         entityType: string;
                     };
+                    hsCode: string;
                     nonDelivery: {
                         returnToSender: string;
                         treatAsAbandoned: string;
@@ -839,6 +842,7 @@ export declare const Element: ({ resources, ...props }: object & {
                         shipments: string;
                         warehouses: string;
                     };
+                    labelHasBeenPurchased: string;
                     emailIsRequired: string;
                     unknown: string;
                     noRatesAvailable: string;

package/src/elements/vat-settings/vat-settings-element.d.ts

@@ -101,16 +101,18 @@ export declare const Element: ({ resources, ...props }: object & {
                 vatNumber: string;
                 vatRegistrationTooltip: string;
                 vatFormText: string;
-                vatFormRegisterLater: string;
                 vatNumberInputHint: string;
                 vatNumberInputPlaceholder: string;
                 verifiedVat: string;
+                vatNumberFieldLabel: string;
+                vatTypePlaceholder: string;
+                issuingAuthorityPlaceholder: string;
+                issuingAuthorityFieldLabel: string;
                 vatFormErrors: {
                     invalidFieldValue: string;
                     verificationFailure: string;
                     forbidden: string;
                     connectionNotSupported: string;
-                    genericTitle: string;
                     genericText: string;
                 };
             };
@@ -802,6 +804,7 @@ export declare const Element: ({ resources, ...props }: object & {
                         taxIssuingAuthority: string;
                         entityType: string;
                     };
+                    hsCode: string;
                     nonDelivery: {
                         returnToSender: string;
                         treatAsAbandoned: string;
@@ -839,6 +842,7 @@ export declare const Element: ({ resources, ...props }: object & {
                         shipments: string;
                         warehouses: string;
                     };
+                    labelHasBeenPurchased: string;
                     emailIsRequired: string;
                     unknown: string;
                     noRatesAvailable: string;