Question 1

How to install the Magento 2 extension?

Accepted Answer

Please find as follows a short overview how to install our Magento 2 extensions, using the sample of the Advanced Invoice Layout for Magento 2 extension:

Are you looking for installing the extensions on Magento 1? Then please have a look at our related FAQ article.

Do you want to install the extension via composer? Please see our FAQ article about installing with composer.

Preparations:

Make sure that "composer" is installed on your system. For details see these composer installation instructions.
Get your Magento API access keys (required for composer authentication) , as described in the Magento documentation.
Do a backup of your Magento installation for safety reasons (database and files).
Uninstall probably existing previous versions of the extension

Installation with Composer

Create a new folder for the extension in app/code/, e.g. app/code/Vianetz/AdvancedInvoiceLayout.
Unzip the setup package and copy the contents into the newly created folder. The folder structure should now be app/code/Vianetz/AdvancedInvoiceLayout/Block, app/code/Vianetz/AdvancedInvoiceLayout/etc, etc.
Please assure that the files are uploaded with the same file user permissions as the Magento installation!
Install extension requirements via composer on the command line in your Magento root directory:
```
composer require --update-no-dev vianetz/pdf-generator:^3.0 vianetz/module-core:^1.0
```
Note: If you use e.g. an older PHP version on the command line than on your webserver then you can add the command line argument --ignore-platform-reqs to ignore PHP version checks.
Enable the Extension and run the setup process by executing the following on the command line in your Magento root directory:
```
bin/magento module:enable Vianetz_Core Vianetz_AdvancedInvoiceLayoutbin/magento setup:upgrade
```
Restart compilation (only required in Magento Production mode):
```
bin/magento setup:di:compile
```
Clear the Magento cache (e.g. System -> Cache Management) and related caches if available (e.g. APC, Varnish, ..).

Congratulations, the installation has been successfully completed!

Question 2

How can I change the font family in the Magento PDF invoice?

Accepted Answer

With our Advanced Invoice Layout extension it is easy to change the font family in the Magento PDF invoice.
Therefore the Advanced Invoice Layout extensions ships with several default fonts which you can choose from:
Courier, DejaVu Sans, Helvetica, Times

Due to licensing issues it is not possible to add other font families by default but you can also easily add your own font family with the following possibilities:

Use Internet Fonts, e.g. Google Fonts
Use Local Fonts, e.g. in TTF format

If you want to use Internet Fonts, e.g. Google Fonts

(Note: this supported by our Advanced Invoice Layout Extension for Magento 1 from version 2.3.16 or newer or for Magento 2)
Additional fonts can easily be embedded via CSS, e.g. with Google Fonts. Please note that therefore the font files have to be downloaded and saved locally (due to a bug in the used PDF library)!

@font-face { font-family: 'Roboto'; src: url('/path/to/Roboto-Medium.ttf') format('truetype'); font-weight: normal; font-style: normal; }@font-face { font-family: 'Roboto'; src: url('/path/to/Roboto-Bold.ttf') format('truetype'); font-weight: bold; font-style: normal; }body { font-family: Roboto !important }

If you want to use local fonts, e.g. in TTF format

Advanced Invoice Layout for Magento 1 with version 2.3.16 or newer

You have to download the load_font.php utility from GitHub to the folder lib/dompdf-advancedinvoicelayout/ and change the third line of the file to

require_once "autoload.inc.php";

Then change into the directory lib/dompdf-advancedinvoicelayout.

Advanced Invoice Layout for Magento 2

You simply have to download the load_font.php utility from GitHub to the Magento root folder.

Then you need to make sure that the used DomPDF library gets to know the new font by executing the following command in the Magento root directory (replace MyFont with your desired font):
```
php -f load_font.php 'MyFont' /path/to/myfont
```
Finally you can use the font in your CSS with
```
font-family: MyFont;
```

Advanced Invoice Layout for Magento 1 with version 2.3.15 or older

