Produktdatenmanagement (PDM)-Interface#
Allgemein#
Das PDM-Interface stellt eine Schnittstelle zu PDM-Systemen als "REST-API" bereit, welche es ermöglicht, Daten zwischen Ihrem PDM-System und KUMAVISION factory365 auszutauschen. Die Funktionalität unterstützt das Anlegen und Ändern von Datensätzen. Das Löschen von bestehenden Stammdaten wird - mit Ausnahme der Fertigungsstücklistenzeilen - nicht unterstützt.
Die folgende Tabelle zeigt Ihnen, welche Daten zum Austausch vorgesehen sind:
| Seite | Tabellen-ID | TAG-Name | Zugriff | Abschnitt |
|---|---|---|---|---|
| Artikel | 27 | items | lesen, einfügen und ändern | API - Feldbeschreibung Artikel |
| Artikelvarianten | 5401 | itemVariants | lesen, einfügen und ändern | API - Feldbeschreibung Artikelvariante |
| Artikelversionen | 5026352 | itemVersions | lesen, einfügen und ändern | API - Feldbeschreibung Artikelversionen |
| Artikeleinheiten | 5404 | itemUnitOfMeasures | lesen, einfügen und ändern | API - Feldbeschreibung Artikeleinheiten |
| Einheiten | 204 | unitOfMeasures | nur lesen | API - Feldbeschreibung Einheiten |
| Artikelvorlagen | 1382 | itemTemplates | nur lesen | API - Feldbeschreibung Artikelvorlagen |
| Artikelkategorien | 5722 | itemCategories | nur lesen | API - Feldbeschreibung Artikelkategorie |
| Hersteller | 5720 | manufacturers | nur lesen | API - Feldbeschreibung Hersteller |
| Werkstoff | 5026357 | materials | nur lesen | API - Feldbeschreibung Werkstoff |
| Kreditoren | 23 | vendors | nur lesen | API - Feldbeschreibung Kreditoren |
| Fertigungsstücklisten - Kopf | 99000771 | productionBOM Headers | lesen, einfügen und ändern | API - Feldbeschreibung Fertigungsstücklisten - Kopf |
| Fertigungsstücklisten - Version | 99000779 | productionBOM Versions | lesen, einfügen, und ändern | API - Feldbeschreibung Fertigungsstücklisten - Version |
| Fertigungsstücklisten - Zeilen | 99000772 | productionBOMLines | lesen, einfügen und ändern sowie löschen (via Funktionsaufruf) | API - Feldbeschreibung Fertigungsstücklisten - Zeilen |
| Artikelattribute | 7500 | itemAttributes | nur lesen | API - Feldbeschreibung Artikelattribute |
| Artikelattributwerte | 7504 | itemVariantVersionAttributes | nur lesen | API - Feldbeschreibung Artikelattributwerte |
Hinweis
Der Austausch von Montagestücklisten ist nicht vorgesehen.
API URL’s im PDM-Interface von KUMAVISION factory365#
Die "systemId" ist der eindeutige Schlüssel (Primärschlüssel) des jeweiligen Datensatzes.
Microsoft Dynamics 365 Business Central On-Prem URL#
https://<base URL>:<port>/<serverInstance>/api/kvsfcy/pdm/v1.0/
Microsoft Dynamics 365 Business Central Saas URL#
https://api.businesscentral.dynamics.com/v2.0/<user domain name>/<environment name>/api/kvsfcy/pdm/v1.0/
Weiterführende Informationen finden Sie unter:
Lizenzierung#
Da über diese Schnittstelle Daten aus Microsoft Dynamics 365 Business Central1 in einem Fremdsystem verarbeitet, verändert und zurückgeschrieben werden (bidirektional), muss jeder PDM-User eine entsprechende Microsoft Dynamics 365 Business Central1-Lizenz besitzen.
Im Sinne der Microsoft Lizenzbedingungen handelt es sich hierbei um Multiplexing. Die Device- bzw. Teammember-Lizenzen sind nicht ausreichend, da hier wesentliche Tabellen im Bereich der Fertigung nicht angesteuert werden. Es werden daher Premium-User benötigt.
Hinweis
PDM-Interface ist ein Freischaltmodul, dessen Nutzung nur mit zusätzlicher Lizenzierung und Aktivierung möglich ist.
Weiterführende Bedingungen finden Sie unter:
Microsoft APIs – Nutzungsbedingungen
Einrichtung#
PDM-User#
Für die Anmeldung über die API-Schnittstelle wird ein separater User zur detaillierten Steuerung der Berechtigungen benötigt.
Für die PDM-spezifischen Berechtigungen steht ein entsprechender Berechtigungssatz (APIPDM(KVSFCYAPIPDM)), welcher mit der Installation von KUMAVISION factory365 generiert wird, zur Verfügung.
Hinweis
Im Änderungsprotokoll können anhand des separaten Users die Datensätze gefiltert werden, welche durch das PDM-Interface erstellt, bzw. verändert wurden.
Dieser User sollte auf jeden Fall nur ein minimaler Zugriff auf das System gewährleistet werden um den externen Zugriff und somit den Datenschutz gewährleisten zu können.
API-Connect#
Für den Zugriff auf die Microsoft Dynamics 365 Business Central1 API-Dienste, muss der Zugriff konfiguriert und eine Authentifizierungsmöglichkeit für API-Clientanwendungen bereitgestellt werden.
Entra-ID#
Über das Microsoft Dynamics 365 Business Central1 Admin Center ist eine Entra-ID zu erstellen und in den Microsoft Entra-Anwendungen eingetragen. Ebenso wird der Berechtigungssatz für das PDM-Interface eingetragen.
Weiterführende Informationen finden Sie unter:
Configure Microsoft Entra authentication with OpenID Connect
Artikel#
Für den PDM Transfer stehen Ihnen auf der Artikelkarte auf dem Inforegister "Artikel" folgende Felder zur Verfügung:
| Feld | Beschreibung |
|---|---|
| Werkstoff | Das Feld "Werkstoff" kennzeichnet den Artikel, aus welchen Werkstoff er besteht. Weiterführende Informationen zum Thema "Werkstoff" finden Sie im gleichnamigen Abschnitt. |
| PDM Status | Das Feld "PDM Status" kennzeichnet, in welchem Status sich der Artikel im PDM-System befindet. Gleichzeitig werden im System die definierten Gesperrt Kennzeichen auf der jeweiligen Artikelkarte gesetzt. Weiterführende Informationen zum Thema PDM-Status finden Sie im gleichnamigen Abschnitt. |
Werkstoffe#
Über die "Werkstoffe" können Sie die Werkstoffe, aus denen Ihre Artikel bestehen, anlegen. Bei der späteren Übertragung in KUMAVISION factory365 werden diese Werkstoffe direkt auf der jeweiligen Artikelkarte übertragen.
Um die Werkstoffe im System anzulegen, rufen Sie sich über die Anwendersuche die "Werkstoffe" auf.
Über "Neu" im Menüband können Sie einen neuen Werkstoff mit Hilfe der u.a. Tabelle definieren.
| Feld | Beschreibung |
|---|---|
| Code | Gibt den "Code" (Kürzel) des Werkstoffes an. Hinweis: Für die Zuordnung der Werkstoffe muss der Code identisch dem Code im übertragenden PDM-System sein. |
| Beschreibung | Gibt die Beschreibung des Werkstoffs an. |
| Spezifisches Gewicht (g/ m³) | Gibt das spezifische Gewicht des Werkstoffs an. Hinweis: Das Feld dient lediglich zur Information (ohne weitergehende Verwendung) |
PDM-Status#
Über den "PDM Status“ können Sie festlegen, ob bei der späteren Übertragung in KUMAVISION factory365 die entsprechenden Gesperrt-Felder auf der Artikelkarte gesetzt werden sollen. Die Festlegung erfolgt hierzu einmalig in den "PDM Status".
Hierzu rufen Sie sich über die Anwendersuche den "PDM Status" auf. Über "Neu" im Menüband können Sie anhand der u.a. Tabelle einen neuen PDM Status definieren
| Feld | Beschreibung |
|---|---|
| Code | Gibt den "Code" (Kürzel) des PDM-Status an. Hinweis Für die Zuordnung der gesperrten Kennzeichen muss der Code identisch dem Code im übertragenden PDM-System sein. |
| Beschreibung | Gibt die Beschreibung des PDM-Status an. |
| Setze Gesperrt | Bei Aktivierung, wird automatisch bei der Übertragung die Felder "Gesperrt" und "Gesperrt (Anwender)" auf der jeweiligen Artikelkarte gesetzt. In Folge dessen ist der Artikel für alle Prozesse im System gesperrt. |
| Setze Gesperrt Verkauf | Bei Aktivierung, wird automatisch bei der Übertragung das Feld "Verkauf gesperrt" auf der jeweiligen Artikelkarte gesetzt. In Folge dessen ist der Artikel für den Verkaufsprozess im System gesperrt. |
| Setze Gesperrt Einkauf | Bei Aktivierung, wird automatisch bei der Übertragung das Feld "Einkauf gesperrt" auf der jeweiligen Artikelkarte gesetzt. In Folge dessen ist der Artikel für den Einkaufsprozess im System gesperrt. |
| Setze Gesperrt Produktion | Bei Aktivierung, wird automatisch bei der Übertragung das Feld "Produktion gesperrt" auf der jeweiligen Artikelkarte gesetzt. In Folge dessen ist der Artikel für den Produktionsprozess im System gesperrt. |
| Setze Gesperrt Service | Bei Aktivierung, wird automatisch bei der Übertragung das Feld "Service gesperrt" auf der jeweiligen Artikelkarte gesetzt. In Folge dessen ist der Artikel für den Serviceprozess im System gesperrt. |
| Setze Gesperrt Produktions-verbrauch | Bei Aktivierung, wird automatisch bei der Übertragung das Feld "Gesperrt Prod. Verbrauch" auf der jeweiligen Artikelkarte gesetzt. In Folge dessen ist der Artikel für den Produktionsverbrauch im System gesperrt. |
API-Feldbeschreibungen#
Artikel#
Die API-Page zu den Artikelstammdaten (Table-ID 27) enthält folgende Felder:
| TAG-Name | Feldname | Typ | Länge | Beschreibung |
|---|---|---|---|---|
| systemId | System-ID | GUID | 16 | Die eindeutige ID des Artikels. Nicht bearbeitbar. |
| no | Nr. | Code | 20 | Gibt die Nummer des Artikels an. |
| no2 | Nummer 2 | Code | 20 | Kann die Nummer des Artikels im PDM-System enthalten. |
| itemTemplateCode | Artikelvorlagencode | Code | 20 | Der Code der Artikelvorlage des Artikels. Hinweis: Dieser Wert übersteuert den Wert der Artikelvorlage aus der Artikelkategorie. |
| itemCategoryCode | Artikelkategoriencode | Code | 20 | Der Code der Artikelkategorie im Artikel. Hinweis: Bei Neuanlage zwingend erforderlich. |
| description | Beschreibung | Text | 100 | Gibt den Namen des Artikels an. Dieser Name erscheint auf allen Verkaufsbelegen für den Artikel. |
| description2 | Beschreibung 2 | Text | 50 | |
| baseUnitOfMeasure | Basiseinheit | Code | 10 | Der Basismengeneinheitencode des Artikels. |
| productionBOMNo | Fert.-Stücklistennr. | Code | 20 | Die Fert.-Stücklistennr. des Artikels. Hinweis: Fert.-Stückliste muss in Microsoft Dynamics 365 Business Central1vorhanden sein. D.h. diese muss ggf. zuvor übertragen und das Feld im Anschluss auf der Artikelkarte aktualisiert werden. |
| vendorNo | Kreditorennummer | Code | 20 | Die Nummer des Kreditors, bei welchem der Artikel üblicherweise beschafft wird. |
| vendorItemNo | Kred.-Artikelnummer | Text | 50 | Die Artikelnummer des Kreditors, bei welchem der Artikel üblicherweise beschafft wird. |
| grossWeight | Bruttogewicht | Decimal | Das Bruttogewicht des Artikels in Bezug auf die Basiseinheit. | |
| netWeight | Nettogewicht | Decimal | Das Nettogewicht des Artikels in Bezug auf die Basiseinheit. | |
| unitVolume | Volumen | Decimal | Das Volumen des Artikels in Bezug auf die Basiseinheit. | |
| manufacturerCode | Herstellercode | Code | 10 | Der Code des Herstellers im Artikel. |
| kvsfcyMaterial | Werkstoff | Code | 10 | Der Code des Werkstoffs im Artikel. |
| kvsfcyDrawingNo | Zeichnungsnr. | Text | 30 | Gibt die Zeichnungsnummer an. |
| kvsfcyDrawingFormat | Zeichnungsformat | Text | 30 | Gibt das Zeichnungsformat an. |
| kvsfcypdmStatus | PDM Status | Code | 10 | Der Code des PDM-Status des Artikels. Hinweis: Der PDM-Status übersteuert die Sperrkennzeichen aus der Artikelvorlage. |
| kvsfcyNewPDMItem | Neuer PDM Artikel | Boolean | Information an das PDM-System, ob es sich um einen neuen Artikel handelt. Es ist nicht editierbar. |
Verknüpfungen#
Es bestehen Verknüpfungen zu den nachfolgenden API-Pages:
| Seite | Tabellen-ID | TAG-Name | Zugriff | Siehe |
|---|---|---|---|---|
| Artikelattribute | 7500 | itemAttributes | nur lesen | API - Feldbeschreibung Artikelattribute |
| Artikelattributwerte | 7504 | itemVariantVersionAttributes | nur lesen | API - Feldbeschreibung Artikelattributwerte |
Weiterführende Informationen finden Sie unter:
item resource type
Artikelvarianten#
Die API-Page zu den Artikelvarianten (Table-ID 5401) enthält folgende Felder:
| TAG-Name | Feldname | Typ | Länge | Beschreibung |
|---|---|---|---|---|
| id | System-ID | GUID | 16 | Die eindeutige ID der Artikelvariante.Nicht editierbar. |
| itemNo | Artikelnr. | Code | 20 | Gibt die Nummer des Artikels an. |
| code | Code | Code | 10 | Gibt den Code der Artikelvariante an. |
| description | Beschreibung | Text | 100 | Gibt den Namen des Artikels an. |
| description2 | Beschreibung 2 | Text | 50 | |
| kvsfcypdmStatus | PDM Status | Code | 10 | Der Code des PDM-Status der Artikelvariante. |
Verknüpfungen#
Es besteht eine Verknüpfung zur folgenden API-Page:
| Tabelle | TAG-Name | Zugriff | Siehe |
|---|---|---|---|
| Artikelattributwerte (Table-ID 7504) |
itemVariantVersionAttributes | nur lesen | API - Feldbeschreibung Artikelattribute. |
Weiterführende Informationen finden Sie unter: itemVariant resource type
Artikelversionen#
Die API-Page zu den Artikelversionen (Table-ID 5026352) enthält folgende Felder:
| TAG-Name | Feldname | Typ | Länge | Beschreibung |
|---|---|---|---|---|
| id | System-ID | GUID | 16 | Die eindeutige ID der Artikelversion. Nicht editierbar. |
| itemNo | Artikelnr. | Code | 20 | Gibt die Nummer des Artikels an. |
| variantCode | Variantencode | Code | 10 | Gibt den Code der Artikelvariante an. |
| versionCode | Versionscode | Code | 20 | Gibt den Code der Artikelversion an. |
| status • New • Certified • Closed |
Status | Option | Es stehen folgende Optionen zur Verfügung: • Neu • Zertifiziert • Abgelaufen |
|
| versionStartingDate | Version Startdatum | Date | Gibt an, ab welchem Datum die Version gültig ist. | |
| material | Werkstoff | Code | 10 | Der Code des Werkstoffs der Artikelversion. |
| drawingNo | Zeichnungsnr. | Text | 30 | Gibt die Zeichnungsnummer an. |
| drawingFormat | Zeichnungsformat | Text | 30 | Gibt das Zeichnungsformat an. |
| drawingindex | Zeichungsindex | Text | 10 | Gibt den Zeichnungsindex an. |
| manufacturercode | Herstellercode | Code | 10 | Der Code des Herstellers der Artikelversion. |
| manufacturerItemNo | Hersteller Artikel Nr. | Code | 20 | Die Artikelnummer des Herstellers. |
| productionBOMNo | Fert.-Stücklistennr. | Code | 20 | Die Fert.-Stücklistennr. der Artikelversion. Hinweis: Fert.-Stückliste muss in Microsoft Dynamics 365 Business Central1 vorhanden sein. D.h. diese muss ggf. zuvor übertragen und das Feld im Anschluss auf der Artikelkarte aktualisiert werden. |
| productionBomVersionCode | Fert.-Stücklistenversionscode | Code | 20 | Der Fert-Stücklistenversionscode der Artikelversion. |
Verknüpfungen#
Es besteht eine Verknüpfung zur folgenden API-Page:
| Tabelle | TAG-Name | Zugriff | Siehe |
|---|---|---|---|
| Artikelattributwerte (Table-ID 7504) |
itemVariantVersionAttributes | nur lesen | API - Feldbeschreibung Artikelattributwerte |
Artikeleinheiten#
Die API-Page zu den Artikeleinheiten (Table-ID 5404) enthält folgende Felder:
| TAG-Name | Feldname | Typ | Länge | Beschreibung |
|---|---|---|---|---|
| systemId | System-ID | GUID | 16 | Die eindeutige ID der Artikeleinheit. Nicht bearbeitbar. |
| itemNo | Artikelnr. | Code | 20 | Gibt die Nummer des Artikels an. |
| code | Code | Code | 10 | Der Einheitencode der Artikeleinheit. |
| qtyPerUnitOfMeasure | Menge pro Einheit | Decimal | 12 | "Menge pro Einheit" in Bezug auf die Basiseinheit des Artikels. |
| qtyRoundingPrecision | Mengenrundungspräzision | Decimal | 12 | Wert mit Anzahl Nachkommastellen auf welche gerundet werden soll. z.B. 0,01 = 2 Nachkommastellen oder 1 für Ganzzahl. Hinweis: Wird beim Buchen in den Belegen berücksichtigt, um die "Menge (Basis)" entsprechend zu runden. |
| height | Höhe | Decimal | 12 | Abmessung "Höhe" der Artikeleinheit. |
| length | Länge | Decimal | 12 | Abmessung "Länge" der Artikeleinheit. |
| width | Breite | Decimal | 12 | Abmessung "Breite" der Artikeleinheit. |
| weight | Gewicht | Decimal | 12 | Gewicht der Artikeleinheit. |
| cubage | Volumen | Decimal | 12 | Volumen der Artikeleinheit. |
Einheiten#
Die API-Page zu den Einheiten (Table-ID 204) enthält folgende Felder:
| TAG-Name | Feldname | Typ | Länge | Beschreibung |
|---|---|---|---|---|
| systemId | System-ID | GUID | 16 | Die eindeutige ID der Maßeinheit. Nicht editierbar. |
| code | Code | Code | 10 | Der Code der Maßeinheit. |
| description | Beschreibung | Text | 50 | Gibt den Namen der Maßeinheit an. Dieser Name erscheint auf allen Verkaufsbelegen für die Maßeinheit. |
Weiterführende Informationen finden Sie unter:
unitOfMeasure resource type
Artikelvorlagen#
Die API-Page zu den Artikelvorlagen (Table-ID 1382 ) enthält folgende Felder:
| TAG-Name | Feldname | Typ | Länge | Beschreibung |
|---|---|---|---|---|
| systemId | System-ID | GUID | 16 | Die eindeutige ID der Artikelvorlage. Nicht editierbar. |
| code | Code | Code | 20 | Gibt den Code der Artikelvorlage an. |
| description | Beschreibung | Text | 100 | Gibt den Namen der Artikelvorlage an. |
| noSeries | Nummernserien | Code | 20 | Der Code der zugeordneten Nummernserie. |
Artikelkategorien#
Die API-Page zu den Artikelkategorien (Table-ID 5722) enthält folgende Felder:
| TAG-Name | Feldname | Typ | Länge | Beschreibung |
|---|---|---|---|---|
| systemId | System ID | GUID | 16 | Die eindeutige ID der Artikelkategorien. Nicht editierbar. |
| code | Code | Code | 20 | Der Code der Artikelkategorie. |
| parentCategory | Übergeordnete Kategorie | Code | 20 | Der Code der übergeordneten Artikelkategorie. |
| description | Beschreibung | Text | 100 | Gibt den Namen der Artikelkategorie an. |
| kvsfcypdmItemTemplateCode | PDM Artikelvorlagencode | Code | 20 | Der Code des PDM Status der Artikelvorlage. |
| kvsfcyActive | Aktiv | Boolean | Zeigt an, ob die Artikelkategorie noch aktiv ist. |
Weiterführende Informationen finden Sie unter:
itemCategory resource type
Hersteller#
Die API-Page zu den Hersteller (Table-ID 5720) enthält folgende Felder:
| TAG-Name | Feldname | Typ | Länge | Beschreibung |
|---|---|---|---|---|
| systemId | System-ID | GUID | 16 | Die eindeutige ID des Herstellers. Nicht editierbar. |
| code | Code | Code | 10 | Der Code des Herstellers. |
| name | Name | Text | 20 | Gibt den Namen des Herstellers an. |
Werkstoff#
Die API-Page zu den Werkstoff (Table-ID 5026357) enthält folgende Felder:
| TAG-Name | Feldname | Typ | Länge | Beschreibung |
|---|---|---|---|---|
| systemId | System-ID | GUID | 16 | Die eindeutige ID des Werkstoffs. Nicht editierbar. |
| code | Nr. | Code | 10 | Der Code des Werkstoffs. |
| description | Beschreibung | Text | 30 | Gibt den Namen des Werkstoffs an. |
Kreditoren#
Die API-Page zu den Kreditoren (Table-ID 23) enthält folgende Felder:
| TAG-Name | Feldname | Typ | Länge | Beschreibung |
|---|---|---|---|---|
| systemId | System-ID | GUID | 16 | Die eindeutige ID des Kreditors. Nicht editierbar. |
| no | Nr. | Code | 20 | Gibt die Nummer des Kreditors an. |
| name | Name | Text | 100 | Gibt den Namen des Kreditors an. |
| name2 | Name 2 | Text | 100 | |
| blocked | Gesperrt | Option | Gibt an, ob der Kreditor gesperrt ist. |
Hinweis
Die Bereitstellung der Kreditoren ist für den Datenabgleich zwischen dem PDM und ERP-System vorgesehen, damit in der Übergabe von Artikeldaten inkonsistente Daten vermieden werden.
Weiterführende Informationen finden Sie unter:
vendor resource type
Fertigungsstücklisten - Kopf#
Die API-Page zu den Fertigungsstücklisten - Kopf (Table-ID 99000771) enthält folgende Felder:
| TAG-Name | Feldname | Typ | Länge | Beschreibung |
|---|---|---|---|---|
| systemId | System-ID | GUID | 16 | Gibt die eindeutige ID des Fertigungsstücklisten - Kopfes an. Nicht editierbar. |
| no | No. | Code | 10 | Gibt die Nummer des Fertigungsstücklisten - Kopfes an. |
| description | Beschreibung | Text | 100 | Gibt den Namen der Fertigungsstückliste an. |
| description2 | Beschreibung 2 | Text | 50 | |
| unitOfMeasureCode | Einheitencode | Code | 10 | Der Einheitencode der Fertigungsstückliste. |
| status • New • Under • Development • Certified • Closed |
Status | Option | Es stehen folgende Optionen zur Verfügung: • Neu • In Entwicklung • Zertifiziert • Abgelaufen |
Hinweis
Aufgrund der aktuellen Microsoft Dynamics 365 Business Central1 Datenstruktur kann derzeit keine Page-Subpage Funktionalität zu den Fertigungsstücklisten - Zeilen Produktseitig umgesetzt werden.
In den Fertigungsstücklisten - Zeilen kann die System-ID der Relation auf Fertigungsstücklistenkopf oder -version durch kundenindividuelle Programmierung implementiert werden.
Fertigungsstücklisten - Version#
Die API-Page zu den Fertigungsstücklisten - Version (Table-ID 99000772) enthält folgende Felder:
| TAG-Name | Feldname | Typ | Länge | Beschreibung |
|---|---|---|---|---|
| systemId | System-ID | GUID | 16 | Gibt die eindeutige ID der Fertigungsstücklisten - Version an. Nicht editierbar. |
| productionBOMNo | Fert.-Stücklistennr. | Code | 10 | Gibt die Nummer der Fertigungsstückliste an. |
| versionCode | Version Code | Code | 20 | Gibt den Code der Fertigungsstücklisten Version an. |
| description | Beschreibung | Text | 100 | Gibt den Namen der Fertigungsstücklisten Version an. |
| unitOfMeasureCode | Einheitencode | Code | 10 | Der Einheitencode der Fertigungsstückliste Version. |
| status • New • Under • Development • Certified • Closed |
Status | Option | Es stehen folgende Optionen zur Verfügung: • Neu • In Entwicklung • Zertifiziert • Abgelaufen |
Fertigungsstücklisten - Zeilen#
Die API-Page zu den Fertigungsstücklisten - Zeilen (Table-ID 99000772) enthält folgende Felder:
| TAG-Name | Feldname | Typ | Länge | Beschreibung |
|---|---|---|---|---|
| systemId | System-ID | GUID | 16 | Die eindeutige ID der Fertigungsstücklisten - Zeile an. Nicht editierbar. |
| productionBOMNo | Fert.-Stücklistennr. | Code | 10 | Gibt die Nummer der Fertigungsstückliste an. |
| type | Type | Option | Der Typ der Fertigungsstücklisten - Zeile. Es kann sich um "Artikel" oder "Fertigungsstückliste" handeln. |
|
| no | Nr. | Code | 20 | Beim Typ "Artikel" ist es die Nummer der Komponente und beim Typ "Fertigungsstückliste" ist es die Nummer der Stückliste. Hinweis: Der Artikel muss in Microsoft Dynamics 365 Business Central1 vorhanden sein. D.h. dieser muss ggf. zuvor übertragen werden. |
| lineNo | Zeilennr. | Integer | Gibt die Zeilennummer der Fertigungsstücklisten - Zeile an. | |
| versionCode | Version Code | Code | 20 | Gibt den Code der Fertigungsstücklisten Version an. |
| description | Beschreibung | Text | 100 | Gibt den Namen der Komponente an. |
| description2 | Beschreibung 2 | Text | 50 | |
| unitOfMeasureCode | Einheitencode | Code | 10 | Der Einheitencode der Komponente. |
| variantCode | Variantencode | Code | 10 | Gibt den Code der Fertigungsstücklisten Variante an. |
| quantity | Menge | Dezimal | Zeigt die Menge der Komponente in der Basiseinheit des Artikels an. | |
| quantityPer | Komponentenmenge | Dezimal | Gibt die Menge der Komponente je zu fertigendem Teil an. | |
| position | Position | Code | 10 | Die Position der Fertigungsstücklisten - Zeile. Hinweis: Wird bei der Berechnung der E+D Positionsnummer verwendet. |
| position2 | Position 2 | Code | 10 | |
| position3 | Position 3 | Code | 10 | |
| length | Länge | Dezimal | Abmessung "Länge" der Komponente. | |
| width | Breite | Dezimal | Abmessung "Breite" der Komponente. | |
| weight | Gewicht | Dezimal | Gewicht der Komponente. | |
| depth | Tiefe | Dezimal | Abmessung "Tiefe" der Komponente. | |
| calculationFormula | Formel | Option | Formel zur Berechnung der Komponentenmenge. Hierzu sind z.B. die Felder: Länge, Breite, usw. notwendig. |
|
| endingDate | Enddatum | Datum | Datum bis zu welchem Zeitpunkt die Fertigungsstücklisten - Zeile angewendet wird. | |
| scrap | Ausschuss % | Dezimal | Gibt den prozentualen Aufschlag zur Berechnung des Komponentenbedarfes an. | |
| startingDate | Startdatum | Datum | Datum ab welchem Zeitpunkt die Fertigungsstücklisten - Zeile angewendet wird. |
Artikelattribute#
Die API-Page zu den Artikelattributen (Table-ID 7500) enthält folgende Felder:
| TAG-Name | Feldname | Typ | Länge | Beschreibung |
|---|---|---|---|---|
| systemId | System-ID | GUID | 16 | Gibt die eindeutige System-ID des Artikelattributes an. Nicht editierbar. |
| id | ID | Integer | Die ID des Artikelattributes. | |
| kvsfcyCode | Code | Code | 20 | Gibt den Code des Artikelattributes an. |
| name | Name | Text | 250 | Gibt den Namen des Artikelattributes an. |
| type | Type | Option | Es stehen die folgenden Optionen zur Verfügung: • Text • Ganzzahl • Dezimalzahl • Datum |
|
| blocked | Gesperrt | Boolean | Gibt an, ob das Artikelattribut gesperrt ist. | |
| unitOfMeasure | Einheit | Text | 30 | Zeigt die Beschreibung der Einheit an. |
| kvsfcyUnitOfMeasureCode | Einheitencode | Code | 20 | Der Einheitencode der Artikelattributes. |
Artikelattributwerte#
Die API-Page zu den Artikelattributwerte (Table-ID 7504) enthält folgende Felder:
| TAG-Name | Feldname | Typ | Länge | Beschreibung |
|---|---|---|---|---|
| systemId | System-ID | GUID | 16 | Gibt die eindeutige ID des Artikelattributes an. Nicht editierbar. |
| recordID | Record ID | Record ID | 20 | Ist der Primärschlüssel des Artikels, der Variante oder der Artikelversion in Textform. |
| sourceSystemid | Herkunft SystemID | GUID | Das Feld liefert die Herkunftssystem ID (Artikel, Variante oder Artikelversion) | |
| kvsfcySorting | Sortierung | Integer | Gibt die Reihenfolge der Anordnung im Artikel, bzw. der Artikelkategorie an. | |
| kvsfcyItemAttributeCode | Attribute Code | Code | 20 | Gibt den Code des Artikelattributes an. |
| attributeName | Attribute Name | Text | 250 | Gibt den Namen des Artikelattributes an. |
| kvsfcyValueCode | Wertcode | Code | 20 | Ist der Code der ausgewählten Option. |
| value | Wert | Text | 250 | Ist der Wert des Artikelattributes. |
| kvsfcyUnitOfMeasureCode | Einheitencode | Code | 20 | Der Einheitencode des Artikelattributes. |
| unitOfMeasure | Einheit | Text | 30 | Zeigt die Beschreibung der Einheit an. |
| kvsfcyNumericValue | Numeric Value | Dezimal | Ist der nummerische Wert des Artikelattributwertes. | |
| attributeID | Attribute ID | Integer | Die ID des Artikelattributes. | |
| attributeType | Attribute Type | Option | Es stehen die folgenden Optionen zur Verfügung: • Text • Ganzzahl • Dezimalzahl • Datum |
|
| blocked | Gesperrt | Boolean | Gibt an, ob Datensatz gesperrt ist. |
Best Practice Prozesse#
Neuanlage Artikel#
Bei Neuanlage eines Artikels muss zunächst der Primärschlüssel (Feld "Nr.") initialisiert werden. Hier gibt es verschiedene Einrichtungsvarianten bzw. -prioritäten:
- Das Feld "Nr." wird in der Schnittstelle vom PDM-System übergeben. Somit muss das PDM-System die eindeutige Nummerierung gewährleisten. (nicht empfohlen, da in Microsoft Dynamics 365 Business Central1 auch Artikel angelegt werden können und dies u.U. zu unerwünschten Konflikten führen kann)
- In der Artikelvorlage, die am jeweiligen Artikelkategoriencode hinterlegt ist oder direkt übergeben werden kann, kann eine Nummernserie hinterlegt werden. Aus dieser Nummernserie wird dann die nächste fortlaufende Nummer ermittelt. Diese Variante ermöglicht die Definition separater Nummernkreise für unterschiedliche Artikelkategorien.
- In der Lagereinrichtung kann eine zentrale Nummernserie für Artikelnummern eingerichtet werden. Sofern die beiden vorgenannten Bedingungen nicht erfüllt sind, wird aus dieser Nummernserie die nächste fortlaufende Nummer erzeugt.
Nach der Initialisierung des Primärschlüssels werden anschließend die Felder aus der Artikelvorlage übernommen. Hierbei ist zu beachten, dass die Artikelvorlage die direkt übergeben werden kann vor der Artikelvorlage aus der Artikelkategorie verwendet wird. Nachfolgend werden die im "PDM Status" hinterlegten Artikelkennzeichen (derzeit lediglich Sperrkennzeichen) übertragen. Abschließend werden dann noch die weiteren Daten aus der Schnittstelleninformation (z.B. Beschreibung) dem Datensatz ergänzt.
Das Artikelkennzeichen "neuer PDM Artikel" wird über die Artikelvorlage in den Artikel übernommen und kann somit variabel zur abschließenden Datenprüfung eingerichtet werden.
Hinweis
Das Feld "PDM Status" dient der Darstellung des Bearbeitungsstandes innerhalb des PDM-Systems und das Feld "Neuer PDM Artikel" stellt die aktuelle Situation im ERP-System dar. Sofern über die Artikelvorlage der Artikel "vollständig" von der Schnittstelle erstellt werden kann, so kann in der jeweiligen Artikelvorlage das Feld "Neuer PDM Artikel" auf "nein" eingestellt werden.
Die Zuweisung einer Fertigungsstückliste ist im Regelfall bei einer Neuanlage für einen Artikel nicht möglich, da zu diesem Zeitpunkt die Fertigungsstückliste in Microsoft Dynamics 365 Business Central1 noch nicht angelegt oder erstellt ist. Des Weiteren muss bei der Zuweisung auch der Einheitencode der Fertigungsstückliste mit den bestehenden Artikeleinheiten abgeglichen werden. Bei Bedarf muss in den Artikeleinheiten der Einheitencode der Fertigungsstückliste mit entsprechender Mengenumrechnung angelegt werden.
Neuanlage Artikelvariante#
Die am übergeordneten Artikel zugeordneten Artikelattribute werden bei der Neuanlage einer Artikelvariante automatisch mit den Werten übernommen und können über die separate API-Page für Artikelattribute geändert bzw. ergänzt werden.
Änderungen Artikel#
Die Änderung von Artikelstammdaten unterliegt teilweise verschiedener Feld abhängiger Restriktionen:
Basiseinheitencode:
Der Basiseinheitencode kann nur geändert werden, wenn der Artikel keinen "offenen" Lagerbestand ausweist.
Artikelkategoriencode:
Bei Änderung des Artikelkategoriencodes werden die Stammdateninformationen aus der
Artikelvorlage ignoriert und nicht in den Artikel übernommen. Die Artikelattribute am Artikel und den abhängigen Artikelvarianten bzw. -versionen, die über den Artikelkategoriencode generiert wurden, werden generell aktualisiert.
Hinweis
Bei Übergabe von "leeren" Feldinhalten wird das Feld im bestehenden Stammdatensatz überschrieben. Somit empfiehlt es sich, bei Änderungen auch nur die "geänderten" Felder bzw. der Feldinhalte zu übergeben