@simpleapps-com/augur-api 0.3.2 → 0.4.0

package/dist/esm/services/orders/client.js

@@ -1,8 +1,8 @@
 import { BaseServiceClient } from '../../core/base-client';
 import { HealthCheckResponseSchema, OrderHeaderResponseSchema, OrderDocumentResponseSchema, OrderLookupParamsSchema, OrderDocumentParamsSchema, SalesRepOrderListResponseSchema, SalesRepOrderDocumentResponseSchema, PurchaseOrderListResponseSchema, PurchaseOrderDetailResponseSchema, PurchaseOrderDocumentResponseSchema, PurchaseOrderScanResponseSchema, PurchaseOrderListParamsSchema, PurchaseOrderScanParamsSchema, InvoiceReprintApiResponseSchema, } from './schemas';
 /**
- * Orders Service Client
- * @description Comprehensive order management functionality for the Augur platform covering the complete order lifecycle from creation through fulfillment, including order processing, invoicing, purchase orders, and sales representative management.
+ * Orders Service Client - OpenAPI Path Mirroring Implementation
+ * @description Comprehensive order management functionality for the Augur platform covering the complete order lifecycle from creation through fulfillment, including order processing, invoicing, purchase orders, and sales representative management. Follows strict OpenAPI path mirroring pattern.
  *
  * @fullPath api.orders
  * @service orders
@@ -20,20 +20,19 @@ import { HealthCheckResponseSchema, OrderHeaderResponseSchema, OrderDocumentResp
  * ```typescript
  * const api = new AugurAPI({ bearerToken: 'token', siteId: 'site' });
  *
- * // Standard methods (full BaseResponse)
- * const ordersResponse = await api.orders.oeHdr.lookup({ limit: 10, q: '12345' });
+ * // OpenAPI Path Mirroring Examples:
+ * // /oe-hdr/lookup → api.orders.oeHdr.lookup.list()
+ * const ordersResponse = await api.orders.oeHdr.lookup.list({ limit: 10, q: '12345' });
  * console.log(`Found ${ordersResponse.total} orders`);
  *
- * // Data methods (data only)
- * const orders = await api.orders.oeHdr.lookupData({ limit: 10, q: '12345' });
- * orders.forEach(order => console.log(order.orderNo, order.customerName));
+ * // /oe-hdr/{orderNo}/doc → api.orders.oeHdr.doc.get(orderNo)
+ * const orderDoc = await api.orders.oeHdr.doc.get(12345678, { postalCode: '12345' });
  *
- * // Get order document with validation
- * const orderDoc = await api.orders.oeHdr.getDocument(12345678, { postalCode: '12345' });
+ * // /oe-hdr-salesrep/{salesrepId}/oe-hdr → api.orders.oeHdrSalesrep.oeHdr.list(salesrepId)
+ * const repOrders = await api.orders.oeHdrSalesrep.oeHdr.list(12345);
  *
- * // Purchase order workflow
- * const pos = await api.orders.poHdr.listData({ complete: 'N', limit: 20 });
- * const poDoc = await api.orders.poHdr.getDocument(pos[0].poNo);
+ * // /po-hdr/scan → api.orders.poHdr.scan.create(params)
+ * const similarPOs = await api.orders.poHdr.scan.create({ vendorId: 'VENDOR001' });
  * ```
  */
 export class OrdersClient extends BaseServiceClient {
@@ -45,257 +44,255 @@ export class OrdersClient extends BaseServiceClient {
     constructor(http, baseUrl = 'https://orders.augur-api.com') {
         super('orders', http, baseUrl);
         /**
-         * Order Management Operations (oe-hdr endpoints)
-         * @description Core order management functionality for searching, tracking, and retrieving sales orders
+         * Health check endpoint
+         * @description Service health and status monitoring endpoint for system diagnostics and uptime verification
+         *
+         * @fullPath api.orders.healthCheck.get
+         * @service orders
+         * @domain system-monitoring
+         * @dataMethod getData - returns only the health check data without metadata
+         * @discoverable true
+         * @searchTerms ["health check", "service status", "orders health", "system status"]
+         * @relatedEndpoints ["api.joomla.healthCheck.get", "api.nexus.healthCheck.get", "api.items.healthCheck.get"]
+         * @commonPatterns ["Check service health", "System monitoring", "Service status"]
+         * @workflow ["system-monitoring", "health-diagnostics"]
+         * @functionalArea "system-operations"
+         * @performance "Lightweight endpoint for monitoring - minimal response time"
          */
-        this.oeHdr = {
-            /**
-             * Search and list order headers with flexible filtering options
-             * @description Returns paginated order headers with comprehensive filtering by customer, date, status, sales rep, and search terms. Supports edge caching for improved performance.
-             *
-             * @fullPath api.orders.oeHdr.lookup
-             * @service orders
-             * @domain order-management
-             * @dataMethod lookupData - returns only the order headers array without metadata
-             * @discoverable true
-             * @searchTerms ["order lookup", "search orders", "order list", "find orders", "order search", "sales orders"]
-             * @relatedEndpoints ["api.orders.oeHdr.getDocument", "api.customers.customer.list", "api.orders.oeHdrSalesrep.getOrders"]
-             * @commonPatterns ["Search orders by customer", "Find orders by order number", "List incomplete orders", "Filter by date range"]
-             * @workflow ["order-discovery", "order-status-tracking", "customer-order-history"]
-             * @prerequisites ["Valid authentication token", "Order access permissions"]
-             * @nextSteps ["api.orders.oeHdr.getDocument for full details", "api.customers.customer.get for customer info"]
-             * @businessRules ["Returns only orders accessible to current user/sales rep", "Completed orders may have restricted access", "Search supports partial matches"]
-             * @functionalArea "order-and-fulfillment-management"
-             * @caching "Supports edgeCache parameter (1-8 hours) for frequently accessed order lists"
-             * @performance "Use pagination for large result sets. Filter by specific criteria to improve performance."
-             *
-             * @param params Optional filtering and pagination parameters
-             * @param params.q Search query for order number, customer name, or PO number
-             * @param params.completed Filter by completion status ('Y' for completed, 'N' for incomplete)
-             * @param params.salesrepId Filter orders by specific sales representative ID
-             * @param params.class1Id Filter by customer class/category
-             * @param params.dateOrderCompleted Filter by order completion date (YYYY-MM-DD format)
-             * @param params.limit Maximum number of orders to return (default: 20, max: 100)
-             * @param params.offset Number of items to skip for pagination
-             * @param params.edgeCache Cache duration in hours (1-8) for improved performance
-             * @returns Promise<BaseResponse<OrderHeader[]>> Complete response with order headers and metadata
-             *
-             * @example
-             * ```typescript
-             * // Search orders with full response metadata
-             * const response = await api.orders.oeHdr.lookup({
-             *   q: '12345',
-             *   completed: 'N',
-             *   limit: 10
-             * });
-             * console.log(`Found ${response.total} orders`);
-             *
-             * // Get just the order data
-             * const orders = await api.orders.oeHdr.lookupData({
-             *   salesrepId: 'REP001',
-             *   limit: 50
-             * });
-             *
-             * // Filter by completion status with caching
-             * const incompleteOrders = await api.orders.oeHdr.lookup({
-             *   completed: 'N',
-             *   edgeCache: 2,  // Cache for 2 hours
-             *   orderBy: 'orderDate DESC'
-             * });
-             * ```
-             */
-            lookup: this.createListMethod('/oe-hdr/lookup', OrderLookupParamsSchema, OrderHeaderResponseSchema),
-            /**
-             * Get only order headers data without response metadata
-             * @description Data-only version of lookup() method - returns the order headers array directly
-             *
-             * @param params Same parameters as lookup() method
-             * @returns Promise<OrderHeader[]> Direct array of order headers
-             */
-            lookupData: async (params) => {
-                const response = await this.oeHdr.lookup(params);
-                return response.data;
-            },
-            /**
-             * Retrieve complete order document with all related information
-             * @description Returns comprehensive order details including customer info, shipping address, line items, and totals. Includes optional postal code validation for security.
-             *
-             * @fullPath api.orders.oeHdr.getDocument
-             * @service orders
-             * @domain order-management
-             * @dataMethod getDocumentData - returns only the order document without metadata
-             * @discoverable true
-             * @searchTerms ["order document", "order details", "full order", "order with lines", "complete order"]
-             * @relatedEndpoints ["api.orders.oeHdr.lookup", "api.customers.customer.get", "api.items.products.get"]
-             * @commonPatterns ["Get order details", "View complete order", "Order with line items", "Full order document"]
-             * @workflow ["order-review", "order-fulfillment", "customer-service"]
-             * @prerequisites ["Valid order number", "Order access permissions", "Optional postal code for validation"]
-             * @nextSteps ["Process order fulfillment", "Update order status", "Generate invoice"]
-             * @businessRules ["Postal code validation optional but recommended for security", "Access restricted by sales rep permissions", "Includes all order line items and totals"]
-             * @functionalArea "order-and-fulfillment-management"
-             * @performance "Single document retrieval - no pagination needed. Consider caching for frequently accessed orders."
-             *
-             * @param orderNo Order number to retrieve
-             * @param params Optional parameters including postal code validation
-             * @param params.postalCode Optional postal code for additional security validation
-             * @returns Promise<BaseResponse<OrderDocument>> Complete response with full order document
-             *
-             * @example
-             * ```typescript
-             * // Get order document with validation
-             * const response = await api.orders.oeHdr.getDocument(12345678, {
-             *   postalCode: '12345'
-             * });
-             * console.log(`Order ${response.data.orderNo} for ${response.data.customerName}`);
-             *
-             * // Get just the document data
-             * const order = await api.orders.oeHdr.getDocumentData(12345678);
-             * order.lines.forEach(line => {
-             *   console.log(`${line.itemId}: ${line.qtyOrdered} @ $${line.unitPrice}`);
-             * });
-             *
-             * // Without postal code validation
-             * const orderDoc = await api.orders.oeHdr.getDocument(12345678);
-             * ```
-             */
-            getDocument: async (orderNo, params) => {
-                return this.executeRequest({
-                    method: 'GET',
-                    path: `/oe-hdr/${orderNo}/doc`,
-                    paramsSchema: OrderDocumentParamsSchema,
-                    responseSchema: OrderDocumentResponseSchema,
-                }, params);
-            },
+        this.healthCheck = {
+            get: this.createHealthCheckMethod(HealthCheckResponseSchema),
             /**
-             * Get only order document data without response metadata
-             * @description Data-only version of getDocument() method - returns the order document directly
-             *
-             * @param orderNo Order number to retrieve
-             * @param params Optional parameters including postal code validation
-             * @returns Promise<OrderDocument> Direct order document object
+             * Get only health check data without response metadata
+             * @returns Promise<HealthCheckData> Direct health check data object
              */
-            getDocumentData: async (orderNo, params) => {
-                const response = await this.oeHdr.getDocument(orderNo, params);
+            getData: async () => {
+                const response = await this.healthCheck.get();
                 return response.data;
             },
         };
         /**
-         * Sales Representative Order Operations
-         * @description Order management functionality specific to sales representatives including territory-based order access and rep-specific reporting
+         * Invoice Header Operations - OpenAPI Path: /invoice-hdr
+         * @description Invoice processing and document management with Prophet 21 integration for billing and accounting workflows following OpenAPI path mirroring pattern
          */
-        this.oeHdrSalesrep = {
+        this.invoiceHdr = {
             /**
-             * Get order list for a specific sales representative
-             * @description Returns all orders associated with a specific sales representative, filtered by territory and permissions. Essential for sales performance tracking and customer relationship management.
-             *
-             * @fullPath api.orders.oeHdrSalesrep.getOrders
-             * @service orders
-             * @domain sales-management
-             * @dataMethod getOrdersData - returns only the orders array without metadata
-             * @discoverable true
-             * @searchTerms ["sales rep orders", "representative orders", "territory orders", "sales orders by rep", "rep performance"]
-             * @relatedEndpoints ["api.orders.oeHdrSalesrep.getOrderDocument", "api.orders.oeHdr.lookup", "api.customers.customer.list"]
-             * @commonPatterns ["Sales rep performance", "Territory management", "Rep order history", "Sales tracking"]
-             * @workflow ["sales-performance-tracking", "territory-management", "commission-calculation"]
-             * @prerequisites ["Valid sales representative ID", "Sales rep access permissions"]
-             * @nextSteps ["api.orders.oeHdrSalesrep.getOrderDocument for details", "Calculate commission totals", "Territory analysis"]
-             * @businessRules ["Returns only orders within rep's territory", "Respects sales hierarchy permissions", "May include completed and pending orders"]
-             * @functionalArea "sales-and-territory-management"
-             * @performance "Territory-filtered results - typically smaller datasets than global order lists"
-             *
-             * @param salesrepId Sales representative ID to retrieve orders for
-             * @returns Promise<BaseResponse<SalesRepOrder[]>> Complete response with rep's orders and metadata
-             *
-             * @example
-             * ```typescript
-             * // Get all orders for a sales rep
-             * const response = await api.orders.oeHdrSalesrep.getOrders(12345);
-             * console.log(`Rep has ${response.data.length} orders`);
-             *
-             * // Get just the orders data
-             * const repOrders = await api.orders.oeHdrSalesrep.getOrdersData(12345);
-             * const totalValue = repOrders.reduce((sum, order) => sum + order.orderTotal, 0);
-             * ```
+             * Invoice reprint operations - OpenAPI Path: /invoice-hdr/{invoiceNo}/reprint
              */
-            getOrders: async (salesrepId) => {
-                return this.executeRequest({
-                    method: 'GET',
-                    path: `/oe-hdr-salesrep/${salesrepId}/oe-hdr`,
-                    responseSchema: SalesRepOrderListResponseSchema,
-                }, {});
+            reprint: {
+                /**
+                 * Reprint an existing invoice through Prophet 21 integration
+                 * @description Generates a reprint of an existing invoice through Prophet 21 system integration. Returns invoice document data and reprint status for billing and customer service workflows.
+                 *
+                 * @fullPath api.orders.invoiceHdr.reprint.get
+                 * @service orders
+                 * @domain invoice-management
+                 * @dataMethod getData - returns only the reprint result without metadata
+                 * @discoverable true
+                 * @searchTerms ["invoice reprint", "reprint invoice", "invoice copy", "duplicate invoice", "invoice document"]
+                 * @relatedEndpoints ["api.orders.oeHdr.doc.get", "api.customers.customer.get", "api.p21-core.company.get"]
+                 * @commonPatterns ["Reprint invoice", "Customer invoice copy", "Billing document", "Invoice duplicate"]
+                 * @workflow ["invoice-management", "customer-service", "billing-workflow"]
+                 * @prerequisites ["Valid invoice number", "Invoice exists in Prophet 21", "Reprint permissions"]
+                 * @nextSteps ["Deliver invoice to customer", "Update billing records", "Customer service follow-up"]
+                 * @businessRules ["Invoice must exist in Prophet 21", "Reprint creates audit trail", "Formatting matches original invoice"]
+                 * @functionalArea "billing-and-invoicing"
+                 * @performance "Integrates with Prophet 21 - response time depends on P21 system load"
+                 */
+                get: async (invoiceNo) => {
+                    return this.executeRequest({
+                        method: 'GET',
+                        path: `/invoice-hdr/${invoiceNo}/reprint`,
+                        responseSchema: InvoiceReprintApiResponseSchema,
+                    }, {});
+                },
+                /**
+                 * Get only invoice reprint data without response metadata
+                 * @param invoiceNo Invoice number to reprint
+                 * @returns Promise<InvoiceReprintResult> Direct reprint result object
+                 */
+                getData: async (invoiceNo) => {
+                    const response = await this.invoiceHdr.reprint.get(invoiceNo);
+                    return response.data;
+                },
             },
+        };
+        /**
+         * Order Header Operations - OpenAPI Path: /oe-hdr
+         * @description Core order management functionality for searching, tracking, and retrieving sales orders following OpenAPI path mirroring pattern
+         */
+        this.oeHdr = {
             /**
-             * Get only sales rep orders data without response metadata
-             * @description Data-only version of getOrders() method - returns the orders array directly
-             *
-             * @param salesrepId Sales representative ID
-             * @returns Promise<SalesRepOrder[]> Direct array of sales rep orders
+             * Order lookup operations - OpenAPI Path: /oe-hdr/lookup
              */
-            getOrdersData: async (salesrepId) => {
-                const response = await this.oeHdrSalesrep.getOrders(salesrepId);
-                return response.data;
+            lookup: {
+                /**
+                 * Search and list order headers with flexible filtering options
+                 * @description Returns paginated order headers with comprehensive filtering by customer, date, status, sales rep, and search terms. Supports edge caching for improved performance.
+                 *
+                 * @fullPath api.orders.oeHdr.lookup.list
+                 * @service orders
+                 * @domain order-management
+                 * @dataMethod listData - returns only the order headers array without metadata
+                 * @discoverable true
+                 * @searchTerms ["order lookup", "search orders", "order list", "find orders", "order search", "sales orders"]
+                 * @relatedEndpoints ["api.orders.oeHdr.doc.get", "api.customers.customer.list", "api.orders.oeHdrSalesrep.oeHdr.list"]
+                 * @commonPatterns ["Search orders by customer", "Find orders by order number", "List incomplete orders", "Filter by date range"]
+                 * @workflow ["order-discovery", "order-status-tracking", "customer-order-history"]
+                 * @prerequisites ["Valid authentication token", "Order access permissions"]
+                 * @nextSteps ["api.orders.oeHdr.doc.get for full details", "api.customers.customer.get for customer info"]
+                 * @businessRules ["Returns only orders accessible to current user/sales rep", "Completed orders may have restricted access", "Search supports partial matches"]
+                 * @functionalArea "order-and-fulfillment-management"
+                 * @caching "Supports edgeCache parameter (1-8 hours) for frequently accessed order lists"
+                 * @performance "Use pagination for large result sets. Filter by specific criteria to improve performance."
+                 */
+                list: this.createListMethod('/oe-hdr/lookup', OrderLookupParamsSchema, OrderHeaderResponseSchema),
+                /**
+                 * Get only order headers data without response metadata
+                 * @param params Same parameters as list() method
+                 * @returns Promise<OrderHeader[]> Direct array of order headers
+                 */
+                listData: async (params) => {
+                    const response = await this.oeHdr.lookup.list(params);
+                    return response.data;
+                },
             },
             /**
-             * Get specific order document for a sales representative
-             * @description Returns complete order document with sales rep context, including commission details and territory-specific information. Validates that the order belongs to the specified sales representative.
-             *
-             * @fullPath api.orders.oeHdrSalesrep.getOrderDocument
-             * @service orders
-             * @domain sales-management
-             * @dataMethod getOrderDocumentData - returns only the order document without metadata
-             * @discoverable true
-             * @searchTerms ["sales rep order document", "rep order details", "territory order document", "rep order with lines"]
-             * @relatedEndpoints ["api.orders.oeHdrSalesrep.getOrders", "api.orders.oeHdr.getDocument", "api.customers.customer.get"]
-             * @commonPatterns ["Rep order details", "Commission calculation", "Territory order review", "Sales order analysis"]
-             * @workflow ["sales-order-review", "commission-processing", "territory-analysis"]
-             * @prerequisites ["Valid sales rep ID", "Valid order number", "Order must belong to specified rep"]
-             * @nextSteps ["Calculate commission", "Update order status", "Customer follow-up"]
-             * @businessRules ["Order must belong to specified sales rep", "Includes commission and territory data", "Access controlled by sales hierarchy"]
-             * @functionalArea "sales-and-territory-management"
-             * @performance "Single document retrieval with rep validation - efficient for territory-specific access"
-             *
-             * @param salesrepId Sales representative ID
-             * @param orderNo Order number to retrieve
-             * @returns Promise<BaseResponse<SalesRepOrderDocument>> Complete response with rep-specific order document
-             *
-             * @example
-             * ```typescript
-             * // Get order document for specific sales rep
-             * const response = await api.orders.oeHdrSalesrep.getOrderDocument(12345, 987654);
-             * console.log(`Order ${response.data.orderNo} - Commission: $${response.data.commissionAmount}`);
-             *
-             * // Get just the document data
-             * const repOrder = await api.orders.oeHdrSalesrep.getOrderDocumentData(12345, 987654);
-             * console.log(`Territory: ${repOrder.territoryCode}`);
-             * ```
+             * Order document operations - OpenAPI Path: /oe-hdr/{orderNo}/doc
              */
-            getOrderDocument: async (salesrepId, orderNo) => {
-                return this.executeRequest({
-                    method: 'GET',
-                    path: `/oe-hdr-salesrep/${salesrepId}/oe-hdr/${orderNo}/doc`,
-                    responseSchema: SalesRepOrderDocumentResponseSchema,
-                }, {});
+            doc: {
+                /**
+                 * Retrieve complete order document with all related information
+                 * @description Returns comprehensive order details including customer info, shipping address, line items, and totals. Includes optional postal code validation for security.
+                 *
+                 * @fullPath api.orders.oeHdr.doc.get
+                 * @service orders
+                 * @domain order-management
+                 * @dataMethod getData - returns only the order document without metadata
+                 * @discoverable true
+                 * @searchTerms ["order document", "order details", "full order", "order with lines", "complete order"]
+                 * @relatedEndpoints ["api.orders.oeHdr.lookup.list", "api.customers.customer.get", "api.items.products.get"]
+                 * @commonPatterns ["Get order details", "View complete order", "Order with line items", "Full order document"]
+                 * @workflow ["order-review", "order-fulfillment", "customer-service"]
+                 * @prerequisites ["Valid order number", "Order access permissions", "Optional postal code for validation"]
+                 * @nextSteps ["Process order fulfillment", "Update order status", "Generate invoice"]
+                 * @businessRules ["Postal code validation optional but recommended for security", "Access restricted by sales rep permissions", "Includes all order line items and totals"]
+                 * @functionalArea "order-and-fulfillment-management"
+                 * @performance "Single document retrieval - no pagination needed. Consider caching for frequently accessed orders."
+                 */
+                get: async (orderNo, params) => {
+                    return this.executeRequest({
+                        method: 'GET',
+                        path: `/oe-hdr/${orderNo}/doc`,
+                        paramsSchema: OrderDocumentParamsSchema,
+                        responseSchema: OrderDocumentResponseSchema,
+                    }, params);
+                },
+                /**
+                 * Get only order document data without response metadata
+                 * @param orderNo Order number to retrieve
+                 * @param params Optional parameters including postal code validation
+                 * @returns Promise<OrderDocument> Direct order document object
+                 */
+                getData: async (orderNo, params) => {
+                    const response = await this.oeHdr.doc.get(orderNo, params);
+                    return response.data;
+                },
             },
+        };
+        /**
+         * Sales Representative Order Header Operations - OpenAPI Path: /oe-hdr-salesrep
+         * @description Order management functionality specific to sales representatives including territory-based order access and rep-specific reporting following OpenAPI path mirroring pattern
+         */
+        this.oeHdrSalesrep = {
             /**
-             * Get only sales rep order document data without response metadata
-             * @description Data-only version of getOrderDocument() method - returns the order document directly
-             *
-             * @param salesrepId Sales representative ID
-             * @param orderNo Order number to retrieve
-             * @returns Promise<SalesRepOrderDocument> Direct sales rep order document object
+             * Sales representative order operations - OpenAPI Path: /oe-hdr-salesrep/{salesrepId}/oe-hdr
              */
-            getOrderDocumentData: async (salesrepId, orderNo) => {
-                const response = await this.oeHdrSalesrep.getOrderDocument(salesrepId, orderNo);
-                return response.data;
+            oeHdr: {
+                /**
+                 * Get order list for a specific sales representative
+                 * @description Returns all orders associated with a specific sales representative, filtered by territory and permissions. Essential for sales performance tracking and customer relationship management.
+                 *
+                 * @fullPath api.orders.oeHdrSalesrep.oeHdr.list
+                 * @service orders
+                 * @domain sales-management
+                 * @dataMethod listData - returns only the orders array without metadata
+                 * @discoverable true
+                 * @searchTerms ["sales rep orders", "representative orders", "territory orders", "sales orders by rep", "rep performance"]
+                 * @relatedEndpoints ["api.orders.oeHdrSalesrep.oeHdr.doc.get", "api.orders.oeHdr.lookup.list", "api.customers.customer.list"]
+                 * @commonPatterns ["Sales rep performance", "Territory management", "Rep order history", "Sales tracking"]
+                 * @workflow ["sales-performance-tracking", "territory-management", "commission-calculation"]
+                 * @prerequisites ["Valid sales representative ID", "Sales rep access permissions"]
+                 * @nextSteps ["api.orders.oeHdrSalesrep.oeHdr.doc.get for details", "Calculate commission totals", "Territory analysis"]
+                 * @businessRules ["Returns only orders within rep's territory", "Respects sales hierarchy permissions", "May include completed and pending orders"]
+                 * @functionalArea "sales-and-territory-management"
+                 * @performance "Territory-filtered results - typically smaller datasets than global order lists"
+                 */
+                list: async (salesrepId) => {
+                    return this.executeRequest({
+                        method: 'GET',
+                        path: `/oe-hdr-salesrep/${salesrepId}/oe-hdr`,
+                        responseSchema: SalesRepOrderListResponseSchema,
+                    }, {});
+                },
+                /**
+                 * Get only sales rep orders data without response metadata
+                 * @param salesrepId Sales representative ID
+                 * @returns Promise<SalesRepOrder[]> Direct array of sales rep orders
+                 */
+                listData: async (salesrepId) => {
+                    const response = await this.oeHdrSalesrep.oeHdr.list(salesrepId);
+                    return response.data;
+                },
+                /**
+                 * Sales rep order document operations - OpenAPI Path: /oe-hdr-salesrep/{salesrepId}/oe-hdr/{orderNo}/doc
+                 */
+                doc: {
+                    /**
+                     * Get specific order document for a sales representative
+                     * @description Returns complete order document with sales rep context, including commission details and territory-specific information. Validates that the order belongs to the specified sales representative.
+                     *
+                     * @fullPath api.orders.oeHdrSalesrep.oeHdr.doc.get
+                     * @service orders
+                     * @domain sales-management
+                     * @dataMethod getData - returns only the order document without metadata
+                     * @discoverable true
+                     * @searchTerms ["sales rep order document", "rep order details", "territory order document", "rep order with lines"]
+                     * @relatedEndpoints ["api.orders.oeHdrSalesrep.oeHdr.list", "api.orders.oeHdr.doc.get", "api.customers.customer.get"]
+                     * @commonPatterns ["Rep order details", "Commission calculation", "Territory order review", "Sales order analysis"]
+                     * @workflow ["sales-order-review", "commission-processing", "territory-analysis"]
+                     * @prerequisites ["Valid sales rep ID", "Valid order number", "Order must belong to specified rep"]
+                     * @nextSteps ["Calculate commission", "Update order status", "Customer follow-up"]
+                     * @businessRules ["Order must belong to specified sales rep", "Includes commission and territory data", "Access controlled by sales hierarchy"]
+                     * @functionalArea "sales-and-territory-management"
+                     * @performance "Single document retrieval with rep validation - efficient for territory-specific access"
+                     */
+                    get: async (salesrepId, orderNo) => {
+                        return this.executeRequest({
+                            method: 'GET',
+                            path: `/oe-hdr-salesrep/${salesrepId}/oe-hdr/${orderNo}/doc`,
+                            responseSchema: SalesRepOrderDocumentResponseSchema,
+                        }, {});
+                    },
+                    /**
+                     * Get only sales rep order document data without response metadata
+                     * @param salesrepId Sales representative ID
+                     * @param orderNo Order number to retrieve
+                     * @returns Promise<SalesRepOrderDocument> Direct sales rep order document object
+                     */
+                    getData: async (salesrepId, orderNo) => {
+                        const response = await this.oeHdrSalesrep.oeHdr.doc.get(salesrepId, orderNo);
+                        return response.data;
+                    },
+                },
             },
         };
         /**
-         * Purchase Order Operations
-         * @description Comprehensive purchase order management including creation, tracking, receiving, and document generation for procurement workflows
+         * Purchase Order Header Operations - OpenAPI Path: /po-hdr
+         * @description Comprehensive purchase order management including creation, tracking, receiving, and document generation for procurement workflows following OpenAPI path mirroring pattern
          */
         this.poHdr = {
             /**
-             * List purchase orders with filtering and pagination
+             * List purchase orders with filtering and pagination - OpenAPI Path: /po-hdr
              * @description Returns paginated purchase orders with comprehensive filtering by status, vendor, date ranges, and completion status. Essential for procurement management and receiving workflows.
              *
              * @fullPath api.orders.poHdr.list
@@ -304,7 +301,7 @@ export class OrdersClient extends BaseServiceClient {
              * @dataMethod listData - returns only the purchase orders array without metadata
              * @discoverable true
              * @searchTerms ["purchase orders", "PO list", "procurement", "vendor orders", "purchase order management", "receiving"]
-             * @relatedEndpoints ["api.orders.poHdr.get", "api.orders.poHdr.getDocument", "api.orders.poHdr.scan", "api.nexus.receiving.list"]
+             * @relatedEndpoints ["api.orders.poHdr.get", "api.orders.poHdr.doc.get", "api.orders.poHdr.scan.create", "api.nexus.receiving.list"]
              * @commonPatterns ["List open POs", "Find POs by vendor", "Track receiving status", "Procurement dashboard"]
              * @workflow ["procurement-workflow", "purchase-order-lifecycle", "receiving-management"]
              * @prerequisites ["Valid authentication", "Purchase order access permissions"]
@@ -312,37 +309,10 @@ export class OrdersClient extends BaseServiceClient {
              * @businessRules ["Filters by completion status", "Supports vendor and date filtering", "Pagination required for large datasets"]
              * @functionalArea "procurement-and-purchasing"
              * @performance "Use filtering to reduce result sets. Consider pagination for better performance."
-             *
-             * @param params Optional filtering and pagination parameters
-             * @param params.complete Filter by completion status ('Y' for complete, 'N' for incomplete)
-             * @param params.vendorId Filter by specific vendor ID
-             * @param params.dateFrom Filter POs created from this date (YYYY-MM-DD)
-             * @param params.dateTo Filter POs created to this date (YYYY-MM-DD)
-             * @param params.limit Maximum number of POs to return (default: 20, max: 100)
-             * @param params.offset Number of items to skip for pagination
-             * @returns Promise<BaseResponse<PurchaseOrder[]>> Complete response with purchase orders and metadata
-             *
-             * @example
-             * ```typescript
-             * // List incomplete purchase orders
-             * const response = await api.orders.poHdr.list({
-             *   complete: 'N',
-             *   limit: 50
-             * });
-             * console.log(`${response.total} open purchase orders`);
-             *
-             * // Get just the PO data
-             * const openPOs = await api.orders.poHdr.listData({
-             *   complete: 'N',
-             *   vendorId: 'VENDOR001'
-             * });
-             * ```
              */
             list: this.createListMethod('/po-hdr', PurchaseOrderListParamsSchema, PurchaseOrderListResponseSchema),
             /**
              * Get only purchase orders data without response metadata
-             * @description Data-only version of list() method - returns the purchase orders array directly
-             *
              * @param params Same parameters as list() method
              * @returns Promise<PurchaseOrder[]> Direct array of purchase orders
              */
@@ -351,7 +321,7 @@ export class OrdersClient extends BaseServiceClient {
                 return response.data;
             },
             /**
-             * Get detailed purchase order information
+             * Get detailed purchase order information - OpenAPI Path: /po-hdr/{poNo}
              * @description Returns comprehensive purchase order details including header information, vendor details, status, and summary totals. Used for PO management and tracking.
              *
              * @fullPath api.orders.poHdr.get
@@ -360,33 +330,18 @@ export class OrdersClient extends BaseServiceClient {
              * @dataMethod getData - returns only the purchase order detail without metadata
              * @discoverable true
              * @searchTerms ["purchase order details", "PO details", "purchase order info", "PO header"]
-             * @relatedEndpoints ["api.orders.poHdr.list", "api.orders.poHdr.getDocument", "api.nexus.receiving.list"]
+             * @relatedEndpoints ["api.orders.poHdr.list", "api.orders.poHdr.doc.get", "api.nexus.receiving.list"]
              * @commonPatterns ["Get PO details", "View purchase order", "PO status check", "Vendor order info"]
              * @workflow ["purchase-order-review", "receiving-preparation", "vendor-management"]
              * @prerequisites ["Valid purchase order number", "PO access permissions"]
-             * @nextSteps ["api.orders.poHdr.getDocument for full details", "Create receiving record", "Update PO status"]
+             * @nextSteps ["api.orders.poHdr.doc.get for full details", "Create receiving record", "Update PO status"]
              * @businessRules ["Returns header-level information only", "Access controlled by permissions", "Status reflects current receiving state"]
              * @functionalArea "procurement-and-purchasing"
              * @performance "Single PO retrieval - efficient for header information"
-             *
-             * @param id Purchase order number to retrieve
-             * @returns Promise<BaseResponse<PurchaseOrderDetail>> Complete response with PO details
-             *
-             * @example
-             * ```typescript
-             * // Get PO details
-             * const response = await api.orders.poHdr.get(12345);
-             * console.log(`PO ${response.data.poNo} - Status: ${response.data.status}`);
-             *
-             * // Get just the PO data
-             * const poDetail = await api.orders.poHdr.getData(12345);
-             * ```
              */
             get: this.createGetMethod('/po-hdr/{poNo}', PurchaseOrderDetailResponseSchema),
             /**
              * Get only purchase order detail data without response metadata
-             * @description Data-only version of get() method - returns the purchase order detail directly
-             *
              * @param id Purchase order number to retrieve
              * @returns Promise<PurchaseOrderDetail> Direct purchase order detail object
              */
@@ -395,206 +350,86 @@ export class OrdersClient extends BaseServiceClient {
                 return response.data;
             },
             /**
-             * Get complete purchase order document with all related information
-             * @description Returns comprehensive purchase order document including header, line items, vendor information, shipping details, and totals. Complete document for receiving and fulfillment processes.
-             *
-             * @fullPath api.orders.poHdr.getDocument
-             * @service orders
-             * @domain procurement-management
-             * @dataMethod getDocumentData - returns only the purchase order document without metadata
-             * @discoverable true
-             * @searchTerms ["purchase order document", "complete PO", "PO with lines", "full purchase order", "PO document"]
-             * @relatedEndpoints ["api.orders.poHdr.get", "api.orders.poHdr.list", "api.nexus.receiving.create"]
-             * @commonPatterns ["Complete PO details", "PO for receiving", "Full purchase order", "PO with line items"]
-             * @workflow ["purchase-order-fulfillment", "receiving-workflow", "vendor-management"]
-             * @prerequisites ["Valid purchase order number", "Document access permissions"]
-             * @nextSteps ["Process receiving", "Create receiving records", "Update line item status"]
-             * @businessRules ["Includes all line items and quantities", "Shows receiving status per line", "Contains vendor and shipping details"]
-             * @functionalArea "procurement-and-purchasing"
-             * @performance "Complete document retrieval - includes all related data in single call"
-             *
-             * @param poNo Purchase order number to retrieve
-             * @returns Promise<BaseResponse<PurchaseOrderDocument>> Complete response with full PO document
-             *
-             * @example
-             * ```typescript
-             * // Get complete PO document
-             * const response = await api.orders.poHdr.getDocument(12345);
-             * console.log(`PO ${response.data.poNo} has ${response.data.lines.length} line items`);
-             *
-             * // Get just the document data
-             * const poDoc = await api.orders.poHdr.getDocumentData(12345);
-             * poDoc.lines.forEach(line => {
-             *   console.log(`${line.itemId}: ${line.qtyOrdered} (${line.qtyReceived} received)`);
-             * });
-             * ```
+             * Purchase order document operations - OpenAPI Path: /po-hdr/{poNo}/doc
              */
-            getDocument: async (poNo) => {
-                return this.executeRequest({
-                    method: 'GET',
-                    path: `/po-hdr/${poNo}/doc`,
-                    responseSchema: PurchaseOrderDocumentResponseSchema,
-                }, {});
+            doc: {
+                /**
+                 * Get complete purchase order document with all related information
+                 * @description Returns comprehensive purchase order document including header, line items, vendor information, shipping details, and totals. Complete document for receiving and fulfillment processes.
+                 *
+                 * @fullPath api.orders.poHdr.doc.get
+                 * @service orders
+                 * @domain procurement-management
+                 * @dataMethod getData - returns only the purchase order document without metadata
+                 * @discoverable true
+                 * @searchTerms ["purchase order document", "complete PO", "PO with lines", "full purchase order", "PO document"]
+                 * @relatedEndpoints ["api.orders.poHdr.get", "api.orders.poHdr.list", "api.nexus.receiving.create"]
+                 * @commonPatterns ["Complete PO details", "PO for receiving", "Full purchase order", "PO with line items"]
+                 * @workflow ["purchase-order-fulfillment", "receiving-workflow", "vendor-management"]
+                 * @prerequisites ["Valid purchase order number", "Document access permissions"]
+                 * @nextSteps ["Process receiving", "Create receiving records", "Update line item status"]
+                 * @businessRules ["Includes all line items and quantities", "Shows receiving status per line", "Contains vendor and shipping details"]
+                 * @functionalArea "procurement-and-purchasing"
+                 * @performance "Complete document retrieval - includes all related data in single call"
+                 */
+                get: async (poNo) => {
+                    return this.executeRequest({
+                        method: 'GET',
+                        path: `/po-hdr/${poNo}/doc`,
+                        responseSchema: PurchaseOrderDocumentResponseSchema,
+                    }, {});
+                },
+                /**
+                 * Get only purchase order document data without response metadata
+                 * @param poNo Purchase order number to retrieve
+                 * @returns Promise<PurchaseOrderDocument> Direct purchase order document object
+                 */
+                getData: async (poNo) => {
+                    const response = await this.poHdr.doc.get(poNo);
+                    return response.data;
+                },
             },
             /**
-             * Get only purchase order document data without response metadata
-             * @description Data-only version of getDocument() method - returns the purchase order document directly
-             *
-             * @param poNo Purchase order number to retrieve
-             * @returns Promise<PurchaseOrderDocument> Direct purchase order document object
+             * Purchase order scan operations - OpenAPI Path: /po-hdr/scan
              */
-            getDocumentData: async (poNo) => {
-                const response = await this.poHdr.getDocument(poNo);
-                return response.data;
-            },
-            /**
-             * Scan for similar purchase orders based on provided criteria
-             * @description Intelligent purchase order discovery that finds similar POs based on items, vendors, or other criteria. Useful for reordering, vendor analysis, and procurement optimization.
-             *
-             * @fullPath api.orders.poHdr.scan
-             * @service orders
-             * @domain procurement-management
-             * @dataMethod scanData - returns only the scan results without metadata
-             * @discoverable true
-             * @searchTerms ["PO scan", "similar purchase orders", "find similar POs", "PO search", "procurement patterns"]
-             * @relatedEndpoints ["api.orders.poHdr.list", "api.orders.poHdr.getDocument", "api.items.products.list"]
-             * @commonPatterns ["Find similar orders", "Reorder analysis", "Vendor pattern analysis", "Procurement optimization"]
-             * @workflow ["procurement-optimization", "reorder-analysis", "vendor-comparison"]
-             * @prerequisites ["Scan criteria parameters", "PO access permissions"]
-             * @nextSteps ["Analyze results for reordering", "Compare vendor patterns", "Optimize procurement"]
-             * @businessRules ["Matches based on provided criteria", "Returns similarity scores", "Filters by date ranges and status"]
-             * @functionalArea "procurement-and-purchasing"
-             * @performance "Advanced search operation - may take longer for complex criteria"
-             *
-             * @param params Scan criteria and parameters
-             * @param params.itemIds Array of item IDs to match against
-             * @param params.vendorId Vendor ID to focus scan on
-             * @param params.dateFrom Start date for scan range
-             * @param params.dateTo End date for scan range
-             * @param params.similarityThreshold Minimum similarity score (0-100)
-             * @returns Promise<BaseResponse<PurchaseOrderScanResult[]>> Complete response with matching POs and similarity scores
-             *
-             * @example
-             * ```typescript
-             * // Scan for similar POs by items
-             * const response = await api.orders.poHdr.scan({
-             *   itemIds: ['ITEM001', 'ITEM002'],
-             *   similarityThreshold: 70
-             * });
-             *
-             * // Get just the scan results
-             * const similarPOs = await api.orders.poHdr.scanData({
-             *   vendorId: 'VENDOR001',
-             *   dateFrom: '2024-01-01'
-             * });
-             * ```
-             */
-            scan: this.createCreateMethod('/po-hdr/scan', PurchaseOrderScanParamsSchema, PurchaseOrderScanResponseSchema),
-            /**
-             * Get only purchase order scan results data without response metadata
-             * @description Data-only version of scan() method - returns the scan results directly
-             *
-             * @param params Same parameters as scan() method
-             * @returns Promise<PurchaseOrderScanResult[]> Direct array of scan results
-             */
-            scanData: async (params) => {
-                const response = await this.poHdr.scan(params || {});
-                return response.data;
+            scan: {
+                /**
+                 * Scan for similar purchase orders based on provided criteria
+                 * @description Intelligent purchase order discovery that finds similar POs based on items, vendors, or other criteria. Useful for reordering, vendor analysis, and procurement optimization.
+                 *
+                 * @fullPath api.orders.poHdr.scan.create
+                 * @service orders
+                 * @domain procurement-management
+                 * @dataMethod createData - returns only the scan results without metadata
+                 * @discoverable true
+                 * @searchTerms ["PO scan", "similar purchase orders", "find similar POs", "PO search", "procurement patterns"]
+                 * @relatedEndpoints ["api.orders.poHdr.list", "api.orders.poHdr.doc.get", "api.items.products.list"]
+                 * @commonPatterns ["Find similar orders", "Reorder analysis", "Vendor pattern analysis", "Procurement optimization"]
+                 * @workflow ["procurement-optimization", "reorder-analysis", "vendor-comparison"]
+                 * @prerequisites ["Scan criteria parameters", "PO access permissions"]
+                 * @nextSteps ["Analyze results for reordering", "Compare vendor patterns", "Optimize procurement"]
+                 * @businessRules ["Matches based on provided criteria", "Returns similarity scores", "Filters by date ranges and status"]
+                 * @functionalArea "procurement-and-purchasing"
+                 * @performance "Advanced search operation - may take longer for complex criteria"
+                 */
+                create: this.createCreateMethod('/po-hdr/scan', PurchaseOrderScanParamsSchema, PurchaseOrderScanResponseSchema),
+                /**
+                 * Get only purchase order scan results data without response metadata
+                 * @param params Same parameters as create() method
+                 * @returns Promise<PurchaseOrderScanResult[]> Direct array of scan results
+                 */
+                createData: async (params) => {
+                    const response = await this.poHdr.scan.create(params || {});
+                    return response.data;
+                },
             },
         };
         /**
-         * Invoice Management Operations
-         * @description Invoice processing and document management with Prophet 21 integration for billing and accounting workflows
+         * Legacy method support for backward compatibility
+         * @deprecated Use the new OpenAPI path mirroring structure instead
          */
-        this.invoiceHdr = {
-            /**
-             * Reprint an existing invoice through Prophet 21 integration
-             * @description Generates a reprint of an existing invoice through Prophet 21 system integration. Returns invoice document data and reprint status for billing and customer service workflows.
-             *
-             * @fullPath api.orders.invoiceHdr.reprint
-             * @service orders
-             * @domain invoice-management
-             * @dataMethod reprintData - returns only the reprint result without metadata
-             * @discoverable true
-             * @searchTerms ["invoice reprint", "reprint invoice", "invoice copy", "duplicate invoice", "invoice document"]
-             * @relatedEndpoints ["api.orders.oeHdr.getDocument", "api.customers.customer.get", "api.p21-core.company.get"]
-             * @commonPatterns ["Reprint invoice", "Customer invoice copy", "Billing document", "Invoice duplicate"]
-             * @workflow ["invoice-management", "customer-service", "billing-workflow"]
-             * @prerequisites ["Valid invoice number", "Invoice exists in Prophet 21", "Reprint permissions"]
-             * @nextSteps ["Deliver invoice to customer", "Update billing records", "Customer service follow-up"]
-             * @businessRules ["Invoice must exist in Prophet 21", "Reprint creates audit trail", "Formatting matches original invoice"]
-             * @functionalArea "billing-and-invoicing"
-             * @performance "Integrates with Prophet 21 - response time depends on P21 system load"
-             *
-             * @param invoiceNo Invoice number to reprint (string format)
-             * @returns Promise<BaseResponse<InvoiceReprintResult>> Complete response with reprint status and document data
-             *
-             * @example
-             * ```typescript
-             * // Reprint an invoice
-             * const response = await api.orders.invoiceHdr.reprint('INV-12345');
-             * console.log(`Invoice reprint status: ${response.data.status}`);
-             *
-             * // Get just the reprint data
-             * const reprintResult = await api.orders.invoiceHdr.reprintData('INV-12345');
-             * if (reprintResult.success) {
-             *   console.log(`Reprint generated: ${reprintResult.documentUrl}`);
-             * }
-             * ```
-             */
-            reprint: async (invoiceNo) => {
-                return this.executeRequest({
-                    method: 'GET',
-                    path: `/invoice-hdr/${invoiceNo}/reprint`,
-                    responseSchema: InvoiceReprintApiResponseSchema,
-                }, {});
-            },
-            /**
-             * Get only invoice reprint data without response metadata
-             * @description Data-only version of reprint() method - returns the reprint result directly
-             *
-             * @param invoiceNo Invoice number to reprint
-             * @returns Promise<InvoiceReprintResult> Direct reprint result object
-             */
-            reprintData: async (invoiceNo) => {
-                const response = await this.invoiceHdr.reprint(invoiceNo);
-                return response.data;
-            },
-        };
-        /**
-         * Health check endpoint
-         * @description Service health and status monitoring endpoint for system diagnostics and uptime verification
-         *
-         * @fullPath api.orders.getHealthCheck
-         * @service orders
-         * @domain system-monitoring
-         * @dataMethod getHealthCheckData - returns only the health check data without metadata
-         * @discoverable true
-         * @searchTerms ["health check", "service status", "orders health", "system status"]
-         * @relatedEndpoints ["api.joomla.getHealthCheck", "api.nexus.getHealthCheck", "api.items.getHealthCheck"]
-         * @commonPatterns ["Check service health", "System monitoring", "Service status"]
-         * @workflow ["system-monitoring", "health-diagnostics"]
-         * @functionalArea "system-operations"
-         * @performance "Lightweight endpoint for monitoring - minimal response time"
-         */
-        this.getHealthCheck = this.createHealthCheckMethod(HealthCheckResponseSchema);
-        /**
-         * Get only health check data without response metadata
-         * @description Data-only version of getHealthCheck() method - returns the health check data directly
-         *
-         * @returns Promise<HealthCheckData> Direct health check data object
-         *
-         * @example
-         * ```typescript
-         * // Get just the health check data
-         * const healthData = await api.orders.getHealthCheckData();
-         * console.log(`Site: ${healthData.siteId} - Hash: ${healthData.siteHash}`);
-         * ```
-         */
-        this.getHealthCheckData = async () => {
-            const response = await this.getHealthCheck();
-            return response.data;
-        };
+        this.getHealthCheck = this.healthCheck.get;
+        this.getHealthCheckData = this.healthCheck.getData;
     }
 }
 //# sourceMappingURL=client.js.map