Dokumentation

1Pingen Printing and Mailing

The following documentation introduces you to the printing service pingen.com that can be used for various cases inside the platform. Pingen lets you print any document inside the platform and send it to your customer. As such pingen integrates into the platform as printing services. Before you start with the configuration make sure that you are familiar with the printer concept by reading the Print Documentation first.

1.1Sign up for Pingen

In order to start using the pingen printing service, make sure that you sign up for an account at pingen first by using the Sign Up Link.

1.2Create and Configure a Pingen Printer

Once you signed up for pingen we can start to create a pingen printer. Go to Space > Printers to add e new printer and select the pingen printer. This will bring you to the setup screen of the pingen printer. Follow the instructions here and configure the printer according to your needs.

The access credentials (API Token) can be found in your pingen login. For this navigate inside your pingen account to Users > Selct your user > Click on *Show API token*. This will display the API token that can be copied and pased into your configuration.

iframe
Figure 1. Copy the pingen API token to the application.

1.3Print with Pingen

Once you created the printer you can assign the printer to different connectors or dunning levels.

You can for example create a pingen printer and use it for reminders that are in a certain dunning level and that should be sent as registered mail or via post. More information can be read under the Print Documentation and the Dunning Documentation.

1.4Verify Your Documents

An overview about the printed documents can be viewed under Space > Printers > Print Job. Here you see the status of all documents. It can happen that there are issues with your documents because they do not fulfill the requirements to be sent and processed by pingen. In case the status of the print job does not switch into the Successful state you have to investigate what needs to be changed on your document in order to be printed.

To do this login to your pingen backend and navigate to Documents. Here you see an overview of the printed documents. In the column valid for you see if the document is valid to be sent via post.

iframe
Figure 2. Check your documents whether they could be sent via post or not.

In case your document is not valid for post you can open it to see more information why it could not be processed.

iframe
Figure 3. In case you open the document you find more information why it was not sent via post.

To get a better understanding about the problem you should open it in the validate mode. To do this click on Solve Problems > Validate. This will open a validator that shows you the problem with your document. In most cases you do have text in ranges where you are not allowed to. To correct this you have to adapt your document templates in the resource editor and try again.

iframe
Figure 4. Validate your documents with the pingen validator.