Skip to main content

Get Cash Invoice Bookings API

Introduction​

Returns Invoicing rows for cash / generated booking flows using InvoiceService.getCashInvoicingListWithDateFilter with status TmsConstants.GENERATED, optional customer (customerId literal null = all), and date range. Results are sorted by invoice date descending (same comparator pattern as pending bookings).

Source: InvoiceHomePageAPI.getCashInvoiceBookings — transportsupplyproject/src/in/greenorange/api/invoice/InvoiceHomePageAPI.java.

See also: Invoice Home — all endpoints.


Path shape note​

The URL includes {invoiceType} and {officeBranch}, but the Java method does not declare @PathParam for them and the service call does not pass invoiceType — only GENERATED status is used. Clients should still supply path segments (e.g. placeholder values) so the path matches the template.


HTTP Endpoint​

PropertyValue
URL/rest/invoicehome/getCashInvoiceBookings/{invoiceType}/{customerId}/{fromDate}/{toDate}/{officeBranch}/{userName}/{authKey}
MethodGET
Producesapplication/json

Path Parameters (contract)​

ParameterTypeRequiredDescription
invoiceTypeStringYesPresent in URL; not applied in current handler logic.
customerIdStringYesUse literal null for no customer filter.
fromDate / toDateStringYesyyyy-MM-dd.
officeBranchStringYesURL placeholder (e.g. default); not bound in method.
userName / authKeyStringYesAuth.

Success Response​

{ "data": [ { "...": "Invoicing" } ] }

Example Request​

GET /rest/invoicehome/getCashInvoiceBookings/CASH/null/2026-04-01/2026-04-30/default/alice/secretKey HTTP/1.1
Host: {base}