Skip to main content

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)​

FieldTypeRequiredDescription
userNameStringYesAuth + generatedBy.
authKeyStringYesAuth.
acknowledgementListArrayYesList<Acknowledgment> (line items).
acknowledgementDetailsObjectYesHeader 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", "...": "..." }
]
}