makea-cli 0.1.21__tar.gz → 0.1.23__tar.gz

{makea_cli-0.1.21 → makea_cli-0.1.23}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: makea-cli
-Version: 0.1.21
+Version: 0.1.23
 Summary: Makea admin CLI (browser login + Makea admin HTTP API)
 Requires-Python: >=3.10
 Requires-Dist: httpx>=0.27
@@ -80,9 +80,12 @@ makea-cli auth --logout
 - `makea-cli create-user <email> --user-type "<type>" [--password ...] [--name ...] [--company-name ...] [--username ...]` — 注册用户并直接确认 Cognito 账号（POST `/admin/users/create`，不发验证码邮件，创建后即可用该密码登录）  
 - `makea-cli list-suppliers` — 列出供应商（需管理员权限）  
 - `makea-cli create-quote-request -s <supplier_id> -p <product_reference_id> [--quote-type SAMPLING|PRODUCTION] [--message ...] [--due-date YYYY-MM-DD]` — 创建并发送 quote request（POST `/admin/supplier/create_quote_request`）  
+- `makea-cli get-quote-requests [--product-id <product_id>] [--quote-request-id <id>]` — 列某个产品下的 quote requests，或读单条完整内容（GET `/admin/quote_requests`）  
+- `makea-cli update-quote-request <quote_request_id> [--stage SAMPLING] [--status PENDING_SUPPLIER] [--due-date YYYY-MM-DD | --clear-due-date]` — 改 quote request 的 stage / status / 截止日（PATCH `/admin/quote_requests/{id}/update`）。**代供应商报价前常常要先用它**：quote request 停在 ENGAGEMENT（供应商还没接单）时 `submit-supplier-quote` 会被拒；过了 due date 也会被拒  
 - `makea-cli get-quote-requests-by-supplier-id <supplier_id> [--status <status>] [-n <limit>]` — 直连后端按 supplier_id 查询 quote requests  
 - `makea-cli get-supplier-links-by-supplier-id <supplier_id> [--link-type SAMPLING|PRODUCTION]` — 直连后端按 supplier_id 查询 supplier links  
-- `makea-cli submit-supplier-quote <quote_request_id> --link-name ... --currency ... --sampling-price-amount ... --sampling-price-valid-until ... --production-price-tiers-json ... --sample-lead-time ... --lead-time ... --deliverables-json ... --customer-note ...` — 以供应商身份向指定 quote request 新增 quote（完整参数说明见 `--help`）  
+- `makea-cli submit-supplier-quote <quote_request_id> --link-name ... --currency ... --sampling-price-value ... --sampling-price-valid-until ... --sample-lead-time ... --deliverables-json ... --customer-note ...` — 以 admin 身份代供应商向指定 quote request 新增 quote。大货阶梯价（`--production-price-tiers-json`）和 `--lead-time` 现在是可选的；样衣加做费、MOQ 口径、寄料地址（CMT / full package 打样报价必填）、可选尺码颜色、规格行、typed link 等字段见 `--help`。pricing groups 提交时给不进去，提交完用 `update-supplier-quote` 补  
+- `makea-cli update-supplier-quote <product_id> <link_id> [--sampling-price-value ... --sampling-price-valid-until ...] [--production-price-tiers-json ...] [--pricing-groups-json ...] [...]` — 改一条已提交的 quote（supplier link）：只发你传的字段，没传的后端不动；pricing groups（多套阶梯价）只有这条命令能写（POST `/admin/product/edit_supplier_link_override_info`）  
 - `makea-cli list-product-orders` — 列出所有设计师产品订单（GET `/admin/designer/get_all_product_orders`）  
 - `makea-cli list-sampling-orders-by-product <id>` — 按产品 reference id 列打样单  
 - `makea-cli list-production-orders-by-product <id>` — 按产品 reference id 列大货单  

{makea_cli-0.1.21 → makea_cli-0.1.23}/README.md

@@ -69,9 +69,12 @@ makea-cli auth --logout
 - `makea-cli create-user <email> --user-type "<type>" [--password ...] [--name ...] [--company-name ...] [--username ...]` — 注册用户并直接确认 Cognito 账号（POST `/admin/users/create`，不发验证码邮件，创建后即可用该密码登录）  
 - `makea-cli list-suppliers` — 列出供应商（需管理员权限）  
 - `makea-cli create-quote-request -s <supplier_id> -p <product_reference_id> [--quote-type SAMPLING|PRODUCTION] [--message ...] [--due-date YYYY-MM-DD]` — 创建并发送 quote request（POST `/admin/supplier/create_quote_request`）  
