# Beispiel: Automatisch Rohstoffkurse aktualisieren (über kostenpflichtigen Service)  

<span class="custom-button petrol-button">XL</span> <span class="custom-button red-button">Gen. 24 Core und Enterprise</span>

In diesem Artikel beschreiben wir den kompletten einzurichtenden Ablauf für eine automatische Aktualisierung der Rohstoffpreise in microtech büro+.

!!! warning "Beachten Sie:"

    Voraussetzung für das automatische Einladen ist die Registrierung eines **kostenpflichtigen** Service bei einem Drittanbieter. Bitte informieren Sie sich im Vorfeld bei einem der verfügbaren Drittanbieter über anfallende Kosten und Details des Zugangs.
    
    Folgende Drittanbieter lassen sich für die automatische Aktualisierung der Rohstoffpreise nutzen:
    
    * Der Drittanbieter "**MetalPriceApi**" steht ab **Build 6950** mit der "**Gen. 24 Core**" und höher als WebContentDienst mittels Kennzeichen zur Auswahl.
    * Der Drittanbieter "**XmlCharts**" steht ab Ausbaustufe "**XL**" sowie ab "**Gen. 24 Core**" als WebContentDienst mittels Kennzeichen zur Auswahl.

Als Inhaber eins Handelsunternehmens für den An- und Verkauf von Edelmetallen ist es sinnvoll, stets die aktuellen Kurse für Gold und Silber um wettbewerbsfähig zu sein. Diese Rohstoffkurse können mittels XML-Feed automatisiert in microtech büro+ eingeladen werden. Dies erspart die Eingabe von Hand und ist somit weniger zeitintensiv und fehleranfällig, da Tippfehler vermieden werden.

Folgende Rohstoffkurse können über genannte Drittanbieter **kostenpflichtig** in microtech büro+ eingeladen werden:

* Silber
* Gold
* Platin
* Palladium

Die Bezeichnungen sind für Zuordnung bei Online-Aktualisierung genauso so wie oben beschrieben festzulegen. Die Kurse werden im Bereich: PARAMETER - SONSTIGE - ROHSTOFFKURSE gespeichert.

## Einstellungen in den Parametern

Unter PARAMETER - SONSTIGE - ROHSTOFFKURSE sind die Rohstoffkurse zu erfassen. Die Anlage erfolgt über die Schaltfläche: NEU.