You need to temporarily rename the file lib/dompdf/dompdf_config.custom.inc.php to something else.
Then change into the directory lib/dompdf-advancedinvoicelayout.
Execute the above mentioned load_font.php command.
Afterwards inject the new font into the XML config object (see app/code/community/Vianetz/AdvancedInvoiceLayout/etc/config.xml) by extending the XML node default/advancedinvoicelayout/fonts, e.g.
The node title must match the generated file in step 2.

And that's it. Now you can choose the new font family in the configuration section under System->Configuration->AdvancedInvoiceLayout.

For further explanations see also the PDF Library documentation about About Fonts and Character Encoding.

Question 3

How can I customize the Magento PDF invoice layout?

Accepted Answer

With our Advanced Invoice Layout for Magento 1 or Magento 2 it is very easy to create individual layouts for Magento PDF invoices, shipments and creditmemos.

Want to see some examples? Check out some sample invoice layouts from our customers.

The extension ships with a base HTML layout that already fits for many cases. Furthermore we will release more enhanced step by step so that you can customize the PDF layout without any effort.

Your own customizations can be done with HTML/CSS.
For more experienced users we also deliver SASS files that allows an easier modification of e.g. colors in the whole document.

Please see also how to customize the payment block in the Magento PDF invoice.

Basically it is always recommended to activate the Debug Mode of the AdvancedInvoiceLayout extension for testing different layouts under Stores -> Configuration -> Advanced Invoice Layout. With activated Debug Mode the intermediate HTML file will be saved with each print of the PDF invoice, shipment or creditmemo into the directory var/tmp/invoice_debug.html. Therewith you can analyze and customize the HTML structure and CSS style sheets more easily.
However you are advised to disable this setting in production environments for performance reasons.

Please see also the available variables.

Instructions for Magento 2

We recommend to do your own customizations within these files in your custom theme folder to avoid loosing changes in case that the Extension got an upgrade.
To do that create a new folder Vianetz_AdvancedInvoiceLayout and a subfolder templates/default in your theme directory in app/design/frontend/MYTHEME/MYTHEME/ and copy the files that you want to customize into the newly created directory.

Instructions for Magento 1/OpenMage

Your own customizations can be done with HTML/CSS. The appropriate files are in the following directories

app/design/frontend/base/default/template/advancedinvoicelayout/default
skin/frontend/base/default/advancedinvoicelayout/default/css

We recommend to do your own customizations within these files in your custom theme folder to avoid loosing changes in case that the Extension got an upgrade.
I.e. assuming that your Magento theme is in folder app/design/frontend/MYTHEME/default/ and you want to customize the invoice layout we recommend to copy the file app/design/frontend/base/default/template/advancedinvoicelayout/invoice.phtml to app/design/frontend/MYTHEME/template/default/advancedinvoicelayout/invoice.phtml.

Question 4

How to install the Magento 1 extension?

Accepted Answer

Please find as follows a short overview how to install our Magento extensions, using the sample of the AdvancedInvoiceLayout extension:

Preparations:

Do a backup of your Magento installation for safety reasons (database and files).
Disable Magento compilation feature (if activated): System->Tools->Compiler
Uninstall probably existing previous versions of the extension

Installation

1Unzip the setup package and copy the contents of the src/ folder into the Magento root folder. (The folder structure is the same as in your Magento installation (e.g. app/, skin/, ..). No files will be overwritten.)
Please assure that the files are uploaded with the same file user permissions as the Magento installation!
2 Clear the Magento cache (z.B. System->Cache Management) and related caches if available (e.g. APC, Varnish, ..).
3 Logout from the admin panel and then login again.

Congratulations, the installation has been successfully completed!

Question 5

How can I install the Magento extensions via composer?

Accepted Answer

Of course you can also install our proprietary Magento extensions via the great composer tool. This applies for our Magento 1 and for our Magento 2 extensions as well.

Therefore please follow these steps:

Contact us to get your access credentials. You will receive the repository URL, a username and a password.

Add this to your composer.json file:

"repositories": [{    "type": "composer",    "url": "https://packages.vianetz.com/.."}]

In your Magento installation type
```
composer require vianetz/module-advancedinvoicelayout
```
and enter the credentials that we provided to you as well as the Magento credentials.