+- `makea-cli get-quote-requests [--product-id <product_id>] [--quote-request-id <id>]` — 列某个产品下的 quote requests，或读单条完整内容（GET `/admin/quote_requests`）  
+- `makea-cli update-quote-request <quote_request_id> [--stage SAMPLING] [--status PENDING_SUPPLIER] [--due-date YYYY-MM-DD | --clear-due-date]` — 改 quote request 的 stage / status / 截止日（PATCH `/admin/quote_requests/{id}/update`）。**代供应商报价前常常要先用它**：quote request 停在 ENGAGEMENT（供应商还没接单）时 `submit-supplier-quote` 会被拒；过了 due date 也会被拒  
 - `makea-cli get-quote-requests-by-supplier-id <supplier_id> [--status <status>] [-n <limit>]` — 直连后端按 supplier_id 查询 quote requests  
 - `makea-cli get-supplier-links-by-supplier-id <supplier_id> [--link-type SAMPLING|PRODUCTION]` — 直连后端按 supplier_id 查询 supplier links  
-- `makea-cli submit-supplier-quote <quote_request_id> --link-name ... --currency ... --sampling-price-amount ... --sampling-price-valid-until ... --production-price-tiers-json ... --sample-lead-time ... --lead-time ... --deliverables-json ... --customer-note ...` — 以供应商身份向指定 quote request 新增 quote（完整参数说明见 `--help`）  
+- `makea-cli submit-supplier-quote <quote_request_id> --link-name ... --currency ... --sampling-price-value ... --sampling-price-valid-until ... --sample-lead-time ... --deliverables-json ... --customer-note ...` — 以 admin 身份代供应商向指定 quote request 新增 quote。大货阶梯价（`--production-price-tiers-json`）和 `--lead-time` 现在是可选的；样衣加做费、MOQ 口径、寄料地址（CMT / full package 打样报价必填）、可选尺码颜色、规格行、typed link 等字段见 `--help`。pricing groups 提交时给不进去，提交完用 `update-supplier-quote` 补  
+- `makea-cli update-supplier-quote <product_id> <link_id> [--sampling-price-value ... --sampling-price-valid-until ...] [--production-price-tiers-json ...] [--pricing-groups-json ...] [...]` — 改一条已提交的 quote（supplier link）：只发你传的字段，没传的后端不动；pricing groups（多套阶梯价）只有这条命令能写（POST `/admin/product/edit_supplier_link_override_info`）  
 - `makea-cli list-product-orders` — 列出所有设计师产品订单（GET `/admin/designer/get_all_product_orders`）  
 - `makea-cli list-sampling-orders-by-product <id>` — 按产品 reference id 列打样单  
 - `makea-cli list-production-orders-by-product <id>` — 按产品 reference id 列大货单  

makea_cli-0.1.23/makea_cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.23"

{makea_cli-0.1.21 → makea_cli-0.1.23}/makea_cli/api_client.py

@@ -294,6 +294,25 @@ def get_quote_requests(*, product_id: str | None = None) -> Any:
     return get_json("/admin/quote_requests", params=params)
 
 
