Übersicht
Unsere Integration mit Business NXT ist eine vollständige bidirektionale Integration auf Grundlage von Verkaufsaufträgen in Business NXT. Darüber hinaus sind Lager und die Verwaltung der Lagerinhalte integriert.
Übersicht über die aus Business NXT übertragenen Stammdaten
Business NXT ist für viele Elemente das führende System, es besteht jedoch eine große Flexibilität bei der Übertragung dieser Daten und bei der Auswahl der Datenquelle in Business NXT. Dies ist wichtig, da es große Unterschiede darin geben kann, wie Business NXT in verschiedenen Unternehmen konfiguriert und verwendet wird.
Handyman berücksichtigt dies bei der Integration, sodass die Integration einfach an die in Business NXT getroffenen Entscheidungen angepasst werden kann.
| Element | Quelle | Konfigurierbar | Kommentar |
|---|---|---|---|
| Kunden | Associate | Auswahl | |
| Kundenkategorie | Text | Auswahl | TextType 24 ist der Standard (Gruppe 1 beim Akteur), es können jedoch auch andere verwendet werden. |
| Abteilungen | OrgUnit1 | Quelle und Auswahl | |
| Mitarbeiter | Associate | Auswahl | |
| Lieferanten | Associate | Auswahl | Großhändler |
| Produkte – Material | Product | Auswahl Preisquelle | Hier sollten Produkte enthalten sein, die nicht mit Zeit und anderen Kosten verbunden sind. Möglichkeit, alle Artikel in Handyman einem Lieferanten zuzuordnen |
| Produkte – Lohnarten | Product | Auswahl Preisquelle | Hier ist es wichtig, die Produkte zu erhalten, die mit Zeit und anderen Kosten verbunden sind |
| Produkte – Warenpakete | Product | Auswahl Preisquelle | Noch nicht implementiert |
| Installationsorte und Ausrüstung | OrgUnit4 | Ein/Aus Quelle und Auswahl | Zwei verschiedene Methoden zur Verwendung der Struktur |
| Ausrüstungskategorie | Text | Auswahl | TextType 40 ist der Standard (Gruppe 5 in OrgUnit), es können jedoch auch andere verwendet werden |
| Projekt | OrgUnit2 | Ein/Aus Quelle und Auswahl | |
| Auftragskategorie | OrgUnit5 | Ein/Aus Quelle und Auswahl | |
| Lagerorte | Warehouse | Auswahl | Nur Lager mit einer verantwortlichen Person werden übertragen. Auswahl aus einer Liste, welche Lagerorte ausgeschlossen werden sollen. |
| Lagerbestand | StockBalance | Ein/Aus Auswahl | Wird jede Nacht übertragen Die Auswahl umfasst auch eine konfigurierbare Liste der Lagerorte, die von der Übertragung ausgenommen werden sollen. |
| Lageränderungen | StockChange | Noch nicht implementiert |
Alle Änderungen an diesen Stammdaten werden unmittelbar nach dem Speichern in Business NXT automatisch über WebHooks an Handyman übertragen, sodass Handyman immer mit Business NXT synchron ist.
Übersicht über die aus Business NXT übertragenen Auftragsdaten
Aufträge können in Business NXT erstellt werden. Wenn sie in die angegebene Auswahl fallen, werden sie an Handyman übertragen. Dadurch ist es möglich, in Business NXT mit Aufträgen zu arbeiten, die für Handyman nicht relevant sind. Dies kann z. B. der Direktverkauf von Ausrüstung und Dienstleistungen sein.
| Element | Quelle | Konfigurierbar | Kommentar |
|---|---|---|---|
| Verkaufsauftrag | Order | Auswahl | Verantwortliche Person und Teilnehmer können Sie in NXT angeben |
| Auftragszeilen | OrderLine |
| |
| Auftragsdokumente | OrderAttachment | ||
| Rechnungsdokument | CustomerTransaction | Ein/Aus |
Wie bei den Stammdaten werden Änderungen an Aufträgen in Business NXT mithilfe von WebHooks unmittelbar an Handyman übermittelt.
Beispiel:
Wenn ein Auftrag in Business NXT endabgerechnet wird, wird der Auftrag in Handyman automatisch als endabgerechnet und historisch markiert.
Übersicht über die aus Handyman übertragenen Auftragsdaten
Neue Aufträge können in Handyman Mobile erstellt werden. In Handyman Office können Aufträge aus Serviceverträgen generiert oder im Zusammenhang mit der Planung manuell erstellt werden. Unabhängig von der Quelle werden alle in Handyman Mobile und Handyman Office vorgenommenen Einträge an Business NXT gesendet, das unmittelbar mit aktualisierten Preisen und Kosten aus Business NXT antwortet.
Auf diese Weise handelt es sich um eine vollständig nahtlose Integration, bei der beide Systeme so schnell wie möglich aktualisiert werden, unabhängig davon, wo die Änderung erfolgt.
| Element | Quelle | Konfigurierbar | Kommentar |
|---|---|---|---|
| Verkaufsauftrag | Order | ||
| Auftragszeilen | OrderLine |
| |
| Auftragsdokumente | OrderAttachment | Ein/Aus Berichte | Die Auswahl der zu übertragenden Berichte ist konfigurierbar |
Weitere aus Handyman übertragene Daten
| Element | Quelle | Konfigurierbar | Kommentar |
|---|---|---|---|
| Ergebnis der Inventur | StockBalance | Das Infofeld wird verwendet, um anzugeben, wer die Inventur durchgeführt hat: stockInformation2 | |
| Neue Kunden | Kunde | Kundennummernkreis | Die Erstellung neuer Kunden in Handyman Office kann blockiert werden. |
| Aktualisierte Informationen zu Installationsorten und Ausrüstung | OrgUnit4 | Quelle + ob eine Übertragung erfolgen soll | Bidirektionale Integration. Änderungen können sowohl in Handyman als auch in NXT vorgenommen werden. |
| Bestellung aus Handyman Mobile | Transfer order oder Purchase order | Als Bestellung oder als Übertragung vom Hauptlager zum Fahrzeuglager behandeln | |
| Lagerbewegungen | Verschieben von Waren zwischen Lagern in Office oder Mobile | Ein/Aus | Lager wird unmittelbar aktualisiert |
Weitere Konfiguration
Zusätzlich zu Quellen und Auswahlmöglichkeiten für Stammdaten gibt es auch Auswahlmöglichkeiten für einzelne wichtige Felder verschiedener Elemente. Business NXT bietet flexible Möglichkeiten zur Verwendung vieler freier Zusatzfelder. Wir verwenden mehrere davon in der Integration. Einige sind konfigurierbar, andere fest definiert. Darüber hinaus können einige Optionen ein- oder ausgeschaltet werden.
Feldbasierte Konfigurationen
| Element | Feld in Handyman | Feld in NXT | Kommentar |
|---|---|---|---|
| Auftrag | Kundenreferenz | keines, yourReference oder beliebige OrgUnit | |
| Auftrag | Hauptauftrag | keines, mainOrderNo oder beliebige OrgUnit | |
| Auftrag | Anforderung | keines, requisitinNo oder beliebige OrgUnit | |
| Auftrag | Auftragsname | keines oder beliebige Information 1–6 | |
| Auftrag | Auftragstyp | keines oder beliebige group1–12 (6 und 10 sind belegt. Siehe unten) |
100 = Arbeitsauftrag Wenn keine Konfiguration ausgewählt wird, erfolgt die Auswahl automatisch danach, ob der Auftrag Ausrüstung enthält oder nicht. |
| Kunde | Kundenkategorie | keines oder beliebige group1–12 | group1 |
| Preisliste (Material) | Warengruppe | keines oder beliebige group1–12 |
Felder, die nicht konfiguriert werden können
Einige Felder im Auftragskopf und in den Ausrüstungsinformationen haben eine feste Konfiguration. Dies kann geändert werden, wenn dies erforderlich ist.
| Element | Feld in Handyman | Feld in NXT | Kommentar |
|---|---|---|---|
| Auftrag | Geprüft/Fertig-Status | group6 | 1 = Fertig 2 = In Handyman vorab genehmigt 3 = In Handyman genehmigt |
| Auftrag | Auftrag an Handyman | group10 |
group10 wird verwendet, um anzugeben, ob ein Auftrag an Handyman übermittelt werden soll, und ist außerdem fester Bestandteil des Auftragsfilters für den Import. 1 = In Handyman anzeigen |
Weitere Einstellungen
Einstellungen mit Ein-/Auswahl, die die Funktionsweise der Integration beeinflussen
| Einstellung in der Integrationskonfiguration | Kommentar |
|---|---|
| Execute Import On Timer | Überträgt den Lagerbestand jede Nacht um 03:00 Uhr |
| Enable document/report export | PDF-Dokumente und ausgewählte Berichte übertragen |
| Import Equipment | Installationsorte und Ausrüstung importieren und exportieren |
| Enable import extra order category 1 | Projekt in die zusätzliche Auftragskategorie 1 importieren |
| Enable order category import | Auftragskategorien importieren |
| Set orders to free if no participants exist | Neue Aufträge aus NXT als frei festlegen, wenn kein Teilnehmer angegeben ist |
| Use incurred field for quantity on order lines | Aufgelaufenen Wert als Menge in den Auftragszeilen verwenden. Dadurch kann eine andere Menge fakturiert werden als die in Handyman erfasste |