ALBIS Leasing manual.

Requirements

Shopware 6.7 and an existing dealer contract with ALBIS. There is a separate plugin version for Shopware 6.5 and 6.6 each. Without a contract and credentials the plugin cannot retrieve leasing offers. The payment method is available from a cart of 500 euros net.

Installation

Upload the plugin through the plugin manager, install and activate it, then open the configuration and enter the credentials.

Storing credentials

Credentials can be stored for all sales channels or per sales channel. To do so, select the channel at the top of the configuration and enter the values there. Fields left empty in a channel use the values for all sales channels. Connection test, product groups and the active interface display always refer to the channel selected at the top.

Sandbox mode

For trying things out without real applications. With the mode active, the plugin talks to the ALBIS test interface, and the minimum order value of 500 euros net is dropped so that small test orders can be run through.

Two contracts in parallel

Besides the main credentials, a second username, a second password and a second product group can be stored, also per sales channel. This is meant for dealers holding two ALBIS contracts, for example with different terms or for different legal entities.

Which contract applies to an item is set on the product: if the custom field custom_albis_contract has the value 2, rate and application use contract 2, otherwise contract 1.

Commission

Commission is given as a percentage, with allowed values between 0 and 5. The default is 5 percent. It feeds into the calculation of the leasing rates.

Managing director details

Whether the form also asks for the owner's or managing director's details depends on the selected legal form. For sole proprietors and partnerships, such as e.K., freelancers, GbR, trade businesses or partnership companies, the section appears automatically: salutation, name, date of birth, address, phone and email.

Display on the product page

Enabled by default. From a price of 500 euros net, the product detail page shows a block headed „Leasing made simple" with a button that opens a rate example with term, monthly rate and insurance. It is based on the calculated price, including advanced prices, tier prices and price rules. The setting can be switched off if leasing should only appear during checkout.

Application confirmation copy

After every leasing application the customer receives a confirmation by email. Optionally another address can receive this confirmation in BCC. Useful when leasing cases are handled separately in-house. The template lives in the Shopware mail settings and can be adjusted there.

Status coupling

With coupling enabled, the Shopware order status is updated automatically from the ALBIS leasing status. It is off by default, leaving the order status under your control.

The leasing application

The application is filled in as a form attached to the order. It asks for the lessee's company details including company name, legal form, street and house number, phone, email and IBAN. Depending on the legal form, the owner's or managing director's details are added. Phone number, IBAN and postcode are checked while filling in the form.

Special leasing payment

Alongside the leasing model, customers can enter a special payment. The permitted range is displayed, and „recalculate leasing rate" updates the rates.

Term and leasing rate

Available terms are shown in months with the matching rate, optionally including a down payment. All amounts are net, excluding VAT. Without selecting a rate the application cannot be submitted.

Submitting the application

„Submit leasing application" sends the application to ALBIS together with the order. The customer receives a confirmation email with all application details, addressed according to the billing address. If a copy address is stored, the confirmation also goes there.

Application number, application details and the status history are shown on the order in the custom field “ALBIS leasing application”.

Checking status from the console

The plugin queries the status of applications at ALBIS through a console command. It has to run regularly via cron job, otherwise the status stays unchanged. A call every 5 minutes is recommended:

The command only checks an application when it is due: every 5 minutes in the first half hour, then hourly up to 4.5 hours, then daily up to 90 days. Once a final status is reached, checking stops for that application. After 90 days a last check takes place, and with the status “settled” the order is completed.

Every status change is added with its date to the history on the order. With status coupling enabled, the plugin sets order, payment and delivery to cancelled on rejection or cancellation and completes the order after settlement. With --dry-run you see what would happen without changing anything.

Troubleshooting

No leasing rates are shown

There is no offer for this order. Common causes are a cart below 500 euros net, items not eligible for leasing, a wrong product group or a temporarily unreachable interface.

The IBAN is rejected

The form checks the IBAN while it is filled in, including the check digit. If it is invalid, the message appears directly at the field, and the application can only be submitted with a valid IBAN.

Missing managing director details

For legal forms with managing director details, day, month and year of birth are mandatory. If one is missing, the form will not submit.

The status is not updated

Usually the cron job for bin/console albis:check-status is not running. Run the command once by hand and check the output, then set up the cron job as described under Checking status from the console.

The connection test says “Credentials are not correct”

Enter user name and password exactly as ALBIS sent them, without spaces at the start or end. Check which sales channel you are testing for, and whether the sandbox mode matches your credentials.

The payment method does not appear on the product page

Check the detail page display setting and whether the payment method is active in the sales channel.

Support

We are happy to answer questions about the setup inside your shop. Questions about terms, credit decisions and contracts go directly to ALBIS. Get in touch via the contact page or write to info@stoneandwater.online.

Obtaining the plugin

ALBIS Leasing is free to download, with its own version for Shopware 6.5, 6.6 and 6.7. For Shopware 6.6 and 6.7 the right version including updates also comes through the free Plugin Suite. Using it requires a dealer contract with ALBIS, and terms and credentials come from there.