Hint: you can also save the credentials in a file called auth.json so that you do not have to type them every time.

Question 6

How can I show custom attributes on the Magento invoice?

Accepted Answer

With our Advanced Invoice Layout Extension for Magento 1 it is very easy to display custom product attributes on the Magento PDF invoice, shipment or creditmemo.

Therefore the extension has a configuration setting where you can easily select which product attributes you want to show on the invoice, shipment and creditmemo PDF:

Show custom attributes on invoice, shipment or creditmemo PDF in Magento

If you want to display custom product attributes with our Advanced Invoice Layout Extension for Magento 2 you can add custom attributes to the PDF invoice by adding the following code to the theme template file default/item/invoice.phtml:

echo $this->getProduct()->getData('your_attribute_code');

The same applies also for the shipment and creditmemo PDF documents.

Question 7

Can I get a license for my development/staging domain?

Accepted Answer

These licenses are included in every production domain license. Please send us after your purchase for your production domain an email with your order number and the desired development domain. We're happy to extend your license then.

Question 8

Cyrillic characters are displayed as "?" on the Magento PDF invoice. What can I do?

Accepted Answer

The problem is that the chosen font family does not support the Cyrillic characters. So far no font with Cyrillic support is included into the AdvancedInvoiceLayout extension. That means that you have to get your own font family with support for Cyrillic characters and include it into the AdvancedInvoiceLayout extension.

Please also see our FAQ article about adding a new font.

Question 9

DHL Location Finder Extension: Post number is printed multiple times in address

Accepted Answer

If you are using our Advanced Invoice Layout Extension with the DHL Extension Dhl_LocationFinder it may happen that if you have added the post number in the shipping address with the variable

you will see the following output on the PDF invoice or shipment document:
Postnumber: Postnumber: Postnumber: Postnumber: Postnumber: Postnumber: Postnumber: Postnumber: 32403197

This issue happens due to a small bug in the DHL Extension that listens to the Magento event customer_address_format and adds the "Postnumber: " prefix. But as this event can occur multiple times (as it will within the Advanced Invoice Layout extension) the prefix is also added multiple times.

As this is not the desired behaviour you can patch the method Dhl_LocationFinder_Model_Observer::addPostNumberLabel() to only add the prefix once:

public function addPostNumberLabel(Varien_Event_Observer $observer)    {        $address = $observer->getData('address');        $postNumberLabel = Mage::helper('dhl_locationfinder/data')->__('Postnumber: ');        if ($address->getData('dhl_post_number') && strpos($address->getData('dhl_post_number'), $postNumberLabel) === false) {            $postNumberString = $postNumberLabel . $address->getData('dhl_post_number');            $address->setData('dhl_post_number', $postNumberString);        }    }

Please note that this was tested with Dhl_LocationFinder extension version 1.0.3.

Question 10

Error message "Mage registry key already exists" e.g. after extension installation

Accepted Answer

After installing a Magento 1 extension or Magento 2 extension you get the following error message, e.g. if you try to login the Magento admin backend:

Mage_Core_Exception: Mage registry key <...> already exists

The solution is very easy in most cases:

If you recently installed a new Magento Extension, please confirm that you followed all installation steps that are mentioned in the README file of the module.

In all other cases especially assure that the Magento cache is cleared, e.g. by emptying the var/cache/ directory in a Magento default installation and that the Magento compilation process has been triggered (if enabled).

If you need help with this problem, just contact me.

Question 11

How can I activate the PDF email attachment feature with other email extensions like Ebizmarts_Mandrill?

Accepted Answer

Important note

This issue is resolved in AdvancedInvoiceLayout Version 2.2.0. Please contact us to check if you can upgrade.

Short explanation

To realize the email attachment functionality in our AdvancedInvoiceLayout extension we had to extend the Magento core email logic to add methods for attaching documents. Unfortunately there is no way to do this without conflicts with other extensions that do the same, e.g. Ebizmarts_Mandrill or Aschroder_SMTPPro.

Solution

To solve this problem the following manual steps are required:

