# DHF Zolaris

Digicust integrates natively with Mic-Cust's [DHF Zolaris](https://www.mic-cust.com/de/landingpages/zollloesung-at-e-zoll/). Just upload customs cases to Digicust. Digicust processes the case and sends the filled out customs declaration to your Zolaris system.

Many of our clients use Digicust as a black box and just check warning messages within Zolaris system before submitting the automatically created customs declaration to the authorities.

### Setup

1. The setup is easy. Configure the API directly in the Zolaris system.<br>

   <figure><img src="/files/yrKW2zbXGOk8TdMBUYSI" alt=""><figcaption></figcaption></figure>

   Click "Schnittstellenverwaltung"

<figure><img src="/files/BmqHqVQwllAg2NLtT1iq" alt=""><figcaption><p>Click the white "new" icon</p></figcaption></figure>

Click the white white "new" icon. Then input the data as follows:

<figure><img src="/files/gNy9sDnHOXJ0oZaWaFxj" alt=""><figcaption></figcaption></figure>

Instead of C:\DHF\Digicust\ you can set up any path you want to put the interface files to. Ideally, it is an SFTP server where Digicust can send the files to directly.

2. To automate the regular import of interface files into the Zolaris application, we recommend setting up a Cronjob or using Task Scheduler on Windows. This guide will walk you through the necessary steps to configure the Task Scheduler for this purpose. To set up the Task Scheduler, follow these steps:
   1. **Open Task Scheduler:**

      Press Windows + R and type taskschd.msc, then press Enter.
   2. **Create a New Task:**\
      In the Task Scheduler, select `Create Task...` from the `Actions` pane.
   3. **General Tab:**

      Name: `Zolaris File Import`

      Description: `Automates the import of interface files into Zolaris`

      Configure for: `Windows 10` (or your specific Windows version)
   4. **Triggers Tab:**

      Click `New...`

      Begin the task: `On a schedule`

      Set your desired schedule (e.g., daily, weekly) and time

      Click `OK`
   5. **Actions Tab:**

      Click `New...`

      Action: `Start a program`

      Program/script: `C:\Program Files (x86)\DHF\Zolaris\Zolaris.exe`

      Add arguments (replace placeholders with your actual parameters):\
      `-s DB_SERVERNAME -d DBNAME -w 1 -u zolaris -l ZOLARIS_LIZENZNUMMER -o 1 -r SCHNITTSTELLE_ID -i Im_AF_Intra`

      Click `OK`
   6. **Conditions Tab:**

      Configure any conditions as necessary, such as only running the task if the computer is idle.
   7. **Settings Tab:**

      Ensure `Allow task to be run on demand` is checked

      Configure error handling settings as needed
   8. **Finish:**

      Click `OK` to create the task<br>
3. In Digicust, navigate to your execution strategy settings and select "Submission".<br>

<figure><img src="/files/i2JQFKhmvDAEmAi6POqp" alt=""><figcaption><p>DHF Zolaris setup</p></figcaption></figure>

1. Customs cases are sent to Zolaris using SFTP protocol. Ask DHF for your Zolaris SFTP credentials. Then input the following:

| Field      | Description                                                          | Example              |
| ---------- | -------------------------------------------------------------------- | -------------------- |
| DNS Name   | The domain or IP of the SFTP server                                  | sftp.your-domain.de  |
| Port       | Port of the SFTP server                                              | 22                   |
| Login name | The SFTP username                                                    | ggss                 |
| Password   | The SFTP password                                                    | \*\*\*\*\*\*\*\*\*\* |
| Inbound    | The SFTP inbound path where to Digicust sends the interface files to | /in/test             |

3. Save the execution strategy. Upload customs cases to said execution strategy and wait for cases to arrive in Zolaris.
4. The case should be filled-out and ready to hand in if Digicust has all information necessary. If not, try [Configure Execution Strategies](/guides/configure-execution-strategies.md) or set up [Rules & Templates](/features/rules-and-templates.md).

Happy automating with Digicust and Zolaris!

### Troubleshooting

If the Dakosy interface is not working as expected, do the following:

1. Use an SFTP client like <https://www.filestash.app/sftp-client.html> to check whether Digicust's interface files are arriving at the server correctly. If not, check the credentials and try again.
2. The Digicust - DHF interface is well-tested and in production with clients. However, in rare occasions it might happen that interface errors occur.. Kindly forward any error messages to <support@digicust.com>. We are happy to help!
3. Regarding task scheduler or Zolaris specific questions, please reach out to your DHF contact person.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guide.digicust.com/features/integrations/dhf-zolaris.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.