Error model and diagnostics

Stable code, safe message, request ID, retry semantics, and remediation owner.

Error fields

Stable machine code.
Safe user-facing message.
Request ID and timestamp.
Retryability indicator.
Field or dependency requiring action.

Classes

Authentication, permission, quota, validation, conflict, provider, and internal-service errors require different responses. Blind retry can hide causes and duplicate work.

Secrets

Responses and logs must not contain passwords, JWTs, API keys, connection strings, or full personal documents.

A note on availability

Features depend on plan, role, connected marketplace, and data readiness. ProfitVena does not replace primary marketplace statements or regulated accounting and legal records.

Error model and diagnostics

Error fields

Classes

Secrets

Related documentation