Paraşüt e-Invoice Addon

35 Aufrufe Markdown

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

StatusEnables the addon. Saving with it checked runs a connection test; the addon stays off when the test fails.

Access ControlAdministrator 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 IDRequired. The application id from the Paraşüt developer panel.

Client SecretRequired. Stored encrypted; leave the asterisks in place to keep the saved value.

EmailRequired. The email of your Paraşüt login.

PasswordRequired. Stored encrypted, shown as asterisks once saved.

Company IDRequired. The number in your Paraşüt panel address.

Invoice ID PrefixOptional. Prevents id collisions when more than one system writes into the same Paraşüt account.

Invoice Line NoteOptional, up to 120 characters. Appended to the description of every invoice line sent to Paraşüt.

Tagging RulesOptional. 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 InvoicesAutomatic or Manual. Defaults to Manual, where every invoice is sent by an administrator.

Automatic Formalization DayShown only for Automatic. Days to wait after the payment date, 0 to 7; the legal limit is 7.

Formalization Start DateOnly 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 ScenarioCommercial 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 CodeDefaults to 302. Sent when the document carries a VAT-free line.

VAT Exemption ReasonThe text sent with the exemption code.

Cash Account IDOptional. The Paraşüt cash or bank account that receives the collection; the first account is used when empty.

Ignore Payment MethodsOptional. Invoices paid with the selected methods are never sent.

Tasks

Connecting to Paraşüt

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

Turning on automatic formalization

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

Choosing the e-Invoice scenario

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

Sending or retrying one invoice

Open the invoice detail and find the Paraşüt band in the summary card.
Click Send to Paraşüt, or Retry after a failure. The band shows Processing while the queue works.
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 AddonsRequired to open and save the settings.

Invoice OperationsRequired for Send to Paraşüt and Retry on the invoice detail.

War das hilfreich?

Vielen Dank für Ihre Rückmeldung!

Brauchen Sie weitere Hilfe?

Unser Support-Team ist rund um die Uhr für Sie da, wenn Sie oben nicht fündig werden.

Kontakt aufnehmen Ticket eröffnen