@wix/auto_sdk_ecom_delivery-profile 1.0.242 → 1.0.243

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.
@@ -2,127 +2,143 @@ import { CreateDeliveryProfileRequest as CreateDeliveryProfileRequest$1, CreateD
2
2
  import '@wix/sdk-types';
3
3
 
4
4
  /**
5
- * A DeliveryProfile is a collection of delivery configurations that define shipping options for products.
6
- * Each profile contains delivery regions, which specify where products can be shipped and which carriers can deliver
7
- * to those destinations. Use delivery profiles to organize and manage different shipping strategies for your store.
5
+ * A delivery profile is a collection of delivery regions that define shipping options for products.
6
+ * Each profile contains delivery regions, which specify where products can be shipped and which carriers can deliver to those destinations.
8
7
  */
9
8
  interface DeliveryProfile {
10
9
  /**
11
- * DeliveryProfile ID.
10
+ * Delivery profile ID.
12
11
  * @format GUID
13
12
  * @readonly
14
13
  */
15
14
  id?: string | null;
16
15
  /**
17
- * DeliveryProfile name.
16
+ * Delivery profile name.
18
17
  * @minLength 1
19
18
  * @maxLength 256
20
19
  */
21
20
  name?: string | null;
22
21
  /**
23
- * Indicates whether this is the default DeliveryProfile.
24
- * The first delivery profile is automatically created and marked as default when the Wix Stores app is installed.
25
- * Default status cannot be changed or transferred to another profile.
26
- * The default profile cannot be deleted because every site requires one for core delivery functionality.
22
+ * Whether this is the default delivery profile.
23
+ *
24
+ * > **Notes:**
25
+ * >
26
+ * > - The first delivery profile is automatically created and marked as default when the Wix Stores, Wix Bookings, Wix Events, or Wix Restaurants business solutions are installed on a site.
27
+ * > - Default status can't be changed or transferred to another profile.
28
+ * > - The default profile can't be deleted because every site requires one for core delivery functionality.
27
29
  * @readonly
28
30
  */
29
31
  default?: boolean | null;
30
32
  /**
31
- * A list of DeliveryProfile regions.
33
+ * Delivery regions in this profile.
32
34
  * @maxSize 100
33
35
  */
34
36
  deliveryRegions?: DeliveryRegion[];
35
37
  /**
36
38
  * Information about who created the delivery profile.
37
- * Contains either an app ID (for profiles created by apps) or a user ID (for profiles created by site users).
39
+ *
40
+ * Currently only for use with Wix Restaurants.
38
41
  */
39
42
  createdBy?: CreatedBy;
40
43
  /**
41
- * DeliveryProfile revision.
44
+ * Revision number, which increments by 1 each time the delivery profile is updated. To prevent conflicting changes, the current revision must be passed when updating the delivery profile. Ignored when creating a delivery profile.
42
45
  * @readonly
43
46
  */
44
47
  revision?: string | null;
45
48
  /**
46
- * Date and time the DeliveryProfile was created.
49
+ * Date and time the delivery profile was created.
47
50
  * @readonly
48
51
  */
49
52
  createdDate?: Date | null;
50
53
  /**
51
- * Date and time the DeliveryProfile was last updated.
54
+ * Date and time the delivery profile was last updated.
52
55
  * @readonly
53
56
  */
54
57
  updatedDate?: Date | null;
55
- /** [Extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields ) must be configured in the app dashboard before they can be accessed with API calls. */
58
+ /** Custom field data for the delivery profile object. [Extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields) must be configured in the app dashboard before they can be accessed with API calls. */
56
59
  extendedFields?: ExtendedFields;
57
60
  }
58
61
  /**
59
- * A DeliveryRegion defines a geographic area and its associated delivery carriers.
60
- * Each region specifies destinations (countries and subdivisions) where products
61
- * can be shipped and the carriers available for those deliveries.
62
+ * A delivery region defines a geographic area and its associated delivery carriers.
63
+ * Each region specifies destinations (countries and subdivisions) where products can be shipped and the carriers available for those deliveries.
64
+ *
65
+ * During the eCommerce onboarding flow, an "International" region with empty destinations is automatically created. This serves as a "Rest of World" configuration that applies to destinations not explicitly defined in other regions.
62
66
  */
63
67
  interface DeliveryRegion {
64
68
  /**
65
- * The delivery region id.
69
+ * Delivery region ID.
66
70
  * @format GUID
67
71
  * @readonly
68
72
  */
69
73
  id?: string | null;
70
74
  /**
71
- * Optional name of the region, for example: "Domestic".
75
+ * Delivery region name. For example, `"Domestic"` or `"International"`.
72
76
  * @minLength 1
73
77
  * @maxLength 256
74
78
  */
75
79
  name?: string | null;
76
- /** Indicates that this delivery region is active, default value is true. */
80
+ /**
81
+ * Whether this delivery region is active and available during checkout.
82
+ *
83
+ * Default: `true`
84
+ */
77
85
  active?: boolean | null;
78
86
  /**
79
- * The spi implementers id of shipping-rates spi, assigned to this delivery region.
87
+ * Delivery carriers assigned to this region. Carriers are managed using the Add Delivery Carrier, Update Delivery Carrier, and Remove Delivery Carrier methods.
80
88
  * @maxSize 25
81
89
  * @readonly
82
90
  */
83
91
  deliveryCarriers?: DeliveryCarrier[];
84
92
  /**
85
- * The operation region of this delivery region, if empty than it is global.
93
+ * Geographic destinations covered by this region. If empty, the region applies globally.
86
94
  * @maxSize 250
87
95
  */
88
96
  destinations?: Destination[];
89
97
  /**
90
- * Represents the time this Profile was created
98
+ * Date and time the delivery region was created.
91
99
  * @readonly
92
100
  */
93
101
  createdDate?: Date | null;
94
102
  }
95
103
  interface DeliveryCarrier {
96
104
  /**
97
- * ID of the app providing the content.
98
- *
99
- * You can get your app's ID from its page in the [app dashboard](https://dev.wix.com/dc3/my-apps/).
105
+ * Carrier app ID.
100
106
  *
101
- * Can be fetched by ListDeliveryCarriers api.
107
+ * Get app IDs from the [app dashboard](https://dev.wix.com/dc3/my-apps/), or by calling [List Installed Delivery Carriers](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/delivery-profiles/list-installed-delivery-carriers).
102
108
  * @format GUID
103
109
  */
104
110
  appId?: string;
105
- /** Backup rate to be used in case the cost returned by the provider is empty. */
111
+ /**
112
+ * Backup rate to use when the carrier doesn't return a rate for a specific shipping option.
113
+ *
114
+ * When `active` is `false` and the carrier doesn't return a rate, the carrier's shipping options aren't shown to customers.
115
+ */
106
116
  backupRate?: BackupRate;
107
117
  /**
108
- * Additional charges to add to the delivery rate for this carrier
118
+ * Additional charges to add to the delivery rate. These charges are combined with the carrier's rate into a single shipping cost and itemized in order details.
109
119
  * @maxSize 10
110
120
  */
111
121
  additionalCharges?: AdditionalCharge[];
112
122
  }
113
123
  interface BackupRate {
114
124
  /**
115
- * Default rate title that will concatenate to the delivery options the provider will offer.
125
+ * Title displayed for the backup rate. For example, `"Standard Shipping"`.
116
126
  * @minLength 1
117
127
  * @maxLength 32
118
128
  */
119
129
  title?: string | null;
120
130
  /**
121
- * Default amount price for all delivery options that the provider will offer.
131
+ * Backup rate amount.
122
132
  * @decimalValue options { gte:0, maxScale:6 }
123
133
  */
124
134
  amount?: string | null;
125
- /** Should the default rate be used. Default value is false. */
135
+ /**
136
+ * Whether the backup rate is active.
137
+ *
138
+ * When `false`, if the carrier doesn't return a rate, the carrier's shipping options aren't shown to customers.
139
+ *
140
+ * Default: `false`
141
+ */
126
142
  active?: boolean;
127
143
  }
128
144
  interface AdditionalCharge {
@@ -132,21 +148,20 @@ interface AdditionalCharge {
132
148
  */
133
149
  description?: string | null;
134
150
  /**
135
- * Cost of additional charge. For example, `12.5`.
151
+ * Charge amount. For example, `"12.5"`.
136
152
  * @maxLength 16
137
153
  */
138
154
  amount?: string;
139
155
  }
140
- /** Defines the area inside one country that is relevant for this delivery region. */
156
+ /** Geographic destination for a delivery region. */
141
157
  interface Destination {
142
158
  /**
143
- * 2-letters code represents the country of the delivery destinations
159
+ * 2-letter country code in [ISO-3166 alpha-2](https://www.iso.org/obp/ui/#search/code/) format.
144
160
  * @format COUNTRY
145
161
  */
146
162
  countryCode?: string;
147
163
  /**
148
- * subdivisions - Usually a state, region, prefecture, or province code, according to [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2).
149
- * If empty, the delivery region applies to the entire country.
164
+ * Subdivision codes in [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) format. For example, `"US-CA"` for California. If empty, the delivery region applies to the entire country.
150
165
  * @maxSize 100
151
166
  * @minLength 1
152
167
  * @maxLength 256
@@ -155,12 +170,12 @@ interface Destination {
155
170
  }
156
171
  interface CreatedBy extends CreatedByIdOneOf {
157
172
  /**
158
- * App ID - when the delivery profile was created by an external application or Wix service.
173
+ * App ID, when the delivery profile was created by an external application or Wix service.
159
174
  * @format GUID
160
175
  */
161
176
  appId?: string | null;
162
177
  /**
163
- * User ID - when the delivery profile was created by a Wix user.
178
+ * Wix user ID, when the delivery profile was created by a Wix user.
164
179
  * @format GUID
165
180
  */
166
181
  userId?: string | null;
@@ -168,12 +183,12 @@ interface CreatedBy extends CreatedByIdOneOf {
168
183
  /** @oneof */
169
184
  interface CreatedByIdOneOf {
170
185
  /**
171
- * App ID - when the delivery profile was created by an external application or Wix service.
186
+ * App ID, when the delivery profile was created by an external application or Wix service.
172
187
  * @format GUID
173
188
  */
174
189
  appId?: string | null;
175
190
  /**
176
- * User ID - when the delivery profile was created by a Wix user.
191
+ * Wix user ID, when the delivery profile was created by a Wix user.
177
192
  * @format GUID
178
193
  */
179
194
  userId?: string | null;
@@ -189,122 +204,125 @@ interface ExtendedFields {
189
204
  */
190
205
  namespaces?: Record<string, Record<string, any>>;
191
206
  }
207
+ /** Event payload for when a delivery region is added to a delivery profile. */
192
208
  interface DeliveryRegionAdded {
193
209
  /**
194
- * The DeliveryProfile owns this region.
210
+ * ID of the delivery profile containing the region.
195
211
  * @format GUID
196
212
  */
197
213
  deliveryProfileId?: string;
198
214
  /**
199
- * The delivery region id.
215
+ * ID of the added delivery region.
200
216
  * @format GUID
201
217
  * @readonly
202
218
  */
203
219
  deliveryRegionId?: string | null;
204
220
  /**
205
- * Optional name of the delivery region, for example: "Domestic".
221
+ * Delivery region name. For example, `"Domestic"`.
206
222
  * @minLength 1
207
223
  * @maxLength 256
208
224
  */
209
225
  name?: string | null;
210
- /** Indicates that this delivery region is active, default value is true. */
226
+ /** Whether the delivery region is active. */
211
227
  active?: boolean | null;
212
228
  /**
213
- * The spi implementers id of shipping-rates spi, assigned to this delivery region.
229
+ * Delivery carriers assigned to this region.
214
230
  * @maxSize 25
215
231
  * @readonly
216
232
  */
217
233
  deliveryCarriers?: DeliveryCarrier[];
218
234
  /**
219
- * The operation region of this delivery region, if empty than it is global.
235
+ * Geographic destinations covered by this region.
220
236
  * @maxSize 200
221
237
  */
222
238
  destinations?: Destination[];
223
239
  /**
224
- * Represents the time this Profile was created
240
+ * Date and time the delivery region was created.
225
241
  * @readonly
226
242
  */
227
243
  createdDate?: Date | null;
228
244
  }
245
+ /** Event payload for when a delivery region is removed from a delivery profile. */
229
246
  interface DeliveryRegionRemoved {
230
247
  /**
231
- * The DeliveryProfile owns this region.
248
+ * ID of the delivery profile that contained the region.
232
249
  * @format GUID
233
250
  */
234
251
  deliveryProfileId?: string;
235
252
  /**
236
- * The removed DeliveryRegion id.
253
+ * ID of the removed delivery region.
237
254
  * @format GUID
238
255
  */
239
256
  deliveryRegionId?: string;
240
257
  }
258
+ /** Event payload for when a delivery region is updated. */
241
259
  interface DeliveryRegionUpdated {
242
260
  /**
243
- * The DeliveryProfile owns this DeliveryRegion.
261
+ * ID of the delivery profile containing the region.
244
262
  * @format GUID
245
263
  */
246
264
  deliveryProfileId?: string;
247
265
  /**
248
- * The delivery region id.
266
+ * ID of the updated delivery region.
249
267
  * @format GUID
250
268
  * @readonly
251
269
  */
252
270
  deliveryRegionId?: string | null;
253
271
  /**
254
- * Optional name of the delivery region, for example: "Domestic".
272
+ * Delivery region name. For example, `"Domestic"`.
255
273
  * @minLength 1
256
274
  * @maxLength 256
257
275
  */
258
276
  name?: string | null;
259
- /** Indicates that this delivery region is active, default value is true. */
277
+ /** Whether the delivery region is active. */
260
278
  active?: boolean | null;
261
279
  /**
262
- * The spi implementers id of shipping-rates spi, assigned to this delivery region.
280
+ * Delivery carriers assigned to this region.
263
281
  * @maxSize 25
264
282
  * @readonly
265
283
  */
266
284
  deliveryCarriers?: DeliveryCarrier[];
267
285
  /**
268
- * The operation region of this delivery region, if empty than it is global.
286
+ * Geographic destinations covered by this region. If empty, the region applies globally.
269
287
  * @maxSize 200
270
288
  */
271
289
  destinations?: Destination[];
272
290
  /**
273
- * Represents the time this Profile was created
291
+ * Date and time the delivery region was created.
274
292
  * @readonly
275
293
  */
276
294
  createdDate?: Date | null;
277
295
  }
278
296
  interface CreateDeliveryProfileRequest {
279
- /** DeliveryProfile to be created. */
297
+ /** Delivery profile to create. */
280
298
  deliveryProfile: DeliveryProfile;
281
299
  }
282
300
  interface CreateDeliveryProfileResponse {
283
- /** The created DeliveryProfile. */
301
+ /** Created delivery profile. */
284
302
  deliveryProfile?: DeliveryProfile;
285
303
  }
286
304
  interface GetDeliveryProfileRequest {
287
305
  /**
288
- * ID of the DeliveryProfile to retrieve.
306
+ * Delivery profile ID.
289
307
  * @format GUID
290
308
  */
291
309
  deliveryProfileId: string;
292
310
  }
293
311
  interface GetDeliveryProfileResponse {
294
- /** The requested DeliveryProfile. */
312
+ /** Retrieved delivery profile. */
295
313
  deliveryProfile?: DeliveryProfile;
296
314
  }
297
315
  interface UpdateDeliveryProfileRequest {
298
- /** DeliveryProfile to be updated, may be partial. */
316
+ /** Delivery profile to update. */
299
317
  deliveryProfile: DeliveryProfile;
300
318
  }
301
319
  interface UpdateDeliveryProfileResponse {
302
- /** Updated DeliveryProfile. */
320
+ /** Updated delivery profile. */
303
321
  deliveryProfile?: DeliveryProfile;
304
322
  }
305
323
  interface DeleteDeliveryProfileRequest {
306
324
  /**
307
- * Id of the DeliveryProfile to delete.
325
+ * Delivery profile ID.
308
326
  * @format GUID
309
327
  */
310
328
  deliveryProfileId: string;
@@ -313,7 +331,7 @@ interface DeleteDeliveryProfileResponse {
313
331
  }
314
332
  interface DeleteDefaultDeliveryProfileRequest {
315
333
  /**
316
- * Id of the DeliveryProfile to delete.
334
+ * Delivery profile ID.
317
335
  * @format GUID
318
336
  */
319
337
  deliveryProfileId?: string;
@@ -321,7 +339,7 @@ interface DeleteDefaultDeliveryProfileRequest {
321
339
  interface DeleteDefaultDeliveryProfileResponse {
322
340
  }
323
341
  interface QueryDeliveryProfilesRequest {
324
- /** WQL expression. */
342
+ /** Query options. */
325
343
  query?: CursorQuery;
326
344
  }
327
345
  interface CursorQuery extends CursorQueryPagingMethodOneOf {
@@ -380,11 +398,11 @@ interface CursorPaging {
380
398
  }
381
399
  interface QueryDeliveryProfilesResponse {
382
400
  /**
383
- * List of DeliveryProfiles.
401
+ * List of delivery profiles.
384
402
  * @maxSize 100
385
403
  */
386
404
  deliveryProfiles?: DeliveryProfile[];
387
- /** Paging metadata */
405
+ /** Paging metadata. */
388
406
  pagingMetadata?: CursorPagingMetadata;
389
407
  }
390
408
  interface CursorPagingMetadata {
@@ -414,176 +432,176 @@ interface Cursors {
414
432
  }
415
433
  interface AddDeliveryRegionRequest {
416
434
  /**
417
- * delivery profile id to associated with the DeliveryRegion
435
+ * Delivery profile ID.
418
436
  * @format GUID
419
437
  */
420
438
  deliveryProfileId: string;
421
- /** DeliveryRegion to be created */
439
+ /** Delivery region to add. */
422
440
  deliveryRegion: DeliveryRegion;
423
441
  /**
424
- * DeliveryProfile revision.
442
+ * Delivery profile revision.
425
443
  * @readonly
426
444
  */
427
445
  revision?: string | null;
428
446
  }
429
447
  interface AddDeliveryRegionResponse {
430
- /** The updated DeliveryProfile with the new DeliveryRegion */
448
+ /** Updated delivery profile with the new delivery region. */
431
449
  deliveryProfile?: DeliveryProfile;
432
450
  }
433
451
  interface UpdateDeliveryRegionRequest {
434
452
  /**
435
- * DeliveryProfile id that owns the DeliveryRegion
453
+ * Delivery profile ID.
436
454
  * @format GUID
437
455
  */
438
456
  deliveryProfileId: string;
439
- /** DeliveryRegion to be updated, may be partial */
457
+ /** Delivery region to update. */
440
458
  deliveryRegion: DeliveryRegion;
441
459
  /**
442
- * DeliveryProfile revision.
460
+ * Delivery profile revision.
443
461
  * @readonly
444
462
  */
445
463
  revision?: string | null;
446
464
  }
447
465
  interface UpdateDeliveryRegionResponse {
448
- /** The updated DeliveryProfile with the updated DeliveryRegion */
466
+ /** Updated delivery profile with the updated delivery region. */
449
467
  deliveryProfile?: DeliveryProfile;
450
468
  }
451
469
  interface GetDeliveryProfileByDeliveryRegionIdRequest {
452
470
  /**
453
- * ID of the DeliveryRegion to retrieve the profile for.
471
+ * Delivery region ID.
454
472
  * @format GUID
455
473
  */
456
474
  deliveryRegionId: string;
457
475
  }
458
476
  interface GetDeliveryProfileByDeliveryRegionIdResponse {
459
- /** The DeliveryProfile containing the requested region. */
477
+ /** Delivery profile containing the requested region. */
460
478
  deliveryProfile?: DeliveryProfile;
461
479
  }
462
480
  interface RemoveDeliveryRegionRequest {
463
481
  /**
464
- * DeliveryProfile id that owns the DeliveryRegion
482
+ * Delivery profile ID.
465
483
  * @format GUID
466
484
  */
467
485
  deliveryProfileId: string;
468
486
  /**
469
- * Id of the DeliveryRegion to delete
487
+ * Delivery region ID.
470
488
  * @format GUID
471
489
  */
472
490
  deliveryRegionId: string;
473
491
  /**
474
- * DeliveryProfile revision.
492
+ * Delivery profile revision.
475
493
  * @readonly
476
494
  */
477
495
  revision?: string | null;
478
496
  }
479
497
  interface RemoveDeliveryRegionResponse {
480
- /** The updated DeliveryProfile without DeliveryRegion */
498
+ /** Updated delivery profile with the delivery region removed. */
481
499
  deliveryProfile?: DeliveryProfile;
482
500
  }
483
501
  interface AddDeliveryCarrierRequest {
484
502
  /**
485
- * delivery_region id to associated with the delivery_carrier.
503
+ * Delivery region ID.
486
504
  * @format GUID
487
505
  */
488
506
  deliveryRegionId: string;
489
- /** delivery_carrier to be added. */
507
+ /** Delivery carrier to add. */
490
508
  deliveryCarrier: DeliveryCarrier;
491
509
  }
492
510
  interface AddDeliveryCarrierResponse {
493
- /** The updated DeliveryProfile */
511
+ /** Updated delivery profile. */
494
512
  deliveryProfile?: DeliveryProfile;
495
513
  }
496
514
  interface RemoveDeliveryCarrierRequest {
497
515
  /**
498
- * Id of the DeliveryRegion
516
+ * Delivery region ID.
499
517
  * @format GUID
500
518
  */
501
519
  deliveryRegionId: string;
502
520
  /**
503
- * DeliveryCarrier app id to be removed.
521
+ * App ID of the delivery carrier to remove.
504
522
  * @format GUID
505
523
  */
506
524
  appId: string;
507
525
  }
508
526
  interface RemoveDeliveryCarrierResponse {
509
- /** The updated DeliveryProfile */
527
+ /** Updated delivery profile. */
510
528
  deliveryProfile?: DeliveryProfile;
511
529
  }
512
530
  interface UpdateDeliveryCarrierRequest {
513
531
  /**
514
- * DeliveryRegion id
532
+ * Delivery region ID.
515
533
  * @format GUID
516
534
  */
517
535
  deliveryRegionId: string;
518
- /** Updated delivery_carrier */
536
+ /** Delivery carrier to update. */
519
537
  deliveryCarrier?: DeliveryCarrier;
520
538
  }
521
539
  interface UpdateDeliveryCarrierResponse {
522
- /** The updated DeliveryProfile with the updated DeliveryCarrier */
540
+ /** Updated delivery profile with the updated delivery carrier. */
523
541
  deliveryProfile?: DeliveryProfile;
524
542
  }
525
543
  interface ListInstalledDeliveryCarriersRequest {
526
544
  }
527
545
  interface ListInstalledDeliveryCarriersResponse {
528
546
  /**
529
- * The list of carrier or multi-carrier services that has implemented the spi and installed on the current context(site)
547
+ * List of installed delivery carriers on the site.
530
548
  * @maxSize 100
531
549
  */
532
550
  installedDeliveryCarriers?: InstalledDeliveryCarrier[];
533
551
  }
534
552
  interface InstalledDeliveryCarrier {
535
553
  /**
536
- * The id of the provider.
554
+ * Carrier app ID.
537
555
  * @format GUID
538
556
  */
539
557
  id?: string;
540
558
  /**
541
- * The name of the Provider.
559
+ * Carrier display name.
542
560
  * @maxLength 256
543
561
  */
544
562
  displayName?: string;
545
563
  /**
546
- * Provider's description.
564
+ * Carrier description.
547
565
  * @maxLength 200
548
566
  */
549
567
  description?: string | null;
550
568
  /**
551
- * A link to learn more about the provider.
569
+ * URL to learn more about the carrier.
552
570
  * @maxLength 200
553
571
  */
554
572
  learnMoreUrl?: string | null;
555
573
  /**
556
- * Dashboard URL for the provider.
574
+ * URL to the carrier's dashboard.
557
575
  * @minLength 1
558
576
  * @maxLength 2048
559
577
  * @format WEB_URL
560
578
  */
561
579
  dashboardUrl?: string | null;
562
- /** If the provider fallback definition is mandatory. */
580
+ /** Whether a backup rate is required for this carrier. */
563
581
  fallbackDefinitionMandatory?: boolean | null;
564
582
  /**
565
- * Thumbnail image for provider.
583
+ * URL for the carrier's thumbnail image.
566
584
  * @format WEB_URL
567
585
  */
568
586
  thumbnailUrl?: string | null;
569
- /** feature toggle initialized with default value = false. should be true if implemented by spi provider */
587
+ /** Whether the carrier supports retrieving carrier settings. */
570
588
  toggleGetCarrierSettingsEnabled?: boolean;
571
589
  }
572
590
  interface ListDeliveryDestinationsRequest {
573
591
  }
574
592
  interface ListDeliveryDestinationsResponse {
575
- /** Scope of destinations, when worldwide is selected, the destinations list will be empty. */
593
+ /** Scope of destinations. When `WORLDWIDE` is selected, the `destinations` list is empty. */
576
594
  destinationScope?: DestinationScopeWithLiterals;
577
595
  /**
578
- * The list of destinations
596
+ * List of configured destinations.
579
597
  * @maxSize 200
580
598
  */
581
599
  destinations?: Destination[];
582
600
  }
583
601
  declare enum DestinationScope {
584
- /** No additional destinations are requested */
602
+ /** Specific destinations are configured. */
585
603
  SPECIFIC_DESTINATIONS = "SPECIFIC_DESTINATIONS",
586
- /** All Destinations */
604
+ /** All destinations worldwide. */
587
605
  WORLDWIDE = "WORLDWIDE"
588
606
  }
589
607
  /** @enumType */
@@ -591,36 +609,36 @@ type DestinationScopeWithLiterals = DestinationScope | 'SPECIFIC_DESTINATIONS' |
591
609
  interface RequiredZipcodeRequest {
592
610
  }
593
611
  interface RequiredZipcodeResponse {
594
- /** If the site requires a zipcode for delivery */
612
+ /** Whether the site requires a postal code for delivery. */
595
613
  requiredZipcode?: boolean;
596
614
  }
597
615
  interface GetDeliveryDestinationPropertiesRequest {
598
616
  }
599
617
  interface GetDeliveryDestinationPropertiesResponse {
600
- /** Delivery destination properties for Rest Of World */
618
+ /** Delivery destination properties for Rest of World. */
601
619
  restOfWorld?: DeliveryDestinationProperties;
602
620
  /**
603
- * List of countries and subdivisions and their delivery destination properties
621
+ * List of countries and their delivery destination properties.
604
622
  * @maxSize 195
605
623
  */
606
624
  countries?: CountryDeliveryProperties[];
607
625
  }
608
626
  interface DeliveryDestinationProperties {
609
- /** True if postal code is required for delivery in this destination */
627
+ /** Whether a postal code is required for delivery to this destination. */
610
628
  postalCodeRequired?: boolean;
611
- /** True if only pickup is available in this destination */
629
+ /** Whether only pickup is available at this destination. */
612
630
  pickupOnly?: boolean;
613
631
  }
614
632
  interface CountryDeliveryProperties {
615
633
  /**
616
- * Two-letter country code in [ISO-3166 alpha-2](https://www.iso.org/obp/ui/#search/code/) format.
634
+ * 2-letter country code in [ISO-3166 alpha-2](https://www.iso.org/obp/ui/#search/code/) format.
617
635
  * @format COUNTRY
618
636
  */
619
637
  country?: string;
620
- /** Delivery destination properties for country */
638
+ /** Delivery destination properties for the country. */
621
639
  deliveryDestinationProperties?: DeliveryDestinationProperties;
622
640
  /**
623
- * List of subdivisions and their delivery destination properties
641
+ * List of subdivisions and their delivery destination properties.
624
642
  * @maxSize 100
625
643
  */
626
644
  subdivisions?: SubdivisionDeliveryProperties[];
@@ -632,17 +650,17 @@ interface SubdivisionDeliveryProperties {
632
650
  * @maxLength 5
633
651
  */
634
652
  subdivision?: string;
635
- /** Delivery destination properties for subdivision */
653
+ /** Delivery destination properties for the subdivision. */
636
654
  deliveryDestinationProperties?: DeliveryDestinationProperties;
637
655
  }
638
656
  interface ListDeliveryCarriersRequest {
639
657
  /**
640
- * Delivery profile id.
658
+ * Delivery profile ID.
641
659
  * @format GUID
642
660
  */
643
661
  deliveryProfileId: string;
644
662
  /**
645
- * Delivery app ids to get settings for.
663
+ * App IDs of the delivery carriers to retrieve settings for.
646
664
  * @format GUID
647
665
  * @minSize 1
648
666
  * @maxSize 25
@@ -651,7 +669,7 @@ interface ListDeliveryCarriersRequest {
651
669
  }
652
670
  interface ListDeliveryCarriersResponse {
653
671
  /**
654
- * The list of delivery settings for the given requests
672
+ * List of delivery carrier results.
655
673
  * @maxSize 100
656
674
  */
657
675
  results?: ListDeliveryCarriersResult[];
@@ -659,12 +677,12 @@ interface ListDeliveryCarriersResponse {
659
677
  bulkActionMetadata?: BulkActionMetadata;
660
678
  }
661
679
  interface ListDeliveryCarriersResult {
662
- /** Information about successful action or error for failure. */
680
+ /** Metadata for the result, including success or error information. */
663
681
  deliveryCarrierMetadata?: ItemMetadata;
664
- /** The delivery carrier details */
682
+ /** Delivery carrier details. */
665
683
  deliveryCarrierDetails?: DeliveryCarrierDetails;
666
684
  /**
667
- * The delivery settings for the delivery profile and delivery region.
685
+ * Regional settings for the delivery carrier.
668
686
  * @minSize 1
669
687
  * @maxSize 5
670
688
  */
@@ -691,52 +709,52 @@ interface ApplicationError {
691
709
  }
692
710
  interface DeliveryCarrierDetails {
693
711
  /**
694
- * The id of the provider.
712
+ * Carrier app ID.
695
713
  * @format GUID
696
714
  */
697
715
  id?: string;
698
716
  /**
699
- * The name of the Provider.
717
+ * Carrier display name.
700
718
  * @maxLength 256
701
719
  */
702
720
  displayName?: string;
703
721
  /**
704
- * Provider's description.
722
+ * Carrier description.
705
723
  * @maxLength 200
706
724
  */
707
725
  description?: string | null;
708
726
  /**
709
- * A link to learn more about the provider.
727
+ * URL to learn more about the carrier.
710
728
  * @maxLength 200
711
729
  */
712
730
  learnMoreUrl?: string | null;
713
731
  /**
714
- * Dashboard URL for the provider.
732
+ * URL to the carrier's dashboard.
715
733
  * @minLength 1
716
734
  * @maxLength 2048
717
735
  * @format WEB_URL
718
736
  */
719
737
  dashboardUrl?: string | null;
720
- /** If the provider fallback definition is mandatory. */
738
+ /** Whether a backup rate is required for this carrier. */
721
739
  fallbackDefinitionMandatory?: boolean | null;
722
740
  /**
723
- * Thumbnail image for provider.
741
+ * URL for the carrier's thumbnail image.
724
742
  * @format WEB_URL
725
743
  */
726
744
  thumbnailUrl?: string | null;
727
- /** feature toggle initialized with default value = false. should be true if implemented by spi provider */
745
+ /** Whether the carrier supports retrieving carrier settings. */
728
746
  toggleGetCarrierSettingsEnabled?: boolean;
729
- /** feature toggle initialized with default value = false. should be true if implemented by spi provider */
747
+ /** Whether the carrier supports updating carrier active status. */
730
748
  toggleUpdateCarrierActiveStatusEnabled?: boolean;
731
749
  }
732
750
  interface DeliveryCarrierRegionalSettings {
733
751
  /**
734
- * The delivery rule id.
752
+ * Delivery region ID.
735
753
  * @format GUID
736
754
  */
737
755
  deliveryRegionId?: string;
738
756
  /**
739
- * The shipping table values that are associated with the delivery rule. Can be multiple if the provider is an aggregator of multiple carriers.
757
+ * Dashboard tables with shipping configuration for this region. Multiple tables can exist if the carrier is an aggregator of multiple services.
740
758
  * @minSize 1
741
759
  * @maxSize 5
742
760
  */
@@ -744,45 +762,42 @@ interface DeliveryCarrierRegionalSettings {
744
762
  }
745
763
  interface DashboardTable {
746
764
  /**
747
- * The title of the delivery settings that will be displayed in the UI.
765
+ * Table title.
748
766
  * @maxLength 256
749
767
  */
750
768
  title?: string;
751
769
  /**
752
- * The columns of the delivery settings that will be displayed in the UI.
770
+ * Table columns.
753
771
  * @maxSize 200
754
772
  */
755
773
  columns?: Column[];
756
774
  /**
757
- * The content of the delivery settings. Each row is a map of column name to value.
775
+ * Table rows containing the configuration data.
758
776
  * @maxSize 25
759
777
  */
760
778
  rows?: Row[];
761
779
  }
762
780
  interface Column {
763
781
  /**
764
- * The name of the column. This is used to get the data from the row.
782
+ * Column key, used to retrieve data from rows.
765
783
  * @maxLength 256
766
784
  */
767
785
  key?: string;
768
786
  /**
769
- * The title of the column that will be displayed in the UI.
787
+ * Column display name.
770
788
  * @maxLength 256
771
789
  */
772
790
  name?: string;
773
791
  }
774
792
  interface Row {
775
793
  /**
776
- * The external key of the data presented in a row. This is used to identify the row in the UI for editing.
794
+ * Unique row identifier, used to identify the row for editing.
777
795
  * @maxLength 256
778
796
  */
779
797
  key?: string;
780
- /**
781
- * The data presented in the row. The key is the column `name` and the value is the data in the specific row and column.
782
- * Data will be in JSON format.
783
- */
798
+ /** Row data as a JSON object. Each key corresponds to a column key. */
784
799
  data?: Record<string, any> | null;
785
- /** The configuration's status of the current row. */
800
+ /** Whether this row's configuration is active. */
786
801
  active?: boolean;
787
802
  }
788
803
  interface BulkActionMetadata {
@@ -795,16 +810,16 @@ interface BulkActionMetadata {
795
810
  }
796
811
  interface UpdateCarrierSettingsRequest {
797
812
  /**
798
- * Carrier id.
813
+ * Carrier app ID.
799
814
  * @format GUID
800
815
  */
801
816
  carrierId: string;
802
817
  /**
803
- * Row id triggered the change
818
+ * ID of the dashboard table row that triggered the change.
804
819
  * @format GUID
805
820
  */
806
821
  rowId: string;
807
- /** New status */
822
+ /** New active status. */
808
823
  active: boolean | null;
809
824
  }
810
825
  interface UpdateCarrierSettingsResponse {
@@ -834,7 +849,7 @@ interface UpdateExtendedFieldsRequest {
834
849
  namespaceData: Record<string, any> | null;
835
850
  }
836
851
  interface UpdateExtendedFieldsResponse {
837
- /** Updated DeliveryProfile. */
852
+ /** Updated delivery profile. */
838
853
  deliveryProfile?: DeliveryProfile;
839
854
  }
840
855
  interface MetaSiteSpecialEvent extends MetaSiteSpecialEventPayloadOneOf {