Funktion "GetPurchaseOrderData" von System "MSD365BC"

Ermittelt zu einer Bestellnummer notwendige Bestellinformationen.

Der Funktionsaufruf ist immer synchron.

Spezifikation der Anfrage

• Id (Text) - Bestellnummer, wie sie im ERP-System hinterlegt ist
• CompanyCode (Text) - Buchungskreis der Bestellung
• Type (Text) - Über den Typ sollen bestimmte Positionsarten bestimmt werden. Gültige Werte sind: [NONE, OPEN, POSTED, RETURNED]
  - NONE: Anfrage von Kopfdaten einer Bestellung ohne Positionen. Daraus folgt: Die Parameter 'Positions' und 'InformativePositions' werden immer eine leere Liste zurückliefern und 'GRExpected' liefert immer false.
  - OPEN: Im Ergebnis müssen die noch offenen Bestellpositionen enthalten sein. Dies sind die bebuchbaren Positionen für normale Rechnungen.
  - POSTED: Anfrage von bereits gebuchten Positionen, z.B. für eine nachträgliche Belastung/Entlastung.
  - RETURNED: Anfrage von gebuchten Positionen, die zurück geliefert wurden. Die sind die bebuchbaren Positionen für Gutschriften.
• Date (Datum) - Entspricht dem Buchungsdatum (im ISO 8601-Format), falls die Positionen rückwirkend ermittelt werden sollen.

Spezifikation des Ergebnisses

• Id (Text) - Bestellnummer, wie sie im ERP-System hinterlegt ist
• DocumentType (Text) - Art der Bestellung. Gültige Werte sind: [STANDARD]
• GRExpected (Boolesch) - Es wird noch Ware für eine Position erwartet
• InformativePositions (Liste von "Objekt", min. 0 Element(e)) - Liste von Positionsdaten, die rein informativen Charakter haben und nicht zur Buchung genutzt werden können
  • Id (Text) - ID der Bestellposition
  • ArticleType (Text) - Typ des Artikels. Gültige Werte sind: [GOOD, SERVICE, IC]
  • Currency (Text) - Die Währung der Position
  • Description (Text) - Die Beschreibung des Artikels, der Dienstleistung oder der Nebenkosten.
  • GRType (Text) - Definiert, um welche Art von Position es sich in Bezug auf den Wareneingang handelt. Folgende Werte werden unterstützt und haben Einfluss auf die GR-Parameter: [NONE, GREXPECTED, GRBIV]
    - NONE: Da kein Wareneingang erwartet wird, sind die Parameter 'GRId', 'GRDeliveryNoteNumber', 'GRPosition' und 'GRDate' nicht zu setzen.
    - GREXPECTED: Der Wareneingang hat rein informativen Charakter und ist nicht für die Buchung notwendig. Die Parameter 'GRId', 'GRDeliveryNoteNumber', 'GRPosition' und 'GRDate' können daher vorhanden sein, müssen aber nicht. Da keine automatisierte Auswertung vorgesehen ist, können die Informationen mehrerer Warenlieferungen als kommaseparierte Liste in die Parameter übertragen werden. Ausnahme ist der Parameter 'GRDate', für den das letzte Lieferdatum aller Lieferungen zu dieser Position zu verwenden ist.
    - GRBIV: Bei der Buchung von Positionen mit wareneingangsbezogener Rechnungsprüfung müssen die Parameter 'GRId', 'GRPosition' und 'GRDate' vorhanden und gesetzt sein. Ausnahme ist 'DeliveryNoteNumber', welche gesetzt sein sollte, aber nicht unbedingt notwendig ist.
  • NetUnit (Double) - Der Nettopreis einer Einheit der Bestellposition
  • Quantity (Double) - Die Liefermenge der Bestellposition
  • Unit (Text) - Die Liefereinheit der Bestellposition
  • Variances (Objekt) - Erlaubte Mengen- und Preisabweichungen einer Position
    • ExpectedPrice (Double) - Der noch erwartete Restbetrag der Position
    • ExpectedQuantity (Double) - Die noch erwartete Restmenge der Position
    • PriceDownward (Objekt) - Die untere Preisgrenze der Position
      • Type (Text) - Typ der Abweichung. Gültige Werte sind: [NONE, RELATIVE, ABSOLUTE, UNLIMITED]
      • Value (Double) - Der Wert der Abweichung für Typ RELATIVE oder ABSOLUTE. Für Typ ABSOLUTE wird der Betrag der noch möglichen Abweichung zurückgegeben. Erwartetes Format für Typ RELATIVE: 0,03 für 3%, 1,00 für 100%.
    • PriceUpward (Objekt) - Die obere Preisgrenze der Position
      • Type (Text) - Typ der Abweichung. Gültige Werte sind: [NONE, RELATIVE, ABSOLUTE, UNLIMITED]
      • Value (Double) - Der Wert der Abweichung für Typ RELATIVE oder ABSOLUTE. Für Typ ABSOLUTE wird der Betrag der noch möglichen Abweichung zurückgegeben. Erwartetes Format für Typ RELATIVE: 0,03 für 3%, 1,00 für 100%
    • QuantityDownward (Objekt) - Die untere Mengenbegrenzung der Position
      • Type (Text) - Typ der Abweichung. Gültige Werte sind: [NONE, RELATIVE, ABSOLUTE, UNLIMITED]
      • Value (Double) - Der Wert der Abweichung für Typ RELATIVE oder ABSOLUTE. Für Typ ABSOLUTE wird der Betrag der noch möglichen Abweichung zurückgegeben. Erwartetes Format für Typ RELATIVE: 0,03 für 3%, 1,00 für 100%
    • QuantityUpward (Objekt) - Die obere Mengenbegrenzung der Position
      • Type (Text) - Typ der Abweichung. Gültige Werte sind: [NONE, RELATIVE, ABSOLUTE, UNLIMITED]
      • Value (Double) - Der Wert der Abweichung für Typ RELATIVE oder ABSOLUTE. Für Typ ABSOLUTE wird der Betrag der noch möglichen Abweichung zurückgegeben. Erwartetes Format für Typ RELATIVE: 0,03 für 3%, 1,00 für 100%
  • ArticleNoCustomer (Text) - Artikelnummer des Kunden
  • ArticleNoVendor (Text) - Artikelnummer des Kreditors
  • RAType (Text) - Definiert, ob für die Position eine Prüfung und Genehmigung erforderlich ist. Folgende Werte werden unterstützt: [DONE, REQUIRED]
    - DONE: Prüfung und Genehmigung wurde bereits durchgeführt.
    - REQUIRED: Prüfung und Genehmigung ist erforderlich.
  • TaxCode (Text) - Das Steuerkennzeichen der Bestellposition
  • TaxRate (Double) - Der Steuersatz der Bestellposition. Erwartetes Format: 0,03 für 3%, 1,00 für 100%.
