Aufträge aus Ihrem Katana-ERP-System lesen und schreiben
This connector is a good starting point that implements a core set of the service's most common functions. You should expect to extend it by adding functions for the specific endpoints your workflow requires. Additionally, some configuration may be required in Katana ERP to establish a connection with Tulip. Please review our [connectors](/r230/docs/<span translate=)">connector framework to learn more about how to build and modify connectors in Tulip.
Einführung
Katana ist eine cloudbasierte Fertigungs-ERP-Software (Enterprise Resource Planning) für kleine und mittelständische Unternehmen, die nach einer kostengünstigen und zugleich flexiblen Lösung suchen. Das Katana-Fertigungs-ERP bietet eine breite Palette an Funktionen, von der Bestandsverwaltung und Produktionsplanung über die Auftragsabwicklung bis hin zum Materialeinkauf, um die Fertigungsabläufe durchgängig zu optimieren. Katana bietet verschiedene Tarife an, die auf Ihre Unternehmensgröße und Ihren Reifegrad zugeschnitten sind. Außerdem steht ein Implementierungspaket (gegen Aufpreis) zur Verfügung, damit Sie schnell einsatzbereit sind.Das Ziel dieser Anwendung ist es, eine Testumgebung und eine MVP-Lösung bereitzustellen, mit der Sie die Mengen von Arbeitsaufträgen aus der Fertigung verfolgen sowie Arbeitsaufträge abschließen können. Diese Lösung und dieser Konnektor lassen sich mithilfe des App-Editors und des Konnektor-Frameworks von Tulip um weitere Funktionen erweitern.
Zweck
Wir werden verschiedene Konnektorfunktionen vorstellen, die durch HTTP-Aufrufe an die API von Katana MRP erstellt werden können, um mit den Daten zu interagieren und grundlegende CRUD-Operationen in Katana durchzuführen. Mit den für den Konnektor verwendeten Funktionen können Sie eine Liste von Arbeitsaufträgen abrufen, Arbeitsaufträge aktualisieren usw.
API-Dokumentation
Katana MRP-API-DokumentationÜbersicht über die Katana MRP-APIs auf YouTube
Voraussetzungen
Sie benötigen ein Katana-Konto und müssen einen Live-API-Schlüssel generieren:
- Melden Sie sich bei Ihrem Katana -Konto an{target="_blank"}
- Gehen Sie zu „Einstellungen“ > „API“
- Wählen Sie „Neuen API-Schlüssel hinzufügen“
Tulip-Verbindungsdetails
Die folgenden Informationen müssen in den Tulip-Konnektoren konfiguriert werden. Zunächst in den Verbindungsdetails:
- Ausgeführt auf: Cloud-Connector-Host
- Host: api.katanamrp.com
- Port: 443
- TLS: ja
Anschließend in der Header-Ansicht: 1. Wählen Sie „OAuth 2 (Bearer-Token)“ aus. 2. Präfix: „Bearer“ 3. Token: Geben Sie den im vorherigen Schritt abgerufenen API-Schlüssel ein. 4. Fügen Sie einen Header mit dem Namen „Accept“ und dem Wert „application/json“ hinzu. 5. Fügen Sie einen Header mit dem Namen „content-type“ und dem Wert „application/json“ hinzu.
Konnektor-Funktionen
Alle Fertigungsaufträge auflisten – sourceGibt eine Liste der von Ihnen zuvor erstellten Fertigungsaufträge zurück. Die Fertigungsaufträge werden sortiert zurückgegeben, wobei die neuesten Fertigungsaufträge an erster Stelle stehen.
Methode: GET
Endpunkthttps://api.katanamrp.com/v1/manufacturing\_orders
Parameter: k. A.
Ausgaben: Die Connector-Funktion gibt die Details des Fertigungsauftrags zurück. Hier sind einige dieser Felder: Fertigungsauftrags-ID, Fertigungsauftragsnummer, Variante, Geplantes Startdatum, Fälligkeitsdatum, Status des Fertigungsauftrags, Geplante Menge, Tatsächliche Menge, Abgeschlossene Menge```
**Alle Fertigungsaufträge nach Status auflisten** – [source](https://developer.katanamrp.com/reference/getallmanufacturingorders){target="\_blank"}Gibt eine Liste der zuvor erstellten Fertigungsaufträge zurück. Die Fertigungsaufträge werden sortiert zurückgegeben, wobei die neuesten Fertigungsaufträge an erster Stelle stehen.
Methode: GET
Endpunkthttps://api.katanamrp.com/v1/manufacturing_orders?status={status}
ParameterStatus: (Text) einer der in Katana MRP bekannten Standardstatus (NOT_STARTED, BLOCKED, IN_PROGRESS, DONE)
Ausgaben: Die Connector-Funktion gibt die Details des Fertigungsauftrags zurück. Hier sind einige dieser Felder: Fertigungsauftrags-ID, Fertigungsauftragsnummer, Variante, Geplantes Startdatum, Fälligkeitsdatum, Status des Fertigungsauftrags, Geplante Menge, Tatsächliche Menge, Abgeschlossene Menge```
Fertigungsauftrag aktualisieren – QuelleAktualisiert die Produktion des angegebenen Fertigungsauftrags durch Festlegen der Werte der übergebenen Parameter.
Methode: PATCH
Endpunkthttps://api.katanamrp.com/v1/manufacturing\_order\_productions/{id}
ParameterAuftrags-ID: (Ganzzahl) Auftrags-IDStatus: (Text) Neuer AuftragsstatusIstmenge: (Ganzzahl) Neue Istmenge des Auftrags
Ausgaben: Die Connector-Funktion gibt die Details des Fertigungsauftrags zurück. Hier sind einige dieser Felder: Fertigungsauftrags-ID, Fertigungsauftragsnummer, Variante, Geplantes Startdatum, Fälligkeitsdatum, Fertigungsauftragsstatus, Geplante Menge, Tatsächliche Menge, Abgeschlossene Menge```
**Fertigungsauftrag abrufen** – [Quelle](https://developer.katanamrp.com/reference/getmanufacturingorderproduction){target="\_blank"}Ruft die Details eines bestehenden Fertigungsauftrags anhand der ID ab.
Methode: GET
Endpunkthttps://api.katanamrp.com/v1/manufacturing_order_productions/{id}
ParameterAuftrags-ID: (Ganzzahl) Auftrags-ID
Ausgaben: Die Connector-Funktion gibt die Details des Fertigungsauftrags zurück. Hier sind einige dieser Felder: Fertigungsauftrags-ID, Fertigungsauftragsnummer, Variante, Geplantes Startdatum, Fälligkeitsdatum, Status des Fertigungsauftrags, Geplante Menge, Tatsächliche Menge, Abgeschlossene Menge```