Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Error Codes Reference

Complete list of error codes returned by the Reframe API.

Error Response Format

{
  "success": false,
  "errors": [
    {
      "error_type": "validation_error",
      "code": "INVALID_FORMAT",
      "message": "Description of the error",
      "field": "field_name",
      "location": "Path or location",
      "details": { ... }
    }
  ]
}

Error Types

TypeDescription
parser_errorMessage parsing failed
validation_errorMessage failed validation
business_validation_errorBusiness rule violation
transformation_errorTransformation failed
schema_errorXSD schema violation
system_errorInternal system error

Parser Errors

CodeDescription
MT_PARSE_ERRORFailed to parse SWIFT MT message
XML_PARSE_ERRORFailed to parse XML message
INVALID_BLOCK_STRUCTUREInvalid SWIFT block structure
MISSING_REQUIRED_BLOCKRequired block is missing
INVALID_HEADERInvalid message header

Validation Errors

CodeDescription
INVALID_FORMATField format is invalid
INVALID_LENGTHField length exceeds limits
MISSING_REQUIRED_FIELDRequired field is missing
INVALID_FIELD_VALUEField value is not allowed
INVALID_CHARACTER_SETInvalid characters in field
INVALID_DATE_FORMATInvalid date or time format
INVALID_CURRENCY_CODEInvalid currency code
INVALID_AMOUNT_FORMATInvalid amount format
INVALID_BICInvalid BIC/SWIFT code
INVALID_IBANInvalid IBAN format

Business Validation Errors

CodeDescription
NVR_VIOLATIONNetwork Validation Rule violation
CBPR_VIOLATIONCBPR+ requirement not met
CROSS_FIELD_ERRORCross-field validation failed
CONDITIONAL_FIELD_ERRORConditional field requirement not met
DUPLICATE_REFERENCEDuplicate transaction reference
INVALID_DATE_RANGEDate range is invalid
CURRENCY_MISMATCHCurrency codes don’t match

Transformation Errors

CodeDescription
UNSUPPORTED_MESSAGE_TYPEMessage type not supported
UNSUPPORTED_SCENARIOTransformation scenario not found
MAPPING_ERRORField mapping failed
DATA_TRUNCATIONData was truncated during transformation
CHARACTER_CONVERSION_ERRORCharacter set conversion failed
TRANSFORMATION_FAILEDGeneral transformation failure

Schema Errors

CodeDescription
XSD_VALIDATION_ERRORXSD schema validation failed
INVALID_NAMESPACEInvalid XML namespace
INVALID_ELEMENTUnknown or invalid XML element
MISSING_REQUIRED_ELEMENTRequired XML element missing

System Errors

CodeDescription
INTERNAL_ERRORInternal server error
TIMEOUTOperation timed out
SERVICE_UNAVAILABLEService temporarily unavailable
CONFIGURATION_ERRORConfiguration error