Create PO Invoice

View as Markdown
### Request Body The request should include the following parameters in the raw request body: | Param | Required | Type | Description | | --- | --- | --- | --- | | po_no | Mandatory | String | Purchase order number | | grn_no | Optional | String | (Goods Receipt Note number), a unique identifier for the GRN, though it is not marked as required in this context. | | request | Mandatory | Object | Contains details of the purchase request | | request.vendor | Mandatory | Object | Vendor details | | request.vendor.code | Mandatory | String | Unique code for the vendor | | request.vendor.id | optional | Long | Vendor identification number(vendor id is mandatory if code is not present) | | request.vendor.name | Mandatory | String | Name of the vendor | | request.vendorInvoiceNumber | Mandatory | String | Invoice number provided by the vendor | | request.billDate | Mandatory | Long | Date of the bill in Unix timestamp format | | request.category | Mandatory | Object | Category information | | request.category.id | optional | Long | Category identification number (Category id is mandatory if label is not present) | | request.category.label | Mandatory | String | Label of the category | | request.billTo | Mandatory | Object | Billing details | | request.billTo.name | Mandatory | String | Name of the entity to be billed | | request.billTo.id | optional | Long | Billing entity identification number <br>(bill to id is mandatory if name is not present) | | request.shipTo | Mandatory | Object | Shipping details | | request.shipTo.name | Mandatory | String | Name of the entity to receive the shipment | | request.shipTo.id | optional | Long | Shipping entity identification number <br>(ship to id is mandatory if name is not present) | | request.roundOffAmount | optional | Double | Amount rounded off | | request.items | Mandatory | Object | List of items included in the request | | request.items\[\].base | Mandatory | Double | Base price of the item | | request.items\[\].product | Mandatory | Object | Product details | | request.items\[\].product.code | Mandatory | String | Unique code for the product | | request.items\[\].product.id | Optional | Long | Product identification number(product id is mandatory if code is not present) | | request.items\[\].product.itemReferenceNo | Mandatory | String | Reference number for the product | | request.items\[\].qtty | Mandatory | Double | Quantity of the product | | request.items\[\].notes | Optional | String | Additional notes about the item | | request.items\[\].taxSlab | Optional | Double | Tax percentage applicable to the item | | request.items\[\].service | Mandatory | Object | Service details related to the item | | request.items\[\].service.label | Mandatory | String | Label of the service | | request.items\[\].service.value | Mandatory | Long | Cost of the service | | request.items\[\].tax | Mandatory | Double | Total tax amount for the item (tax is Mandatory if taxslab is present) | Upon successful execution, the API will return a status code of 200 and a JSON response with a `success` key indicating whether the invoice submission was successful. ### Example Response ``` json { "invoiceId": "VI-KARANDEVENV-000000493", "message": "Invoice Posted Successfully.", "success": true } ```

Headers

DICE-APP-IDstringOptional
X-CLIENT-IDstringOptional
X-CLIENT-SECRETstringOptional

Request

This endpoint expects an object.
po_nostringRequired
requestobjectRequired

Response headers

request-idstringOptional

Response

OK
invoiceIdstring
messagestring
successboolean