Add Disbursement Batch Entry

Overview

Adds a new disbursement entry to an existing batch. The batch must be in Draft status. Use this command to incrementally build up a batch after initial creation.

Command Details

• Command: AddDisbursementBatchEntryCommand
• Type: Command (write operation)
• Batch status requirement: Draft
• Permissions required: Disbursement Create

API Endpoint

POST /api/bpm/cmd

Request Structure

Field	Type	Required	Description
batchId	long	Yes	ID of the batch
bankCode	string	Yes	Bank code
destinationAccount	string	Yes	Destination account number
amount	decimal	Yes	Amount
narration	string	No	Narration

Try It Out

POST/api/bpm/cmdAddDisbursementBatchEntryCommand

Base URL

Bearer Token

Request Body

{ "cmd": "AddDisbursementBatchEntryCommand", "data": { "batchId": 1024, "bankCode": "058", "destinationAccount": "0098765432", "amount": 75000, "narration": "Contractor payment - March 2026" } }

Response Structure

{
  "success": true,
  "data": {
    "entryId": 3087,
    "batchId": 1024,
    "bankCode": "058",
    "destinationAccount": "0098765432",
    "amount": 75000.00,
    "narration": "Contractor payment - March 2026"
  },
  "message": "Entry added to batch successfully"
}

Related Operations

• Initiate Disbursement Batch — Create a new batch with entries
• Remove Disbursement Batch Entry — Remove an entry from a batch
• Retrieve Disbursement Batch Entries — List entries in a batch