Python-amazon-sp-api

Changes Relevant to Users

- **Pagination Enhancements**
- Improved the `ApiResponse` class to better handle pagination by adding support for an additional `nextToken` key in the response payload. This enhancement ensures more reliable navigation through paginated data.

mermaid
graph TD;
A[Version 1.9.23] -->|Improved| B[Version 1.9.24];
B --> C[ApiResponse];
C --> D[nextToken Support];


Internal Changes

- **Code Quality Improvements**
- Minor formatting adjustments in `load_all_pages.py` to enhance code readability and maintain consistency.

mermaid
graph TD;
A[Version 1.9.23] -->|Refined| B[Version 1.9.24];
B --> C[load_all_pages.py];
C --> D[Formatting Adjustments];


These changes aim to improve the overall functionality and maintainability of the `python-amazon-sp-api` package, ensuring a smoother experience for developers interacting with Amazon's Selling Partner API.

New Features

- **Finances API Enhancements**
- Introduced versioning support for the `Finances` client, allowing users to specify API versions when interacting with financial endpoints.
- Added a new `list_transactions` endpoint to the `Finances` client for retrieving transaction details.

mermaid
graph TD;
A[Version 1.9.22] -->|Enhanced| B[Version 1.9.23];
B --> C[Finances API];
C --> D[Versioning Support];
C --> E[list_transactions];


Internal Changes

- **Dependencies Update**
- Updated `boto3` library dependency from `~=1.37.14` to `~=1.37.17` to ensure compatibility with the latest features and security patches.
- Updated `setuptools` library dependency from `~=75.8.2` to `~=77.0.3`.

mermaid
graph TD;
A[Version 1.9.22] -->|Updated| B[Version 1.9.23];
B --> C[boto3 ~=1.37.17];
A --> D[boto3 ~=1.37.14];
B --> E[setuptools ~=77.0.3];
A --> F[setuptools ~=75.8.2];

New Features

- **Finances API Enhancements**
- Introduced versioning support for the `Finances` client, allowing users to specify API versions when interacting with financial endpoints.
- Added a new `list_transactions` endpoint to the `Finances` client for retrieving transaction details.

mermaid
graph TD;
A[Version 1.9.21] -->|Enhanced| B[Version 1.9.22];
B --> C[Finances API];
C --> D[Versioning Support];
C --> E[list_transactions];


Internal Changes

- **Dependencies Update**
- Updated `boto3` library dependency from `~=1.37.12` to `~=1.37.14` to ensure compatibility with the latest features and security patches.

mermaid
graph TD;
A[Version 1.9.21] -->|Updated| B[Version 1.9.22];
B --> C[boto3 ~=1.37.14];
A --> D[boto3 ~=1.37.12];

New Features

- **Easy Ship API Integration**
- Introduced a new `EasyShip` client in the `sp_api.api` module, allowing users to manage and ship Amazon Easy Ship orders.
- Added several new endpoints under the `EasyShip` client:
- `list_handover_slots`: Retrieve available time slots for scheduling Easy Ship orders.
- `get_scheduled_package`: Get detailed information about a scheduled package.
- `create_scheduled_package`: Schedule an Easy Ship order and obtain package information.
- `update_scheduled_packages`: Update the time slot for a scheduled package.
- `create_scheduled_package_bulk`: Schedule multiple Easy Ship orders and generate shipping labels in bulk.

mermaid
graph TD;
A[Version 1.9.20] -->|Added| B[Version 1.9.21];
B --> C[EasyShip API];
C --> D[list_handover_slots];
C --> E[get_scheduled_package];
C --> F[create_scheduled_package];
C --> G[update_scheduled_packages];
C --> H[create_scheduled_package_bulk];


Internal Changes

- **Dependencies Update**
- Updated `requests` library dependency from `>=2.32.0` to `>=2.32.1` to ensure compatibility with the latest features and security patches.

mermaid
graph TD;
A[Version 1.9.20] -->|Updated| B[Version 1.9.21];
B --> C[Requests >=2.32.1];
A --> D[Requests >=2.32.0];

Internal Changes

- **Dependencies Update**
- Updated `requests` library dependency from `>=2.32.0` to `>=2.32.1`.

mermaid
graph TD;
A[Version 1.9.19] -->|Updated| B[Version 1.9.20];
B --> C[Requests >=2.32.1];
A --> D[Requests >=2.32.0];


This update ensures compatibility with the latest features and security patches of the `requests` library.

Changes Relevant to End-Users
- **New Report Types**: Added support for new brand analytics report types in the `ReportType` enum:
- `GET_BRAND_ANALYTICS_SEARCH_CATALOG_PERFORMANCE_REPORT`
- `GET_BRAND_ANALYTICS_SEARCH_QUERY_PERFORMANCE_REPORT`

Internal Changes
- **Dependency Updates**: Updated dependencies for improved performance and security:
- `boto3` updated from `1.37.0` to `1.37.2`
- `setuptools` updated from `75.8.0` to `75.8.2`

Mermaid Diagram Representation

mermaid
graph TD;
A[ReportType Enum] -->|Added| B[GET_BRAND_ANALYTICS_SEARCH_CATALOG_PERFORMANCE_REPORT];
A -->|Added| C[GET_BRAND_ANALYTICS_SEARCH_QUERY_PERFORMANCE_REPORT];
D[Dependencies] -->|Updated| E[boto3, setuptools];


This release introduces new report types for enhanced brand analytics capabilities and updates dependencies for better stability and security.