Zum Inhalt springen

OBS/Stammdaten/Schnittstellen/Internet-Shop/brShop24/PDF-Druck Artikellink

Aus OBS Wiki
Version vom 3. November 2026, 16:25 Uhr von MINERVA-Nimz (Diskussion | Beiträge) (Neue Seite zum Menüpunkt „PDF-Druck Artikellink“ der Schnittstelle brShop24 (Neuaufbau Internet-Shop) [Styleguide-Abweichung: Linkziele folgen in derselben Welle])
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)

PDF-Druck Artikellink

Verschicken Sie Angebote als E-Mail mit PDF-Anhang oder als PDF-Export (Druckauswahl Export), kann OBS zu jedem Artikel einen Link auf den Artikel in Ihrem brShop24 einfügen. Ihre Kunden kommen so mit einem Klick vom Angebot in den Shop. Diese Seite zeigt, wie Sie den Link einrichten.

HINWEIS: Die Standardformulare drucken den Link nur bei Angeboten und nur, wenn Sie das Angebot per E-Mail versenden oder in eine PDF-Datei exportieren. Den Link setzt OBS fett unter die Beschreibung der Position. Beim Druck auf Papier und in anderen Belegarten erscheint er nicht. In eigenen Druckformularen können Sie ihn selbst einbauen, siehe In eigenen Druckformularen.

Druckauswahl mit E-Mail und Export

Voraussetzungen

  • Die brShop24-Schnittstelle ist aktiv.
  • Der Artikel steht im Shop, und OBS hat ihn als Shop-Artikel erkannt. Das Lager des Artikels ist aktiv, und der Artikel ist im Shop weder gelöscht noch inaktiv.

OBS verlinkt mit dem Kurzlink. Das ist Ihre Shop-URL mit dem Pfad artnr und der Artikelnummer, z.B. https://<Ihr-Shop>.brshop24.de/artnr/BROTN2320. In OBS hinterlegen Sie die URL mit dem Platzhalter $REFERENZ für die Artikelnummer, z.B. https://<Ihr-Shop>.brshop24.de/artnr/$REFERENZ. Setzen Sie dabei die Adresse Ihres Shops ein. Sie ist individuell und wird zwischen Ihnen und Büroring festgelegt. Üblich ist <Mitgliedname>.brshop24.de, andere Adressen sind möglich.

ACHTUNG: Ein Kurzlink enthält nur die Artikelnummer. Eine Artikelnummer ist im Shop aber nur je Lager eindeutig. Gibt es dieselbe Nummer in mehreren Lagern, kann der Link auf den falschen Artikel führen. Nutzen Sie eigene Artikel und diese Funktion, achten Sie darauf, dass Ihre Artikelnummern im ganzen Shop eindeutig sind.

Vorgehen

Den Link stellen Sie in der Konfiguration der Schnittstelle mit der Einstellung Allgemein.Kurzlink.Artikel ein. Sie erreichen sie über Stammdaten → Schnittstellen → Internet-Shop, F10 X Konfiguration. Sie haben zwei Möglichkeiten:

  • URL als Text: Die URL erscheint so, wie sie ist, im Ausdruck.
  • Textbaustein mit Hyperlink: Ein Text oder eine Grafik Ihrer Wahl erscheint im Ausdruck und führt zum Artikel.

Variante 1: URL als sichtbarer Text

  1. Öffnen Sie in der Konfiguration die Einstellung Allgemein.Kurzlink.Artikel.
  2. Tragen Sie die URL mit dem Platzhalter ein, z.B. https://<Ihr-Shop>.brshop24.de/artnr/$REFERENZ.
  3. Sichern Sie mit F2.

Einstellung Allgemein.Kurzlink.Artikel mit URL

Variante 2: Textbaustein mit Hyperlink

Im Textbaustein können Sie einen Text oder eine Grafik zum Hyperlink machen.

  1. Legen Sie einen Textbaustein an und schreiben Sie den Text, der im Ausdruck erscheinen soll. Für eine Grafik fügen Sie sie über die RTF Texteigenschaften mit dem Bild-Symbol ein oder kopieren sie mit Strg+C und Strg+V in den Text.
  2. Markieren Sie den Text oder die Grafik, die zum Link werden soll.
  3. Klicken Sie auf die Schaltfläche für Hyperlinks (Kugel mit Kette).
  4. Tragen Sie im Feld Ziel die URL mit dem Platzhalter ein, z.B. https://<Ihr-Shop>.brshop24.de/artnr/$REFERENZ.
  5. Speichern Sie den Textbaustein.
  6. Tragen Sie die Nummer des Textbausteins in die Einstellung Allgemein.Kurzlink.Artikel ein und sichern Sie mit F2.

