convexity-sdk 0.21.0.dev373__tar.gz → 0.21.0.dev375__tar.gz

{convexity_sdk-0.21.0.dev373 → convexity_sdk-0.21.0.dev375}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: convexity-sdk
-Version: 0.21.0.dev373
+Version: 0.21.0.dev375
 Summary: Convexity Python SDK - programmatic access to the Convexity platform
 Requires-Python: >=3.12
 Requires-Dist: convexity-api-client

{convexity_sdk-0.21.0.dev373 → convexity_sdk-0.21.0.dev375}/convexity_sdk/resources/logistics.py

@@ -58,7 +58,6 @@ class Logistics:
         self,
         *,
         project_id: str,
-        shipment_number: str,
         to_address_id: str,
         lines: list[CreateShipmentLineRequest | dict[str, Any]],
         carrier: str | None = None,
@@ -70,7 +69,6 @@ class Logistics:
     ) -> ShipmentResponse:
         """Create an originless direct shipment to the sales-order customer."""
         body = CreateShipmentRequest(
-            shipment_number=shipment_number,
             to_address_id=to_address_id,
             lines=_shipment_lines(lines),
             direction=ShipmentDirection.DIRECT_DROPSHIP,

{convexity_sdk-0.21.0.dev373 → convexity_sdk-0.21.0.dev375}/convexity_sdk/resources/purchasing.py

@@ -45,6 +45,7 @@ from convexity_api_client.models.batch_delete_purchase_orders_request import Bat
 from convexity_api_client.models.batch_delete_purchase_orders_response import BatchDeletePurchaseOrdersResponse
 from convexity_api_client.models.batch_delete_vendors_request import BatchDeleteVendorsRequest
 from convexity_api_client.models.batch_delete_vendors_response import BatchDeleteVendorsResponse
+from convexity_api_client.models.bulk_create_purchase_order_payload import BulkCreatePurchaseOrderPayload
 from convexity_api_client.models.bulk_create_purchase_orders_request import BulkCreatePurchaseOrdersRequest
 from convexity_api_client.models.bulk_create_purchase_orders_response import BulkCreatePurchaseOrdersResponse
 from convexity_api_client.models.bulk_upsert_item_sourcing_request import BulkUpsertItemSourcingRequest
@@ -52,6 +53,7 @@ from convexity_api_client.models.bulk_upsert_item_sourcing_response import BulkU
 from convexity_api_client.models.bulk_upsert_purchase_order_payload import BulkUpsertPurchaseOrderPayload
 from convexity_api_client.models.bulk_upsert_purchase_orders_request import BulkUpsertPurchaseOrdersRequest
 from convexity_api_client.models.bulk_upsert_purchase_orders_response import BulkUpsertPurchaseOrdersResponse
+from convexity_api_client.models.bulk_upsert_purchase_return_payload import BulkUpsertPurchaseReturnPayload
 from convexity_api_client.models.bulk_upsert_purchase_returns_request import (
     BulkUpsertPurchaseReturnsRequest,
 )
@@ -68,7 +70,6 @@ from convexity_api_client.models.cancel_purchase_order_request import CancelPurc
 from convexity_api_client.models.canonical_status import CanonicalStatus
 from convexity_api_client.models.create_item_sourcing_request import CreateItemSourcingRequest
 from convexity_api_client.models.create_purchase_order_request import CreatePurchaseOrderRequest
-from convexity_api_client.models.create_purchase_return_request import CreatePurchaseReturnRequest
 from convexity_api_client.models.create_vendor_request import CreateVendorRequest
 from convexity_api_client.models.item_sourcing_response import ItemSourcingResponse
 from convexity_api_client.models.list_purchase_orders_response import ListPurchaseOrdersResponse
@@ -128,12 +129,12 @@ def _po_lines(lines: list[PurchaseOrderLineRequest | dict[str, Any]]) -> list[Pu
     return [line if isinstance(line, PurchaseOrderLineRequest) else PurchaseOrderLineRequest(**line) for line in lines]
 
 
-def _po_request(purchase_order: CreatePurchaseOrderRequest | dict[str, Any]) -> CreatePurchaseOrderRequest:
-    if isinstance(purchase_order, CreatePurchaseOrderRequest):
+def _po_request(purchase_order: BulkCreatePurchaseOrderPayload | dict[str, Any]) -> BulkCreatePurchaseOrderPayload:
+    if isinstance(purchase_order, BulkCreatePurchaseOrderPayload):
         return purchase_order
     data = dict(purchase_order)
     data["lines"] = _po_lines(data.get("lines") or [])
-    return CreatePurchaseOrderRequest(**data)
+    return BulkCreatePurchaseOrderPayload(**data)
 
 
 def _bulk_po_payload(
@@ -145,9 +146,9 @@ def _bulk_po_payload(
 
 
 def _purchase_return_payload(
-    purchase_return: CreatePurchaseReturnRequest | dict[str, Any],
-) -> CreatePurchaseReturnRequest:
-    if isinstance(purchase_return, CreatePurchaseReturnRequest):
+    purchase_return: BulkUpsertPurchaseReturnPayload | dict[str, Any],
+) -> BulkUpsertPurchaseReturnPayload:
+    if isinstance(purchase_return, BulkUpsertPurchaseReturnPayload):
         return purchase_return
     serialized = dict(purchase_return)
     for field in ("shipped_at", "credit_received_at"):
@@ -159,7 +160,7 @@ def _purchase_return_payload(
         serialized["lifecycle_status"] = getattr(
             lifecycle_status, "value", lifecycle_status
         )
-    return CreatePurchaseReturnRequest.from_dict(serialized)
+    return BulkUpsertPurchaseReturnPayload.from_dict(serialized)
 
 
 def _receive_lines(lines: list[ReceiveLineRequest | dict[str, Any]]) -> list[ReceiveLineRequest]:
@@ -457,7 +458,6 @@ class Purchasing:
         self,
         *,
         project_id: str,
-        po_number: str,
         vendor_id: str,
         lines: list[PurchaseOrderLineRequest | dict[str, Any]],
         currency: str = "USD",
@@ -467,7 +467,6 @@ class Purchasing:
     ) -> PurchaseOrderResponse:
         """Create a purchase order with one or more lines."""
         body = CreatePurchaseOrderRequest(
-            po_number=po_number,
             vendor_id=vendor_id,
             lines=_po_lines(lines),
             currency=currency,
@@ -508,7 +507,7 @@ class Purchasing:
         self,
         *,
         project_id: str,
-        purchase_orders: list[CreatePurchaseOrderRequest | dict[str, Any]],
+        purchase_orders: list[BulkCreatePurchaseOrderPayload | dict[str, Any]],
     ) -> BulkCreatePurchaseOrdersResponse:
         """Create multiple purchase orders in one request."""
         body = BulkCreatePurchaseOrdersRequest(purchase_orders=[_po_request(purchase_order) for purchase_order in purchase_orders])
@@ -543,7 +542,7 @@ class Purchasing:
         self,
         *,
         project_id: str,
-        returns: list[CreatePurchaseReturnRequest | dict[str, Any]],
+        returns: list[BulkUpsertPurchaseReturnPayload | dict[str, Any]],
     ) -> BulkUpsertPurchaseReturnsResponse:
         """Import complete return-to-vendor snapshots by return number."""
         body = BulkUpsertPurchaseReturnsRequest(

{convexity_sdk-0.21.0.dev373 → convexity_sdk-0.21.0.dev375}/convexity_sdk/resources/sales.py

@@ -44,6 +44,7 @@ from convexity_api_client.models.bulk_upsert_sales_invoices_response import Bulk
 from convexity_api_client.models.bulk_upsert_sales_order_payload import BulkUpsertSalesOrderPayload
 from convexity_api_client.models.bulk_upsert_sales_orders_request import BulkUpsertSalesOrdersRequest
 from convexity_api_client.models.bulk_upsert_sales_orders_response import BulkUpsertSalesOrdersResponse
+from convexity_api_client.models.bulk_upsert_sales_return_payload import BulkUpsertSalesReturnPayload
 from convexity_api_client.models.bulk_upsert_sales_returns_request import BulkUpsertSalesReturnsRequest
 from convexity_api_client.models.bulk_upsert_sales_returns_response import BulkUpsertSalesReturnsResponse
 from convexity_api_client.models.cancel_sales_invoice_request import CancelSalesInvoiceRequest
@@ -54,7 +55,6 @@ from convexity_api_client.models.create_invoice_from_sales_order_request import
 from convexity_api_client.models.create_sales_invoice_request import CreateSalesInvoiceRequest
 from convexity_api_client.models.create_sales_order_line_request import CreateSalesOrderLineRequest
 from convexity_api_client.models.create_sales_order_request import CreateSalesOrderRequest
-from convexity_api_client.models.create_sales_return_request import CreateSalesReturnRequest
 from convexity_api_client.models.dropship_fulfillment_source_request import DropshipFulfillmentSourceRequest
 from convexity_api_client.models.list_sales_invoices_response import ListSalesInvoicesResponse
 from convexity_api_client.models.list_sales_orders_response import ListSalesOrdersResponse
@@ -125,9 +125,9 @@ def _create_sales_invoice_payload(
 
 
 def _bulk_sales_return_payload(
-    payload: CreateSalesReturnRequest | dict[str, Any],
-) -> CreateSalesReturnRequest:
-    return payload if isinstance(payload, CreateSalesReturnRequest) else CreateSalesReturnRequest.from_dict(payload)
+    payload: BulkUpsertSalesReturnPayload | dict[str, Any],
+) -> BulkUpsertSalesReturnPayload:
+    return payload if isinstance(payload, BulkUpsertSalesReturnPayload) else BulkUpsertSalesReturnPayload.from_dict(payload)
 
 
 def _update_sales_invoice_payload(
@@ -218,7 +218,6 @@ class Sales:
         self,
         *,
         project_id: str,
-        invoice_number: str,
         issue_date: datetime,
         due_date: datetime,
         lines: list[SalesInvoiceLineRequest | dict[str, Any]],
@@ -241,7 +240,6 @@ class Sales:
         snapshot. ``uom_id`` on a line participates in rule matching.
         """
         body = CreateSalesInvoiceRequest(
-            invoice_number=invoice_number,
             issue_date=issue_date,
             due_date=due_date,
             lines=_invoice_lines(lines),
@@ -334,7 +332,6 @@ class Sales:
         order_id: str,
         *,
         project_id: str,
-        invoice_number: str,
         issue_date: datetime,
         due_date: datetime,
         customer_id: str | None = None,
@@ -353,7 +350,6 @@ class Sales:
         unit price. Overridden lines are recorded as manual snapshots.
         """
         body = CreateInvoiceFromSalesOrderRequest(
-            invoice_number=invoice_number,
             issue_date=issue_date,
             due_date=due_date,
             customer_id=_optional(customer_id),
@@ -379,7 +375,6 @@ class Sales:
         packing_slip_id: str,
         *,
         project_id: str,
-        invoice_number: str,
         issue_date: datetime,
         due_date: datetime,
         customer_id: str | None = None,
@@ -398,7 +393,6 @@ class Sales:
         unit price. Overridden lines are recorded as manual snapshots.
         """
         body = CreateInvoiceFromPackingSlipRequest(
-            invoice_number=invoice_number,
             issue_date=issue_date,
             due_date=due_date,
             customer_id=_optional(customer_id),
@@ -562,7 +556,6 @@ class Sales:
         self,
         *,
         project_id: str,
-        so_number: str,
         lines: list[CreateSalesOrderLineRequest | dict[str, Any]] | None = None,
         customer_id: str | None = None,
         sales_rep_id: str | None = None,
@@ -581,9 +574,10 @@ class Sales:
         Omit ``price_list_id`` to use customer, channel, and project defaults.
         A line without ``unit_price`` resolves from the selected list; a line
         with ``unit_price`` is an intentional manual override.
+        ``external_id`` is optional for internal drafts and identifies
+        replayable source records when supplied.
         """
         body = CreateSalesOrderRequest(
-            so_number=so_number,
             customer_id=_optional(customer_id),
             sales_rep_id=_optional(sales_rep_id),
             commission_rate_snapshot=commission_rate_snapshot,
@@ -606,7 +600,7 @@ class Sales:
         project_id: str,
         orders: list[BulkUpsertSalesOrderPayload | dict[str, Any]],
     ) -> BulkUpsertSalesOrdersResponse:
-        """Bulk upsert sales orders by sales order number."""
+        """Bulk upsert sales orders by external source and external ID."""
         body = BulkUpsertSalesOrdersRequest(orders=[_bulk_sales_order_payload(order) for order in orders])
         result = _bulk_upsert_orders.sync(client=self._client, body=body, project_id=project_id)
         return _expect_response(result, BulkUpsertSalesOrdersResponse, "bulk upserting sales orders")
@@ -615,7 +609,7 @@ class Sales:
         self,
         *,
         project_id: str,
-        returns: list[CreateSalesReturnRequest | dict[str, Any]],
+        returns: list[BulkUpsertSalesReturnPayload | dict[str, Any]],
     ) -> BulkUpsertSalesReturnsResponse:
         """Bulk upsert complete sales-return snapshots by RMA number."""
         body = BulkUpsertSalesReturnsRequest(returns=[_bulk_sales_return_payload(item) for item in returns])

{convexity_sdk-0.21.0.dev373 → convexity_sdk-0.21.0.dev375}/convexity_sdk/resources/warehouses.py

@@ -34,13 +34,13 @@ from convexity_api_client.api.v1 import (
 from convexity_api_client.models.assign_inventory_item_location_request import (
     AssignInventoryItemLocationRequest,
 )
+from convexity_api_client.models.bulk_upsert_goods_receipt_payload import BulkUpsertGoodsReceiptPayload
 from convexity_api_client.models.bulk_upsert_goods_receipts_request import (
     BulkUpsertGoodsReceiptsRequest,
 )
 from convexity_api_client.models.bulk_upsert_goods_receipts_response import (
     BulkUpsertGoodsReceiptsResponse,
 )
-from convexity_api_client.models.create_goods_receipt_request import CreateGoodsReceiptRequest
 from convexity_api_client.models.create_warehouse_location_request import CreateWarehouseLocationRequest
 from convexity_api_client.models.create_warehouse_request import CreateWarehouseRequest
 from convexity_api_client.models.inventory_item_location_assignment_response import (
@@ -80,9 +80,9 @@ def _optional(value: Any | None) -> Any | Unset:
 
 
 def _goods_receipt_payload(
-    value: CreateGoodsReceiptRequest | dict[str, Any],
-) -> CreateGoodsReceiptRequest:
-    if isinstance(value, CreateGoodsReceiptRequest):
+    value: BulkUpsertGoodsReceiptPayload | dict[str, Any],
+) -> BulkUpsertGoodsReceiptPayload:
+    if isinstance(value, BulkUpsertGoodsReceiptPayload):
         return value
     serialized = dict(value)
     received_at = serialized.get("received_at")
@@ -91,7 +91,7 @@ def _goods_receipt_payload(
     lifecycle_status = serialized.get("lifecycle_status")
     if lifecycle_status is not None and not isinstance(lifecycle_status, str):
         serialized["lifecycle_status"] = getattr(lifecycle_status, "value", lifecycle_status)
-    return CreateGoodsReceiptRequest.from_dict(serialized)
+    return BulkUpsertGoodsReceiptPayload.from_dict(serialized)
 
 
 class Warehouses:
@@ -104,7 +104,7 @@ class Warehouses:
         self,
         *,
         project_id: str,
-        receipts: list[CreateGoodsReceiptRequest | dict[str, Any]],
+        receipts: list[BulkUpsertGoodsReceiptPayload | dict[str, Any]],
     ) -> BulkUpsertGoodsReceiptsResponse:
         """Import complete goods-receipt snapshots by receipt number."""
         body = BulkUpsertGoodsReceiptsRequest(

{convexity_sdk-0.21.0.dev373 → convexity_sdk-0.21.0.dev375}/samples/crm/004_manage_sales_reps.py

@@ -40,7 +40,7 @@ def main() -> None:
     )
     order = client.sales.create_order(
         project_id=project_id,
-        so_number=f"SDK-SO-{suffix}",
+        external_id=f"SDK-SO-{suffix}",
         customer_id=customer.id,
         lines=[],
     )

{convexity_sdk-0.21.0.dev373 → convexity_sdk-0.21.0.dev375}/samples/sales/005_manage_sales_orders.py

@@ -52,7 +52,7 @@ def main() -> None:
     print("\n--- Create order ---")
     order = client.sales.create_order(
         project_id=project_id,
-        so_number=so_number,
+        external_id=so_number,
         channel="sdk-sample",
         requested_ship_date=now + timedelta(days=7),
         ordered_at=now,

{convexity_sdk-0.21.0.dev373 → convexity_sdk-0.21.0.dev375}/samples/sales/007_price_list_sales_order.py

@@ -84,7 +84,7 @@ def main() -> None:
 
     order = client.sales.create_order(
         project_id=project_id,
-        so_number=f"SDK-PRICE-SO-{suffix}",
+        external_id=f"SDK-PRICE-SO-{suffix}",
         price_list_id=price_list.id,
         notes="Price-list-backed Sales Order SDK sample.",
         lines=[

{convexity_sdk-0.21.0.dev373 → convexity_sdk-0.21.0.dev375}/samples/uci/003_seed_sales_from_uci.py

@@ -794,10 +794,9 @@ def seed_sales_order(
     try:
         order = client.sales.create_order(
             project_id=project_id,
-            so_number=so_number,
+            external_id=so_number,
             customer_id=customer_id,
             channel_id=channel_id,
-            external_id=invoice.invoice_no,
             requested_ship_date=requested_ship_date,
             currency="GBP",
             notes="Synthetic sales order seeded from UCI Online Retail invoice.",