<style>p { margin: 0; }span.fr-emoticon.fr-emoticon-img { background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle; } span.fr-emoticon { font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0; } blockquote { border-left: solid 2px #5e35b1; color: #5e35b1; margin-left:0; padding-left:5px;}blockquote blockquote{ border-color: #00bcd4; color: #00bcd4;}blockquote blockquote blockquote{ border-color: #43a047; color: #43a047;} table.grid{ border-collapse: collapse;} table.grid td, table.grid th { border: 1px solid #ddd;} .fr-fic.fr-dib{ display: block; margin: 5px auto;}.fr-fic.fr-dib.fr-fir{ text-align: right; margin: 5px 0 5px auto;}.fr-fic.fr-dib.fr-fil{ text-align: left; margin: 5px auto 5px 0;}.fr-fic.fr-dii{ float: none; margin: 5px auto;}.fr-fic.fr-dii.fr-fil{ float: left; margin: 5px auto;}.fr-fic.fr-dii.fr-fir{ float: right; margin: 5px auto;}img.fr-dib.fr-fir { margin-right: 0; text-align: right;}img.fr-dib.fr-fil { margin-left: 0; text-align: left;}img.fr-dib { margin: 5px auto; display: block; float: none;}img.fr-bordered { box-sizing: content-box; border: solid 5px #CCC;}img.fr-shadow { box-shadow: 10px 10px 5px 0px #cccccc;}img.fr-rounded { border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box;}</style><style>
p {
margin: 0;
}
span.fr-emoticon.fr-emoticon-img {
background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle;
}
span.fr-emoticon {
font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0;
}
blockquote {
border-left: solid 2px #5e35b1; color: #5e35b1; margin-left: 0; padding-left: 5px;
}
blockquote blockquote {
border-color: #00bcd4; color: #00bcd4;
}
blockquote blockquote blockquote {
border-color: #43a047; color: #43a047;
}
table.grid {
border-collapse: collapse;
}
table.grid td,
table.grid th {
border: 1px solid #ddd;
}
.fr-fic.fr-dib {
display: block; margin: 5px auto;
}
.fr-fic.fr-dib.fr-fir {
text-align: right; margin: 5px 0 5px auto;
}
.fr-fic.fr-dib.fr-fil {
text-align: left; margin: 5px auto 5px 0;
}
.fr-fic.fr-dii {
float: none; margin: 5px auto;
}
.fr-fic.fr-dii.fr-fil {
float: left; margin: 5px auto;
}
.fr-fic.fr-dii.fr-fir {
float: right; margin: 5px auto;
}
img.fr-dib.fr-fir {
margin-right: 0; text-align: right;
}
img.fr-dib.fr-fil {
margin-left: 0; text-align: left;
}
img.fr-dib {
margin: 5px auto; display: block; float: none;
}
img.fr-bordered {
box-sizing: content-box; border: solid 5px #CCC;
}
img.fr-shadow {
box-shadow: 10px 10px 5px 0px #cccccc;
}
img.fr-rounded {
border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box;
}
</style><style>
p {
margin: 0;
}
span.fr-emoticon.fr-emoticon-img {
background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle;
}
span.fr-emoticon {
font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0;
}
blockquote {
border-left: solid 2px #5e35b1; color: #5e35b1; margin-left: 0; padding-left: 5px;
}
blockquote blockquote {
border-color: #00bcd4; color: #00bcd4;
}
blockquote blockquote blockquote {
border-color: #43a047; color: #43a047;
}
table.grid {
border-collapse: collapse;
}
table.grid td,
table.grid th {
border: 1px solid #ddd;
}
.fr-fic.fr-dib {
display: block; margin: 5px auto;
}
.fr-fic.fr-dib.fr-fir {
text-align: right; margin: 5px 0 5px auto;
}
.fr-fic.fr-dib.fr-fil {
text-align: left; margin: 5px auto 5px 0;
}
.fr-fic.fr-dii {
float: none; margin: 5px auto;
}
.fr-fic.fr-dii.fr-fil {
float: left; margin: 5px auto;
}
.fr-fic.fr-dii.fr-fir {
float: right; margin: 5px auto;
}
img.fr-dib.fr-fir {
margin-right: 0; text-align: right;
}
img.fr-dib.fr-fil {
margin-left: 0; text-align: left;
}
img.fr-dib {
margin: 5px auto; display: block; float: none;
}
img.fr-bordered {
box-sizing: content-box; border: solid 5px #CCC;
}
img.fr-shadow {
box-shadow: 10px 10px 5px 0px #cccccc;
}
img.fr-rounded {
border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box;
}
</style><style>
p {
margin: 0;
}
span.fr-emoticon.fr-emoticon-img {
background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle;
}
span.fr-emoticon {
font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0;
}
blockquote {
border-left: solid 2px #5e35b1; color: #5e35b1; margin-left: 0; padding-left: 5px;
}
blockquote blockquote {
border-color: #00bcd4; color: #00bcd4;
}
blockquote blockquote blockquote {
border-color: #43a047; color: #43a047;
}
table.grid {
border-collapse: collapse;
}
table.grid td,
table.grid th {
border: 1px solid #ddd;
}
.fr-fic.fr-dib {
display: block; margin: 5px auto;
}
.fr-fic.fr-dib.fr-fir {
text-align: right; margin: 5px 0 5px auto;
}
.fr-fic.fr-dib.fr-fil {
text-align: left; margin: 5px auto 5px 0;
}
.fr-fic.fr-dii {
float: none; margin: 5px auto;
}
.fr-fic.fr-dii.fr-fil {
float: left; margin: 5px auto;
}
.fr-fic.fr-dii.fr-fir {
float: right; margin: 5px auto;
}
img.fr-dib.fr-fir {
margin-right: 0; text-align: right;
}
img.fr-dib.fr-fil {
margin-left: 0; text-align: left;
}
img.fr-dib {
margin: 5px auto; display: block; float: none;
}
img.fr-bordered {
box-sizing: content-box; border: solid 5px #CCC;
}
img.fr-shadow {
box-shadow: 10px 10px 5px 0px #cccccc;
}
img.fr-rounded {
border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box;
}
</style><style>
p {
margin: 0;
}
span.fr-emoticon.fr-emoticon-img {
background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle;
}
span.fr-emoticon {
font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0;
}
blockquote {
border-left: solid 2px #5e35b1; color: #5e35b1; margin-left: 0; padding-left: 5px;
}
blockquote blockquote {
border-color: #00bcd4; color: #00bcd4;
}
blockquote blockquote blockquote {
border-color: #43a047; color: #43a047;
}
table.grid {
border-collapse: collapse;
}
table.grid td,
table.grid th {
border: 1px solid #ddd;
}
.fr-fic.fr-dib {
display: block; margin: 5px auto;
}
.fr-fic.fr-dib.fr-fir {
text-align: right; margin: 5px 0 5px auto;
}
.fr-fic.fr-dib.fr-fil {
text-align: left; margin: 5px auto 5px 0;
}
.fr-fic.fr-dii {
float: none; margin: 5px auto;
}
.fr-fic.fr-dii.fr-fil {
float: left; margin: 5px auto;
}
.fr-fic.fr-dii.fr-fir {
float: right; margin: 5px auto;
}
img.fr-dib.fr-fir {
margin-right: 0; text-align: right;
}
img.fr-dib.fr-fil {
margin-left: 0; text-align: left;
}
img.fr-dib {
margin: 5px auto; display: block; float: none;
}
img.fr-bordered {
box-sizing: content-box; border: solid 5px #CCC;
}
img.fr-shadow {
box-shadow: 10px 10px 5px 0px #cccccc;
}
img.fr-rounded {
border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box;
}
</style><p><strong>In this guide we will cover:</strong></p><p><strong>- What is Multi-Currency?</strong></p><p><strong>- Setting up multi-currency </strong></p><p><strong>- Updating conversion rates automatically</strong></p><p data-pasted="true"><strong>- Have Invoices Inherit the Conversion rate from the Sales Order or Recurring Invoice</strong></p><p><strong>- Determine what currency will be used (currency overrides) </strong></p><p><strong>- Viewing currency conversions on quotes/orders/invoices</strong></p><p><strong>- Purchase Currency</strong></p><p><strong>- Sales Currency</strong></p><p><strong>- Syncing invoices to Xero when using multi-currency</strong></p><p><br></p><p><br></p><p><strong><span style="font-size: 14pt;">What is Multi-Currency?</span></strong></p><p>Multi-currency allows you to create quotes, sales orders, purchase orders and invoices with various currencies. When multi-currency has been configured prices on these entities will convert automatically to the chosen currency. Currency overrides can also be set so agents do not need to know/choose the currency of the entity, the correct currency will be applied based on th<span style="color: rgb(0, 0, 0);">e customer/site</span> the entity is for. This should be used when you bill or purchase in more than one currency.</p><p><br></p><p><strong><span style="font-size: 14pt;">Setting Up Multi-Currency </span></strong></p><p>To enable multi-currency head to Configuration > Billing > Currency, here, enable 'Use multiple currencies'. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImE0NWY0MDM3LWY3MzktNDVhZC05MWY2LTU0Y2QyNTgwMzQ4MCJ9.lCEBooFbUDnoF3sWf-FZ-zEvnNiws0kEWT1aiVXT48U" class="fr-fic fr-fil fr-dib" width="734" style="width: 736px; height: 565.463px;" height="565"></p><p><strong><span style="font-size: 10pt;">Fig 1. Enable multi-currency</span></strong></p><p><br></p><p>Once enabled you will need to set a default currency. The default currency will be used to when calculating conversion rates, this will also be the currency quotes/sales orders/invoices are created using by default. </p><p><br></p><p><strong><span style="font-size: 12pt;">Configure currencies</span></strong></p><p>To configure currencies use the 'Edit Currencies' button (Figure 2). Here you can add new currencies. When adding a currency you will need to give it a name, symbol and code as well as set the conversion rate. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijg4ZmY1NGI1LWI4YmQtNDk1Yy05ZjM5LWEwZjVjMThjMTJiNCJ9.yvPMhsKwsYGanresliqS6UKJmmgumXHdjERrqQ2yE4I" class="fr-fic fr-fil fr-dib" width="790" style="width: 792px; height: 501.659px;" height="502"></p><p><strong><span style="font-size: 10pt;">Fig 2. New currency setup</span></strong></p><p><br></p><p><strong><em>Note: The symbol entered here will be used when generating PDFs.</em></strong></p><p><br></p><p>The conversion rate will be relative to the default currency. In the Figure 2 example my conversion rate for Euros is 1.16 and my default currency is pounds (GBP). All item prices will be set using pounds but when a quote, sales order, purchase order or invoice is created using euros, the item price will be multiplied by 1.16, as this is the conversion rate. </p><p><br></p><p><strong>Rate History</strong></p><p>Under the 'History' tab against the currency you will be able to configure historical currency rates. This is used to raise invoices/orders/quotes using a historical rather than the current rate, used for example, when a quote has been accepted but the currency rate has since changed, therefore when invoicing the customer you will need to use a historic rate (from the time of the quote). The rate that is used for the invoice/order is determined by the date of the invoice/order.</p><p><br></p><p>To add a historic rate head to the 'History' tab and add to the table, when adding, enter the rate and when this rate will end. This rate will no longer be used after the chosen end date. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjM2ZjdhNGE4LTdiZTUtNDg4OS04YzJlLTUzODNhYTIwMzUwMyJ9.Xl3FEp3UgpQJDJB6ufI888NfsxwbKgjHCPCF4hJL2sg" class="fr-fic fr-fil fr-dib" width="1218" style="width: 1220px; height: 331.455px;" height="331"></p><p><strong><span style="font-size: 10pt;">Fig 3. Currency History </span></strong></p><p><br></p><p>In the Figure 3 example, the rate 1.17 will be used until 17/04/25, after this date the current currency record will be used (1.16). Therefore, if I create an invoice using this currency and set the 'date invoiced' to be a date BEFORE 17/04/25 the rate 1.17 will be used. If I create an invoice that has the 'date invoiced' set to be a date AFTER 17/04/25 the rate 1.16 will be used (as this is the current rate). </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjU2N2I3Y2ZhLWQ4OTgtNDkzZS04MjBjLTc5ZDE0NTFkMDViYiJ9.JS27ugOXGsvG3sC_LLv-Pj8xyGijSbjmHdrBoDRX65s" class="fr-fic fr-fil fr-dib" width="1218" style="width: 1220px; height: 569.646px;" height="570"></p><p><strong><span style="font-size: 10pt;">Fig 4. Invoice using historical currency conversion rate</span></strong></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjcwNTJiYjk0LTUyNWYtNGQ2Ni04NjdjLWEyMWZmZTJjOTlhNyJ9.HW_jrA7jEtnJVwE2S1KB0H2zVfYJFhxoeuS1lwi3kAs" class="fr-fic fr-fil fr-dib" width="1217" style="width: 1219px; height: 520.462px;" height="520"></p><p><strong><span style="font-size: 10pt;">Fig 5. Invoice using current currency conversion rate</span></strong></p><p><br></p><p>This allows you to have conversions calculated based on past conversion rates. </p><p><br></p><p><strong><em>Note: The 'date' of the invoice/order being raised will default to the date it is actually created, therefore if you would like the invoice to use a historical conversion rate you will need to change the 'date invoiced' against the invoice to the date of the rate you would like to use. Keeping the due date and date sent the same. </em></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Updating Conversion Rates Automatically</span></strong></p><p>Of course, the conversion rate of each of your currencies can be updated manually against the currency. However, you can also have the update automatically on a daily basis. To enable this head to Configuration > Billing > Currency, enable 'Automatically update currency conversion rates'.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjA2NGU2ODZmLThlYzAtNGM4MS1iMTQxLWQzMDZkNzc1YzRhYiJ9.feNJPBZYu4Y7as8fyUDEkGtmPoQ3ilJrf6ySR48gWCc" class="fr-fic fr-fil fr-dib" width="628" style="width: 630px; height: 430.784px;" height="431"></p><p><strong><span style="font-size: 10pt;">Fig 6. Automatically update currency conversion rates</span></strong></p><p><br></p><p>When this is enabled all configured currencies will have their rates updated automatically on a daily basis. Allowing any invoices/quotes/orders raised to have the most current conversion rate applied automatically. </p><p><br></p><p>Conversion rate data will be taken from the <a data-fr-linked="true" href="https://openexchangerates.org/" id="isPasted" target="_blank" rel="noopener noreferrer">Open Exchange Rates</a> service. </p><p><br></p><p><strong><em>Note: If this is enabled updates to the conversion rate will not be stored against the currency as a historical record. Historical records can only be added manually.</em></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Have Invoices Inherit the Conversion rate from the Sales Order or Recurring invoice </span></strong></p><p>Often, in the time between raising a sales order for an order and invoicing the order, the currency conversion rate will have changed. This will also be the case for recurring invoices, the rate at the time of creating the recurring invoice will be different to the rate each time an invoice is actually created. </p><p><br></p><p>Settings are available to have invoices inherit the rate from the sales order or recurring invoice they are created from, these are found under Configuration > Billing > Currency, shown in Figure 7.</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImQwZjYzNTkwLWI1ODgtNDVkYS1hMjM4LTA2NWU4Y2M5YTZmYSJ9.apnAfyB3aQxfgx_FKDBPB1J-PCujLN_BsGj42VLbVPQ" class="fr-fic fr-fil fr-dib" width="943" style="width: 945px; height: 342.951px;" height="343"></p><p><strong><span style="font-size: 10pt;">Fig 7. Settings to have invoice inherit the conversion rate from another entity</span></strong></p><p><br></p><p><strong>Currency Conversion Rate is inherited from Recurring Invoice</strong> - When enabled, invoices generated from a recurring invoice will use the same conversion rate as the recurring invoice. The rate that was active at the time the recurring invoice was created will be used, rather than the most recent rate </p><p><strong>Currency Conversion Rate is inherited from Sales Order</strong> - When enabled, invoices generated from sales orders will use the same conversion rate as the sales order they are generated from. The rate that was active at the time the sales order was created will be used, rather than the most recent rate. </p><p><br></p><p><strong><span style="font-size: 14pt;">Currency Overrides </span></strong></p><p>The currency used can be selected against the entity, however, this can be automatically defaulted based on the customer and site the quote/invoice/order is for. </p><p><br></p><p>To default the currency a customer uses head to the customers module > select a customer > Billing tab > see 'currency' setting.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjI1NTYxZmJlLTFkOTgtNGMzZi04Y2Y4LTg3MDRmM2I1YjliNSJ9.7qLhQQQwlsLPqbLSJYY-KDsDjyyVOxD3IjOh4BSeo0k" class="fr-fic fr-fil fr-dib" width="441" style="width: 443px; height: 325.928px;" height="326"></p><p><strong><span style="font-size: 10pt;">Fig 8. Customer currency override</span></strong></p><p><br></p><p>The currency chosen here will automatically be used when raising quotes/orders/invoices for this customer. </p><p><br></p><p>A currency override can also be set against each site. Head to a site profile > Billing tab, here you will see the same setting titled 'Currency'. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjI2OTBhN2NjLWZiNTEtNGI2ZC05YjUyLTFkNmJjMGM0NGFhNSJ9.h3ilUkgG_vcHvyAP5t0NkwZlPH7-7hB-Arq5FIk9EMU" class="fr-fic fr-fil fr-dib" width="739" style="width: 741px; height: 728.732px;" height="729"></p><p><strong><span style="font-size: 10pt;">Fig 9. Site currency override</span></strong></p><p><br></p><p id="isPasted">The currency chosen here will automatically be used when raising quotes/orders/invoices for this site, this will override the customer level setting if set. </p><p><br></p><p><strong><span style="font-size: 14pt;">Override Item Price based on currency</span></strong></p><p>An overriding cost and price can be set against each item based on the currency it is being quoted/charged for in. This is useful if the cost/price of items varies based on the currency it is being purchased/sold in, for example, when it is cheaper to purchase an item in an alternative currency.</p><p><br></p><p>To do this head to the item profile under, items/products module > select the item > costing and pricing > add an entry to the 'Overriding cost and Price' table. From here you will be able to set the cost/price to change automatically depending on the currency the item is being quoted/ordered in.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjBhZTc4NjdkLTg4YWYtNDY3OC05Y2M4LTdkZWJlOWQyN2EwNiJ9.dV0xb4OevI19WZD4y3eQFFsIxsfxdvsGq2S8EBcKSh0" class="fr-fic fr-fil fr-dib" width="505" style="width: 507px; height: 604.842px;" height="605"></p><p><strong><span style="font-size: 10pt;">Fig 10. Override cost and price based on currency</span></strong></p><p><br></p><p>Now, when a quote/order/invoice is set to use 'Euro' as the currency, any items added to this will use this as their cost/price. </p><p><br></p><p><strong><em>Note: If a currency price/cost override is not used the price/cost of the item in the chosen currency will be calculated using the current conversion rate. </em></strong></p><p><br></p><p>These can be imported via an XLS spreadsheet using the following column headers.</p><p id="isPasted"><br></p><ul><li>overridingsupplierid</li><li>overridingclientid</li><li>overridingcurrencyid</li><li>overridingcurrencycode</li><li>overridingcurrencysymbol</li><li>overridingprice</li><li>overridingcost</li></ul><p><br></p><p><br></p><p><strong><span style="font-size: 14pt;">Viewing currency conversions on quotes/orders/invoices</span></strong></p><p>Quotes/orders/invoices should be created in your default currency, then a conversion will apply based on the customer/site or currency selected. How/when you can view the converted rate will vary based on the entity. </p><p><br></p><p>When a quote/order/invoice is raised you can set the currency this should be sent in within the details (right-hand pane). However, the agent's view of the entity will not be updated to reflect the chosen currency. The value of the quote/order/invoice will be converted to the chosen currency when a PDF is generated. </p><p><br></p><p><strong><span style="font-size: 12pt;">View chosen currency in Agent App</span></strong></p><p>If you would like agents to be able to see the quote/order/invoice total in converted to the chosen currency before creating a PDF, this can be enabled. Head to Configuration > Billing > Currency and enable 'Show both currencies on quotation/order/invoice lines'.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjM0MmZlM2JiLWUwMjUtNGVmMi05YjRkLTNmNjA0MjZiOGEyMCJ9.wULL8-zD1mMPXP7baITVGsPj8lMHfwdgPTZcbu9BVKA" class="fr-fic fr-fil fr-dib" width="595" style="width: 597px; height: 385.135px;" height="385"></p><p><strong><span style="font-size: 10pt;">Fig 11. Setting to show currencies in agent app</span></strong></p><p><br></p><p>When this is enabled a button will be made available on quotes/orders/invoices that will allow you to toggle the view of the entity to show the chosen or default currency. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImU2ZWVhN2RjLTJkODktNDQzZi04YjJjLTEzMTI2OTBkZjc5NiJ9.cLqWpr7nzLXhUhto6BZrZditWnhgkSK_r8T86A6a08Q" class="fr-fic fr-fil fr-dib" width="708" style="width: 710px; height: 285.351px;" height="285"></p><p><strong><span style="font-size: 10pt;">Fig 12. Button to toggle currency view</span></strong></p><p><br></p><p>Figure 13 shows how this invoice will look when the button is used, here we can see the invoice now displays prices in euros instead of pounds. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImFjYjAxYWE2LTYxMzctNGQxNC1iODE4LTdkNjcxYmY2MzJjYyJ9.zHEyvps8I5mFdofiuJgJUjpugSuehOCcaJ6uVK1Te7o" class="fr-fic fr-fil fr-dib" width="1224" style="width: 1226px; height: 526.22px;" height="526"></p><p><strong><span style="font-size: 10pt;">Fig 13. Viewing invoice in agent app using alternative currency </span></strong></p><p><br></p><p><strong><em>Note: The PDF for the entity will always generate using the selected currency, not the currency the agent is viewing the entity in. </em></strong></p><p><br></p><p>If you would like the quote/order/invoice to always display in the chosen currency by default enable the setting 'Display the currency set against the quotation/order/invoice by default' (shown in Figure 11). </p><p><br></p><p><strong><span style="font-size: 14pt;">Purchase Currency </span></strong></p><p>Purchase currency can be enabled to help you track your costs when items are purchased in various currencies. Enabling this will allow you to choose the purchase currency used for each line item on a quote, this will automatically re-calculate the 'cost' of the item on the quote so it is in line with you default currency. This makes cost tracking easier as all costs will be measured in the same (default) currency, but items can still be purchased in an alternative currency. </p><p><br></p><p>To enable this functionality head to Configuration > Billing > Currency, enable 'Enable Purchase Currency'. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjdiZTQyMDRiLTQ5OTgtNGJhMi04NzQ1LThmYzk2YWJhNGIwMyJ9.U9H6Qn8o8trPZqme8_w9Zlg_2J4w4z5Rzf_s48g1y88" class="fr-fic fr-fil fr-dib" width="898" style="width: 900px; height: 507.102px;" height="507"></p><p><strong><span style="font-size: 10pt;">Fig 14. setting to enable purchase currency </span></strong></p><p><br></p><p>Once enabled you will have an additional option against quotation lines called 'Purchase Currency'. Here, you can choose the currency this item is purchased in. When a currency is selected (that is your non-default currency), an additional field will become available called 'Cost in the selected Purchase Currency'. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjM5MWUyMmM2LTQwNzktNDA5OS1hMDM1LWU3ZDJlZjZhMDQ3YyJ9.Lcj_aSBbkYGDH7_sK9TM5zncbBuK_ARog47w-UJQYik" class="fr-fic fr-fil fr-dib" width="880" height="671"></p><p><strong><span style="font-size: 10pt;">Fig 15. Purchase currency setting</span></strong></p><p><br></p><p><strong>Cost in the selected Purchase Currency</strong> - This field will be populated with the cost of the item in your chosen currency. By default this will be taken from the cost set against the item. If the cost you have against the item is the cost in your default currency, not the cost in the purchase currency, you will need to update this field. This field should contain how much the item costs to purchase in the chosen currency.</p><p><strong>Cost </strong>- This field will be populated with the cost of the item in your default currency. This will re-calculate automatically based on the 'Cost in the selected Purchase Currency', converting in line with the current exchange rate. This field is used for cost tracking metrics, therefore should contain the item cost in your default currency. </p><p><br></p><p>Once you have set the costs accordingly the cost of this line item will show in your chosen currency. </p><p><br></p><p>The "Update Purchase Currency" button shown at the top of quotes will update the cost based on currency conversions. Both cost and price can adjust based on these rates by enabling "Enable Currency Update for Cost and Price" in Configuration > Billing > Currency. This will replace the button with one named "Update Currency".</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjZiYmU5OGUxLWI4YmUtNDYzMS05ODE5LTI4M2EzMDFiMjIxNCJ9.BPtcd_A804Mx23TUdeQwtOFfupJaQuNeIh82umvT-io" class="fr-fic fr-fil fr-dib" width="1308" style="width: 1310px; height: 645.519px;" height="646"></p><p><strong><span style="font-size: 10pt;">Fig 16. Cost against quote</span></strong></p><p><br></p><p><strong><em>Note: The price will still use your default currency as this is the currency you are selling (not purchasing) the item at. </em></strong></p><p><br></p><p>When a sales order is raised from this quote the cost currency will carry over automatically. The chosen purchase currency for this line will not be editable against the purchase order but you will be able to edit the cost in the selected Purchase Currency. </p><p><br></p><p>If required, a purchase order can be raised from this sales order. Both the cost and currency from the sales order will be pulled through to the purchase order automatically.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImVjMjFmMGQ5LTdlZjYtNDhjZi1iNGJhLTMxYjU5ZGE3NjBkZSJ9.8agKy56HOdYP2k-w4SMTsGrsXjvxJp_4sFDfaILgbK4" class="fr-fic fr-fil fr-dib" width="1360" style="width: 1362px; height: 582.223px;" height="582"></p><p><strong><span style="font-size: 10pt;">Fig 17. Cost and currency pulled through to PO </span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Sales Currency (v2.232+)</span></strong></p><p><span style="font-size: 11pt;">From v2.232+ sales currency can be enabled for products, this allows you to set the price of a product in a currency that is different from your default (native) currency. Useful for products that you buy in your non-native currency but re-sell in various currencies as, unlike pricing overrides, this calculates the sale price of the item using the current conversion rate.</span></p><p> </p><p><span style="font-size: 11pt;">To use sales currency, enable this globally under Configuration > Billing > Currency > enable "Enable Sales Currency". </span></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImZiNzk4OGM0LWY4ZTctNDg3YS1iMjYyLWI1MTY2ZTVmMmZlMyJ9.NJkZh8rqOwuWHbJMGC7fVO-SapGivRdbY8WxPUKJzvQ" class="fr-fic fr-fil fr-dib" width="989" style="width: 991px; height: 773.484px;" height="773"></p><p><strong><span style="font-size: 10pt;">Fig 18. Enable Sales Currency </span></strong></p><p><br></p><p>Now, against each product a new field will be available called "Sales Currency". This is found under the Billing tab of the product. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjlhNTc0MjRjLWZlYzYtNGIwMS05YzAxLTI0N2QzZGJlOThhNCJ9.OmObZHd9XHk8Y79DvCIIPTMeuFs9UlIrYzd52ayglYY" class="fr-fic fr-fil fr-dib" width="1580" style="width: 1582px; height: 698.048px;" height="698"></p><p><strong><span style="font-size: 10pt;">Fig 19. Sales Currency for Product</span></strong></p><p><br></p><p>In this field choose the currency you would like to set the sales price of the item in. In the Figure 19 example I have chosen Dollar therefore the price entered in the "Price" field for the product should be the price in Dollars. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjhhNjc2ODA1LTFjYmMtNGViOC04ZWRlLWM1OTQ4Zjk2ZTA0NCJ9.8F9FqwyLUDHlAtn6JCgyUzwGZSu6RMnXsHwOToB5GrU" class="fr-fic fr-fil fr-dib" width="740" style="width: 742px; height: 508.299px;" height="508"></p><p><strong><span style="font-size: 10pt;">Fig 20. Price of Product (in Dollars)</span></strong></p><p><br></p><p>Now, when this product is added to a quote/sales order/invoice the price shown will be calculated based on this price being converted to the chosen currency. Using the Figure 20 example, if I raise a quote for this product and set the currency to be GBP, the price shown will be the price of the item converted from Dollars into Pounds (based on the current conversion rate). </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImRlZmQ1NzE2LTcwZDYtNDFiMC1iNGIzLTYzMjU0ZTA4ODhiZiJ9.mI702rZWKSe9khYXIAfJ_8pxpTUa4BIlfTHbtNEguTg" class="fr-fic fr-fil fr-dib" width="2138" style="width: 2140px; height: 918.245px;" height="918"></p><p><strong><span style="font-size: 10pt;">Fig 21. Price of line converted from sales currency to chosen currency</span></strong></p><p><br></p><p>If this product is being quoted in dollars, the price will be $40 as this is the base price of the product. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImMyMDkwMjk2LTk4ZjMtNGVjOC1iZjVkLWI3ZTNmYzI2MjE3NyJ9.PBWYTXINOmZYoPpImqh5O_hiLvKA9W-SfCvU2Oaw1Bs" class="fr-fic fr-fil fr-dib" width="1876" style="width: 1878px; height: 802.821px;" height="803"></p><p><strong><span style="font-size: 10pt;">Fig 22. Price of line in sales currency</span></strong></p><p><br></p><p>Keep in mind, Halo currently only stores conversion rates relative to the native currency. This means two conversion calculations will be completed in order to obtain the price of an item when sales currency is in use, and the item is being sold in a different, non native, currency. For example, if the native currency is Pounds and the sales currency for an item is Dollars, when the item is sold in euros the price will be calculated by converting Dollars -> Pounds and then Pounds -> Euros. </p><p><br></p><p><strong><span style="font-size: 12pt;">Sales Currency and Price Overrides</span></strong></p><p data-pasted="true">If using sales currency for an item, any price overrides set for the item will be assumed to be in the sales currency. For example if the sales currency of a product is in dollars the price entered as part of the price override will be assumed to be dollars. </p><p><br></p><p>However, if the price override uses currency as the criteria for the override the price entered will be assumed to be the price in the currency selected. In the Figure 23 example if a quote/sales order/invoice is raised in Euros the product will be priced at €45. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjkwZmMzNDdjLWM2YmYtNDJhMC1hOWMwLTE1ZWI4MWI1NzVkOSJ9.ecRHWICgQDz4vOnPOf-kAMBhJreBxdyE5IfEZi0_BfM" class="fr-fic fr-fil fr-dib" width="610" style="width: 612px; height: 472.793px;" height="473"></p><p><strong><span style="font-size: 10pt;">Fig 23. Price override based on Currency</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Syncing invoices to Xero using Multi-Currency </span></strong></p><p>Xero is a third party accounting application Halo integrates with to streamline the invoicing process. This next section only applies to Halo customers using the <a data-fr-linked="true" href="https://usehalo.com/halopsa/guides/1235" id="isPasted" target="_blank" rel="noopener noreferrer">Xero Integration</a>, however, may give you an insight into how multi-currency may interact with you integrated accounting tool. </p><p><br></p><p>If you are using multi-currency and Xero first ensure you have multi-currency setup in both your Xero and Halo instance. Ensure you have enabled the setting 'Apply currency and conversion for Invoices' against your Xero integration setup in Halo. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjgzNDk3NzM0LTkwNjctNGYxNi1iMDBhLTdkNWM5NzEyYjYxMyJ9.6F-_UA2buwtEeeFKNzoMyc-1U39rkTCgEBPCBXxh6CY" class="fr-fic fr-fil fr-dib" width="756" style="width: 758px; height: 554.634px;" height="555"></p><p><strong><span style="font-size: 10pt;">Fig 24. Apply currency and conversion for invoices </span></strong></p><p><br></p><p>When this is enabled the currency and converted value against the invoice in Halo will be sent to Xero. Invoices can be created and sent from Halo using the chosen currency, converted using exchange rates from Halo. When synced to Xero the invoice will be created in the currency set in Halo, with already converted values (Xero exchange rates will not be used). For more information on our Xero integration see our guide <a data-fr-linked="true" href="https://usehalo.com/halopsa/guides/1235" id="isPasted" target="_blank" rel="noopener noreferrer">here</a>. </p><p><br></p>
