Skip to content

katana_public_api_client.models.create_purchase_order_request

katana_public_api_client.models.create_purchase_order_request

Classes

CreatePurchaseOrderRequest

Request payload for creating a new purchase order to procure materials or products from suppliers

Example

{'order_no': 'PO-2024-0156', 'entity_type': 'regular', 'supplier_id': 4001, 'currency': 'USD', 'status': 'NOT_RECEIVED', 'order_created_date': '2024-01-15T09:30:00Z', 'location_id': 1, 'additional_info': "Rush order - needed for Valentine's Day production run", 'purchase_order_rows': [{'quantity': 250, 'price_per_unit': 2.85, 'variant_id': 501, 'tax_rate_id': 1, 'purchase_uom': 'kg', 'purchase_uom_conversion_rate': 1.0, 'arrival_date': '2024-08-20T14:45:00Z'}, {'quantity': 100, 'price_per_unit': 12.5, 'variant_id': 502, 'tax_rate_id': 1, 'purchase_uom': 'pieces', 'purchase_uom_conversion_rate': 1.0, 'arrival_date': '2024-08-20T14:45:00Z'}]}

Attributes:

  • order_no (str) –

    Unique purchase order number for tracking and reference

  • supplier_id (int) –

    Unique identifier of the supplier providing the materials or services

  • location_id (int) –

    Primary location where the purchased items will be received and stored

  • purchase_order_rows (list[PurchaseOrderRowRequest]) –

    List of line items being ordered, including quantities and pricing

  • entity_type (PurchaseOrderEntityType | Unset) –

    Type of purchase order - regular for materials or outsourced for subcontracted work

  • currency (str | Unset) –

    Active ISO 4217 currency code (e.g. USD, EUR).

  • status (CreatePurchaseOrderInitialStatus | Unset) –

    Initial status when creating a purchase order

  • order_created_date (datetime | Unset) –

    Date when the purchase order was created

  • additional_info (str | Unset) –

    Optional notes or special instructions for the supplier

  • expected_arrival_date (datetime | Unset) –

    Expected date when the purchase order items will arrive

  • tracking_location_id (int | Unset) –

    Location ID for tracking outsourced orders