shipbob-node-sdk 0.0.4 → 0.0.6

package/dist/index.d.ts

@@ -1,11 +1,6 @@
+import { AddProductResponse, CancelOrderResponse, ExperimentalPagedResult, FulfillmentCenter, GetInventory1_0Result, GetOrdersQueryStrings, GetProduct1_0Result, GetProduct2_0Response, GetProductExperimentalResponse, GetProductQueryStrings, GetProducts1_0QueryString, ListInventoryQueryStrings, Order, PlaceOrderRequest, SetExternalSyncResponse, ShippingMethod, SimulateShipmentRequest, SimulateShipmentResponse, SimulationResponse, VariantRequestProduct2_0, VariantRequestProductExperimental, WarehouseReceivingOrderBoxesResponse, WarehouseReceivingOrderRequest, WarehouseReceivingOrderResponse, Webhook } from './types';
+export * from './types';
 export type Nullable<T> = T | null;
-export declare enum WebhookTopic {
-    OrderShipped = "order_shipped",
-    ShipmentDelivered = "shipment_delivered",
-    ShipmentException = "shipment_exception",
-    ShipmentOnHold = "shipment_onhold",
-    ShipmentCancelled = "shipment_cancelled"
-}
 export type Credentials = {
     token: string;
     channelId?: number;
@@ -42,1120 +37,11 @@ export type DataResponse<T> = ({
         retryAfter: Nullable<number>;
     };
 };
-export type ChannelsResponse = {
-    id: number;
-    name: string;
-    application_name: string;
-    scopes: string[];
-}[];
-export type Address = {
+export type CreateOptions = {
     /**
-     * First line of the address
+     * console.log HTTP traffic (http verb + endpoint)
      */
-    address1: string;
-    /**
-     * Second line of the address
-     */
-    address2?: Nullable<string>;
-    /**
-     * Name of the company receiving the shipment
-     */
-    company_name?: Nullable<string>;
-    /**
-     * The city
-     */
-    city: Required<string>;
-    /**
-     * The state or province
-     * Not required, but not all countries have state/province
-     */
-    state: Nullable<string>;
-    /**
-     * The country (Must be ISO Alpha-2 for estimates)
-     */
-    country: string;
-    /**
-     * The zip code or postal code
-     */
-    zip_code: string;
-};
-/**
- * Returns also everything else including onhand, etc.  Stuff that makes no sense at this point.
- */
-export type AddProductResponse = {
-    id: number;
-    reference_id: string;
-};
-/**
- * This is missing practically all fields of actual result.
- */
-export type GetProduct1_0Result = {
-    id: number;
-    reference_id: string;
-};
-export type ActionName = 'Dispose' | 'Restock' | 'Quarantine';
-export type ProductType = 'Regular' | 'Bundle';
-type GetProduct2_0Variant = {
-    /**
-     * The expected barcode to be found on the item and checked during the pick process
-     */
-    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>;
-        };
-        /**
-         * If the product needs to classified as a hazmat product with the shipping carrier
-         */
-        dangerous_goods: 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
-         */
-        msds_url: string;
-        /**
-         * If the product should be picked as an entire case
-         */
-        is_case_pick: boolean;
-        /**
-         * Is Bound Printed Matter, must be set by the ShipBob internal team
-         */
-        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;
-        /**
-         * Not sure what else can be here
-         */
-        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: 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;
-        }>;
-    };
-    /**
-     * 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;
-        /**
-         * ie: "oz"
-         */
-        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 = ({
-    /**
-     * Unique reference id of the product
-     */
-    reference_id: string;
-    /**
-     * Name of the product. Required if there is not an existing ShipBob product with a matching reference_id value.
-     */
-    name?: Nullable<string>;
-    /**
-     * Global Trade Item Number - unique and internationally recognized identifier assigned to item by company GS1 (0-50 chars)
-     */
-    gtin?: Nullable<string>;
-    /**
-     * Universal Product Code - Unique external identifier
-     */
-    upc?: Nullable<string>;
-    /**
-     * Price for one item
-     */
-    unit_price?: Nullable<number>;
-    /**
-     * Product SKU
-     */
-    sku?: Nullable<string>;
-} & {
-    /**
-     * Unique Id of the product.  Not sure who would track **their** product ids..
-     */
-    id: number;
-}) | {
-    /**
-     * Numeric assignment per item. Used as a reference number for multiple purposes such as split orders, split containers, etc.
-     */
-    external_line_id?: number;
-    /**
-     * The quantity of this product ordered
-     * (< 2147483647 LOL)
-     */
-    quantity: number;
-    /**
-     * 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>;
-    required_lot?: {
-        lot_number: Nullable<string>;
-        /**
-         * string or null <date-time>
-         * Manually specified lot date
-         */
-        lot_date: Nullable<string>;
-    };
-};
-export type CancelOrderResponse = {
-    order_id: number;
-    order: {
-        id: number;
-        reference_id: string;
-        order_number: string;
-        status: string;
-    };
-    /**
-     * ie: "Success"
-     */
-    status: string;
-    canceled_shipment_results: {
-        /**
-         * ie: "Cancel".  The docs are wrong.  This is actually a number like 6.
-         */
-        action: number;
-        shipment_id: number;
-        is_success: boolean;
-        /**
-         * ie: "Order cancelled"
-         */
-        reason: string;
-    }[];
-};
-export type PlaceOrderResponse = {
-    id: number;
-    /**
-     * ISO date.  ie: "2019-08-24T14:15:22Z"
-     */
-    created_date: string;
-    /**
-     * ISO date.  ie: "2019-08-24T14:15:22Z"
-     */
-    purchase_date: string;
-    reference_id: string;
-    order_number: string;
-    /**
-     * probably always "Processing" - we should be able to get order status updates via webhook
-     */
-    status: 'Processing';
-    type: OrderType;
-    channel: {
-        id: number;
-        /**
-         * ie: "ShipBobs-Shopify-Store"
-         */
-        name: string;
-    };
-    /**
-     * ie: "Free 2-day Shipping"
-     */
-    shipping_method: string;
-    recipient: {
-        name: string;
-        address: Address;
-        email: string;
-        phone_number: string;
-    };
-    products: {
-        id: number;
-        reference_id: string;
-        quantity: number;
-        quantity_unit_of_measure_code: string;
-        sku: string;
-        gtin: string;
-        upc: string;
-        unit_price: number;
-        external_line_id: number;
-    }[];
-    tags: string[];
-    shipments: {
-        id: number;
-        order_id: number;
-        reference_id: string;
-        recipient: {
-            name: string;
-            address: Address;
-            email: string;
-            phone_number: string;
-        };
-    }[];
-    gift_message: string;
-    shipping_terms: {
-        /**
-         * ie: "Parcel"
-         */
-        carrier_type: CarrierShipType;
-        payment_term: PaymentShipTerm;
-    };
-};
-export type PaymentShipTerm = 'Collect' | 'ThirdParty' | 'Prepaid' | 'MerchantResponsible';
-export type CarrierShipType = 'Parcel' | 'Freight';
-export type PlaceOrderRequest = {
-    /**
-     * User friendly orderId or store order number that will be shown on the Orders Page. If not provided, referenceId will be used (<= 400 characters)
-     */
-    order_number: Nullable<string>;
-    recipient: {
-        name: string;
-        address: Address;
-        /**
-         * Email address of the recipient
-         */
-        email?: Nullable<string>;
-        /**
-         * Phone number of the recipient (<= 50 characters)
-         */
-        phone_number?: Nullable<string>;
-    };
-    /**
-     * Products included in the order. Products identified by reference_id must also include the product name if there is no matching ShipBob product.
-     */
-    products: AnyProduct[];
-    /**
-     * Unique and immutable order identifier from your upstream system.
-     *
-     * Discussions with Simon. This is a forever unique identifier. ie: cannot be an IC order number like 18888888 - we could not reship.
-     *
-     * NOTE: reusing generates 422 error: "Cannot insert order with existing ReferenceId"
-     */
-    reference_id: string;
-    /**
-     * Contains properties that needs to be used for fulfilling B2B/Dropship orders.
-     */
-    retailer_program_data?: {
-        /**
-         * First initial documentation sent from buyer to seller with item(s) and quantities.
-         */
-        purchase_order_number: string;
-        /**
-         * Identifies retailer-merchant combination
-         */
-        retailer_program_type: string;
-        /**
-         * Store Number
-         */
-        mark_for_store?: Nullable<string>;
-        /**
-         * Identifies a merchant's store department
-         */
-        department?: Nullable<string>;
-        /**
-         * Expected delivery date
-         */
-        delivery_date?: Nullable<string>;
-        /**
-         * Customer Ticket Number
-         */
-        customer_ticket_number?: Nullable<string>;
-        /**
-         * The date the retailer has requested the order to ship by.
-         */
-        shipByDate?: Nullable<string>;
-        /**
-         * The date the retailer does not want the order shipped by.
-         */
-        doNotShipBeforeDate?: Nullable<string>;
-    };
-    /**
-     * Client-defined shipping method matching what the user has listed as the shipping method on the Ship Option Mapping setup page in the ShipBob Merchant Portal.
-     * If they don’t match, we will create a new one and default it to Standard
-     * (non-empty)
-     * ie: "Standard"
-     */
-    shipping_method: string;
-    /**
-     * Contains shipping properties that need to be used for fulfilling an order.
-     */
-    shipping_terms?: {
-        /**
-         * CarrierShipType:  Enum: "Parcel" "Freight"
-         */
-        carrier_type: CarrierShipType;
-        /**
-         * PaymentShipTerm
-         */
-        payment_term: PaymentShipTerm;
-    };
-    /**
-     * Enum: "DTC" "DropShip" "B2B" "Transportation"
-     */
-    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;
-    /**
-     * ISO date format: "2025-02-14T22:21:33.4911731"
-     */
-    created_at: string;
-    /**
-     * The subscription topic for the webhook
-     */
-    topic: WebhookTopic;
-    /**
-     * This is what we provided to them.
-     */
-    subscription_url: string;
-};
-export type FulfillmentCenter = {
-    id: number;
-    /**
-     * ie: "Cicero (IL)"
-     */
-    name: string;
-    /**
-     * ie: "Central Standard Time"
-     */
-    timezone: string;
-    address1: string;
-    address2: string;
-    city: string;
-    /**
-     * ie: "IL"
-     */
-    state: string;
-    /**
-     * ie: "USA"
-     */
-    country: string;
-    zip_code: string;
-    phone_number: string;
-    email: string;
-};
-export type PackageType = 'Package' | 'Pallet' | 'FloorLoadedContainer';
-export type BoxPackagingType = 'EverythingInOneBox' | 'OneSkuPerBox' | 'MultipleSkuPerBox';
-/**
- * The receiving order to create
- */
-export type WarehouseReceivingOrderRequest = {
-    /**
-     * Model containing information that assigns a receiving order to a fulfillment center.
-     * If the fulfillment center provided is in a receiving hub region, then the response will be the receiving hub location.
-     */
-    fulfillment_center: {
-        /**
-         * ID of the fulfillment center to assign this receiving order to
-         */
-        id: number;
-    };
-    package_type: PackageType;
-    box_packaging_type: BoxPackagingType;
-    /**
-     * Box shipments to be added to this receiving order
-     */
-    boxes: {
-        /**
-         * Tracking number for the box shipment.
-         *
-         * The API docs say "string or null", but if you pass null will get a 400: Boxes[...] 'The TrackingNumber field is required.'
-         */
-        tracking_number: string;
-        /**
-         * Items contained in this box
-         */
-        box_items: {
-            /**
-             * Quantity of the items in the box
-             *
-             * NOTE: integer <int32> [ 1 .. 2147483647 ].  LOL.  2 billion
-             */
-            quantity: number;
-            /**
-             * Unique inventory id of the items in the box
-             */
-            inventory_id: number;
-            /**
-             * 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>;
-            /**
-             * Lot expiration date for the items in the box
-             */
-            lot_date?: Nullable<string>;
-        }[];
-    }[];
-    /**
-     * 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;
-    /**
-     * Purchase order number for this receiving order,
-     *
-     * NOTE: Supporting idempotency this must be unique across WROs
-     *       Otherwise 422: "Request could not be completed, PO reference already exists and must be a unique value"
-     */
-    purchase_order_number?: Nullable<string>;
-};
-export type ReceivingStatus = 'Awaiting' | 'Processing' | 'Completed' | 'Cancelled' | 'Incomplete' | 'Arrived' | 'PartiallyArrived' | 'PartiallyArrivedAtHub' | 'ArrivedAtHub' | 'ProcessingAtHub' | 'InternalTransfer';
-export type WarehouseReceivingOrderResponse = {
-    id: number;
-    /**
-     * Not sure what these could be. "Awaiting" is a staging status.
-     */
-    status: ReceivingStatus;
-    /**
-     * What was sent in the request
-     */
-    package_type: PackageType;
-    /**
-     * What was sent in the request
-     */
-    box_packaging_type: BoxPackagingType;
-    /**
-     * What was sent in the request (ISO date)
-     */
-    expected_arrival_date: string;
-    /**
-     * ISO date: "2025-02-18T19:25:13.034265+00:00"
-     */
-    insert_date: string;
-    /**
-     * ISO date
-     */
-    last_updated_date: string;
-    /**
-     * ie: "/2.0/receiving/442945/labels"
-     */
-    box_labels_uri: string;
-    fulfillment_center: FulfillmentCenter;
-    purchase_order_number: Nullable<string>;
-    inventory_quantities: {
-        inventory_id: number;
-        sku: string;
-        expected_quantity: number;
-        received_quantity: number;
-        stowed_quantity: number;
-    }[];
-    /**
-     * The timestamp in UTC when a 3rd party integrator has set in ShipBob system
-     *
-     * We set this in their receiving-extended API endpoints.  Use case is for acknowledging completed orders.
-     * Their API has example: "2019-08-24T14:15:22Z"
-     */
-    external_sync_timestamp: Nullable<string>;
-};
-/**
- * The simulation will work on our SandBox Environment.
- */
-export type Simulation = {
-    /**
-     * Identifies what action to perform on shipment.
-     */
-    action: 'ShipOrder' | 'DeliverOrder';
-    /**
-     * Delay time for action in minutes to be triggered after.
-     *
-     * NOTE: anything over 2880 will be clamped
-     */
-    delay?: Nullable<number>;
-    /**
-     * Next simulation action to be performed after it.
-     */
-    next?: Nullable<SimulateShipmentRequest>;
-};
-export type SimulateShipmentRequest = {
-    /**
-     * Shipment Id for simulation.
-     */
-    shipment_id: number;
-    /**
-     * Simulation actions object.
-     */
-    simulation: Simulation;
-};
-export type SimulateShipmentResponse = {
-    /**
-     * Simulation id for register simulation request.
-     * UUID ie: 439a9dec-9bff-4339-9564-89975d3a8f5c
-     */
-    simulation_id: string;
-    /**
-     * ie: "Simulation registered successfully"
-     */
-    message: string;
-};
-export type SimulationDetails = {
-    /**
-     * Identifies the action that was performed.
-     */
-    action: 'ShipOrder' | 'DeliverOrder';
-    /**
-     * Status of the simulation action.
-     */
-    status: 'Success' | 'Failed' | 'Pending' | 'Skipped';
-    /**
-     * Additional message for the action.
-     *
-     * ie:
-     * - "This simulated action has been completed successfully."
-     * - "This simulation action is not executed yet."
-     */
-    message: string;
-    /**
-     * Scheduled time if the action had a delay.
-     * ie: ISO date '2025-02-19T00:09:53.77' or NULL
-     */
-    schedule_time: Nullable<string>;
-    /**
-     * Nested object with details of subsequent simulation actions. This value would be null if there is no subsequent action.
-     */
-    next: Nullable<SimulationDetails>;
-};
-export type SimulationResponse = {
-    /**
-     * Simulation id for register simulation request.
-     */
-    simulation_id: string;
-    /**
-     * ID of the entity for which the simulation was registered.
-     */
-    entity_id: string;
-    /**
-     * Type of entity for which the simulation was registered.
-     *
-     * ie: "Order"
-     */
-    entity_type: string;
-    /**
-     * Object with details of simulation actions
-     * type:  SimulationDetails (not described in docs)
-     */
-    simulation: SimulationDetails;
-};
-/**
- * For each WRO that was supplied, if ExternalSync was updated
- */
-export type SetExternalSyncResponse = {
-    results: {
-        id: number;
-        action: 'ExternalSync';
-        is_success: boolean;
-        /**
-         * Probably a reason if it didn't succeed.  Empty when it does succeed.
-         * ie: ""
-         */
-        reason: string;
-    }[];
-};
-export type BoxStatus = 'Awaiting' | 'Arrived' | 'Completed' | 'Counting' | 'Stowing' | 'Cancelled' | 'InternalTransfer';
-/**
- * Get Warehouse Receiving Order Boxes response
- */
-export type WarehouseReceivingOrderBoxesResponse = {
-    box_id: number;
-    /**
-     * The number of the box in the receiving order
-     */
-    box_number: number;
-    box_status: BoxStatus;
-    /**
-     * Date the box arrived
-     */
-    arrived_date: Nullable<string>;
-    /**
-     * Date the box was received
-     */
-    received_date: Nullable<string>;
-    /**
-     * Date counting of the box's inventory items started
-     */
-    counting_started_date: Nullable<string>;
-    /**
-     * Tracking number of the box shipment
-     */
-    tracking_number: Nullable<string>;
-    /**
-     * type: BoxItemViewModel
-     */
-    box_items: {
-        /**
-         * Quantity of the item included
-         */
-        quantity: number;
-        /**
-         * Quantity of the item that was received after processing the receiving order
-         */
-        received_quantity: number;
-        /**
-         * Quantity of the item that has been stowed
-         */
-        stowed_quantity: number;
-        /**
-         * Unique identifier of the inventory item
-         */
-        inventory_id: number;
-        /**
-         * Lot number the item belongs to
-         */
-        lot_number: Nullable<string>;
-        /**
-         * Expiration date of the item's lot
-         */
-        lot_date: Nullable<string>;
-    }[];
-}[];
-export declare enum PackagingRequirement {
-    'No Requirements' = 1,
-    Fragile = 2,
-    'Is Foldable' = 3,
-    'Is Media (Media mail)' = 4,
-    'Is Book' = 5,
-    'Is Poster' = 6,
-    'Is Apparel' = 7,
-    'Is Packaging Material (for custom boxes, marketing inserts, etc)' = 8,
-    'Ship In Own Container' = 9
-}
-export declare enum PackagingMaterial {
-    'Box' = 1,
-    'Bubble Mailer' = 2,
-    'Poly Mailer' = 3,
-    'Poster Tube' = 5,
-    'Custom Box' = 6,
-    'Bookfold' = 7,
-    'Ship In Own Container' = 8,
-    'Custom Bubble Mailer' = 9,
-    'Custom Poly Mailer' = 10
-}
-/**
- * Restock (1)
- * Quarantine (2)
- * Dispose (3)
- */
-export declare enum ReturnAction {
-    /**
-     * Restock (1)
-     */
-    Restock = 1,
-    /**
-     * Quarantine (2)
-     */
-    Quarantine = 2,
-    /**
-     * Dispose (3)
-     */
-    Dispose = 3
-}
-export type VariantRequestProductExperimental = Omit<VariantRequestProduct2_0, 'barcode'> & {
-    barcodes: {
-        value: string;
-        sticker_url: Nullable<string>;
-    }[];
-};
-export type VariantRequestProduct2_0 = {
-    /**
-     * Required for updates
-     */
-    id?: number;
-    name?: string;
-    sku?: string;
-    /**
-     * will serialize as a number
-     */
-    packaging_requirement_id?: PackagingRequirement;
-    /**
-     * will serialize as a number
-     */
-    packaging_material_type_id?: PackagingMaterial;
-    barcode?: string;
-    upc?: string;
-    gtin?: string;
-    customs?: {
-        /**
-         * 2 character country code
-         */
-        country_code_of_origin: 'US';
-        /**
-         * The customs code (6 digit)
-         * ie: “6103.22”
-         */
-        hs_tariff_code: string;
-        /**
-         * Value of object for customs (in USD)
-         * ie: “15”
-         */
-        value: string;
-        /**
-         * Description of product for customs purposes
-         */
-        description: string;
-    };
-    /**
-     * Not sure if these can be partially supplied.
-     */
-    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>;
-    };
-    lot_information: {
-        /**
-         * If the product should use lot date based picking
-         */
-        is_lot: boolean;
-        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 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';
+    logTraffic: boolean;
 };
 /**
  * Create API with PAT (personal access token) - defaults to sandbox endpoints and "SMA" channel.
@@ -1165,28 +51,16 @@ export type GetInventory1_0Result = {
  * TODO: Consider adding global parameters like timeout (or per method).  Some endpoints are slower than others.
  *
  * @param personalAccessToken passing *undefined* or empty string has a guar clause that will throw
- * @param apiBaseUrl
- * @param channelApplicationName
+ * @param apiBaseUrl must pass "api.shipbob.com" otherwise sandbox will be used.
+ * @param channelApplicationName will default to SMA account, otherwise provide your application_name here
  * @param options
- * @returns
  */
