Modules:GlobalBlue Tax Free
Contents |
Introduction
Commercial module developed by Practics Business Solutions, Openbravo Gold Partner.
The scope of the present module is to allow the creation, void and print of a Tax Free invoice throught Openbravo Web POS.
Considerations
- The present module allows the emision of a Tax Free invoice, from Spain customs and Italy Customs only.
- The module does the specifics validations and gathers requiered information through Openbravo Web POS, as defined by either Country's Customs System
- For Spain, it is called DIVA.
- For Italy, it is called OTELLO.
- The integrator solution chosen for this module has been Global Blue
Installation
After Openbravo ERP is up and running, the Global Tax Free module should be installed. Log into the system using the System Administrator role and go to General Setup -> Application -> Module Management. Click the Add Modules tab and find the Global Tax Free module within the list of all modules available in the central repository.
Note: Keep in mind that the Global Tax Free module is a commercial module which means your Openbravo ERP instance must be activated and a valid license for this module from Practics Business Solutions, Openbravo Gold Partner, is needed before the module can be installed..
Master data configuration
To able the module to work properly some additional information must be provided to existing Openbravo Entities.
Note: Some data must be provided by Global Tax Free Provider, then you need to register a valid account with him.
Country and Region
New Global Blue section has been added two with the following fields:
- Blocked: if Country is Tax Free eligible it is shown as checked, otherwise not.
- Country Code: three digit Country Code
- Document Code: three digit Document Code
- ICAO Code: three digit ICAO Country Code
- Voucher Time Limit: The period of time where a receipt can be eligible to issue a Taxfree Voucher
- As a System Administrator, go to Country and Region and set Same Day for Italy. Leave blank for Spain.
- Minimum age: Birth date of a customer is mandatory to issue a Tax Free voucher. In this field, we set the minimum eligible age.
- Maximum age: The same as previous one, but we set the maximum eligible age. Set 100 for Spain and 110 for Italy
Client
On the organization window, under the Global Blue section, we've added next fields:
- Host IP, Port and Sender ID: Must be provided by Global Blue.
- Version: set '1.0' on this field.
- Diva Product Category: Contains a list of product categories defined by the Spanish Customs System Diva. You can see the full list on the Annex I of this document. You can set Diva Product Category for a specific Client, Organization, Product Category or Product.
- Otello Tax Exempt Goods Category: Must be defined for Tax Exempt products. See localization information at the end of this document.
Organization
On the organization window, under the Global Blue section, we've added next fields:
- Username, Password and Shop ID:they identify every store and their tills. Ask Global Blue for its credentials.
- Diva Product Category:See localization information at the end of this document.
Under the Global Blue Italy section, we've added next fields:
- Otello Tax Exempt Goods Category: See localization information at the end of this document.
- Invoice Sequence to Issue Taxfree:See localization information at the end of this document.
- Credit Note Sequence to Issue Taxfree:See localization information at the end of this document.
Note: this information must supplied for each Organization defined as Retail Store, if their WEB Pos Terminals will generate Tax Free Invoices
Channel TouchPoint
For each Pos Terminal that must generate Tax Free Invoices, the next fields under Blobal Blue section must be set:
- Desk Id: ask Global Blue for valid credentials. Each Desk ID, has associated and output Tax Free Voucher format: A4 PDF sheet or Thermal Receipt. A new Desk Id must be requested to Global Blue If we decided to change output format.
- Enable Global Blue Tax Free Integration for this Terminal : uncheck this if the current touchpoint doesn't issue Tax Free Vouchers, otherwise, leave It checked.
- Passport Reader Filler Character : sets the 'space' character for passports. Leave < by default.
- Output format: leave as default.
- Use product category for product description: leave unchecked by default. Otherwise, when a Tax Free is issued, product description will be taken from product category description.
- Use receipt number as invoice number: leave unchecked by default. Otherwise receipt documentno will be used to identify Tax Free Voucher instead of Invoice Number. This only applies for Spain Customs.
The next fields under Blobal Blue Italy section must be set:
- Invoice Sequence to Issue Taxfree:See localization information at the end of this document.
- Credit Note Sequence to Issue Taxfree:See localization information at the end of this document.
Business Partner
On the Business Partner window, under the Global Tax Free section, we've added next fields:
- Nationality,ICAO Code,Document Type,Origin Country: are filled when we choose Business Partner Country of Origin. This information is store on Global Blue Countries Window
- Origin Country: country where Business Partner has born.
- Passport Issuing Country: there are some cases where passport country is different from country of origin. A Canary Islands resident, may have a passport issued on Spain, but as Canarian Born resident, he must be eligible to tax free deduction on Spain, then some specials regions like Canary Islands, Ceuta and Melilla are found on Origin Country.
- Passport Identifier: passport id wich may differ from Tax ID
All of These are captured when We add a new Business Partner on WEB Pos.
Product Category
On the Product Category window, under the Global Tax Free section, we've added next fields:
- Diva Category List:See localization information at the end of this document..
- Tax Free Exclude: If checked, this will exclude all the products belonging to this category to be used on a Tax Free Invoice, for example: services or products that aren't Tax Free eligible. When a minimum amount needs to be reached to issue a taxfree this products will be excluded.
- Otello Tax Exempt Goods Category:See localization information at the end of this document.
Product
On the Product window, under the Global Tax Free section, we've added next fields:
- Diva Product Category: Contains a list of product categories defined by the Spanish Customs System Diva. You can see the full list on the Annex I of this document. You can set Diva Product Category for an entire Organization or a specific Product Category.
- Tax Free Exclude: If set, this product will be excluded to be used on a Tax Free Invoice, for example: a service or product that isn't Tax Free eligible.
Note: Diva Product Category and Otello Tax Exempt Goods Category are mandatory for their respective countries and they must be set when needed.
Process Request
Three new Process Request must be configured and Scheduled.
GB Get Desk Configuration
This process gathers information from Global Blue by a given Desk ID. This information should be used later, for example: to check minimum amount for a Country if needed. This process must be executed first, to allow other two to communicate with Global Blue. The information is stored on window Global Blue Desktop Configuration.
GB Get Countries
This process gathers all country list related to Tax Free Integration. It may be executed after GB Get Desk Configuration, from day to day, at the begining of Journey. The information is stored on window Global Blue Desktop Configuration.
GB Get Blocked Countries
This is third and last Process to be scheduled after GB Get Countries finish. European Union countries and other may be blocked to avoid Issuing a Tax Free Voucher. This process must be scheduled after GB Get Countries
Openbravo Web POS
- We've introduced changes on Business Partner creation window of Openbravo Web POS.
- Three menu options to Create, Void, and Print a Tax Free Invoice has been added on the Openbravo Web POS menu dialog.
- After a receipt has been paid and data has been synchronized to Openbravo Backoffice, If a Business Partner is a Tax Free Invoice eligible, a pop-up will be shown asking us about to generate or not a Tax Free Invoice.
Business Partner creation
On the Business Partner window, we've added the following fields required to create a Tax Free Invoice from Spanish Customs System:
- Email: to ask for a e-mail account of a newly created Business Partner.
- Country of Origin: the Country of Origin of the Business Partner. This allows to the module to know If a given Business Partner is Tax Free eligible or not.
Note: the country of the default delivery address created will be the default country assigned by Openbravo Web POS, then It must be different from the country filled here.
- Birth Date: a Date of Birth of the Business Partner.
- Passport Issuing Country, Passport N#: information regarding customer passport. It must be filled to Issue a Tax Free Voucher.
If we are creating a Business Partner outside European Union, some fields will turn mandatory, additionaly to those that Openbravo Web POS has by default: First Name, Last Name, Address, Tax ID, and Birth Date. They are mandatory for the some Country Customs System. If we leave some of these empty a pop-up will be shown.
Note: required fields to issue Tax Free Voucher may be different from Web POS mandatory fields. The Business Partner information needed to issue a Tax Free Voucher it is highlight in a blueish background color.
Gathering Traveller Data
While we are creating a Business Partner, two new buttons may appear to help gather data from Global Blue Integration System or a Passport Reader external device.
Gathering Global Blue Traveller Data
If we select a Passport Issuing Country and fill Passport N#, a yellow button called Search appears. When it is pressed, a search through Global Blue Integration System. If traveller information is found, many information will be filled automatically. If not, nothing will occurs and we must continue with the Business Partner creation.
Passport Reader
If we've a passport reader, when we press Read Passport button a new window is shown. If we read passport data through external passport reader, the passport information is readed. When we press Done button, this is returned to Business Partner window.
How it Works
Pop-up after receipt has been send to backoffice and paid
The module asks if We want to generate a Tax Free Invoice after a receipt has been paid and send correctly synchronized with Openbravo ERP. A pop-up will be shown if the next occurrences are met:
- Business Partner has Non European Union as Country of Origin.
- Delivery address of the current receipt is the issuing Tax Free Country.
- The total amount of receipt including taxes is greather or equal than the Minimum Tax Free Amount defined on the GB Desktop Configuration
- If we don't want to create a Tax Free Invoice we must press No button.
- If we want to create a Tax Free Invoice we must press Yes button. See [Synchronization with Global Tax Free Integration System] section
Manually Create a Tax Free Invoice
This action will be found on Openbravo Web POS menu.
To manually create a Tax Free Invoice from a Given receipt, we must find the desired ticket througs Receipts menu option.
Then press Create a Tax Free Voucher menu option.
Synchronization with Global Tax Free Integration System
At this moment, receipt information will be send to Global Tax Free Integration System.
- If receipt information is correct, a pop-up with a Tax Free Invoice ID will be shown and will be printed automatically across the printer device defined.
- If receipt information in not correct, a pop-up will be shown with information related to the issue.
Void a Tax Free Invoice
This action will be found on Openbravo Web POS menu. With this action we will void a previously generated Tax Free Invoice from a given receipt.
Note: this action will void a given receipt to be tax deductible on Customs Agency
To Void Tax Free Invoice from a Given receipt, we must find the desired ticket througs Receipts menu option.
Then press Void Tax Free Voucher menu option.
At this moment, receipt information will be send to Global Tax Free Integration System.
- If receipt information is correct, a pop-up with a receipt document number will be shown and receipt will be voided.
- If receipt information in not correct, a pop-up will be shown with information related to the issue.
Print a Tax Free Invoice
This action will be found on Openbravo Web POS menu. With this action we will print a generated Tax Free Invoice from a given receipt.
To Print Tax Free Invoice from a Given receipt, we must find the desired ticket througs Receipts menu option.
Then press Print Tax Free Voucher menu option.
A printed version of the Tax Free Invoice will be send to the configured printer device.
Country Customs Settings
Every Country needs special information that must be filled before issuing a Tax Free Voucher. Here they are the most relevant
Spain Customs
- Diva Product Category: Contains a list of product categories defined by the Spanish Customs System Diva. You can see the full list on the Annex I of this document. You can set Diva Product Category for a specific Client, Organization, Product Category or Product. For every product you want to deduct tax, a DIVA category must be set.
Italy Customs
- Otello Tax Exempt Goods Category: when a product is tax exempt (vat rate 0%), we must choose one of the showed categories. It can be defined at Client, Organization, Product Category or Product level.
The accepted values are:
- N2 _NonSoggette ... not subjected.
- N3 _NonImponibili ... not taxable.
- N5 _RegimeDelMargine ... special situation in which, for antique furniture, the VAT is
only applied on the difference between the purchase amount and the sales amount.
- Invoice Sequence to Issue Taxfree: An unique document Identifier, separate from invoices must be set, for each Vat Registration Number. It may not have gaps between numbers or repetitions.
- Credit Note Sequence to Void Taxfree: An unique document Identifier, separate from invoices must be set, for each Vat Registration Number. It may not have gaps between numbers or repetitions.