Transfer Requests

Backlog field	Value
Story ID	AP-VAN-003
Epic	Van Sales
Story type	Business workflow
Review status	Draft - business analyst and business owner review required
Source evidence	AppsPortal.Apis controller, application command/query handlers, validators, domain entities, and matching MFE workflow where available
Last source review	2026-07-10

User story

As distribution users, I want to request and track stock transfers for field operations so that vehicle/device stock is replenished through an auditable process.

Acceptance criteria

1. Only authorized users can view or execute the feature's actions.
2. Required business data, active dependencies, tenant/branch scope, and current document state are validated.
3. Invalid requests return actionable validation errors without applying a partial change.
4. Search, list, view, print, and export operations use the same authorized business scope.
5. Material create, edit, status, approval, posting, reversal, and integration actions are auditable where applicable.
6. Financial or stock effects are applied atomically and no more than once.

Business rules

Required

Requester/salesperson/device, source and target warehouse context, date, and positive item quantities are required.

Optional or conditional

Notes, priority, schedule, and partial fulfillment are optional/conditional.

Action behavior

Submit/approve changes request status only; linked Stock Transfer Post moves stock and updates remaining quantities.

Blocking rule or downstream effect

Over-fulfillment and transfer from unapproved/cancelled request are blocked.