amazon-orders 4.4.2__tar.gz → 4.4.3__tar.gz

{amazon_orders-4.4.2 → amazon_orders-4.4.3}/CHANGELOG.md

@@ -4,7 +4,14 @@ All notable changes to this project will be documented in this file.
 
 This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased](https://github.com/alexdlaird/amazon-orders/compare/4.4.2...HEAD)
+## [Unreleased](https://github.com/alexdlaird/amazon-orders/compare/4.4.3...HEAD)
+
+## [4.4.3](https://github.com/alexdlaird/amazon-orders/compare/4.4.2...4.4.3) - 2026-07-06
+
+### Added
+
+- `AmazonOrders.get_order_history()` `order_filter` parameter to filter by order type via Amazon's `orderFilter` query parameter. `--order-filter` added to the `history` CLI command.
+- `invoice` and `order-transactions` CLI commands, adding parity with `AmazonOrders.get_invoice()` and `AmazonTransactions.get_transactions(order_id=)`.
 
 ## [4.4.2](https://github.com/alexdlaird/amazon-orders/compare/4.4.1...4.4.2) - 2026-07-05
 

{amazon_orders-4.4.2/amazon_orders.egg-info → amazon_orders-4.4.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: amazon-orders
-Version: 4.4.2
+Version: 4.4.3
 Summary: A Python library (and CLI) for Amazon order history
 Author-email: Alex Laird <contact@alexlaird.com>
 Maintainer-email: Alex Laird <contact@alexlaird.com>

{amazon_orders-4.4.2 → amazon_orders-4.4.3/amazon_orders.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: amazon-orders
-Version: 4.4.2
+Version: 4.4.3
 Summary: A Python library (and CLI) for Amazon order history
 Author-email: Alex Laird <contact@alexlaird.com>
 Maintainer-email: Alex Laird <contact@alexlaird.com>

{amazon_orders-4.4.2 → amazon_orders-4.4.3}/amazonorders/__init__.py

@@ -1,3 +1,3 @@
 __copyright__ = "Copyright (c) 2024-2025 Alex Laird"
 __license__ = "MIT"
-__version__ = "4.4.2"
+__version__ = "4.4.3"

{amazon_orders-4.4.2 → amazon_orders-4.4.3}/amazonorders/cli.py

@@ -126,6 +126,8 @@ def amazon_orders_cli(ctx: Context,
 @click.option("--full-details", is_flag=True, default=False,
               help="Get the full details for each Order in the history. "
                    "This will execute an additional request per Order.")
+@click.option("--order-filter", "order_filter", default=None,
+              help="The order type filter to use.")
 def history(ctx: Context,
             **kwargs: Any) -> None:
     """
@@ -142,6 +144,7 @@ def history(ctx: Context,
         start_index = kwargs["start_index"]
         single_page = kwargs["single_page"]
         full_details = kwargs["full_details"]
+        order_filter = kwargs["order_filter"]
 
         exclusive_flags = [year, last_3_months, last_30_days]
         if not all(not item for item in exclusive_flags) and sum(exclusive_flags) == 1:
@@ -180,7 +183,8 @@ Order History for {filter_description}{optional_start_index}{optional_full_detai
                                                  start_index=start_index,
                                                  full_details=full_details,
                                                  keep_paging=not single_page,
-                                                 time_filter=time_filter):
+                                                 time_filter=time_filter,
+                                                 order_filter=order_filter):
             click.echo(f"{_order_output(o, config)}\n")
             total += 1
         end_time = time.time()
@@ -222,6 +226,67 @@ def order(ctx: Context,
         ctx.fail(str(e))
 
 
+@amazon_orders_cli.command()
+@click.pass_context
+@click.argument("order_id")
+def invoice(ctx: Context,
+            order_id: str) -> None:
+    """
+    Get the invoice for a given Amazon Order ID.
+    """
+    amazon_session = ctx.obj["amazon_session"]
+
+    try:
+        _authenticate(amazon_session)
+
+        config = ctx.obj["conf"]
+        amazon_orders = AmazonOrders(amazon_session,
+                                     config=config)
+
+        invoice_response = amazon_orders.get_invoice(order_id)
+
+        click.echo(invoice_response.response.text)
+    except AmazonOrdersAuthRedirectError:
+        _prompt_to_reauth_flow()
+    except AmazonOrdersError as e:
+        logger.debug("An error occurred.", exc_info=True)
+        ctx.fail(str(e))
+
+
+@amazon_orders_cli.command("order-transactions")
+@click.pass_context
+@click.argument("order_id")
+def order_transactions(ctx: Context,
+                       order_id: str) -> None:
+    """
+    Get the Transactions for a given Amazon Order ID.
+    """
+    amazon_session = ctx.obj["amazon_session"]
+
+    try:
+        _authenticate(amazon_session)
+
+        config = ctx.obj["conf"]
+        amazon_transactions = AmazonTransactions(amazon_session,
+                                                 config=config)
+
+        start_time = time.time()
+        total = 0
+        for t in amazon_transactions.get_transactions(order_id=order_id):
+            click.echo(f"{_transaction_output(t, config)}\n")
+            total += 1
+        end_time = time.time()
+
+        click.echo(
+            "... {total} Transactions parsed in {time} seconds.\n".format(total=total,
+                                                                          time=int(end_time - start_time)))
+    except AmazonOrdersAuthRedirectError:
+        _prompt_to_reauth_flow()
+    except AmazonOrdersError as e:
+        logger.debug("An error occurred.", exc_info=True)
+        ctx.fail(str(e))
+
+
 @amazon_orders_cli.command()
 @click.pass_context
 @click.option("--days", default=365,

{amazon_orders-4.4.2 → amazon_orders-4.4.3}/amazonorders/constants.py

@@ -112,6 +112,7 @@ class Constants:
     ORDER_DETAILS_URL = f"{BASE_URL}/gp/your-account/order-details"
     ORDER_INVOICE_URL = f"{BASE_URL}/gp/css/summary/print.html"
     HISTORY_FILTER_QUERY_PARAM = "timeFilter"
+    ORDER_FILTER_QUERY_PARAM = "orderFilter"
 
     ##########################################################################
     # URLs for Transactions

{amazon_orders-4.4.2 → amazon_orders-4.4.3}/amazonorders/orders.py

@@ -6,6 +6,7 @@ import concurrent.futures
 import datetime
 import logging
 from typing import Any, Callable, List, Optional
+from urllib.parse import quote
 
 from bs4 import Tag
 
@@ -103,7 +104,8 @@ class AmazonOrders:
                           start_index: Optional[int] = None,
                           full_details: bool = False,
                           keep_paging: bool = True,
-                          time_filter: Optional[str] = None) -> List[Order]:
+                          time_filter: Optional[str] = None,
+                          order_filter: Optional[str] = None) -> List[Order]:
         """
         Get the Amazon Order history for a given time period.
 
@@ -119,6 +121,7 @@ class AmazonOrders:
         :param time_filter: The time filter to use. Supported values are ``"last30"`` (last 30 days),
             ``"months-3"`` (past 3 months), or ``"year-YYYY"`` (specific year). If provided, this takes
             precedence over the ``year`` parameter.
+        :param order_filter: The order type filter to use. If provided, appended alongside the time filter.
         :return: A list of the requested Orders.
         """
         if not self.amazon_session.is_authenticated:
@@ -144,12 +147,17 @@ class AmazonOrders:
             filter_value = f"year-{year}"
 
         optional_start_index = f"&startIndex={start_index}" if start_index else ""
+        optional_order_filter = (
+            f"&{self.config.constants.ORDER_FILTER_QUERY_PARAM}={quote(order_filter, safe='')}"
+            if order_filter else ""
+        )
         next_page: Optional[str] = (
-            "{url}?{query_param}={filter_value}{optional_start_index}"
+            "{url}?{query_param}={filter_value}{optional_order_filter}{optional_start_index}"
         ).format(
             url=self.config.constants.ORDER_HISTORY_URL,
             query_param=self.config.constants.HISTORY_FILTER_QUERY_PARAM,
             filter_value=filter_value,
+            optional_order_filter=optional_order_filter,
             optional_start_index=optional_start_index
         )