@whiplashmerch/whiplash-api-client 0.4.42 → 0.4.44

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -769,6 +769,11 @@ export interface APIV21EntitiesOrder {
769
769
  /** the order type */
770
770
  order_type?: string;
771
771
  originator?: APIV2EntitiesOriginator;
772
+ /**
773
+ * User-defined reference for shipping labels on packages.
774
+ * Note: this field has a limit of 35 chars.
775
+ */
776
+ package_label_reference?: string;
772
777
  /** url for this orders packing slip */
773
778
  packingslip_pdf_url?: string;
774
779
  /** Permission limited orders are not editable, but still may be processed/shipped */
@@ -2559,6 +2564,11 @@ export interface APIV2EntitiesOrder {
2559
2564
  /** the order type */
2560
2565
  order_type?: string;
2561
2566
  originator?: APIV2EntitiesOriginator;
2567
+ /**
2568
+ * User-defined reference for shipping labels on packages.
2569
+ * Note: this field has a limit of 35 chars.
2570
+ */
2571
+ package_label_reference?: string;
2562
2572
  packages?: APIV2EntitiesPackage[];
2563
2573
  /** url for this orders packing slip */
2564
2574
  packingslip_pdf_url?: string;
@@ -5791,6 +5801,152 @@ export interface PostApiV21ConsumerReturns {
5791
5801
  warehouse_id?: number;
5792
5802
  }
5793
5803
 
5804
+ /** Create consumer_returns in bulk */
5805
+ export interface PostApiV21ConsumerReturnsBulk {
5806
+ /** An array of consumer_return objects to create in bulk */
5807
+ resources: {
5808
+ /**
5809
+ * The whiplash id of the order from which an item is being returned
5810
+ * @format int32
5811
+ */
5812
+ order_id: number;
5813
+ /**
5814
+ * the consumer return customer id
5815
+ * @format int32
5816
+ */
5817
+ customer_id?: number;
5818
+ /**
5819
+ * The ID of the whiplash warehouse this return should be delivered to
5820
+ * @format int32
5821
+ */
5822
+ warehouse_id?: number;
5823
+ /** the consumer return sender */
5824
+ sender?: string;
5825
+ /**
5826
+ * the consumer return estimated arrival date
5827
+ * @format date-time
5828
+ */
5829
+ eta?: string;
5830
+ /**
5831
+ * status of the consumer return
5832
+ * @format int32
5833
+ */
5834
+ status?: number;
5835
+ /** the shipnotice status name */
5836
+ status_name?: string;
5837
+ /** the name of the person who received the consumer return */
5838
+ received_by?: string;
5839
+ /** notes by whiplash */
5840
+ notes_by_whiplash?: string;
5841
+ /** notes by customer */
5842
+ notes_by_customer?: string;
5843
+ /**
5844
+ * total number of boxes in the consumer return
5845
+ * @format int32
5846
+ */
5847
+ total_boxes?: number;
5848
+ /**
5849
+ * the consumer return arrival date and time
5850
+ * @format date-time
5851
+ */
5852
+ arrived_at?: string;
5853
+ /** allow skipping of images for this consumer return? */
5854
+ skip_images?: boolean;
5855
+ /** the ID of the easypost shipment or tracker */
5856
+ easypostable_id?: string;
5857
+ /** the type of the easypost object (shipment or tracker) */
5858
+ easypostable_type?: string;
5859
+ /** url of the shipping label */
5860
+ shipping_label_url?: string;
5861
+ /**
5862
+ * the consumer return actual cost of shipping
5863
+ * @format float
5864
+ */
5865
+ ship_actual_cost?: number;
5866
+ /** the method of shipping for the consumer return */
5867
+ shipping_method_text?: string;
5868
+ /** shipping carrier */
5869
+ carrier?: string;
5870
+ /** the tracking number of the consumer return */
5871
+ tracking?: string;
5872
+ /** consumer return type (Shipnotice, ConsumerReturn) */
5873
+ type?: string;
5874
+ /** was postage billed? */
5875
+ postage_billed?: boolean;
5876
+ /** was handling billed? */
5877
+ handling_billed?: boolean;
5878
+ /**
5879
+ * the consumer return actual cost of shipping
5880
+ * @format float
5881
+ */
5882
+ ship_3rdparty_cost?: number;
5883
+ /** does this consumer return require a label? */
5884
+ requires_label: boolean;
5885
+ /**
5886
+ * the consumer return completion date and time
5887
+ * @format date-time
5888
+ */
5889
+ completed_at?: string;
5890
+ /** currency used for this consumer return */
5891
+ ship_actual_currency?: string;
5892
+ /**
5893
+ * date when was the consumer return delivered
5894
+ * @format date-time
5895
+ */
5896
+ delivered_at?: string;
5897
+ /**
5898
+ * date when the consumer return is due to be delivered
5899
+ * @format date-time
5900
+ */
5901
+ due_at?: string;
5902
+ /** purchase order number or other human readable token to another system */
5903
+ reference?: string;
5904
+ return_items?: string;
5905
+ shipnotice_items_attributes?: {
5906
+ /**
5907
+ * the shipnotice item item id
5908
+ * @format int32
5909
+ */
5910
+ item_id: number;
5911
+ /**
5912
+ * the number of this shipnotice item in the shipnotice
5913
+ * @format int32
5914
+ */
5915
+ quantity: number;
5916
+ /** action to perform on item return */
5917
+ return_action: string;
5918
+ /** description of the item */
5919
+ description: string;
5920
+ extended_description?: string;
5921
+ originator_attributes?: {
5922
+ /** the originator original id (from the provider) */
5923
+ original_id?: string;
5924
+ /** the originator group id */
5925
+ group_id?: string;
5926
+ /** miscellaneous info for the originator */
5927
+ misc?: string;
5928
+ };
5929
+ }[];
5930
+ originator_attributes?: {
5931
+ /** the originator original id (from the provider) */
5932
+ original_id?: string;
5933
+ /** the originator group id */
5934
+ group_id?: string;
5935
+ /** miscellaneous info for the originator */
5936
+ misc?: string;
5937
+ };
5938
+ /** Hash of key value pairs (must conform to available meta keys) */
5939
+ meta_fields?: {
5940
+ /** Hash of key/value pairs */
5941
+ fields?: object;
5942
+ /** Included meta fields for associations */
5943
+ association_fields?: object;
5944
+ };
5945
+ /** List of whiplash item ids to be added to an exchange order */
5946
+ exchange_items?: number[];
5947
+ }[];
5948
+ }
5949
+
5794
5950
  /** Create a document */
5795
5951
  export interface PostApiV21Documents {
5796
5952
  /** Comma seperated list of context tags */
@@ -6618,6 +6774,11 @@ export interface PostApiV21Orders {
6618
6774
  /** miscellaneous info for the originator */
6619
6775
  misc?: string;
6620
6776
  };
6777
+ /**
6778
+ * User-defined reference for shipping labels on packages.
6779
+ * Note: this field has a limit of 35 chars.
6780
+ */
6781
+ package_label_reference?: string;
6621
6782
  /** Permission limited orders are not editable, but still may be processed/shipped */
6622
6783
  permissions_limited?: boolean;
6623
6784
  /** is the order a pickup order */
@@ -6776,6 +6937,390 @@ export interface PostApiV21Orders {
6776
6937
  };
6777
6938
  }
6778
6939
 
6940
+ /** Create orders in bulk */
6941
+ export interface PostApiV21OrdersBulk {
6942
+ /** An array of order objects to create in bulk */
6943
+ resources?: {
6944
+ /**
6945
+ * the order shipping method id
6946
+ * @format int32
6947
+ */
6948
+ shipping_method_id?: number;
6949
+ /**
6950
+ * the estimated order shipping method id, if set to cheapest rate
6951
+ * @format int32
6952
+ */
6953
+ estimated_shipping_method_id?: number;
6954
+ /** the order humanized id */
6955
+ humanize_id?: string;
6956
+ /**
6957
+ * the order original id (from the shop that sent whiplash the order)
6958
+ * Note: contains the global-e order id for any global-e order.
6959
+ */
6960
+ order_orig?: string;
6961
+ /**
6962
+ * User-defined reference for shipping labels on packages.
6963
+ * Note: this field has a limit of 35 chars.
6964
+ */
6965
+ package_label_reference?: string;
6966
+ /** the order level 1 token */
6967
+ level1_token?: string;
6968
+ /** the order level 2 token */
6969
+ level2_token?: string;
6970
+ /** skip street date for this order? */
6971
+ skip_street_date?: boolean;
6972
+ /**
6973
+ * the order due at date and time
6974
+ * @format date-time
6975
+ */
6976
+ due_at?: string;
6977
+ /** meta data for this order as stringified JSON */
6978
+ meta_data?: string;
6979
+ /** the carrier on the customer provided label (for tracking purposes) */
6980
+ customer_provided_label_carrier?: string;
6981
+ /** the purchase order this order */
6982
+ purchase_order?: string;
6983
+ /** the order type */
6984
+ order_type?: PostApiV21OrdersBulkOrderType;
6985
+ /** the order shipping email */
6986
+ email?: string;
6987
+ /** are the items in the order updateable */
6988
+ items_updateable?: boolean;
6989
+ /** skip order shipping address verification? (staff only) */
6990
+ skip_address_verification?: boolean;
6991
+ /** the order shop warehouse ids */
6992
+ shop_warehouse_ids?: number[];
6993
+ /** the order shop shipping method currency */
6994
+ shop_shipping_method_currency?: string;
6995
+ /**
6996
+ * the order shop creation date and time
6997
+ * @format date-time
6998
+ */
6999
+ shop_created_at?: string;
7000
+ /**
7001
+ * the order shop last update date and time
7002
+ * @format date-time
7003
+ */
7004
+ shop_updated_at?: string;
7005
+ /**
7006
+ * the order shop shipping method text
7007
+ * ge_standard = order uses global-e standard shipping method
7008
+ * ge_express = order uses global-e express shipping method
7009
+ * Note: the global-e values will not match the global-e official shipping method mappings set up in the UI
7010
+ */
7011
+ shop_shipping_method_text?: string;
7012
+ /**
7013
+ * the order shop shipping method price
7014
+ * @format float
7015
+ */
7016
+ shop_shipping_method_price?: number;
7017
+ /** the order billing company */
7018
+ billing_company?: string;
7019
+ /** the order billing street address 1 */
7020
+ billing_address_1?: string;
7021
+ /** the order billing street address 2 */
7022
+ billing_address_2?: string;
7023
+ /** the order billing street address 3 */
7024
+ billing_address_3?: string;
7025
+ /** the order billing city */
7026
+ billing_city?: string;
7027
+ /** the order billing state */
7028
+ billing_state?: string;
7029
+ /** the order billing zip */
7030
+ billing_zip?: string;
7031
+ /** the order billing country */
7032
+ billing_country?: string;
7033
+ /** the order billing phone number */
7034
+ billing_phone?: string;
7035
+ /** do not bill for the order? (staff only) */
7036
+ do_not_bill?: boolean;
7037
+ /** the order billing name */
7038
+ billing_name?: string;
7039
+ /** the first name of the person the order is being shipped to */
7040
+ first_name?: string;
7041
+ /** the last name of the person the order is being shipped to */
7042
+ last_name?: string;
7043
+ /** the full name of the person the order is being shipped to */
7044
+ full_name?: string;
7045
+ /** the order shipping name */
7046
+ shipping_name?: string;
7047
+ /** the order shipping company */
7048
+ shipping_company?: string;
7049
+ /** the order shipping street address 1 */
7050
+ shipping_address_1?: string;
7051
+ /** the order shipping street address 2 */
7052
+ shipping_address_2?: string;
7053
+ /** the order shipping city */
7054
+ shipping_city?: string;
7055
+ /** the order shipping state */
7056
+ shipping_state?: string;
7057
+ /** the order shipping zip */
7058
+ shipping_zip?: string;
7059
+ /** the order shipping country */
7060
+ shipping_country?: string;
7061
+ /** the order shipping country iso2 (US, GB, CA, etc) */
7062
+ shipping_country_iso2?: string;
7063
+ /** the order shipping phone number */
7064
+ shipping_phone?: string;
7065
+ /** the order requested address */
7066
+ requested_address?: string;
7067
+ /** is the order address residential? */
7068
+ residential?: boolean;
7069
+ /** is the order expedited? */
7070
+ expedited?: boolean;
7071
+ /** does the order require a signature upon delivery? */
7072
+ require_signature?: boolean;
7073
+ /** does the order require an adult signature upon delivery? */
7074
+ require_adult_signature?: boolean;
7075
+ /** require a carrier that delivers on Saturdays for this order? */
7076
+ saturday_delivery?: boolean;
7077
+ /** is the order a gift? */
7078
+ gift?: boolean;
7079
+ /** is the order insured? */
7080
+ insure?: boolean;
7081
+ /** does the order contain alcohol? */
7082
+ contains_alcohol?: boolean;
7083
+ /** does the order require customs documents? */
7084
+ customs_required?: boolean;
7085
+ /** carrier facility access point for the address destination */
7086
+ shipping_carrier_facility?: string;
7087
+ /** pickup option for carrier facility on the address destination */
7088
+ shipping_hold_for_pickup?: boolean;
7089
+ /** the order ship notes */
7090
+ ship_notes?: string;
7091
+ /**
7092
+ * the order third party shipping cost
7093
+ * @format float
7094
+ */
7095
+ ship_3rdparty_cost?: number;
7096
+ /** the order third party shipping account */
7097
+ ship_3rdparty_account?: string;
7098
+ /** the order third party shipping zip */
7099
+ ship_3rdparty_zip?: string;
7100
+ /** the order third party shipping country */
7101
+ ship_3rdparty_country?: string;
7102
+ /** the order public note */
7103
+ public_note?: string;
7104
+ /**
7105
+ * the order estimated days in transit (used for release planning)
7106
+ * @format int32
7107
+ */
7108
+ days_in_transit?: number;
7109
+ /**
7110
+ * the order estimated days in transit estimate from the carrier
7111
+ * @format int32
7112
+ */
7113
+ days_in_transit_carrier_estimate?: number;
7114
+ /**
7115
+ * the order requested insurance value
7116
+ * @format float
7117
+ */
7118
+ req_insurance_value?: number;
7119
+ /** packingslip pdf url */
7120
+ cf_packingslip_pdf_url?: string;
7121
+ /** Value Added Tax identifcation number for the sender of the order */
7122
+ customs_vat_number?: string;
7123
+ /** Economic Operators Registration and Identification number for the sender of the order */
7124
+ customs_eori_number?: string;
7125
+ /** Import One-Stop Shop number for the sender of the order */
7126
+ customs_ioss_number?: string;
7127
+ /**
7128
+ * the carrier account id for this package, if it has shipped (staff only)
7129
+ * @format int32
7130
+ */
7131
+ carrier_account_id?: number;
7132
+ /** the order tracking numbers */
7133
+ tracking?: string[];
7134
+ /** the order tracking links */
7135
+ tracking_links?: string[];
7136
+ /**
7137
+ * the order approxiamte delivery date
7138
+ * @format date
7139
+ */
7140
+ approximate_delivery_date?: string;
7141
+ /** is the order a global_e order? */
7142
+ global_e_ge_order?: boolean;
7143
+ /** the orders calculated return time limit */
7144
+ calculated_time_limit?: string;
7145
+ /** is the order within its return time limit */
7146
+ within_return_time_limit?: boolean;
7147
+ /** the order return name */
7148
+ return_name?: string;
7149
+ /** the order return company */
7150
+ return_company?: string;
7151
+ /** the order return street address 1 */
7152
+ return_address_1?: string;
7153
+ /** the order return street address 2 */
7154
+ return_address_2?: string;
7155
+ /** the order return city */
7156
+ return_city?: string;
7157
+ /** the order return state */
7158
+ return_state?: string;
7159
+ /** the order return country */
7160
+ return_country?: string;
7161
+ /** the order return zip */
7162
+ return_zip?: string;
7163
+ /** the order return phone number */
7164
+ return_phone?: string;
7165
+ /** the order return email */
7166
+ return_email?: string;
7167
+ /**
7168
+ * the order return time limit
7169
+ * @format int32
7170
+ */
7171
+ return_time_limit?: number;
7172
+ /** is the order workable? */
7173
+ is_workable?: boolean;
7174
+ /** is the order gestating? */
7175
+ is_gestating?: boolean;
7176
+ /** Permission limited orders are not editable, but still may be processed/shipped */
7177
+ permissions_limited?: boolean;
7178
+ order_items?: string;
7179
+ /** desired incoterm for the order */
7180
+ incoterm?: PostApiV21OrdersBulkIncoterm;
7181
+ /**
7182
+ * the order status: 30 (Shipped Externally), 35 (Quote), 40 (Cancelled), 45 (Closed by Originator), 50 (Unpaid), 75 (Pending Return), 77 (Return Verified), 80 (Pre-Order), 90 (Paused), 95 (Insufficient Inventory), 100 (Processing), 120 (Printed), 150 (Picked), 155 (Prepacking in Progress), 160 (Packed), 200 (Label Scheduled for Purchase), 250 (Label Purchased), 300 (Shipped), 325 (Picked Up), 350 (Delivered), 375 (Return Expired), 380 (Replacement Cancelled), 400 (Returned Undeliverable), 410 (Replacement Requested), 430 (Exchanged), 450 (Refund Requested)
7183
+ * @format int32
7184
+ */
7185
+ status?: PostApiV21OrdersBulkStatus;
7186
+ order_items_attributes?: {
7187
+ /**
7188
+ * number of this item in Order
7189
+ * @format int32
7190
+ */
7191
+ quantity?: number;
7192
+ /**
7193
+ * the order item order id
7194
+ * @format int32
7195
+ */
7196
+ order_id?: number;
7197
+ /**
7198
+ * the order item customer id
7199
+ * @format int32
7200
+ */
7201
+ customer_id?: number;
7202
+ /**
7203
+ * the order item item id
7204
+ * @format int32
7205
+ */
7206
+ item_id?: number;
7207
+ /** the SKU of this item */
7208
+ sku?: string;
7209
+ /** description for this order item. This will appear in packing slips. If not set, the description will be inherited from the parent Item. */
7210
+ description?: string;
7211
+ /**
7212
+ * price of this item
7213
+ * @format float
7214
+ */
7215
+ price?: number;
7216
+ /** is this item unshippable? */
7217
+ unshippable?: boolean;
7218
+ /** is this item available? */
7219
+ available?: boolean;
7220
+ /**
7221
+ * number of items packed
7222
+ * @format int32
7223
+ */
7224
+ packed?: number;
7225
+ /** is this item packaging? */
7226
+ packaging?: boolean;
7227
+ /**
7228
+ * wholesale cost of the item
7229
+ * @format float
7230
+ */
7231
+ wholesale_cost?: number;
7232
+ /** is this item a bundle? */
7233
+ is_bundle?: boolean;
7234
+ /**
7235
+ * retail fee of this item
7236
+ * @format float
7237
+ */
7238
+ retail_fee?: number;
7239
+ /** is this item a promo? */
7240
+ promo?: boolean;
7241
+ /** is this item returnable? */
7242
+ returnable?: boolean;
7243
+ /** currency code for this item */
7244
+ currency?: string;
7245
+ /**
7246
+ * wholesale fee of this item
7247
+ * @format float
7248
+ */
7249
+ wholesale_fee?: number;
7250
+ /** (deprecated) is the order item hazmat? */
7251
+ hazmat?: boolean;
7252
+ /** miscellaneous information about the order item */
7253
+ misc?: string;
7254
+ /** does the item require a serial number when shipping? */
7255
+ request_serial_number?: boolean;
7256
+ /** The original id of the order item */
7257
+ originator_id?: string;
7258
+ /** The original id of the item */
7259
+ item_originator_id?: string;
7260
+ originator_attributes?: {
7261
+ /** the originator original id (from the provider) */
7262
+ original_id?: string;
7263
+ /** the originator group id */
7264
+ group_id?: string;
7265
+ /** miscellaneous info for the originator */
7266
+ misc?: string;
7267
+ };
7268
+ }[];
7269
+ originator_attributes?: {
7270
+ /** the originator original id (from the provider) */
7271
+ original_id?: string;
7272
+ /** the originator group id */
7273
+ group_id?: string;
7274
+ /** miscellaneous info for the originator */
7275
+ misc?: string;
7276
+ };
7277
+ /** Hash of key value pairs (must conform to available meta keys) */
7278
+ meta_fields?: {
7279
+ /** Hash of key/value pairs */
7280
+ fields?: object;
7281
+ /** Included meta fields for associations */
7282
+ association_fields?: object;
7283
+ };
7284
+ }[];
7285
+ }
7286
+
7287
+ /** desired incoterm for the order */
7288
+ export enum PostApiV21OrdersBulkIncoterm {
7289
+ EXW = "EXW",
7290
+ FCA = "FCA",
7291
+ CPT = "CPT",
7292
+ CIP = "CIP",
7293
+ DAT = "DAT",
7294
+ DAP = "DAP",
7295
+ DDP = "DDP",
7296
+ FAS = "FAS",
7297
+ FOB = "FOB",
7298
+ CFR = "CFR",
7299
+ CIF = "CIF",
7300
+ DAF = "DAF",
7301
+ DES = "DES",
7302
+ DEQ = "DEQ",
7303
+ DDU = "DDU",
7304
+ }
7305
+
7306
+ /** the order type */
7307
+ export enum PostApiV21OrdersBulkOrderType {
7308
+ DirectToConsumer = "direct_to_consumer",
7309
+ Dropship = "dropship",
7310
+ Retail = "retail",
7311
+ Transfer = "transfer",
7312
+ Wholesale = "wholesale",
7313
+ }
7314
+
7315
+ /**
7316
+ * the order status: 30 (Shipped Externally), 35 (Quote), 40 (Cancelled), 45 (Closed by Originator), 50 (Unpaid), 75 (Pending Return), 77 (Return Verified), 80 (Pre-Order), 90 (Paused), 95 (Insufficient Inventory), 100 (Processing), 120 (Printed), 150 (Picked), 155 (Prepacking in Progress), 160 (Packed), 200 (Label Scheduled for Purchase), 250 (Label Purchased), 300 (Shipped), 325 (Picked Up), 350 (Delivered), 375 (Return Expired), 380 (Replacement Cancelled), 400 (Returned Undeliverable), 410 (Replacement Requested), 430 (Exchanged), 450 (Refund Requested)
7317
+ * @format int32
7318
+ */
7319
+ export enum PostApiV21OrdersBulkStatus {
7320
+ Value30 = 30,
7321
+ Value35 = 35,
7322
+ }
7323
+
6779
7324
  /** Create an order document for an order */
6780
7325
  export interface PostApiV21OrdersIdOrderDocuments {
6781
7326
  /**
@@ -7088,6 +7633,185 @@ export interface PostApiV21Shipnotices {
7088
7633
  warehouse_id: number;
7089
7634
  }
7090
7635
 
7636
+ /** Create shipnotices in bulk */
7637
+ export interface PostApiV21ShipnoticesBulk {
7638
+ /** An array of shipnotice objects to create in bulk */
7639
+ resources: {
7640
+ /** the shipnotice sender */
7641
+ sender: string;
7642
+ /**
7643
+ * the shipnotice estimated arrival date
7644
+ * @format date-time
7645
+ */
7646
+ eta: string;
7647
+ /**
7648
+ * the shipnotice warehouse id
7649
+ * @format int32
7650
+ */
7651
+ warehouse_id: number;
7652
+ /**
7653
+ * status of the shipnotice
7654
+ * @format int32
7655
+ */
7656
+ status?: number;
7657
+ /** the shipnotice status name */
7658
+ status_name?: string;
7659
+ /** the name of the person who received the shipnotice */
7660
+ received_by?: string;
7661
+ /** notes by whiplash */
7662
+ notes_by_whiplash?: string;
7663
+ /** notes by customer */
7664
+ notes_by_customer?: string;
7665
+ /**
7666
+ * total number of boxes in the shipnotice
7667
+ * @format int32
7668
+ */
7669
+ total_boxes?: number;
7670
+ /**
7671
+ * the shipnotice arrival date and time
7672
+ * @format date-time
7673
+ */
7674
+ arrived_at?: string;
7675
+ /** allow skipping of images for this shipnotice? */
7676
+ skip_images?: boolean;
7677
+ /** the ID of the easypost shipment or tracker */
7678
+ easypostable_id?: string;
7679
+ /** the type of the easypost object (shipment or tracker) */
7680
+ easypostable_type?: string;
7681
+ /** url of the shipping label */
7682
+ shipping_label_url?: string;
7683
+ /**
7684
+ * the shipnotice actual cost of shipping
7685
+ * @format float
7686
+ */
7687
+ ship_actual_cost?: number;
7688
+ /** the method of shipping for the shipnotice */
7689
+ shipping_method_text?: string;
7690
+ /** shipping carrier */
7691
+ carrier?: string;
7692
+ /**
7693
+ * shipping method id
7694
+ * @format int32
7695
+ */
7696
+ shipping_method_id?: number;
7697
+ /** the tracking number of the shipnotice */
7698
+ tracking?: string;
7699
+ /**
7700
+ * the order_id of the shipnotice
7701
+ * @format int32
7702
+ */
7703
+ order_id?: number;
7704
+ /** shipnotice type (Shipnotice, ConsumerReturn) */
7705
+ type?: string;
7706
+ /** was postage billed? */
7707
+ postage_billed?: boolean;
7708
+ /** was handling billed? */
7709
+ handling_billed?: boolean;
7710
+ /**
7711
+ * 3rd party cost for the shipnotice
7712
+ * @format float
7713
+ */
7714
+ ship_3rdparty_cost?: number;
7715
+ /** does this shipnotice require a label? */
7716
+ requires_label?: boolean;
7717
+ /**
7718
+ * the shipnotice completion date and time
7719
+ * @format date-time
7720
+ */
7721
+ completed_at?: string;
7722
+ /**
7723
+ * the shipnotice must be completed by date and time
7724
+ * @format date-time
7725
+ */
7726
+ complete_by?: string;
7727
+ /** currency used for this shipnotice */
7728
+ ship_actual_currency?: string;
7729
+ /**
7730
+ * date when was the shipnoticed delivered
7731
+ * @format date-time
7732
+ */
7733
+ delivered_at?: string;
7734
+ /**
7735
+ * date when the shipnotice is due to be delivered
7736
+ * @format date-time
7737
+ */
7738
+ due_at?: string;
7739
+ /** meta data for this shipnotice as stringified JSON */
7740
+ meta_data?: string;
7741
+ /** purchase order number or other human readable token to another system */
7742
+ reference?: string;
7743
+ /**
7744
+ * number of line items in this Ship Notice
7745
+ * @format int32
7746
+ */
7747
+ shipnotice_item_count?: number;
7748
+ /**
7749
+ * number of unique items in this Ship Notice
7750
+ * @format int32
7751
+ */
7752
+ shipnotice_item_sku_count?: number;
7753
+ /**
7754
+ * quantity of all the line items in this Ship Notice
7755
+ * @format int32
7756
+ */
7757
+ shipnotice_item_quantity?: number;
7758
+ /** purchase order numbers associated with this Ship Notice */
7759
+ purchase_order_numbers?: string[];
7760
+ /** JSON object of required and optional receiving quantities verified by staff */
7761
+ quantities_verified?: object;
7762
+ /** is inspection required? (default: false) */
7763
+ inspection_required?: boolean;
7764
+ shipnotice_items_attributes?: {
7765
+ /**
7766
+ * the number of this shipnotice item in the shipnotice
7767
+ * @format int32
7768
+ */
7769
+ quantity: number;
7770
+ /**
7771
+ * the shipnotice item item id
7772
+ * @format int32
7773
+ */
7774
+ item_id?: number;
7775
+ /** The original id of the item */
7776
+ item_originator_id?: string;
7777
+ /** The purchase order number */
7778
+ purchase_order_number?: string;
7779
+ originator_attributes?: {
7780
+ /** the originator original id (from the provider) */
7781
+ original_id?: string;
7782
+ /** the originator group id */
7783
+ group_id?: string;
7784
+ /** miscellaneous info for the originator */
7785
+ misc?: string;
7786
+ };
7787
+ lot_attributes?: {
7788
+ /** The lot number of the item. */
7789
+ number: string;
7790
+ /**
7791
+ * The lot expiration date.
7792
+ * @format date-time
7793
+ */
7794
+ expires_on: string;
7795
+ };
7796
+ }[];
7797
+ originator_attributes?: {
7798
+ /** the originator original id (from the provider) */
7799
+ original_id?: string;
7800
+ /** the originator group id */
7801
+ group_id?: string;
7802
+ /** miscellaneous info for the originator */
7803
+ misc?: string;
7804
+ };
7805
+ /** Hash of key value pairs (must conform to available meta keys) */
7806
+ meta_fields?: {
7807
+ /** Hash of key/value pairs */
7808
+ fields?: object;
7809
+ /** Included meta fields for associations */
7810
+ association_fields?: object;
7811
+ };
7812
+ }[];
7813
+ }
7814
+
7091
7815
  /** create a shipnotice item */
7092
7816
  export interface PostApiV21ShipnoticesIdShipnoticeItems {
7093
7817
  /** description of the item */
@@ -7336,6 +8060,152 @@ export interface PostApiV2ConsumerReturns {
7336
8060
  warehouse_id?: number;
7337
8061
  }
7338
8062
 
8063
+ /** Create consumer_returns in bulk */
8064
+ export interface PostApiV2ConsumerReturnsBulk {
8065
+ /** An array of consumer_return objects to create in bulk */
8066
+ resources: {
8067
+ /**
8068
+ * The whiplash id of the order from which an item is being returned
8069
+ * @format int32
8070
+ */
8071
+ order_id: number;
8072
+ /**
8073
+ * the consumer return customer id
8074
+ * @format int32
8075
+ */
8076
+ customer_id?: number;
8077
+ /**
8078
+ * The ID of the whiplash warehouse this return should be delivered to
8079
+ * @format int32
8080
+ */
8081
+ warehouse_id?: number;
8082
+ /** the consumer return sender */
8083
+ sender?: string;
8084
+ /**
8085
+ * the consumer return estimated arrival date
8086
+ * @format date-time
8087
+ */
8088
+ eta?: string;
8089
+ /**
8090
+ * status of the consumer return
8091
+ * @format int32
8092
+ */
8093
+ status?: number;
8094
+ /** the shipnotice status name */
8095
+ status_name?: string;
8096
+ /** the name of the person who received the consumer return */
8097
+ received_by?: string;
8098
+ /** notes by whiplash */
8099
+ notes_by_whiplash?: string;
8100
+ /** notes by customer */
8101
+ notes_by_customer?: string;
8102
+ /**
8103
+ * total number of boxes in the consumer return
8104
+ * @format int32
8105
+ */
8106
+ total_boxes?: number;
8107
+ /**
8108
+ * the consumer return arrival date and time
8109
+ * @format date-time
8110
+ */
8111
+ arrived_at?: string;
8112
+ /** allow skipping of images for this consumer return? */
8113
+ skip_images?: boolean;
8114
+ /** the ID of the easypost shipment or tracker */
8115
+ easypostable_id?: string;
8116
+ /** the type of the easypost object (shipment or tracker) */
8117
+ easypostable_type?: string;
8118
+ /** url of the shipping label */
8119
+ shipping_label_url?: string;
8120
+ /**
8121
+ * the consumer return actual cost of shipping
8122
+ * @format float
8123
+ */
8124
+ ship_actual_cost?: number;
8125
+ /** the method of shipping for the consumer return */
8126
+ shipping_method_text?: string;
8127
+ /** shipping carrier */
8128
+ carrier?: string;
8129
+ /** the tracking number of the consumer return */
8130
+ tracking?: string;
8131
+ /** consumer return type (Shipnotice, ConsumerReturn) */
8132
+ type?: string;
8133
+ /** was postage billed? */
8134
+ postage_billed?: boolean;
8135
+ /** was handling billed? */
8136
+ handling_billed?: boolean;
8137
+ /**
8138
+ * the consumer return actual cost of shipping
8139
+ * @format float
8140
+ */
8141
+ ship_3rdparty_cost?: number;
8142
+ /** does this consumer return require a label? */
8143
+ requires_label: boolean;
8144
+ /**
8145
+ * the consumer return completion date and time
8146
+ * @format date-time
8147
+ */
8148
+ completed_at?: string;
8149
+ /** currency used for this consumer return */
8150
+ ship_actual_currency?: string;
8151
+ /**
8152
+ * date when was the consumer return delivered
8153
+ * @format date-time
8154
+ */
8155
+ delivered_at?: string;
8156
+ /**
8157
+ * date when the consumer return is due to be delivered
8158
+ * @format date-time
8159
+ */
8160
+ due_at?: string;
8161
+ /** purchase order number or other human readable token to another system */
8162
+ reference?: string;
8163
+ return_items?: string;
8164
+ shipnotice_items_attributes?: {
8165
+ /**
8166
+ * the shipnotice item item id
8167
+ * @format int32
8168
+ */
8169
+ item_id: number;
8170
+ /**
8171
+ * the number of this shipnotice item in the shipnotice
8172
+ * @format int32
8173
+ */
8174
+ quantity: number;
8175
+ /** action to perform on item return */
8176
+ return_action: string;
8177
+ /** description of the item */
8178
+ description: string;
8179
+ extended_description?: string;
8180
+ originator_attributes?: {
8181
+ /** the originator original id (from the provider) */
8182
+ original_id?: string;
8183
+ /** the originator group id */
8184
+ group_id?: string;
8185
+ /** miscellaneous info for the originator */
8186
+ misc?: string;
8187
+ };
8188
+ }[];
8189
+ originator_attributes?: {
8190
+ /** the originator original id (from the provider) */
8191
+ original_id?: string;
8192
+ /** the originator group id */
8193
+ group_id?: string;
8194
+ /** miscellaneous info for the originator */
8195
+ misc?: string;
8196
+ };
8197
+ /** Hash of key value pairs (must conform to available meta keys) */
8198
+ meta_fields?: {
8199
+ /** Hash of key/value pairs */
8200
+ fields?: object;
8201
+ /** Included meta fields for associations */
8202
+ association_fields?: object;
8203
+ };
8204
+ /** List of whiplash item ids to be added to an exchange order */
8205
+ exchange_items?: number[];
8206
+ }[];
8207
+ }
8208
+
7339
8209
  /** Create a document */
7340
8210
  export interface PostApiV2Documents {
7341
8211
  /** Comma seperated list of context tags */
@@ -8134,6 +9004,11 @@ export interface PostApiV2Orders {
8134
9004
  /** miscellaneous info for the originator */
8135
9005
  misc?: string;
8136
9006
  };
9007
+ /**
9008
+ * User-defined reference for shipping labels on packages.
9009
+ * Note: this field has a limit of 35 chars.
9010
+ */
9011
+ package_label_reference?: string;
8137
9012
  /** Permission limited orders are not editable, but still may be processed/shipped */
8138
9013
  permissions_limited?: boolean;
8139
9014
  /** the order public note */
@@ -8244,6 +9119,390 @@ export interface PostApiV2Orders {
8244
9119
  within_return_time_limit?: boolean;
8245
9120
  }
8246
9121
 
9122
+ /** Create orders in bulk */
9123
+ export interface PostApiV2OrdersBulk {
9124
+ /** An array of order objects to create in bulk */
9125
+ resources?: {
9126
+ /**
9127
+ * the order shipping method id
9128
+ * @format int32
9129
+ */
9130
+ shipping_method_id?: number;
9131
+ /**
9132
+ * the estimated order shipping method id, if set to cheapest rate
9133
+ * @format int32
9134
+ */
9135
+ estimated_shipping_method_id?: number;
9136
+ /** the order humanized id */
9137
+ humanize_id?: string;
9138
+ /**
9139
+ * the order original id (from the shop that sent whiplash the order)
9140
+ * Note: contains the global-e order id for any global-e order.
9141
+ */
9142
+ order_orig?: string;
9143
+ /**
9144
+ * User-defined reference for shipping labels on packages.
9145
+ * Note: this field has a limit of 35 chars.
9146
+ */
9147
+ package_label_reference?: string;
9148
+ /** the order level 1 token */
9149
+ level1_token?: string;
9150
+ /** the order level 2 token */
9151
+ level2_token?: string;
9152
+ /** skip street date for this order? */
9153
+ skip_street_date?: boolean;
9154
+ /**
9155
+ * the order due at date and time
9156
+ * @format date-time
9157
+ */
9158
+ due_at?: string;
9159
+ /** meta data for this order as stringified JSON */
9160
+ meta_data?: string;
9161
+ /** the carrier on the customer provided label (for tracking purposes) */
9162
+ customer_provided_label_carrier?: string;
9163
+ /** the purchase order this order */
9164
+ purchase_order?: string;
9165
+ /** the order type */
9166
+ order_type?: PostApiV2OrdersBulkOrderType;
9167
+ /** the order shipping email */
9168
+ email?: string;
9169
+ /** are the items in the order updateable */
9170
+ items_updateable?: boolean;
9171
+ /** skip order shipping address verification? (staff only) */
9172
+ skip_address_verification?: boolean;
9173
+ /** the order shop warehouse ids */
9174
+ shop_warehouse_ids?: number[];
9175
+ /** the order shop shipping method currency */
9176
+ shop_shipping_method_currency?: string;
9177
+ /**
9178
+ * the order shop creation date and time
9179
+ * @format date-time
9180
+ */
9181
+ shop_created_at?: string;
9182
+ /**
9183
+ * the order shop last update date and time
9184
+ * @format date-time
9185
+ */
9186
+ shop_updated_at?: string;
9187
+ /**
9188
+ * the order shop shipping method text
9189
+ * ge_standard = order uses global-e standard shipping method
9190
+ * ge_express = order uses global-e express shipping method
9191
+ * Note: the global-e values will not match the global-e official shipping method mappings set up in the UI
9192
+ */
9193
+ shop_shipping_method_text?: string;
9194
+ /**
9195
+ * the order shop shipping method price
9196
+ * @format float
9197
+ */
9198
+ shop_shipping_method_price?: number;
9199
+ /** the order billing company */
9200
+ billing_company?: string;
9201
+ /** the order billing street address 1 */
9202
+ billing_address_1?: string;
9203
+ /** the order billing street address 2 */
9204
+ billing_address_2?: string;
9205
+ /** the order billing street address 3 */
9206
+ billing_address_3?: string;
9207
+ /** the order billing city */
9208
+ billing_city?: string;
9209
+ /** the order billing state */
9210
+ billing_state?: string;
9211
+ /** the order billing zip */
9212
+ billing_zip?: string;
9213
+ /** the order billing country */
9214
+ billing_country?: string;
9215
+ /** the order billing phone number */
9216
+ billing_phone?: string;
9217
+ /** do not bill for the order? (staff only) */
9218
+ do_not_bill?: boolean;
9219
+ /** the order billing name */
9220
+ billing_name?: string;
9221
+ /** the first name of the person the order is being shipped to */
9222
+ first_name?: string;
9223
+ /** the last name of the person the order is being shipped to */
9224
+ last_name?: string;
9225
+ /** the full name of the person the order is being shipped to */
9226
+ full_name?: string;
9227
+ /** the order shipping name */
9228
+ shipping_name?: string;
9229
+ /** the order shipping company */
9230
+ shipping_company?: string;
9231
+ /** the order shipping street address 1 */
9232
+ shipping_address_1?: string;
9233
+ /** the order shipping street address 2 */
9234
+ shipping_address_2?: string;
9235
+ /** the order shipping city */
9236
+ shipping_city?: string;
9237
+ /** the order shipping state */
9238
+ shipping_state?: string;
9239
+ /** the order shipping zip */
9240
+ shipping_zip?: string;
9241
+ /** the order shipping country */
9242
+ shipping_country?: string;
9243
+ /** the order shipping country iso2 (US, GB, CA, etc) */
9244
+ shipping_country_iso2?: string;
9245
+ /** the order shipping phone number */
9246
+ shipping_phone?: string;
9247
+ /** the order requested address */
9248
+ requested_address?: string;
9249
+ /** is the order address residential? */
9250
+ residential?: boolean;
9251
+ /** is the order expedited? */
9252
+ expedited?: boolean;
9253
+ /** does the order require a signature upon delivery? */
9254
+ require_signature?: boolean;
9255
+ /** does the order require an adult signature upon delivery? */
9256
+ require_adult_signature?: boolean;
9257
+ /** require a carrier that delivers on Saturdays for this order? */
9258
+ saturday_delivery?: boolean;
9259
+ /** is the order a gift? */
9260
+ gift?: boolean;
9261
+ /** is the order insured? */
9262
+ insure?: boolean;
9263
+ /** does the order contain alcohol? */
9264
+ contains_alcohol?: boolean;
9265
+ /** does the order require customs documents? */
9266
+ customs_required?: boolean;
9267
+ /** carrier facility access point for the address destination */
9268
+ shipping_carrier_facility?: string;
9269
+ /** pickup option for carrier facility on the address destination */
9270
+ shipping_hold_for_pickup?: boolean;
9271
+ /** the order ship notes */
9272
+ ship_notes?: string;
9273
+ /**
9274
+ * the order third party shipping cost
9275
+ * @format float
9276
+ */
9277
+ ship_3rdparty_cost?: number;
9278
+ /** the order third party shipping account */
9279
+ ship_3rdparty_account?: string;
9280
+ /** the order third party shipping zip */
9281
+ ship_3rdparty_zip?: string;
9282
+ /** the order third party shipping country */
9283
+ ship_3rdparty_country?: string;
9284
+ /** the order public note */
9285
+ public_note?: string;
9286
+ /**
9287
+ * the order estimated days in transit (used for release planning)
9288
+ * @format int32
9289
+ */
9290
+ days_in_transit?: number;
9291
+ /**
9292
+ * the order estimated days in transit estimate from the carrier
9293
+ * @format int32
9294
+ */
9295
+ days_in_transit_carrier_estimate?: number;
9296
+ /**
9297
+ * the order requested insurance value
9298
+ * @format float
9299
+ */
9300
+ req_insurance_value?: number;
9301
+ /** packingslip pdf url */
9302
+ cf_packingslip_pdf_url?: string;
9303
+ /** Value Added Tax identifcation number for the sender of the order */
9304
+ customs_vat_number?: string;
9305
+ /** Economic Operators Registration and Identification number for the sender of the order */
9306
+ customs_eori_number?: string;
9307
+ /** Import One-Stop Shop number for the sender of the order */
9308
+ customs_ioss_number?: string;
9309
+ /**
9310
+ * the carrier account id for this package, if it has shipped (staff only)
9311
+ * @format int32
9312
+ */
9313
+ carrier_account_id?: number;
9314
+ /** the order tracking numbers */
9315
+ tracking?: string[];
9316
+ /** the order tracking links */
9317
+ tracking_links?: string[];
9318
+ /**
9319
+ * the order approxiamte delivery date
9320
+ * @format date
9321
+ */
9322
+ approximate_delivery_date?: string;
9323
+ /** is the order a global_e order? */
9324
+ global_e_ge_order?: boolean;
9325
+ /** the orders calculated return time limit */
9326
+ calculated_time_limit?: string;
9327
+ /** is the order within its return time limit */
9328
+ within_return_time_limit?: boolean;
9329
+ /** the order return name */
9330
+ return_name?: string;
9331
+ /** the order return company */
9332
+ return_company?: string;
9333
+ /** the order return street address 1 */
9334
+ return_address_1?: string;
9335
+ /** the order return street address 2 */
9336
+ return_address_2?: string;
9337
+ /** the order return city */
9338
+ return_city?: string;
9339
+ /** the order return state */
9340
+ return_state?: string;
9341
+ /** the order return country */
9342
+ return_country?: string;
9343
+ /** the order return zip */
9344
+ return_zip?: string;
9345
+ /** the order return phone number */
9346
+ return_phone?: string;
9347
+ /** the order return email */
9348
+ return_email?: string;
9349
+ /**
9350
+ * the order return time limit
9351
+ * @format int32
9352
+ */
9353
+ return_time_limit?: number;
9354
+ /** is the order workable? */
9355
+ is_workable?: boolean;
9356
+ /** is the order gestating? */
9357
+ is_gestating?: boolean;
9358
+ /** Permission limited orders are not editable, but still may be processed/shipped */
9359
+ permissions_limited?: boolean;
9360
+ order_items?: string;
9361
+ /** desired incoterm for the order */
9362
+ incoterm?: PostApiV2OrdersBulkIncoterm;
9363
+ /**
9364
+ * the order status: 30 (Shipped Externally), 35 (Quote), 40 (Cancelled), 45 (Closed by Originator), 50 (Unpaid), 75 (Pending Return), 77 (Return Verified), 80 (Pre-Order), 90 (Paused), 95 (Insufficient Inventory), 100 (Processing), 120 (Printed), 150 (Picked), 155 (Prepacking in Progress), 160 (Packed), 200 (Label Scheduled for Purchase), 250 (Label Purchased), 300 (Shipped), 325 (Picked Up), 350 (Delivered), 375 (Return Expired), 380 (Replacement Cancelled), 400 (Returned Undeliverable), 410 (Replacement Requested), 430 (Exchanged), 450 (Refund Requested)
9365
+ * @format int32
9366
+ */
9367
+ status?: PostApiV2OrdersBulkStatus;
9368
+ order_items_attributes?: {
9369
+ /**
9370
+ * number of this item in Order
9371
+ * @format int32
9372
+ */
9373
+ quantity?: number;
9374
+ /**
9375
+ * the order item order id
9376
+ * @format int32
9377
+ */
9378
+ order_id?: number;
9379
+ /**
9380
+ * the order item customer id
9381
+ * @format int32
9382
+ */
9383
+ customer_id?: number;
9384
+ /**
9385
+ * the order item item id
9386
+ * @format int32
9387
+ */
9388
+ item_id?: number;
9389
+ /** the SKU of this item */
9390
+ sku?: string;
9391
+ /** description for this order item. This will appear in packing slips. If not set, the description will be inherited from the parent Item. */
9392
+ description?: string;
9393
+ /**
9394
+ * price of this item
9395
+ * @format float
9396
+ */
9397
+ price?: number;
9398
+ /** is this item unshippable? */
9399
+ unshippable?: boolean;
9400
+ /** is this item available? */
9401
+ available?: boolean;
9402
+ /**
9403
+ * number of items packed
9404
+ * @format int32
9405
+ */
9406
+ packed?: number;
9407
+ /** is this item packaging? */
9408
+ packaging?: boolean;
9409
+ /**
9410
+ * wholesale cost of the item
9411
+ * @format float
9412
+ */
9413
+ wholesale_cost?: number;
9414
+ /** is this item a bundle? */
9415
+ is_bundle?: boolean;
9416
+ /**
9417
+ * retail fee of this item
9418
+ * @format float
9419
+ */
9420
+ retail_fee?: number;
9421
+ /** is this item a promo? */
9422
+ promo?: boolean;
9423
+ /** is this item returnable? */
9424
+ returnable?: boolean;
9425
+ /** currency code for this item */
9426
+ currency?: string;
9427
+ /**
9428
+ * wholesale fee of this item
9429
+ * @format float
9430
+ */
9431
+ wholesale_fee?: number;
9432
+ /** (deprecated) is the order item hazmat? */
9433
+ hazmat?: boolean;
9434
+ /** miscellaneous information about the order item */
9435
+ misc?: string;
9436
+ /** does the item require a serial number when shipping? */
9437
+ request_serial_number?: boolean;
9438
+ /** The original id of the order item */
9439
+ originator_id?: string;
9440
+ /** The original id of the item */
9441
+ item_originator_id?: string;
9442
+ originator_attributes?: {
9443
+ /** the originator original id (from the provider) */
9444
+ original_id?: string;
9445
+ /** the originator group id */
9446
+ group_id?: string;
9447
+ /** miscellaneous info for the originator */
9448
+ misc?: string;
9449
+ };
9450
+ }[];
9451
+ originator_attributes?: {
9452
+ /** the originator original id (from the provider) */
9453
+ original_id?: string;
9454
+ /** the originator group id */
9455
+ group_id?: string;
9456
+ /** miscellaneous info for the originator */
9457
+ misc?: string;
9458
+ };
9459
+ /** Hash of key value pairs (must conform to available meta keys) */
9460
+ meta_fields?: {
9461
+ /** Hash of key/value pairs */
9462
+ fields?: object;
9463
+ /** Included meta fields for associations */
9464
+ association_fields?: object;
9465
+ };
9466
+ }[];
9467
+ }
9468
+
9469
+ /** desired incoterm for the order */
9470
+ export enum PostApiV2OrdersBulkIncoterm {
9471
+ EXW = "EXW",
9472
+ FCA = "FCA",
9473
+ CPT = "CPT",
9474
+ CIP = "CIP",
9475
+ DAT = "DAT",
9476
+ DAP = "DAP",
9477
+ DDP = "DDP",
9478
+ FAS = "FAS",
9479
+ FOB = "FOB",
9480
+ CFR = "CFR",
9481
+ CIF = "CIF",
9482
+ DAF = "DAF",
9483
+ DES = "DES",
9484
+ DEQ = "DEQ",
9485
+ DDU = "DDU",
9486
+ }
9487
+
9488
+ /** the order type */
9489
+ export enum PostApiV2OrdersBulkOrderType {
9490
+ DirectToConsumer = "direct_to_consumer",
9491
+ Dropship = "dropship",
9492
+ Retail = "retail",
9493
+ Transfer = "transfer",
9494
+ Wholesale = "wholesale",
9495
+ }
9496
+
9497
+ /**
9498
+ * the order status: 30 (Shipped Externally), 35 (Quote), 40 (Cancelled), 45 (Closed by Originator), 50 (Unpaid), 75 (Pending Return), 77 (Return Verified), 80 (Pre-Order), 90 (Paused), 95 (Insufficient Inventory), 100 (Processing), 120 (Printed), 150 (Picked), 155 (Prepacking in Progress), 160 (Packed), 200 (Label Scheduled for Purchase), 250 (Label Purchased), 300 (Shipped), 325 (Picked Up), 350 (Delivered), 375 (Return Expired), 380 (Replacement Cancelled), 400 (Returned Undeliverable), 410 (Replacement Requested), 430 (Exchanged), 450 (Refund Requested)
9499
+ * @format int32
9500
+ */
9501
+ export enum PostApiV2OrdersBulkStatus {
9502
+ Value30 = 30,
9503
+ Value35 = 35,
9504
+ }
9505
+
8247
9506
  /** Create an order document for an order */
8248
9507
  export interface PostApiV2OrdersIdOrderDocuments {
8249
9508
  /**
@@ -8556,6 +9815,185 @@ export interface PostApiV2Shipnotices {
8556
9815
  warehouse_id: number;
8557
9816
  }
8558
9817
 
9818
+ /** Create shipnotices in bulk */
9819
+ export interface PostApiV2ShipnoticesBulk {
9820
+ /** An array of shipnotice objects to create in bulk */
9821
+ resources: {
9822
+ /** the shipnotice sender */
9823
+ sender: string;
9824
+ /**
9825
+ * the shipnotice estimated arrival date
9826
+ * @format date-time
9827
+ */
9828
+ eta: string;
9829
+ /**
9830
+ * the shipnotice warehouse id
9831
+ * @format int32
9832
+ */
9833
+ warehouse_id: number;
9834
+ /**
9835
+ * status of the shipnotice
9836
+ * @format int32
9837
+ */
9838
+ status?: number;
9839
+ /** the shipnotice status name */
9840
+ status_name?: string;
9841
+ /** the name of the person who received the shipnotice */
9842
+ received_by?: string;
9843
+ /** notes by whiplash */
9844
+ notes_by_whiplash?: string;
9845
+ /** notes by customer */
9846
+ notes_by_customer?: string;
9847
+ /**
9848
+ * total number of boxes in the shipnotice
9849
+ * @format int32
9850
+ */
9851
+ total_boxes?: number;
9852
+ /**
9853
+ * the shipnotice arrival date and time
9854
+ * @format date-time
9855
+ */
9856
+ arrived_at?: string;
9857
+ /** allow skipping of images for this shipnotice? */
9858
+ skip_images?: boolean;
9859
+ /** the ID of the easypost shipment or tracker */
9860
+ easypostable_id?: string;
9861
+ /** the type of the easypost object (shipment or tracker) */
9862
+ easypostable_type?: string;
9863
+ /** url of the shipping label */
9864
+ shipping_label_url?: string;
9865
+ /**
9866
+ * the shipnotice actual cost of shipping
9867
+ * @format float
9868
+ */
9869
+ ship_actual_cost?: number;
9870
+ /** the method of shipping for the shipnotice */
9871
+ shipping_method_text?: string;
9872
+ /** shipping carrier */
9873
+ carrier?: string;
9874
+ /**
9875
+ * shipping method id
9876
+ * @format int32
9877
+ */
9878
+ shipping_method_id?: number;
9879
+ /** the tracking number of the shipnotice */
9880
+ tracking?: string;
9881
+ /**
9882
+ * the order_id of the shipnotice
9883
+ * @format int32
9884
+ */
9885
+ order_id?: number;
9886
+ /** shipnotice type (Shipnotice, ConsumerReturn) */
9887
+ type?: string;
9888
+ /** was postage billed? */
9889
+ postage_billed?: boolean;
9890
+ /** was handling billed? */
9891
+ handling_billed?: boolean;
9892
+ /**
9893
+ * 3rd party cost for the shipnotice
9894
+ * @format float
9895
+ */
9896
+ ship_3rdparty_cost?: number;
9897
+ /** does this shipnotice require a label? */
9898
+ requires_label?: boolean;
9899
+ /**
9900
+ * the shipnotice completion date and time
9901
+ * @format date-time
9902
+ */
9903
+ completed_at?: string;
9904
+ /**
9905
+ * the shipnotice must be completed by date and time
9906
+ * @format date-time
9907
+ */
9908
+ complete_by?: string;
9909
+ /** currency used for this shipnotice */
9910
+ ship_actual_currency?: string;
9911
+ /**
9912
+ * date when was the shipnoticed delivered
9913
+ * @format date-time
9914
+ */
9915
+ delivered_at?: string;
9916
+ /**
9917
+ * date when the shipnotice is due to be delivered
9918
+ * @format date-time
9919
+ */
9920
+ due_at?: string;
9921
+ /** meta data for this shipnotice as stringified JSON */
9922
+ meta_data?: string;
9923
+ /** purchase order number or other human readable token to another system */
9924
+ reference?: string;
9925
+ /**
9926
+ * number of line items in this Ship Notice
9927
+ * @format int32
9928
+ */
9929
+ shipnotice_item_count?: number;
9930
+ /**
9931
+ * number of unique items in this Ship Notice
9932
+ * @format int32
9933
+ */
9934
+ shipnotice_item_sku_count?: number;
9935
+ /**
9936
+ * quantity of all the line items in this Ship Notice
9937
+ * @format int32
9938
+ */
9939
+ shipnotice_item_quantity?: number;
9940
+ /** purchase order numbers associated with this Ship Notice */
9941
+ purchase_order_numbers?: string[];
9942
+ /** JSON object of required and optional receiving quantities verified by staff */
9943
+ quantities_verified?: object;
9944
+ /** is inspection required? (default: false) */
9945
+ inspection_required?: boolean;
9946
+ shipnotice_items_attributes?: {
9947
+ /**
9948
+ * the number of this shipnotice item in the shipnotice
9949
+ * @format int32
9950
+ */
9951
+ quantity: number;
9952
+ /**
9953
+ * the shipnotice item item id
9954
+ * @format int32
9955
+ */
9956
+ item_id?: number;
9957
+ /** The original id of the item */
9958
+ item_originator_id?: string;
9959
+ /** The purchase order number */
9960
+ purchase_order_number?: string;
9961
+ originator_attributes?: {
9962
+ /** the originator original id (from the provider) */
9963
+ original_id?: string;
9964
+ /** the originator group id */
9965
+ group_id?: string;
9966
+ /** miscellaneous info for the originator */
9967
+ misc?: string;
9968
+ };
9969
+ lot_attributes?: {
9970
+ /** The lot number of the item. */
9971
+ number: string;
9972
+ /**
9973
+ * The lot expiration date.
9974
+ * @format date-time
9975
+ */
9976
+ expires_on: string;
9977
+ };
9978
+ }[];
9979
+ originator_attributes?: {
9980
+ /** the originator original id (from the provider) */
9981
+ original_id?: string;
9982
+ /** the originator group id */
9983
+ group_id?: string;
9984
+ /** miscellaneous info for the originator */
9985
+ misc?: string;
9986
+ };
9987
+ /** Hash of key value pairs (must conform to available meta keys) */
9988
+ meta_fields?: {
9989
+ /** Hash of key/value pairs */
9990
+ fields?: object;
9991
+ /** Included meta fields for associations */
9992
+ association_fields?: object;
9993
+ };
9994
+ }[];
9995
+ }
9996
+
8559
9997
  /** create a shipnotice item */
8560
9998
  export interface PostApiV2ShipnoticesIdShipnoticeItems {
8561
9999
  /** description of the item */
@@ -10179,6 +11617,11 @@ export interface PutApiV21Orders {
10179
11617
  order_orig?: string;
10180
11618
  /** the order type */
10181
11619
  order_type?: string;
11620
+ /**
11621
+ * User-defined reference for shipping labels on packages.
11622
+ * Note: this field has a limit of 35 chars.
11623
+ */
11624
+ package_label_reference?: string;
10182
11625
  /** url for this orders packing slip */
10183
11626
  packingslip_pdf_url?: string;
10184
11627
  /** Permission limited orders are not editable, but still may be processed/shipped */
@@ -10446,6 +11889,11 @@ export interface PutApiV21OrdersOriginator {
10446
11889
  order_orig?: string;
10447
11890
  /** the order type */
10448
11891
  order_type?: string;
11892
+ /**
11893
+ * User-defined reference for shipping labels on packages.
11894
+ * Note: this field has a limit of 35 chars.
11895
+ */
11896
+ package_label_reference?: string;
10449
11897
  /** url for this orders packing slip */
10450
11898
  packingslip_pdf_url?: string;
10451
11899
  /** Permission limited orders are not editable, but still may be processed/shipped */
@@ -12415,6 +13863,11 @@ export interface PutApiV2Orders {
12415
13863
  order_orig?: string;
12416
13864
  /** the order type */
12417
13865
  order_type?: string;
13866
+ /**
13867
+ * User-defined reference for shipping labels on packages.
13868
+ * Note: this field has a limit of 35 chars.
13869
+ */
13870
+ package_label_reference?: string;
12418
13871
  /** url for this orders packing slip */
12419
13872
  packingslip_pdf_url?: string;
12420
13873
  /** Permission limited orders are not editable, but still may be processed/shipped */
@@ -12680,6 +14133,11 @@ export interface PutApiV2OrdersOriginator {
12680
14133
  order_orig?: string;
12681
14134
  /** the order type */
12682
14135
  order_type?: string;
14136
+ /**
14137
+ * User-defined reference for shipping labels on packages.
14138
+ * Note: this field has a limit of 35 chars.
14139
+ */
14140
+ package_label_reference?: string;
12683
14141
  /** url for this orders packing slip */
12684
14142
  packingslip_pdf_url?: string;
12685
14143
  /** Permission limited orders are not editable, but still may be processed/shipped */