Trillium UAT - Configure external exchange rate provider

Trillium UAT - Configure external exchange rate provider

Links

Test environment: https://folio-edev-thunderjet-diku.ci.folio.org/

Test credentials: exchange_uat/uat

Jira feature: UXPROD-4883: Allow library to set alternate external exchange rate sourceClosed

Feedback form: https://forms.office.com/r/H0zEUXuCHY

Dates: August 4-8

Slack channel for UAT questions and discussion: #acquisitions-uat

Required permissions

Related videos

UAT Overview

Exchange rate config.mp4

 

Known Issues

 

Instructions

Configuration

  1. In the “Settings” app, select “Finance” → “Exchange rate source”

  2. Check the “Specify exchange rate provider” box

  3. Under “Exchange rate provider type” choose “treasury.gov”

  4. Under “Exchange rate provider URI” enter https://api.fiscaldata.treasury.gov/services/api/fiscal_service/v1/accounting/od/rates_of_exchange

  5. Leave all other fields blank and click “save”

Testing

  1. Create a new purchase order and purchase order line

  2. Under “Cost details” → “Currency”, choose a currency other than US Dollar. Do NOT check the “set exchange rate” box.

  3. Verify that the exchange rate automatically appears and that the exchanged value box shows the rate converted into USD. Note that when treasury.gov is used as the exchange rate source, the exchange rate will always appear as $1 USD = X foreign currency, but FOLIO will calculate foreign currency to USD.

  4. OPTIONAL: Exchange rates can be verified at https://fiscaldata.treasury.gov/datasets/treasury-reporting-rates-exchange/treasury-reporting-rates-of-exchange.

  5. OPTIONAL: You can change currencies at will as long as the order is pending in order to test multiple currency checks.

  6. Create a new invoice and invoice line related to the purchase order line.

  7. Verify the invoice exchange rate lookup is working correctly, as above. Again, feel free to experiment with multiple currencies.