Make the Advanced Invoice Layout extension depend on the other extension by creating a new file app/etc/modules/ZVianetz_AdvancedInvoiceLayout_Compatibility.xml with the following content (replace OtherVendor_OtherExtension with the extension name)
```
                                                                
```
Copy the file app/code/community/Vianetz/AdvancedInvoiceLayout/Model/Email/Template to app/code/local/Vianetz/AdvancedInvoiceLayout/Model/Email/Template and replace the beginning with
```
Vianetz_AdvancedInvoiceLayout_Model_Email_Template extends Ebizmarts_Mandrill_Model_Email_Template
```
Flush the Magento Cache

Please find also further general discussions in this support thread.

Question 12

How can I configure the address format?

Accepted Answer

Since Magento 1.5 the address format can be configured under System->Configuration->Customer Configuration->Address Templates->PDF. Newlines are marked as pipes (|).

Question 13

How can I configure the tax format on the PDF invoice?

Accepted Answer

Following a sample for a AdvancedInvoiceLayout tax configuration that many of our German shop owners use (based on Magento 1.7.x):

System » Configuration » AdvancedInvoiceLayout » General » Tax Display: Including Tax
System » Configuration » Tax » Orders, Invoices, Credit Memos Display Settings » Include Tax In Grand Total: Yes
System » Configuration » Tax » Orders, Invoices, Credit Memos Display Settings » Display Full Tax Summary: Yes
(if this is set to "No" tax is not splitted into percent classes)

Question 14

How can I create different PDF invoice layouts for different Magento store views?

Accepted Answer

With our Advanced Invoice Layout Extension for Magento you can easily create store view specific layouts, texts, logos or colors. Therefore you can easily change the store view switcher on the Advanced Invoice Layout configuration page in the Magento backend.

If you want further more layout customizations to the HTML files there are 2 possibilities:

If you use already different Magento themes you can easily do the customizations in the appropriate theme folder (please also see our FAQ entry How to change the Magento PDF invoice layout?). I.e. you just do the customizations e.g. in app/design/frontend/theme1/default/advancedinvoicelayout and app/design/frontend/theme2/default/advancedinvoicelayout.
Additionally there is the possibility (e.g. if you use the same theme for both store views) to create own themes in the Advanced Invoice Layout extension.

Question 15

How can I customize the payment block in the Magento PDF invoice?

Accepted Answer

The AdvancedInvoiceLayout Extension prints a block with information about the chosen payment method onto the PDF invoice. This block is dynamically filled by the used Magento Payment Extension, e.g. PayPal, DebitPayment, Credit Card, etc. and so this is information is contained in the appropriate Extension files. For example for PayPal the payer email address is printed, for credit cards the credit card number and so on.

So if we want to customize e.g. the text/formatting that is printed on the invoice in case of "Purchase Order" payments we have to do the following steps:

copy file app/design/frontend/base/default/template/payment/info/purchaseorder.phtml to your theme folder i.e. app/design/frontend//default/template/payment/purchaseorder.phtml
customize the file to your needs

Basically it is always recommended to activate the Debug Mode of the AdvancedInvoiceLayout extension for testing different layouts under System > Configuration > AdvancedInvoiceLayout. With activated Debug Mode the intermediate HTML file will be saved with each print of the PDF invoice, shipment or creditmemo into the directory var/tmp/invoice_debug.html. Therewith you can analyze and customize the HTML structure and CSS style sheets more easily.
However you are advised to disable this setting in production environments for performance reasons.

This process can be done analoguous for other payment methods as well.

Please see also how to customize the Magento PDF layout in general.

Question 16

How can I display the Amazon Order Id on the Magento PDF invoice?

Accepted Answer

If you use the Magento Extension M2EPro you can easily display the Amazon Order Id on the Magento PDF invoice with our Advanced Invoice Layout Extension with the following code:

echo Mage::helper('M2ePro/Component_Amazon')->getModel('Order')->load($this->getOrder()->getId(), 'magento_order_id')->getChildObject()->getAmazonOrderId();

You can find more information in our FAQ on how to customize the templates.

Question 17

