Zielgruppe & Rolle

Rolle: Mandanten-Administrator / IT-Admin | Voraussetzung: Aktivierter USt-IdNr.-Check

Eingebettete Prüfansicht (microtech-Verlinkung)

Die eingebettete Prüfansicht zeigt den USt-IdNr.-Prüfstatus einer einzelnen Adresse oder eines einzelnen Vorgangs in einer kompakten Ansicht ohne Portal-Navigation. Sie ist dafür gedacht, direkt aus microtech büro+ heraus (z. B. als Internetverweis) oder in anderen Systemen aufgerufen zu werden.

Die Ansicht enthält:

• den aktuellen Prüfstatus inklusive Zeitpunkt der letzten Prüfung,
• bei EU-Auslandsprüfungen die BZSt-Rückmeldung und das Ergebnis der qualifizierten Adressprüfung (Firmenname, Straße, PLZ, Ort),
• die Prüfungshistorie der Adresse mit Zugriff auf jedes revisionssichere Prüfprotokoll,
• die Schaltfläche Jetzt prüfen, um sofort eine neue Prüfung anzustoßen.

1. URL-Schema

Es gibt je eine Ansicht für Adressen und für Vorgänge:

https://portal.mbcom.cloud/embedded/vat-validation/address/:addressNr?tenant=<TENANT>&customer=<CUSTOMER>

https://portal.mbcom.cloud/embedded/vat-validation/transaction/:transactionNr?tenant=<TENANT>&customer=<CUSTOMER>

Bestandteil	Pflicht	Beschreibung
:addressNr	Ja (Adressansicht)	Adressnummer aus microtech büro+ (AdrNr).
:transactionNr	Ja (Vorgangsansicht)	Belegnummer des Vorgangs aus microtech büro+ (BelegNr), z. B. VRE16-00042.
tenant	Ja	Mandantenkennung im Portal, z. B. MBCOM.
customer	Ja	Kundennummer im Portal, z. B. 10639.

Werte anpassen

<TENANT> und <CUSTOMER> sind systemabhängig und müssen durch die Werte des Zielsystems ersetzt werden. Bei einer abweichenden Portal-Adresse ist zusätzlich https://portal.mbcom.cloud anzupassen.

Beispiele

Adresse 10000 des Mandanten MBCOM (Kunde 10639):

https://portal.mbcom.cloud/embedded/vat-validation/address/10000?tenant=MBCOM&customer=10639

Vorgang VRE16-00042 desselben Mandanten:

https://portal.mbcom.cloud/embedded/vat-validation/transaction/VRE16-00042?tenant=MBCOM&customer=10639

Unterschiede zwischen Adress- und Vorgangsansicht

Ansicht	Angezeigtes Prüfergebnis	Jetzt prüfen
Adresse	Letzte Prüfung der Adresse.	Prüft die Adresse neu.
Vorgang	Prüfung, die diesem Beleg zugeordnet ist. Wurde ein vorhandenes Prüfergebnis innerhalb des Wiederverwendungsfensters übernommen, wird dies als Wiederverwendet aus Prüfung … gekennzeichnet. In der Historie ist der zugehörige Eintrag als Dieser Beleg markiert.	Prüft den Vorgang neu.

Ist für einen Vorgang noch keine Prüfung hinterlegt, zeigt die Vorgangsansicht den Hinweis Vorgang noch nicht geprüft sowie die bisherigen Prüfungen der zugeordneten Adresse. Über Jetzt für Vorgang prüfen kann die Prüfung direkt nachgeholt werden.

2. Anmeldung & Berechtigung

Die eingebettete Ansicht erfordert eine Anmeldung am ConnectPORTAL. Ist der Anwender im Browser noch nicht angemeldet, wird er zunächst zur Anmeldung geleitet und danach automatisch zur aufgerufenen Ansicht zurückgeführt.

Über tenant und customer wechselt das Portal automatisch in den angegebenen Mandanten. Der angemeldete Benutzer muss daher Zugriff auf genau diesen Mandanten haben.

Zusätzlich benötigt der Benutzer für den Mandanten die Berechtigung tenant:microtech-data:read, z. B. über die Rolle TENANT_DATA_VIEWER (siehe Berechtigungskonzept). Fehlt die Berechtigung, wird statt der Prüfansicht die Startseite des Portals geöffnet.

3. Einrichtung als Internetverweis in microtech büro+

Damit Anwender die Prüfansicht direkt aus büro+ öffnen können, wird – analog zum Workflowverlauf – eine Regel zur Aufbereitung von Internet-Links mit der Anweisungsart Internet- / Intranetverweis erzeugen angelegt. Der Link erscheint anschließend in der Detail-Ansicht Internetverweise der Adresse bzw. des Vorgangs.

Eigenschaft	Adressen	Vorgänge
Bezeichnung der Anweisung	Beispiel: USt-IdNr.-Prüfung	Beispiel: USt-IdNr.-Prüfung
Auswertungsposition	Zur Aufbereitung von Internet-Links für die Detail-Ansicht Internetverweise	Zur Aufbereitung von Internet-Links für die Detail-Ansicht Internetverweise
Linkformel	https://portal.mbcom.cloud/embedded/vat-validation/address/«Adr.AdrNr»?tenant=<TENANT>&customer=<CUSTOMER>	https://portal.mbcom.cloud/embedded/vat-validation/transaction/«Vog.BelegNr»?tenant=<TENANT>&customer=<CUSTOMER>

Beim Auswerten ersetzt microtech die Feldreferenz in Guillemets («…») durch die Adress- bzw. Belegnummer des aktuellen Datensatzes.

Prüfung nach der Einrichtung

Prüfung	Erwartung
Formel im Feldeditor testen	Die Testausgabe enthält die konkrete Adress- bzw. Belegnummer statt der Feldreferenz.
Link in den Internetverweisen öffnen	Das Portal öffnet die eingebettete Prüfansicht zur Adresse bzw. zum Vorgang.
Ansicht zeigt Prüfstatus konnte nicht geladen werden	tenant, customer, Portal-URL und die Berechtigung des angemeldeten Benutzers prüfen.
Ansicht zeigt Keine bisherige Prüfung vorhanden	Für den Datensatz liegt noch keine Prüfung vor; über Erste Prüfung durchführen kann sie angestoßen werden.