import * as _wix_sdk_types from '@wix/sdk-types'; import { QuerySpec, Query, NonNullablePaths } from '@wix/sdk-types'; interface ShippoConfiguration { /** * ShippoConfiguration ID. * @format GUID * @readonly */ _id?: string | null; /** @readonly */ revision?: string | null; /** * Date and time the ShippoConfiguration was created. * @readonly */ _createdDate?: Date | null; /** * Date and time the ShippoConfiguration was last updated. * @readonly */ _updatedDate?: Date | null; /** * Associated delivery region ID. * @format GUID * @immutable * @deprecated Associated delivery region ID. * @replacedBy delivery_region_ids * @targetRemovalDate 2025-06-01 */ deliveryRegionId?: string | null; /** * Settings of USPS domestic services. * @maxSize 3 */ domesticServices?: DomesticServiceSettings[]; /** * Settings of USPS international services. * @maxSize 3 */ internationalServices?: InternationalServiceSettings[]; /** Package type. */ packageType?: PackageTypeWithLiterals; /** Package details. */ packageDetails?: PackageDetails; /** * Location ID from OS location service. * @format GUID */ osLocationId?: string | null; /** * Ship from address materialized from OS location. * @readonly */ shipFromAddress?: Address; /** * This shippo configuration is active for the following delivery regions. * @maxSize 50 * @format GUID * @immutable */ deliveryRegionIds?: string[]; /** * Backup weight. * @decimalValue options { gte:0, maxScale:5 } */ backupWeight?: string | null; /** Data extensions. */ extendedFields?: ExtendedFields; } interface DomesticServiceSettings { /** * DomesticServiceSettings ID. * @format GUID */ _id?: string | null; /** USPS domestic service. */ service?: DomesticServiceWithLiterals; /** Service settings. */ serviceSettings?: ServiceSettings; } declare enum DomesticService { GROUND_ADVANTAGE = "GROUND_ADVANTAGE", PRIORITY_MAIL = "PRIORITY_MAIL", PRIORITY_MAIL_EXPRESS = "PRIORITY_MAIL_EXPRESS" } /** @enumType */ type DomesticServiceWithLiterals = DomesticService | 'GROUND_ADVANTAGE' | 'PRIORITY_MAIL' | 'PRIORITY_MAIL_EXPRESS'; interface ServiceSettings { /** * Estimated delivery time. * @maxLength 500 */ estimatedDeliveryTime?: string | null; /** Handling fee. */ handlingFee?: HandlingFee; /** * Amount above which free delivery is offered. * @decimalValue options { gte:0, maxScale:6 } */ freeDeliveryMinimumAmount?: string | null; } interface HandlingFee { /** * Value that will be used to calculate the fee. For example, percentage fee with value 5% to calculate the fee. * @decimalValue options { gte:0, maxScale:4 } */ value?: string; /** How to calculate the fee: fixed amount or by percentage. */ calculationType?: CalculationTypeWithLiterals; } declare enum CalculationType { FIXED = "FIXED", PERCENTAGE = "PERCENTAGE" } /** @enumType */ type CalculationTypeWithLiterals = CalculationType | 'FIXED' | 'PERCENTAGE'; interface InternationalServiceSettings { /** * InternationalServiceSettings ID. * @format GUID */ _id?: string | null; /** USPS international service. */ service?: InternationalServiceWithLiterals; /** Service settings. */ serviceSettings?: ServiceSettings; } declare enum InternationalService { FIRST_CLASS_PACKAGE_INTERNATIONAL = "FIRST_CLASS_PACKAGE_INTERNATIONAL", PRIORITY_MAIL_INTERNATIONAL = "PRIORITY_MAIL_INTERNATIONAL", PRIORITY_MAIL_EXPRESS_INTERNATIONAL = "PRIORITY_MAIL_EXPRESS_INTERNATIONAL" } /** @enumType */ type InternationalServiceWithLiterals = InternationalService | 'FIRST_CLASS_PACKAGE_INTERNATIONAL' | 'PRIORITY_MAIL_INTERNATIONAL' | 'PRIORITY_MAIL_EXPRESS_INTERNATIONAL'; declare enum PackageType { CUSTOM = "CUSTOM", FLAT_RATE_ENVELOPE = "FLAT_RATE_ENVELOPE", PADDED_FLAT_RATE_ENVELOPE = "PADDED_FLAT_RATE_ENVELOPE", SMALL_FLAT_RATE_BOX = "SMALL_FLAT_RATE_BOX", MEDIUM_FLAT_RATE_BOX_1 = "MEDIUM_FLAT_RATE_BOX_1", MEDIUM_FLAT_RATE_BOX_2 = "MEDIUM_FLAT_RATE_BOX_2", LARGE_FLAT_RATE_BOX = "LARGE_FLAT_RATE_BOX" } /** @enumType */ type PackageTypeWithLiterals = PackageType | 'CUSTOM' | 'FLAT_RATE_ENVELOPE' | 'PADDED_FLAT_RATE_ENVELOPE' | 'SMALL_FLAT_RATE_BOX' | 'MEDIUM_FLAT_RATE_BOX_1' | 'MEDIUM_FLAT_RATE_BOX_2' | 'LARGE_FLAT_RATE_BOX'; interface PackageDetails { /** * Package name. Must be set when package type is CUSTOM. * For other package types, it is read-only, and an exception will be thrown * if it set when creating a ShippoConfiguration. * @maxLength 255 */ name?: string | null; /** * Package dimensions. Can only be set when package type is CUSTOM. * For other package types, it is read-only, and an exception will be thrown * if it set when creating a ShippoConfiguration. */ dimensions?: PackageDimensions; /** * Maximum number of products. Must be set when package type is NOT CUSTOM. * Otherwise, if the package type is CUSTOM, this field cannot be set and an * exception will be thrown if it is set when creating a ShippoConfiguration. */ maxNumberOfProducts?: string | null; } interface PackageDimensions { /** * Package length. * @decimalValue options { gte:0, maxScale:3 } */ length?: string; /** * Package width. * @decimalValue options { gte:0, maxScale:3 } */ width?: string; /** * Package height. * @decimalValue options { gte:0, maxScale:3 } */ height?: string; } /** Physical address */ interface Address { /** * Two-letter country code in [ISO-3166 alpha-2](https://www.iso.org/obp/ui/#search/code/) format. * @format COUNTRY */ country?: string | null; /** * Code for a subdivision (such as state, prefecture, or province) in [ISO 3166-2](https://www.iso.org/standard/72483.html) format. * @maxLength 50 */ subdivision?: string | null; /** * City name. * @maxLength 50 */ city?: string | null; /** * Postal or zip code. * @maxLength 50 */ postalCode?: string | null; /** Street address. */ streetAddress?: StreetAddress; /** * Main address line (usually street name and number). * @maxLength 150 */ addressLine1?: string | null; /** * Free text providing more detailed address info. Usually contains apt, suite, floor. * @maxLength 100 */ addressLine2?: string | null; /** Geocode object containing latitude and longitude coordinates. */ location?: AddressLocation; /** * Country's full name. * @readonly */ countryFullname?: string | null; /** * Subdivision full-name. * @readonly */ subdivisionFullname?: string | null; } interface StreetAddress { /** Street number. */ number?: string; /** Street name. */ name?: string; } interface AddressLocation { /** Address latitude. */ latitude?: number | null; /** Address longitude. */ longitude?: number | null; } interface ExtendedFields { /** * Extended field data. Each key corresponds to the namespace of the app that created the extended fields. * The value of each key is structured according to the schema defined when the extended fields were configured. * * You can only access fields for which you have the appropriate permissions. * * Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields). */ namespaces?: Record>; } interface CreateShippoConfigurationRequest { /** ShippoConfiguration to be created. */ shippoConfiguration: ShippoConfiguration; /** @decimalValue options { gte:0, maxScale:6 } */ backupRate?: string | null; } interface CreateShippoConfigurationResponse { /** The created ShippoConfiguration. */ shippoConfiguration?: ShippoConfiguration; } interface GetShippoConfigurationRequest { /** * ID of the ShippoConfiguration to retrieve. * @format GUID */ shippoConfigurationId: string; } interface GetShippoConfigurationResponse { /** The requested ShippoConfiguration. */ shippoConfiguration?: ShippoConfiguration; } interface UpdateShippoConfigurationRequest { /** ShippoConfiguration to be updated, may be partial. */ shippoConfiguration: ShippoConfiguration; } interface UpdateShippoConfigurationResponse { /** Updated ShippoConfiguration. */ shippoConfiguration?: ShippoConfiguration; } interface DeleteShippoConfigurationRequest { /** * ID of the ShippoConfiguration to delete. * @format GUID */ shippoConfigurationId: string; } interface DeleteShippoConfigurationResponse { } interface QueryShippoConfigurationsRequest { /** WQL expression. */ query?: CursorQuery; } interface CursorQuery extends CursorQueryPagingMethodOneOf { /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */ cursorPaging?: CursorPaging; /** * Filter object in the following format: * `"filter" : { * "fieldName1": "value1", * "fieldName2":{"$operator":"value2"} * }` * Example of operators: `$eq`, `$ne`, `$lt`, `$lte`, `$gt`, `$gte`, `$in`, `$hasSome`, `$hasAll`, `$startsWith`, `$contains` */ filter?: Record | null; /** * Sort object in the following format: * `[{"fieldName":"sortField1","order":"ASC"},{"fieldName":"sortField2","order":"DESC"}]` * @maxSize 5 */ sort?: Sorting[]; } /** @oneof */ interface CursorQueryPagingMethodOneOf { /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */ cursorPaging?: CursorPaging; } interface Sorting { /** * Name of the field to sort by. * @maxLength 512 */ fieldName?: string; /** Sort order. */ order?: SortOrderWithLiterals; } declare enum SortOrder { ASC = "ASC", DESC = "DESC" } /** @enumType */ type SortOrderWithLiterals = SortOrder | 'ASC' | 'DESC'; interface CursorPaging { /** * Maximum number of items to return in the results. * @max 100 */ limit?: number | null; /** * Pointer to the next or previous page in the list of results. * * Pass the relevant cursor token from the `pagingMetadata` object in the previous call's response. * Not relevant for the first request. * @maxLength 16000 */ cursor?: string | null; } interface QueryShippoConfigurationsResponse { /** List of ShippoConfigurations. */ shippoConfigurations?: ShippoConfiguration[]; /** Paging metadata. */ pagingMetadata?: CursorPagingMetadata; } interface CursorPagingMetadata { /** Number of items returned in the response. */ count?: number | null; /** Cursor strings that point to the next page, previous page, or both. */ cursors?: Cursors; /** * Whether there are more pages to retrieve following the current page. * * + `true`: Another page of results can be retrieved. * + `false`: This is the last page. */ hasNext?: boolean | null; } interface Cursors { /** * Cursor string pointing to the next page in the list of results. * @maxLength 16000 */ next?: string | null; /** * Cursor pointing to the previous page in the list of results. * @maxLength 16000 */ prev?: string | null; } interface UpdateExtendedFieldsRequest { /** ID of the entity to update. */ _id: string; /** Identifier for the app whose extended fields are being updated. */ namespace: string; /** Data to update. Structured according to the [schema](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields#json-schema-for-extended-fields) defined when the extended fields were configured. */ namespaceData: Record | null; } interface UpdateExtendedFieldsResponse { /** Updated ShippoConfiguration. */ shippoConfiguration?: ShippoConfiguration; } interface DomainEvent extends DomainEventBodyOneOf { createdEvent?: EntityCreatedEvent; updatedEvent?: EntityUpdatedEvent; deletedEvent?: EntityDeletedEvent; actionEvent?: ActionEvent; /** Event ID. With this ID you can easily spot duplicated events and ignore them. */ _id?: string; /** * Fully Qualified Domain Name of an entity. This is a unique identifier assigned to the API main business entities. * For example, `wix.stores.catalog.product`, `wix.bookings.session`, `wix.payments.transaction`. */ entityFqdn?: string; /** * Event action name, placed at the top level to make it easier for users to dispatch messages. * For example: `created`/`updated`/`deleted`/`started`/`completed`/`email_opened`. */ slug?: string; /** ID of the entity associated with the event. */ entityId?: string; /** Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example, `2020-04-26T13:57:50.699Z`. */ eventTime?: Date | null; /** * Whether the event was triggered as a result of a privacy regulation application * (for example, GDPR). */ triggeredByAnonymizeRequest?: boolean | null; /** If present, indicates the action that triggered the event. */ originatedFrom?: string | null; /** * A sequence number that indicates the order of updates to an entity. For example, if an entity was updated at 16:00 and then again at 16:01, the second update will always have a higher sequence number. * You can use this number to make sure you're handling updates in the right order. Just save the latest sequence number on your end and compare it to the one in each new message. If the new message has an older (lower) number, you can safely ignore it. */ entityEventSequence?: string | null; } /** @oneof */ interface DomainEventBodyOneOf { createdEvent?: EntityCreatedEvent; updatedEvent?: EntityUpdatedEvent; deletedEvent?: EntityDeletedEvent; actionEvent?: ActionEvent; } interface EntityCreatedEvent { entity?: string; } interface RestoreInfo { deletedDate?: Date | null; } interface EntityUpdatedEvent { /** * Since platformized APIs only expose PATCH and not PUT we can't assume that the fields sent from the client are the actual diff. * This means that to generate a list of changed fields (as opposed to sent fields) one needs to traverse both objects. * We don't want to impose this on all developers and so we leave this traversal to the notification recipients which need it. */ currentEntity?: string; } interface EntityDeletedEvent { /** Entity that was deleted. */ deletedEntity?: string | null; } interface ActionEvent { body?: string; } interface Empty { } interface AddDeliveryRegionRequest { /** * ID of the ShippoConfiguration to add the delivery region to. * @format GUID */ shippoConfigurationId: string; /** * ID of the delivery region to add. * @format GUID */ deliveryRegionId: string; /** Revision of the ShippoConfiguration. */ revision?: string | null; } interface AddDeliveryRegionResponse { /** The updated ShippoConfiguration. */ shippoConfiguration?: ShippoConfiguration; } interface RemoveDeliveryRegionRequest { /** * ID of the ShippoConfiguration to remove the delivery region from. * @format GUID */ shippoConfigurationId: string; /** * ID of the delivery region to remove. * @format GUID */ deliveryRegionId: string; /** Revision of the ShippoConfiguration. */ revision?: string | null; } interface RemoveDeliveryRegionResponse { /** The updated ShippoConfiguration, or empty if the ShippoConfiguration was deleted. */ shippoConfiguration?: ShippoConfiguration; } interface MessageEnvelope { /** * App instance ID. * @format GUID */ instanceId?: string | null; /** * Event type. * @maxLength 150 */ eventType?: string; /** The identification type and identity data. */ identity?: IdentificationData; /** Stringify payload. */ data?: string; /** Details related to the account */ accountInfo?: AccountInfo; } interface IdentificationData extends IdentificationDataIdOneOf { /** * ID of a site visitor that has not logged in to the site. * @format GUID */ anonymousVisitorId?: string; /** * ID of a site visitor that has logged in to the site. * @format GUID */ memberId?: string; /** * ID of a Wix user (site owner, contributor, etc.). * @format GUID */ wixUserId?: string; /** * ID of an app. * @format GUID */ appId?: string; /** @readonly */ identityType?: WebhookIdentityTypeWithLiterals; } /** @oneof */ interface IdentificationDataIdOneOf { /** * ID of a site visitor that has not logged in to the site. * @format GUID */ anonymousVisitorId?: string; /** * ID of a site visitor that has logged in to the site. * @format GUID */ memberId?: string; /** * ID of a Wix user (site owner, contributor, etc.). * @format GUID */ wixUserId?: string; /** * ID of an app. * @format GUID */ appId?: string; } declare enum WebhookIdentityType { UNKNOWN = "UNKNOWN", ANONYMOUS_VISITOR = "ANONYMOUS_VISITOR", MEMBER = "MEMBER", WIX_USER = "WIX_USER", APP = "APP" } /** @enumType */ type WebhookIdentityTypeWithLiterals = WebhookIdentityType | 'UNKNOWN' | 'ANONYMOUS_VISITOR' | 'MEMBER' | 'WIX_USER' | 'APP'; interface AccountInfo { /** * ID of the Wix account associated with the event. * @format GUID */ accountId?: string | null; /** * ID of the parent Wix account. Only included when accountId belongs to a child account. * @format GUID */ parentAccountId?: string | null; /** * ID of the Wix site associated with the event. Only included when the event is tied to a specific site. * @format GUID */ siteId?: string | null; } interface BaseEventMetadata { /** * App instance ID. * @format GUID */ instanceId?: string | null; /** * Event type. * @maxLength 150 */ eventType?: string; /** The identification type and identity data. */ identity?: IdentificationData; /** Details related to the account */ accountInfo?: AccountInfo; } interface EventMetadata extends BaseEventMetadata { /** Event ID. With this ID you can easily spot duplicated events and ignore them. */ _id?: string; /** * Fully Qualified Domain Name of an entity. This is a unique identifier assigned to the API main business entities. * For example, `wix.stores.catalog.product`, `wix.bookings.session`, `wix.payments.transaction`. */ entityFqdn?: string; /** * Event action name, placed at the top level to make it easier for users to dispatch messages. * For example: `created`/`updated`/`deleted`/`started`/`completed`/`email_opened`. */ slug?: string; /** ID of the entity associated with the event. */ entityId?: string; /** Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example, `2020-04-26T13:57:50.699Z`. */ eventTime?: Date | null; /** * Whether the event was triggered as a result of a privacy regulation application * (for example, GDPR). */ triggeredByAnonymizeRequest?: boolean | null; /** If present, indicates the action that triggered the event. */ originatedFrom?: string | null; /** * A sequence number that indicates the order of updates to an entity. For example, if an entity was updated at 16:00 and then again at 16:01, the second update will always have a higher sequence number. * You can use this number to make sure you're handling updates in the right order. Just save the latest sequence number on your end and compare it to the one in each new message. If the new message has an older (lower) number, you can safely ignore it. */ entityEventSequence?: string | null; accountInfo?: AccountInfoMetadata; } interface AccountInfoMetadata { /** ID of the Wix account associated with the event */ accountId: string; /** ID of the Wix site associated with the event. Only included when the event is tied to a specific site. */ siteId?: string; /** ID of the parent Wix account. Only included when 'accountId' belongs to a child account. */ parentAccountId?: string; } interface ShippoConfigurationCreatedEnvelope { entity: ShippoConfiguration; metadata: EventMetadata; } /** * Triggered when a shipping option is created. * @permissionScope Manage Stores * @permissionScopeId SCOPE.STORES.MANAGE-STORES * @permissionScope Wix Multilingual - Nile Wrapper Domain Events Read * @permissionScopeId SCOPE.MULTILINGUAL.NILE_WRAPPER_DOMAIN_EVENTS_READ * @permissionId ECOM.SHIPPO_CONFIGURATION_READ * @webhook * @eventType wix.ecom.v1.shippo_configuration_created * @slug created * @documentationMaturity preview */ declare function onShippoConfigurationCreated(handler: (event: ShippoConfigurationCreatedEnvelope) => void | Promise): void; interface ShippoConfigurationDeletedEnvelope { entity: ShippoConfiguration; metadata: EventMetadata; } /** * Triggered when a shipping option is deleted. * @permissionScope Manage Stores * @permissionScopeId SCOPE.STORES.MANAGE-STORES * @permissionScope Wix Multilingual - Nile Wrapper Domain Events Read * @permissionScopeId SCOPE.MULTILINGUAL.NILE_WRAPPER_DOMAIN_EVENTS_READ * @permissionId ECOM.SHIPPO_CONFIGURATION_READ * @webhook * @eventType wix.ecom.v1.shippo_configuration_deleted * @slug deleted * @documentationMaturity preview */ declare function onShippoConfigurationDeleted(handler: (event: ShippoConfigurationDeletedEnvelope) => void | Promise): void; interface ShippoConfigurationUpdatedEnvelope { entity: ShippoConfiguration; metadata: EventMetadata; /** @hidden */ modifiedFields: Record; } /** * Triggered when a shipping option is updated. * @permissionScope Manage Stores * @permissionScopeId SCOPE.STORES.MANAGE-STORES * @permissionScope Wix Multilingual - Nile Wrapper Domain Events Read * @permissionScopeId SCOPE.MULTILINGUAL.NILE_WRAPPER_DOMAIN_EVENTS_READ * @permissionId ECOM.SHIPPO_CONFIGURATION_READ * @webhook * @eventType wix.ecom.v1.shippo_configuration_updated * @slug updated * @documentationMaturity preview */ declare function onShippoConfigurationUpdated(handler: (event: ShippoConfigurationUpdatedEnvelope) => void | Promise): void; /** * Creates a ShippoConfiguration. * @param shippoConfiguration - ShippoConfiguration to be created. * @public * @documentationMaturity preview * @requiredField shippoConfiguration * @requiredField shippoConfiguration.deliveryRegionId * @requiredField shippoConfiguration.osLocationId * @requiredField shippoConfiguration.packageDetails * @requiredField shippoConfiguration.packageDetails.dimensions.height * @requiredField shippoConfiguration.packageDetails.dimensions.length * @requiredField shippoConfiguration.packageDetails.dimensions.width * @requiredField shippoConfiguration.packageType * @permissionId ECOM.SHIPPO_CONFIGURATION_CREATE * @applicableIdentity APP * @returns The created ShippoConfiguration. * @fqn wix.ecom.delivery.v1.ShippoService.CreateShippoConfiguration */ declare function createShippoConfiguration(shippoConfiguration: NonNullablePaths, options?: CreateShippoConfigurationOptions): Promise>; interface CreateShippoConfigurationOptions { /** @decimalValue options { gte:0, maxScale:6 } */ backupRate?: string | null; } /** * Retrieves a ShippoConfiguration. * @param shippoConfigurationId - ID of the ShippoConfiguration to retrieve. * @public * @documentationMaturity preview * @requiredField shippoConfigurationId * @permissionId ECOM.SHIPPO_CONFIGURATION_READ * @applicableIdentity APP * @returns The requested ShippoConfiguration. * @fqn wix.ecom.delivery.v1.ShippoService.GetShippoConfiguration */ declare function getShippoConfiguration(shippoConfigurationId: string): Promise>; /** * Updates a ShippoConfiguration. * @param _id - ShippoConfiguration ID. * @public * @documentationMaturity preview * @requiredField _id * @requiredField shippoConfiguration * @requiredField shippoConfiguration.revision * @permissionId ECOM.SHIPPO_CONFIGURATION_UPDATE * @applicableIdentity APP * @returns Updated ShippoConfiguration. * @fqn wix.ecom.delivery.v1.ShippoService.UpdateShippoConfiguration */ declare function updateShippoConfiguration(_id: string, shippoConfiguration: NonNullablePaths): Promise>; interface UpdateShippoConfiguration { /** * ShippoConfiguration ID. * @format GUID * @readonly */ _id?: string | null; /** @readonly */ revision?: string | null; /** * Date and time the ShippoConfiguration was created. * @readonly */ _createdDate?: Date | null; /** * Date and time the ShippoConfiguration was last updated. * @readonly */ _updatedDate?: Date | null; /** * Associated delivery region ID. * @format GUID * @immutable * @deprecated Associated delivery region ID. * @replacedBy delivery_region_ids * @targetRemovalDate 2025-06-01 */ deliveryRegionId?: string | null; /** * Settings of USPS domestic services. * @maxSize 3 */ domesticServices?: DomesticServiceSettings[]; /** * Settings of USPS international services. * @maxSize 3 */ internationalServices?: InternationalServiceSettings[]; /** Package type. */ packageType?: PackageTypeWithLiterals; /** Package details. */ packageDetails?: PackageDetails; /** * Location ID from OS location service. * @format GUID */ osLocationId?: string | null; /** * Ship from address materialized from OS location. * @readonly */ shipFromAddress?: Address; /** * This shippo configuration is active for the following delivery regions. * @maxSize 50 * @format GUID * @immutable */ deliveryRegionIds?: string[]; /** * Backup weight. * @decimalValue options { gte:0, maxScale:5 } */ backupWeight?: string | null; /** Data extensions. */ extendedFields?: ExtendedFields; } /** * Deletes a ShippoConfiguration. * @param shippoConfigurationId - ID of the ShippoConfiguration to delete. * @public * @documentationMaturity preview * @requiredField shippoConfigurationId * @permissionId ECOM.SHIPPO_CONFIGURATION_DELETE * @applicableIdentity APP * @fqn wix.ecom.delivery.v1.ShippoService.DeleteShippoConfiguration */ declare function deleteShippoConfiguration(shippoConfigurationId: string): Promise; /** * Retrieves a list of ShippoConfigurations, given the provided [paging, filtering, and sorting][1]. * * Up to 1,000 ShippoConfigurations can be returned per request. * * To learn how to query ShippoConfigurations, see [API Query Language][2]. * * [1]: https://dev.wix.com/api/rest/getting-started/sorting-and-paging * [2]: https://dev.wix.com/api/rest/getting-started/api-query-language * @public * @documentationMaturity preview * @permissionId ECOM.SHIPPO_CONFIGURATION_READ * @applicableIdentity APP * @fqn wix.ecom.delivery.v1.ShippoService.QueryShippoConfigurations */ declare function queryShippoConfigurations(): ShippoConfigurationsQueryBuilder; interface QueryCursorResult { cursors: Cursors; hasNext: () => boolean; hasPrev: () => boolean; length: number; pageSize: number; } interface ShippoConfigurationsQueryResult extends QueryCursorResult { items: ShippoConfiguration[]; query: ShippoConfigurationsQueryBuilder; next: () => Promise; prev: () => Promise; } interface ShippoConfigurationsQueryBuilder { /** @param propertyName - Property whose value is compared with `value`. * @param value - Value to compare against. * @documentationMaturity preview */ eq: (propertyName: '_id' | 'deliveryRegionId', value: any) => ShippoConfigurationsQueryBuilder; /** @param propertyName - Property whose value is compared with `value`. * @param value - Value to compare against. * @documentationMaturity preview */ ne: (propertyName: '_id' | 'deliveryRegionId', value: any) => ShippoConfigurationsQueryBuilder; /** @param propertyName - Property whose value is compared with `value`. * @param value - Value to compare against. * @documentationMaturity preview */ ge: (propertyName: '_id' | 'deliveryRegionId', value: any) => ShippoConfigurationsQueryBuilder; /** @param propertyName - Property whose value is compared with `value`. * @param value - Value to compare against. * @documentationMaturity preview */ gt: (propertyName: '_id' | 'deliveryRegionId', value: any) => ShippoConfigurationsQueryBuilder; /** @param propertyName - Property whose value is compared with `value`. * @param value - Value to compare against. * @documentationMaturity preview */ le: (propertyName: '_id' | 'deliveryRegionId', value: any) => ShippoConfigurationsQueryBuilder; /** @param propertyName - Property whose value is compared with `value`. * @param value - Value to compare against. * @documentationMaturity preview */ lt: (propertyName: '_id' | 'deliveryRegionId', value: any) => ShippoConfigurationsQueryBuilder; /** @param propertyName - Property whose value is compared with `string`. * @param string - String to compare against. Case-insensitive. * @documentationMaturity preview */ startsWith: (propertyName: '_id' | 'deliveryRegionId', value: string) => ShippoConfigurationsQueryBuilder; /** @param propertyName - Property whose value is compared with `values`. * @param values - List of values to compare against. * @documentationMaturity preview */ hasSome: (propertyName: '_id' | 'deliveryRegionId', value: any[]) => ShippoConfigurationsQueryBuilder; /** @documentationMaturity preview */ in: (propertyName: '_id' | 'deliveryRegionId', value: any) => ShippoConfigurationsQueryBuilder; /** @documentationMaturity preview */ exists: (propertyName: '_id' | 'deliveryRegionId', value: boolean) => ShippoConfigurationsQueryBuilder; /** @param propertyNames - Properties used in the sort. To sort by multiple properties, pass properties as additional arguments. * @documentationMaturity preview */ ascending: (...propertyNames: Array<'_id' | 'deliveryRegionId'>) => ShippoConfigurationsQueryBuilder; /** @param propertyNames - Properties used in the sort. To sort by multiple properties, pass properties as additional arguments. * @documentationMaturity preview */ descending: (...propertyNames: Array<'_id' | 'deliveryRegionId'>) => ShippoConfigurationsQueryBuilder; /** @param limit - Number of items to return, which is also the `pageSize` of the results object. * @documentationMaturity preview */ limit: (limit: number) => ShippoConfigurationsQueryBuilder; /** @param cursor - A pointer to specific record * @documentationMaturity preview */ skipTo: (cursor: string) => ShippoConfigurationsQueryBuilder; /** @documentationMaturity preview */ find: () => Promise; } /** * @hidden * @fqn wix.ecom.delivery.v1.ShippoService.QueryShippoConfigurations * @requiredField query */ declare function typedQueryShippoConfigurations(query: ShippoConfigurationQuery): Promise>; interface ShippoConfigurationQuerySpec extends QuerySpec { paging: 'cursor'; wql: [ { fields: ['_id', 'deliveryRegionId']; operators: '*'; sort: 'BOTH'; } ]; } type CommonQueryWithEntityContext = Query; type ShippoConfigurationQuery = { /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */ cursorPaging?: { /** Maximum number of items to return in the results. @max: 100 */ limit?: NonNullable['limit'] | null; /** Pointer to the next or previous page in the list of results. Pass the relevant cursor token from the `pagingMetadata` object in the previous call's response. Not relevant for the first request. @maxLength: 16000 */ cursor?: NonNullable['cursor'] | null; }; /** Filter object in the following format: `"filter" : { "fieldName1": "value1", "fieldName2":{"$operator":"value2"} }` Example of operators: `$eq`, `$ne`, `$lt`, `$lte`, `$gt`, `$gte`, `$in`, `$hasSome`, `$hasAll`, `$startsWith`, `$contains` */ filter?: CommonQueryWithEntityContext['filter'] | null; /** Sort object in the following format: `[{"fieldName":"sortField1","order":"ASC"},{"fieldName":"sortField2","order":"DESC"}]` @maxSize: 5 */ sort?: { /** Name of the field to sort by. @maxLength: 512 */ fieldName?: NonNullable[number]['fieldName']; /** Sort order. */ order?: NonNullable[number]['order']; }[]; }; declare const utils: { query: { QueryBuilder: () => _wix_sdk_types.QueryBuilder; Filter: _wix_sdk_types.FilterFactory; Sort: _wix_sdk_types.SortFactory; }; }; /** * Updates extended fields of a ShippoConfiguration without incrementing revision * @param _id - ID of the entity to update. * @param namespace - Identifier for the app whose extended fields are being updated. * @public * @documentationMaturity preview * @requiredField _id * @requiredField namespace * @requiredField options * @requiredField options.namespaceData * @permissionId ECOM.SHIPPO_CONFIGURATION_UPDATE * @applicableIdentity APP * @fqn wix.ecom.delivery.v1.ShippoService.UpdateExtendedFields */ declare function updateExtendedFields(_id: string, namespace: string, options: NonNullablePaths): Promise>; interface UpdateExtendedFieldsOptions { /** Data to update. Structured according to the [schema](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields#json-schema-for-extended-fields) defined when the extended fields were configured. */ namespaceData: Record | null; } /** * Adds a delivery region to a Shippo configuration. * @param shippoConfigurationId - ID of the ShippoConfiguration to add the delivery region to. * @param deliveryRegionId - ID of the delivery region to add. * @public * @documentationMaturity preview * @requiredField deliveryRegionId * @requiredField shippoConfigurationId * @permissionId ECOM.SHIPPO_CONFIGURATION_UPDATE * @applicableIdentity APP * @fqn wix.ecom.delivery.v1.ShippoService.AddDeliveryRegion */ declare function addDeliveryRegion(shippoConfigurationId: string, deliveryRegionId: string, options?: AddDeliveryRegionOptions): Promise>; interface AddDeliveryRegionOptions { /** Revision of the ShippoConfiguration. */ revision?: string | null; } /** * Removes a delivery region from a Shippo configuration. * When passing the ID of the only existing delivery region, removing it will delete the Shippo configuration. * @public * @documentationMaturity preview * @requiredField identifiers * @requiredField identifiers.deliveryRegionId * @requiredField identifiers.shippoConfigurationId * @permissionId ECOM.SHIPPO_CONFIGURATION_UPDATE * @applicableIdentity APP * @fqn wix.ecom.delivery.v1.ShippoService.RemoveDeliveryRegion */ declare function removeDeliveryRegion(identifiers: NonNullablePaths, options?: RemoveDeliveryRegionOptions): Promise>; interface RemoveDeliveryRegionIdentifiers { /** * ID of the ShippoConfiguration to remove the delivery region from. * @format GUID */ shippoConfigurationId: string; /** * ID of the delivery region to remove. * @format GUID */ deliveryRegionId: string; } interface RemoveDeliveryRegionOptions { /** Revision of the ShippoConfiguration. */ revision?: string | null; } export { type AccountInfo, type AccountInfoMetadata, type ActionEvent, type AddDeliveryRegionOptions, type AddDeliveryRegionRequest, type AddDeliveryRegionResponse, type Address, type AddressLocation, type BaseEventMetadata, CalculationType, type CalculationTypeWithLiterals, type CommonQueryWithEntityContext, type CreateShippoConfigurationOptions, type CreateShippoConfigurationRequest, type CreateShippoConfigurationResponse, type CursorPaging, type CursorPagingMetadata, type CursorQuery, type CursorQueryPagingMethodOneOf, type Cursors, type DeleteShippoConfigurationRequest, type DeleteShippoConfigurationResponse, type DomainEvent, type DomainEventBodyOneOf, DomesticService, type DomesticServiceSettings, type DomesticServiceWithLiterals, type Empty, type EntityCreatedEvent, type EntityDeletedEvent, type EntityUpdatedEvent, type EventMetadata, type ExtendedFields, type GetShippoConfigurationRequest, type GetShippoConfigurationResponse, type HandlingFee, type IdentificationData, type IdentificationDataIdOneOf, InternationalService, type InternationalServiceSettings, type InternationalServiceWithLiterals, type MessageEnvelope, type PackageDetails, type PackageDimensions, PackageType, type PackageTypeWithLiterals, type QueryShippoConfigurationsRequest, type QueryShippoConfigurationsResponse, type RemoveDeliveryRegionIdentifiers, type RemoveDeliveryRegionOptions, type RemoveDeliveryRegionRequest, type RemoveDeliveryRegionResponse, type RestoreInfo, type ServiceSettings, type ShippoConfiguration, type ShippoConfigurationCreatedEnvelope, type ShippoConfigurationDeletedEnvelope, type ShippoConfigurationQuery, type ShippoConfigurationQuerySpec, type ShippoConfigurationUpdatedEnvelope, type ShippoConfigurationsQueryBuilder, type ShippoConfigurationsQueryResult, SortOrder, type SortOrderWithLiterals, type Sorting, type StreetAddress, type UpdateExtendedFieldsOptions, type UpdateExtendedFieldsRequest, type UpdateExtendedFieldsResponse, type UpdateShippoConfiguration, type UpdateShippoConfigurationRequest, type UpdateShippoConfigurationResponse, WebhookIdentityType, type WebhookIdentityTypeWithLiterals, addDeliveryRegion, createShippoConfiguration, deleteShippoConfiguration, getShippoConfiguration, onShippoConfigurationCreated, onShippoConfigurationDeleted, onShippoConfigurationUpdated, queryShippoConfigurations, removeDeliveryRegion, typedQueryShippoConfigurations, updateExtendedFields, updateShippoConfiguration, utils };