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 (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 (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.
{"invoiceId": "VI-KARANDEVENV-000000493","message": "Invoice Posted Successfully.","success": true}