Electronic Sales Invoices

Backlog field	Value
Story ID	AP-SAL-004
Epic	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 tax users, I want to review and submit eligible sales documents to ETA/ZATCA so that submission state and authority responses are traceable.

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

Eligible Posted invoice/return, authority configuration, official party/item/tax codes, token/signature, and unsent/retryable state are required.

Optional or conditional

Batch selection, sending schedule, and notes are optional.

Action behavior

Send creates authority payload/history and updates submission status only; it does not repost ERP financials/stock.

Blocking rule or downstream effect

Duplicate accepted submissions are prevented; rejection details remain visible and retry follows authority rules.