So sieht ein Textbaustein mit Text und mit Grafik als Hyperlink aus:

Textbaustein mit Text als Hyperlink

Textbaustein mit Bild als Hyperlink

Das Fenster für den Hyperlink:

Hyperlink einfügen mit dem Feld Ziel

ACHTUNG: Verwenden Sie eine Grafik als Hyperlink, muss der Textbaustein außer der Grafik noch ein weiteres Zeichen enthalten, sonst wird der Text nicht gespeichert. Fügen Sie z.B. ein Leerzeichen hinter der Grafik ein.

Grafik mit Hyperlink und folgendem Leerzeichen

Die Einstellung mit der Nummer des Textbausteins:

Einstellung Allgemein.Kurzlink.Artikel mit Textbausteinnummer

HINWEIS: Gibt es einen Textbaustein mit der eingetragenen Nummer, verwendet OBS den Textbaustein. Sonst verwendet OBS den Eintrag selbst als Text.

Lager priorisieren

Steht ein Artikel in mehreren Lagern, legen Sie fest, welches Lager OBS für den Link bevorzugt. OBS verwendet die Artikelnummer aus dem Lager mit der höchsten Priorität.

  1. Öffnen Sie in der Konfiguration mit F8 L Lager und Lagerlieferanten.
  2. Markieren Sie das Lager und drücken Sie  ↩ Enter.
  3. Tragen Sie im Feld Priorisierung Link eine Zahl ein. Standard ist 0. Je höher die Zahl, desto eher wird das Lager verwendet.
  4. Sichern Sie mit F2.

Haben mehrere Lager dieselbe Priorität, verwendet OBS das Lager mit der kleinsten Lager-ID. Mehr zur Maske steht unter L Lager und Lagerlieferanten.

Artikel ausnehmen

Soll für einen Artikel kein Link im PDF erscheinen, hinterlegen Sie beim Artikel die Eigenschaft 9207 SHOP Keinen Link setzen.

Eigenschaft 9207 beim Artikel
  1. Öffnen Sie den Artikel im Artikelstamm.
  2. Fügen Sie bei den Eigenschaften die Eigenschaft 9207 SHOP Keinen Link setzen hinzu.
  3. Sichern Sie den Artikel.

In eigenen Druckformularen

Für eigene Druckformulare, z.B. für andere Belegarten, steht in den Druckscripten die Funktion GetArtLinkText zur Verfügung:

cShopLink := GetArtLinkText(oDB, '', AZ_Query.A2C('az_artnr'));
  • Der erste Parameter ist die Datenbankverbindung des Druckscripts.
  • Der zweite Parameter ist die Nummer der Shop-Schnittstelle. Bleibt er leer, nimmt OBS die erste aktive brShop24-Schnittstelle, die für den Artikel einen Link liefert.
  • Der dritte Parameter ist die OBS-Artikelnummer.

Die Funktion liefert den Inhalt von Allgemein.Kurzlink.Artikel bzw. des Textbausteins, mit der Shop-Artikelnummer anstelle von $REFERENZ. Sind die Voraussetzungen für den Artikel nicht erfüllt oder hat er die Eigenschaft 9207, liefert sie einen leeren Text. Wo und wie der Link im Formular erscheint, legen Sie im Druckscript fest.

Ergebnis

Im PDF steht bei jedem Artikel, der im Shop vorhanden ist, der Link zum Artikel. Mit Variante 1 ist es die URL, die der PDF-Export automatisch klickbar macht:

PDF mit URL zum Artikel

Mit Variante 2 ist es Ihr Text oder Ihre Grafik:

PDF mit Text als Hyperlink

PDF mit Bild als Hyperlink

Wenn es nicht klappt

Beobachtung Ursache
Bei keinem Artikel erscheint ein Link. Die Schnittstelle ist nicht aktiv, oder Allgemein.Kurzlink.Artikel ist leer. Oder der Beleg ist kein Angebot bzw. wurde nicht per E-Mail oder als PDF-Datei ausgegeben.
Bei einem Artikel fehlt der Link. Der Artikel steht nicht im Shop, ist dort gelöscht oder inaktiv, sein Lager ist nicht aktiv, oder er hat die Eigenschaft 9207.
Der Link führt zum falschen Artikel. Dieselbe Artikelnummer gibt es in mehreren Lagern. Machen Sie die Artikelnummern eindeutig oder legen Sie die Priorität der Lager fest.
Statt des Textbausteins erscheint seine Nummer. Einen Textbaustein mit dieser Nummer gibt es nicht.

Siehe auch