createArticle (Version 3)

Legt einen Artikel im WWS (Waren-Wirtschafts-System) neu an.

Objekt: /net/dsb/vhs3/ArticleMaster
Methode: createArticle
Version: 3.0.0

Parameter

Name	Typ / Länge	Kann / Muss	Beschreibung
create-article	XML	M	Siehe XML Beschreibung unten

Rückgabe Element

Leerer MessageFrame

Beispiel Request

<?xml version="1.0" encoding="UTF-8"?>
<message version="1.0" system="vhs/3" >
  <header>
    <client>4711</client>
    <service-provider>999</service-provider>
  </header>
  <body>
      <!-- 0 ... 100 -->
      <create-article>
      ...
      <create-article>
  </body>
</message>

Beispiel Response

Bei einer erfolgreichen Artikelanlage wird nur eine leere Message zurück gegeben. Im Fehlerfall wird ein SOAP Fehler zurück gegeben.

<?xml version="1.0" encoding="UTF-8"?>
<message version="1.0" system="vhs/3">
  <header>
    <client>4711</client>
    <service-provider>999</service-provider>
  </header>
  <body>
  </body>
</message>

Request Struktur

Aufbau <create-article>

<!-- 0 ... 100 -->
<create-article>
  <external-transaction-id></external-transaction-id>
  <article>
    <distribution-article-number></distribution-article-number>
    <distribution-article-number-external></distribution-article-number-external>
    <rep-article-number></rep-article-number>
    <stock-article-number></stock-article-number>
    <stock-article-description></stock-article-description>
    <stock-article-description-suffix></stock-article-description-suffix>
    <stock></stock>
    <!-- 0 ... 10 -->
    <distribution-article-description>
      <language-code></language-code>
      <description1></description1>
      <description2></description2>
      <description3></description3>
      <description4></description4>
      <description5></description5>
    </distribution-article-description >
    <release-date></release-date>
    <delivery-code></delivery-code>
    <article-type></article-type>
    <article-status></article-status>
    <article-class></article-class>
    <article-group></article-group>
    <product-group></product-group>
    <product-category></product-category>
    <isbn></isbn>
    <ean></ean>
    <special-ean></special-ean>
    <cost-center></cost-center>
    <drawing-number></drawing-number>
    <part-family></part-family>
    <part-family-text></part-family-text>
    <!-- 0 ... 20 -->
    <price>
      <price-list></price-list>
      <standard-price></standard-price>
    </price>
    <!-- 0 ... 40 -->
    <value-added-tax>
      <vat-country-code></vat-country-code>
      <vat-distribution-channel></vat-distribution-channel>
      <value-added-tax-rate>
        <vat-category-code></vat-category-code>
        <vat-percentage></vat-percentage>
        <vat-value></vat-value>
      </value-added-tax-rate>
    </value-added-tax>
    <distribution-channel number="1234">
      <eshop-article-flag></eshop-article-flag>
      <cc-article-flag></cc-article-flag>
    </distribution-channel>
    <schedule-code></schedule-code>
    <shipping-type></shipping-type>
    <shipping-cost-group></shipping-cost-group>
    <shipping-cost></shipping-cost>
    <weight></weight>
    <length></length>
    <width></width>
    <height></height>
    <object-number></object-number>
    <inventory-manager></inventory-manager>
    <sales-price-internal-unit></sales-price-internal-unit>
    <sales-price-internal></sales-price-internal>
    <purchasing-price></purchasing-price>
    <duty-tariff-number></duty-tariff-number>
    <standard-supplier></standard-supplier>
    <revenue-group-code></revenue-group-code>
    <accounting-area></accounting-area>
    <timestamp-of-last-article-update></timestamp-of-last-article-update>
    <!-- 0 ... 20 -->
    <set-component>
    </set-component>
    <size></size>
    <season></season>
    <collection></collection>
    <hazmat>
      <hazmat-un-code></hazmat-un-code>
      <!-- 0 ... 40 -->
      <hazmat-flags>
        <hazmat-country-code></hazmat-country-code>
        <hazmat-code></hazmat-code>
      </hazmat-flags>
    </hazmat>
  </article>
