# Paraşüt e-Invoice Addon

https://docs.wisecp.com/de/parasut-e-invoice-addon

The Paraşüt addon sends your paid invoices to Paraşüt as sales invoices and issues the legal e-Invoice or e-Archive document for each one, so your official documents are issued without leaving the panel.

## Opening the Screen

Go to **Tools → Addons → Paraşüt → Settings**: `{admin}/tools/addons/settings?module=Parasut`

The addon can be enabled only while invoice taxation is switched on in the general settings. You also need a Paraşüt account with API access: a Client ID and Client Secret from the Paraşüt developer panel, the login email and password, and the company number in your Paraşüt address.

## What the Addon Does

| Place | What you see | What happens |
| --- | --- | --- |
| Settings screen | Connection, formalization and document fields. | Decides which invoices go to Paraşüt and how the document is issued. |
| Invoice detail | A Paraşüt band with the status, the e-document number and the PDF state. | Sends or retries one invoice. The official PDF is attached when it arrives. |
| Automation | The **Automatic formalization sweep** task. | Runs every minute and queues the invoices whose day has come. |
| Client area | An e-Invoice PDF download on the invoice page. | The client downloads the official document while the addon is enabled. |

### Which document is issued

The tax number on the invoice decides. A buyer registered in the e-Invoice system receives an e-Invoice; everyone else receives an e-Archive invoice. Only the e-Invoice carries a scenario, chosen with **e-Invoice Scenario**.

### What is not sent

An invoice is skipped when its currency is not TRY, USD, EUR or GBP, when its status is neither paid nor unpaid, or when more than 7 days have passed since its payment date. Invoices paid with a method listed under **Ignore Payment Methods** are skipped as well.

## Fields

- **Status**: Enables the addon. Saving with it checked runs a connection test; the addon stays off when the test fails.
- **Access Control**: Administrator groups allowed to manage the addon.
- **Test Mode (Sandbox)**: Connects to the Paraşüt staging environment. Needs separate sandbox credentials from Paraşüt support.
- **Client ID**: Required. The application id from the Paraşüt developer panel.
- **Client Secret**: Required. Stored encrypted; leave the asterisks in place to keep the saved value.
- **Email**: Required. The email of your Paraşüt login.
- **Password**: Required. Stored encrypted, shown as asterisks once saved.
- **Company ID**: Required. The number in your Paraşüt panel address.
- **Invoice ID Prefix**: Optional. Prevents id collisions when more than one system writes into the same Paraşüt account.
- **Invoice Line Note**: Optional, up to 120 characters. Appended to the description of every invoice line sent to Paraşüt.
- **Tagging Rules**: Optional. Each rule looks at the billing address country or the account language and applies a Paraşüt tag to matching invoices. A missing tag is created on first use.
- **Formalize Invoices**: Automatic or Manual. Defaults to Manual, where every invoice is sent by an administrator.
- **Automatic Formalization Day**: Shown only for Automatic. Days to wait after the payment date, 0 to 7; the legal limit is 7.
- **Formalization Start Date**: Only invoices paid on or after this date are sent automatically. Set to the enable date on first activation; pick an earlier date to include older invoices.
- **e-Invoice Scenario**: Commercial or Basic, defaults to Commercial. Commercial lets the buyer accept or reject the invoice through the e-Invoice system; Basic involves no buyer response. Has no effect on e-Archive invoices.
- **VAT Exemption Reason Code**: Defaults to 302. Sent when the document carries a VAT-free line.
- **VAT Exemption Reason**: The text sent with the exemption code.
- **Cash Account ID**: Optional. The Paraşüt cash or bank account that receives the collection; the first account is used when empty.
- **Ignore Payment Methods**: Optional. Invoices paid with the selected methods are never sent.

## Tasks

### Connecting to Paraşüt

1. Enter the Client ID, Client Secret, Email, Password and Company ID.
2. Click **Test Connection** at the top of the screen and wait for the success message.
3. Check **Status** and click **Save Changes**. The addon is now live and the Paraşüt band appears on invoice details.

### Turning on automatic formalization

1. Under **Formalize Invoices**, choose **Automatic**.
2. Enter the **Automatic Formalization Day** and check the **Formalization Start Date**.
3. Click **Save Changes**. From the next minute on, the sweep queues every eligible paid invoice whose day has come.

### Choosing the e-Invoice scenario

1. Under **e-Invoice Scenario**, choose **Commercial** or **Basic**.
2. Click **Save Changes**. Every e-Invoice issued from now on uses the chosen scenario; documents already issued keep theirs.

### Sending or retrying one invoice

1. Open the invoice detail and find the Paraşüt band in the summary card.
2. Click **Send to Paraşüt**, or **Retry** after a failure. The band shows **Processing** while the queue works.
3. Reload after a moment. The band shows **Official** with the e-document number, and **PDF Ready** once the official PDF is attached.

## Things to Watch

> **Seven days after payment**
> 
> A paid invoice older than 7 days is never sent, on any path. Late invoices stay unformalized and need handling outside the panel.

> **An issued document is not issued twice**
> 
> Retry reuses the document Paraşüt already holds for the invoice. It only finishes the missing steps, such as the collection or the PDF.

> **Failures reach the notification bell**
> 
> When an invoice fails after several attempts, an administrator notification offers **Retry** and **View Invoice**. The invoice detail shows the stage and the message returned by Paraşüt.

## Privileges

- **Tools Addons**: Required to open and save the settings.
- **Invoice Operations**: Required for Send to Paraşüt and Retry on the invoice detail.

## Related Screens

- [Invoice Detail](https://docs.wisecp.com/en/invoice-detail-overview)
- [Automation](https://docs.wisecp.com/en/automation-overview)
- [Addons](https://docs.wisecp.com/en/addons)