Konfiguracja usługi pobierania kursów walut NBP

Narodowy Bank Polski publikuje API webowe (interfejsy webowe), dzięki którym użytkownicy mogą pobierać dane dotyczące wcześniejszych i bieżących kursów walut. W Dynamics 365 Business Central można w prosty sposób zdefiniować ustawienia umożlwiające korzystanie z API w celu pobierania i aktualizacji kursów wymiany.

Podstawowa konfiguracja ustawień usługi

Aby zdefiniować ustawienia usługi pobierania i aktualizacji kursów wymiany walut i ją uruchomić:

  1. Wybierz ikonę Lightbulb that opens the Tell Me feature, wprowadź Usługi kursów wymiany walut, a następnie wybierz powiązane łącze.

  2. Na stronie Usługi kursów wymiany walut utwórz nową usługę kursu wymiany.

  3. Na stronie Usługa wymiany walut, która się otworzy, na skróconej karcie Ogólne uzupełnij następujące pola:

  • Kod - Określ nazwę kodu usługi wymiany walut.
  • Opis - Określ nazwę opisową usługi wymiany danych.
  1. Na skróconej karcie Serwis wypełnij adres URL dla API webowego w polu Adres URL usługi.
Uwaga

W przypadku API udostępnianego przez NBP, w polu Adres URL usługi wprowadź: http://api.nbp.pl/api/exchangerates/tables/A?format=xml

  1. Na skróconej karcie Mapowanie pola zmapuj wymienione poniżej pola, wprowadzając odpowiednie wartości w kolumnie Źródło.

  • Nadrzędny węzeł dla kodu waluty - /ArrayOfExchangeRatesTable/ExchangeRatesTable/Rates/Rate

  • Kod waluty - /ArrayOfExchangeRatesTable/ExchangeRatesTable/Rates/Rate/Code

  • Data początku obowiązywania - /ArrayOfExchangeRatesTable/ExchangeRatesTable/EffectiveDate

  • Kurs wymiany - Pozostaw pole Źródło puste i wypełnij pole Wartość domyślna liczbą 1.

  • Relacyjny kurs wymiany - /ArrayOfExchangeRatesTable/ExchangeRatesTable/Rates/Rate/Mid

  • Numer tabeli kursu wymiany - /ArrayOfExchangeRatesTable/ExchangeRatesTable/No

Reguła transformacji dla różnicy czasowej

Ponieważ tabela kursu wymiany walut publikowana przez NBP obowiązuje od dnia następującego po dacie określonej w tabeli w polu Data początku obowiązywania, konieczne jest przygotowanie reguły transformacji obsługującej tę różnicę czasową. Aby utworzyć i zdefiniować regułę transformacji:

  1. W wierszu zawierającym etykietę Data początkowa, w polu Reguła transformacji z listy rozwijanej wybierz Nowy.

  2. Na stronie Karta reguły transformacji wypełnij niezbędne pola zgodnie z poniższą instrukcją:

  • Kod - Wprowadź ONE DAY FORWARD.
Uwaga

Jeśli w polu Kod zostanie wprowadzony inny kod, transformacja nie powiedzie się.

  • Opis - Wprowadź Zmień datę na dzień do przodu.
  • Typ transformacji - Wybierz opcję Niestandardowy.
Uwaga

Aby przetestować transformację, wprowadź datę w formacie RRRR-MM-DD w polu Testowy tekst i kliknij przycisk Aktualizuj.

  1. Zamknij stronę, klikając przycisk OK.
Uwaga

Na stronie Konfiguracja z pomocą została dodana funkcja Ustaw usługę kursów wymiany NBP. Umożliwia ona użytkownikowi dodanie usługi kursów wymiany walut z predefiniowanymi adresami URL, wskazującymi na serwisy Narodowego Banku Polskiego. Wymagana reguła transformacji ONE DAY FORWARD również zostanie dodana przez system automatycznie.

Aktywacja usługi

Aby aktywować skonfigurowaną usługę pobierania kursów wymiany walut:

  1. Na skróconej karcie Ogólne na stronie Usługa wymiany walut zaznacz pole Włączone. W ten sposób aplikacja utworzy zapis kolejki zleceń, w którym codziennie będą pobierane kursy wymiany walut ze zdefiniowanego źródła.

Dodatkowe opcje konfiguracyjne

Dostępnych jest kilka opcji umożliwiających dostosowanie funkcjonalności do potrzeb użytkownika.

Kurs wymiany dla kwoty różnej od 1

Niektóre firmy określają kurs wymiany dla kwoty wymiany równej 100. Aby ustawić kurs wymiany walut dla różnych kwot wymiany:

  1. Zdefiniuj ustawienia podstawowe opisane w sekcji Konfiguracja usługi wymiany walut, ale nie aktywuj usługi.

  2. Na skróconej karcie Mapowanie pola, w wierszu zawierającym etykietę Kurs wymiany, w polu Wartość domyślna, ustaw odpowiednią wartość.

  3. Na skróconej karcie Mapowanie pola, wybierz na wstążce Definicje schematu wymiany danych.

  4. Na nowo otwartej stronie Definicja schematu wymiany danych, na skróconej karcie Definicje wierszy, wybierz na wstążce Mapowanie pola.

  5. Na nowo otwartej stronie Mapowanie pola, na skróconej karcie Mapowanie pola, w wierszu zawierającym etykietę Kurs wymiany, wypełnij pole Mnożnik (pole jest standardowo niewidoczne na stronie) dla relacyjnego kursu wymiany walut, wprowadzając tą samą wartość, co wpisana w kroku 2.

  6. Aktywuj usługę wymiany danych.

Przechwytywanie danych historycznych

Interfejs wymiany walut API ułatwia pobieranie kursów obowiązujących w przeszłości.

Aby pobrać dane historyczne dotyczące kursów wymiany walut NBP:

  1. Wyłącz usługę wymiany walut na stronie Usługa wymiany walut i ustaw adres URL usługi na http://api.nbp.pl/api/exchangerates/tables/A/startDate/endDate?format=xml.

  2. Określ okres, definiując daty startDate i endDate w formacie RRRR-MM-DD. Okres nie może być dłuższy od 93 dni.

  3. Po ustawieniu adresu URL włącz usługę.

  4. Użyj akcji Aktualizuj kursy wymiany na stronie Waluty, aby zaktualizować kursy wymiany dla określonych dat, a następnie przywrócić pierwotny adres URL usługi.