How can I force a page break in the Magento invoice PDF?

Accepted Answer

A page break can be forced in the invoice PDF by adding an HTML element with the CSS class pageBreak.

See also our FAQ article on how to customize the Magento invoice PDF layout.

Question 18

How can I move the logo on the Magento PDF invoice to the left?

Accepted Answer

If you use our extension Advanced Invoice Layout for Magento it is very easy to move the logo on the PDF documents (invoice/shipment/creditmemo) to the left or right. Just enter the following CSS snippet into System > Configuration > Advanced Invoice Layout > Custom CSS to move the logo to the left:

#header #storeLogo { text-align: left; }

Question 19

How can I print barcodes on the Magento PDF invoice?

Accepted Answer

With our Advanced Invoice Layout Extension for Magento it is very easy to print barcodes of any code on the Magento PDF invoice, shipment or creditmemo.
All you have to do is to choose a font family that supports your desired barcode format and use that in the Advanced Invoice Layout CSS file for printing the barcode. Voilà!

See also our FAQ article on how to customize the PDF invoice layout.

Question 20

How can I print the telephone number on the Magento pdf invoice?

Accepted Answer

Printing the telephone number of the customer on the Magento pdf invoice, shipment or creditmemo is very easy with our Advanced Invoice Layout Extension.

All you have to do is go to System > Configuration > Customer Configuration > Address Templates and in the field Advanced Invoice Layout PDFs add the following variable:

This field accepts HTML source code, i.e. you can add line breaks (
) or plain text as you like.

Question 21

How can I run the unit tests for your Magento extension?

Accepted Answer

The unit tests of our Magento 1 extensions are based on the EcomDev_PHPUnit module that can be found on Github.
I recommend installing the extension via composer like this:

composer config repositories.ecomdev-phpunit vcs git@github.com:vianetz/ecomdev-phpunit-magento1.gitcomposer require --dev ecomdev/ecomdev_phpunit dev-master

For detailed installation instructions please see the appropriate manual.

After installation of the EcomDev_PHPUnit extension you can run e.g. the Advanced Invoice Layout extension tests by the following command in the root folder of your Magento installation:

phpunit --group Vianetz_AdvancedInvoiceLayout

If everything is fine you should get a green output that says that all tests ran successfully:

PHPUnit 9.5.28 by Sebastian Bergmann and contributors...............................                                    30 / 30 (100%)Time: 00:19.833, Memory: 48.50 MBOK (30 tests, 34 assertions)

Question 22

How can I send Magento invoice/shipment emails to store owner only?

Accepted Answer

With our AutomaticInvoice extension you can send invoice emails to store owner exclusively (i.e. not to the customer). Therefore you have to set the following configurations:

System > Configuration > AutomaticInvoice > Invoice > Notify Customer: No
System > Configuration > Sales Emails > Invoice > Send Order Copy Method: Separate Email

The same applies to shipment emails as well:

System > Configuration > AutomaticInvoice > Shipment > Notify Customer: No
System> Configuration > Sales Emails > Shipment > Send Order Copy Method: Separate Email

Question 23

How can I show additional text in tax-free PDF invoices in Magento?

Accepted Answer

Our Advanced Invoice Layout Extension for Magento allows you to have customer group specific texts on the PDF invoice document.
Therefore on the customer group configuration page in the Magento admin panel there is an additional text field where you can enter HTML-text that will be displayed on PDF invoices if the customer is contained in that customer group.

The automatic group assignment is a standard Magento feature which is explained in more detail in the Magento Documentation.

Question 24

How do I get the Advanced Invoice Layout extension to work with module AITOC Checkout Fields Manager?

Accepted Answer

Go to System > Manage AITOC Modules, click on link "Manage Class Rewrites" and scroll down to the text field "Indicate names of all base Magento classes, that you wouldn't like to overwrite" and add the value Mage_Sales_Model_Order_Pdf_Invoice there.

Question 25

How to migrate Advanced Invoice Layout templates from Magento 1 to Magento 2?

Accepted Answer