• InvoiceRecipientId (Text) - ID des Rechnungsempfängers
• Positions (Liste von "Objekt", min. 0 Element(e)) - Liste von Positionsdaten.
  • Id (Text) - ID der Bestellposition
  • ArticleType (Text) - Typ des Artikels. Gültige Werte sind: [GOOD, SERVICE, IC]
  • Currency (Text) - Die Währung der Position
  • Description (Text) - Die Beschreibung des Artikels, der Dienstleistung oder der Nebenkosten.
  • GRType (Text) - Definiert, um welche Art von Position es sich in Bezug auf den Wareneingang handelt. Folgende Werte werden unterstützt und haben Einfluss auf die GR-Parameter: [NONE, GREXPECTED, GRBIV]
    - NONE: Da kein Wareneingang erwartet wird, sind die Parameter 'GRId', 'GRDeliveryNoteNumber', 'GRPosition' und 'GRDate' nicht zu setzen.
    - GREXPECTED: Der Wareneingang hat rein informativen Charakter und ist nicht für die Buchung notwendig. Die Parameter 'GRId', 'GRDeliveryNoteNumber', 'GRPosition' und 'GRDate' können daher vorhanden sein, müssen aber nicht. Da keine automatisierte Auswertung vorgesehen ist, können die Informationen mehrerer Warenlieferungen als kommaseparierte Liste in die Parameter übertragen werden. Ausnahme ist der Parameter 'GRDate', für den das letzte Lieferdatum aller Lieferungen zu dieser Position zu verwenden ist.
    - GRBIV: Bei der Buchung von Positionen mit wareneingangsbezogener Rechnungsprüfung müssen die Parameter 'GRId', 'GRPosition' und 'GRDate' vorhanden und gesetzt sein. Ausnahme ist 'DeliveryNoteNumber', welche gesetzt sein sollte, aber nicht unbedingt notwendig ist.
  • NetUnit (Double) - Der Nettopreis einer Einheit der Bestellposition
  • Quantity (Double) - Die Liefermenge der Bestellposition
  • Unit (Text) - Die Liefereinheit der Bestellposition
  • Variances (Objekt) - Erlaubte Mengen- und Preisabweichungen einer Position
    • ExpectedPrice (Double) - Der noch erwartete Restbetrag der Position
    • ExpectedQuantity (Double) - Die noch erwartete Restmenge der Position
    • PriceDownward (Objekt) - Die untere Preisgrenze der Position
      • Type (Text) - Typ der Abweichung. Gültige Werte sind: [NONE, RELATIVE, ABSOLUTE, UNLIMITED]
      • Value (Double) - Der Wert der Abweichung für Typ RELATIVE oder ABSOLUTE. Für Typ ABSOLUTE wird der Betrag der noch möglichen Abweichung zurückgegeben. Erwartetes Format für Typ RELATIVE: 0,03 für 3%, 1,00 für 100%
    • PriceUpward (Objekt) - Die obere Preisgrenze der Position
      • Type (Text) - Typ der Abweichung. Gültige Werte sind: [NONE, RELATIVE, ABSOLUTE, UNLIMITED]
      • Value (Double) - Der Wert der Abweichung für Typ RELATIVE oder ABSOLUTE. Für Typ ABSOLUTE wird der Betrag der noch möglichen Abweichung zurückgegeben. Erwartetes Format für Typ RELATIVE: 0,03 für 3%, 1,00 für 100%
    • QuantityDownward (Objekt) - Die untere Mengenbegrenzung der Position
      • Type (Text) - Typ der Abweichung. Gültige Werte sind: [NONE, RELATIVE, ABSOLUTE, UNLIMITED]
      • Value (Double) - Der Wert der Abweichung für Typ RELATIVE oder ABSOLUTE. Für Typ ABSOLUTE wird der Betrag der noch möglichen Abweichung zurückgegeben. Erwartetes Format für Typ RELATIVE: 0,03 für 3%, 1,00 für 100%
    • QuantityUpward (Objekt) - Die obere Mengenbegrenzung der Position
      • Type (Text) - Typ der Abweichung. Gültige Werte sind: [NONE, RELATIVE, ABSOLUTE, UNLIMITED]
      • Value (Double) - Der Wert der Abweichung für Typ RELATIVE oder ABSOLUTE. Für Typ ABSOLUTE wird der Betrag der noch möglichen Abweichung zurückgegeben. Erwartetes Format für Typ RELATIVE: 0,03 für 3%, 1,00 für 100%
  • AlternativePackagings (Liste von "Objekt", min. 1 Element(e)) - Liste von alternativen Verpackungsgrößen
    • NetUnit (Double) - Alternativer Stückpreis
    • Quantity (Double) - Alternative Stückzahl
    • Unit (Text) - Alternative Verpackungseinheit
  • ArticleNoCustomer (Text) - Artikelnummer des Kunden
  • ArticleNoVendor (Text) - Artikelnummer des Kreditors
  • GRDate (Datum) - Entspricht dem Wareneingangsdatum (im ISO 8601-Format), wie es im ERP-System gebucht ist
  • GRDeliveryNoteNumber (Text) - Dabei handelt es sich um die Lieferscheinnummer, wie sie auf dem Beleg steht.
  • GRId (Text) - Dabei handelt es sich um die Wareneinangsnummer, die der ID im ERP-System entspricht.
  • GRPosition (Text) - Dabei handelt es sich um die Wareneingangsposition.
  • RAType (Text) - Definiert, ob für die Position eine Prüfung und Genehmigung erforderlich ist. Folgende Werte werden unterstützt: [DONE, REQUIRED]
    - DONE: Prüfung und Genehmigung wurde bereits durchgeführt.
    - REQUIRED: Prüfung und Genehmigung ist erforderlich.
  • TaxCode (Text) - Das Steuerkennzeichen der Bestellposition
  • TaxRate (Double) - Der Steuersatz der Bestellposition. Erwartetes Format: 0,03 für 3%, 1,00 für 100%
• VendorId (Text) - Die ID des Kreditors
• TermsOfPayment (Objekt) - Zahlungsbedingungen
  • Discounts (Liste von "Objekt", min. 0 Element(e)) - Liste von Rabatt-Details aufsteigend sortiert nach 'Days'
    • Days (Integer) - Dauer der Gültigkeit des Rabatts in Tagen
    • Discount (Double) - Prozentsatz des Rabatts. Erwartetes Format: 0,03 für 3%, 1,00 für 100%
  • DueDays (Integer) - Anzahl Tage, bis die Zahlung fällig wird
  • Id (Text) - Zahlungsbedingungsschlüssel
  • BaseLineDate (Datum) - Zahlungsfristenbasisdatum der Zahlungsbedingung (im ISO 8601-Format)
  • PaymentMethod (Text) - Zahlweg