It doesn’t matter whether you are a new user who would like to get to know the instructions for use, or an experienced developer who would like to find out more about the ear-Portal’s interfaces: Here you can find valuable information to improve your experience and fulfill your technical requirements.
Technical framework conditions
Instructions for use of the ear-Portal and its interfaces
Technical requirements
For secure transimission in the ear-Portal and the connected webservices (SOAP and REST) the encryption protocol Transport Layer Security (TLS) is used. TLS ensures that information is secured cryptographically during transmission.
It is only possible to use the ear-Portal and the webservices if TLS 1.2 or a higher version is being used. Make sure that the applications and tools that you use (such as browser) fulfill the minimum requirements.
Electronic Data interface (SOAP)
The SOAP-interface enables you to sumbit amount reports in connection with the ElektroG among others, and to receive information of pick-up coordination. Additionally it offers functions to request public lists and services for own take-back systems (BattG).
The documentaion of the SOAP-interface (Version 2.0) is available in HTML-format at https://www.ear-system.de/ear-soap/v2.
Test environment on the ear-Portal and its interfaces
You can create a test account in the ear-Portal’s test environment and try out many of the ear-Portal’s functions.
Important notes on using the test environment
Please note that all data, inspection decisions and documents that you submit to or receive from the test environment are not legally effective. This test environment is exclusively meant for testing and has no effect on the actual ear-Portal. All inspection decisions and procedures are already determined, regardless of the test details that you submit. Therefore you cannot make conclusions regarding the results or the duration of the procedure in the actual ear-Portal.
Important note: All details in the test environment are deleted every 3 months, always on the first day of every quarter.
Test SOAP-interface
There is a separate testing system to test the SOAP-interface available. You can call up the WSDL for the testing system at the following URLs:
Instructions on using the SOAP-interface on the testing system
- Authentification
To use the SOAP-interface you have to sign up with a test account. Use the user-ID ‘test’ and the Password ‘test’ to do so. Please note that no changes will be made to the data if you sign up with this user. - Virtual registration number
A ‘virtual’ registration number (12345678) is provided for electrical and electronic equipment producers’ and ElektroG-representatives’ test users. This must be used for certain calls to the communication services. - Virtual pick-up coordination codes
A fixed sample answer can be generated for the functions of the pick-up coordination service getCodes and getDetails with the codeld V001 (for full report), A001 (for deduction) and B001 (for first induction) which always delivers back, both for pick-up, as well as also for provision, status 5 (‘pick-up confirmed after allocation’, or respectively ‘Provision confirmed after allocation’). - Test with electrical and electronic equipment producer’s account
Alternatively you can use the SOAP-interface with an account for electrical and electronic equipment producers that has been created in the test portal. In this case all the functions are available for you that are also available for a user in the productive system. Please note, though, that no valid data can be delivered on the pick-up coordination in the test system.
Test-REST-web service interface for producer guarantee systems
To be able to use the interface you will require user authentification. Use the given registration details:
- User name: test
- Password: test
After you have successfully registered you can try out the interface’s different functions. Please note that it is not possible to make changes in the test environemnt. All data is only checked formally and returned with the appropriate error or success reports.
Important notes on using the test environment
Please consider that the types of equipment IDs can differ from those in the productive systen, even though the called-on types of equipment are identical.