If you use our Advanced Invoice Layout extension for Magento 1 and you want to migrate your shop to Magento 2, there are a few simple steps to make the invoice, packing slips and creditmemo PDF look nice:

Purchase the Advanced Invoice Layout extension for Magento 2
Copy all your template files from the Magento 1 extension from app/design/frontend/base/default/template/advancedinvoicelayout to the Magento 2 extension in view/base/templates/
Copy all the CSS files from Magento 1 from skin/frontend/base/default/advancedinvoicelayout to the Magento 2 extension in view/base/web/
Replace all occurrences of $this->__( .. %s .. ) with $this->__( .. %1 .. )

Question 26

How to translate the Magento PDF invoice?

Accepted Answer

With our AdvancedInvoiceLayout extension you are able to customize the Magento default PDF invoice layout to adapt it to your needs and improve the look'n'feel of the invoice.
Therefore you can also easily add your own translations (of course this in accordance to Magento best practices):

Identify the text string that you want to translate in the template files in app/design/frontend/base/default/template/advancedinvoicelayout, e.g. the string "Invoice #%s" in app/design/frontend/base/default/template/advancedinvoicelayout/default/invoice.phtml
Search for this text string in file app/locale/xx_XX/Vianetz_AdvancedInvoiceLayout.csv with xx_XX being the locale code, e.g. "de_DE".
If the text string is available just change the translation to your needs, otherwise add a new line at the end of the file with your translation like
```
"Invoice #%s","Ihre Rechnung Nr. %s"
```
Flush the Magento Cache in the backend

Question 27

I cannot login to the Magento Admin - what can I do?

Accepted Answer

Sometimes you have the problem that you cannot login to the Magento Admin area - despite entering the correct username and password. There are several points that you can check in this case (it is most probably an issue with the cookies):

Check the cookie domain in the core_config_data table that it matches your backend domain
Also check that if you previously switched from HTTPS to HTTP that you drop all browser cookies, as if the adminhtml cookie already exists with the "Secure" flag, it cannot be overwritten

Question 28

I get a "404"-Error after the installation of the extension

Accepted Answer

Symptom: A 404 error is shown if you go to System->Configuration and choose e.g. AdvancedInvoiceLayout tab.

To solve this kind of error you need to log out of the backend and log in again. Then the tab should be successfully accessible.

Question 29

I get the error message "There has been an error processing your request". What can I do?

Accepted Answer

The error message "There has been an error processing your request" is one of the most frequent error messages in in Magento 1 and Magento 2. This message is displayed in general if an error of any kind has occurred in Magento.

In this case Magento creates a file with the name of the error report number in the directory var/report, that contains further information regarding this error.

Please find an example for the error in the following screenshot:

Magento: There has been an error processing your request

Afterwards we check the contents of the file var/report/var/report/71f20cdad8ceb5efde802084ba1eec158275937c822322eee3b1eac5ebde00b0 in our Magento root directory for the sample error:

