@sp-api-sdk/external-fulfillment-returns-api-2024-09-11 1.1.11 → 2.0.0

package/dist/index.d.cts

@@ -0,0 +1,707 @@
+import { ClientConfiguration, RateLimit } from '@sp-api-sdk/common';
+import * as axios from 'axios';
+import { AxiosInstance, RawAxiosRequestConfig, AxiosPromise } from 'axios';
+
+/**
+ * The Selling Partner API for Amazon External Fulfillment Return Item Processing
+ * You can use the Amazon External Fulfillment Return Item Processing API to retrieve, track, and process return items through Amazon\'s External Fulfillment returns management system.
+ *
+ * The version of the OpenAPI document: 2024-09-11
+ * Contact: marketplaceapitest@amazon.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+interface AWSv4Configuration {
+    options?: {
+        region?: string;
+        service?: string;
+    };
+    credentials?: {
+        accessKeyId?: string;
+        secretAccessKey?: string;
+        sessionToken?: string;
+    };
+}
+interface ConfigurationParameters {
+    apiKey?: string | Promise<string> | ((name: string) => string) | ((name: string) => Promise<string>);
+    username?: string;
+    password?: string;
+    accessToken?: string | Promise<string> | ((name?: string, scopes?: string[]) => string) | ((name?: string, scopes?: string[]) => Promise<string>);
+    awsv4?: AWSv4Configuration;
+    basePath?: string;
+    serverIndex?: number;
+    baseOptions?: any;
+    formDataCtor?: new () => any;
+}
+declare class Configuration {
+    /**
+     * parameter for apiKey security
+     * @param name security name
+     */
+    apiKey?: string | Promise<string> | ((name: string) => string) | ((name: string) => Promise<string>);
+    /**
+     * parameter for basic security
+     */
+    username?: string;
+    /**
+     * parameter for basic security
+     */
+    password?: string;
+    /**
+     * parameter for oauth2 security
+     * @param name security name
+     * @param scopes oauth2 scope
+     */
+    accessToken?: string | Promise<string> | ((name?: string, scopes?: string[]) => string) | ((name?: string, scopes?: string[]) => Promise<string>);
+    /**
+     * parameter for aws4 signature security
+     * @param {Object} AWS4Signature - AWS4 Signature security
+     * @param {string} options.region - aws region
+     * @param {string} options.service - name of the service.
+     * @param {string} credentials.accessKeyId - aws access key id
+     * @param {string} credentials.secretAccessKey - aws access key
+     * @param {string} credentials.sessionToken - aws session token
+     * @memberof Configuration
+     */
+    awsv4?: AWSv4Configuration;
+    /**
+     * override base path
+     */
+    basePath?: string;
+    /**
+     * override server index
+     */
+    serverIndex?: number;
+    /**
+     * base options for axios calls
+     */
+    baseOptions?: any;
+    /**
+     * The FormData constructor that will be used to create multipart form data
+     * requests. You can inject this here so that execution environments that
+     * do not support the FormData class can still run the generated client.
+     *
+     * @type {new () => FormData}
+     */
+    formDataCtor?: new () => any;
+    constructor(param?: ConfigurationParameters);
+    /**
+     * Check if the given MIME is a JSON MIME.
+     * JSON MIME examples:
+     *   application/json
+     *   application/json; charset=UTF8
+     *   APPLICATION/JSON
+     *   application/vnd.company+json
+     * @param mime - MIME (Multipurpose Internet Mail Extensions)
+     * @return True if the given MIME is JSON, false otherwise.
+     */
+    isJsonMime(mime: string): boolean;
+}
+
+/**
+ * The Selling Partner API for Amazon External Fulfillment Return Item Processing
+ * You can use the Amazon External Fulfillment Return Item Processing API to retrieve, track, and process return items through Amazon\'s External Fulfillment returns management system.
+ *
+ * The version of the OpenAPI document: 2024-09-11
+ * Contact: marketplaceapitest@amazon.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+interface RequestArgs {
+    url: string;
+    options: RawAxiosRequestConfig;
+}
+declare class BaseAPI {
+    protected basePath: string;
+    protected axios: AxiosInstance;
+    protected configuration: Configuration | undefined;
+    constructor(configuration?: Configuration, basePath?: string, axios?: AxiosInstance);
+}
+
+/**
+ * The Selling Partner API for Amazon External Fulfillment Return Item Processing
+ * You can use the Amazon External Fulfillment Return Item Processing API to retrieve, track, and process return items through Amazon\'s External Fulfillment returns management system.
+ *
+ * The version of the OpenAPI document: 2024-09-11
+ * Contact: marketplaceapitest@amazon.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * An object containing a list of error responses returned when a request is unsuccessful.
+ */
+interface ErrorList {
+    /**
+     * A list of error responses returned when a request is unsuccessful.
+     */
+    'errors': Array<Error>;
+}
+
+/**
+ * The Selling Partner API for Amazon External Fulfillment Return Item Processing
+ * You can use the Amazon External Fulfillment Return Item Processing API to retrieve, track, and process return items through Amazon\'s External Fulfillment returns management system.
+ *
+ * The version of the OpenAPI document: 2024-09-11
+ * Contact: marketplaceapitest@amazon.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Invoice-related information for the return created for Amazon SmartConnect.
+ */
+interface InvoiceInformation {
+    /**
+     * The unique ID of the invoice that corresponds to the return.
+     */
+    'id': string;
+}
+
+/**
+ * The Selling Partner API for Amazon External Fulfillment Return Item Processing
+ * You can use the Amazon External Fulfillment Return Item Processing API to retrieve, track, and process return items through Amazon\'s External Fulfillment returns management system.
+ *
+ * The version of the OpenAPI document: 2024-09-11
+ * Contact: marketplaceapitest@amazon.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * The marketplace and channel name.
+ */
+interface MarketplaceChannel {
+    /**
+     * The name of the marketplace.
+     */
+    'marketplaceName'?: string;
+    /**
+     * The name of the channel within the marketplace.
+     */
+    'channelName'?: string;
+}
+
+/**
+ * The Selling Partner API for Amazon External Fulfillment Return Item Processing
+ * You can use the Amazon External Fulfillment Return Item Processing API to retrieve, track, and process return items through Amazon\'s External Fulfillment returns management system.
+ *
+ * The version of the OpenAPI document: 2024-09-11
+ * Contact: marketplaceapitest@amazon.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ * Marketplace channel-specific attributes for the return. These attributes are not mandatory and each channel can provide them differently.
+ */
+interface MarketplaceChannelDetails {
+    'marketplaceChannel'?: MarketplaceChannel;
+    /**
+     * The ID of the merchant or seller to whom this return is created in the marketplace.
+     */
+    'merchantId'?: string;
+    /**
+     * The marketplace-specific shipment ID.
+     */
+    'shipmentId'?: string;
+    /**
+     * The marketplace-specific customer order ID.
+     */
+    'customerOrderId'?: string;
+    /**
+     * The Amazon SmartConnect ID of the location to which this return is created.
+     */
+    'returnLocationId'?: string;
+    /**
+     * The Amazon SmartConnect SKU of the channel.
+     */
+    'channelSku'?: string;
+    /**
+     * The Amazon SmartConnect ID of the exchange order.
+     */
+    'exchangeOrderId'?: string;
+}
+
+/**
+ * The Selling Partner API for Amazon External Fulfillment Return Item Processing
+ * You can use the Amazon External Fulfillment Return Item Processing API to retrieve, track, and process return items through Amazon\'s External Fulfillment returns management system.
+ *
+ * The version of the OpenAPI document: 2024-09-11
+ * Contact: marketplaceapitest@amazon.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Error response returned when the request is unsuccessful.
+ */
+interface ModelError {
+    /**
+     * An error code that identifies the type of error that occurred.
+     */
+    'code': string;
+    /**
+     * A message that describes the error condition.
+     */
+    'message': string;
+    /**
+     * Additional details that can help the caller understand or fix the issue.
+     */
+    'details'?: string;
+}
+
+/**
+ * The Selling Partner API for Amazon External Fulfillment Return Item Processing
+ * You can use the Amazon External Fulfillment Return Item Processing API to retrieve, track, and process return items through Amazon\'s External Fulfillment returns management system.
+ *
+ * The version of the OpenAPI document: 2024-09-11
+ * Contact: marketplaceapitest@amazon.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * One-time password (OTP) details of the return item.
+ */
+interface OtpDetails {
+    /**
+     * One-time password to validate the return delivered to the seller.
+     */
+    'otp': string;
+    /**
+     * The UNIX timestamp of when the verification code expires.
+     */
+    'validTill': number;
+}
+
+/**
+ * The Selling Partner API for Amazon External Fulfillment Return Item Processing
+ * You can use the Amazon External Fulfillment Return Item Processing API to retrieve, track, and process return items through Amazon\'s External Fulfillment returns management system.
+ *
+ * The version of the OpenAPI document: 2024-09-11
+ * Contact: marketplaceapitest@amazon.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Information for tracking a return.
+ */
+interface TrackingInfo {
+    /**
+     * The name of the third party courier service used to ship the return package.
+     */
+    'carrierName': string;
+    /**
+     * The tracking ID of the return package.
+     */
+    'trackingId': string;
+}
+
+/**
+ * The Selling Partner API for Amazon External Fulfillment Return Item Processing
+ * You can use the Amazon External Fulfillment Return Item Processing API to retrieve, track, and process return items through Amazon\'s External Fulfillment returns management system.
+ *
+ * The version of the OpenAPI document: 2024-09-11
+ * Contact: marketplaceapitest@amazon.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ * Provides details about the replanned returns.
+ */
+interface ReplanningDetails {
+    /**
+     * A list of all the previous tracking information for the return.
+     */
+    'previousTrackingInfo'?: Array<TrackingInfo>;
+}
+
+/**
+ * The Selling Partner API for Amazon External Fulfillment Return Item Processing
+ * You can use the Amazon External Fulfillment Return Item Processing API to retrieve, track, and process return items through Amazon\'s External Fulfillment returns management system.
+ *
+ * The version of the OpenAPI document: 2024-09-11
+ * Contact: marketplaceapitest@amazon.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ * Metadata about the return item.
+ */
+interface ReturnMetadata {
+    /**
+     * The reason for the return.
+     */
+    'returnReason': string;
+    /**
+     * The RMA ID of the return.
+     */
+    'rmaId'?: string;
+    /**
+     * The SmartConnect ID of the fulfillment order for which the return was placed.
+     */
+    'fulfillmentOrderId'?: string;
+    'invoiceInformation'?: InvoiceInformation;
+}
+
+/**
+ * The Selling Partner API for Amazon External Fulfillment Return Item Processing
+ * You can use the Amazon External Fulfillment Return Item Processing API to retrieve, track, and process return items through Amazon\'s External Fulfillment returns management system.
+ *
+ * The version of the OpenAPI document: 2024-09-11
+ * Contact: marketplaceapitest@amazon.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ * Information about the shipping of the return packages.
+ */
+interface ReturnShippingInfo {
+    /**
+     * A date and time in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format.
+     */
+    'deliveryDateTime'?: string;
+    /**
+     * A date and time in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format.
+     */
+    'pickupDateTime'?: string;
+    'forwardTrackingInfo'?: TrackingInfo;
+    'reverseTrackingInfo'?: TrackingInfo;
+}
+
+/**
+ * The Selling Partner API for Amazon External Fulfillment Return Item Processing
+ * You can use the Amazon External Fulfillment Return Item Processing API to retrieve, track, and process return items through Amazon\'s External Fulfillment returns management system.
+ *
+ * The version of the OpenAPI document: 2024-09-11
+ * Contact: marketplaceapitest@amazon.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ * Information about the return item.
+ */
+interface Return {
+    /**
+     * The return item\'s ID.
+     */
+    'id': string;
+    /**
+     * The SmartConnect identifier for where the return item was dropped for delivery.
+     */
+    'returnLocationId'?: string;
+    /**
+     * The seller\'s identifier for the SKU.
+     */
+    'merchantSku'?: string;
+    /**
+     * The type of return.
+     */
+    'returnType': ReturnReturnTypeEnum;
+    /**
+     * The sub-type of return.
+     */
+    'returnSubType'?: ReturnReturnSubTypeEnum;
+    /**
+     * The total number of units in the return.
+     */
+    'numberOfUnits'?: number;
+    /**
+     * The current status of the return.
+     */
+    'status': ReturnStatusEnum;
+    /**
+     * The ID of the location that fulfilled the order.
+     */
+    'fulfillmentLocationId': string;
+    /**
+     * A date and time in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format.
+     */
+    'creationDateTime'?: string;
+    /**
+     * A date and time in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format.
+     */
+    'lastUpdatedDateTime': string;
+    'returnMetadata': ReturnMetadata;
+    'returnShippingInfo': ReturnShippingInfo;
+    'marketplaceChannelDetails': MarketplaceChannelDetails;
+    'otpDetails'?: OtpDetails;
+    /**
+     * The package delivery mode. This indicates whether the return was delivered to the seller with or without a one-time password (OTP).
+     */
+    'packageDeliveryMode'?: ReturnPackageDeliveryModeEnum;
+    'replanningDetails'?: ReplanningDetails;
+}
+declare const ReturnReturnTypeEnum: {
+    readonly Customer: "CUSTOMER";
+    readonly Reject: "REJECT";
+};
+type ReturnReturnTypeEnum = typeof ReturnReturnTypeEnum[keyof typeof ReturnReturnTypeEnum];
+declare const ReturnReturnSubTypeEnum: {
+    readonly Normal: "NORMAL";
+    readonly Replacement: "REPLACEMENT";
+    readonly Exchange: "EXCHANGE";
+};
+type ReturnReturnSubTypeEnum = typeof ReturnReturnSubTypeEnum[keyof typeof ReturnReturnSubTypeEnum];
+declare const ReturnStatusEnum: {
+    readonly Created: "CREATED";
+    readonly CarrierNotifiedToPickUpFromCustomer: "CARRIER_NOTIFIED_TO_PICK_UP_FROM_CUSTOMER";
+    readonly CarrierOutForPickUpFromCustomer: "CARRIER_OUT_FOR_PICK_UP_FROM_CUSTOMER";
+    readonly CustomerCancelledPickUp: "CUSTOMER_CANCELLED_PICK_UP";
+    readonly CustomerRescheduledPickUp: "CUSTOMER_RESCHEDULED_PICK_UP";
+    readonly PickedFromCustomer: "PICKED_FROM_CUSTOMER";
+    readonly InTransit: "IN_TRANSIT";
+    readonly OutForDelivery: "OUT_FOR_DELIVERY";
+    readonly Delivered: "DELIVERED";
+    readonly Replanned: "REPLANNED";
+    readonly CustomerDroppedOff: "CUSTOMER_DROPPED_OFF";
+    readonly PartiallyProcessed: "PARTIALLY_PROCESSED";
+    readonly Processed: "PROCESSED";
+    readonly Rejected: "REJECTED";
+    readonly Cancelled: "CANCELLED";
+};
+type ReturnStatusEnum = typeof ReturnStatusEnum[keyof typeof ReturnStatusEnum];
+declare const ReturnPackageDeliveryModeEnum: {
+    readonly WithOtp: "WITH_OTP";
+    readonly WithoutOtp: "WITHOUT_OTP";
+};
+type ReturnPackageDeliveryModeEnum = typeof ReturnPackageDeliveryModeEnum[keyof typeof ReturnPackageDeliveryModeEnum];
+
+/**
+ * The Selling Partner API for Amazon External Fulfillment Return Item Processing
+ * You can use the Amazon External Fulfillment Return Item Processing API to retrieve, track, and process return items through Amazon\'s External Fulfillment returns management system.
+ *
+ * The version of the OpenAPI document: 2024-09-11
+ * Contact: marketplaceapitest@amazon.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ * The response to the `listReturns` operation.
+ */
+interface ReturnsResponse {
+    /**
+     * A list of returns.
+     */
+    'returns'?: Array<Return>;
+    /**
+     * A token that you use to retrieve the next page of results. The response includes `nextToken` when there are multiple pages of results. To get the next page of results, call the operation with this token and include the same arguments as the call that produced the token. To get a complete list, call this operation until `nextToken` is null. Note that this operation can return empty pages.
+     */
+    'nextToken'?: string;
+}
+
+/**
+ * ExternalFulfillmentReturnsApi - axios parameter creator
+ */
+declare const ExternalFulfillmentReturnsApiAxiosParamCreator: (configuration?: Configuration) => {
+    /**
+     * Retrieve the return item with the specified ID.
+     * @param {string} returnId The ID of the return item you want.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getReturn: (returnId: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Retrieve a list of return items. You can filter results by location, RMA ID, status, or time.
+     * @param {string} [returnLocationId] The SmartConnect location ID of the location from which you want to retrieve return items.
+     * @param {string} [rmaId] The RMA ID of the return items you want to list.
+     * @param {ListReturnsStatusEnum} [status] The status of return items you want to list. You can retrieve all new return items with the &#x60;CREATED&#x60; status.
+     * @param {string} [reverseTrackingId] The reverse tracking ID of the return items you want to list.
+     * @param {string} [createdSince] Return items created after the specified date are included in the response. In [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date-time format.
+     * @param {string} [createdUntil] Return items created before the specified date are included in the response. In [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date-time format.
+     * @param {string} [lastUpdatedSince] Return items updated after the specified date are included in the response. In [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date-time format. If you supply this parameter, you must also supply &#x60;returnLocationId&#x60; and &#x60;status&#x60;.
+     * @param {string} [lastUpdatedUntil] Return items whose most recent update is before the specified date are included in the response. In [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date-time format. If you supply this parameter, you must also supply &#x60;returnLocationId&#x60; and &#x60;status&#x60;.
+     * @param {string} [lastUpdatedAfter] DEPRECATED. Use the &#x60;createdSince&#x60; parameter.
+     * @param {string} [lastUpdatedBefore] DEPRECATED. Use the &#x60;createdUntil&#x60; parameter.
+     * @param {number} [maxResults] The number of return items you want to include in the response.  **Default:** 10  **Maximum:** 100
+     * @param {string} [nextToken] A token that you use to retrieve the next page of results. The response includes &#x60;nextToken&#x60; when there are multiple pages of results. To get the next page of results, call the operation with this token and include the same arguments as the call that produced the token. To get a complete list, call this operation until &#x60;nextToken&#x60; is null. Note that this operation can return empty pages.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listReturns: (returnLocationId?: string, rmaId?: string, status?: ListReturnsStatusEnum, reverseTrackingId?: string, createdSince?: string, createdUntil?: string, lastUpdatedSince?: string, lastUpdatedUntil?: string, lastUpdatedAfter?: string, lastUpdatedBefore?: string, maxResults?: number, nextToken?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+};
+/**
+ * ExternalFulfillmentReturnsApi - functional programming interface
+ */
+declare const ExternalFulfillmentReturnsApiFp: (configuration?: Configuration) => {
+    /**
+     * Retrieve the return item with the specified ID.
+     * @param {string} returnId The ID of the return item you want.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getReturn(returnId: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Return>>;
+    /**
+     * Retrieve a list of return items. You can filter results by location, RMA ID, status, or time.
+     * @param {string} [returnLocationId] The SmartConnect location ID of the location from which you want to retrieve return items.
+     * @param {string} [rmaId] The RMA ID of the return items you want to list.
+     * @param {ListReturnsStatusEnum} [status] The status of return items you want to list. You can retrieve all new return items with the &#x60;CREATED&#x60; status.
+     * @param {string} [reverseTrackingId] The reverse tracking ID of the return items you want to list.
+     * @param {string} [createdSince] Return items created after the specified date are included in the response. In [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date-time format.
+     * @param {string} [createdUntil] Return items created before the specified date are included in the response. In [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date-time format.
+     * @param {string} [lastUpdatedSince] Return items updated after the specified date are included in the response. In [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date-time format. If you supply this parameter, you must also supply &#x60;returnLocationId&#x60; and &#x60;status&#x60;.
+     * @param {string} [lastUpdatedUntil] Return items whose most recent update is before the specified date are included in the response. In [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date-time format. If you supply this parameter, you must also supply &#x60;returnLocationId&#x60; and &#x60;status&#x60;.
+     * @param {string} [lastUpdatedAfter] DEPRECATED. Use the &#x60;createdSince&#x60; parameter.
+     * @param {string} [lastUpdatedBefore] DEPRECATED. Use the &#x60;createdUntil&#x60; parameter.
+     * @param {number} [maxResults] The number of return items you want to include in the response.  **Default:** 10  **Maximum:** 100
+     * @param {string} [nextToken] A token that you use to retrieve the next page of results. The response includes &#x60;nextToken&#x60; when there are multiple pages of results. To get the next page of results, call the operation with this token and include the same arguments as the call that produced the token. To get a complete list, call this operation until &#x60;nextToken&#x60; is null. Note that this operation can return empty pages.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listReturns(returnLocationId?: string, rmaId?: string, status?: ListReturnsStatusEnum, reverseTrackingId?: string, createdSince?: string, createdUntil?: string, lastUpdatedSince?: string, lastUpdatedUntil?: string, lastUpdatedAfter?: string, lastUpdatedBefore?: string, maxResults?: number, nextToken?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ReturnsResponse>>;
+};
+/**
+ * ExternalFulfillmentReturnsApi - factory interface
+ */
+declare const ExternalFulfillmentReturnsApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
+    /**
+     * Retrieve the return item with the specified ID.
+     * @param {ExternalFulfillmentReturnsApiGetReturnRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getReturn(requestParameters: ExternalFulfillmentReturnsApiGetReturnRequest, options?: RawAxiosRequestConfig): AxiosPromise<Return>;
+    /**
+     * Retrieve a list of return items. You can filter results by location, RMA ID, status, or time.
+     * @param {ExternalFulfillmentReturnsApiListReturnsRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listReturns(requestParameters?: ExternalFulfillmentReturnsApiListReturnsRequest, options?: RawAxiosRequestConfig): AxiosPromise<ReturnsResponse>;
+};
+/**
+ * Request parameters for getReturn operation in ExternalFulfillmentReturnsApi.
+ */
+interface ExternalFulfillmentReturnsApiGetReturnRequest {
+    /**
+     * The ID of the return item you want.
+     */
+    readonly returnId: string;
+}
+/**
+ * Request parameters for listReturns operation in ExternalFulfillmentReturnsApi.
+ */
+interface ExternalFulfillmentReturnsApiListReturnsRequest {
+    /**
+     * The SmartConnect location ID of the location from which you want to retrieve return items.
+     */
+    readonly returnLocationId?: string;
+    /**
+     * The RMA ID of the return items you want to list.
+     */
+    readonly rmaId?: string;
+    /**
+     * The status of return items you want to list. You can retrieve all new return items with the &#x60;CREATED&#x60; status.
+     */
+    readonly status?: ListReturnsStatusEnum;
+    /**
+     * The reverse tracking ID of the return items you want to list.
+     */
+    readonly reverseTrackingId?: string;
+    /**
+     * Return items created after the specified date are included in the response. In [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date-time format.
+     */
+    readonly createdSince?: string;
+    /**
+     * Return items created before the specified date are included in the response. In [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date-time format.
+     */
+    readonly createdUntil?: string;
+    /**
+     * Return items updated after the specified date are included in the response. In [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date-time format. If you supply this parameter, you must also supply &#x60;returnLocationId&#x60; and &#x60;status&#x60;.
+     */
+    readonly lastUpdatedSince?: string;
+    /**
+     * Return items whose most recent update is before the specified date are included in the response. In [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date-time format. If you supply this parameter, you must also supply &#x60;returnLocationId&#x60; and &#x60;status&#x60;.
+     */
+    readonly lastUpdatedUntil?: string;
+    /**
+     * DEPRECATED. Use the &#x60;createdSince&#x60; parameter.
+     */
+    readonly lastUpdatedAfter?: string;
+    /**
+     * DEPRECATED. Use the &#x60;createdUntil&#x60; parameter.
+     */
+    readonly lastUpdatedBefore?: string;
+    /**
+     * The number of return items you want to include in the response.  **Default:** 10  **Maximum:** 100
+     */
+    readonly maxResults?: number;
+    /**
+     * A token that you use to retrieve the next page of results. The response includes &#x60;nextToken&#x60; when there are multiple pages of results. To get the next page of results, call the operation with this token and include the same arguments as the call that produced the token. To get a complete list, call this operation until &#x60;nextToken&#x60; is null. Note that this operation can return empty pages.
+     */
+    readonly nextToken?: string;
+}
+/**
+ * ExternalFulfillmentReturnsApi - object-oriented interface
+ */
+declare class ExternalFulfillmentReturnsApi extends BaseAPI {
+    /**
+     * Retrieve the return item with the specified ID.
+     * @param {ExternalFulfillmentReturnsApiGetReturnRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getReturn(requestParameters: ExternalFulfillmentReturnsApiGetReturnRequest, options?: RawAxiosRequestConfig): Promise<axios.AxiosResponse<Return, any, {}>>;
+    /**
+     * Retrieve a list of return items. You can filter results by location, RMA ID, status, or time.
+     * @param {ExternalFulfillmentReturnsApiListReturnsRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listReturns(requestParameters?: ExternalFulfillmentReturnsApiListReturnsRequest, options?: RawAxiosRequestConfig): Promise<axios.AxiosResponse<ReturnsResponse, any, {}>>;
+}
+declare const ListReturnsStatusEnum: {
+    readonly Created: "CREATED";
+    readonly CarrierNotifiedToPickUpFromCustomer: "CARRIER_NOTIFIED_TO_PICK_UP_FROM_CUSTOMER";
+    readonly CarrierOutForPickUpFromCustomer: "CARRIER_OUT_FOR_PICK_UP_FROM_CUSTOMER";
+    readonly CustomerCancelledPickUp: "CUSTOMER_CANCELLED_PICK_UP";
+    readonly CustomerRescheduledPickUp: "CUSTOMER_RESCHEDULED_PICK_UP";
+    readonly PickedFromCustomer: "PICKED_FROM_CUSTOMER";
+    readonly InTransit: "IN_TRANSIT";
+    readonly OutForDelivery: "OUT_FOR_DELIVERY";
+    readonly Delivered: "DELIVERED";
+    readonly Replanned: "REPLANNED";
+    readonly CustomerDroppedOff: "CUSTOMER_DROPPED_OFF";
+    readonly PartiallyProcessed: "PARTIALLY_PROCESSED";
+    readonly Processed: "PROCESSED";
+    readonly Rejected: "REJECTED";
+    readonly Cancelled: "CANCELLED";
+};
+type ListReturnsStatusEnum = typeof ListReturnsStatusEnum[keyof typeof ListReturnsStatusEnum];
+
+declare const clientRateLimits: RateLimit[];
+declare class ExternalFulfillmentReturnsApiClient extends ExternalFulfillmentReturnsApi {
+    constructor(configuration: ClientConfiguration);
+}
+
+export { type ErrorList, ExternalFulfillmentReturnsApi, ExternalFulfillmentReturnsApiAxiosParamCreator, ExternalFulfillmentReturnsApiClient, ExternalFulfillmentReturnsApiFactory, ExternalFulfillmentReturnsApiFp, type ExternalFulfillmentReturnsApiGetReturnRequest, type ExternalFulfillmentReturnsApiListReturnsRequest, type InvoiceInformation, ListReturnsStatusEnum, type MarketplaceChannel, type MarketplaceChannelDetails, type ModelError, type OtpDetails, type ReplanningDetails, type Return, type ReturnMetadata, ReturnPackageDeliveryModeEnum, ReturnReturnSubTypeEnum, ReturnReturnTypeEnum, type ReturnShippingInfo, ReturnStatusEnum, type ReturnsResponse, type TrackingInfo, clientRateLimits };