Troubleshooting

This guide helps you resolve common issues when using mini-eric.

Common Issues

Binary Not Found

Error:

ceric binary not found: /path/to/ceric

Solutions:

PHP SDK: Ensure the ceric binary is in the correct location

# Check if binary exists
ls -la vendor/bin/ceric
# Create symlink if needed
ln -sf ../rechtlogisch/mini-eric-"$ID"/bin/ceric vendor/bin/ceric

Standalone: Verify the binary path and permissions

# Check if binary exists and is executable
ls -la /path/to/ceric
chmod +x /path/to/ceric

Custom path: Specify the correct binary path

$ceric = new Ceric(binaryPath: '/correct/path/ceric');

ERiC Libraries Missing

Error:

Could not initialize ERiC instance

Solutions:

Check library directory structure:

bin/eric
├── ericapi.dll (Windows)
├── libericapi.dylib (macOS)
├── libericapi.so (Linux)
├── [other ERiC library files]
└── plugins
   ├── commonData.dll (Windows)
   ├── libcommonData.dylib (macOS)
   ├── libcommonData.so (Linux)
   └── [other ERiC plugins]

Verify environment variable:

echo $PATH_VENDOR
# Should point to the plugins directory

Custom vendor path:

ceric --pathVendor /path/to/eric/plugins/ --pathXml info.xml --dataType Kontoinformation

Certificate Issues

Error:

Could not load certificate

Solutions:

Check certificate file exists:
```
ls -la $PATH_CERTIFICATE
```
Verify certificate PIN:
```
echo $CERTIFICATE_PIN
```
Inspect eric.log for ERRORs:
```
cat /path/to/eric.log
```

Test with default certificate:

# Use test certificate for validation
export PATH_CERTIFICATE="bin/eric/test-softorg-pse.pfx"
export CERTIFICATE_PIN="123456"

Note: For environment variable configuration, see Environment Variables.

Check certificate format:
- Ensure certificate is in PFX format
- Verify certificate is not corrupted
- Try to login with certificate on https://elster.de
- Check certificate permissions

Permission Errors

Error:

Storage directory not writable

Solutions:

Check directory permissions:

ls -la /path/to/storage/
chmod 755 /path/to/storage/

Check ownership:
```
chown -R $USER:$USER /path/to/storage/
```

Create directory if missing:

mkdir -p /path/to/storage/
chmod 755 /path/to/storage/

XML Validation Errors

Error:

Content of XML after adding header incorrect

Solutions:

Validate XML structure:
```
xmllint --noout your-file.xml
```
Check XML encoding:
- Ensure XML uses UTF-8 encoding
- Check for BOM (Byte Order Mark) issues

Verify data type matches content:

# Use draft mode to validate
ceric --pathXml your-file.xml --dataType YourDataType --usecase draft

Check required elements:
- Ensure all mandatory XML elements are present
- Verify element names and structure match ELSTER specifications

Process Execution Errors

Error:

Error while processing XML

Solutions:

Inpect processResult of ceric:

jq --raw-output .processResult response.json

Check ERiC logs:
```
cat /path/to/eric.log
```
Verify ERiC libraries:
- Ensure all required ERiC libraries are present

Test with simple XML:

# Use the provided info.xml example
ceric --pathXml examples/info.xml --dataType Kontoinformation

Download Errors

Error:

Could not initialize download use case

Solutions:

Check OTTO logs:
```
cat /path/to/otto.log
```

Verify UUID format:

# UUID should be in format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
echo "41a42915-d8ba-45c7-89e6-6b875a853fc4" | grep -E "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"

Check network connectivity:
- Ensure internet connection is available
- Verify firewall settings allow outbound connections to https://objektspeicher.elster.de (Port 443)

Error Code Reference

Command Line Errors (1-19)

Code

Error

Solution

Unknown or incomplete argument

Check command syntax and parameters

Missing --pathXml

Provide input XML file path

Missing --dataType

Specify data type parameter

Unsupported data type

Use supported data type, check supported-data-types in composer.json

Invalid usecase

Use 'draft', 'send' or 'transmit'

Data type print not supported

Use other supported usecase for given data type

15-18

Storage directory errors

Check directory permissions and existence

Missing --objectUuid for download

Provide object UUID for download operations

File I/O Errors (20-29)

Code

Error

Solution

Could not open input XML file

Check file path and permissions

Invalid UUID format

Use valid UUID v4 format

ERiC Errors (100-199)

Code

Error

Solution

100

Could not initialize ERiC instance

Check ERiC libraries and configuration

101

Could not load certificate

