getArticle (Version 1) Returns detailed information about a given distribution article Object: /net/dsb/vhs3/ArticleMaster Method: getArticle Version: 1.0.0 Parameter Name Type / LenghtOpt. / Man.Description distribution-article-number AN / 18 O distribution article number of the article. Only one of the two article numbers is required distribution-articlenumber-externalAN / 20 O external article number of the article. Only one of the two article numbers is required price-list AN / 4 O 0 .. n price-list elements for which you want to query the prices. country-code-type AN / 3 O Controls which types of country-code will be returned. car = triple-digit int.car country-code iso = two-digit ISO countycode Response Element XML fragment article (see below). 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> <distribution-article-number>1FS9701</distribution-article-number> <price-list>PLE1</price-list> <price-list>PLA1</price-list> </body> </message> Example Response <?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> <article> <distribution-article-number>1FS9701</distribution-article-number> <distribution-article-number-external>1000000-111-000</distribution-article-numberexternal> <stock-article-number>1FS9701</stock-article-number> <article-type>1</article-type> ... </article> </body> </message> Response Structure Structure <article> <article> <distribution-article-number></distribution-article-number> <distribution-article-number-external></distribution-article-number-external> <stock-article-number></stock-article-number> <article-type></article-type> <article-status></article-status> <stock-article-description></stock-article-description> <stock-article-description-suffix></stock-article-description-suffix> <!-- 0 ... 10 --> <distribution-article-description> <language-code></language-code> <description1></description1> <description2></description2> <description3></description3> <description4></description4> <description5></description5> </distribution-article-description> <product-group></product-group> <shipping-type></shipping-type> <shipping-cost-group></shipping-cost-group> <shipping-cost></shipping-cost> <isnb></isnb> <ean></ean> <special-ean></special-ean> <delivery-code></delivery-code> <collection></collection> <weight></weight> <length></length> <width></width> <height></height> <cost-center></cost-center> <drawing-number></drawing-number> <part-family></part-family> <object-number></object-number> <release-date>2019-05-21</release-date> <inventory-manager></inventory-manager> <material-group></material-group> <revenue-group-code></revenue-group-code> <accounting-area></accounting-area> <timestamp-of-last-article-update></timestamp-of-last-article-update> <!-- up to 20 --> <value-added-tax country-code="" distribution-channel=""> <value-added-tax-rate code="" percentage=""></value-added-tax-rate> </value-added-tax> <!-- up to 20 --> <price> <price-list></price-list> <country-code></country-code> <currency-code></currency-code> <inclusive-vat></inclusive-vat> <standard-price></standard-price> </price> <!-- up to 20 --> <distribution-channel number=""> <eshop-article-flag></eshop-article-flag> <cc-article-flag></cc-article-flag> </distribution-channel> <!-- if article-type is 2 (set-article) --> <!-- up to 20 --> <set-component> <set-article-number></set-article-number> <set-article-quantity></set-article-quantity> </set-component> </article> Element Definitions Field NameKeyLengthTypeRemark, field supply or encoding distribution-article-numberXP13ANDistribution article number distribution-article-number-externalXP20ANDistribution article number (external) stock-article-number 18ANStock article number article-type 1NArticle type 1 = stock article 2 = Set/pseudo article 3 = Service item article article-status 1NArticle status (1: active; 2: inactive) stock-article-description 28ANStock article description Maybe the same as element 'description1' stock-article-description-suffix 20ANAddition to the description Maybe the same as element 'description2' distribution-article-description 0 … 10 * language-code 2ANISO-Language code * description1 35ANDistribution article description 1 * description2 35ANDistribution article description 2 * description3 35ANDistribution article description 3 * description4 35ANDistribution article description 4 * description5 35ANDistribution article description 5 product-group 4ANProduct Group shipping-type 2ANShipping type 02 = Shipping of books 03 = Shipping of goods shipping-cost-group 2ANShipping cost group shipping-cost 3,2NShipping cost (in reference to the distribution-article-number not to the purchase-order-source or similar things) isnb 13ANInternational Standard Book Number ean 13ANInternational Article Number (former European Article Number) special-ean 13ANSpecial EAN delivery-code 4ANDelivery-Code collection 10ANCollection weight 3,4NWeight in kg length 5NLength in mm width 5NWidth in mm height 5NHeight in mm cost-center 10ANCost center drawing-number 18ANDrawing number or value of <size> from the createArticle request part-family 4ANFamily of this part object-number 4ANObjekc number release-date Date Releasedate of this article inventory-manager 8ANinventory manager material-group 10ANmaterial group or value of <color-number> from the createArticle request revenue-group-code 8ANRevenue group code accounting-area 3ANAccounting area timestamp-of-last-article-update TStimestamp of article last updated value-added-tax 0 … 40 Attribute: country-code Attribute: distribution-channel 3 4AN ANCountry code, Int. car code or ISO code, according to the request. Default is car code. distribution channel * value-added-tax-rate Attribute: code=““ Attribute: percentage=““ 3,1 3 3,1N N NValue added tax rate Value added tax code (for example: 040 = 0% D tax free 041 = 7% D reduced 043 = 19% D full rate percentage of 100.0 % (sum has to be 100%) Examples Book + CD Book 7% (percentage: 70%) CD 19% (percentage: 30%) Book Book 7% (percentage: 100%) price 0 … n * price-list 4ANprice-list where the price comes from * country-code 3ANCountry in which this price is applied (country code) Int. car code or ISO code, according to the request. Default is car code. * currency-code 3ANCurrency code (Coded field; content is declared by the department) * inclusive-vat 1ANIs price inclusive value added tax (J/N) * standard-price 7,2NPrice (amount) distribution-channel 0 … 20 * Attribute: number 4NDistribution channel * eshop-article-flag 1ANValue of the eShop flag according to this distribution channel * cc-article-flag 1ANValue of the call center flag according to this distribution channel set-component 0 … 20 * set-article-number * set-article-quantity 13 8AN NIf this is an set-article (2), then … Distribution article number of this component Quantity of this component Field mapping in VIS XML-Table and Field in VIS distribution-article-numberM_VAR.VAR_ARTNR distribution-article-number-externalM_VAR.VAR_ART_NR_EXT stock-article-numberM_VAR.VAR_LAG_ARTNR article-typeM_VAR.ART_TYP article-statusM_VAR.VAR_STATUS stock-article-descriptionM_VAR.VAR_ARTBEZ1 stock-article-description-suffixM_VAR.VAR_ARTBEZ2 product-groupM_VAR.VAR_PROD_GRP shipping-typeM_VAR.VAR_VERS_ART shipping-cost-groupM_VAR.VAR_VERS_KOSTEN_GRP shipping-costM_VAR.VAR_VERSANDKOSTEN isbnM_VAR.VAR_ISBNR eanM_VAR.VAR_VTR_EAN special-eanM_VAR.VAR_SONDER_EAN delivery-codeM_VAR.VAR_LKZ_AKT collectionM_VAR.VAR_COLLECTION weightM_LAR.LAR_GEWICHT lengthM_LAR.LAR_LAENGE widthM_LAR.LAR_BREITE heightM_LAR.LAR_HOEHE cost-centerM_VAR.VAR_KOSTENST drawing-numberM_VAR.VAR_ZEICHNUNGSNR part-familyM_VAR.VAR_TEILE_FAM object-numberM_VAR.VAR_OBJEKT_NR release-dateM_VAR.VAR_DUE_DATUM inventory-managerM_VAR.VAR_BV material-groupM_LAR.LAR_MAT_GRP revenue-group-codeM_VAR.VAR_ERL_GRP accounting-areaM_VAR.VAR_BUCHUNGSKREIS timestamp-of-last-article-updateM_VAR.VAR_UPD_DATUM value-added-tax → Attribute: country-codeMWST.UST_LAND value-added-tax → value-added-tax-rate → Attribute: code=““ → Attribute: percentage=““MWST.UST_SATZ_1 or MWST.UST_SATZ_2 MWST.UST_CODE_1 or MWST.UST_CODE_2 MWST.UST_ANTEIL_1 or MWST.UST_ANTEIL_2 price → price-listPRL_KOPF.PK_NO price → country-codePRL_KOPF.PK_LAND_KFZ price → currency-codePRL_KOPF.PK_CURR price → inclusive-vatPRL_KOPF.PK_GROSS_INCL price → standard-pricePRL_POS.PP_DEF_PREIS distribution-channel → Attribute: numberM_VAR.VAR_VSCHIENE distribution-channel → eshop-article-flagM_VAR.VAR_KE_E_SHOP distribution-channel → cc-article-flagM_VAR.VAR_KE_E_SHOP set-component → set-article-number → set-article-quantityM_VAR.VAR_COMPxx_NR M_VAR.VAR_COMPxx_MNGE distribution-article-description → language-codeM_VAR.VAR_SPRACHE distribution-article-description → description1M_VAR.VAR_ARTBEZ1 distribution-article-description → description2M_VAR.VAR_ARTBEZ2 distribution-article-description → description3M_VAR.VAR_ARTBEZ3 distribution-article-description → description4M_VAR.VAR_ARTBEZ4 distribution-article-description → description5M_VAR.VAR_ARTBEZ5 This website uses cookies for visitor traffic analysis. By using the website, you agree with storing the cookies on your computer.OKMore information