shipbob-node-sdk 0.0.3 → 0.0.5

package/dist/index.d.ts

@@ -26,7 +26,21 @@ export type DataResponse<T> = ({
      */
     data: object | string;
 }) & {
+    headers: Record<string, string>;
     statusCode: number;
+    rateLimit: {
+        /**
+         * There are 150 calls in a sliding window of 1 minute.
+         *
+         * Retrieved from x-remaining-calls header in response.
+         * null when not found.
+         */
+        remainingCalls: Nullable<number>;
+        /**
+         * Seconds remaining in sliding window once rate limit has been exhausted.
+         */
+        retryAfter: Nullable<number>;
+    };
 };
 export type ChannelsResponse = {
     id: number;
@@ -81,209 +95,222 @@ export type GetProduct1_0Result = {
 };
 export type ActionName = 'Dispose' | 'Restock' | 'Quarantine';
 export type ProductType = 'Regular' | 'Bundle';
-/**
- * This is just some guessing based on a response
- */
-export type GetProduct2_0Result = {
-    /**
-     * Product Id
-     */
-    id: number;
+type GetProduct2_0Variant = {
     /**
-     * Product Name
+     * The expected barcode to be found on the item and checked during the pick process
      */
-    name: string;
-    type: ProductType;
-    category: Nullable<unknown>;
-    sub_category: Nullable<unknown>;
-    user_id: number;
+    barcode: string;
+    barcode_sticker_url: Nullable<string>;
+    channel_metadata: unknown[];
+    reviews_pending: unknown[];
+    associated_bundles: unknown[];
+    bundle_definition: unknown[];
     created_on: string;
-    updated_on: string;
-    /**
-     * null | ?
-     */
-    taxonomy: null;
-    variants: {
+    customs: {
         /**
-         * The expected barcode to be found on the item and checked during the pick process
+         * The customs code (6 digit)
          */
-        barcode: string;
-        barcode_sticker_url: Nullable<string>;
-        channel_metadata: unknown[];
-        reviews_pending: unknown[];
-        associated_bundles: unknown[];
-        bundle_definition: unknown[];
-        created_on: string;
-        customs: {
-            /**
-             * The customs code (6 digit)
-             */
-            hs_tariff_code: string;
-            /**
-             * 2 character country code
-             */
-            country_code_of_origin: string;
-            /**
-             * Value of object for customs (in USD)
-             */
-            value: Nullable<string>;
-            currency: 'USD';
-            /**
-             * Description of product for customs purposes
-             */
-            description: string;
-            is321_eligible: boolean;
-        };
-        dimension: {
-            length: number;
-            width: number;
-            height: number;
-            /**
-             * "inch"
-             */
-            unit: string;
-            is_locked: boolean;
-            /**
-             * ie: "UserEntry"
-             */
-            source: string;
-        };
-        fulfillment_settings: {
-            /**
-             * If the product requires a prop65 label in the box
-             */
-            requires_prop65: false;
-            serial_scan: {
-                /**
-                 * Indicates if a Serial Scan is required during the pack process.
-                 * Note: Serial scan requires either a prefix or a suffix to be defined
-                 */
-                is_enabled: false;
-                /**
-                 * The prefix expected on the serial number
-                 */
-                prefix: string;
-                /**
-                 * The suffix expected on the serial number
-                 */
-                suffix: string;
-                /**
-                 * The exact number of characters expected in the serial number
-                 */
-                exact_character_length: Nullable<number>;
-            };
+        hs_tariff_code: string;
+        /**
+         * 2 character country code
+         */
+        country_code_of_origin: string;
+        /**
+         * Value of object for customs (in USD)
+         */
+        value: Nullable<string>;
+        currency: 'USD';
+        /**
+         * Description of product for customs purposes
+         */
+        description: string;
+        is321_eligible: boolean;
+    };
+    dimension: {
+        length: number;
+        width: number;
+        height: number;
+        /**
+         * "inch"
+         */
+        unit: string;
+        is_locked: boolean;
+        /**
+         * ie: "UserEntry"
+         */
+        source: string;
+    };
+    fulfillment_settings: {
+        /**
+         * If the product requires a prop65 label in the box
+         */
+        requires_prop65: false;
+        serial_scan: {
             /**
-             * If the product needs to classified as a hazmat product with the shipping carrier
+             * Indicates if a Serial Scan is required during the pack process.
+             * Note: Serial scan requires either a prefix or a suffix to be defined
              */
-            dangerous_goods: false;
+            is_enabled: false;
             /**
-             * URL of the Safety Data Sheet for this product.
-             * Note: should be populated by ShipBob system via the UI, should not reference a URL outside of the ShipBob domain
+             * The prefix expected on the serial number
              */
-            msds_url: string;
+            prefix: string;
             /**
-             * If the product should be picked as an entire case
+             * The suffix expected on the serial number
              */
-            is_case_pick: boolean;
+            suffix: string;
             /**
-             * Is Bound Printed Matter, must be set by the ShipBob internal team
+             * The exact number of characters expected in the serial number
              */
-            is_bpm_parcel: boolean;
+            exact_character_length: Nullable<number>;
         };
         /**
-         * Global Trade Item Number
+         * If the product needs to classified as a hazmat product with the shipping carrier
          */
-        gtin: string;
+        dangerous_goods: false;
         /**
-         * Variant Id (used to alter product lot, packaging, etc.)
+         * URL of the Safety Data Sheet for this product.
+         * Note: should be populated by ShipBob system via the UI, should not reference a URL outside of the ShipBob domain
          */
-        id: number;
-        inventory: {
-            inventory_id: number;
-            on_hand_qty: number;
-        };
-        is_digital: boolean;
-        lot_information: {
-            /**
-             * If the product should use lot date based picking
-             */
-            is_lot: boolean;
-            minimum_shelf_life_days: Nullable<number>;
-        };
+        msds_url: string;
         /**
-         * Name of the Variant (should match the Product name if a non-varying product)
+         * If the product should be picked as an entire case
          */
-        name: string;
+        is_case_pick: boolean;
         /**
-         * PDf has wrong field: The specific material to package the product in (box, poly mailer, bubble mailer, etc_
+         * Is Bound Printed Matter, must be set by the ShipBob internal team
          */
-        packaging_material_type: {
-            id: number;
-            /**
-             * Not sure what else can be here
-             */
-            name: 'Box';
-        };
+        is_bpm_parcel: boolean;
+    };
+    /**
+     * Global Trade Item Number
+     */
+    gtin: string;
+    /**
+     * Variant Id (used to alter product lot, packaging, etc.)
+     */
+    id: number;
+    inventory: {
+        inventory_id: number;
+        on_hand_qty: number;
+    };
+    is_digital: boolean;
+    lot_information: {
+        /**
+         * If the product should use lot date based picking
+         */
+        is_lot: boolean;
+        minimum_shelf_life_days: Nullable<number>;
+    };
+    /**
+     * Name of the Variant (should match the Product name if a non-varying product)
+     */
+    name: string;
+    /**
+     * PDf has wrong field: The specific material to package the product in (box, poly mailer, bubble mailer, etc_
+     */
+    packaging_material_type: {
+        id: number;
         /**
-         * PDF has wrong field. int The id of the packaging_requirement (No requirement, fragile, ship in own container, etc)
+         * Not sure what else can be here
          */
-        packaging_requirement: {
+        name: 'Box';
+    };
+    /**
+     * PDF has wrong field. int The id of the packaging_requirement (No requirement, fragile, ship in own container, etc)
+     */
+    packaging_requirement: {
+        id: number;
+        name: 'NoRequirements' | 'Fragile';
+    };
+    return_preferences: {
+        /**
+         * Restock (1) Quarantine (2) Dispose (3)
+         */
+        primary_action: Nullable<{
             id: number;
-            name: 'NoRequirements' | 'Fragile';
-        };
-        return_preferences: {
-            /**
-             * Restock (1) Quarantine (2) Dispose (3)
-             */
-            primary_action: Nullable<{
-                id: number;
-                name: ActionName;
-            }>;
-            /**
-             * Restock (1) Quarantine (2) Dispose (3)
-             */
-            backup_action: Nullable<{
-                id: number;
-                name: ActionName;
-            }>;
-            /**
-             * Instructions for inspecting returns
-             */
-            instructions: Nullable<string>;
-            return_to_sender_primary_action: Nullable<{
-                id: number;
-                name: ActionName;
-            }>;
-            return_to_sender_backup_action: Nullable<{
-                id: number;
-                name: ActionName;
-            }>;
-        };
+            name: ActionName;
+        }>;
         /**
-         * The SKU of the product. This is a required field and must be unique.
+         * Restock (1) Quarantine (2) Dispose (3)
          */
-        sku: string;
+        backup_action: Nullable<{
+            id: number;
+            name: ActionName;
+        }>;
         /**
-         * PDF is incorrect - it describes in int.  Active (1) or Inactive (2)
+         * Instructions for inspecting returns
          */
-        status: 'Active' | 'Inactive';
+        instructions: Nullable<string>;
+        return_to_sender_primary_action: Nullable<{
+            id: number;
+            name: ActionName;
+        }>;
+        return_to_sender_backup_action: Nullable<{
+            id: number;
+            name: ActionName;
+        }>;
+    };
+    /**
+     * The SKU of the product. This is a required field and must be unique.
+     */
+    sku: string;
+    /**
+     * PDF is incorrect - it describes in int.  Active (1) or Inactive (2)
+     */
+    status: 'Active' | 'Inactive';
+    /**
+     * Universal Product Code
+     */
+    upc: string;
+    is_image_uploaded: false;
+    updated_on: string;
+    weight: {
+        weight: number;
         /**
-         * Universal Product Code
+         * ie: "oz"
          */
-        upc: string;
-        is_image_uploaded: false;
-        updated_on: string;
-        weight: {
-            weight: number;
-            /**
-             * ie: "oz"
-             */
-            unit: string;
-        };
-        additional_hazmat_attributes: Nullable<unknown>;
-        merge_children: [];
+        unit: string;
+    };
+    additional_hazmat_attributes: Nullable<unknown>;
+    merge_children: [];
+};
+/**
+ * This is just some guessing based on found responses
+ */
+export type GetProduct2_0Response = {
+    /**
+     * Product Id
+     */
+    id: number;
+    /**
+     * Product Name
+     */
+    name: string;
+    type: ProductType;
+    category: Nullable<unknown>;
+    sub_category: Nullable<unknown>;
+    user_id: number;
+    created_on: string;
+    updated_on: string;
+    /**
+     * null | ?
+     */
+    taxonomy: null;
+    variants: GetProduct2_0Variant[];
+};
+export type GetProductExperimentalVariant = Omit<GetProduct2_0Variant, 'barcode'> & {
+    barcodes: {
+        value: string;
+        sticker_url: Nullable<string>;
     }[];
 };
+/**
+ * Just the barcode -> barcodes on the variant seems like the only difference so far.
+ */
+export type GetProductExperimentalResponse = Omit<GetProduct2_0Response, 'variants'> & {
+    variants: GetProductExperimentalVariant[];
+};
 export type OrderType = 'DTC' | 'DropShip' | 'B2B' | 'Transportation';
 export type AnyProduct = ({
     /**
@@ -363,23 +390,53 @@ export type CancelOrderResponse = {
         reason: string;
     }[];
 };
-export type PlaceOrderResponse = {
+/**
+ * ShipBob.Orders.StatusResolver.OrderStatus
+ */
+export type OrderStatusType = 'Processing' | 'Exception' | 'PartiallyFulfilled' | 'Fulfilled' | 'Cancelled' | 'ImportReview';
+/**
+ * Shipbob.CoreModels.OrderStateResolver.OrderStatusEnum
+ */
+export type ShipmentStatusType = 'None' | 'Processing' | 'Completed' | 'Exception' | 'OnHold' | 'Cancelled' | 'CleanSweeped' | 'LabeledCreated' | 'ImportReview';
+export type Order = {
+    /**
+     * Unique id of the order
+     */
     id: number;
     /**
+     * Date this order was created
+     *
      * ISO date.  ie: "2019-08-24T14:15:22Z"
      */
     created_date: string;
     /**
+     * Date this order was purchase by the end user
+     *
      * ISO date.  ie: "2019-08-24T14:15:22Z"
      */
-    purchase_date: string;
+    purchase_date: Nullable<string>;
+    /**
+     * Client-defined external unique id of the order
+     */
     reference_id: string;
+    /**
+     * User friendly orderId or store order number that will be shown on the Orders Page. If not provided, referenceId will be used
+     */
     order_number: string;
     /**
-     * probably always "Processing" - we should be able to get order status updates via webhook
+     * ie "Processing" when created. We should be able to get order status updates via webhook
+     *
+     * ShipBob.Orders.StatusResolver.OrderStatus
+     * "Processing" "Exception" "PartiallyFulfilled" "Fulfilled" "Cancelled" "ImportReview"
+     */
+    status: OrderStatusType;
+    /**
+     * Shipbob.Orders.Common.OrderType
      */
-    status: 'Processing';
     type: OrderType;
+    /**
+     * Created by channel metadata
+     */
     channel: {
         id: number;
         /**
@@ -388,37 +445,125 @@ export type PlaceOrderResponse = {
         name: string;
     };
     /**
+     * Client-defined shipping method
+     *
      * ie: "Free 2-day Shipping"
      */
     shipping_method: string;
+    /**
+     * Information about the recipient of an order
+     */
     recipient: {
         name: string;
         address: Address;
         email: string;
         phone_number: string;
     };
+    /**
+     * List of products included in the order
+     *
+     * ShipBob.Orders.Presentation.ViewModels.ProductInfoViewModel
+     */
     products: {
+        /**
+         * Unique id of the product
+         */
         id: number;
+        /**
+         * Unique reference id of the product
+         */
         reference_id: string;
+        /**
+         * The quantity of this product ordered
+         */
         quantity: number;
-        quantity_unit_of_measure_code: string;
+        /**
+         * Defined standard for measure for an item (each, inner pack, case, pallet). Values: EA, INP, CS and PL
+         */
+        quantity_unit_of_measure_code: Nullable<string>;
+        /**
+         * Stock keeping unit for the product
+         */
         sku: string;
+        /**
+         * Global Trade Item Number - unique and internationally recognized identifier assigned to item by company GS1
+         */
         gtin: string;
+        /**
+         * Universal Product Code - Unique external identifier
+         */
         upc: string;
+        /**
+         * Price for one item
+         */
         unit_price: number;
+        /**
+         * Numeric assignment per item. Used as a reference number for multiple purposes such as split orders, split containers, etc.
+         */
         external_line_id: number;
     }[];
+    /**
+     * Client-defined order tags
+     */
     tags: string[];
+    /**
+     * Shipments affiliated with the order
+     * TODO: redo this as it's a union of 2 types.
+     * - ShipBob.Orders.Presentation.ViewModels.ShipmentViewModel
+     * - ShipBob.Orders.Presentation.ViewModels.InternalShipmentViewModel
+     * probably good idea to use what is generated from the OpenAPI and reference here - the generated has lots of TS errors.
+     */
     shipments: {
+        /**
+         * The datetime of Shipment delivered to customer.
+         */
+        delivery_date: Nullable<string>;
+        /**
+         * Unique id of the shipment
+         */
         id: number;
+        /**
+         * Id of the order this shipment belongs to
+         */
         order_id: number;
+        /**
+         * Client-defined external unique id of the order this shipment belongs to
+         */
         reference_id: string;
+        /**
+         * Information about the recipient of a shipment
+         */
         recipient: {
             name: string;
             address: Address;
             email: string;
             phone_number: string;
         };
+        /**
+         * OrderStateResolver.OrderStatusEnum
+         */
+        status: ShipmentStatusType;
+        /**
+         * Tracking information for a shipment (null on creation)
+         */
+        tracking: Nullable<{
+            /**
+             * Carrier of the shipment
+             */
+            carrier: Nullable<string>;
+            /**
+             * Tracking number of the shipment
+             */
+            tracking_number: Nullable<string>;
+            /**
+             * The carrier's service which was used for this shipment
+             */
+            carrier_service: Nullable<string>;
+            /**
+             * URL to the website where a shipment can be tracked
+             */
+            tracking_url: Nullable<string>;
+        }[]>;
     }[];
     gift_message: string;
     shipping_terms: {
@@ -522,6 +667,39 @@ export type PlaceOrderRequest = {
      */
     type: OrderType;
 };
+export type ShippingMethod = {
+    /**
+     * Unique id for shipping method
+     */
+    id: number;
+    /**
+     * Indicates if the shipping method is active
+     */
+    active: boolean;
+    /**
+     * Indicates the shipping method is a ShipBob default shipping method.
+     */
+    default: boolean;
+    /**
+     * Name of the ship method as selected by the merchant and saved in ShipBob’s database (i.e. “ground”).
+     *
+     * Corresponds to the shipping_method field in the Orders API.
+     */
+    name: string;
+    /**
+     * ShipBob.Orders.Presentation.ViewModels.ServiceLevelDetailViewModel)
+     */
+    service_level: {
+        /**
+         * Unique id for the service level
+         */
+        id: number;
+        /**
+         * The name or title of the service level
+         */
+        name: string;
+    };
+};
 export type Webhook = {
     id: number;
     /**
@@ -605,7 +783,8 @@ export type WarehouseReceivingOrderRequest = {
              */
             inventory_id: number;
             /**
-             * Lot number of the items in the box
+             * Lot number of the items in the box.  Must be supplied for products that have lot set, otherwise will be:
+             * 422 status code "Wrong Lot Information Provided For Inventory IDs: 8619859,8619860, etc."
              */
             lot_number?: Nullable<string>;
             /**
@@ -617,6 +796,8 @@ export type WarehouseReceivingOrderRequest = {
     /**
      * Expected arrival date of all the box shipments in this receiving order
      * ie: ISO date "2019-08-24T14:15:22Z"
+     *
+     * NOTE: Must be in the future or it will generate a 422 error.
      */
     expected_arrival_date: string;
     /**
@@ -876,7 +1057,13 @@ export declare enum ReturnAction {
      */
     Dispose = 3
 }
-export type ProductVariantRequest = {
+export type VariantRequestProductExperimental = Omit<VariantRequestProduct2_0, 'barcode'> & {
+    barcodes: {
+        value: string;
+        sticker_url: Nullable<string>;
+    }[];
+};
+export type VariantRequestProduct2_0 = {
     /**
      * Required for updates
      */
@@ -920,6 +1107,10 @@ export type ProductVariantRequest = {
     return_preferences?: {
         primary_action_id: Nullable<ReturnAction>;
         backup_action_id: null;
+        /**
+         * Cannot be set when "primary_action_id" has certain values (ie: Quarantine)
+         * error: variants.return_preferences.instructions cannot be set for the selected primary action
+         */
         instructions: Nullable<string>;
         return_to_sender_primary_action_id: Nullable<ReturnAction>;
         return_to_sender_backup_action_id: Nullable<ReturnAction>;
@@ -932,6 +1123,212 @@ export type ProductVariantRequest = {
         minimum_shelf_life_days: Nullable<number>;
     };
 };
+export type GetProductQueryStrings = {
+    Page: number;
+    Limit: number;
+    /**
+     * Regular product (1) or Bundle (2)
+     */
+    productTypeId: 1 | 2;
+    /**
+     * Active (1) or Inactive (2)
+     */
+    variantStatus: 1 | 2;
+    /**
+     * True -> at least one variant is digital
+     * False -> at least one variant is not-digital
+     */
+    hasDigitalVariants: boolean;
+    /**
+     * Search by one or more Product Ids (comma separated) to return multiple products
+     */
+    Ids: string;
+    /**
+     * Search by one or more Variant Ids (comma separated) to return multiple products
+     */
+    VariantIds: string;
+    /**
+     * Search by product barcode
+     */
+    barcode: string;
+    /**
+     * Search by an exact sku
+     */
+    sku: string;
+    /**
+     * Search for products that vary or non-varying products
+     */
+    hasVariants: boolean;
+    /**
+     * Search by one or more InventoryIds (comma separated) to return multiple barcodes
+     */
+    InventoryId: string;
+    /**
+     * Search by Variant Name.
+     * NOTE: Query parameters should be URL encoded such as "Green%20Shirt"
+     */
+    Name: string;
+    /**
+     * Search by matching Taxonomy (category) of the product (comma separated)
+     */
+    TaxonomyIds: string;
+};
+export type GetOrdersQueryStrings = {
+    Page: number;
+    Limit: number;
+    /**
+     * order ids to filter by, comma separated
+     */
+    Ids: string;
+    /**
+     * Reference ids to filter by, comma separated
+     */
+    ReferenceIds: string;
+    /**
+     * Start date to filter orders inserted later than
+     */
+    StartDate: string;
+    /**
+     * End date to filter orders inserted earlier than
+     */
+    EndDate: string;
+    /**
+     * Order to sort results in
+     */
+    SortOrder: 'Newest' | 'Oldest';
+    /**
+     * Has any portion of this order been assigned a tracking number
+     */
+    HasTracking: boolean;
+    /**
+     * Start date to filter orders updated later than
+     */
+    LastUpdateStartDate: string;
+    /**
+     * End date to filter orders updated later than
+     */
+    LastUpdateEndDate: string;
+    /**
+     * Filter orders that their tracking information was fully uploaded
+     */
+    IsTrackingUploaded: boolean;
+    /**
+     * Start date to filter orders with tracking updates later than the supplied date. Will only return orders that have tracking information
+     */
+    LastTrackingUpdateStartDate: string;
+    /**
+     * End date to filter orders updated later than the supplied date. Will only return orders that have tracking information
+     */
+    LastTrackingUpdateEndDate: string;
+};
+export type ExperimentalPagedResult<T> = {
+    /**
+     * Will be null when there are no items
+     */
+    first: Nullable<string>;
+    next: Nullable<string>;
+    items: T[];
+    prev: Nullable<string>;
+    /**
+     * Will be null when there are no items.
+     */
+    last: Nullable<string>;
+};
+export type GetInventory1_0Result = {
+    id: number;
+    name: string;
+    is_digital: boolean;
+    is_case_pick: boolean;
+    is_lot: boolean;
+    dimensions: {
+        weight: number;
+        length: number;
+        width: number;
+        depth: number;
+    };
+    /**
+     * Total fulfillable quantity of this inventory item
+     */
+    total_fulfillable_quantity: number;
+    /**
+     * Total onhand quantity of this inventory item
+     */
+    total_onhand_quantity: number;
+    /**
+     * Total committed quantity of this inventory item
+     */
+    total_committed_quantity: number;
+    /**
+     * Total quantity that can be sold without overselling the inventory item. This is calculated by subtracting the total exception quantity from the fulfillable quantity.
+     */
+    total_sellable_quantity: number;
+    /**
+     * Total quantity in unreceived receiving orders for this inventory item
+     */
+    total_awaiting_quantity: number;
+    /**
+     * The total quantity of all items that are contained within orders that are in exception/out of stock status. Out of stock orders have not been processed and therefore do not have lot or fulfillment centers assigned.
+     */
+    total_exception_quantity: number;
+    /**
+     * The total quantity of all items that are in the process of internal transit between ShipBob fulfillment centers. These items are not pickable or fulfillable until they have been received and moved to the "On Hand" quantity of the destination FC. Internal transit quantities for each FC represent the incoming transfer stock for that specific location.
+     */
+    total_internal_transfer_quantity: number;
+    /**
+     * The amount of the item you need to send to ShipBob to fulfill all exception orders containing the item. This is the exception_quantity less the fulfillable_quantity of the item.
+     */
+    total_backordered_quantity: number;
+    /**
+     * Whether the inventory is active or not
+     */
+    is_active: boolean;
+    /**
+     * Fulfillable quantity of this inventory item broken down by fulfillment center location
+     */
+    fulfillable_quantity_by_fulfillment_center: {
+        id: number;
+        name: string;
+        fulfillable_quantity: number;
+        onhand_quantity: number;
+        committed_quantity: number;
+        awaiting_quantity: number;
+        internal_transfer_quantity: number;
+    }[];
+    /**
+     * Fulfillable quantity of this inventory item broken down by lot
+     */
+    fulfillable_quantity_by_lot: {
+        lot_number: string;
+        /**
+         * ie: "2019-08-24T14:15:22Z"
+         */
+        expiration_date: string;
+        fulfillable_quantity: number;
+        onhand_quantity: number;
+        committed_quantity: number;
+        awaiting_quantity: number;
+        internal_transfer_quantity: number;
+        fulfillable_quantity_by_fulfillment_center: {
+            id: number;
+            name: string;
+            fulfillable_quantity: number;
+            onhand_quantity: number;
+            committed_quantity: number;
+            awaiting_quantity: number;
+            internal_transfer_quantity: number;
+        }[];
+    }[];
+    /**
+     * ie: "None" "Fragile" "Foldable" "Stackable" "Book" "CustomPackaging" "CustomDunnage" "MarketingInsert" or "Poster"
+     */
+    packaging_attribute: 'None' | 'Fragile' | 'Foldable' | 'Stackable' | 'Book' | 'CustomPackaging' | 'CustomDunnage' | 'MarketingInsert' | 'Poster';
+};
+export type CreateOptions = {
+    /**
+     * console.log HTTP traffic (http verb + endpoint)
+     */
+    logTraffic: boolean;
+};
 /**
  * Create API with PAT (personal access token) - defaults to sandbox endpoints and "SMA" channel.
  *
@@ -942,9 +1339,14 @@ export type ProductVariantRequest = {
  * @param personalAccessToken passing *undefined* or empty string has a guar clause that will throw
  * @param apiBaseUrl
  * @param channelApplicationName
+ * @param options
  * @returns
  */
-export declare const createShipBobApi: (personalAccessToken: string | undefined, apiBaseUrl?: string, channelApplicationName?: string) => Promise<{
+export declare const createShipBobApi: (personalAccessToken: string | undefined, apiBaseUrl?: string, channelApplicationName?: string, options?: CreateOptions) => Promise<{
+    /**
+     * You would need a product id on your side.  Not sure how useful this is in all practicality unless
+     * you maintain the association on your side.
+     */
     getProductById: (productId: number) => Promise<DataResponse<GetProduct1_0Result>>;
     getProducts1_0: (query: Partial<{
         ReferenceIds: string;
@@ -956,10 +1358,20 @@ export declare const createShipBobApi: (personalAccessToken: string | undefined,
         BundleStatus: "Any" | "Bundle" | "NotBundle";
     }>) => Promise<DataResponse<GetProduct1_0Result[]>>;
     /**
+     * NOTE: you need to use the headers (part of this client response) to page the results.
+     * page-number='1'
+     * page-size='50'
+     * total-count='1'
+     * total-pages='1'
+     *
      * NOTE: we can probably pass more than "variants" prop.  We could on the /1.0/product endpoint
      * NOTE: This PATCH functionality will be available in the next version available in ShipBob next large release January 2025, it may require extra scope.
      */
-    updateProducts2_0: (productId: number, variants: ProductVariantRequest[]) => Promise<DataResponse<AddProductResponse>>;
+    updateProduct2_0: (productId: number, variants: VariantRequestProduct2_0[]) => Promise<DataResponse<AddProductResponse>>;
+    /**
+     * Unsure how this is different from /2.0/product except for "barcode" -> "barcodes"
+     */
+    updateProductExperimental: (productId: number, variants: VariantRequestProductExperimental[]) => Promise<DataResponse<AddProductResponse>>;
     /**
      * Not supported here, but:
      * Some search filters allow for operators (equals, not equals, starts with, ends with, contains, etc) to get more exact values. When filtering with an operator, the query string will look like the below:
@@ -967,56 +1379,11 @@ export declare const createShipBobApi: (personalAccessToken: string | undefined,
      * Example: /product?sku=any:shirt-a,shirt-b,shirt-c Find products that match any of these SKUs
      * Example: /product?onHandQuantity=gt:0 Find products where OnHandQty greater than 0
      */
-    getProducts2_0: (query: Partial<{
-        Page: number;
-        Limit: number;
-        /**
-         * Regular product (1) or Bundle (2)
-         */
-        productTypeId: 1 | 2;
-        /**
-         * Active (1) or Inactive (2)
-         */
-        variantStatus: 1 | 2;
-        /**
-         * True -> at least one variant is digital
-         * False -> at least one variant is not-digital
-         */
-        hasDigitalVariants: boolean;
-        /**
-         * Search by one or more Product Ids (comma separated) to return multiple products
-         */
-        Ids: string;
-        /**
-         * Search by one or more Variant Ids (comma separated) to return multiple products
-         */
-        VariantIds: string;
-        /**
-         * Search by product barcode
-         */
-        barcode: string;
-        /**
-         * Search by an exact sku
-         */
-        sku: string;
-        /**
-         * Search for products that vary or non-varying products
-         */
-        hasVariants: boolean;
-        /**
-         * Search by one or more InventoryIds (comma separated) to return multiple barcodes
-         */
-        InventoryId: string;
-        /**
-         * Search by Variant Name.
-         * NOTE: Query parameters should be URL encoded such as "Green%20Shirt"
-         */
-        Name: string;
-        /**
-         * Search by matching Taxonomy (category) of the product (comma separated)
-         */
-        TaxonomyIds: string;
-    }>) => Promise<DataResponse<GetProduct2_0Result[]>>;
+    getProducts2_0: (query: Partial<GetProductQueryStrings>) => Promise<DataResponse<GetProduct2_0Response[]>>;
+    /**
+     * Note sure how this is different from /2.0/product.  Only notable difference is "barcodes" type from string to object.
+     */
+    getProductsExperimental: (query: Partial<GetProductQueryStrings>) => Promise<DataResponse<ExperimentalPagedResult<GetProductExperimentalResponse>>>;
     createProduct1_0: (product: {
         reference_id: string;
         sku: string;
@@ -1027,21 +1394,46 @@ export declare const createShipBobApi: (personalAccessToken: string | undefined,
      * The request part for variant is not accurate.  This is just for testing - there are no official docs.
      */
     createProduct2_0: (product: {
-        reference_id: string;
-        sku: string;
         type_id: number;
         name: string;
-        variants: ProductVariantRequest[];
+        variants: VariantRequestProduct2_0[];
+    }) => Promise<DataResponse<AddProductResponse>>;
+    /**
+     * Unsure how this is different from '2.0/product' except for "barcode" -> "barcodes"
+     */
+    createProductExperimental: (product: {
+        type_id: number;
+        name: string;
+        variants: VariantRequestProductExperimental[];
     }) => Promise<DataResponse<AddProductResponse>>;
-    placeOrder: (order: PlaceOrderRequest) => Promise<DataResponse<PlaceOrderResponse>>;
+    /**
+     * Look in the returned headers to get paging information.
+     */
+    getOrders: (query: Partial<GetOrdersQueryStrings>) => Promise<DataResponse<Order[]>>;
+    placeOrder: (order: PlaceOrderRequest) => Promise<DataResponse<Order>>;
     /**
      * Cancel single Order by Order Id
      *
      * @param orderId The order Id to cancel
      */
     cancelSingleOrderByOrderId: (orderId: number) => Promise<DataResponse<CancelOrderResponse>>;
-    getWebhooks: () => Promise<DataResponse<Webhook[][]>>;
-    createWebhookSubscription: (webhook: Omit<Webhook, "id" | "created_at">) => Promise<DataResponse<Webhook>>;
+    getShippingMethods: () => Promise<DataResponse<ShippingMethod[]>>;
+    getWebhooks: () => Promise<DataResponse<Webhook[]>>;
+    /**
+     *
+     * @param webhook
+     * @param sendChannelId defaults `true`.  Not providing channel id will (I think) subscribe to all channels.  You need to match when unsubscribing.
+     * @returns
+     */
+    registerWebhookSubscription: (webhook: Omit<Webhook, "id" | "created_at">, sendChannelId?: boolean) => Promise<DataResponse<Webhook>>;
+    /**
+     * Can generate 500 response with data: "The wait operation timed out."  If so, check your channel id (or lack thereof) matches the subscription registration.
+     *
+     * @param id channelId from getWebhooks()
+     * @param sendChannelId defaults `true`.  You need to match this with when you subscribed.  There's no way to see this anywhere.
+     * @returns
+     */
+    unregisterWebhookSubscription: (id: number, sendChannelId?: boolean) => Promise<DataResponse<Webhook>>;
     getFulfillmentCenters: () => Promise<DataResponse<FulfillmentCenter[]>>;
     createWarehouseReceivingOrder: (request: WarehouseReceivingOrderRequest) => Promise<DataResponse<WarehouseReceivingOrderResponse>>;
     getWarehouseReceivingOrder: (orderId: number) => Promise<DataResponse<WarehouseReceivingOrderResponse>>;
@@ -1095,7 +1487,7 @@ export declare const createShipBobApi: (personalAccessToken: string | undefined,
          * LocationType is valid for hub, spoke, or lts. LocationType will default to all locations.
          */
         LocationType: string;
-    }>) => Promise<DataResponse<GetProduct1_0Result[]>>;
+    }>) => Promise<DataResponse<GetInventory1_0Result[]>>;
     /**
      * Only for sandbox: https://developer.shipbob.com/sandbox-simulations/
      *
@@ -1110,3 +1502,4 @@ export declare const createShipBobApi: (personalAccessToken: string | undefined,
      */
     getSimulationStatus: (simulationId: string) => Promise<DataResponse<SimulationResponse>>;
 }>;
+export {};