Working with the E-POST API
Archive
After sending the invoice, you can check the status in the joblist. This can be found in the factbox area directly on the overview of the documents. Here you can see when the letter was sent, who sent it and what the status is.
In the factbox area of the documents you can find the Connector 365 Activities. There you find the brief overview to each process. You can find this overview in the list view as well as the card view of the documents.
By clicking the field Accepted at you cand navigate the the complete overview. By clicking the field Status you can navigate to the detailed state overview of the process.
The page Connector 365 Activities provides you with a detailed overview of all letters that have been sent. It shows which options were used and displays any error messages that may have occurred. If the option Save file in job list is active in the setup, you can also view the sent document. To do this simply click on the name of the file under File name.
Clicking on the status marker of an entry opens the table of feedback entries.
Of interest here are the status ID reported back by the E-Post API, the descriptive status text and time details for various processing steps. In the case of processing errors, these are logged with the associated code, error level and description.
The status is subdivided by the Deutsche Post API into the following levels:
| Status | Meaning |
|---|---|
| 1 | Acceptance of the shipment: successful transmission of the shipment Status placement: upon successful upload of the shipment |
| 2 | Processing of the shipment: PDF has been checked and released for shipment to the printing center Status placement: a few minutes after acceptance of the shipment |
| 3 | Delivery to print center: Receipt of the shipment has been reported back to the API by the print center Status placement: within the next few hours after the shipment has been processed |
| 4 | Processing in print center: Shipment has been reported back as “shipped” by print center Status placement: one to two business days after posting to print center |
| 99 | Processing error: See error list |
A quick overview of successfully sent, still open and unsuccessfully sent documents of the last 30 days can be found on the E-Post status tiles in the role center.
Error list
Below you will find a list of codes related to possible errors, warnings and information.
| Error code type | Error code description | Prefix |
|---|---|---|
| Error | Error occurred, action required, processing aborted | E |
| Warnings | Error occurred, possible need for action, no processing abort | W |
| Infos | Pure information, no need for action | I |
Error
| Error code | Description |
|---|---|
| E001 | Invalid access data - Please check your login data |
| E002 | Invalid access data - VendorSubID invalid |
| E003 | Too many SMS requests - Too many SMS codes were requested within a short time. The request via this identifier is blocked for 15 min. |
| E004 | This EKP has been blocked by Deutsche Post AG |
| E101 | Invalid token - expired |
| E201 | Invalid status query - No shipment was found using this search criterion |
| E301 | No PDF format detected |
| E302 | Detected violation of DVF blocking range |
| E303 | Maximum file size of 20 MB exceeded |
| E304 | Maximum page count of 94 pages exceeded |
| E305 | Invalid country code: {placeholder for error details} |
| E306 | Invalid recipient address format detected: {placeholder for error details} |
| E307 | 1st page delivered in landscape format - file name: {placeholder for error details} |
| E308 | No DinA4 format - file name: {placeholder for error details} |
| E309 | Duplicate detected in submitted file name - {placeholder for error details} |
| E311 | Illegal combination: registered mail and foreign country |
| E312 | Illegal combination: dublex + registered mail |
| E313 | Violation of letter scheme: {placeholder for error details} |
| E314 | Maximum cover sheet file size of 1 MB exceeded |
| E315 | Error in shipment processing: {placeholder for error details} |
| E316 | Error in shipment upload: {placeholder for error details} |
| E317 | Illegal registered letter format in RegisteredLetter field: {placeholder for error details} |
| E318 | Rejection in print center: {placeholder for error details} |
| E319 | EKP is not released for the print center. Live shipping is currently not yet possible |
| E320 | The maximum number of test shipments allowed per day has been reached. No further test shipments are possible today |
| E321 | (Overhauled) Not all necessary return address fields for registered mail by return receipt were specified |
| E322 | Too high query frequency of letter status requests. The minimum time between 2 status queries is 5 seconds |
| E323 | No content detected in recipient area of PDF (White area) |
| E399 | General error: {placeholder for error details} |
| E501 | API status: Inactive {placeholder for error details} |
| E601 | PlugIn error: {placeholder for error details} |
| E900 | Unspecified error: {placeholder for error details} |
Warnings
| Warning Code | Description |
|---|---|
| W101 | PDF/A conversion warnings: {placeholder for details} |
| W201 | Overrun address range: {placeholder for details} |
| W202 | Exceeding blocking area left: This area is whitened in the print center |
| W220 | The specified data for the return receipt of registered mail will only be determined automatically from the viewing window of the letter as of 01.10.2022. This applies in particular to the return address from the sender line that can be determined in the window. Possible explicit entries will no longer be used from this date onwards. |
| W301 | Sender address not available |
| W501 | API status: maintenance notification {placeholder for details} |
| W601 | PlugIn warning: {placeholder for details} |
Info
| Info Code | Description |
|---|---|
| I101 | Additional option: PDF -> PDFA conversion |
| I501 | API status: OK |
| I601 | PlugIn Info: {placeholder for details} |
| I701 | Track And Trace Status Message: {placeholder for details} |
| I751 | Destination Status Message: {placeholder for details} |
