Skip to content
Longport WhaleLongport Whale
Payment Transaction

Trigger Bilateral Bookkeeping

Re-trigger bilateral payment transaction matching for a given date range.

Request parameters

  • Required: start_date (start date, YYYYMMDD), end_date (end date, YYYYMMDD), and scenes (rerun scene, fixed value bookkeeping_bilateral).
  • Optional: manual (manual-trigger flag) and audit_frontend_resource (caller audit context).
  • See the individual field docs for each field's format, allowed values, and meaning.

Business notes

Recomputes the existing bilateral payment matching results for the given date range. scenes is fixed to bookkeeping_bilateral.

Risk warning

This operation regenerates the matching results for the date range and affects reconciliation data. Verify the date range before calling.

Result

On success, the re-matching is triggered; see the 200 response for the returned content.

POSThttps://b-api.lbkrs.com/book/bilateral/trigger

Authorization

AuthorizationstringheaderRequired

Send the Broker ACCESS_TOKEN as Authorization: Bearer <token>.

Permission

accounting.bilateralaccounting.member_fee_billsbook.book_atomic_vaults_statement_operationbook.book_contract_bills_operation

The Broker ACCESS_TOKEN must be granted the permission above, or the call will be rejected.

Request body application/json

start_datestringrequired

Date in YYYYMMDD format.

end_datestringrequired

Format YYYYMMDD; the selected date plus 1 day.

scenesstringrequired

Always set to bookkeeping_bilateral.

manualboolean

Always set to true.

audit_frontend_resourceobject

Used in backend audit logs. In this context it includes bookkeeping_bilateral_date, the selected date in YYYY-MM-DD format.

Responses

HTTP 200The request was processed successfully. The response data does not contain additional business fields.
Standard response envelopecodemessagedata
dataobjectdata structure
idstring
idsarray<string>
HTTP 400Bad request. Check the business error code in code and the error details in message.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

HTTP 401The user is not authenticated, or the login session has expired.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

HTTP 403The current account is not authorized to use this feature. Grant the required permission to the account in User Permission.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

HTTP 408The request timed out. Check the business error code in code and the error details in message.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

Whale Docs