https://doku.pdi.elanders-germany.com/ 2026-04-05T21:37:19+0200 https://doku.pdi.elanders-germany.com/ https://doku.pdi.elanders-germany.com/lib/exe/fetch.php?media=favicon.ico text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:aktuell_unterstuetzte_barcodetypen&rev=1554734101&do=diff Possible barcode types • DataMatrix • 2/5 family • Code 39 • Code 128 • EAN text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:allgemeine_technische_vorgaben&rev=1554734101&do=diff Printing data - technical specifications General * PDF-X3 * PDF version 1.3 * 3 mm bleed * No cutmarks * No colour bar Colours Production uses the CMYK colour space by default. You can also transmit data in RGB but they will be converted to the CMYK colour space for production, which can result in colour deviations. We use the standard Apple RGB colour profile for the conversion. text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:anwendungsbeispiele&rev=1554734101&do=diff PDI - application examples Example 1 You would like to integrate PDI into your shop system. You gather the user input and ask ELANDERS for a PDF preview that you can offer for download directly from your order process. Once the user approves the PDF preview, you give us the command to convert the current configuration for the order. ELANDERS now starts production and delivers to your customer. You use our interface invisibly in the background for your own customers. text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:auftragsarten&rev=1554734101&do=diff PDI - order types Order type Detail You transmit 1 Finished print orders Print order with finished print data that ELANDERS will only produce Job XML + print data PDFs 2 Generic print orders Print order for which ELANDERS generates the print data completely from an archive / media database and then does production text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:barcodes&rev=1554734101&do=diff Print data - barcodes General Production can and/or in many case must be carried out using barcodes on the product or on product components. It must be defined in advance where on the product the barcode can/may be affixed. A value generated by ELANDERS (the internal order number) is used for the barcode and automatically placed by ELANDERS in the previously defined positions. text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:beispiele_allgemein&rev=1554734101&do=diff Order transmission - XML examples To slim the project workflow, we will be happy to create XML structures for you, including adapted file references (PDFs, JPEGs, TIFFs, etc.) specifically for your products at the start of the project, based on the example data you provide. text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:buchrueckenberechnung&rev=1554734101&do=diff Print data - calculating book spines General The thickness of the spine of, for example, your photo album is calculated based on the number of pages. So if you create your own data, you will have to calculate the custom spine yourself. We can provide the parameters to use at the beginning of the project. text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:cloud_allgemein&rev=1554734101&do=diff Order transmission - cloud / storage General Upon request, we can provide you with data storage in our computer centre to minimise the load-intensive transmission of frequently used data. Server URL: cloud.pdi.elanders-germany.com Port: 22 Protocols: sFTP, SCP text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:datenkonventionen&rev=1554734101&do=diff Order transmission - conventions General * All filenames (XML and references) must be unique. * Tip: If you aren't using SOAP, then they must be unique between orders! * ISO 9660 is used for the file naming convention. * Transactions (XML and all references) are limited to 500 text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:datenschutz&rev=1554734101&do=diff Other - data protection General In brief: We cannot accept sensitive data on insecure channels! We will be happy to provide you with more information upon request. Data protection officer Mr. Jürgen Klaile Phone: +0049 (0) 7151-9563-405 Email: text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:downloads&rev=1554734101&do=diff Downloads Interfaces Description SST version XML version XSD download XML example Order transmission 2.0 ?? Download Download Order transmission 1.0 ?? Download Download Order transmission 1.0 ?? Download Download Tracking 2.0 2.3 Download Download text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:ebook&rev=1554734101&do=diff ~~BOOK~~ text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:faq&rev=1554734101&do=diff Other - FAQ Retrieving tracking data via sFTP Example using libssh2: <?php $connection = ssh2_connect('tracking.pdi.elanders-germany.com', 22); ssh2_auth_password($connection, 'USERNAME', 'PASSWORT'); $sftp = ssh2_sftp($connection); $handle = opendir("ssh2.sftp://$sftp/./"); echo "Directory handle: $handle\n"; echo "Entries:\n"; while (false != ($entry = readdir($handle))){ echo "$entry\n"; } … then use a loop with ssh2_scp_recv to retrieve the data … … and then delete the file with … text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:formatierung_allgemein&rev=1554734101&do=diff Order transmission - formatting Formatting of text elements in the XML You can dynamically tag text elements intended for the customisation and personalisation of printed products yourself. We use the conventions of our software solution to prepare print data. text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:moegliche_barcodetypen&rev=1554734101&do=diff Barcodes Production can and/or in many case must be carried out using barcodes on the product or on product components. It must be defined in advance where on the product the barcode can/may be affixed. A value generated by ELANDERS (the internal order number) is used for the barcode and automatically placed by ELANDERS in the previously defined positions. text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:mypdi_allgemein&rev=1554734101&do=diff PDI - myPDI General Upon request, we can set up access to a personalised “myPDI” Web interface for your support needs. https://pdi.elanders-germany.com Screens Transaction screen We check orders transmitted via SOAP or sFTP for content and completeness. Once they pass that test, the data transmitted is used to create one or more orders. In case of an error, you will receive details about the error here and can correct them and retransmit your data. Transactions with errors are automaticall… text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:nachdrucke&rev=1554734101&do=diff Order transmission - reprints General There are different kinds of processes that fall within the area of reprints. Reprints Changed or unchanged reprints of orders can be started through the PDI Web interface. This is a changed or unchanged copy of the original order, which is possible within the agreed-upon data retention period. text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:pdi_allgemein&rev=1554734101&do=diff PDI - General General The interfaces of Elanders GmbH (ELANDERS) permit you to transmit orders (usually print orders) from your Web applications and internal systems ELANDERS directly and automatically. Requirements • You have concluded a contract with ELANDERS. text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:pdi_auftrag&rev=1554734101&do=diff PDI - What does an order look like? General An order generally has several components. Required components XML data with job information: • Shopping cart / order • Posts • Desired product ID • Billing address • Order number • Item quantity text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:produkte_hardcover&rev=1554734101&do=diff Product samples - Hardcover available soon! text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:produkte_kalender&rev=1554734101&do=diff Product samples - Calendar available soon! text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:produkte_postkarte&rev=1554734101&do=diff Product samples - Postcard available soon! text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:produkte_rueckstichheftung&rev=1554734101&do=diff Product samples - Saddle stich available soon! text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:produkte_softcover&rev=1554734101&do=diff Product samples - Softcover available soon! text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:reportings_allgemein&rev=1554734101&do=diff text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:security&rev=1554734101&do=diff Interface - security General Access to PDI is possible in two ways. IP whitelisting Your fixed IP address or fixed IP range has been placed in our whitelist. This is generally your production system or systems that have shared access to the Internet through a router/firewall. text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:seite_2&rev=1554734101&do=diff text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:sidebar&rev=1554734101&do=diff PDI - Print Data Interface General myPDI Support Ordering Interfaces Conventions XML examples Reprints Validation Cloud / Storage Tracking General Messages Interface Status codes Error codes Error handling Command request Messages Interface Error codes SAOP General Functions Error codes Print data Technical specifications Book spine calculation Barcodes Product samples Hardcover Softcover Calendar Saddle stich Postcard Shipping General I… text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:soap_allgemein&rev=1554734101&do=diff Interface - SOAP in general General As a user of the PDI interface, you receive a personal URL to call the Web service WSDL with the functions customised for you, in the following form: https://services.pdi.elanders-germany.com/application_services/pdi-service/service.php?wsdl&uid=xyz123 With this example, you can instance your SOAP client under PHP, for example: text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:soap_error_codes&rev=1554734101&do=diff Interface - SOAP error codes Error codes Possible error codes that can be returned from the Web service methods. Code Message 17 Service error: SOAP service is not available in your client setup. 18 Service error: Preview generation failed. 19 text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:soap_funktionen&rev=1554734101&do=diff Interface - SOAP functions Here you can find a more detailed description of the SOAP functions. Connection test ping For testing availability of the Web service. Parameters expected: Element Description [“client”] Your client code [“pass” text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:start&rev=1554734101&do=diff PDI documentation Access to this documentation is protected. If you have been granted access, click here. If you are interested in our services and interfaces, please write an eMail to pdi-support@elanders-germany.com. text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:support&rev=1554734101&do=diff PDI - Support General You can reach our technical support team by sending an eMail to pdi-support@elanders-germany.com. Support is available from Monday to Friday from 9am to 6pm. text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:tracking_allgemein&rev=1554734101&do=diff Tracking - General Production tracking You can retrieve the current status of a transmitted order at any time through your myPDI access. Alternatively, we can gladly transmit the status to you specifically when certain quantities are exceeded on your system. text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:tracking_error&rev=1554734101&do=diff Tracking - Error handling General If your server cannot be reached in the agreed-upon manner (FTP, sFTP, HTTP), PDI will attempt to store the status messages on your server multiple times. The number of attempts and the waiting time between attempts can be custom configured for each project. By default, PDI makes 3 attempts at 30-minute intervals. text/html 2019-05-27T11:29:43+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:tracking_error_codes&rev=1558949383&do=diff Tracking - Error-Codes General Errors during order acceptance are also transmitted using tracking. There is a basic difference between error codes during acceptance of the transaction (import/SOAP), i.e. “Checks during order acceptance”, and preprocessing, or text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:tracking_interface&rev=1554734101&do=diff Tracking - Interface Header Element Type Possible values Description token String Unique ID of the transmission client_id Int Your PDI client ID client_name String Your PDI client name project_id Int Your project ID for the client number project_name text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:tracking_status_codes&rev=1554734101&do=diff Tracking - Status codes General More detailed tracking of the complete order handling process is possible. The messages break down into the following sections: * Transactions * Orders * Items * Packages Transactions A transaction describes the segment for transmission of an order to PDI, and includes: text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:tracking_transmission_from_pdi&rev=1554734101&do=diff Tracking - messages Push messages via XML All messages can be collected periodically (every 30 minutes) and transmitted to your sFTP server by XML. Here, all the changes to transactions, orders, items, packages and errors are are collected on a queue, then bundled into one or more XML files for transmission. text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:tracking_transmission_to_pdi&rev=1554734101&do=diff Command request - Messages Push messages via XML Analogous to the messages from us to your system, you can also transmit messages/requests by XML. You receive a response on success or failure through the tracking interface. The assignment can be made using the 'request_reference_id' attribute with your unique request ID. text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:tracking_transmission_to_pdi_interface&rev=1554734101&do=diff Command request - Interfaces Header Element Type Possible values Description token String Unique ID of the transmission client_id Int Your PDI client ID client_name String Your PDI client name project_id Int Your project ID for the client number text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:tracking_transmission_to_pdi_status_codes&rev=1554734101&do=diff Command request - Error codes General After successful processing of your command requests, you receive the result through the tracking interface in the instances “Transaction”, “Order”, “Item” or “Package”. If command requests could not be processed, you receive the response in the instance text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:uebermittlung_allgemein&rev=1554734101&do=diff Order transmission - Interfaces You can store your data directly in the main directory using your sFTP access. All files must initially be transmitted with a file ending of “.tmp”. After successful transmission and validation by your system, please rename the file to the corresponding file type. Our validation ignores all files with a file ending of text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:validation&rev=1554734101&do=diff Order transmission - Validation General We automatically check every order transmitted. Checks on order receipt Directly during processing of the transaction (the transmitted order (XML) with all the referenced data (e.g. PDFs)), the following points are checked. text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:versand&rev=1554734101&do=diff Shipping - General End customer shipping We ship every order individually to your end customer using your shipper. * DHL - including tracking * UPS - including tracking (available soon) * Deutsche Post - without tracking Collective batch text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:versand_international&rev=1554734101&do=diff Shipping - International General Pro forma invoices are automatically generated and attached to the shipment based on the item values you transmit in the XML. Specifying in the XML Beside the <delivery_address>, <items> etc. we need the following information: text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:versand_laender&rev=1554734101&do=diff text/html 2019-04-08T16:35:01+0200 Anonymous (anonymous@undisclosed.example.com) https://doku.pdi.elanders-germany.com/doku.php?id=en:versand_retouren&rev=1554734101&do=diff Shipping - Returns General The sender is generally your own company (DropShipping). So returns will be returned to your address. Please note that returns within Germany in most cases are free. For returns from abroad, often incurred increased costs (e.g. additional 30-50 Euro). So in some cases it is useful to destroy the consignment and ship new products to the correct shipping address.