> ## Documentation Index > Fetch the complete documentation index at: https://developers.cmicglobal.com/llms.txt > Use this file to discover all available pages before exploring further. # Create Purchase Order Detail Line > ## Overview The Purchase Order Details API provides programmatic access to the CMiC Purchase Order module's line item details functionality. This API allows users to define, retrieve, and manage specific details and allocations for purchase orders, such as materials required, quantities, pricing, and distribution types. ## Notes When using the Purchase Order Details API, details must be entered and saved in the PO header (e.g., Header Detail and Distribution Detail sections) before line-item details can be entered in the Purchase Order Detail section. ## UI Navigation Purchase Order > Process > Enter Purchase Order – General tab ## Reference Articles [Enter Purchase Order – Purchase Order Detail](https://docs.cmicglobal.com/portal/Content/E_Reference_Material/PO_-_Purchase_Order/Reference/Enter_PO/Purchase_Order_Detail_Section.htm) ## Commonly Used Body Parameters | **CMiC UI Fieldname** | **Name** | **Description** | **Type** | **Data Length** | **Example** | **Required** | | --- | --- | --- | --- | --- | --- | --- | | Called From Application Code | PosCalledFromAppCode | Source application that created the PO. | string | 4 | "PO" | No | | Item Type | PosPoItemType | F(ree-Form), I(nventory), or N(on-Stock). Controls which fields (item type code, inventory location) are required/disabled. [More info](https://docs.cmicglobal.com/portal/Content/E_Reference_Material/PO_-_Purchase_Order/Reference/Enter_PO/Purchase_Order_Detail_Section.htm) | string | 1 | "I" | YES | | PO Company Code | PosCompCode | Company/job the PO costs are charged against; defaults with Job Code for 'J' distribution lines. [More info](https://docs.cmicglobal.com/portal/Content/E_Reference_Material/PO_-_Purchase_Order/Reference/Enter_PO/Purchase_Order_Section.htm) | string | 8 | "ZZ" | YES | | Release Number | PosReleaseNum | Distinguishes orders entered against blanket POs. [More info](https://docs.cmicglobal.com/portal/Content/E_Reference_Material/PO_-_Purchase_Order/Reference/Blanket_POs/Purchase_Order_Entry_Blanket.htm) | integer | 11 | 1 | YES | | PO Number | PosPoNum | Unique PO identifier; auto- or manually-assigned. | string | 11 | "25000046" | YES | | User Type Code | PosUserTypeCode | Distribution Type for the Summary table. | string | 3 | "J" | YES | | User Field 1 | PosUserField1 | Custom field 1 — stores Company Code. | string | 60 | "ZZ" | No | | User Field 2 | PosUserField2 | Custom field 2 — Job, Department, or first user-defined distribution field. | string | 60 | "PCCTRLJOB" | No | | User Field 3 | PosUserField3 | Custom field 3 — Cost Code, account, or first user-defined distribution field. | string | 60 | " 01-100" | No | | User Field 4 | PosUserField4 | Custom field 4 — Category or first user-defined distribution field. | string | 60 | "2000" | No | | Item Code | PosItmCode | Unique item identifier; required on all detail lines. | string | 16 | "2704" | YES | | Item Name | PosItmName | Name of the item being purchased. | string | 4000 | " 3/4\" CABC" | No | | Inventory type, Inventory (Location) | PosItemLocCode | Inventory location code; required for inventory items only. [More info](https://docs.cmicglobal.com/portal/Content/E_Reference_Material/PO_-_Purchase_Order/Reference/Enter_PO/Purchase_Order_Detail_Section.htm) | string | 7 | "MAIN-03" | YES | | Item Type Code | PosCiitemtypCode | Item type classification; required for inventory items (PosPoItemType), disabled for non-stock/free-form. [More info](https://docs.cmicglobal.com/portal/Content/E_Reference_Material/PO_-_Purchase_Order/Reference/Enter_PO/Purchase_Order_Detail_Section.htm) | string | 2 | "01" | YES | | WM (Weight Measurement) | PosWmCode | Weight measurement code; defaults from the PO Defaults tab for lump-sum lines. [More info](https://docs.cmicglobal.com/portal/Content/E_Reference_Material/PO_-_Purchase_Order/Reference/Enter_PO/Purchase_Order_Detail_Section.htm) | string | 2 | "$" | NO | | Description | PosDesc | Item description; auto-populated for inventory/non-stock items, manual for free-form. [More info](https://docs.cmicglobal.com/portal/Content/E_Reference_Material/PO_-_Purchase_Order/Reference/Enter_PO/Purchase_Order_Detail_Section.htm) | string | 4000 | “3/4\" CABC Prod-NonDepl” | No | | Expected Price | PosExptdPriceAmt | Default item price (inventory market/last cost, or non-stock file); editable per vendor agreement. [More info](https://docs.cmicglobal.com/portal/Content/E_Reference_Material/PO_-_Purchase_Order/Reference/Enter_PO/Purchase_Order_Detail_Section.htm) | number | | “90” | YES | | Extended (Price) | PosExtdAmt | (Quantity × Expected Price); auto-calculated, or enter directly to back-calculate price. [More info](https://docs.cmicglobal.com/portal/Content/E_Reference_Material/PO_-_Purchase_Order/Reference/Enter_PO/Purchase_Order_Detail_Section.htm) | number | | “5220” | No | | Quantity | PosOrdQty | Quantity of the item to be purchased. | number | 16 | “58” | YES | | Rec Inv - Checkbox | PosRecIntoInvFlag | For J/E/I distribution lines, flags whether items are received into inventory before going to the job/equipment; defaults on for 'I'. [More info](https://docs.cmicglobal.com/portal/Content/E_Reference_Material/PO_-_Purchase_Order/Reference/Enter_PO/Purchase_Order_Detail_Section.htm) | string | 1 | "Y" / “N” | No | | TAC Setup Flag | PosTacSetupFlag | Indicates if TAC (Tax, Assessment, Compliance) is set up for this PO. | string | 4000 | “Y” / "N" | No | | WBS Setup Flag | PosWbsSetupFlag | Indicates if Work Breakdown Structure is set up for this PO. | string | 4000 | "J" | No | ## Other (Optional) Body Parameters | **CMiC UI Fieldname** | **Name** | **Description** | **Type** | **Data Length** | **Example** | | --- | --- | --- | --- | --- | --- | | Classification Code | PosClassCode | Classifies the PO for reporting and analysis. | string | 4 | "STEEL" | | Expected Date | PosExptdDate | Date the merchandise is expected to be received. | Date | | "2025-04-15" | | Line Number | PosLineNum | System-generated sequential line number. | integer | 6 | 1 | | On-order Quantity | PosOnOrderQty | Quantity on order but not yet received. | number | 16 | 0 | | Tax 1 Code | PosTax1Code | Code for the first tax applied to this PO. | string | 11 | "GST" | | Tax 1 Taxable Flag | PosTax1TaxableFlag | Indicates if the PO is subject to the first tax. | string | 1 | "Y" / “N” | | Tax 2 Code | PosTax2Code | Code for the second tax applied to this PO. | string | 11 | "PST" | | Tax 2 Taxable Flag | PosTax2TaxableFlag | Indicates if the PO is subject to the second tax. | string | 1 | "Y" / “N” | | Tax 3 Code | PosTax3Code | Code for the third tax applied to this PO. | string | 11 | "" | | Tax 3 Taxable Flag | PosTax3TaxableFlag | Indicates if the PO is subject to the third tax. | string | 1 | "Y" / “N” | | User Field 5 | PosUserField5 | Custom field 5. | string | 60 | "Special Handling" | | User Field 6 | PosUserField6 | Custom field 6. | string | 60 | "Expedited Shipping" | | User Field 7 | PosUserField7 | Custom field 7. | string | 60 | "Inspection Required" | | User Field 8 | PosUserField8 | Custom field 8. | string | 60 | "Quality Check" | | Master Version UUID | PosPomstVUuid | UUID of the purchase order's master version. | string | 64 | "550e8400-e29b-41d4-a716-446655440000" | | Version UUID | PosVUuid | UUID of this purchase order version. | string | 64 | "550e8400-e29b-41d4-a716-446655440001" | | WBS Code 1 | PosWbsvCode1 | Work Breakdown Structure code 1. | string | 60 | | | WBS Code 10 | PosWbsvCode10 | Work Breakdown Structure code 10. | string | 60 | | | WBS Code 11 | PosWbsvCode11 | Work Breakdown Structure code 11. | string | 60 | | | WBS Code 12 | PosWbsvCode12 | Work Breakdown Structure code 12. | string | 60 | | | WBS Code 2 | PosWbsvCode2 | Work Breakdown Structure code 2. | string | 60 | | | WBS Code 3 | PosWbsvCode3 | Work Breakdown Structure code 3. | string | 60 | | | WBS Code 4 | PosWbsvCode4 | Work Breakdown Structure code 4. | string | 60 | | | WBS Code 5 | PosWbsvCode5 | Work Breakdown Structure code 5. | string | 60 | | | WBS Code 6 | PosWbsvCode6 | Work Breakdown Structure code 6. | string | 60 | | | WBS Code 7 | PosWbsvCode7 | Work Breakdown Structure code 7. | string | 60 | | | WBS Code 8 | PosWbsvCode8 | Work Breakdown Structure code 8. | string | 60 | | | WBS Code 9 | PosWbsvCode9 | Work Breakdown Structure code 9. | string | 60 | | | Lump Sum PO Flag | PosLumpSumPoFlag | Flags a lump-sum PO; requires at least one lump-sum line and defaults Item Type to Free-Form. [More info](https://docs.cmicglobal.com/portal/Content/E_Reference_Material/PO_-_Purchase_Order/How_To/Using_Lump_Sum_PO.htm) | string | 1 | "Y" / “N” | ## OpenAPI ````json POST /po-rest-api/rest/1/podetail { "openapi": "3.0.0", "info": { "title": "API Catalog", "description": "", "version": "1.0.0" }, "servers": [ { "url": "https://mobtest.cmiccloudr12.com/cmictestrti", "description": "CMIC API Server" } ], "security": [ { "cmicBasicAuth": [] } ], "tags": [ { "name": "Highlights" }, { "name": "Asset Management | Equipment" }, { "name": "Asset Management | Fixed Assets" }, { "name": "Asset Management | Purchase Order" }, { "name": "Asset Management | Inventory" }, { "name": "Asset Management | Requisition" }, { "name": "Asset Management | Purchase Change Order" }, { "name": "Bim Model" }, { "name": "Bim Model Revision" }, { "name": "Bim Tag Model" }, { "name": "Bim Tags" }, { "name": "Bim FileUpload Jersey" }, { "name": "Core System | Business Partners" }, { "name": "Core System | Business Partner Addresses" }, { "name": "Core System | Bank" }, { "name": "Core System | Currency" }, { "name": "Core System | Exchange Rates" }, { "name": "Core System | Global Table Text Codes" }, { "name": "Core System | Global Table Regions" }, { "name": "Core System | Terms" }, { "name": "Core System | System Contact" }, { "name": "Core System | Weight Measures" }, { "name": "Core System | Field User Defined Classifiers" }, { "name": "Core System | User Defined Classifiers by Object" }, { "name": "Core System | User Extension Definitions by Object" }, { "name": "Core System | User Extention Field Data Value" }, { "name": "Core System | User Extension Values by Object" }, { "name": "Core System | User System Role" }, { "name": "Core System | User Project Role" }, { "name": "Core System | Documents by Object" }, { "name": "Core System | Audit Status Log by Object" }, { "name": "Core System | Licensed Users" }, { "name": "Core System | Company Access" }, { "name": "Core System | Copy User Settings" }, { "name": "Core System | User Maintenance" }, { "name": "Core System | User Roles" }, { "name": "Core System | Security Groups" }, { "name": "Core System | Job/Project Security" }, { "name": "Core System | Weight Measure with Conversions Code" }, { "name": "Core System | Weight Measure Conversions Code" }, { "name": "Core System | User-defined-fields" }, { "name": "Core System | User-extension" }, { "name": "ECM and Workflow | Image Manager" }, { "name": "Financials | General Ledger" }, { "name": "Financials | Accounts Payable" }, { "name": "Financials | Accounts Receivable" }, { "name": "Preventative Maintenance | Issue Work Orders" }, { "name": "Preventative Maintenance | Issue Work Items" }, { "name": "Preventative Maintenance | Issue Work Budgets" }, { "name": "Preventative Maintenance | Issue Priorities" }, { "name": "Preventative Maintenance | Issue Status" }, { "name": "Preventative Maintenance | Issue Types" }, { "name": "Preventative Maintenance | Accumulative Equipment" }, { "name": "Preventative Maintenance | Work Orders" }, { "name": "Preventative Maintenance | Work Items" }, { "name": "Preventative Maintenance | Work Budgets" }, { "name": "Preventative Maintenance | Priorities" }, { "name": "Preventative Maintenance | Tasks" }, { "name": "HCM | UKG Pay Deductions" }, { "name": "HCM | UKG Pay Earnings" }, { "name": "HCM | UKG Pay Headers" }, { "name": "HCM | UKG Pay Taxes" }, { "name": "HCM | Payroll Geographical States" }, { "name": "HCM | Payroll Trades" }, { "name": "HCM | Payroll Union" }, { "name": "HCM | Payroll Pay Runs" }, { "name": "HCM | Payroll Pay Groups" }, { "name": "HCM | Payroll Tax" }, { "name": "HCM | Payroll Worker Compensation" }, { "name": "HCM | Payroll Work Locations" }, { "name": "HCM | Payroll Trade Pay Rates" }, { "name": "HCM | Payroll Union Pay Rates" }, { "name": "HCM | Payroll Job Pay Rates" }, { "name": "HCM | Payroll Master Benefits" }, { "name": "HCM | Payroll Master Deductions" }, { "name": "HCM | Payroll Ben/Ded/Leave Base Codes" }, { "name": "HCM | Payroll Ben/Ded Plans" }, { "name": "HCM | Payroll Ben/Ded Plan Options" }, { "name": "HCM | Payroll Company Benefits" }, { "name": "HCM | Payroll Company Deductions" }, { "name": "HCM | Payroll Vertex Geographic Locations" }, { "name": "HCM | Payroll Checks" }, { "name": "HCM | Payroll Timesheets" }, { "name": "HCM | Employee" }, { "name": "HCM | Employee (Minimum payload)" }, { "name": "HCM | Employee History" }, { "name": "HCM | Tax Exemptions" }, { "name": "HCM | Employee Tax Overrides" }, { "name": "HCM | Employee Pay Splits" }, { "name": "HCM | Employee Benefits" }, { "name": "HCM | Employee Clock In and Out" }, { "name": "HCM | Employee Deductions" }, { "name": "HCM | Employee Leaves" }, { "name": "HCM | Employee Leave History" }, { "name": "HCM | Employee Hour Types" }, { "name": "HCM | Employee Pay History" }, { "name": "HCM | Employee Work Statuses" }, { "name": "HCM | Employee Security Group" }, { "name": "HCM | Crewtime Crew" }, { "name": "HCM | Crewtime Employee Timesheet" }, { "name": "HCM | Crewtime Equipment Timesheet" }, { "name": "HCM | Crew Maintenance Activity Assignment" }, { "name": "HCM | Crew Maintenance Member Assignment" }, { "name": "HCM | Crew Maintenance Member Trade and Union Assignment" }, { "name": "HCM | Crew Maintenance Equipment Assignment" }, { "name": "HCM | Crew Maintenance Equipment Detail Assignment" }, { "name": "HCM | HR Requisitions" }, { "name": "HCM | HR Relations" }, { "name": "HCM | HR Employee Skills" }, { "name": "HCM | HR Incident" }, { "name": "HCM | HR Employee Relatives / Dependents" }, { "name": "HCM | HR Employee Positions" }, { "name": "HCM | HR Applicants" }, { "name": "HCM | HR Applications" }, { "name": "HCM | Vertex Location City" }, { "name": "HCM | HR Application History" }, { "name": "HCM | HR Dependent Benefits" }, { "name": "HCM | HR Dependent Deductions" }, { "name": "HCM | HR Employee Elected Plans" }, { "name": "HCM | HR Employee Training Certifications" }, { "name": "HCM | HR Trainings" }, { "name": "HCM | E-Timesheets" }, { "name": "HCM | System Contacts" }, { "name": "HCM | System User Payroll Security Group" }, { "name": "HCM | Payroll Timesheet Posting" }, { "name": "HCM | CrewTimesheet Posting" }, { "name": "HCM | HR Positions Master" }, { "name": "HCM | Payroll Pay Periods" }, { "name": "HCM | Payroll Rate Codes" }, { "name": "HCM | Payroll Overhead Codes and Rates" }, { "name": "HCM | Payroll Assigned Overhead to Jobs" }, { "name": "Materials Management | Material Sale Orders" }, { "name": "Materials Management | Material Sale Orders Details" }, { "name": "Materials Management | Truck Rate Detail" }, { "name": "Opportunity Management | Competitors" }, { "name": "Opportunity Management | Opportunities" }, { "name": "Opportunity Management | Revenue Details" }, { "name": "Opportunity Management | Opportunity History" }, { "name": "Opportunity Management | Organization" }, { "name": "Project Controls | Job Billing" }, { "name": "Project Controls | Job Cost" }, { "name": "Project Controls | PCI Details" }, { "name": "Project Controls | Unposted PCI Details" }, { "name": "Project Controls | PCI Headers" }, { "name": "Project Controls | Owner Change Orders" }, { "name": "Project Controls | CM Statuses" }, { "name": "Project Controls | CM Types" }, { "name": "Project Controls | CM Vendor Details" }, { "name": "Project Controls | Post PCI" }, { "name": "Project Management | Uploading Documents" }, { "name": "Project Management | Downloading Documents" }, { "name": "Project Management | Foreign Bid Item Imports" }, { "name": "Project Management | Communications" }, { "name": "Project Management | Daily Journals" }, { "name": "Project Management | Communications Types" }, { "name": "Project Management | Daily Journal Daily Work Plans" }, { "name": "Project Management | Daily Journal Field Forces" }, { "name": "Project Management | Daily Journal Labour" }, { "name": "Project Management | Daily Journal Materials" }, { "name": "Project Management | Daily Journal Owner Equipment" }, { "name": "Project Management | Daily Journal Quality Control" }, { "name": "Project Management | Daily Journal Tasks" }, { "name": "Project Management | Daily Journal Trade Equipment" }, { "name": "Project Management | Daily Journal Transactions" }, { "name": "Project Management | Daily Journal User Defined Data" }, { "name": "Project Management | Daily Journal Visitors" }, { "name": "Project Management | Daily Journal Bill Details" }, { "name": "Project Management | Field Work Directives" }, { "name": "Project Management | Contract Types" }, { "name": "Project Management | Company Contacts" }, { "name": "Project Management | Distribution BCC" }, { "name": "Project Management | Distribution CC" }, { "name": "Project Management | Field Work Directive Statuses" }, { "name": "Project Management | Issues" }, { "name": "Project Management | Key Players" }, { "name": "Project Management | Meetings" }, { "name": "Project Management | Meeting Attendees" }, { "name": "Project Management | Meeting Item Statuses" }, { "name": "Project Management | Meeting Tracks" }, { "name": "Project Management | Notes" }, { "name": "Project Management | Projects" }, { "name": "Project Management | Project Items" }, { "name": "Project Management | Project Item Phase Segment Sums" }, { "name": "Project Management | Project Partners" }, { "name": "Project Management | Notices" }, { "name": "Project Management | Notice Statuses" }, { "name": "Project Management | Owner JS Query" }, { "name": "Project Management | PCI Real Locations" }, { "name": "Project Management | Project Contacts" }, { "name": "Project Management | RFIs (Requests for Information)" }, { "name": "Project Management | RFI Statuses" }, { "name": "Project Management | Submittal Packages" }, { "name": "Project Management | Submittal Package Details" }, { "name": "Project Management | Submittal Package Status" }, { "name": "Project Management | Submittals" }, { "name": "Project Management | Submittal Status" }, { "name": "Project Management | Transmittals" }, { "name": "Project Management | Subcontract Headers" }, { "name": "Project Management | Subcontract Schedules" }, { "name": "Project Management | Subcontract Sechedule Phase Segment Sums" }, { "name": "Project Management | User Roles" }, { "name": "Project Management | Punchlists" }, { "name": "Project Management | Punchlist Details" }, { "name": "Project Management | Punchlist Statuses" }, { "name": "Project Management | Meeting Items" }, { "name": "Project Management | Self Perform Vendor" }, { "name": "Project Management | Submittal Types" }, { "name": "Project Management | Assign contact and partner to project" }, { "name": "Project Management | Subcontract Prequal" }, { "name": "Project Management | Bid Item Package" } ], "paths": { "/po-rest-api/rest/1/podetail": { "post": { "tags": [ "Asset Management | Purchase Order" ], "summary": "Create Purchase Order Detail Line", "description": "## Overview\n\nThe Purchase Order Details API provides programmatic access to the CMiC Purchase Order module's line item details functionality. This API allows users to define, retrieve, and manage specific details and allocations for purchase orders, such as materials required, quantities, pricing, and distribution types.\n\n## Notes\n\nWhen using the Purchase Order Details API, details must be entered and saved in the PO header (e.g., Header Detail and Distribution Detail sections) before line-item details can be entered in the Purchase Order Detail section.\n\n## UI Navigation\n\nPurchase Order > Process > Enter Purchase Order – General tab\n\n## Reference Articles\n\n[Enter Purchase Order – Purchase Order Detail](https://docs.cmicglobal.com/portal/Content/E_Reference_Material/PO_-_Purchase_Order/Reference/Enter_PO/Purchase_Order_Detail_Section.htm)\n\n## Commonly Used Body Parameters\n\n| **CMiC UI Fieldname** | **Name** | **Description** | **Type** | **Data Length** | **Example** | **Required** |\n| --- | --- | --- | --- | --- | --- | --- |\n| Called From Application Code | PosCalledFromAppCode | Source application that created the PO. | string | 4 | \"PO\" | No |\n| Item Type | PosPoItemType | F(ree-Form), I(nventory), or N(on-Stock). Controls which fields (item type code, inventory location) are required/disabled. [More info](https://docs.cmicglobal.com/portal/Content/E_Reference_Material/PO_-_Purchase_Order/Reference/Enter_PO/Purchase_Order_Detail_Section.htm) | string | 1 | \"I\" | YES |\n| PO Company Code | PosCompCode | Company/job the PO costs are charged against; defaults with Job Code for 'J' distribution lines. [More info](https://docs.cmicglobal.com/portal/Content/E_Reference_Material/PO_-_Purchase_Order/Reference/Enter_PO/Purchase_Order_Section.htm) | string | 8 | \"ZZ\" | YES |\n| Release Number | PosReleaseNum | Distinguishes orders entered against blanket POs. [More info](https://docs.cmicglobal.com/portal/Content/E_Reference_Material/PO_-_Purchase_Order/Reference/Blanket_POs/Purchase_Order_Entry_Blanket.htm) | integer | 11 | 1 | YES |\n| PO Number | PosPoNum | Unique PO identifier; auto- or manually-assigned. | string | 11 | \"25000046\" | YES |\n| User Type Code | PosUserTypeCode | Distribution Type for the Summary table. | string | 3 | \"J\" | YES |\n| User Field 1 | PosUserField1 | Custom field 1 — stores Company Code. | string | 60 | \"ZZ\" | No |\n| User Field 2 | PosUserField2 | Custom field 2 — Job, Department, or first user-defined distribution field. | string | 60 | \"PCCTRLJOB\" | No |\n| User Field 3 | PosUserField3 | Custom field 3 — Cost Code, account, or first user-defined distribution field. | string | 60 | \" 01-100\" | No |\n| User Field 4 | PosUserField4 | Custom field 4 — Category or first user-defined distribution field. | string | 60 | \"2000\" | No |\n| Item Code | PosItmCode | Unique item identifier; required on all detail lines. | string | 16 | \"2704\" | YES |\n| Item Name | PosItmName | Name of the item being purchased. | string | 4000 | \" 3/4\\\" CABC\" | No |\n| Inventory type, Inventory (Location) | PosItemLocCode | Inventory location code; required for inventory items only. [More info](https://docs.cmicglobal.com/portal/Content/E_Reference_Material/PO_-_Purchase_Order/Reference/Enter_PO/Purchase_Order_Detail_Section.htm) | string | 7 | \"MAIN-03\" | YES |\n| Item Type Code | PosCiitemtypCode | Item type classification; required for inventory items (PosPoItemType), disabled for non-stock/free-form. [More info](https://docs.cmicglobal.com/portal/Content/E_Reference_Material/PO_-_Purchase_Order/Reference/Enter_PO/Purchase_Order_Detail_Section.htm) | string | 2 | \"01\" | YES |\n| WM (Weight Measurement) | PosWmCode | Weight measurement code; defaults from the PO Defaults tab for lump-sum lines. [More info](https://docs.cmicglobal.com/portal/Content/E_Reference_Material/PO_-_Purchase_Order/Reference/Enter_PO/Purchase_Order_Detail_Section.htm) | string | 2 | \"$\" | NO |\n| Description | PosDesc | Item description; auto-populated for inventory/non-stock items, manual for free-form. [More info](https://docs.cmicglobal.com/portal/Content/E_Reference_Material/PO_-_Purchase_Order/Reference/Enter_PO/Purchase_Order_Detail_Section.htm) | string | 4000 | “3/4\\\" CABC Prod-NonDepl” | No |\n| Expected Price | PosExptdPriceAmt | Default item price (inventory market/last cost, or non-stock file); editable per vendor agreement. [More info](https://docs.cmicglobal.com/portal/Content/E_Reference_Material/PO_-_Purchase_Order/Reference/Enter_PO/Purchase_Order_Detail_Section.htm) | number | | “90” | YES |\n| Extended (Price) | PosExtdAmt | (Quantity × Expected Price); auto-calculated, or enter directly to back-calculate price. [More info](https://docs.cmicglobal.com/portal/Content/E_Reference_Material/PO_-_Purchase_Order/Reference/Enter_PO/Purchase_Order_Detail_Section.htm) | number | | “5220” | No |\n| Quantity | PosOrdQty | Quantity of the item to be purchased. | number | 16 | “58” | YES |\n| Rec Inv - Checkbox | PosRecIntoInvFlag | For J/E/I distribution lines, flags whether items are received into inventory before going to the job/equipment; defaults on for 'I'. [More info](https://docs.cmicglobal.com/portal/Content/E_Reference_Material/PO_-_Purchase_Order/Reference/Enter_PO/Purchase_Order_Detail_Section.htm) | string | 1 | \"Y\" / “N” | No |\n| TAC Setup Flag | PosTacSetupFlag | Indicates if TAC (Tax, Assessment, Compliance) is set up for this PO. | string | 4000 | “Y” / \"N\" | No |\n| WBS Setup Flag | PosWbsSetupFlag | Indicates if Work Breakdown Structure is set up for this PO. | string | 4000 | \"J\" | No |\n\n## Other (Optional) Body Parameters\n\n| **CMiC UI Fieldname** | **Name** | **Description** | **Type** | **Data Length** | **Example** |\n| --- | --- | --- | --- | --- | --- |\n| Classification Code | PosClassCode | Classifies the PO for reporting and analysis. | string | 4 | \"STEEL\" |\n| Expected Date | PosExptdDate | Date the merchandise is expected to be received. | Date | | \"2025-04-15\" |\n| Line Number | PosLineNum | System-generated sequential line number. | integer | 6 | 1 |\n| On-order Quantity | PosOnOrderQty | Quantity on order but not yet received. | number | 16 | 0 |\n| Tax 1 Code | PosTax1Code | Code for the first tax applied to this PO. | string | 11 | \"GST\" |\n| Tax 1 Taxable Flag | PosTax1TaxableFlag | Indicates if the PO is subject to the first tax. | string | 1 | \"Y\" / “N” |\n| Tax 2 Code | PosTax2Code | Code for the second tax applied to this PO. | string | 11 | \"PST\" |\n| Tax 2 Taxable Flag | PosTax2TaxableFlag | Indicates if the PO is subject to the second tax. | string | 1 | \"Y\" / “N” |\n| Tax 3 Code | PosTax3Code | Code for the third tax applied to this PO. | string | 11 | \"\" |\n| Tax 3 Taxable Flag | PosTax3TaxableFlag | Indicates if the PO is subject to the third tax. | string | 1 | \"Y\" / “N” |\n| User Field 5 | PosUserField5 | Custom field 5. | string | 60 | \"Special Handling\" |\n| User Field 6 | PosUserField6 | Custom field 6. | string | 60 | \"Expedited Shipping\" |\n| User Field 7 | PosUserField7 | Custom field 7. | string | 60 | \"Inspection Required\" |\n| User Field 8 | PosUserField8 | Custom field 8. | string | 60 | \"Quality Check\" |\n| Master Version UUID | PosPomstVUuid | UUID of the purchase order's master version. | string | 64 | \"550e8400-e29b-41d4-a716-446655440000\" |\n| Version UUID | PosVUuid | UUID of this purchase order version. | string | 64 | \"550e8400-e29b-41d4-a716-446655440001\" |\n| WBS Code 1 | PosWbsvCode1 | Work Breakdown Structure code 1. | string | 60 | |\n| WBS Code 10 | PosWbsvCode10 | Work Breakdown Structure code 10. | string | 60 | |\n| WBS Code 11 | PosWbsvCode11 | Work Breakdown Structure code 11. | string | 60 | |\n| WBS Code 12 | PosWbsvCode12 | Work Breakdown Structure code 12. | string | 60 | |\n| WBS Code 2 | PosWbsvCode2 | Work Breakdown Structure code 2. | string | 60 | |\n| WBS Code 3 | PosWbsvCode3 | Work Breakdown Structure code 3. | string | 60 | |\n| WBS Code 4 | PosWbsvCode4 | Work Breakdown Structure code 4. | string | 60 | |\n| WBS Code 5 | PosWbsvCode5 | Work Breakdown Structure code 5. | string | 60 | |\n| WBS Code 6 | PosWbsvCode6 | Work Breakdown Structure code 6. | string | 60 | |\n| WBS Code 7 | PosWbsvCode7 | Work Breakdown Structure code 7. | string | 60 | |\n| WBS Code 8 | PosWbsvCode8 | Work Breakdown Structure code 8. | string | 60 | |\n| WBS Code 9 | PosWbsvCode9 | Work Breakdown Structure code 9. | string | 60 | |\n| Lump Sum PO Flag | PosLumpSumPoFlag | Flags a lump-sum PO; requires at least one lump-sum line and defaults Item Type to Free-Form. [More info](https://docs.cmicglobal.com/portal/Content/E_Reference_Material/PO_-_Purchase_Order/How_To/Using_Lump_Sum_PO.htm) | string | 1 | \"Y\" / “N” |", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "example": { "PosCalledFromAppCode": "PO", "PosPoItemType": "F", "PosCompCode": "001", "PosReleaseNum": "1", "PosPoNum": "23.000001", "PosUserTypeCode": "J", "PosUserField1": "001", "PosUserField2": "01JOB", "PosUserField3": "00010", "PosUserField4": "L", "PosItmCode": "MATERIALS", "PosItmName": "Structural Concrete", "PosItemLocCode": "null", "PosCiitemtypCode": "N", "PosWmCode": "NA", "PosDesc": "test", "PosExptdPriceAmt": "1", "PosExtdAmt": "10", "PosOrdQty": "10", "PosRecIntoInvFlag": "N", "PosTacSetupFlag": "N", "PosWbsSetupFlag": "N" } } } } }, "parameters": [ { "name": "Content-Type", "in": "header", "schema": { "type": "string" }, "example": "application/vnd.oracle.adf.resourceItem+json" } ], "responses": { "201": { "description": "Created", "headers": { "Content-Type": { "schema": { "type": "string", "example": "application/vnd.oracle.adf.resourceitem+json" } } }, "content": { "application/json": { "schema": { "type": "object" }, "example": { "PosCalledFromAppCode": "PO", "PosCatName": null, "PosCiitemtypCode": "N", "PosClassCode": null, "PosCompCode": "001", "PosDesc": "test", "PosExptdDate": null, "PosExptdPriceAmt": 1, "PosExtdAmt": 10, "PosItemLocCode": "null", "PosItmCode": "MATERIALS", "PosItmName": "Structural Concrete", "PosJobName": null, "PosLineNum": 2, "PosMaxOnhandQty": null, "PosMaxOrderQty": null, "PosMinOnhandQty": null, "PosMinOrderQty": null, "PosOnHandQty": null, "PosOnOrderQty": null, "PosOrdQty": 10, "PosPhsName": null, "PosPoItemType": "F", "PosPoNum": "23.000001", "PosRecIntoInvFlag": "N", "PosReleaseNum": 1, "PosStdOrderQty": null, "PosTacSetupFlag": "N", "PosTax1Code": null, "PosTax1OnTaxFlag": null, "PosTax1Perc": null, "PosTax1TaxableFlag": null, "PosTax2Code": null, "PosTax2OnTaxFlag": null, "PosTax2Perc": null, "PosTax2TaxableFlag": null, "PosTax3Code": null, "PosTax3OnTaxFlag": null, "PosTax3Perc": null, "PosTax3TaxableFlag": null, "PosTaxAmt": null, "PosTotAmt": null, "PosUserField1": "001", "PosUserField2": "01JOB", "PosUserField3": "00010", "PosUserField4": "L", "PosUserField5": null, "PosUserField6": null, "PosUserField7": null, "PosUserField8": null, "PosUserFieldEdtFlag5": null, "PosUserFieldEdtFlag6": null, "PosUserFieldEdtFlag7": null, "PosUserFieldEdtFlag8": null, "PosUserFieldName5": null, "PosUserFieldName6": null, "PosUserFieldName7": null, "PosUserFieldName8": null, "PosUserTypeCode": "J", "PosPomstVUuid": null, "PosVUuid": "F7FB90F5C3F214DDE05316821FAC502E", "PosWbsSetupFlag": "N", "PosWbsvCode1": null, "PosWbsvCode10": null, "PosWbsvCode11": null, "PosWbsvCode12": null, "PosWbsvCode2": null, "PosWbsvCode3": null, "PosWbsvCode4": null, "PosWbsvCode5": null, "PosWbsvCode6": null, "PosWbsvCode7": null, "PosWbsvCode8": null, "PosWbsvCode9": null, "PosWmCode": "NA", "PosIuCreateDate": null, "PosIuUpdateDate": null, "PosLumpSumPoFlag": null, "links": [ { "rel": "self", "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/po-rest-api/rest/1/podetail/F7FB90F5C3F214DDE05316821FAC502E", "name": "podetail", "kind": "item" }, { "rel": "canonical", "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/po-rest-api/rest/1/podetail/F7FB90F5C3F214DDE05316821FAC502E", "name": "podetail", "kind": "item" } ] } } } } } } } }, "components": { "securitySchemes": { "cmicBasicAuth": { "type": "http", "scheme": "basic", "description": "Basic authentication" } } } } ````