Etiketten aus Business Central drucken
Versand- und Barcode-Etiketten aus Dynamics 365 Business Central: Labelixa liest Ihre gebuchten Verkaufslieferungen über die Standard-API, füllt eine ZPL-Vorlage, zeigt das Etikett am Bildschirm und druckt es über den DirectPrint-Agenten.
Das Problem
Business Central erfasst die Lieferung, das Thermoetikett entsteht aber anderswo: Berichtslayouts erzeugen kein ZPL, eine Partnererweiterung ist teuer, und ob die Vorlage stimmt, zeigt sich erst am Drucker. Es fehlt eine Schicht, die Felder liest, das Etikett am Bildschirm zeigt und an den Drucker übergibt.
Was macht Labelixa?
Verbindung mit Entra-Identität
Sie legen im eigenen Mandanten eine App-Registrierung (Client Credentials) an und tragen Mandant, Umgebung und Unternehmens-ID in den Labelixa-Konnektor ein. Das Client-Secret wird verschlüsselt gespeichert und nie angezeigt.
Lieferfelder zuordnen
Felder des Datensatzes `salesShipments` — Empfänger, Adresse, Ort, Postleitzahl, Belegnummer — werden Etikettvariablen zugeordnet; nur zugeordnete Felder werden abgefragt.
Vorschau am Bildschirm
Das aus den Daten erzeugte ZPL wird in Originalgröße gerendert, der Barcode wird durch echtes Decodieren geprüft. Ein falsches Feld ist sichtbar, bevor Material verbraucht wird.
Druck über DirectPrint
Das fertige Etikett geht über den DirectPrint-Agenten an einen Zebra-kompatiblen Drucker im Netzwerk oder per USB; der Auftragsverlauf bleibt im Panel.
Beispieletikett
ZPL
^XA
^FO25,20^A0N,26,24^FDSHIP TO^FS
^FO25,52^A0N,22,20^FDTrey Research^FS
^FO25,80^A0N,20,18^FD153 Thomas Drive^FS
^FO25,106^A0N,20,18^FDChicago 61236^FS
^BY2,3,80^FO25,140^BCN,80,Y,N,N^FDS-SHPT102001^FS
^FO470,20^BXN,5,200^FDS-SHPT102001|Trey Research^FS
^XZ
Häufig verwendete Symbologien
Wie funktioniert der Etikettendruck aus Business Central?
- App-Registrierung in Entra ID anlegen: Business Central-API-Berechtigung (Application, API.ReadWrite.All) mit Admin-Zustimmung; Client-ID in BC auf der Karte Microsoft Entra Applications eintragen.
- Konnektor in Labelixa anlegen: Mandant, Umgebung, Unternehmens-ID, Ressource (salesShipments) und die Zuordnung der Lieferfelder zu den Variablen Ihrer Etikettenvorlage. Vorlage Versandetikett 4×6 · alle Etikettenvorlagen
- Ausführen: Lieferzeilen kommen zurück; erste Zeile mit der Vorlage rendern und Etikett samt Barcode am Bildschirm prüfen. ZPL-Viewer
- DirectPrint-Agent installieren, Drucker zuordnen, Auftrag senden. DirectPrint-Agent herunterladen
Gemessene Grenzen der Integration
Was wird gelesen?
Lieferköpfe werden über die Standard-API v2.0 von Business Central (`companies/{id}/salesShipments`) gelesen; die Abfrage fordert nur zugeordnete Felder an. In einer echten BC-Umgebung gemessen: 42 Felder je Datensatz, Seiten mit 200 Datensätzen.
Kein Rückschreiben
Die Integration liest nur. Ein Status "Etikett gedruckt" wird nicht nach Business Central geschrieben; dafür ist eine kleine AL-Erweiterung auf Kundenseite nötig, die mit dem Piloten entsteht. Nichts, was nicht funktioniert, wird versprochen.
Seitenumfang und Grenzen
Ein Aufruf verarbeitet höchstens 200 Datensätze und meldet, ob weitere vorliegen; eine einzelne Lieferung per Filter (Belegnummer) ist der typische Fall. Antwortgrenze 1 MB; darüber kommt ein klarer Fehler.
Sicherheit
Das Client-Secret liegt in einer AES-256-GCM-verschlüsselten Spalte und erreicht keine Leseoberfläche; ausgehende Anfragen durchlaufen Schema-, IP- und Weiterleitungsprüfung; Token und Kundendaten werden nicht protokolliert.
Zur API-Referenz →
Häufig gestellte Fragen
Funktioniert es mit Business Central On-Premises?
Bisher wurde nur Business Central online (api.businesscentral.dynamics.com) gemessen. Der On-Premises-OData-Endpunkt braucht eine eigene Prüfung und wird vorher nicht versprochen.
Welcher Plan ist nötig?
Konnektoren gibt es ab dem Pro-Plan; eine Konnektoreinstellung gehört zu einem API-Schlüssel und wird im Panel verwaltet.
Kann ich mit einem Klick aus BC heraus drucken?
Noch nicht. Heute startet der Ablauf bei Labelixa (API oder Panel). Die App innerhalb von BC (AppSource) steht auf der Roadmap und entsteht mit einem Pilotpartner.
Kann ich Versandetiketten aus Dynamics 365 Business Central drucken?
Ja, aus gebuchten Verkaufslieferungen: Empfänger, Adresse, Postleitzahl und Belegnummer werden über die Standard-API gelesen und auf ein ZPL-Etikett gesetzt — etwa ein Versandetikett 4×6 mit Code-128-Barcode — und dann über den DirectPrint-Agenten auf einem Zebra-kompatiblen Thermodrucker gedruckt.
Welche Barcodes kann ein Business Central-Etikett enthalten?
Jede Symbologie, die die Labelixa-Engine rendert, darunter Code 128, GS1-128, Data Matrix, QR und ITF-14. Der Barcode wird vor dem Druck am Bildschirm decodiert.
Muss ich eine Erweiterung in Business Central installieren?
Nein. Die heutige Integration liest die Daten über die Standard-API von Business Central mit einer Entra-App-Registrierung; in BC wird nichts installiert.
