Configuration

Basic Settings

Action (from v5.8.0)

Select an action that the plugin should perform.

Plugin active (v5.6.1 - v5.7.5)

If this option is not enabled, all plugin functions remain inactive.

Send invoice to customer (until v5.7.5)

If this field is enabled, the customer will receive the invoice by email.

Make invoice available in customer account

Enable this option if you also want to provide the customer invoice directly via the customer account.

Process orders from

Orders received after this date will be automatically processed by the cron job.

So that not all old customers automatically receive an invoice after installation, the date of first activation is set by default (from v5.6.2).

Enable Cron Job (Scheduled Task)

not inherited

By enabling this option, orders are processed by cron job in the background. The cron job runs asynchronously every 10 minutes, so invoice sending does not occur immediately after order completion.

If you want to use this option, the option "Attach invoice to email" must remain empty.

Attach invoice to email (optional) (from v5.5.6)

not inherited

With this option you can choose which email's attachment the invoice should be sent with. The invoice will then be sent when other conditions are met. If the configured settings do not apply, the invoice will be sent with a separate email as soon as the settings apply.

Important: This option is optional. However, if you want to use it, you must note the following:

Additional Settings

Shop owner email

The invoice copy and delivery note will be sent to this email address. Separate multiple email addresses with a comma.

Email to shop owner

Select here which documents should be sent to the shop owner.

If no delivery note was selected, it will not be created either.

Export directory (from v5.4.1)

Invoices, delivery notes, cancellations and credit notes will be exported to this directory. Please specify relative to the shop directory. Documents can be exported via Orders -> Invoices or via cron job.

Allow automatic export of documents via cron job (from v5.4.1)

By enabling this field, invoices, delivery notes, cancellations and credit notes can be exported in the background via cron job. Important: To use this function, the cron job must be enabled in the basic settings.

Export documents only from edited orders (from v5.7.4)

If enabled, documents will only be exported from orders marked as edited.

Separate email field for invoices (from v5.7.2)

If enabled, the customer can enter a separate email address for invoice delivery during the checkout process.

Customer chooses whether they need an invoice (from v5.6.0)

If this option is enabled, the customer can decide during the checkout process whether they want the invoice sent to them.

Filename for invoice

Enter the filename for the PDF invoice here. The available variables can be found further down on this page.

Filename for delivery note

Enter the filename for the PDF delivery note here. The available variables can be found further down on this page.

Filename for cancellation invoice (from v5.5.10)

Enter the filename for the PDF cancellation invoice here. The available variables can be found further down on this page.

Filename for credit note (from v5.5.10)

Enter the filename for the PDF credit note here. The available variables can be found further down on this page.

Replace filenames in admin area (from v5.5.6)

Filenames are replaced when downloading in the admin area.

Send existing invoice documents (until v5.7.5)

If this field is enabled, the plugin will also send the invoice if the invoice document already exists, for example created by another plugin.

Send delivery note directly upon order receipt

When enabled, the delivery note will be sent directly to the shop owner upon order receipt.

Always create documents (until v5.7.5)

With this option you can have documents created for internal use even if you disable the option "Send invoice to customer".

Do not create documents via CLI (from v5.6.2)

If active, documents will neither be created nor sent when orders are created via CLI. Orders can still be processed via cron job.

Order number for PDF preview (from v5.6.4)

Here you can specify an order number of an existing order. The preview will then always be created using the information from this order. Otherwise, an order will be selected randomly or automatically generated.

Further information can be found under the menu item PDF Preview.

Orders per cron job run

Enter here the number of orders that should be processed per cron job run. By default, a number of approximately 40 orders is recommended. The cron job runs by default every 10 minutes. This can be changed in the DB table 'scheduled_task' for the row with 'fgits_autoinvoice.auto_invoice_order_scan' in the 'run_interval' column. For this, enter a value in seconds.

If you receive more than 200 orders per hour, you can increase the value. Important: The maximum number of orders per run depends on your server performance.

No invoice for order value from (from v5.7.5)

Excludes orders with the order value from the specified value. If nothing is specified, this function is disabled.

No invoice for order value up to (from v5.7.3)

Excludes orders with the order value up to the specified value. If nothing is specified, this function is disabled.

No invoice for these billing countries (from v5.8.0)

Excludes the specified billing countries. No invoice will be generated for orders from these countries. All conditions must apply simultaneously.

No invoice for these delivery countries

Excludes the specified delivery countries. No invoice will be generated for orders from these countries. All conditions must apply simultaneously.

No invoice for these shipping methods (from v5.7.3)

Excludes the specified shipping methods. No invoice will be generated for orders with these shipping methods. All conditions must apply simultaneously.

No invoice for these customer groups

Select here customer groups that should not receive an invoice. For example, if you want only business customers to receive an invoice, select all other customer groups here except "Reseller".

No invoice for these payment methods

Select here the payment methods that you want to exclude from invoice generation.

Exclude payment methods from synchronous processing

Orders with these payment methods will only be processed via cron job. Useful for PayPal invoice purchase etc.

Payment methods for purchase on account

Invoices for orders with payment methods selected here will be sent immediately after order completion.

Create invoice at payment status**

Select here a payment status at which the invoice (and delivery note) should be created and sent separately.

As soon as the desired payment, delivery and order status are reached, an invoice (and delivery note) will be created and sent.

If you want to use this option, the option "Attach invoice to email" must remain empty. When using the option "Attach invoice to email", this field must remain empty or be set to "Open".

Create invoice at delivery status** (from v5.7.4)

Select here a delivery status at which the invoice (and delivery note) should be created and sent separately.

As soon as the desired payment, delivery and order status are reached, an invoice (and delivery note) will be created and sent.

If you want to use this option, the option "Attach invoice to email" must remain empty. When using the option "Attach invoice to email", this field must remain empty or be set to "Open".

Create invoice at order status**

Select here an order status at which the invoice (and delivery note) should be created and sent separately.

As soon as the desired payment, delivery and order status are reached, an invoice (and delivery note) will be created and sent.

If you want to use this option, the option "Attach invoice to email" must remain empty. When using the option "Attach invoice to email", this field must remain empty or be set to "Open".

Order status after invoice generation (from v5.6.2)

The plugin sets the order status to the selected status after successful invoice generation.

Order status after invoice sending (from v5.6.2)

The plugin sets the order status to the selected status after successful invoice sending.

Setup (from v5.6.2)

Remove email templates when plugin is disabled

If this field is enabled, the email templates you created will be deleted when the plugin is deactivated.

API Settings (Until Version 5.8.4)

Admin user

In the fields "Admin username" and "Admin user password" enter the access credentials of a user who has access to the admin area. Note: This refers to a user you create under Settings -> System -> Users & Permissions.

Authentication method (from v5.6.7)

Here you can select the authentication method:

• admin = Username & password of an admin user

• integration = API Client ID & Secret

Determine APP_URL automatically

This field is enabled by default so that APP_URL is automatically determined by the plugin. If the field is disabled, APP_URL is taken from the .env file or from the field below if specified.

APP-URL

If APP_URL is specified here, this APP_URL will be used instead of the APP-URL from the .env file.

{$orderNumber}

Order number

{$orderDay}

Order date

{$orderTime}

Order time

{$documentNumber}

Document number

{$documentPrefix}

Document prefix

{$documentName}

Document name

{$documentDate}

Document date

{$customerEmail}

Customer email

{$documentAmount}

Number of documents

{$fullname}

Customer first and last name

{$firstname}

Customer first name

{$lastname}

Customer last name