Register a Driver Honorarium Fee for a Completed Assignment
After a driver completes an assignment, the coordinator registers the honorarium fee using a dedicated form. The form pre-fills details from the assignment (date, duration, destination) and allows the coordinator to confirm or adjust the fee amount based on the organization's rate configuration. The driver honorarium is a separate expense type from mileage reimbursement and follows its own approval and accounting export pathway. For Blindeforbundet, this integrates with the Xledger accounting system.
User Story
Acceptance Criteria
- Given the coordinator navigates to a completed assignment that has an acknowledged declaration, when they tap 'Register Honorarium', then the driver honorarium form opens pre-filled with the assignment date, driver name, and estimated fee based on org rate configuration
- Given the coordinator reviews the pre-filled fee, when they adjust the amount and submit, then the honorarium expense record is created and linked to the assignment in the database
- Given the honorarium has been submitted, when the coordinator views the assignment, then an expense summary card shows the registered honorarium amount and its submission status
- Given the organization has Xledger integration configured, when the honorarium is submitted, then it is queued for the next accounting export batch
- Given the driver does not yet have an acknowledged declaration, when the coordinator attempts to register a honorarium for that assignment, then the form is blocked with an explanation that the declaration must be acknowledged first
Business Value
Driver honorarium processing is currently handled through separate paper forms submitted to the finance team, creating a multi-day delay in payment and frequent errors due to illegible forms or missing assignment references. Integrating honorarium registration directly into the assignment workflow — linked to the declaration record — eliminates manual re-entry, speeds up driver payments, and creates an auditable chain from assignment through declaration to payment.
Components
- Driver Honorarium Form ui
- Driver Honorarium Service service
- Driver Fee Registration Form ui
- Expense Submission Service service
- Expense Repository data
- Expense Summary Card ui
- Accounting Integration Client infrastructure
- Driver Assignment Repository data
- Confidentiality Declaration Repository data