createArticle (Version 3)

This message creates a new article in the WWS (inventory management system).

Object: /net/dsb/vhs3/ArticleMaster
Method: createArticle
Version: 3.0.0

Parameter

Name	Type / Lenght	Opt. / Mandat	Description
create-article	XML	M	See XML Description below

Response Element

empty message frame

Example 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>

Example Response

If article creation was succesful, only an empty message frame will be returned. In case of failure, a soup-fault message will be returned.

<?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 Structure

Structure <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	External transaction id
distribution-article-number	X	13	AN	Distribution article number
distribution-article-number-external		20	AN	External distribution article number
rep-article-number		13	AN	Replacement article number
stock-article-number		18	AN	Stock article number
stock-article-description		18	AN	Stock article description
stock-article-description-suffix		18	AN	Stock article description suffix
distribution-article-description 0 … 10
* language-code	X	2	AN	ISO-language code
* description1	X	35	AN	Distribution article description
* description2		35	AN	Distribution article description addition
* description3		35	AN	Distribution article description addition
* description4		35	AN	Distribution article description addition
* description5		35	AN	Distribution article description addition
release-date		10	DT	release date ISO format
delivery-code	M	2	AN
article-type	M	1	N	Articletype1 = stockarticle 2 = Set/Pseudoarticle 3 = Service item article
article-status	M	1	N	Article-status 1 = active, 2 = inactive
article-class		4	AN	Article class
article-group		10	AN	Article group
product-group	M	4	AN	Product group
product-category		1	AN	Product category
isbn		20	AN	International Standardbooknumber
ean		13	AN	International Article Number (former European Article Number)
special-ean		13	AN
cost-center		8	AN
drawing-number		18	AN
part-family		4	AN
part-family-text		50	AN
price 0 … 20
* price-list	X	4	AN	Price list code of an existing price list
* country-code		3	AN	ISO-Country code (unused in create sertvice)
* currency-code		3	AN	currency code (unused in create sertvice)
* inclusive-vat			B	is Price incl. vat: true/false (unused in create sertvice)
* standard-price	X	7,2	N	Standardprice: actual price (Amount)
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	VAT Code , see Codetable VAT in Appendix
* vat-percentage		3,2	N	Percentage of this rate, the sum of all rates of this value-added-tax element must be 100, default is 100
* vat-value	X	2,2	N	VAT Value
distribution-channel 0 … 40	distribution-channel, this article is assigned to
* eshop-article-flag			BOOL	is this article displayed in the eshop of this distribution-channel
* cc-article-flag			BOOL	is this article displayed in the call center of this distribution-channel
schedule-code		2	AN
shipping-type		2	AN
shipping-cost-group		2	AN
shipping-cost		7,2	N
weight		7	N	weight in Gramm
length		7	N	Length in mm
width		7	N	Width in mm
height		7	N	Height in mm
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
timestamp-of-last-article-update			TS
set-component 0 … 20
* set-article-number		13	AN	Article number
* set-article-quantity		7	N	Article quantity
size		10	AN	Size (eg. Length)
season		10	AN	season
collection		10	AN	Collection
Hazmat 0 … 1
* hazmat-un-code	X	4	AN	UN code of hazardous materials
hazmat-flags 1 …40
* hazmat-country-code	X	3	AN	ISO-Country code
* hazmat-code	X	1	N	0 = no hazmat 1 = hazmat 2 = except