Save Acknowledgement API
Introduction
Persists acknowledgement data after preview: accepts acknowledgementDetails (single Acknowledgment) and acknowledgementList (array of Acknowledgment line rows from the UI). Sets generatedBy from userName, regenerates the main acknowledgement number with generateAcknowledgementNumber, and calls acknowledgementService.saveAcknowledgement(acknowledgementList, null, false, tenantId) with a list containing the details row.
On success: for each item in acknowledgementList, loads InvoiceOriginal rows by invoice number, sets generatedAcknowledgementOrPostlajuNo to the new acknowledgement number, status to TmsConstants.CLOSED, and updateInvoiceOriginal. Activity log records generated acknowledgement.
Source: InvoiceHomePageAPI.saveAcknowledgement — transportsupplyproject/src/in/greenorange/api/invoice/InvoiceHomePageAPI.java.
See also: generate acknowledgement, Invoice Home — all endpoints.
HTTP Endpoint
| URL | /rest/invoicehome/saveAcknowledgement |
| Method | POST |
Request Body (JSON)
| Field | Type | Required | Description |
|---|---|---|---|
userName | String | Yes | Auth + generatedBy. |
authKey | String | Yes | Auth. |
acknowledgementList | Array | Yes | List<Acknowledgment> (line items). |
acknowledgementDetails | Object | Yes | Header Acknowledgment (number regenerated server-side). |
Response
{"saved":true}
or false if saveAcknowledgement returns false.
Headers: Access-Control-Allow-Origin: * on Response.ok().
Example (illustrative)
{
"userName": "alice",
"authKey": "k",
"acknowledgementDetails": { "customerId": "C1", "...": "..." },
"acknowledgementList": [
{ "invoiceNumber": "INV-1", "...": "..." }
]
}