+def get_quote_request(*, quote_request_id: str) -> Any:
+    """
+    GET /admin/quote_requests/{quote_request_id} — one quote request in full.
+    """
+    return get_json(f"/admin/quote_requests/{quote_request_id}")
+
+
+def update_quote_request(
+    *,
+    quote_request_id: str,
+    body: dict[str, Any],
+) -> Any:
+    """
+    PATCH /admin/quote_requests/{quote_request_id}/update — set a quote request's
+    stage, status and/or due date. Only the keys present in ``body`` are applied.
+    """
+    return patch_json(f"/admin/quote_requests/{quote_request_id}/update", body)
+
+
 def create_quote_request(
     *,
     supplier_id: str,
@@ -390,6 +409,27 @@ def submit_admin_quote_for_quote_request(
     return post_json(f"/admin/quote_requests/{quote_request_id}/submit_quote", body)
 
 
+def edit_supplier_link_override_info(
+    *,
+    product_id: str,
+    link_id: str,
+    override_info: dict[str, Any],
+) -> Any:
+    """
+    POST /admin/product/edit_supplier_link_override_info — admin updates an existing
+    supplier link (a submitted quote) in place. Only the keys present in
+    ``override_info`` are applied; the rest of the link is left alone.
+    """
+    return post_json(
+        "/admin/product/edit_supplier_link_override_info",
+        {
+            "product_id": product_id,
+            "link_id": link_id,
+            "override_info": override_info,
+        },
+    )
+
+
 def upload_admin_link_document(
     *,
     file_path: Path,

{makea_cli-0.1.21 → makea_cli-0.1.23}/makea_cli/commands/supplier/cmd.py

@@ -20,6 +20,86 @@ def _normalize_add_supplier_body(raw: dict) -> dict:
     return {"supplier": raw}
 
 
+MOQ_APPLIES_TO_VALUES = ("style", "size", "color")
+
+# Mirrors garmentby_service.domain.QuoteRequest — kept here only so `--help` can
+# name the values; the backend is the one that validates.
+QUOTE_REQUEST_STAGES = ("ENGAGEMENT", "SAMPLING", "PRODUCTION")
+QUOTE_REQUEST_STATUSES = (
+    "PENDING_MERCHANT",
+    "PENDING_SUPPLIER",
+    "NEEDS_CLARIFICATION",
+    "COMPLETED",
+    "ORDER_PLACED",
+    "TERMINATED",
+    "RESAMPLE_QUOTE_REQUESTED",
+)
+PRODUCTION_FLOW_STATUSES = (
+    "PENDING_QUOTE",
+    "QUOTE_SUBMITTED",
+    "QUOTE_CONFIRMED",
+    "AWAITING_DEPOSIT",
+    "DEPOSIT_PAID",
+    "IN_PRODUCTION",
+    "AWAITING_FINAL_PAYMENT",
+    "FINAL_PAYMENT_PAID",
+    "SHIPPED",
+    "COMPLETED",
+    "CANCELLED",
+)
+
+
+def _parse_json_option(raw: str, option_name: str) -> object:
+    """Parse a JSON-valued option, failing with the option's own name."""
+    try:
+        return json.loads(raw)
+    except json.JSONDecodeError as e:
+        console.print(f"[red]{option_name} must be valid JSON: {e}[/red]")
+        raise typer.Exit(1) from e
+
+
+def _parse_json_list_option(raw: str, option_name: str) -> list:
+    parsed = _parse_json_option(raw, option_name)
+    if not isinstance(parsed, list):
+        console.print(f"[red]{option_name} must be a JSON array (list).[/red]")
+        raise typer.Exit(1)
+    return parsed
+
+
+def _parse_json_object_option(raw: str, option_name: str) -> dict:
+    parsed = _parse_json_option(raw, option_name)
+    if not isinstance(parsed, dict):
+        console.print(f"[red]{option_name} must be a JSON object.[/red]")
+        raise typer.Exit(1)
+    return parsed
+
+
+def _validate_moq_applies_to(values: list[str]) -> list[str]:
+    """Normalize --moq-applies-to; the backend silently drops unknown values."""
+    normalized = [str(v).strip().lower() for v in values if str(v).strip()]
+    unknown = [v for v in normalized if v not in MOQ_APPLIES_TO_VALUES]
+    if unknown:
+        console.print(
+            f"[red]--moq-applies-to accepts only {', '.join(MOQ_APPLIES_TO_VALUES)} "
+            f"(got: {', '.join(unknown)}).[/red]"
+        )
+        raise typer.Exit(1)
+    return [v for v in MOQ_APPLIES_TO_VALUES if v in set(normalized)]
+
+
+def _validate_choice(value: str, allowed: tuple[str, ...], option_name: str) -> str:
+    """Reject an out-of-range option before it costs a round trip."""
+    if value not in allowed:
+        console.print(f"[red]{option_name} must be one of {', '.join(allowed)}.[/red]")
+        raise typer.Exit(1)
+    return value
+
+
+def _none_if_null_literal(value: str) -> str | None:
+    """Let an option clear a stored value by passing the literal `null`."""
+    return None if value.strip().lower() in ("null", "none") else value
+
+
 def register(app: typer.Typer) -> None:
     @app.command(
         "list-suppliers",
@@ -468,11 +548,131 @@ def register(app: typer.Typer) -> None:
             ),
         )
 
+    @app.command(
+        "get-quote-requests",
+        help=(
+            "GET /admin/quote_requests — list quote requests, optionally for one product. "
+            "Pass --quote-request-id to read a single one in full "
+            "(GET /admin/quote_requests/{id})."
+        ),
+    )
+    def get_quote_requests(
+        product_id: str | None = typer.Option(
+            None,
+            "--product-id",
+            "-p",
+            help="product_id: only quote requests on this product (product_reference_id).",
+        ),
+        quote_request_id: str | None = typer.Option(
+            None,
+            "--quote-request-id",
+            help="quote_request_id: read this one quote request in full instead of a list.",
+        ),
+    ) -> None:
+        """
+        List quote requests, or read one.
+        """
+        if quote_request_id:
+            print_json_or_exit(
+                console,
+                lambda: api_client.get_quote_request(quote_request_id=quote_request_id),
+            )
+            return
+        print_json_or_exit(
+            console,
+            lambda: api_client.get_quote_requests(product_id=product_id),
+        )
+
+    @app.command(
+        "update-quote-request",
+        help=(
+            "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 submit: submit-supplier-quote requires "
+            "stage SAMPLING or PRODUCTION, and a quote request sits in ENGAGEMENT "
+            "until the supplier accepts it."
+        ),
+    )
+    def update_quote_request(
+        quote_request_id: str = typer.Argument(
+            ...,
+            help="quote_request_id: the quote request to update.",
+        ),
+        stage: str | None = typer.Option(
+            None,
+            "--stage",
+            help=(
+                "current_stage: ENGAGEMENT (supplier has not accepted yet), SAMPLING or "
+                "PRODUCTION. Moving to SAMPLING/PRODUCTION by hand skips the supplier's "
+                "own acceptance, so accepted_at / terms_accepted_at stay empty."
+            ),
+        ),
+        status: str | None = typer.Option(
+            None,
+            "--status",
+            help=(
+                "status: for ENGAGEMENT/SAMPLING one of "
+                f"{', '.join(QUOTE_REQUEST_STATUSES)}; "
+                "for PRODUCTION one of "
+                f"{', '.join(PRODUCTION_FLOW_STATUSES)}. "
+                "The backend validates against whichever stage the request ends up in."
+            ),
+        ),
+        due_date: str | None = typer.Option(
+            None,
+            "--due-date",
+            help=(
+                "due_date: ISO date (YYYY-MM-DD). A quote request past its due date "
+                "cannot be quoted, so this is the other thing that blocks a submit."
+            ),
+        ),
+        clear_due_date: bool = typer.Option(
+            False,
+            "--clear-due-date",
+            help="Send due_date as null, leaving the quote request with no deadline.",
+        ),
+    ) -> None:
+        """
+        Update a quote request's stage, status and/or due date.
+        """
+        if due_date and clear_due_date:
+            console.print("[red]Pass either --due-date or --clear-due-date, not both.[/red]")
+            raise typer.Exit(1)
+
+        body: dict[str, object] = {}
+        if stage is not None:
+            body["current_stage"] = _validate_choice(
+                stage.strip().upper(), QUOTE_REQUEST_STAGES, "--stage"
+            )
+        if status is not None:
+            body["status"] = status.strip().upper()
+        if due_date:
+            body["due_date"] = due_date.strip()
+        elif clear_due_date:
+            body["due_date"] = None
+
+        if not body:
+            console.print(
+                "[red]Nothing to update: pass --stage, --status, --due-date or "
+                "--clear-due-date.[/red]"
+            )
+            raise typer.Exit(1)
+
+        print_json_or_exit(
+            console,
+            lambda: api_client.update_quote_request(
+                quote_request_id=quote_request_id,
+                body=body,
+            ),
+        )
+
     @app.command(
         "submit-supplier-quote",
         help=(
             "POST /admin/quote_requests/{quote_request_id}/submit_quote — "
-            "admin submits a new quote (link) to a quote request."
+            "admin submits a new quote (link) to a quote request. "
+            "Pricing groups cannot be sent here (the submit endpoint ignores them) — "
+            "set them afterwards with `update-supplier-quote`."
         ),
     )
     def submit_supplier_quote(
@@ -490,10 +690,14 @@ def register(app: typer.Typer) -> None:
             "--currency",
             help="currency: quote currency (used by sampling price and fees).",
         ),
-        sampling_price_amount: float = typer.Option(
+        sampling_price_value: float = typer.Option(
             ...,
+            "--sampling-price-value",
             "--sampling-price-amount",
-            help="sampling_price.amount: sampling price amount (required, number).",
+            help=(
+                "sampling_price.value: sampling price (required, number). "
+                "Sent as `value` — the backend reads no other key."
+            ),
         ),
         sampling_price_valid_until: str = typer.Option(
             ...,
@@ -503,25 +707,11 @@ def register(app: typer.Typer) -> None:
                 "(required, ISO datetime string, e.g. 2026-05-01T00:00:00+00:00)."
             ),
         ),
-        production_price_tiers_json: str = typer.Option(
-            ...,
-            "--production-price-tiers-json",
-            help=(
-                "production_price_tiers: tiered production price array "
-                "(required, JSON string). "
-                'Example: \'[{"min_qty":100,"max_qty":499,"unit_price":12.5}]\''
-            ),
-        ),
         sample_lead_time: str = typer.Option(
             ...,
             "--sample-lead-time",
             help="sample_lead_time: sampling lead time (required, string).",
         ),
-        lead_time: str = typer.Option(
-            ...,
-            "--lead-time",
-            help="lead_time: production lead time (required, string).",
-        ),
         deliverables_json: str = typer.Option(
             ...,
             "--deliverables-json",
@@ -535,6 +725,28 @@ def register(app: typer.Typer) -> None:
             "--customer-note",
             help="customer_note: note for customer/platform (required, string; empty string allowed).",
         ),
+        production_price_tiers_json: str | None = typer.Option(
+            None,
+            "--production-price-tiers-json",
+            help=(
+                "production_price_tiers: tiered production price array "
+                "(optional since TECH-93 — a factory may quote the sample only). "
+                'Example: \'[{"min_qty":100,"max_qty":499,"unit_price":12.5}]\''
+            ),
+        ),
+        lead_time: str | None = typer.Option(
+            None,
+            "--lead-time",
+            help="lead_time: production lead time (optional since TECH-93, string).",
+        ),
+        extra_sample_price_value: float | None = typer.Option(
+            None,
+            "--extra-sample-price-value",
+            help=(
+                "extra_sample_price.value: per-unit charge for extra samples "
+                "(optional, number; currency defaults to --currency)."
+            ),
+        ),
         link_id: str | None = typer.Option(
             None,
             "--link-id",
@@ -550,6 +762,14 @@ def register(app: typer.Typer) -> None:
             "--moq",
             help="moq: minimum order quantity (optional, integer).",
         ),
+        moq_applies_to: list[str] | None = typer.Option(
+            None,
+            "--moq-applies-to",
+            help=(
+                "moq_applies_to: what the MOQ counts (optional, repeatable): "
+                "style, size, color. Empty means the supplier did not say."
+            ),
+        ),
         production_price_incoterm: str | None = typer.Option(
             None,
             "--production-price-incoterm",
@@ -560,6 +780,63 @@ def register(app: typer.Typer) -> None:
             "--production-payment-term",
             help='production_payment_term: production payment term/deposit ratio (optional, e.g. "40" or "40%").',
         ),
+        material_ship_to_json: str | None = typer.Option(
+            None,
+            "--material-ship-to-json",
+            help=(
+                "material_ship_to_address: where the buyer ships materials "
+                "(JSON object with street, city, state, postal_code, country). "
+                "REQUIRED by the backend for a CMT or full-package SAMPLING quote — "
+                "street, city and country must be non-empty. "
+                'Example: \'{"street":"1 Test Rd","city":"Guangzhou","country":"CN"}\''
+            ),
+        ),
+        available_sizes_json: str | None = typer.Option(
+            None,
+            "--available-sizes-json",
+            help=(
+                "available_sizes: sizes the piece comes in (optional, JSON array of strings). "
+                'Example: \'["S","M","L"]\''
+            ),
+        ),
+        available_colors_json: str | None = typer.Option(
+            None,
+            "--available-colors-json",
+            help=(
+                "available_colors: colours the piece comes in (optional, JSON array of objects). "
+                'Example: \'[{"color_name":"Black","hex_code":"#000000","pantone_code":"Black 6 C"}]\''
+            ),
+        ),
+        size_chart_document_id: str | None = typer.Option(
+            None,
+            "--size-chart-document-id",
+            help=(
+                "size_chart_document_id: the quote's size chart document (optional). "
+                'Pass an empty string ("") to send it as null and leave the link without one.'
+            ),
+        ),
+        component_specifications_json: str | None = typer.Option(
+            None,
+            "--component-specifications-json",
+            help=(
+                "component_specifications: free-form specification rows (optional, JSON array). "
+                'Example: \'[{"component":"Fabric","specification":"100% cotton, 220gsm"}]\''
+            ),
+        ),
+        link_type_kind: str | None = typer.Option(
+            None,
+            "--type",
+            help=(
+                "type: typed-link kind (optional; default MANUFACTURE). "
+                "MANUFACTURE, PRODUCT_DEVELOP, or a material kind (FABRIC, BUTTON, ZIPPER, "
+                "ELASTIC, LABEL, HOOK, SNAP, CORD, BUCKLE, TAPE, PATCH, LACE, EYELET)."
+            ),
+        ),
+        attributes_json: str | None = typer.Option(
+            None,
+            "--attributes-json",
+            help="attributes: LinkAttributes-shaped SKU metadata (optional, JSON object).",
+        ),
         document_ids_json: str | None = typer.Option(
             None,
             "--document-ids-json",
@@ -594,76 +871,78 @@ def register(app: typer.Typer) -> None:
         """
         Submit a new quote link to a quote request as admin.
         """
-
-        def _parse_json_option(raw: str, option_name: str) -> object:
-            try:
-                return json.loads(raw)
-            except json.JSONDecodeError as e:
-                console.print(f"[red]{option_name} must be valid JSON: {e}[/red]")
-                raise typer.Exit(1) from e
-
-        production_price_tiers = _parse_json_option(
-            production_price_tiers_json, "--production-price-tiers-json"
-        )
-        deliverables = _parse_json_option(deliverables_json, "--deliverables-json")
-        if not isinstance(production_price_tiers, list):
-            console.print("[red]--production-price-tiers-json must be a JSON array (list).[/red]")
-            raise typer.Exit(1)
-        if not isinstance(deliverables, list):
-            console.print("[red]--deliverables-json must be a JSON array (list).[/red]")
-            raise typer.Exit(1)
+        deliverables = _parse_json_list_option(deliverables_json, "--deliverables-json")
 
         body: dict[str, object] = {
             "link_name": link_name,
             "currency": currency,
             "sampling_price": {
-                "amount": sampling_price_amount,
+                # `value`, not `amount`: Price.to_domain reads `value` and nothing
+                # else, so an `amount` key used to land the quote at zero.
+                "value": sampling_price_value,
                 "currency": currency,
                 "valid_until": sampling_price_valid_until,
             },
-            "production_price_tiers": production_price_tiers,
             "sample_lead_time": sample_lead_time,
-            "lead_time": lead_time,
             "deliverables": deliverables,
             "customer_note": customer_note,
         }
 
+        if production_price_tiers_json is not None:
+            body["production_price_tiers"] = _parse_json_list_option(
+                production_price_tiers_json, "--production-price-tiers-json"
+            )
+        if lead_time is not None:
+            body["lead_time"] = lead_time
+        if extra_sample_price_value is not None:
+            body["extra_sample_price"] = {
+                "value": extra_sample_price_value,
+                "currency": currency,
+            }
         if link_id:
             body["link_id"] = link_id
         if link_type:
             body["link_type"] = link_type
         if moq is not None:
             body["moq"] = moq
+        if moq_applies_to:
+            body["moq_applies_to"] = _validate_moq_applies_to(moq_applies_to)
         if production_price_incoterm is not None:
             body["production_price_incoterm"] = production_price_incoterm
         if production_payment_term is not None:
             body["production_payment_term"] = production_payment_term
+        if material_ship_to_json is not None:
+            body["material_ship_to_address"] = _parse_json_object_option(
+                material_ship_to_json, "--material-ship-to-json"
+            )
+        if available_sizes_json is not None:
+            body["available_sizes"] = _parse_json_list_option(
+                available_sizes_json, "--available-sizes-json"
+            )
+        if available_colors_json is not None:
+            body["available_colors"] = _parse_json_list_option(
+                available_colors_json, "--available-colors-json"
+            )
+        if size_chart_document_id is not None:
+            body["size_chart_document_id"] = size_chart_document_id or None
+        if component_specifications_json is not None:
+            body["component_specifications"] = _parse_json_list_option(
+                component_specifications_json, "--component-specifications-json"
+            )
+        if link_type_kind is not None:
+            body["type"] = link_type_kind
+        if attributes_json is not None:
+            body["attributes"] = _parse_json_object_option(attributes_json, "--attributes-json")
         if document_ids_json is not None:
-            parsed = _parse_json_option(document_ids_json, "--document-ids-json")
-            if not isinstance(parsed, list):
-                console.print("[red]--document-ids-json must be a JSON array (list).[/red]")
-                raise typer.Exit(1)
-            body["document_ids"] = parsed
+            body["document_ids"] = _parse_json_list_option(document_ids_json, "--document-ids-json")
         if additional_deliverables_json is not None:
-            parsed = _parse_json_option(
+            body["additional_deliverables"] = _parse_json_list_option(
                 additional_deliverables_json, "--additional-deliverables-json"
             )
-            if not isinstance(parsed, list):
-                console.print(
-                    "[red]--additional-deliverables-json must be a JSON array (list).[/red]"
-                )
-                raise typer.Exit(1)
-            body["additional_deliverables"] = parsed
         if one_time_production_fees_json is not None:
-            parsed = _parse_json_option(
+            body["one_time_production_fees"] = _parse_json_list_option(
                 one_time_production_fees_json, "--one-time-production-fees-json"
             )
-            if not isinstance(parsed, list):
-                console.print(
-                    "[red]--one-time-production-fees-json must be a JSON array (list).[/red]"
-                )
-                raise typer.Exit(1)
-            body["one_time_production_fees"] = parsed
         if refundable_terms_json is not None:
             body["refundable_terms"] = _parse_json_option(
                 refundable_terms_json, "--refundable-terms-json"
@@ -686,3 +965,283 @@ def register(app: typer.Typer) -> None:
                 body=body,
             ),
         )
+
+    @app.command(
+        "update-supplier-quote",
+        help=(
+            "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 every field you omit alone. "
+            "The override door does not read extra_sample_price, moq_applies_to, "
+            "material_ship_to_address or size_chart_document_id — those can only be "
+            "set at submit time."
+        ),
+    )
+    def update_supplier_quote(
+        product_id: str = typer.Argument(
+            ...,
+            help="product_id: the product the quote (supplier link) hangs off.",
+        ),
+        link_id: str = typer.Argument(
+            ...,
+            help="link_id: the supplier link to update.",
+        ),
+        supplier_id: str | None = typer.Option(
+            None,
+            "--supplier-id",
+            help="supplier_id: reassign the link to another supplier (validated by the backend).",
+        ),
+        link_name: str | None = typer.Option(
+            None,
+            "--link-name",
+            help="link_name: quote name.",
+        ),
+        currency: str | None = typer.Option(
+            None,
+            "--currency",
+            help="currency: quote currency (also the fallback currency for fees).",
+        ),
+        sampling_price_value: float | None = typer.Option(
+            None,
+            "--sampling-price-value",
+            help=(
+                "sampling_price.value: new sampling price. The whole sampling_price "
+                "object is replaced, so --sampling-price-valid-until is required with it."
+            ),
+        ),
+        sampling_price_valid_until: str | None = typer.Option(
+            None,
+            "--sampling-price-valid-until",
+            help="sampling_price.valid_until: expiry to store with the new sampling price.",
+        ),
+        sampling_price_options_json: str | None = typer.Option(
+            None,
+            "--sampling-price-options-json",
+            help="sampling_price_options: multi-option sampling prices (JSON array).",
+        ),
+        production_price_tiers_json: str | None = typer.Option(
+            None,
+            "--production-price-tiers-json",
+            help=(
+                "production_price_tiers: the link's single tier schedule (JSON array; "
+                "pass [] to clear it). "
+                'Example: \'[{"min_qty":100,"max_qty":499,"unit_price":12.5}]\''
+            ),
+        ),
+        pricing_groups_json: str | None = typer.Option(
+            None,
+            "--pricing-groups-json",
+            help=(
+                "pricing_groups: several tier schedules on one quote (JSON array; "
+                "pass [] to clear them). A group names the cart keys it prices "
+                '("{size},{color_hex}") and carries its own tiers, MOQ and incoterm; '
+                "tier_basis/moq_basis are VARIANT, GROUP (default) or ORDER, and "
+                "max_qty 0 means an open-ended top tier. "
+                'Example: \'[{"name":"Core","variants":["S,#000000"],'
+                '"price_tiers":[{"min_qty":100,"max_qty":0,"unit_price":12.5}],'
+                '"tier_basis":"VARIANT"}]\''
+            ),
+        ),
+        moq: int | None = typer.Option(
+            None,
+            "--moq",
+            help="moq: minimum order quantity.",
+        ),
+        sample_lead_time: str | None = typer.Option(
+            None,
+            "--sample-lead-time",
+            help="sample_lead_time: sampling lead time.",
+        ),
+        lead_time: str | None = typer.Option(
+            None,
+            "--lead-time",
+            help="lead_time: production lead time.",
+        ),
+        production_price_incoterm: str | None = typer.Option(
+            None,
+            "--production-price-incoterm",
+            help=(
+                "production_price_incoterm: EXW or FOB; pass `null` to clear it. "
+                "An unrecognised value is rejected by the backend."
+            ),
+        ),
+        production_payment_term: str | None = typer.Option(
+            None,
+            "--production-payment-term",
+            help='production_payment_term: deposit ratio, e.g. "40". Pass `null` to clear it.',
+        ),
+        customer_note: str | None = typer.Option(
+            None,
+            "--customer-note",
+            help="customer_note: note for customer/platform (empty string allowed).",
+        ),
+        deliverables_json: str | None = typer.Option(
+            None,
+            "--deliverables-json",
+            help="deliverables: deliverables array (JSON), e.g. '[\"size_set\"]'.",
+        ),
+        additional_deliverables_json: str | None = typer.Option(
+            None,
+            "--additional-deliverables-json",
+            help="additional_deliverables: extra deliverables array (JSON).",
+        ),
+        one_time_production_fees_json: str | None = typer.Option(
+            None,
+            "--one-time-production-fees-json",
+            help="one_time_production_fees: one-time production fees array (JSON).",
+        ),
+        refundable_terms_json: str | None = typer.Option(
+            None,
+            "--refundable-terms-json",
+            help="refundable_terms: refundable terms (JSON object; pass `null` to clear).",
+        ),
+        available_sizes_json: str | None = typer.Option(
+            None,
+            "--available-sizes-json",
+            help=(
+                "available_sizes: sizes the quote is priced against (JSON array of strings). "
+                "Pricing groups claim cart keys built from these."
+            ),
+        ),
+        available_colors_json: str | None = typer.Option(
+            None,
+            "--available-colors-json",
+            help=(
+                "available_colors: colours the quote is priced against (JSON array of "
+                "{color_name, hex_code, pantone_code?})."
+            ),
+        ),
+        component_specifications_json: str | None = typer.Option(
+            None,
+            "--component-specifications-json",
+            help="component_specifications: free-form specification rows (JSON array).",
+        ),
+        link_type_kind: str | None = typer.Option(
+            None,
+            "--type",
+            help="type: typed-link kind (MANUFACTURE, PRODUCT_DEVELOP, FABRIC, BUTTON, ...).",
+        ),
+        attributes_json: str | None = typer.Option(
+            None,
+            "--attributes-json",
+            help="attributes: LinkAttributes-shaped SKU metadata (JSON object).",
+        ),
+        document_ids_json: str | None = typer.Option(
+            None,
+            "--document-ids-json",
+            help="document_ids: related document ID array (JSON), e.g. '[\"doc_1\"]'.",
+        ),
+    ) -> None:
+        """
+        Update an existing quote (supplier link) as admin.
+        """
+        override: dict[str, object] = {}
+
+        if (sampling_price_value is None) != (sampling_price_valid_until is None):
+            console.print(
+                "[red]--sampling-price-value and --sampling-price-valid-until must be "
+                "passed together: the backend replaces the whole sampling_price object, "
+                "so sending one without the other drops the other.[/red]"
+            )
+            raise typer.Exit(1)
+
+        if supplier_id is not None:
+            override["supplier_id"] = supplier_id
+        if link_name is not None:
+            override["link_name"] = link_name
+        if currency is not None:
+            override["currency"] = currency
+        if sampling_price_value is not None:
+            override["sampling_price"] = {
+                "value": sampling_price_value,
+                "valid_until": sampling_price_valid_until,
+                **({"currency": currency} if currency else {}),
+            }
+        if sampling_price_options_json is not None:
+            override["sampling_price_options"] = _parse_json_list_option(
+                sampling_price_options_json, "--sampling-price-options-json"
+            )
+        if production_price_tiers_json is not None:
+            override["production_price_tiers"] = _parse_json_list_option(
+                production_price_tiers_json, "--production-price-tiers-json"
+            )
+        if pricing_groups_json is not None:
+            override["pricing_groups"] = _parse_json_list_option(
+                pricing_groups_json, "--pricing-groups-json"
+            )
+        if moq is not None:
+            override["moq"] = moq
+        if sample_lead_time is not None:
+            override["sample_lead_time"] = sample_lead_time
+        if lead_time is not None:
+            override["lead_time"] = lead_time
+        if production_price_incoterm is not None:
+            override["production_price_incoterm"] = _none_if_null_literal(production_price_incoterm)
+        if production_payment_term is not None:
+            override["production_payment_term"] = _none_if_null_literal(production_payment_term)
+        if customer_note is not None:
+            override["customer_note"] = customer_note
+        if deliverables_json is not None:
+            override["deliverables"] = _parse_json_list_option(
+                deliverables_json, "--deliverables-json"
+            )
+        if additional_deliverables_json is not None:
+            override["additional_deliverables"] = _parse_json_list_option(
+                additional_deliverables_json, "--additional-deliverables-json"
+            )
+        if one_time_production_fees_json is not None:
+            override["one_time_production_fees"] = _parse_json_list_option(
+                one_time_production_fees_json, "--one-time-production-fees-json"
+            )
+        if refundable_terms_json is not None:
+            override["refundable_terms"] = _parse_json_option(
+                refundable_terms_json, "--refundable-terms-json"
+            )
+        if available_sizes_json is not None:
+            override["available_sizes"] = _parse_json_list_option(
+                available_sizes_json, "--available-sizes-json"
+            )
+        if available_colors_json is not None:
+            override["available_colors"] = _parse_json_list_option(
+                available_colors_json, "--available-colors-json"
+            )
+        if component_specifications_json is not None:
+            override["component_specifications"] = _parse_json_list_option(
+                component_specifications_json, "--component-specifications-json"
+            )
+        if link_type_kind is not None:
+            override["type"] = link_type_kind
+        if attributes_json is not None:
+            override["attributes"] = _parse_json_object_option(attributes_json, "--attributes-json")
+        if document_ids_json is not None:
+            override["document_ids"] = _parse_json_list_option(
+                document_ids_json, "--document-ids-json"
+            )
+
+        if not override:
+            console.print(
+                "[red]Nothing to update: pass at least one field option "
+                "(the backend rejects an empty override_info).[/red]"
+            )
+            raise typer.Exit(1)
+
+        # Pricing groups claim cart keys built from the link's own variant lists.
+        # Groups without them price variants no order can contain, so say so
+        # rather than let the quote look fine and misprice later.
+        if override.get("pricing_groups") and not (
+            "available_sizes" in override or "available_colors" in override
+        ):
+            console.print(
+                "[yellow]Warning: --pricing-groups-json without --available-sizes-json / "
+                "--available-colors-json relies on the variant lists already stored on the "
+                "link. Check them with `get-supplier-links-by-supplier-id`.[/yellow]"
+            )
+
+        print_json_or_exit(
+            console,
+            lambda: api_client.edit_supplier_link_override_info(
+                product_id=product_id,
+                link_id=link_id,
+                override_info=override,
+            ),
+        )

{makea_cli-0.1.21 → makea_cli-0.1.23}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "makea-cli"
-version = "0.1.21"
+version = "0.1.23"
 description = "Makea admin CLI (browser login + Makea admin HTTP API)"
 readme = "README.md"
 requires-python = ">=3.10"

makea_cli-0.1.21/makea_cli/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.1.21"