</create-article>

Element Definitions

Field	Mandatory	Length	Type	Remark, field supply or encoding
external-transaction-id	X	40	AN	externe Transaktionsnummer(unique identifier)
distribution-article-number	X	13	AN	Vertriebs-Artikel-Nr.
distribution-article-number-external		20	AN	Vertriebs-Artikel-Nr. (extern)
rep-article-number		13	AN	Replacement article number
stock-article-number		18	AN	Lager-Artikel-Nr.
stock-article-description		18	AN	Lager-ArtikelBeschreibung
stock-article-description-suffix		18	AN	Lager-ArtikelBeschreibung Zusatz
distribution-article-description 0 … 10
* language-code	X	2	AN	ISO-Sprachcode
* description1	X	35	AN	Vertriebsartikel Bezeichnung
* description2		35	AN	Zusatzbezeichnung
* description3		35	AN	Zusatzbezeichnung
* description4		35	AN	Zusatzbezeichnung
* description5		35	AN	Zusatzbezeichnung
release-date		10	DT	release date ISO format
delivery-code	M	2	AN	Lieferkennzeichen
article-type	M	1	N	Artikeltyp: 1 = Lagerartikel 2 = Set/Pseudoartikel 3 = Dienstleister(DL) Artikel
article-status	M	1	N	Artikel-Status 1 = aktiv, 2 = inaktiv
article-class		4	AN	Artikelklasse
article-group		10	AN	Artikelgruppe
product-group		4	AN	Produktgruppe
product-category		1	AN	Kennzeichen
isbn		20	AN	Internationale Standardbuchnummer
ean		13	AN	International Article Number(früher European Article Number)
special-ean		13	AN
cost-center		8	AN	Kostenstelle
drawing-number		18	AN
part-family		4	AN
part-family-text		50	AN
price 0 … 20
* price-list	X	4	AN	Code einer existierenden Preisliste
* standard-price	X	7,2	N	Standardpreis, eigentlicher Preis (Betrag)
value-added-tax 0 … 40
* vat-country-code	X	3	AN	ISO-Country code
* vat-distribution-channel		4	AN	distribution channel where this vat is valid
value-added-tax-rate 0 … n
* vat-category-code		3	AN	Mehrwertsteuercode
* vat-percentage		3,2	N	Anteil dieses Mehrwertsteuersatzes am gesamten MwSt.-Betrag. Die Summe akker Mehrwertsteuersätze muss 100 sein.
* vat-value	X	2,2	N	Mehrwertsteuerbetrag
distribution-channel 0 … 40				Vertriebskanal, dem dieser Artikel zugeordnet wird
* eshop-article-flag			BOOL	Soll der Artikel im Shop zu diesem Vertriebskanal angezeigt werden?
* cc-article-flag			BOOL	Soll der Artikel im Call Center zu diesem Vertriebskanal angezeigt werden?
schedule-code		2	AN
shipping-type		2	AN
shipping-cost-group		2	AN
shipping-cost		7,2	N
weight		7	N	Gewicht in Gramm
length		7	N	Länge in mm (Packmaße)
width		7	N	Breite in mm (Packmaße)
height		7	N	Höhe in mm (Packmaße)
object-number		10	AN
inventory-manager		8	AN
sales-price-internal-unit		7	N	Internal unit of the sales price
sales-price-internal		10	AN	Internal sales price
duty-tariff-number		11	N	duty tariff numberr
standard-supplier		8	AN
revenue-group-code		8	AN
accounting-area		3	AN
set-component 0 … 20
* set-article-number		13	AN	Artikelnummer
* set-article-quantity		7	N	Stückanzahl
size		10	AN	Größe (Bsp. Länge)
season		10	AN	Saison
collection		10	AN	Kollektion
Hazmat 0 … 1
* hazmat-un-code	X	4	AN	Gefahrgut Code
hazmat-flags 1 …40
* hazmat-country-code	X	3	AN	Ländercode
* hazmat-code	X	1	N	0 = kein Gefahrgut \\1 = Gefahrgut\\2 = Ausnahme