Verify certificate path and PIN

110

Error while creating header

Check ERiC logs for details

120

XML validation failed

Validate XML structure and content

130

Could not create output file

Check storage directory permissions

140

Error while processing XML

Check ERiC logs and XML content

150-151

Empty buffer/content

Check ERiC processing logs

160

Server response contains errors

Review server response for error details

170-173

Download operation errors

Check OTTO logs and network connectivity

Debugging Tips

Enable Verbose Logging

# Set environment variable for detailed logging
echo "log.detailed=ja" >> /path/to/bin/eric/eric.ini
ceric --pathXml info.xml --dataType Kontoinformation

Check Log Files

# ERiC processing logs
tail -f /path/to/eric.log

# OTTO download logs
tail -f /path/to/otto.log

# System logs (Linux/macOS)
tail -f /var/log/syslog

Test with Minimal Examples

# Test with provided examples
ceric --pathXml examples/info.xml --dataType Kontoinformation --pathStorage ./test/

# Check version and help
ceric --version
ceric --help

PHP SDK Debugging

<?php
use Rechtlogisch\MiniEric\Ceric;
use Rechtlogisch\MiniEric\Dto\CericInput;

$ceric = new Ceric();

try {
   $result = $ceric->draft(new CericInput(
      dataType: 'Kontoinformation',
      pathXml: 'info.xml',
      pathStorage: '/storage/'
   ));

   echo "Exit Code: " . $result->cericOutput->exitCode . PHP_EOL;
   echo "Message: " . $result->cericOutput->message . PHP_EOL;
   echo "ERiC Code: " . $result->cericOutput->ericCode . PHP_EOL;
   echo "ERiC Message: " . $result->cericOutput->ericMessage . PHP_EOL;
   echo "Other Output: " . $result->cericOutput->otherOutput . PHP_EOL;
} catch (Exception $e) {
      echo "Error: " . $e->getMessage() . PHP_EOL;
}

Performance Issues

Slow Processing

Causes:

Large XML files
Network latency for send/transmit operations
Insufficient system resources

Solutions:

Optimize XML size:
- Remove unnecessary whitespaces/tabs/line breaks

Check system resources:

# Check memory usage
free -h

# Check disk space
df -h

Use appropriate use case:
- Use draft for validation only
- Use transmit when PDF is not needed

Memory Issues

Error:

Out of memory

Solutions:

Increase PHP memory limit:
```
ini_set('memory_limit', '512M');
```

Getting Help

Check Documentation

CLI Reference - Complete command-line reference
PHP SDK API - PHP SDK documentation
XML Examples - Working XML examples

Support

For support and custom inquires, contact Recht logisch GmbH & Co. KG.

Reporting Issues

When reporting issues, please include:

System information:
- Operating system and version
- PHP version (for SDK issues)
- ceric --version (and cotto --version)
Error details:
- Complete error message
- Exit code
- eric.log/otto.log file contents
Reproduction steps:
- Minimal XML file that reproduces the issue
- Exact command used
- Expected vs actual behavior
Environment:
- Certificate information (if applicable)
- Network configuration

Installation Guide - Setup instructions
Error Codes - Complete error code reference
Configuration - Advanced configuration options

PreviousHelp Center

Last updated 4 months ago

hashtagCommon Issues

hashtagBinary Not Found

hashtagERiC Libraries Missing

hashtagCertificate Issues

hashtagPermission Errors

hashtagXML Validation Errors

hashtagProcess Execution Errors

hashtagDownload Errors

hashtagError Code Reference

hashtagCommand Line Errors (1-19)

hashtagFile I/O Errors (20-29)

hashtagERiC Errors (100-199)

hashtagDebugging Tips

hashtagEnable Verbose Logging

hashtagCheck Log Files

hashtagTest with Minimal Examples

hashtagPHP SDK Debugging

hashtagPerformance Issues

hashtagSlow Processing

hashtagMemory Issues

hashtagGetting Help

hashtagCheck Documentation

hashtagSupport

hashtagReporting Issues

hashtagRelated Topics

Common Issues

Binary Not Found

ERiC Libraries Missing

Certificate Issues

Permission Errors

XML Validation Errors

Process Execution Errors

Download Errors

Error Code Reference

Command Line Errors (1-19)

File I/O Errors (20-29)

ERiC Errors (100-199)

Debugging Tips

Enable Verbose Logging

Check Log Files

Test with Minimal Examples

PHP SDK Debugging

Performance Issues

Slow Processing

Memory Issues

Getting Help

Check Documentation

Support

Reporting Issues

Related Topics