![Alt-Text](https://assets.hilfe.microtech.de/bilder/04_modul%C3%BCbergreifend/prozessautomatisierung/beispiele/glautaufgabenbeispielerohstoffkurseaktualisieren_1.png)

!!! danger "Beachten Sie:"

    Der korrekte Name ist für die Zuordnung bei einer Online-Aktualisierung essentiell.
    
    Bei der Neuanlage wird das Fenster "Rohstoffkurs neu erfassen / ändern" geöffnet: Legen Sie Rohstoffkurse mit den folgenden Namen an:
    
    * **Silber**
    * **Gold**
    * **Platin**
    * **Palladium**
    
    Diese Namen müssen exakt diese Schreibweise aufweisen, damit sie bei Online-Aktualisierungen korrekt zugeordnet werden.

Als Bezeichnung vergeben Sie einen kurzen, prägnanten Text, z. B. "Silber" oder "Akt. Silber-Kurs" (dieser Eintrag wird später im Rohstoff-Artikel als Auswahlfeld angezeigt).

Im Feld: "Wert" wird über den automatischen Abgleich mit den kostenpflichtigen Online-Service der Wert eingetragen, im Feld: "Stand" wird eingetragen, wann der Anbieter das letzte mal seine Daten aktualisiert hat.

![Alt-Text](https://assets.hilfe.microtech.de/bilder/04_modul%C3%BCbergreifend/prozessautomatisierung/beispiele/glautaufgabenbeispielerohstoffkurseaktualisieren_2.png)

<span class="custom-button red-button">Gen. 24 Core und Enterprise</span>

## API-Key in den Parametern innerhalb der Zugangsdaten hinterlegen (MetalPriceApi)

Sofern Sie sich bei dem Anbieter "MetalPriceApi" angemeldet haben, um die Rohstoffkurse abzurufen, benötigen Sie einen "Api Key" des Anbieters, um die Rohstoffkurse automatisch abrufen zu können.

Tragen Sie diesen in der Software ein. Rufen Sie hierzu über die Schaltfläche: PARAMETER - SONSTIGE - ZUGANGSDATEN auf. Über die Schaltfläche: NEU erfassen Sie einen Zugangsdaten-Datensatz. Wählen Sie als "Art der Zugangsdaten": "**MetalPriceApi**". Auf dem Register: EINSTELLUNGEN innerhalb der Maske steht das Feld: "Api Key" zur Verfügung. Kopieren Sie an dieser Stelle den vom Drittanbieter erhaltenen Key ein.

Über die Schaltfläche: TESTEN können Sie einen Verbindungstest durchführen. Aktivieren Sie im Anschluss das Kennzeichen: AKTIV, um diesen Zugang nutzen zu können. Speichern & schließen Sie im Anschluss die Maske für die Zugangsdaten sowie die Maske für die Parameter.

![Alt-Text](https://assets.hilfe.microtech.de/bilder/04_modul%C3%BCbergreifend/prozessautomatisierung/beispiele/glautaufgabenbeispielerohstoffkurseaktualisieren_3.png)

<span class="custom-button petrol-button">XL</span> <span class="custom-button red-button">Gen. 24 Core und Enterprise</span>

## Anlegen einer Automatisierungsaufgabe für die Online-Aktualisierung

Wechseln Sie in den Bereich: MEINE FIRMA - ÜBERBLICK - AUTOMATISIERUNGSAUFGABEN. Stellen Sie sicher, dass der Automatisierungs-Dienst verfügbar und korrekt eingerichtet ist ([Prozessautomatisierung (Automatisierungsaufgaben)](../index.md)).

1. Erfassen Sie über die **Schaltfläche: "NEU" eine frische Automatisierungsaufgabe** - Als Bezeichnung und Suchbegriff wählen Sie z. B. "Rohstoff-Kurse aktualisieren"
2. Wählen Sie eine kontinuierliche Ausführung mit einer Pausenzeit zwischen den Aktualisieren, z. B. **Pausezeit: 5 Min** 3.  Über einen Doppelklick in die Tabelle "**Aktionen**" öffnet sich die Erfassungsmaske für die Aktionen 4.  Wählen Sie als Art über das **Auswahlfeld "Web Content Dienste"** 5.  Aktivieren Sie für die Wahl Ihres Drittanbieters das Kennzeichen: "**XmlCharts**" bzw. das Kennzeichen: "**MetalPriceApi**" (Das Kennzeichen für die "MetalPirceApi" ist verfügbar ab "Gen. 24 Core") 6.  **Speichern und schließen Sie alle Angaben**

!!! warning "Beachten Sie:"

    Wir empfehlen jeweils nur die Preise eines Anbieters abzurufen, da die Dienste unterschiedliche Update-Zyklen seitens des Anbieters besitzen und sich somit die Werte immer wieder durch den letzten Dienst überschrieben werden.

![Alt-Text](https://assets.hilfe.microtech.de/bilder/04_modul%C3%BCbergreifend/prozessautomatisierung/beispiele/glautaufgabenbeispielerohstoffkurseaktualisieren_4.png)

!!! warning "Beachten Sie:"

    <span class="custom-button red-button">Gen. 24 Core und Enterprise</span>
    
    ### MetalPriceApi: Zusätzliche notwendige Angaben im Aktionen-Datensatz der Automatisierungsaufgabe (Gen. 24 Core)
    
    Sofern Sie die "MetalPriceApi" nutzen, sind im Feld: "**Zusätzliche Daten**" zusätzliche Parameter zu hinterlegen.
    
    Beispiel:
    
    ```dotnetcli
    WebContentDiensteList=2
    Base=EUR
    currencies=XAG,XAU,XPT,XPD
    ```
    
    Dabei steht "XAG" für Silber, "XAU" für Gold, "XPT" für Platinum, "XPD" für Palladium.
    
    ### MetalPriceApi: Gramm statt Unze verwenden (Gen. 24 Core)
    
    Über die Parametrisierung mittels des Feldes: "Zusätzliche Daten" lassen sich weitere Einstellungen vornehmen. So lässt sich z. B. auch einstellen, dass der Wert für Gramm statt Unze ausgegeben wird.
    
    Beispiel:
    
    ```dotnetcli
    WebContentDiensteList=2
    Base=EUR
    currencies=XAG,XAU,XPT,XPD
    unit=gram
    ```
    
    Weitere Informationen unter folgenden externen Links:
    
    * [https://metalpriceapi.com/currencies](https://metalpriceapi.com/currencies "Verknüpfung folgen") (Externer Link)
    * [https://metalpriceapi.com/documentation#api\_realtime](https://metalpriceapi.com/documentation#api_realtime) (Externer Link)
    
    ![Alt-Text](https://assets.hilfe.microtech.de/bilder/04_modul%C3%BCbergreifend/prozessautomatisierung/beispiele/glautaufgabenbeispielerohstoffkurseaktualisieren_5.png)

Die Automatisierungsaufgabe ist nun angelegt und kann getestet werden. In den Rohstoffparametern sollten die Werte nun anhand des gewählten Aktualisierungsintervalls gefüllt werden. Durch den Zeitstempel des Parameter-Datensatzes sehen Sie jeweils, wann die letzte Aktualisierung erfolgte.

<span class="custom-button petrol-button">XL</span> <span class="custom-button red-button">Gen. 24 Core und Enterprise</span>

## Einstellungen auf dem Register: VK-PREISE im Artikel-Datensatz

Wenn ein Rohstoffkurs angelegt ist, wird in Artikel-Datensätzen der **Artikelart: "Rohstoffkurs-Artikel"** (Register: VK-PREISE) das **Auswahlfeld "Preise über Rohstoffkurs"** angezeigt.

Wählen Sie für Ihre Rohstoff-Artikel den jeweils passenden Eintrag. Für "GOLD" z. B. über das Auswahlfeld "Preise für Rohstoffkurs" den Gold-Kurs.

![Alt-Text](https://assets.hilfe.microtech.de/bilder/04_modul%C3%BCbergreifend/prozessautomatisierung/beispiele/glautaufgabenbeispielerohstoffkurseaktualisieren_6.png)

!!! warning "Beachten Sie:"

    Wenn das das **Feld: "Preise über Rohstoffkurs"** durch Auswahl eines Eintrags aktiviert wird, wird eine **manuelle Preisanpassung nicht mehr gespeichert. Sonderpreise bleiben weiterhin vollumfänglich gültig.**

### Preise für Rohstoff-Kurs unabhängig des Artikel-VK-Preis im Lieferanten-Datensatz einstellen

In der Eingabe für die Artikel-Lieferanten kann die Auswahl für die Preise unabhängig der Eingabe des Artikel-VK-Preis hinterlegt werden. Über das Auswahlfeld stehen die in den Parametern eingestellten Werte zur Verfügung. Über das Tabellenfeld "**Zuschlag in €**" lässt sich beim Einkauf eines Rohstoffs die Differenz zum Rohstoffkurs und zum effektiven Einkaufspreis im **Artikel-Lieferanten-Datensatz** erfassen.

Beispiel:

Sie besitzen ein Geschäft für den Goldankauf. Ihre Kunden treten somit auch als Lieferanten auf.

Wenn ein Kunde Ihnen z. B. einen Ring aus Gold verkaufen möchte, ist dieser als Lieferant zu erfassen.

**Über Zuschläge können Sie den Preis für den Rohstoff-Artikel berechnen. Sprich: Für welchen effektiven EK Sie den Rohstoff ankaufen möchten.**

Die Daten des Kunden, wie Anschrift, Personalausweisnummer, Telefon, etc., notieren Sie in büro+ und speichern diese.

![Alt-Text](https://assets.hilfe.microtech.de/bilder/04_modul%C3%BCbergreifend/prozessautomatisierung/beispiele/glautaufgabenbeispielerohstoffkurseaktualisieren_7.png)

### Tabelle Vorgangspositionen anpassen

Mithilfe des Gestalters können Sie die Tabellenansicht z. B. um folgende Felder anpassen:

* Artikel → Rohstoffkurs **Art.RskNr**
* Artikel → Lieferant → Rohstoffkurs **Art.Lief.RskNr**

Weitere Informationen zum Gestalten der Tabelle in unserer Online-Hilfe: [Tabellenansichten gestalten und Eigenschaften der Tabellenansichten](.././../die%20grundlagen%20der%20hauptmasken/tabellenansicht/gestaltung/index.md).

![Alt-Text](https://assets.hilfe.microtech.de/bilder/04_modul%C3%BCbergreifend/prozessautomatisierung/beispiele/glautaufgabenbeispielerohstoffkurseaktualisieren_8.png)
