makea-cli 0.2.16__py3-none-any.whl → 0.2.17__py3-none-any.whl

makea_cli/__init__.py

@@ -1 +1 @@
-__version__ = "0.2.16"
+__version__ = "0.2.17"

makea_cli/api_client.py

@@ -766,6 +766,89 @@ def get_all_shipping_orders(
     return get_json("/admin/shipping_orders", params=params)
 
 
+def admin_create_shipping_order(body: dict[str, Any]) -> Any:
+    """POST /admin/shipping_orders/create — a shipment for a brand's production/sampling orders."""
+    return post_json("/admin/shipping_orders/create", body)
+
+
+def admin_get_shipping_order(shipping_order_id: str) -> Any:
+    """GET /admin/shipping_orders/{id}/details — the shipment with its orders filled in."""
+    return get_json(f"/admin/shipping_orders/{shipping_order_id}/details")
+
+
+def admin_update_shipping_order_status(shipping_order_id: str, status: str) -> Any:
+    """PUT /admin/shipping_orders/{id}/status"""
+    return put_json(f"/admin/shipping_orders/{shipping_order_id}/status", {"status": status})
+
+
+def admin_update_shipping_order_tracking(
+    shipping_order_id: str, tracking_info: dict[str, Any]
+) -> Any:
+    """POST /admin/shipping_orders/{id}/tracking"""
+    return post_json(
+        f"/admin/shipping_orders/{shipping_order_id}/tracking", {"tracking_info": tracking_info}
+    )
+
+
+def admin_update_shipping_order_address(
+    shipping_order_id: str, shipping_address: dict[str, Any]
+) -> Any:
+    """PUT /admin/shipping_orders/{id}/shipping-address"""
+    return put_json(
+        f"/admin/shipping_orders/{shipping_order_id}/shipping-address",
+        {"shipping_address": shipping_address},
+    )
+
+
+def admin_update_shipping_order_cargo(shipping_order_id: str, cargo: dict[str, Any]) -> Any:
+    """PUT /admin/shipping_orders/{id}/cargo — cartons and/or gross_weight_kg."""
+    return put_json(f"/admin/shipping_orders/{shipping_order_id}/cargo", cargo)
+
+
+def admin_delete_shipping_order(shipping_order_id: str) -> Any:
+    """DELETE /admin/shipping_orders/{id}/delete — soft delete; unlinks its orders."""
+    return delete_json(f"/admin/shipping_orders/{shipping_order_id}/delete")
+
+
+def admin_add_shipping_option(shipping_order_id: str, option: dict[str, Any]) -> Any:
+    """POST /admin/shipping_orders/{id}/shipping-options — one freight quote."""
+    return post_json(
+        f"/admin/shipping_orders/{shipping_order_id}/shipping-options",
+        {"shipping_option": option},
+    )
+
+
+def admin_remove_shipping_option(shipping_order_id: str, shipping_option_id: str) -> Any:
+    """DELETE /admin/shipping_orders/{id}/shipping-options/{option_id}/remove"""
+    return delete_json(
+        f"/admin/shipping_orders/{shipping_order_id}/shipping-options/{shipping_option_id}/remove"
+    )
+
+
+def admin_add_shipping_order_fee(shipping_order_id: str, fee: dict[str, Any]) -> Any:
+    """POST /admin/shipping_orders/{id}/fees/add"""
+    return post_json(f"/admin/shipping_orders/{shipping_order_id}/fees/add", fee)
+
+
+def admin_remove_shipping_order_fee(shipping_order_id: str, fee_id: str) -> Any:
+    """DELETE /admin/shipping_orders/{id}/fees/{fee_id}/remove"""
+    return delete_json(f"/admin/shipping_orders/{shipping_order_id}/fees/{fee_id}/remove")
+
+
+def admin_unlink_from_shipping_order(
+    shipping_order_id: str,
+    *,
+    production_order_id: str | None = None,
+    sampling_order_id: str | None = None,
+) -> Any:
+    """POST /admin/{production|sampling}_orders/{id}/unlink_from_shipping_order/{shipping_order_id}"""
+    if production_order_id:
+        path = f"/admin/production_orders/{production_order_id}"
+    else:
+        path = f"/admin/sampling_orders/{sampling_order_id}"
+    return post_json(f"{path}/unlink_from_shipping_order/{shipping_order_id}", {})
+
+
 def get_misc_payments_by_product(product_id: str) -> Any:
     """GET /admin/products/{product_id}/misc-payments — misc payments for one product."""
     return get_json(f"/admin/products/{product_id}/misc-payments")

makea_cli/commands/__init__.py

@@ -16,6 +16,7 @@ from makea_cli.commands.orders.cmd import register as register_orders
 from makea_cli.commands.playbook.cmd import register as register_playbook
 from makea_cli.commands.product.cmd import register as register_product
 from makea_cli.commands.production.cmd import register as register_production
+from makea_cli.commands.shipping.cmd import register as register_shipping
 from makea_cli.commands.supplier.cmd import register as register_supplier
 
 
@@ -27,6 +28,7 @@ def register_all(app: typer.Typer) -> None:
     register_orders(app)
     register_product(app)
     register_production(app)
+    register_shipping(app)
     register_designer(app)
     register_metrics(app)
     register_analytics(app)

makea_cli/commands/shipping/cmd.py

@@ -0,0 +1,422 @@
+"""Admin shipping orders: make one for a brand, then run it (status, tracking, quotes, fees)."""
+
+from __future__ import annotations
+
+import json
+from pathlib import Path
+from typing import Any
+
+import typer
+from rich.console import Console
+
+from makea_cli import api_client
+from makea_cli.commands._util import print_json_or_exit
+from makea_cli.registry import command
+
+console = Console()
+
+SHIPPING_STATUSES = ("DRAFT", "SUBMITTED", "READY_TO_PAY", "PAID", "IN_TRANSIT", "DELIVERED")
+SHIPPING_MODES = ("AIR", "SEA", "LAND", "TRUCK", "RAIL", "SEA_TRUCK")
+FEE_TYPES = ("SHIPPING", "SERVICE", "HANDLING", "CUSTOMS", "INSURANCE", "TRANSACTION", "OTHER")
+
+
+def _address(raw: str | None, path: Path | None) -> dict[str, Any] | None:
+    if raw is None and path is None:
+        return None
+    if raw is not None and path is not None:
+        raise typer.BadParameter("pass only one of --address / --address-file")
+    text = raw if raw is not None else path.read_text(encoding="utf-8")  # type: ignore[union-attr]
+    try:
+        data = json.loads(text)
+    except json.JSONDecodeError as e:
+        raise typer.BadParameter(f"address: invalid JSON ({e})") from e
+    if not isinstance(data, dict):
+        raise typer.BadParameter("address: expected a JSON object")
+    return data
+
+
+def _choice(value: str | None, allowed: tuple[str, ...], flag: str) -> str | None:
+    if value is None:
+        return None
+    v = value.strip().upper()
+    if v not in allowed:
+        raise typer.BadParameter(f"{flag} must be one of {', '.join(allowed)}")
+    return v
+
+
+_ADDRESS_HELP = (
+    "Shipping address as a JSON object: street, city, state, postal_code, country "
+    "(plus contact_name / phone if known)."
+)
+
+
+def register(app: typer.Typer) -> None:
+    @command(
+        app,
+        "admin",
+        "create",
+        "shipping-order",
+        api="POST /admin/shipping_orders/create",
+        side_effects=[
+            "links the orders to the new shipment (the brand sees it on its Ship page)",
+            "adds the fulfilment service fee for the brand's plan",
+        ],
+        approval="ask",
+        help=(
+            "POST /admin/shipping_orders/create — make a shipment for a brand's production "
+            "and/or sampling orders. The shipment belongs to the orders' owner; you are "
+            "recorded as created_by. Orders already on a live shipment are refused (unlink "
+            "first), and one shipment carries one supplier's goods."
+        ),
+    )
+    def create_shipping_order(
+        production_order: list[str] | None = typer.Option(
+            None, "--production-order", "-p", help="Production order id; repeat for several."
+        ),
+        sampling_order: list[str] | None = typer.Option(
+            None, "--sampling-order", "-s", help="Sampling order id; repeat for several."
+        ),
+        mode: str | None = typer.Option(
+            None,
+            "--mode",
+            help=f"Freight method the brand wants quoted: {', '.join(SHIPPING_MODES)}. "
+            "Leave out to keep it open.",
+        ),
+        status: str | None = typer.Option(
+            None,
+            "--status",
+            help="Starting status (default SUBMITTED, i.e. waiting for freight quotes).",
+        ),
+        address: str | None = typer.Option(
+            None,
+            "--address",
+            help=_ADDRESS_HELP + " Default: the first order's shipping address.",
+        ),
+        address_file: Path | None = typer.Option(
+            None, "--address-file", help="Same as --address, read from a file."
+        ),
+        reference_id: str | None = typer.Option(
+            None, "--reference-id", help="External reference (default admin_<timestamp>)."
+        ),
+    ) -> None:
+        """Create a shipping order for a brand."""
+        if not production_order and not sampling_order:
+            raise typer.BadParameter("pass at least one --production-order or --sampling-order")
+        body: dict[str, Any] = {
+            "production_order_ids": production_order or [],
+            "sampling_order_ids": sampling_order or [],
+        }
+        shipping_address = _address(address, address_file)
+        if shipping_address is not None:
+            body["shipping_address"] = shipping_address
+        if mode:
+            body["shipping_mode"] = _choice(mode, SHIPPING_MODES, "--mode")
+        if status:
+            body["status"] = _choice(status, SHIPPING_STATUSES, "--status")
+        if reference_id:
+            body["reference_id"] = reference_id
+        print_json_or_exit(console, lambda: api_client.admin_create_shipping_order(body))
+
+    @command(
+        app,
+        "admin",
+        "get",
+        "shipping-order",
+        api="GET /admin/shipping_orders/{shipping_order_id}/details",
+        help=(
+            "GET /admin/shipping_orders/{id}/details — one shipment with its production and "
+            "sampling orders, freight quotes, fees, tracking and address."
+        ),
+    )
+    def get_shipping_order(
+        shipping_order_id: str = typer.Argument(..., help="Shipping order id."),
+    ) -> None:
+        """Show one shipping order."""
+        print_json_or_exit(console, lambda: api_client.admin_get_shipping_order(shipping_order_id))
+
+    @command(
+        app,
+        "admin",
+        "update",
+        "shipping-order",
+        api="PUT /admin/shipping_orders/{shipping_order_id}/status",
+        side_effects=[
+            "--status IN_TRANSIT stamps the departure date the brand's ETA is counted from",
+            "each group of flags is its own request; a later one failing leaves earlier ones applied",
+        ],
+        approval="ask",
+        help=(
+            "Change a shipment: --status (PUT .../status), tracking flags (POST .../tracking), "
+            "--address (PUT .../shipping-address), --cartons / --gross-weight-kg "
+            "(PUT .../cargo). Pass any combination; they run in that order."
+        ),
+    )
+    def update_shipping_order(
+        shipping_order_id: str = typer.Argument(..., help="Shipping order id."),
+        status: str | None = typer.Option(
+            None, "--status", help=f"New status: {', '.join(SHIPPING_STATUSES)}."
+        ),
+        tracking_number: str | None = typer.Option(
+            None, "--tracking-number", help="Carrier tracking number."
+        ),
+        tracking_url: str | None = typer.Option(None, "--tracking-url", help="Tracking page URL."),
+        shipping_method: str | None = typer.Option(
+            None, "--shipping-method", help="Free text, e.g. 'DHL Express'."
+        ),
+        carrier_id: str | None = typer.Option(
+            None, "--carrier-id", help="Carrier code (17track numbering), optional."
+        ),
+        address: str | None = typer.Option(None, "--address", help=_ADDRESS_HELP),
+        address_file: Path | None = typer.Option(
+            None, "--address-file", help="Same as --address, read from a file."
+        ),
+        cartons: int | None = typer.Option(None, "--cartons", help="Number of cartons."),
+        gross_weight_kg: float | None = typer.Option(
+            None, "--gross-weight-kg", help="Total gross weight in kg."
+        ),
+    ) -> None:
+        """Update status, tracking, address and/or cargo of a shipping order."""
+        new_status = _choice(status, SHIPPING_STATUSES, "--status")
+        tracking: dict[str, Any] = {
+            k: v
+            for k, v in {
+                "tracking_number": tracking_number,
+                "tracking_url": tracking_url,
+                "shipping_method": shipping_method,
+                "carrier_id": carrier_id,
+            }.items()
+            if v is not None
+        }
+        if tracking and not (tracking_number or tracking_url or shipping_method):
+            raise typer.BadParameter(
+                "--carrier-id needs --tracking-number, --tracking-url or --shipping-method"
+            )
+        shipping_address = _address(address, address_file)
+        cargo: dict[str, Any] = {}
+        if cartons is not None:
+            cargo["cartons"] = cartons
+        if gross_weight_kg is not None:
+            cargo["gross_weight_kg"] = gross_weight_kg
+        if not (new_status or tracking or shipping_address is not None or cargo):
+            raise typer.BadParameter(
+                "nothing to change: pass --status, tracking flags, --address or cargo flags"
+            )
+
+        def run() -> Any:
+            results: dict[str, Any] = {}
+            if new_status:
+                results["status"] = api_client.admin_update_shipping_order_status(
+                    shipping_order_id, new_status
+                )
+            if tracking:
+                results["tracking"] = api_client.admin_update_shipping_order_tracking(
+                    shipping_order_id, tracking
+                )
+            if shipping_address is not None:
+                results["shipping_address"] = api_client.admin_update_shipping_order_address(
+                    shipping_order_id, shipping_address
+                )
+            if cargo:
+                results["cargo"] = api_client.admin_update_shipping_order_cargo(
+                    shipping_order_id, cargo
+                )
+            return results
+
+        print_json_or_exit(console, run)
+
+    @command(
+        app,
+        "admin",
+        "delete",
+        "shipping-order",
+        api="DELETE /admin/shipping_orders/{shipping_order_id}/delete",
+        side_effects=[
+            "soft-deletes the shipment",
+            "unlinks its production and sampling orders so they can ship again",
+        ],
+        approval="never",
+        help=(
+            "DELETE /admin/shipping_orders/{id}/delete — remove a shipment and free its orders. "
+            "Graded `never`: the backend does not check status, so it removes a paid or in-transit shipment too."
+        ),
+    )
+    def delete_shipping_order(
+        shipping_order_id: str = typer.Argument(..., help="Shipping order id."),
+    ) -> None:
+        """Delete a shipping order."""
+        print_json_or_exit(
+            console, lambda: api_client.admin_delete_shipping_order(shipping_order_id)
+        )
+
+    @command(
+        app,
+        "admin",
+        "delete",
+        "shipping-order-item",
+        api="POST /admin/production_orders/{id}/unlink_from_shipping_order/{shipping_order_id}",
+        side_effects=[
+            "takes the order off the shipment",
+            "deletes the shipment if that was its last order",
+        ],
+        approval="ask",
+        help=(
+            "POST /admin/{production|sampling}_orders/{id}/unlink_from_shipping_order/{so_id} — "
+            "take one production or sampling order off a shipment. A shipment left empty is "
+            "deleted."
+        ),
+    )
+    def delete_shipping_order_item(
+        shipping_order_id: str = typer.Argument(..., help="Shipping order id."),
+        production_order: str | None = typer.Option(
+            None, "--production-order", "-p", help="Production order to take off."
+        ),
+        sampling_order: str | None = typer.Option(
+            None, "--sampling-order", "-s", help="Sampling order to take off."
+        ),
+    ) -> None:
+        """Unlink one order from a shipping order."""
+        if bool(production_order) == bool(sampling_order):
+            raise typer.BadParameter("pass exactly one of --production-order / --sampling-order")
+        print_json_or_exit(
+            console,
+            lambda: api_client.admin_unlink_from_shipping_order(
+                shipping_order_id,
+                production_order_id=production_order,
+                sampling_order_id=sampling_order,
+            ),
+        )
+
+    @command(
+        app,
+        "admin",
+        "create",
+        "shipping-option",
+        api="POST /admin/shipping_orders/{shipping_order_id}/shipping-options",
+        side_effects=[
+            "adds a freight quote the brand can pick and pay for",
+            "the first quote on a shipment is auto-selected",
+        ],
+        approval="ask",
+        help=(
+            "POST /admin/shipping_orders/{id}/shipping-options — add one freight quote "
+            "(provider, speed, price, currency)."
+        ),
+    )
+    def create_shipping_option(
+        shipping_order_id: str = typer.Argument(..., help="Shipping order id."),
+        provider: str = typer.Option(..., "--provider", help="Forwarder / carrier, e.g. DHL."),
+        speed: str = typer.Option(..., "--speed", help="e.g. Standard, Express, Sea freight."),
+        price: str = typer.Option(..., "--price", help="Price as a number, e.g. 412.50."),
+        currency: str = typer.Option(..., "--currency", help="ISO code, e.g. GBP."),
+        days: int | None = typer.Option(None, "--days", help="Estimated delivery days."),
+        description: str | None = typer.Option(None, "--description", help="Shown to the brand."),
+        valid_until: str | None = typer.Option(
+            None, "--valid-until", help="Quote valid until, YYYY-MM-DD."
+        ),
+        includes_duties: bool | None = typer.Option(
+            None,
+            "--includes-duties/--excludes-duties",
+            help="Whether the price includes destination customs and duties.",
+        ),
+        selected: bool = typer.Option(
+            False, "--selected", help="Mark this quote as the chosen one."
+        ),
+    ) -> None:
+        """Add a freight quote to a shipping order."""
+        option: dict[str, Any] = {
+            "provider": provider,
+            "speed": speed,
+            "price": price,
+            "currency": currency.strip().upper(),
+            "selected": selected,
+        }
+        if days is not None:
+            option["estimated_delivery_days"] = days
+        if description:
+            option["description"] = description
+        if valid_until:
+            option["valid_until"] = valid_until
+        if includes_duties is not None:
+            option["includes_customs_and_duties"] = includes_duties
+        print_json_or_exit(
+            console, lambda: api_client.admin_add_shipping_option(shipping_order_id, option)
+        )
+
+    @command(
+        app,
+        "admin",
+        "delete",
+        "shipping-option",
+        api="DELETE /admin/shipping_orders/{shipping_order_id}/shipping-options/{shipping_option_id}/remove",
+        side_effects=["removes the freight quote from the brand's choices"],
+        approval="ask",
+        help="DELETE .../shipping-options/{option_id}/remove — withdraw one freight quote.",
+    )
+    def delete_shipping_option(
+        shipping_order_id: str = typer.Argument(..., help="Shipping order id."),
+        shipping_option_id: str = typer.Argument(..., help="Shipping option id."),
+    ) -> None:
+        """Remove a freight quote from a shipping order."""
+        print_json_or_exit(
+            console,
+            lambda: api_client.admin_remove_shipping_option(shipping_order_id, shipping_option_id),
+        )
+
+    @command(
+        app,
+        "admin",
+        "create",
+        "shipping-fee",
+        api="POST /admin/shipping_orders/{shipping_order_id}/fees/add",
+        side_effects=["adds a charge to what the brand pays for this shipment"],
+        approval="ask",
+        help=(
+            "POST /admin/shipping_orders/{id}/fees/add — add a fee (fixed amount or percentage) "
+            "on top of the freight."
+        ),
+    )
+    def create_shipping_fee(
+        shipping_order_id: str = typer.Argument(..., help="Shipping order id."),
+        fee_type: str = typer.Option(..., "--fee-type", help=f"One of {', '.join(FEE_TYPES)}."),
+        name: str = typer.Option(..., "--name", help="Label the brand sees."),
+        value: str = typer.Option(
+            ..., "--value", help="Amount (FIXED) or percent (PERCENTAGE, e.g. 10 for 10%)."
+        ),
+        calculation_type: str = typer.Option(
+            "FIXED", "--calculation-type", help="FIXED or PERCENTAGE."
+        ),
+        description: str | None = typer.Option(None, "--description", help="Optional note."),
+    ) -> None:
+        """Add a fee to a shipping order."""
+        fee: dict[str, Any] = {
+            "fee_type": _choice(fee_type, FEE_TYPES, "--fee-type"),
+            "name": name,
+            "value": value,
+            "calculation_type": _choice(
+                calculation_type, ("FIXED", "PERCENTAGE"), "--calculation-type"
+            ),
+        }
+        if description:
+            fee["description"] = description
+        print_json_or_exit(
+            console, lambda: api_client.admin_add_shipping_order_fee(shipping_order_id, fee)
+        )
+
+    @command(
+        app,
+        "admin",
+        "delete",
+        "shipping-fee",
+        api="DELETE /admin/shipping_orders/{shipping_order_id}/fees/{fee_id}/remove",
+        side_effects=["removes the charge from what the brand pays"],
+        approval="ask",
+        help="DELETE /admin/shipping_orders/{id}/fees/{fee_id}/remove — remove one fee.",
+    )
+    def delete_shipping_fee(
+        shipping_order_id: str = typer.Argument(..., help="Shipping order id."),
+        fee_id: str = typer.Argument(..., help="Fee id (from admin get shipping-order)."),
+    ) -> None:
+        """Remove a fee from a shipping order."""
+        print_json_or_exit(
+            console, lambda: api_client.admin_remove_shipping_order_fee(shipping_order_id, fee_id)
+        )

{makea_cli-0.2.16.dist-info → makea_cli-0.2.17.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: makea-cli
-Version: 0.2.16
+Version: 0.2.17
 Summary: Makea admin CLI (browser login + Makea admin HTTP API)
 Requires-Python: >=3.10
 Requires-Dist: click<9,>=8.1
@@ -93,10 +93,17 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin create library-element` | write（auto） | `POST /admin/designer/{user_id}/library_components` | save a reusable component under a designer. Provide --section and --values (see admin get library-schema). | `library-create` |
 | `makea-cli admin create quote-request` | write（ask） | `POST /admin/supplier/create_quote_request` | create/send a quote request to a supplier for a product (admin). | `create-quote-request` |
 | `makea-cli admin create rule` | write（ask） | `POST /admin/playbook/users/{user}/rules` | add a rule to one person's AI playbook (user_id or email); admin-authored, active unless --status. Refuses a repeat or a conflict unless --force. --reason required. | — |
+| `makea-cli admin create shipping-fee` | write（ask） | `POST /admin/shipping_orders/{shipping_order_id}/fees/add` | add a fee (fixed amount or percentage) on top of the freight. | — |
+| `makea-cli admin create shipping-option` | write（ask） | `POST /admin/shipping_orders/{shipping_order_id}/shipping-options` | add one freight quote (provider, speed, price, currency). | — |
+| `makea-cli admin create shipping-order` | write（ask） | `POST /admin/shipping_orders/create` | make a shipment for a brand's production and/or sampling orders. The shipment belongs to the orders' owner; you are r… | — |
 | `makea-cli admin create supplier` | write（ask） | `POST /admin/supplier/add_supplier` | create supplier from JSON file (admin). Run `makea-cli get-supplier-profile-schema` FIRST to get the field taxonomy (… | `add-supplier` |
 | `makea-cli admin create user` | write（never） | `POST /admin/users/create` | register a user and confirm the Cognito account in one step (no verification email). Allowed --user-type values: "Fas… | `create-user` |
 | `makea-cli admin delete library-element` | write（never） | `DELETE /admin/designer/{user_id}/library_components/{component_id}` | remove a component from the designer's org library. | `library-delete` |
 | `makea-cli admin delete rule` | write（ask） | `DELETE /admin/playbook/users/{user}/rules/{rule_id}` | remove a rule: archived, with who and why kept on it (`update rule --status active` restores it). --reason required. | — |
+| `makea-cli admin delete shipping-fee` | write（ask） | `DELETE /admin/shipping_orders/{shipping_order_id}/fees/{fee_id}/remove` | remove one fee. | — |
+| `makea-cli admin delete shipping-option` | write（ask） | `DELETE /admin/shipping_orders/{shipping_order_id}/shipping-options/{shipping_option_id}/remove` | withdraw one freight quote. | — |
+| `makea-cli admin delete shipping-order` | write（never） | `DELETE /admin/shipping_orders/{shipping_order_id}/delete` | remove a shipment and free its orders. Graded `never`: the backend does not check status, so it removes a paid or in-transit shipment too. | — |
+| `makea-cli admin delete shipping-order-item` | write（ask） | `POST /admin/production_orders/{id}/unlink_from_shipping_order/{shipping_order_id}` | take one production or sampling order off a shipment. A shipment left empty is deleted. | — |
 | `makea-cli admin download document` | read | `GET /admin/document/download` | save a document file (document id + designer user_id). | `download-document` |
 | `makea-cli admin download product-document` | read | `GET /admin/document/download` | Resolve product via admin list product-order payload, then GET /admin/document/download. | `download-product-document` |
 | `makea-cli admin generate pricing-groups` | write（ask） | `POST /admin/production_orders/{id}/details/update` | Lay a production order's variants into pricing groups along one axis (--by style \| colour \| variant \| all) with th… | `production-groups-generate` |
@@ -109,6 +116,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin get quote-request` | read | `GET /admin/quote_requests/{quote_request_id}` | one quote request in full. | — |
 | `makea-cli admin get revenue-metrics` | read | `GET /admin/business-metrics/cumulative-payment-and-platform-revenue` | platform-wide payment received and platform revenue (service fee + transaction fee) bucketed over a date range. | `get-cumulative-payment-and-platform-revenue` |
 | `makea-cli admin get rule` | read | `GET /admin/playbook/users/{user}/rules/{rule_id}` | one rule in full, with its evidence: where it came from, who changed it and why. | — |
+| `makea-cli admin get shipping-order` | read | `GET /admin/shipping_orders/{shipping_order_id}/details` | one shipment with its production and sampling orders, freight quotes, fees, tracking and address. | — |
 | `makea-cli admin get supplier-profile-schema` | read | `GET /admin/supplier/profile/schema` | supplier profile v2 schema (section/field taxonomy: sections, fields, options, required rules). | `get-supplier-profile-schema` |
 | `makea-cli admin get tech-spec-extraction` | read | `GET /admin/products/{id}/extract-tech-specifications` | AI-generate specs (not saved). | `extract-ai-tech-spec` |
 | `makea-cli admin get top-clicks` | read | `POST /admin/analytics/query` | which buttons/elements get clicked most. | `analytics-top-clicks` |
@@ -134,6 +142,7 @@ exit code：`0` 成功 · `2` 用法错 · `3` 未登录或身份与 persona 不
 | `makea-cli admin update quote` | write（ask） | `POST /admin/product/edit_supplier_link_override_info` | admin updates an existing quote (supplier link) in place. Only the options you pass are sent, and the backend leaves … | `update-supplier-quote` |
 | `makea-cli admin update quote-request` | write（ask） | `PATCH /admin/quote_requests/{quote_request_id}/update` | set a quote request's stage, status and/or due date. Only what you pass is changed. This is the door that unblocks a … | `update-quote-request` |
 | `makea-cli admin update rule` | write（ask） | `PATCH /admin/playbook/users/{user}/rules/{rule_id}` | change a rule's text, status, applies_to, when or mode. --reason required; the rule keeps what it was before. | — |
+| `makea-cli admin update shipping-order` | write（ask） | `PUT /admin/shipping_orders/{shipping_order_id}/status` | Change a shipment: --status (PUT .../status), tracking flags (POST .../tracking), --address (PUT .../shipping-address… | — |
 | `makea-cli admin update supplier` | write（ask） | `PUT /admin/supplier/update_supplier` | update an existing supplier from a JSON file (admin). Run `makea-cli get-supplier-profile-schema` FIRST to get the fi… | `update-supplier` |
 | `makea-cli admin update tech-spec` | write（ask） | `POST /admin/products/{id}/technical-specifications` | persist specs from a JSON file. | `save-product-tech-spec` |
 | `makea-cli admin update tracking-status` | write（ask） | `POST /admin/tracking/carrier_status` | apply a carrier status looked up by hand (tracking-sweep skill) to one order: status, fan-out, delivered emails (--silent: state only). | — |

{makea_cli-0.2.16.dist-info → makea_cli-0.2.17.dist-info}/RECORD

@@ -1,6 +1,6 @@
-makea_cli/__init__.py,sha256=nS1Qf8CA6pxMzqGCeAMZHTKK2igCSNakZ3o7kDK0JIQ,23
+makea_cli/__init__.py,sha256=Qi17SZ8BBtfJyUgJ1-dmlKGJmEwoMRO4CvqGYPFRAhw,23
 makea_cli/__main__.py,sha256=AkQjxWfKE3w9iD1d6I-2Zqvv2t9cct0oYyFF0UiA-Z0,144
-makea_cli/api_client.py,sha256=I3w5xPMSxZ0bUliXdS8Sz4_W0-ZS3uhHVvoAkn166ZE,67533
+makea_cli/api_client.py,sha256=sPJ_YmfzlpyOi8HL95pDEnQin_eZIN00Yc9LD4fj4XE,70913
 makea_cli/auth_pkce.py,sha256=iXSyJ7DM3qVuj-3FwPiqM25CxXz9ebFs9FNthZdw3ws,7315
 makea_cli/broker.py,sha256=5O650nAdRuF-u9E1MuVM2jVv796iBdxJGIaJasxHij0,3019
 makea_cli/config.py,sha256=hz8MnJSkhxcIEZkcpHR005JrDceo1Xmi8qwIUq50cMU,3003
@@ -10,7 +10,7 @@ makea_cli/main.py,sha256=nuTQ8_P8OSdRbjMHMB4qcKdex124nS-ApCW-zfbqlI0,7169
 makea_cli/output.py,sha256=VWvZe2Ad8zxT4ZQyBhFRc6wkFwbyYzQFPddepANGAbY,6361
 makea_cli/posthog_client.py,sha256=k0cy9Hq7bhdLlPvC1ZW_esJ70xHDdQzPQUlx-GpVskk,1921
 makea_cli/registry.py,sha256=GYJK_idhwIh1X2ictwFjn8PEMaXT56hFVkoLEVYrVqw,13722
-makea_cli/commands/__init__.py,sha256=LJ6pjYtIL_VvdSRbF1QomSojcarJF710Sifg2RWsgQo,1575
+makea_cli/commands/__init__.py,sha256=A6nBCidMsRXfNtIPhJhbvIQklYe1BIphMAubZQc1s0w,1676
 makea_cli/commands/_util.py,sha256=zSFwWaWpncARlKxgq4WuJlJvNv7XdZ39HfHrNOELHuw,980
 makea_cli/commands/analytics/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 makea_cli/commands/analytics/cmd.py,sha256=KVLUtYSeyYZ8_09jIuIAmePjQqcpQS2mb5PBBzGwQYQ,6562
@@ -41,9 +41,11 @@ makea_cli/commands/product/cmd.py,sha256=W0oVTZvsK1QWZWv2x6NC26_JQMXrO16O8gYuKYP
 makea_cli/commands/production/__init__.py,sha256=Whn5ziwVMt4jzcokiFWLhWIpRLYC-ldnjZgAzeQ3We4,79
 makea_cli/commands/production/cmd.py,sha256=s6fVAGzOvokF6Va5WKGEA2vw2x2hDQ3PrsF01EyZA-Q,38283
 makea_cli/commands/production/pricing_spec.py,sha256=xGbj7-ps3PcKuU6Oc59A70b62FjF6Awhr5IY3ymZveU,27174
+makea_cli/commands/shipping/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+makea_cli/commands/shipping/cmd.py,sha256=ozt73pj3onlOv0NhEwiJlslyG9WOycE0QN4tmzwFlT0,17280
 makea_cli/commands/supplier/__init__.py,sha256=qfQDeQdQ-B7I_uwFVfcp1vXFUTL4fAcNLu3ipsZ7dfs,77
 makea_cli/commands/supplier/cmd.py,sha256=crRCy9WfhkryHMIL3iufoiT90_SG3-mKChAtdhd06uc,58076
-makea_cli-0.2.16.dist-info/METADATA,sha256=-Zpj9hQq0JaECBulxaELeFJeaMEjjthhrIDO8VxBeKI,32987
-makea_cli-0.2.16.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
-makea_cli-0.2.16.dist-info/entry_points.txt,sha256=4x-lbVa1jBbNlkNq7L-rYyfRh2spZmc3BLIzP-Dl-Qk,50
-makea_cli-0.2.16.dist-info/RECORD,,
+makea_cli-0.2.17.dist-info/METADATA,sha256=aubC1OdePkFzgJBiKYJPPEk1-wtjC7jwfckx2JA4OgU,34938
+makea_cli-0.2.17.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+makea_cli-0.2.17.dist-info/entry_points.txt,sha256=4x-lbVa1jBbNlkNq7L-rYyfRh2spZmc3BLIzP-Dl-Qk,50
+makea_cli-0.2.17.dist-info/RECORD,,