app.core.exceptions module

All custom application exceptions with structured error codes. Every exception maps to a specific HTTP status code and error payload.

exception app.core.exceptions.CSVEncodingError(message: str, detail: dict[str, Any] | None = None)

Bases: FinParseException

error_code: str = 'CSV_ENCODING_ERROR'

status_code: int = 422

exception app.core.exceptions.CSVMissingRequiredColumnsError(missing: list[str], available: list[str])

Bases: FinParseException

error_code: str = 'CSV_MISSING_REQUIRED_COLUMNS'

status_code: int = 422

exception app.core.exceptions.CSVNoDataRowsError(message: str, detail: dict[str, Any] | None = None)

Bases: FinParseException

error_code: str = 'CSV_NO_DATA_ROWS'

status_code: int = 422

exception app.core.exceptions.CSVParseError(message: str, detail: dict[str, Any] | None = None)

Bases: FinParseException

error_code: str = 'CSV_PARSE_ERROR'

status_code: int = 422

exception app.core.exceptions.DuplicateFileError(existing_document_id: str)

Bases: FinParseException

Raised when a file with the same SHA-256 checksum already exists.

error_code: str = 'DUPLICATE_FILE'

status_code: int = 409

exception app.core.exceptions.EmptyFileError(message: str, detail: dict[str, Any] | None = None)

Bases: FinParseException

error_code: str = 'EMPTY_FILE'

status_code: int = 400

exception app.core.exceptions.FileMimeTypeMismatchError(message: str, detail: dict[str, Any] | None = None)

Bases: FinParseException

error_code: str = 'FILE_TYPE_MISMATCH'

status_code: int = 415

exception app.core.exceptions.FileTooLargeError(message: str, detail: dict[str, Any] | None = None)

Bases: FinParseException

error_code: str = 'FILE_TOO_LARGE'

status_code: int = 413

exception app.core.exceptions.FinParseException(message: str, detail: dict[str, Any] | None = None)

Bases: Exception

Base exception for all application errors.

error_code: str = 'INTERNAL_ERROR'

status_code: int = 500

to_dict() → dict[str, Any]

exception app.core.exceptions.InvalidExtensionError(message: str, detail: dict[str, Any] | None = None)

Bases: FinParseException

error_code: str = 'INVALID_EXTENSION'

status_code: int = 400

exception app.core.exceptions.OCRFailedError(message: str, detail: dict[str, Any] | None = None)

Bases: FinParseException

error_code: str = 'OCR_FAILED'

status_code: int = 422

exception app.core.exceptions.PDFCorruptedError(message: str, detail: dict[str, Any] | None = None)

Bases: FinParseException

error_code: str = 'PDF_CORRUPTED'

status_code: int = 422

exception app.core.exceptions.PDFPasswordRequiredError(document_id: str | None = None)

Bases: FinParseException

error_code: str = 'PDF_PASSWORD_REQUIRED'

status_code: int = 422

exception app.core.exceptions.PDFTooManyPagesError(message: str, detail: dict[str, Any] | None = None)

Bases: FinParseException

error_code: str = 'PDF_TOO_MANY_PAGES'

status_code: int = 422

exception app.core.exceptions.PDFWrongPasswordError(message: str, detail: dict[str, Any] | None = None)

Bases: FinParseException

error_code: str = 'PDF_WRONG_PASSWORD'

status_code: int = 422

exception app.core.exceptions.PartialParseError(message: str, detail: dict[str, Any] | None = None)

Bases: FinParseException

Raised when parsing succeeds but with warnings (non-fatal).

error_code: str = 'PARTIAL_PARSE'

status_code: int = 207

exception app.core.exceptions.UnsupportedFormatError(message: str, detail: dict[str, Any] | None = None)

Bases: FinParseException

error_code: str = 'UNSUPPORTED_FORMAT'

status_code: int = 415

exception app.core.exceptions.UploadIncompleteError(message: str, detail: dict[str, Any] | None = None)

Bases: FinParseException

error_code: str = 'UPLOAD_INCOMPLETE'

status_code: int = 400