Fetch PO Details

### Fetch Purchase Order Details This endpoint retrieves the details of a specific purchase order (PO) using the provided `orderId`. The request is made via an HTTP GET method. #### Request Parameters - **orderId** (string, required): The unique identifier for the purchase order you wish to fetch. For example, `PO-INDIAN-00407`. #### Response On a successful request, the server responds with a status code of **200** and a JSON object containing the following key details: - **remarks** (string): Any remarks associated with the PO. - **warnings** (array): A list of warnings related to the PO, if any. - **grns** (array): An array of Goods Receipt Notes (GRNs) associated with the PO, each containing: - **id** (integer): Unique identifier for the GRN. - **status** (string): Current status of the GRN. - **grnId** (string): ID of the GRN. - **invoiceId** (string): Associated invoice ID. - **invoiceAmount** (number): Amount on the invoice. - **currency** (string): Currency type. - **partial** (boolean): Indicates if the GRN is partial. - **date** (integer): Date of the GRN. - **createdAt** (integer): Timestamp when the GRN was created. - **amend** (boolean): Indicates if the GRN has been amended. - **attrs** (object): Contains various attributes related to the PO, such as owner details, currency amount, and address. - **orderId** (string): The unique order ID. - **title** (string): Title of the PO. - **currency** (string): Currency used in the PO. - **shipTo** (object): Shipping details including tags. - **billingTo** (object): Billing details including name, registered name, address, and GSTIN. - **vendor** (object): Information about the vendor, including ID, name, GSTIN, and address. - **payments** (array): Payment details associated with the PO. - **publicComments** (array): Any public comments related to the PO. - **procured** (array): Details of procured items, including quantity, price, and status. - **invoices** (array): List of invoices related to the PO. #### Example Response ``` json { "remarks": "", "warnings": [], "grns": [ { "id": 19612, "status": "COMPLETED", "grnId": "GRN-INDIAN-00307", "invoiceId": "VI-INDIAN-000001723", "invoiceAmount": 1500.0, "currency": "INR", "partial": false, "date": 1704133800000, "createdAt": 1704176202179, "amend": false } ], "attrs": { "ownerType": "EMPLOYEE", "admin.id": "118", "amount": "1500", "currency_amount": "1500", "address": "1347", "admin.name": "Admin", "test": "dfgh", "document": "https://static.eka.io/v2/INDIAN/orders/PO-INDIAN-00407.pdf", "admin": "karanshrm44@gmail.com", "office": "1347", "ownerId": "0001", "last_approver_email": "testuser3@antrepriz.com", "workflow.current": "1704176158871", "budgeted": "yes", "last_approver_name": "karanss kumar", "last_approver_time": "1704176158836", "grn.start": "1704176158873", "po_released": "1704176158875", "fds": "2024-01-02", "stage": "Grn", "service": "karan", "admin.email": "karanshrm44@gmail.com", "last_approver_code": "0001", "workflow.start": "1704176158861" }, "orderId": "PO-INDIAN-00407", "title": "fghb", "currency": "INR", "shipTo": { "tags": {} }, "billingTo": { "name": "Pune_", "registered_name": "", "address": "", "gstin": "27AAZCS7239P1Z1", "country": "India", "city": "Pune", "entityName": "GRNY", "entityRegisterName": "", "tags": { "one": "two", "sample test 11": "value" } }, "vendorConditions": "rgfs", "category": { "id": 129, "name": "karan" }, "conditions": [], "payments": [], "paymentData": { "advancePaymentTerms": [], "paymentTerms": [], "alertUsers": [] }, "currencyAmount": 1500.0, "grossAmount": 1500.0, "details": { "raisedBy": { "id": 17253, "ownerType": "EMPLOYEE", "ownerId": "0001", "ownerName": "karanss kumar" }, "createdAt": 1704176082890, "updatedAt": 1724765235699, "addressName": "Pune_", "addressId": 1347, "officeName": "Pune_", "officeGstin": "27AAZCS7239P1Z1", "officeAddress": "", "officeCity": "Pune", "officeId": 1347 }, "grnOwner": { "ownerName": "Karan k", "ownerId": "0001", "ownerType": "EMPLOYEE", "officeTags": {}, "customFields": {} }, "submission": false, "completed": false, "status": "INVOICE", "stage": "Grn", "recurringId": 0, "poDocument": "https://static.eka.io/v2/INDIAN/orders/PO-INDIAN-00407.pdf", "additionalEmail": "", "vendor": { "id": 287032, "vendorId": "CONTACT-INDIAN-0000063", "name": "BAKKIREDDY SRINIVASULU REDDY", "gstin": "27AAACI1195H5ZI", "email": "sriniivastest@yopmail.com", "mobile": "7993435403", "pan": " AFQPA7358J", "address": { "id": "10abef6c-a743-4616-b6a0-fc4fe2bbeb49", "title": "PUNE", "address": "PUNE", "city": "Satara", "state": "Maharashtra", "country": "INDIA", "pincode": "415011", "gstin": "27AAACI1195H5ZI", "gstinValid": true, "businessAddress": false, "attrs": {}, "forms": [], "locationId": "", "filterKey": "", "bankIds": [] }, "currency": "INR" }, "publicComments": [], "procured": [ { "id": 131886, "qtty": 10.0, "price": 150.0, "tax": 0.0, "taxSlab": 0.0, "base": 1500.0, "amount": 1500.0, "status": "TAGGED", "approved": 10.0, "invoicedQty": 0.0, "asnQty": 0.0, "blocked": false, "allowBlockedItemSubmission": false, "amends": 0.0, "name": "Macbook", "productCode": "PRODUCT-INDIAN-0000004", "vendor": "BAKKIREDDY SRINIVASULU REDDY", "vendorId": 287032, "createdAt": 1704176045017, "updatedAt": 1704200184788, "image": "", "officeId": 1347, "officeName": "Pune_", "officeAddress": "", "officeRegisteredName": "", "officeGstin": "27AAZCS7239P1Z1", "officePin": "411045", "officeCity": "Pune", "purchaseId": "RFQ-INDIAN-00325", "purchase": 23813, "serviceName": "karan", "poId": "PO-INDIAN-00407", "po": 42912, "owner": { "id": 17253, "ownerType": "EMPLOYEE", "ownerId": "0001", "ownerName": "karanss kumar" }, "hsn": "hiosp", "productId": 37468, "sku": "IO", "unit": "kg", "deliveryDate": 1706767782933, "notes": "fwdsa", "specs": "", "description": "Macbook", "quoteId": 79678, "grnQty": 10.0, "grnNos": [ "GRN-INDIAN-00307" ], "productAttrs": { "po_generated": "YES", "toggle": "yes" }, "shortClosure": false, "shortClosureQtty": 0.0, "attrs": { "notes": "fwdsa" }, "quotationId": "fsda", "skipFar": false } ], "invoices": [ { "service": "karan", "category": "karan", "owner": { "id": 17253, "ownerType": "EMPLOYEE", "ownerId": "0001", "ownerName": "karanss kumar" }, "createdAt": 1704176278166, "file": "https://static.eka.io/v2/INDIAN/receipts/2024/01/3282f964-7fce-457b-87d5-14a748078340.png", "status": "DECLINED", "id": 439857, "invoiceId": "VI-INDIAN-000001704", "stage": "approver", "duplicate": false, "integration": { "done": false }, "currencyAmount": 1500.0, "currency": "INR", "billNumber": "KL23990Z" }, { "service": "karan", "category": "karan", "owner": { "id": 17253, "ownerType": "EMPLOYEE", "ownerId": "0001", "ownerName": "karanss kumar" }, "createdAt": 1704178300775, "file": "https://static.eka.io/v2/INDIAN/receipts/2024/01/fc43148d-ad2c-4dc1-b16f-178830d6ebf6.png", "status": "DECLINED", "id": 439923, "invoiceId": "VI-INDIAN-000001711", "stage": "test", "duplicate": false, "integration": { "done": false }, "currencyAmount": 1500.0, "currency": "INR", "billNumber": "KL23990Z" }, { "service": "karan", "category": "karan", "owner": { "id": 287032, "ownerType": "CONTACT", "ownerId": "287032", "ownerName": "BAKKIREDDY SRINIVASULU REDDY" }, "createdAt": 1704178527831, "file": "https://static.eka.io/v2/receipts/2024/01/a9f0a711-976a-43d0-99f5-b14816d0f529.png", "status": "DECLINED", "id": 439931, "invoiceId": "VI-INDIAN-000001712", "stage": "xd", "duplicate": false, "integration": { "done": false }, "currencyAmount": 1500.0, "currency": "INR", "billNumber": "KL23990Z" }, { "service": "karan", "category": "karan", "owner": { "id": 17253, "ownerType": "EMPLOYEE", "ownerId": "0001", "ownerName": "karanss kumar" }, "createdAt": 1704200006728, "status": "DECLINED", "id": 440467, "invoiceId": "VI-INDIAN-000001723", "stage": "test", "duplicate": false, "integration": { "done": false }, "currencyAmount": 1500.0, "currency": "INR", "billNumber": "dsds" } ], "logs": [], "conditionalPos": {}, "budgeted": true, "asnRequired": false, "budgetIds": [], "budgetCheckExecuted": false } ``` #### Notes - Ensure that the `orderId` is valid to receive accurate details. - The response may contain multiple GRNs, invoices, and procured items, which provide comprehensive information about the purchase order. This endpoint retrieves the details of a specific purchase order (PO) using the provided `orderId`. The request is made via an HTTP GET method. #### Request Parameters - **orderId** (string, required): The unique identifier for the purchase order you wish to fetch. For example, `PO-INDIAN-00407`. #### Response On a successful request, the server responds with a status code of **200** and a JSON object containing the following key details: - **remarks** (string): Any remarks associated with the PO. - **warnings** (array): A list of warnings related to the PO, if any. - **grns** (array): An array of Goods Receipt Notes (GRNs) associated with the PO, each containing: - **id** (integer): Unique identifier for the GRN. - **status** (string): Current status of the GRN. - **grnId** (string): ID of the GRN. - **invoiceId** (string): Associated invoice ID. - **invoiceAmount** (number): Amount on the invoice. - **currency** (string): Currency type. - **partial** (boolean): Indicates if the GRN is partial. - **date** (integer): Date of the GRN. - **createdAt** (integer): Timestamp when the GRN was created. - **amend** (boolean): Indicates if the GRN has been amended. - **attrs** (object): Contains various attributes related to the PO, such as owner details, currency amount, and address. - **orderId** (string): The unique order ID. - **title** (string): Title of the PO. - **currency** (string): Currency used in the PO. - **shipTo** (object): Shipping details including tags. - **billingTo** (object): Billing details including name, registered name, address, and GSTIN. - **vendor** (object): Information about the vendor, including ID, name, GSTIN, and address. - **payments** (array): Payment details associated with the PO. - **publicComments** (array): Any public comments related to the PO. - **procured** (array): Details of procured items, including quantity, price, and status. - **invoices** (array): List of invoices related to the PO. #### Notes - Ensure that the `orderId` is valid to receive accurate details. - The response may contain multiple GRNs, invoices, and procured items, which provide comprehensive information about the purchase order.