Skip to main content

Get Pending Summary Invoicing for Customer API

Introduction​

Returns pending summary Invoicing rows for a single customer via InvoiceService.getPendingSummaryInvoicingForCustomer(customerId, tenantId), as JSON {"data":[...]}. Used by summary invoice screens (for example viewSummaryInvoice.xhtml) to load bookings eligible for summary billing.

Source: InvoiceHomePageAPI.getPendingSummaryInvoicingForCustomer (@Path("invoicehome")).

See also: Invoice Home — all endpoints.


HTTP Endpoint​

PropertyValue
URL/rest/invoicehome/getPendingSummaryInvoicingForCustomer/{customerId}/{officeBranch}/{userName}/{authKey}
MethodGET
Producesapplication/json

Path Parameters​

ParameterTypeRequiredDescription
customerIdStringYesCustomer whose pending summary lines are loaded.
officeBranchStringYesRequired in the URL (e.g. default). The Java method does not declare @PathParam("officeBranch"); ensure your JAX-RS runtime matches the template (clients must still supply this segment).
userNameStringYesAuth username.
authKeyStringYesAuth key.

Authentication​

ConditionHTTP status
Invalid credentials401 Unauthorized (Access-Control-Allow-Origin: *)
Success200 OK

Behaviour​

After auth, loads the list with getPendingSummaryInvoicingForCustomer, serialises with Gson into a JSONArray, wraps in {"data": ...}.


Success Response​

Code: 200 OK

Content-Type: application/json

Body:

{
"data": [
{
"id": 1,
"bookingId": "...",
"customerId": "...",
"invoiceType": "SUMMARY",
"status": "PENDING",
"...": "Invoicing entity fields"
}
]
}

Headers: Access-Control-Allow-Origin: *


Example Request​

GET /rest/invoicehome/getPendingSummaryInvoicingForCustomer/CUST01/default/alice/secretKey HTTP/1.1
Host: {base}