Parameter Planung APS
Mit dieser Funktion wird die Schnittstelle zum Supply-Chain-Produkt parametriert: AZAP.
Mit dieser Schnittstelle werden über Datendateien im .csv-Format die Datenflüsse nach und von AZAP verwaltet.
Diese Datenströme betreffen das Bestandsmodul:
X3 nach AZAP:
- Artikel / Produkte
- Umrechnung der Artikeleinheiten
- Artikelkriterien
- Standorte / Kunde
- Kriterien Standorte / Kunden
- Verkaufsverlauf
- Lfd Aufträge
AZAP nach X3:
- Verkaufsprognose
Nach der Parametrierung wird die Verarbeitung mit folgender Funktion aufgerufen: Schnittstellenaufruf SCM AZAP
Vorbedingungen
Siehe Dokumentation Umsetzung
Maskenverwaltung
Erfassungsmaske
Übersicht
Die Parametrierung umfasst:
- Standardarbeitsverzeichnis für die Suche nach zu importierenden Dateien und für die Generierung der zu exportierenden Dateien.
- Standardablageverzeichnis für die verarbeiteten Dateien.
- Die Referenzen für die Import- / Exportschnittstellenbeschreibungen der zu verarbeitenden .csv-Dateien ggf. unter Angabe von:
- Auswahl für den Export von Artikeln, laufenden Aufträgen und Verkaufsverläufen,
- Anzahl von Verpackungseinheiten, deren Umrechnungsdaten inklusive Lagereinheit exportiert werden,
- Auswahl der Kriterien zu den zu exportierenden Artikeln und Standorten,
- Aggregationsebene der Verkaufsdaten,
- Vorgabe, ob die alten oder sämtliche Verkaufsprognosen beim Import von neuen Verkaufsprognosen gelöscht werden sollen
Schließen
Felder
In diesem Register befinden sich die folgenden Felder :
Blocknummer 1
| Identifikationscode des Schnittstellenparameters. |
|
|
Blocknummer 2
|
|
|
|
|
|
Exporte
| Angabe des Pivotcodes, der die Zeilen der zu exportierenden Datei Artikel beschreibt: produits.csv. |
| Dieses Feld ermöglicht die Angabe einer Artikelauswahlreferenz, die standardmäßig beim Start der Schnittstellenverarbeitung vorgeschlagen wird.
|
| Angabe des Pivot-Codes, der die Zeilen der zu exportierenden Datei Artikel/Umrechnungen beschreibt: conversion.csv. |
|
|
| Die erste Position der Datei Artikel/Umrechnungen enthält systematisch für jeden Artikel die Umrechnungsinformationen zwischen Verkaufseinheit und Bestandseinheit. |
|
|
|
|
|
|
|
|
| Angabe des Pivot-Codes, der die Zeilen der zu exportierenden Datei Artikel/Kriterien beschreibt: critstr.csv. |
| Für alle Kriterien kann in der Datei auch entweder der Code oder die Bezeichnung oder der Code und die Bezeichnung eingeschlossen sein. |
|
|
| Die Statistikgruppenkriterien 1-5 werden nur exportiert, wenn die entsprechenden Optionen aktiviert sind. |
|
|
|
|
|
|
|
|
|
|
|
|
| Dieses Kriterium wird nur exportiert, wenn die entsprechende Option aktiviert ist. |
|
|
|
|
| Angabe des Pivot-Codes, der die Zeilen der zu exportierenden Datei Standorte beschreibt: sites.csv. |
| Angabe des Pivot-Codes, der die Zeilen der zu exportierenden Datei Standorte/Kriterien beschreibt: critstrsite.csv. |
| Für alle Kriterien kann in der Datei auch entweder der Code oder die Bezeichnung oder der Code und die Bezeichnung eingeschlossen sein. |
|
|
| Dieses Kriterium wird nur exportiert, wenn die entsprechende Option aktiviert ist. |
|
|
|
|
|
|
| Die Statistikgruppenkriterien 1-5 werden nur exportiert, wenn die entsprechenden Optionen aktiviert sind. |
|
|
|
|
|
|
|
|
|
|
| Dieses Kriterium wird nur exportiert, wenn die entsprechende Option aktiviert ist. |
|
|
Exporte Verkäufe
| Optionsfeld, über das die Aggregationsebene angegeben werden kann. Aggregationsebene zur Definition der Datengruppierung bei den Verlaufsdaten und bei den laufenden Aufträgen. |
| Dieses Feld ermöglicht die Angabe der Referenz einer Auswahl von Aufträgen, die für die aktuellen Aufträge und den Verkaufsverlauf angewendet werden, wenn dieser Verlauf aus den saldierten Aufträgen stammt. |
| Angabe des Pivot-Codes, der die Zeilen der zu exportierenden Datei Verkaufshistorie beschreibt: ventes.csv. |
| Diese Option ist ausgewählt, um anzugeben, dass die Verkaufshistorie aus den Lieferungen und Rechnungen stammt, die ausgewählt werden können, indem der Code einer Auswahl im folgenden Feld angegeben wird.
|
| Dieses Feld kann nur erfasst werden, wenn der Verkaufsverlauf aus den Lieferungen und Rechnungen stammen muss. |
|
|
|
|
| Diese Option wird ausgewählt, um anzugeben, dass die Verkaufshistorie aus den saldierten Aufträgen stammt, für die bereits eine Menge geliefert oder fakturiert wurde. |
| Angabe des Pivot-Codes, der die Zeilen der zu exportierenden Datei Aktuelle Aufträge beschreibt: carnet.csv. |
Importe
| Angabe des Pivot-Codes, der die Zeilen der zu importierenden Datei Prognosen beschreibt: previsions.csv. |
| Diese Option ermöglicht die Angabe, dass die alten Prognosen der einzelnen Artikel der importierten Datei vor dem Import der neuen gelöscht werden. |
| Diese Option ermöglicht die Angabe, dass alle Prognosen vor der Dateiverarbeitung gelöscht werden. |
Schließen
Zu Grunde liegende Prinzipien
Die Schnittstellenverarbeitung wird mithilfe von .csv-Dateien ausgeführt.
Allgemeine Angaben zu diesen Dateien
- Format: .csv
- Typ: ASCII (änderbar über einen Eingabepunkt, siehe unten)
- Die Felder sind von variabler Länge und per ";" getrennt (das Trennzeichen kann im Eingabepunkt geändert werden, siehe unten)
- Das Trennzeichen für Zahlen lautet: Punkt
- Das Datenformat lautet "JJJJMMTTHHmm" oder "JJJJMMTT".
- Die Dauer wird in Stunden ausgedrückt.
- Booleans können die folgenden Werte annehmen: 1 (falsch) oder 1 (wahr)
- Es handelt sich um DOS-Dateien (letztes Zeichen der Zeile: \013\010 oder \r\n).
- Dateien haben Kopfzeilen.
Die in diesen Dateien enthaltenen Zeilen werden in einer Beschreibung erläutert. Hier werden die Reihenfolge der Felder, die Feldlängen und die Belegung (direkt aus Tabellenfeldern oder über Funktionen) angegeben.
Nachstehend sind die Namen der Dateien, ihre Beschreibung und die standardmäßigen Schnittstellenbeschreibungen aufgelistet.
Nicht übertragene Daten
- Die Bewertungen: Diese werden in der Schnittstelle nicht verwaltet. Betrags- und Währungsdaten (zu Artikeln und Verkäufen) werden in dieser Schnittstelle in der Standardversion nicht übertragen.
- Außerplanmäßige, d. h. nicht systematisch auftretende Ereignisse mit Auswirkungen auf den Verkauf (z. B. Werbeaktionen) werden nicht übertragen.
Export: X3 --- AZAP
Erwartete Dateien |
| Schnittstellenbeschreibung |
Artikel / Produkte | SCMAITM | |
Artikel / Umrechnung | SCMAITMTCO | |
Artikel / Kriterien | SCMAITMCRI | |
Standorte | SCMAFCY | |
Standorte / Kriterien | SCMACRIFCY | |
Verlauf Verkäufe | SCMAHSOH | |
Laufende Aufträge / Auftragsbuch | SCMASOH |
Import: AZAP --- X3
Erwartete Dateien |
| Schnittstellenbeschreibung |
Verkaufsprognose | SCMASOS |
Eingabepunkte
Mit dem Eingabepunkt PIVOTSFILE der Verarbeitung CONNECTFCT können der Kodierungstyp der Dateien und das Spaltentrennzeichen geändert werden.
Beschreibung der aus Sage X3 exportierten Dateien
Artikel: produits.csv
Schnittstellenbeschreibung: SCMAITM
Datei | Nr. | Bezeichnung | Typ | max. | Optional | Schnittstellenbeschreibung | Tabellen | Feld- | Titel
| Feld |
| 1 | Host-Code Produkt | A | 20 | Nein |
| ITMMASTER | ITMREF | Artikel | Nein |
| 2 | Artikel- | A | 30 | Ja |
| ITMMASTER | ITMDES1 | Bezeichnung 1 | Nein |
| 3 | Bezeichnung 2 Artikel | A | 30 | Ja |
| ITMMASTER | ITMDES2 | Bezeichnung 2 | Nein |
| 4 | Verkaufseinheit | A | 3 | Ja |
| ITMMASTER | SAU | Verkaufseinheit | Nein |
Hinweise:
- Die Dateikopfzeile umfasst die in der Schnittstellenbeschreibung parametrierten Spaltencodes.
- Nur Artikel vom Typ "verkauft" (geführt in der Artikelkategorie) werden exportiert.
- Die Parametrierung ermöglicht die Erfassung einer Artikelauswahl: Zu den in der Auswahl enthaltenen Artikeln werden die Umrechnungsdaten sowie die Artikelkriterien in getrennte Dateien exportiert: conversion.csv et critstr.csv
Artikel / Umrechnungen: conversion.csv
Schnittstellenbeschreibung: SCMAITMTCO
Datei | Nr. | Bezeichnung | Typ | max. | Optional | Schnittstellenbeschreibung | Tabellen | Feld- | Titel
| Feld |
| 1 | Host-Code Produkt | A | 20 | Nein |
| ITMMASTER | ITMREF | Artikel | Nein |
| 2 | Einheit 1 | A | 3 | Nein |
| ITMMASTER | WUOM1 |
| Nein |
| 3 | Einheit 2 | A | 3 | Nein |
| ITMMASTER | WUOM2 |
| Nein |
4 | Koeffizient | N |
| Nein |
| ITMMASTER | WCOEUOM |
| Nein |
Hinweise:
- Die Dateikopfzeile umfasst die in der Schnittstellenbeschreibung parametrierten Spaltencodes.
- Die Datei umfasst pro Artikel:
- eine erste Zeile mit den Umrechnungsdaten zwischen Verkaufseinheit und Lagereinheit. Diese Zeile ist auch dann vorhanden, wenn Verkaufseinheit und Lagereinheit identisch sind.
- optionale Zeilen zur Umrechnung zwischen den vier Verpackungseinheiten und der Lagereinheit gemäß Parametrierung.
Artikel / Kriterien: critstr.csv
Schnittstellenbeschreibung: SCMAITMCRI
Datei | Nr. | Bezeichnung | Typ | max. | Optional | Schnittstellenbeschreibung | Tabellen | Feld- | Titel
| Feld |
| 1 | Host-Code Produkt | A | 20 | Nein |
| ITMMASTER | ITMREF | Artikel | Nein |
| 2 | Status AZAP (1) | A |
| Nein |
| ITMMASTER | WAZAPSTA | Status AZAP | Nein |
| 3 | Artikelstatus (2) | A |
| Nein |
| ITMMASTER | ITMSTA | Status Artikel | Nein |
| 4 | Statistikgruppe 1 | A |
| Ja |
| ITMMASTER | WTSICOD0 | Statistikgruppe 1 | Nein |
| 5 | Statistikgruppe 2 | A |
| Ja |
| ITMMASTER | WTSICOD1 | Statistikgruppe 2 | Nein |
| 6 | Statistikgruppe 3 | A |
| Ja |
| ITMMASTER | WTSICOD2 | Statistikgruppe 3 | Nein |
| 7 | Statistikgruppe 4 | A |
| Ja |
| ITMMASTER | WTSICOD3 | Statistikgruppe 4 | Nein |
| 8 | Statistikgruppe 5 | A |
| Ja |
| ITMMASTER | WTSICOD4 | Statistikgruppe 5 | Nein |
| 9 | Kategorie | A |
| Ja |
| ITMMASTER | TCLCOD | Kategorie | Nein |
| 10 | Produktlinie | A |
| Ja |
| ITMMASTER | CFGLIN | Produktposition | Nein |
11 | Verwaltung | A |
| Ja |
| ITMMASTER | PLANNER | Planung | Nein |
(1) Artikel mit aktivem Status: AZAP-Status = 1, sonstige Fälle: AZAP-Status = 0.
(2) Die Artikelstatus sind im Lokalen Menü 246 definiert.
Hinweise:
- Die Dateikopfzeile umfasst die in der Schnittstellenbeschreibung parametrierten Spaltentitel. Deren Länge darf 15 Zeichen nicht überschreiten.
- Je nach Parametrierung können zu den einzelnen Kriterien entweder nur der Code oder nur die Bezeichnung oder beide Angaben vorhanden sein: Code und Bezeichnung.
- Je nach Parametrierung können die Kriterien 4 bis 11 exportiert werden. Dies ist jedoch nicht zwingend notwendig. Werden sie nicht exportiert, sind die Spalten in der Datei nicht vorhanden.
Standorte: sites.csv
Schnittstellenbeschreibung: SCMAFCY
Datei | Nr. | Bezeichnung | Typ | max. | Optional | Schnittstellenbeschreibung | Tabellen | Feld- | Titel
| Feld |
| 1 | Code Standorthost | A | 15 | Nein |
| FACILITY | FCY | Standort | Nein |
| 2 | Langbezeichnung | A | 35 | Ja |
| FACILITY | FCYNAM | Name | Nein |
| 3 | Kurzbezeichnung | A | 10 | Ja |
| FACILITY | FCYSHO | Kurzbezeichnung | Nein |
Hinweise:
- Die Dateikopfzeile umfasst die in der Schnittstellenbeschreibung parametrierten Spaltencodes.
- Standorte im AZAP-Sinne sind Kunden oder Lager. Daher werden sämtliche Kunden und sämtliche Lagerstandorte in diese Datei exportiert. Die Unterscheidung wird direkt in AZAP getroffen.
- Die Standortkriterien werden in eine getrennte Datei exportiert: critstrsite.csv
Standorte / Kriterien: critstrsite.csv
Schnittstellenbeschreibung: SCMACRIFCY
Datei | Nr. | Bezeichnung | Typ | max. | Optional | Schnittstellenbeschreibung | Tabellen | Feld- | Titel
| Feld |
| 1 | Code Standorthost | A | 15 | Nein |
| FACILITY | FCY | Standort | Nein |
| 2 | Land | A |
| Nein |
| BPARTNER | CRY | Land | Nein |
| 3 | Kategorie | A |
| Ja |
| BPCUSTOMER | BCGCOD | Kategorie | Nein |
| 4 | Statistikgruppe 1 | A |
| Ja |
| BPCUSTOMER | WTSCCOD0 | Statistikgruppe 1 | Nein |
| 5 | Statistikgruppe 2 | A |
| Ja |
| BPCUSTOMER | WTSCCOD1 | Statistikgruppe 2 | Nein |
| 6 | Statistikgruppe 3 | A |
| Ja |
| BPCUSTOMER | WTSCCOD2 | Statistikgruppe 3 | Nein |
| 7 | Statistikgruppe 4 | A |
| Ja |
| BPCUSTOMER | WTSCCOD3 | Statistikgruppe 4 | Nein |
| 8 | Statistikgruppe 5 | A |
| Ja |
| BPCUSTOMER | WTSCCOD4 | Statistikgruppe 5 | Nein |
| 9 | Rechnungsempfänger | A |
| Ja |
| BPCUSTOMER | BPCINV | Rechnungsempfänger | Nein |
| 10 | Gruppenkunde | A |
| Ja |
| BPCUSTOMER | BPCGRU | Gruppenkunde | Nein |
Hinweise:
- Die Dateikopfzeile umfasst die in der Schnittstellenbeschreibung parametrierten Spaltentitel. Deren Länge darf 15 Zeichen nicht überschreiten.
- Standorte im AZAP-Sinne sind Kunden oder Lager. Daher werden sämtliche Kunden und sämtliche Lagerstandorte in diese Datei exportiert. Die Unterscheidung wird direkt in AZAP getroffen.
- Je nach Parametrierung können zu den einzelnen Kriterien entweder nur der Code oder nur die Bezeichnung oder beide Angaben vorhanden sein: Code und Bezeichnung.
- Je nach Parametrierung können die Kriterien 2 bis 10 exportiert werden. Dies ist jedoch nicht zwingend notwendig. Werden sie nicht exportiert, sind die Spalten in der Datei nicht vorhanden.
Verlauf Verkäufe: ventes.csv
Schnittstellenbeschreibung: SCMAHSOH
Datei | Nr. | Bezeichnung | Typ | max. | Optional | Schnittstellenbeschreibung | Tabellen | Feld- | Titel
| Feld |
| 1 | Gewünschtes Lieferdatum | D |
| Nein |
| SORDERQ | DEMDLVDAT | Gewünschtes Lieferdatum | Nein |
| 2 | Code Verkaufsstandorthost | A |
| Nein |
| SORDERQ | BPCORD | Vertragskunde | Nein |
| 3 | Host-Code Produkt | A |
| Nein |
| SORDERQ | ITMREF | Artikel | Nein |
| 4 | Menge in VE (2) | N |
| Nein |
| SORDERQ | QTY | Bestellmenge | Nein |
| 5 | Code Ursprungsstandorthost | A |
| Nein |
| SORDERQ | STOFCY | Versandstandort | Nein |
(1) Je nach gewähltem Aggregationsniveau wird entweder das Wirksamkeitsdatum oder das Beginndatum der Periode (Woche oder Monat) bei der Datengruppierung berücksichtigt.
(2) Die Menge muss in Verkaufseinheiten ausgedrückt werden.
Hinweise:
- Die Dateikopfzeile umfasst die in der Schnittstellenbeschreibung parametrierten Spaltencodes.
- Stammt der Verlauf aus den abgeschlossenen Aufträgen, bezieht sich der Export auf die abgeschlossenen Aufträge mit einer gelieferten oder in Rechnung gestellten Menge. Die Parametrierung ermöglicht die Auswahl einer Auftragsselektion.
- Stammt der Verlauf aus den Lieferungen / Rechnungen, bezieht sich der Export auf die tatsächlich realisierten Elemente, d. h. auf die realen Flüsse:
+ freigegebene Lieferungen
+ freigegebene Direktrechnungen mit Bestandsbewegungen
+ freigegebene "Auftrags"rechnungen mit Bestandsbewegung
+ freigegebene "Liefer"rechnungspositionen mit Bestandsbewegung ohne Liefernummer
- Lieferretouren
- freigegebene Direktgutschriften mit Bestandsbewegung
- freigegebene Rechnungsgutschriften mit Bestandsbewegung
Der Parameter erlaubt die Erfassung einer Lieferungs-/Rechnungsauswahl.
Lfd Aufträge: carnet.csv
Schnittstellenbeschreibung: SCMASOH
Datei | Nr. | Bezeichnung | Typ | max. | Optional | Schnittstellenbeschreibung | Tabellen | Feld- | Titel
| Feld |
| 1 | Geplantes Lieferdatum (1) (2) | D |
| Nein |
| SORDERQ | EXTDLVDAT | Geplantes Lieferdatum | Nein |
| 2 | Code Verkaufsstandorthost | A |
| Nein |
| SORDERQ | BPCORD | Vertragskunde | Nein |
| 3 | Host-Code Produkt | A |
| Nein |
| SORDERQ | ITMREF | Artikel | Nein |
| 4 | Menge in VE (3) (4) | N |
| Nein |
| SORDERQ | TDLQTY | Zu liefernde Menge | Nein |
| 5 | Code Ursprungsstandorthost | A |
| Nein |
| SORDERQ | STOFCY | Versandstandort | Nein |
(1) Bei Kontrakten: gewünschtes Lieferdatum: DEMDLVDAT
(2) Je nach gewähltem Aggregationsniveau wird entweder das Wirksamkeitsdatum oder das Beginndatum der Periode (Woche oder Monat) bei der Datengruppierung berücksichtigt.
(3) Die Menge muss in Verkaufseinheiten ausgedrückt werden.
(4) Da nicht abgeschlossene Aufträge (aus dem Auftragsbuch) bereits über (im Verlauf berücksichtigte) gelieferte Mengen verfügen können, wird im Auftragsbuch nur die noch zu liefernde Menge geführt.
Hinweise:
- Die Dateikopfzeile umfasst die in der Schnittstellenbeschreibung parametrierten Spaltencodes.
- Der Export erstreckt sich über die nicht abgeschlossenen Auftragspositionen.
- Die Parametrierung ermöglicht die Auswahl einer Auftragsselektion.
Beschreibung der in Sage X3 importierten Dateien
Verkaufsprognosen: previsions..csv
Schnittstellenbeschreibung: SCMASOS
Datei | Nr. | Bezeichnung | Typ | max. | Optional | Schnittstellenbeschreibung | Tabellen | Feld- | Titel
| Feld |
| 1 | Prognosedatum (1) | D |
| Nein |
| ORDERS | ENDDAT | Endedatum | Nein |
| 2 | Code Ursprungsstandorthost | A |
| Nein |
| ORDERS | STOFCY | Lagerstandort | Nein |
| 3 | Host-Code Produkt | A |
| Nein |
| ORDERS | ITMREF | Artikel | Nein |
| 4 | Menge in STK (2) | N |
| Nein |
| ORDERS | EXTQTY | Sollmenge | Nein |
(1) Je nach in AZAP gewähltem Aggregationsniveau handelt es sich um das Wirksamkeitsdatum oder um das Periodenende.
(2) die Menge muss in Bestandseinheiten ausgedrückt werden.
Hinweise:
- Der Import erstreckt sich über die in AZAP vorgenommenen Verkaufsprognosen.
- Die erwartete Datei muss über eine Kopfzeile verfügen.
- Per Parametrierung können folgende Elemente gelöscht werden:
- entweder die alten Prognosen zu den Artikeln der importierten Datei, bevor die neuen Prognosen importiert werden,
- oder sämtliche Prognosen vor der Verarbeitung der Datei.