Custom Rendition-Plus Converter for XInvoice XML Documents

Owned by Mr. Schmittberger
Last updated: Nov 27, 2024 by Product Management
2 min read

This page describes how to integrate a custom converter into Rendition-Plus to convert XML files of the format XRechnung with syntax CII (Corporate Industry Invoice) to a human-readable PDF document. Also, the client is configured to show the PDF instead of the XML document.

Rendition Plus must be installed in version >= 5.0.3.

 

  1. Frist we install the custom converter for Rendition-Plus. It will (try to) convert all files of mimetype “text/xml” or “application/xml” to an XRechnung PDF document. It has the highest priority and will thus always be the first converter to try. If it fails rendition-plus will try the next converter for this mimetype. So, if the result is not the expected PDF, then the custom converter probably failed.

  2. Copy the following files to the folder <rendition-plus>\renditionplus\bin\custom\

  1. Restart Rendition-Plus to activate the custom converter

  2. Now we configure the client to not show the default viewer for XML files - which is the monaco editor - but use the pdfjs PDF viewer. We can do this for a list of objecttypes that are designated for XInvoice objects (documents)

  3. Copy the following file to the folder <service-manager-data>\webresource\resources\client\assets\_default\config\
    (If you already have this file - important is only the preview section. You can merge this into the existing file.)

  1. Edit the file and adapt the array “['etlainvoice']” in line 19 to the technical objecttype name(s) that contain the XInvoice XML documents. A list with multiple objecttypes would look like this “['xinvoice1', ‘invoices2’]”.

  2. Save the file and restart the client microservice (or the entire service-manager).

  3. Create a new dms-object of the above configured objecttype(s) with a XInvoice document as content and check the preview for correctness.