PDF Enhancer Error Codes

Complete reference for all VIESUS PDF Enhancer error codes — meanings, causes, and fixes.

Error codes appear in the XML processing report (<error code="X" msg="..."/>). Code 0 means success; all non-zero codes indicate a processing failure.

For underlying CLI exit codes from the enhancement engine, see CLI Exit Codes. For settings-related issues, see the PDF Settings Reference.

---

Common fixes by category

File system issues (12, 14–18)

• Verify all file and folder paths exist
• Check read / write permissions
• Ensure sufficient disk space

Permission errors (21–22)

• Run with appropriate user privileges
• Check file / folder permissions
• Ensure exclusive access to files

PDF processing (6, 13, 23–28)

• Verify PDF file integrity
• Check for password protection
• Confirm PDF version compatibility

License (7, 36)

• Verify license validity and expiration
• Check processing limits
• Contact [e-mail]

General system errors (1–8)

Code	Description
1	An unknown or unspecified error occurred
2	The PDF file has already been enhanced (use force option to re-process)
3	Failed to load the configuration/settings file
4	Unable to open the PDF document (file may be corrupted or password-protected)
5	Failed to create required directories
6	The input file is not a valid PDF document
7	License validation failed or license is invalid
8	PDF library initialisation or operation failed

File system & path errors (9, 12, 14–18)

Code	Description
9	File size is below the minimum threshold for processing
12	The specified input file could not be found
14	The specified path does not exist
15	VIESUS configuration file not found
16	Destination folder does not exist or is not accessible
17	Archive folder does not exist or is not accessible
18	Debug folder does not exist or is not accessible

File operations & permissions (10–11, 21–22, 29)

Code	Description
10	Failed to save the processed file
11	Error replacing images in the PDF
21	Insufficient file permissions for the operation
22	Failed to modify file permissions
29	Unable to delete the specified file

Configuration & parameters (19–20)

Code	Description
19	Invalid or incorrect command-line parameters provided
20	General VIESUS processing error

PDF processing errors (13, 23–28)

Code	Description
13	PDF library failed to initialise
23	Error during PDF flattening
24	PDF color conversion failed
25	PDF flattening initialisation failed
26	Image enhancement process failed
27	Failed to read image location data from PDF
28	No corresponding PDF found for TOX file

Trigger & workflow management (30–35)

Code	Description
30	Failed to rename the trigger file
31	Error copying folders
32	Failed to delete the trigger file
33	Unable to rename the specified folder
34	Failed to create the trigger file
35	Error during file archiving

License & resource limits (36)

Code	Description
36	Processing limit has been reached for the current license

Cropping & region processing (37–39)

Code	Description
37	Invalid cropping rectangle specified
38	Cropping rectangle extends beyond page boundaries
39	Error during cropping operation

Best practices

1. Log error codes. Capture and log the specific code per failed file — error categories rely on knowing which codes you're hitting.
2. Validate prerequisites. Verify file permissions, paths, and license status before processing.
3. Validate input. Ensure PDFs are valid and not password-protected before queueing them.
4. Monitor resources. Check available disk space and memory continuously in production.
5. Archive originals. Use the archive setting to preserve source files before any destructive operation.

---

For configuration parameters, see PDF Settings Reference. For the CLI, see PDF CLI Reference. For broader troubleshooting, see Troubleshooting.