{"0":"test","1":"#1 Composer\Autoload\includeFile('/home/vianetz/ma...') called at [vendor/composer/ClassLoader.php:322]
#2 Composer\Autoload\ClassLoader->loadClass('Magento\Framewor...')
#3 spl_autoload_call('Magento\Framewor...')
#4 is_subclass_of('Magento\Framewor...', '\Magento\Framewo...') called at [vendor/magento/framework/ObjectManager/InterceptableValidator.php:42]
#5 Magento\Framework\ObjectManager\InterceptableValidator->isInterceptable('Magento\Framewor...') called at [vendor/magento/framework/ObjectManager/InterceptableValidator.php:16]
#6 Magento\Framework\ObjectManager\InterceptableValidator->validate('Magento\Framewor...') called at [vendor/magento/framework/Interception/ObjectManager/Config/Developer.php:62]
#7 Magento\Framework\Interception\ObjectManager\Config\Developer->getInstanceType('Magento\Framewor...') called at [vendor/magento/framework/ObjectManager/Factory/Dynamic/Developer.php:47]
#8 Magento\Framework\ObjectManager\Factory\Dynamic\Developer->create('Magento\Framewor...') called at [vendor/magento/framework/ObjectManager/ObjectManager.php:70]
#9 Magento\Framework\ObjectManager\ObjectManager->get('Magento\Framewor...') called at [vendor/magento/framework/App/Http.php:115]
#10 Magento\Framework\App\Http->launch() called at [generated/code/Magento/Framework/App/Http/Interceptor.php:24]
#11 Magento\Framework\App\Http\Interceptor->launch() called at [vendor/magento/framework/App/Bootstrap.php:261]
#12 Magento\Framework\App\Bootstrap->run(&Magento\Framework\App\Http\Interceptor#000000006a1e7d590000000079678f99#) called at [index.php:39]
","url":"/","script_name":"/index.php","report_id":"71f20cdad8ceb5efde802084ba1eec158275937c822322eee3b1eac5ebde00b0"}

If you do not find a solution for your problem, just send us this file please.

Question 30

Magento shows a Blank Page

Accepted Answer

While executing some actions Magento is only showing a blank page without any content.
This behaviour is mostly caused by a Fatal PHP error. Please have a look into your PHP log files (perhaps ask your hoster) and/or see the Magento error log in the directory var/log of your Magento installation.

Question 31

PDF documents cannot be generated when using a PDF background template file

Accepted Answer

Solution: Try to save the background PDF template file, especially save the PDF as PDF/A for Acrobat 1.4 or Acrobat 5.

Question 32

Schweizer QR-Rechnung mit Magento generieren

Accepted Answer

Mit meiner Advanced Invoice Layout Extension kann sehr einfach ein QR-Zahlschein nach den offiziellen Schweizer Vorgaben generiert und an die Magento PDF-Rechnung angehängt werden.

Aktivierung der QR-Rechnung in Magento

Für das Layout des Zahlscheins kommt eine Open Source Bibliothek zum Einsatz. Diese muss zunächst installiert werden, da diese nicht Teil der Standard Advanced Invoice Layout Installation ist:

composer require sprain/swiss-qr-bill

Als nächsten Schritt muss noch in der Konfiguration unter Stores -> Configuration -> vianetz Extensions -> Advanced Invoice Layout -> QR Bill Options das Feature aktiviert sowie die QR-IBAN und der Reference Type ausgewählt werden. Weitere Hilfestellungen finden sich auch in der FAQ der QR-Bibliothek.

Es kann außerdem noch konfiguriert werden, dass die QR-Rechnung nur für bestimmte Zahlungsarten aktiviert wird.

Anpassen des Layouts der QR-Rechnung

Das Layout sieht standardmäßig wie folgt aus: QR-Rechnung Beispiellayout

Um das Layout der QR-Rechnung individuell anzupassen, kann - wie für die Anpassung der Magento PDF-Rechnung auch einfach CSS-Code verwendet werden und in der Advanced Invoice Layout Konfiguration unter Stores -> Configuration -> vianetz Extensions -> Advanced Invoice Layout -> Custom CSS hinterlegt werden.
Der Selektor für die Tabelle im Zahlungsschein lautet #qr-bill.

Um den freien Platz auf der zusätzlichen PDF-Seite besser zu nutzen, kann außerdem auch der Platz oberhalb des Zahlscheins genutzt werden, um z.B. ein (Werbe-)Bild oder ähnliches anzuzeigen. Hierzu kann folgender CSS-Code genutzt werden:

#customQrBillContent {     background-image: url('https://www.vianetz.com/skin/frontend/default/vianetz/images/products/placeholder.png');    background-repeat: none;    width: 700px;    height: 500px;}

Question 33

What can I do if Magento invoice emails are not sent anymore?

Accepted Answer

If you use our AutomaticInvoice Extension and invoice emails are not sent anymore please check the following points:

Please check the configuration at System > Configuration > Automatic Invoice:
Is the Automatic Invoice Extension activated and are the checkboxes for "Generate Invoice" and "Notify Customer" triggered for the specific payment method?
Has the Magento invoice document been generated for the specific order and is it flagged as "invoice email sent"?
Which Magento Extension is used for the payment method? Perhaps it uses itself a mechanism for generating invoice document and sending the invoice email. Then perhaps it is better to exclude it from the Automatic Invoice generation.
Are there any error messages in the Magento and/or Automatic Invoice log files in var/log/?

Question 34

What kind of variables are available in Advanced Invoice Layout configuration?

Accepted Answer

For salutations, footer columns and other free texts in the Magento PDF invoices, shipments and creditmemos, the following variables are available in System -> Configuration -> Advanced Invoice Layout.

Please note: Simple existence of a variable can be checked with {{depend shipping_date}}, negations can be used with {{if is_shipment}}{{else}}No Shipment{{/if}}.

Variable/Expression	Explanation
`{{var increment_id}}`	Invoice/Shipment/Creditmemo Increment Id
`{{var customer_id}}`	Customer Id
`{{var order.getIncrementId()}}`	Order Id (all other order attributes can also be accessed with the order object)
`{{var increment_id}}`	Invoice/Shipment/Creditmemo Increment Id
`{{depend is_invoice}} Text only for invoices {{/depend}}`	"Text only for invoices" will only be shown on invoice PDFs.
`{{depend is_shipment}} Text only for shipments {{/depend}}`	"Text only for shipments" will only be shown on shipment PDFs.
`{{depend is_creditmemo}} Text only for creditmemos {{/depend}}`	"Text only for creditmemos" will only be shown on creditmemo PDFs.
`{{var billing_address}}`	Billing Address of Order (formatting can be configured)
`{{var shipping_address}}`	Shipping Address of Order (formatting can be configured)
`{{date}}`	Date of invoice/shipment/creditmemo creation (formatted in your locale)
`{{date+X}}`	Date of invoice/shipment/creditmemo creation plus specified number of days, e.g. for specifying due/delivery dates. (Replace "X" with number of days)
`{{var prefix}}`	Customer Prefix
`{{var firstname}}`	Customer Firstname
`{{var lastname}}`	Customer Lastname
`{{var shipping_date}}`	The date of the first shipment (if any)
`{{var payment_method.getTitle()}}`	The payment method title
`{{if payment_method_purchaseorder}} Only for invoices with payment method purchase order. {{else}}For all other payment methods.{{/if}}`	With this statement you can insert text that is dependent on the payment method, in this example purchaseorder. Just replace the text "purchaseorder" with your payment method code, e.g. "checkmo", "banktransfer", "payone", ..
`{{config design/head/default_description}}`	Access any Magento configuration value

If you have the extension Firegento_MageSetup installed the following additional variables are available:

Variable/Expression	Explanation
`{{var merchant_tax_number}}`	The configured tax number of the merchant
`{{var merchant_vat_number}}`	The configured vat number of the merchant
`{{var bank_account}}`	The configured bank account
`{{var bank_code_number}}`	The configured bank code number
`{{var bank_name}}`	The configured bank name
`{{var swift}}`	The configured swift number
`{{var iban}}`	The configured iban number

Question 35

Which data should I submit for a support request to vianetz?

Accepted Answer

Please send us the following data to help you answer your support request.

used extension version (e.g. AdvancedInvoiceLayout 2.0.13)
You can find the extension version in the configuration section e.g. in System > Configuration > AdvancedInvoiceLayout
domain on which you are using the extension and which produces the problem
Magento version

Furthermore if we should support you within our installation support, please provide us with the following details:

FTP/SSH access (username, password and path to Magento installation directory)
Magento Backend access (username, password and URL)

Please verify that all access data is working properly, especially if the Magento user has the correct group to login and view all relevant areas and the FTP user has write access to all folders of the Magento installation.
All data is kept confidentially.

Question 36

Which domain name should I type in?

Accepted Answer

Please specify your exact production domain name of your Magento installation, i.e. including www. (if exists) and including HTTP protocol like https://.
For more details please also see my license agreement.

Examples: https://www.vianetz.com, https://subdomain.example.com, http://vianetz.local

Frequently Asked Questions

Allgemeines

Lizenz

Magento 1

Rechnungslayout

Order Workflows

Installation Extension

Magento 2

Rechnungslayout

Installation Extension