-export declare const createShipBobApi: (personalAccessToken: string | undefined, apiBaseUrl?: string, channelApplicationName?: string, options?: {
-    logTraffic: boolean;
-}) => 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.
+     * Gets by *their* product id
      */
     getProductById: (productId: number) => Promise<DataResponse<GetProduct1_0Result>>;
-    getProducts1_0: (query: Partial<{
-        ReferenceIds: string;
-        Page: number;
-        Limit: number;
-        IDs: string;
-        Search: string;
-        ActiveStatus: "Any" | "Active" | "Inactive";
-        BundleStatus: "Any" | "Bundle" | "NotBundle";
-    }>) => Promise<DataResponse<GetProduct1_0Result[]>>;
+    getProducts1_0: (query: GetProducts1_0QueryString) => Promise<DataResponse<GetProduct1_0Result[]>>;
     /**
      * NOTE: you need to use the headers (part of this client response) to page the results.
      * page-number='1'
@@ -1209,7 +83,7 @@ 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<GetProductQueryStrings>) => Promise<DataResponse<GetProduct2_0Response[]>>;
+    getProducts2_0: (query: 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.
      */
@@ -1236,7 +110,11 @@ export declare const createShipBobApi: (personalAccessToken: string | undefined,
         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
      *
@@ -1246,15 +124,20 @@ export declare const createShipBobApi: (personalAccessToken: string | undefined,
     getShippingMethods: () => Promise<DataResponse<ShippingMethod[]>>;
     getWebhooks: () => Promise<DataResponse<Webhook[]>>;
     /**
-     * NOTE: can consider option to add without providing channel id (would need matching unregister)
+     *
+     * @param webhook just needs topic and subscription url.
+     * @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">) => Promise<DataResponse<Webhook>>;
+    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 matches.
+     * Can generate 500 response with data: "The wait operation timed out."  If so, check your channel id (or lack thereof) matches the subscription registration.
      *
-     * NOTE: can consider option to add without providing channel id (would need matching register)
+     * @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) => Promise<DataResponse<Webhook>>;
+    unregisterWebhookSubscription: (id: number, sendChannelId?: boolean) => Promise<DataResponse<Webhook>>;
     getFulfillmentCenters: () => Promise<DataResponse<FulfillmentCenter[]>>;
     createWarehouseReceivingOrder: (request: WarehouseReceivingOrderRequest) => Promise<DataResponse<WarehouseReceivingOrderResponse>>;
     getWarehouseReceivingOrder: (orderId: number) => Promise<DataResponse<WarehouseReceivingOrderResponse>>;
@@ -1277,42 +160,9 @@ export declare const createShipBobApi: (personalAccessToken: string | undefined,
     /**
      * NOTE: should verify the response type matches the product 1.0 endpoint
      */
-    listInventory: (query: Partial<{
-        /**
-         * Page of inventory items to get
-         */
-        Page: number;
-        /**
-         * Amount of inventory items per page to request
-         */
-        Limit: number;
-        IsActive: boolean;
-        IsDigital: boolean;
-        IDs: number[];
-        /**
-         * Sort will default to ascending order for each field. To sort in descending order please pass a "-" in front of the field name. For example, Sort=-onHand,name will sort by onHand descending
-         *
-         * NOTE: if you sort a non-valid field will be a 422.  ie: on_hand is not an available sort property
-         *
-         * NOTE: their API is a mix of pascalCase and snake_case.
-         */
-        Sort: string;
-        /**
-         * Search is available for 2 fields, Inventory ID and Name -
-         *
-         * Expected behavior for search by Inventory ID is exact match
-         * Expected behavior for search by Inventory Name is partial match, i.e. does not have to be start of word, but must be consecutive characters. This is not case sensitive.
-         */
-        Search: string;
-        /**
-         * LocationType is valid for hub, spoke, or lts. LocationType will default to all locations.
-         */
-        LocationType: string;
-    }>) => Promise<DataResponse<GetInventory1_0Result[]>>;
+    listInventory: (query: Partial<ListInventoryQueryStrings>) => Promise<DataResponse<GetInventory1_0Result[]>>;
     /**
      * Only for sandbox: https://developer.shipbob.com/sandbox-simulations/
-     *
-     * NOTE: generates a 200 instead of a 201 like everywhere else
      */
     simulateShipment: (request: SimulateShipmentRequest) => Promise<DataResponse<SimulateShipmentResponse>>;
     /**
@@ -1323,4 +173,3 @@ export declare const createShipBobApi: (personalAccessToken: string | undefined,
      */
     getSimulationStatus: (simulationId: string) => Promise<DataResponse<SimulationResponse>>;
 }>;
-export {};