Home

User Manual MartServices

1. Stand 01 01 2011 Seite 85 von 85
2. eese 24 5 7 MartLink PickBasket een 25 5 7 1 DI H 25 5 7 2 e ET 25 5 7 3 Response iieoevsesus eee aa eee PRENNE Yee ERR sinkenden 25 5 8 WebService GetBasket essen ene 27 5 8 1 II 27 5 8 2 Format of the Shopping Basket 27 5 8 3 Exceptional Alta nennen 27 5 8 4 Request Parameter EEN 28 5 8 5 Response Parameter secececcccccensssseseececeeeenaneess 29 5 8 6 Mlllicreioee ETE 32 6 Order Centre t rentre eee IE EE Ee vea eee Fe EE YER seein 33 6 1 FUNCION e 33 6 2 Entry Point anni 33 6 3 Search and Filtern eene 34 6 4 Differences to the Online Features sese 34 6 5 Technische Implementierung eee 35 6 5 1 WIR ce 35 6 5 2 CRUCE 35 6 5 3 E ET 36 7 Order Tracking terre 37 7 1 putredo 37 7 2 Seaichrand FIIEGT eic e eR enges 38 7 3 Technical Implementatian u ucn nu0u0ennen 38 7 3 1 dip 38 7 3 2 e TEE DRE 39 7 3 3 Mitis 39 8 Product Configuration E 40 8 1 Function eT 40 8 2 Configuration of Products EN 40 8 3 elt ge A0 8 54 Technical Implemtation icu ero eno EORR Ir gege AE 43 8 4 1 i O 43 8 4 2 AG Iri 44 8 4 3 RESPONSE 45 8 5 Advanced Settings EEN 46 Stand 01 01 2011 Seite 4 von 85 User Manual Mar
3. Current status of an order booked delivered partly delivered etc Allinformation about the order itself price position etc m Firma a amp e amp i 5s QQse ia GP imatro de ebusiness f rs handwerk Ez imatro de ebusiness f rs handwerk _ 100 ale Auftrags bersicht Sie k nnen hier ber Ihre Auftr ge bei Sto AG recherchieren egal ob per Telefon Fax pers nlich oder schriftlich bermittelt Kunden Nr Name 6032458 Mustermann zl Kommission Artikel Nr E sni Bei Kommissionen mitmehr als einer Beschreibung oder Auftragsdatum TT MM JJ Ziffernfolge zB Parkstadion Seestadt bitte nur die erste Datum von for 10 2005 Beschreibung und 2B Parkstadion Datum bis 6122005 Objekt inen E Auftrags Nr bei E Objektnummer Lieferant Lieferadi Bite wanien Auftragsstatus Hc Stra e Postleitzahl Dam 0001210156 Sto AG 0000032488 o 900 09 42 2005 42422005 Testbestellung Mustermann Ehrenbachstra e 2 Rechnungsempf nger DEI780 St hlingen Hamburg 40 12122005 3403 004 StoAqua Lackier Set 4 00ST 0 00ST mme 3999 o 0001213688 Mustermann 0000032483 o nase 42422005 Mustermann2 13422005 Mustermann Musterstrasse 1 2005 00114BS2005008 Rechnungsempf nger DE78700 St hlingen Hamburg 10 13122005 Doran T SHIRT 4 ST 2005T 0 0057 sae sase o 20 13122005 1034001 ANFANGSLEISTE ALU 4 ST zuer 0 00sT 10 59 5 0 o 30 13122005 mm Am PL
4. H he St Lange St Standardausr stung Bohrfutterschl ssel Bohrtiefenanschlag Haltegriff Schnellspannbohrfutter Tragekoffer Zahnkranz Bohrfutter Example for product details 5 Kilo Bohrhammer mit SDS max 85081091 4007140066484 550 WW ca 100 cm min oder 320 mm min 20 mm 45 55mm 40 90 mm 12 40 mm ca 110 Nm 15 64 20 35 mm 59kg Spitzmei el ca 95 kgh 950 Wi 180 360 min 1 1800 3200 min 1 413 mm 10 189 kg 134 mm 515 mm Seite 15 von 85 User Manual MartServices ab nexMart That s e business 4 5 Integration into the IT The portal feature Product Details can be placed anywhere in a computer system but that depends on the developers of the computer Systems VK Preise Kundendaten Kennzeichen Faktura e Commerce Grundiagen Beschaffung Lagerhatung St ckiste_ Kalkulation Verkauf E Sage Office Line Warenwirtschaft Online Artikelinfo E Geet Bearbeiten Datengstz Grundlagen System Portal Fenster 2 122270800046 AKKU PACK 9 6V KNOLLE 1 4AH HW Figure 3 Example for integrated product details displayed in a Popup window 4 6 Technical Implementation 4 6 1 URL The MartLink ID for product details is productdetail https Portal URL martlink productdetail In addition a target of the entry point can be provided In that way it is possible to have a direct access to the spare part page accessory page or other pages
5. EMBADR301020 ERROR No further specification of an address error EMBADR301030 ERROR The delivery to the specified country is not possible EMBADR301040 ERROR Zip code error EMBADR301050 ERROR Object error report EMBADR303340 ERROR A field is missing in the delivery address EMBBUY201080 WARNING Customer ID is disabled in the suppliers system EMBBUY201090 WARNING ERP customer has no read permission EMBBUY201100 WARNING ERP customer has no write permission EMBBUY201110 WARNING ERP customer cannot be executed Wrong customer ID EMBBUY201120 WARNING ERP customer financially EMBBUY201140 WARNING ERP customer has exceeded credit limit The currency is changed by the ERP of the supplier through the EMBBUY201150 WARNING requested customer number EMBBUY201160 WARNING Customer has delivery stop in the supplier s ERP EMBBUY201170 WARNING Customer warning with report EMBBUY301010 ERROR Customer Login is unknown in the portal EMBBUY301020 ERROR Activation is equivocal or not active at the supplier EMBBUY301030 ERROR User has no right to order at the supplier EMBBUY301040 ERROR Discount list could not be identified EMBBUY301050 ERROR ERP format error in the customer format Please correct in the portal EMBBUY301060 ERROR ERP customer ID invalid EMBBUY301070 ERROR ERP unknown error in the customer ID EMBBUY301080 ERROR Customer ID is disabled in the suppliers system Stand 01 01 2011 Seite 71 von 85 User Manual MartServices
6. EMBSHP301080 ERROR Date is mandatory but was not specified EMBSHP301090 ERROR Location is mandatory but was not specified EMBSHP301100 ERROR Shipping method is not supported by the supplier EMBSHP301110 ERROR Format error in the delivery date EMBSHP301120 ERROR Invalid delivery date EMBSHP301130 ERROR Supplier does not accept the requested delivery date too early EMBSHP301140 ERROR Supplier does not accept the requested delivery date too late EMBSHP301150 ERROR ERP delivery error with report EMBSHP301160 ERROR You must specify a date in this shipping method EMBSHP301170 ERROR The supplier requires a date that is at least X days in the future EMBSHP301180 ERROR The supplier requires a date that is more than X days in the future EMBSHP301190 ERROR Please enter a date with a valid format Stand 01 01 2011 Seite 75 von 85 User Manual MartServices eS n exM a rt That s e business MessageCode Level MessageText EMBSHP301200 ERROR You must specify a date and a place for this shipping method EMBSHP303320 ERROR Error in the validation of the delivery date EMBWKF101010 SUCCESS CreateResult successful EMBWKF101050 SUCCESS SimulateResult successful EMBWKF101090 SUCCESS SubmitResult successful EMBWKF101130 SUCCESS ConfirmResult successful Final response on the successful completion of the process Business EMBWKF101170 INFO objects have to be appended to the response EMBWKF201020 WARNING CreateResult warning
7. Server BIS Then the order gets booked in the particular portal The portal accepts or rejects the order The acceptance of the order means that the order is accepted by the port and the ordering process was triggered Error Handling Errors of an order can occur in the format or even in the order data itself Depending on the type of error tasks are generated either automatically or manually by an administrator All processes and tasks are checked for format and order data and displayed by the SCCC Silent Commerce Control Center Format Verification The data information takes place by means of the Business Integration Sever BIS If this fails the task format correction is generated That happens automatically or manually by an administrator Order Data Verification The order correction is initiated and the task generated if the booking fails This means that errors were made in the order data e g unknown article number or a delivery date in the past Task Pool SCCC Every process is controlled by the SCCC Every task for correction is displayed in the SCCC organizer of a portal The tasks for corrections may be delegated to the supplier The WebService ProcessOrder is used for asynchronous handling of orders An order is sent in the bM Order XML with the necessary authentication and authorization data to the appropriate port by the request of the WebService The answer includes a ticket for order tracking or an error descripti
8. String 1 32 Required Method by which the Response localget to the calling Client is passed localpost MartLinkld String 1 128 Required Identifier of the calling case sensitive Manes e g ViewBasket MartLinkVersion String 1 32 Required Version of the MartLink named S in MartLinkld currently 1 0 as case insensitive of 21 12 2009 MartLinkPortallD String 1 128 Required Name of the portal case insensitive MartLinkSupplierld String 0 128 Optional A valid identifier of a supplier case insensitive MartLinkLocale String 5 Optional A valid locale ID consists three ach parts SEINE ISO 639 Language Code 2 letter lower case separator _ ISO 3166 Country Code 2 letter upper case e g de DE de AT en GB MartLinkCurrency String 3 Optional A valid currency ID according to DE EE E ISO 4217 e g EUR CHF USD etc BuyerOrganization String 9 Required ID of the customers company consist 3 letters and 6 digits Stand 01 01 2011 Seite 12 von 85 User Manual MartServices n exM a rt That s e business Name Type Required Description Optional case sensitive e g BDE999999 BuyerUserName String 1 255 Required The username of the customer consists of name lt surname case sensitive Special characters are not allowed BuyerUserPassword String 8 128 Required Password of the user case sensitive Table 1 General Reques
9. Supplier TechnicalSellerName is invalid does not exist capitalization customer ID does not exist for this supplier customer ID is disabled by the supplier invalid destination country in alternate delivery address invalid delivery address e g postcode incomplete invalid shopping basket head fields commission result code 000130020 gt Shopping basket is already picked up BDE user password contain special characters e g 468 Article is not identified catalogueArticleCode and ordererArticleCode got mixed up x lt faultcode gt Server generalException lt fa ultcode gt lt faultstring gt WSWS3277E Error No such operation amp amp apos ExportBasketRequest amp amp apos faultstring Therequest was send to the wrong endpoint x The shopping basket can be picked up after UploadBasket and simulate but does not change the result code Therequested unit is not valid in the portal or ERP system Table 10 FAQ s Stand 01 01 2011 Seite 70 von 85 User Manual MartServices eS n exM a rt That s e business 14 Appendix 14 1 Error Codes The current error codes are available at http api test businessmart de services emartservices doc eMartServices Err orCodes html MessageCode Level MessageText EMBADR201050 WARNING Object warning report EMBADR301010 ERROR Supplier does not allow any different delivery address
10. This applies mainly to the following functions In the detailed view of the orders are no actions available e g takeover of positions into the shopping basket It is not possible to cancel an order during the booking process or generate a shopping basket out of order data if an error occurs in Current Orders Stand 01 01 2011 Seite 34 von 85 User Manual MartServices eS n exM a rt That s e business 6 5 Technical Implementation 6 5 1 URL The MartLink ID for PickBasket is ordercenter https Portal URL martlink ordercenter 6 5 2 Request The following parameters in the table apply for the MartLink OrderCenter as well as all general parameters from chapter 3 Name Type Required Description Optional TargetPage String Required Choice of entry point among openorders Current Orders or Order e P Archive In case of missing or archive roe invalid parameter the entry point is Order Archive Note If Open Orders is selected you get redirected to Current Orders On this page are no search parameters That means are such parameters set they will be ignored OrderNo String 255 Optional The optional OrderNo leads to the s call of the appropriate order The CaSe SEIISIIVE OrderNo is the eMart order number Orderld or the order number of the customer Is there no order to the OrderNo it will be rejected FromDate Date Optional Used to filter the orders by date YYYY MM
11. glich Ihre Angaben zum Produkt kom899999 exkl MwSt EUR 99 00 exkl MwSt EUR 110 00 EUR 17 60 MwSt EUR 127 80 471 90020 Gewinde 4007140066418 EUR 2 39 EUR 119 50 Meldungen Hinweis Angabe nicht m glich Ihre Angaben zum Produkt Bemerkung kom999999 Preise DER PREIS exkl MwSt EUR 2 39 VKPREIS exkl MwSt EUR 2 65 MwSt EUR 042 VKPREIS inkl MwSt EUR 3 07 Preise pro St ck Informationen Kundeneigene Artikel Nr ant 1 St ck 908090 9025536433547 EUR 1128 EUR11 28 7 Meldungen 1 Hinweis Angabe nicht m glich exkl MwSt EUR 11 28 exkl MwSt EUR 12 53 EUR 2 00 inkl MwSt EUR 14 53 90014 4007140066334 Spulenbolzen EUR 1 19 EUR 59 50 Meldungen Hinweis Angabe nicht m glich Preise DER PREIS exkl MwSt EUR 148 VKPREIS exkl MwSt EUR 1 32 MwSt EUR 0 21 VKPREIS inkl MwSt EUR 1 53 Preise pro St ck Katalogpreis Der Lieferant wird bei der Rechnungsstellung Ihre individuellen Konditionen ber cksichtigen Copyright 2000 2005 by businessMart AG Stuttgart lieferbar teilweise lieferbar Ql nicht lieferbar zur Zeit keine Angabe m glich K A keine Direktverbindung zum System des Lieferanten X nicht bestellbar Bestellwert EUR 289 28 Gesamt netto ER a MwSt 16 00 EUR 46 28 Gesamt brutto EUR 335 56 a eoo GERIERMARD Figure 32 Shopping Basket shown via Pop Up Seite 57 von 8
12. the use of the http s protocol The user password combination is transmitted for authentication The user is identified by BuyerOrganization and BuyerUserName and authorized by BuyerUserPassword Both have to match an activated and valid ID on the portal 3 8 Version Management MartLinks will be further developed The version of the MartLink MartLinkVersion is indicated in the request to run and route one and the same MartLink parallel 3 9 Traceability of the Response The information of a MartLink for tracing is provided in the response This information could be used for debugging The following information is provided PortallD The portal identification which is generated by the Response HostName The name of the host which is generated by the response This information is used only for internal use and tracking errors ResponseTimeStamp A time stamp that holds the date and time of the created Response 3 10 Necessary Parameter for all MartLinks When constructing MartLinks keep attention to capitalization Stand 01 01 2011 Seite 11 von 85 User Manual MartServices wv nexMart That s e business 3 10 1 Request Name Type Required Description Optional ClientName String 1 128 Required The name of the calling client case sensitive ClientTargetURL String 1 512 Optional URL of the client to whom the case insensitive peques is seni ClientRequestMethod
13. Angebot in Bestellung kopieren N pese 8 Angebot drucken Altuallderen gt owe owd usred Gedern gt Angebot abschlie en rem E Enthak die duis Ss 03 03 2008 14 21 _bmo lesen adb Figure 29 Possible Implementation Order Request Seite 54 von 85 User Manual MartServices ab nexMart That s e business diabolo Firma amp Geier x EES HERE a Startseke zu od BONNY reg Sagesse und P a kalkul Warenkorb m tat den ausgevwesenven AB Zuschasg Enkh k die gt 03 03 2005 14 21 peokee adb Figure 30 Prices and Availability shown via Pop Up 10 3 2 Attributes Process MartService Modules The following happens in the background The shopping basket will WebService be sent to the portal to start an order request from the ERP system of UploadBasket the supplier In order for the user request a ticket number returns to the computer system during the upload of the shopping basket That allows the user to ask for prices and availabilities of products The MartLink order request is started automatically on the portal after the shopping ViewBasket basket is arrived The computer system can send a request to the portal by using the ticket number In that way the basket will appear as a pop up on the screen of the customer All users of a BDE can call the shopping baskets of their colleagues because the shopping baskets are handled by the Order Centre The fol
14. Envelope gt Figure 16 Example for a Response of a Shopping Basket 5 8 6 Results The possible result codes are available at http api test businessmart de services emartservices doc eMartServic es_ErrorCodes html Stand 01 01 2011 Seite 32 von 85 User Manual MartServices af n exM a rt That s e business 6 Order Centre 6 1 Function The status of current orders may be viewed on the MartLink Order Centre In addition existing orders can be accessed via Order Archive 6 2 Entry Point The entry point into Current Orders or Order Archive can be set as default amp D m i Drucken Seitenansicht Navigation Favoriten moser de dabolo de Sto de imatro de Aktualisieren Zu demomart die demo bestellplattform der businessmart ag H im Bestellarchiv k nnen Sie alle Auftr ge sehen die in den letzten 3 Monaten unter Ihrer demomart Kundennummer ber demomart bestellt worden sind Das umfasst auch Bestellungen die Sie aus Ihrer Warenwirtschaft ber demomart gebucht haben Anfragen E e Anzahl der Bestellungen 9 v ihre dimomar Reste v Liet v vew w Lieferant w Mitarbeiter w Quelle w Kostenstelle Bestell Nr Mr Auftragsnr Y Datum w Pos v Summe Status Best tigung Soria Hofmann Online Holz 010820050813 3 EUR 691 54 gebucht versand Sorte Hofmann Online Holz 01 08 2005 08 06 1 EUR 99 00 gebucht ve
15. String ByVal soapActions As String As String Dim httpRequest As Net HttpWebRequest Net HttpWebRequest Create url Proxy settings Dim proxy As Net WebProxy Dim cred As Net NetworkCredential proxy New Net WebProxy http localhost 8888 False Stand 01 01 2011 Seite 84 von 85 User Manual MartServices eS n exM a rt That s e business Visual Basic NET Example ProcessOrder cred New NetworkCredential proxyUser proxyPWD proxyDomain proxy Credentials cred httpRequest Credentials cred httpRequest Proxy proxy set HEADERs httpRequest Method POST httpRequest ContentType text xml httpRequest Headers Add SOAPAction soapActions set timout httpRequest Timeout 120000 Write to request Dim requestStream As IO Stream httpRequest GetRequestStream Dim requestStreamWriter As New IO StreamWriter requestStream New System Text UTF8Encoding False requestStreamWriter Write postContent requestStreamWriter Close requestStream Close Open response Dim httpResponse As Net HttpWebResponse httpResponse CType httpRequest GetResponse Net HttpWebResponse httpResponse httpRequest GetResponse Dim responseStream As IO Stream httpResponse GetResponseStream Read the response stream Dim streamReader As IO StreamReader New IO StreamReader responseStream Dim sText As String streamReader ReadToEnd Return sText End Function End Class
16. 5 User Manual MartServices eS nexMart That s e business Case of Failure The sent shopping baskets cannot be corrected in the SCCC It is possible to correct them by using the Order Center of the portal or by repeating the transmission of the shopping basket from the computer system Especially a repetition of the transmission makes sense when the Martservice GetBasket is implemented in the customers ERP A further correction can happen to the SCCC customer order correction ERP Response It takes a view seconds until the shopping basket is transmitted to takes longer the portal and the order request is edited by the ERP system A demand note to be patient is displayed when the pop up of the shopping basket is called before the process of editing is done E nexMart das Fachhandelsportal f r Eisenwaren Werkzeuge Beschlage Datei Bearbeiten Ansicht Favoriten Extras dv Que O a d sem rmm BR Adresse e https ema003 e1 is bin INTERSH P enfinity eTS eMart de DE 5X SecureSession Start z Wechseln zu Warenkorb Zei Bitte warten nexMart f hrt f r Sie eine Preis und Verf gbarkeitsanfrage durch Dieser Vorgang dauert in der Regel 10 20 Sekunden In seltenen F llen kann dieser Vorgang etwas l nger dauern Bitte brechen Sie diesen nicht ab Warten Sie bis Sie eine R ckmeldung vom System erhalten Figure 33 Waiting for the Order Request Page 10 3 3 Technical Implementation The
17. ATTPINSEL SCHW PA GELB 25MM 1 ST UNV mmer uer 66 00 200 o Einstelungen O Ofen InBearbeitung amp f Ausgeliefert Fertig 16 12 2005 12 15 timo lesen diabolo mdb Figure 19 Order Tracking Seite 37 von 85 User Manual MartServices eS n exM a rt That s e business 7 2 Search and Filter Orders and information can be searched or filtered by the following criteria Customer order number or name Order number of the supplier Article number Order date from to Order number from the supplier Order Status Manual Input The function can be implemented in a way that the page is called without default search and filter criteria Default Input It is also possible that search and filter criteria are already set The results of the criteria are displayed immediately without the users input on the portal interface Automatic Search Furthermore it can be decided whether the search is to be started automatically or initiated by the manual click of the user 7 3 Technical Implementation 7 3 1 URL The MartLink ID for ERPOrderHistory is orderhistory https Portal URL martlink orderhistory Stand 01 01 2011 Seite 38 von 85 User Manual MartServices nexwart That s e business 7 3 2 Request The following parameters in the table apply for the MartLink OrderCenter as well as all general parameters from chapter 3 Stand 01 01 2011
18. DD ISO 8601 Stand 01 01 2011 Seite 35 von 85 User Manual MartServices eS n exM a rt That s e business Name Type Required Description Optional ToDate Date Optional Used to filter the orders by date YYYY MM DD ISO 8601 OrderStatus Num Optional Used to filter the orders by status 1 booked 1000 booked 1200 notbooked incorrect 500 in progress 0 unknown BuyerName String 255 Optional Used to filter the orders by person e The persons have a login on the case sensitive portal The personal user name consists mostly first name gt lt last name CostCenterlD String 255 Optional Used to filter the orders by cost centers This only makes sense if the user is using E Procurement Il ExecSearch String Required The parameter sets the automatic true false start of search 6 5 3 Response The MartLink OrderCenter has no Response parameter All general parameters of chapter 3 apply to the MartLink OrderCenter Stand 01 01 2011 Seite 36 von 85 User Manual MartServices neXMart That s e business 7 Order Tracking 7 1 Function Stand 01 01 2011 The MartLink ERPOrderHistory calls the function Order Overview of the portal In this case all orders of the selected supplier will be displayed This information is obtained directly from the ERP System of the supplier Thus obtains all important information of an order
19. EMBPLS301070 ERROR Article error with report EMBPLS301080 ERROR Error in specifying a fixed price EMBPLS301090 ERROR Error in specifying a fixed price EMBPLS301100 ERROR Error in specifying a discount unit percent EMBPLS301110 ERROR ERP error in specifying a discount unit percent EMBPLS301120 ERROR Error in specifying a discount unit percent EMBPLS301130 ERROR Article currency error EMBPLS301140 ERROR Error in article price of the ERP EMBPLS301150 ERROR Price error in discount list EMBPLS301160 ERROR Currency error EMBPLS301170 ERROR General discount list error EMBPLS301180 ERROR Discontinued article EMBPLS301190 ERROR Text fields are truncated when booking in the ERP EMBPOS201010 WARNING Free position no catalogue article EMBPOS202030 WARNING Free position no catalogue article EMBPOS301010 ERROR No catalogue article EMBPOS301020 ERROR Position was deleted automatically EMBPOS301030 ERROR Error for reorder in order number EMBPOS301040 ERROR Error for reorder position number does not exist EMBPOS301050 ERROR Error for reorder position number is not a number EMBPOS301060 ERROR Error for reorder order number is not a number EMBPOS301070 ERROR Error for reorder position number too long EMBPOS301080 ERROR Error for reorder order number too long Free positions could not be booked because the direct connection to EMBPOS302030 WARNING the suppliers system was not available eMartCode 32143220 EMBSEL201060 WARNING Sales Centre war
20. EMBWKF201060 WARNING SimulateResult warning EMBWKF201100 WARNING SubmitResult warning EMBWKF201140 WARNING ConfirmResult warning EMBWKF201190 WARNING Order could not be found for the interface RX GetOrderController EMBWKF201210 INFO Error in the order positions found EMBWKF201240 WARNING Warning order request in the ERP contains errors EMBWKF301010 ERROR Free positions are not allowed EMBWKF301030 ERROR CreateResult error EMBWKF301070 ERROR SimulateResult error EMBWKF301110 ERROR SubmitResult error EMBWKF301150 ERROR Error on sending order confirmation Please check e mail address A duplicate has been sent from your ERP system An order was EMBWKF301200 ERROR already processed at this number EMBWKF301210 ERROR Shopping basket for the BasketID not found The customer is not the owner of the shopping basket for the EMBWKF301220 ERROR BasketlD EMBWKF301230 ERROR Shopping basket is ready for export EMBWKF301240 ERROR Order request in the ERP contains errors EMBWKF301250 ERROR Data error necessary data are missing for the order request at the ERP EMBWKF301260 ERROR Data error necessary data are missing for the order request at the ERP Table 11 Error Codes Stand 01 01 2011 Seite 76 von 85 User Manual MartServices wv nexMart That s e business bmXML eMart ErrorLevel Reference Description ErrorCode ErrorCode EMBWKF101170 11011020 info Final answer about suc
21. L stXML amp funcFormatXML lt ExportBasketRequest xmInsz 2 StXML stXML amp funcFormatXML lt client gt 3 stXML stXML amp funcFormatXML name Test Client name 4 stXML stXML amp funcFormatXML lt emailAddress michael mezger businessmart de lt emailAddress gt 4 stXML stXML amp funcFormatXML lt client gt 3 stXML stXML amp funcFormatXML webService 3 stXML stXML amp funcFormatXML lt id GetBasket lt id gt 4 StXML stXML amp funcFormatXML version 1 0 version 4 stXML stXML amp funcFormatXML portalld amp txtPortallD amp lt portalld gt 4 StXML stXML amp funcFormatXML supplierld amp txtSupplierlD amp supplierld 4 stXML stXML amp funcFormatXML localexde DE locale 4 stXML stXML amp funcFormatXML lt currency EUR lt currency gt 4 stXML stXML amp funcFormatXML lt tan amp txtTAN amp lt tan gt 4 stXML stXML amp funcFormatXML lt webService gt 3 stXML stXML amp funcFormatXML lt buyer 3 stXML stXML amp funcFormatXML organization amp txtBDE amp lt organization gt 4 stXML stXML amp funcFormatXML userName amp txtLogin amp userName 4 stXML stXML amp funcFormatXML lt password gt amp txtPwd amp lt password gt 4 stXML stXML amp funcFormatXML lt buyer 3 stXML stXML amp funcFormatXML lt securi
22. Name Type Required Description Optional SupplierlD String 0 128 Required A valid identifier of a supplier who case insensitive is part of the portal Default is the preset preferred supplier on the portal ExecSearch String Optional The parameter sets the automatic true false start of search OrderState Num Optional This setting allows filtering orders according to their process status 0 All 1 In process at suppliers 2 Partly delivered 3 Delivered FromDate String Optional Used to filter orders by date YYYY MM DD ISO 8601 OrderState String Optional Used to filter orders by process YYYY MM DD status ISO 8601 BuyerOrderNo String 255 Optional The order number of the customer SellerOrderNo String 255 Optional The order number of the supplier 7 3 3 Response The MartLink ERPOrderHistory has no Response parameter All general parameters of chapter 3 apply to the MartLink OrderCenter Seite 39 von 85 User Manual MartServices eS n exM a rt That s e business 8 Product Configuration 8 1 Function It is possible to configure and order products with certain features such as sizes for screwdrivers or hue for paints on all eMart portals A setting page for the product configuration is available by means of the GTIN EAN code or order number and supplier name Optionally an existing configuration of a product can be passed to the MartLink This is used as preselection for the relevant product attribut
23. SEM EURS35 34220 kA SIT 4007140056485 sereriarg _ k Tewes C sSC C CS S Kstslogpres Bestelwert EUR 536 358 50 ER Der Lieferant wird be der Rechnungsstelung Ihre Goss v FUR 536 359 60 Schrelertassungzzeien ndividuslen Kendtionen ber cksichtigen EI Actuausienen E auracnonen proren Mwst T600 BUR 8S 817 38 Gesamt brutto FUR 622 175 98 Nome der Bestelvorlage Pietercar tehweiss leterbar nicttteterbar Angabe zur Zeit nicht m glich K A keine Direktverbindung zum System des Lieferanten X nicht bestellbsr OB 122005 15 10 sabine wesner 108fnihomelsabne jwasserldabolo db 7 Figure 11 ERP Request and Shopping Basket Takeover ais diabolo Firma Muster AG Kennung Faktor Einh Text Einzelpreis PC ike 1 o 1 St ck Sicherhelts Federspanner 16e A tikel 2 30500 10 stuck Drucii ftschrauber 53 634228 1 Online Funktionen Bearbeiten Loschen Nummerisren Aktualisieren Gledern gt H DI kalkuliert Einkauf 536 359 60 0 00 0 08 oe 33 358 60 zuberechnen 1 verkauf Enth lt den Verkauf 0 00 536 355 56 16 00 85 817 25 622 175 95 Enthak die Kennung 3 12 2005 15 12 sabine wesner 1 108fn homeisabne wasneridabolo mdb A Figure 12 Created Shopping Basket in the
24. Schematic representation ofthe Scenario See also Takeover of Shopping Baskets and Chapter 6 2 Entry Point Stand 01 01 2011 Seite 60 von 85 User Manual MartServices 11 Base of all WebServices wv nexMart That s e business 11 1 1 Request for new structure case sensitive Name Type Required Description Optional RequestHeader Clientld String 1 128 required Name of the requested client case sensitive buyer portalld String 1 128 required Name of the portal case insensitive buyer organization String 9 required ID of the customers company consist 3 letters and 6 digits case sensitive e g BDE999999 buyer userName String 1 255 required The username of the case sensitive customer consists of lt name gt lt surname gt Special characters are not allowed buyer password String 8 128 required Password of the user 11 1 2 Response for new structure Name Type Guaranteed Description ResponseHeader Responseld String Yes Unique number of the 25 Response for el identification and correlation of internal processes results result List of result Yes values Stand 01 01 2011 Seite 61 von 85 User Manual MartServices eS n exM a rt That s e business 12 WebService ProcessOrder Order Process The WebService ProcessOrder represents the ordering process The data of a sent order are transformed by the Business Integration
25. That s E Business User Manual MARTSERVICES Specifications and technical implementation in IT Systems ei MartService That s E Business Please note that there is no guarantee for technical details or the applicability of software referring the product description and the application documentation The documentation referring the product of the contract is also stored on the computer centre from nexMart and can be requested and printed at any time Copyright The information given in the document is under copyright It is forbidden to copy modify translate microfilming save on electronic medias as well as recreate the document or parts of the document electronically this right is reserved just for nexMart GmbH amp Co KG Software referring the documentation is property of the Copyright owner Copyright O 2013 by nexMart GmbH amp Co KG Stuttgart All rights reserved Author nexMart GmbH amp Co KG Gropiusplatz 10 70563 Stuttgart 01 01 2011 1 4 Tony Bu ler Translation on the bases of the german original version 1 4 nexMart GmbH Table 1 Proof of change User Manual MartServices eS n exM a rt That s e business Index tel M 3 1 What are the MartServices EE 6 1 1 What do MartServices EE 6 1 2 Iris 6 1 3 X Added Value EE 6 2 Technical Devices EE 7 2 1 Construction of the individual MartServices 7 2 2 Definition MartL
26. The MartLink ProductDetail does not return any parameters and therefore no Response Stand 01 01 2011 Seite 16 von 85 User Manual MartServices eS n exM a rt That s e business 4 6 2 Request The following parameters in the table apply for the MartLink ProductDetail as well as all general parameters from chapter 3 Name Type Required Description Optional SupplierArticle String 1 128 Required Unique article number of the Number product given by the supplier nsitive SC ee Mostly it is the order number or the GTIN former EAN Code TargetPage String Optional The appropriate tab is activated and the called page displayed if productdetail ee EE the requested information is Parepare available otherwise the main accessories other page ofthe product productdetail is displayed MartLinkSupplierld String 0 128 Required A valid identifier of a supplier who case insensitive IS paroline portal Table 3 Request parameter for the MartLink product details 4 6 3 Response The MartLink ProductDetail has no Response parameter It is called only one side of the portal 4 6 4 Multiple Hits in Search A hit list will show up if there is an article number for two or more articles Stand 01 01 2011 Seite 17 von 85 User Manual MartServices wv nexwart That s e business Es wurde mehr als 1 Produkt gefunden Zur Detailansicht bitte auf den Produktnamen
27. Users IT System Stand 01 01 2011 Seite 23 von 85 User Manual MartServices ab nexMart That s e business 5 5 Already created Shopping Baskets Already created shopping baskets can be accepted In that case the shopping baskets are saved in Open Shopping Baskets The shopping baskets can be saved in the own IT System by clicking Place Order Eo EETETT_ lt GE Tats sstbaten mache Es 7 o e 0 m WB 7 v CMS EI Startsate Zur ck Vorwerts Drucken Setenarscht Navigation Favonten meser de diabaio de Sto de ropp de Aktualisieren Em demomart die demo bestellplattform der businessmart ag AR uererant een DemoMart 1 a anam wo Bestellcenter ein eee Gah OFFENE WARENKORBE yy k re die bisher unter Ihrem dememart Benutzamamen erstellt aber noch nicht staesand worden sind Sie V rb Wa lor sofort bestellen Abeksrettel 5 Warenk rbe warden aulomalisch gel scht wenn sie alter als 31 Tage sind L t Anzahl der Warenk rbe 7 Ueferschene Sta zi viuis Wie e bb ee E i sep Warenkorb erstellen Lieferant Tequp zEe Import von offline erstellten Bestell Dateien Bie k nnen amine varereitete Dateien unc Daten aus Ihrem eigenen EOV System hier dirait als Vlarenkor importieren MT gue Bomm ze 2000 2005 oy busineest ert A Impressum f Kontakt Figure 13 Takeover from Open Shopping Basket
28. amValues 0 Case Supplierld txtSupplierlD arrParamValues 1 Case Basketld txtBasketld 2 arrParamValues 1 Case CheckSum txtCheckSum arrParamValues 1 Case TAN txtTAN arrParamValues 1 End Select stResult stResult amp arrParamValues 0 amp amp arrParamValues 1 amp vbCrLf Next Display result MsgBox stResult vbInformation bermittelte Parameterwerte End If End Sub Stand 01 01 2011 Seite 83 von 85 User Manual MartServices eS n exM a rt That s e business 14 3 Visual Basic NET Example ProcessOrder Visual Basic NET Example ProcessOrder Public Class Form1 URL f r den Web Service Aufruf festlegen Dim WSTargetUploadBasketURL As String http soa2 businessmart de ProcessOrderWebServiceAdapterRouter services ProcessOrder Private Sub Button1 Click ByVal sender As System Object ByVal e As System EventArgs Handles Button1 Click Dim requestString As String My Computer FileSystem ReadAllText bsp_order xml MsgBox requestString Dim responseString As String responseString funcSendSoapRequest WSTargetUploadBasketURL requestString processOrder responseString responseString Replace x gt amp Chr 13 amp Chr 10 amp oi My Computer FileSystem WriteAllText uploadbasket response xml responseString False MsgBox hallo ich bin fertig End Sub Private Function funcSendSoapRequest ByVal url As String ByVal postContent As
29. ameter eene eren 66 12 10 2 E e Ir E 67 12 10 3 Results isses terr rh nun 69 T3 DAI EE 70 14 ele le ame 71 14 1 Error Codes ie etre tete e engen aae Ea cons 71 14 2 VBA Example Shopping Basket Takeover 79 14 3 VBA Example ProcessOrder eee 84 Stand 01 01 2011 Seite 5 von 85 User Manual MartServices eS nexMart That s e business 1 What are the MartServices 1 1 What do MartServices Enterprise resource planning systems can be enriched with portal functions by MartServices The functions of the portal are implemented directly into the computer of the customer The use of the portal functionality expands each ERP System to better product and shipping information and more efficient purchasing processes Users of the MartServices don t need to change their applications and they have not to log in separately to the portal Portal Seller Figure 1 Schematic representation of MartServices 1 2 Target Group The target groups are providers of application software and system vendors as well as purchasers and contract agents who want to shop online via nexMart and use the portal functionality in familiar internal software 1 3 Added Value Integration of portal functionality in application software Enrichment of the user software to better information and more efficient purchasing processes Using the features without portal Login or the change of
30. applications Stand 01 01 2011 Seite 6 von 85 User Manual MartServices eS n exM a rt That s e business 2 Technical Devices 2 1 Construction of the individual MartServices MartServices are composed of individual technology components These devices are different WebServices or MartLinks sometimes a combination of both 2 2 Definition MartLink In a mart link pages of the portal are accessed and appear in the external application programs Information of the portal and portal features can be used by MartLinks When dealing with features no data in the application program are stored but everything remains on the portal 2 3 Definition WebService Data can be loaded into the application programs by a WebService Because of the WebService an application and the portal are able to communicate with each other That means besides of using the portal features the user may also save his work in its own application 2 4 System and Operating Conditions Users and their respective suppliers have to be enabled for using the services The user program has to be compatible with a browser to view portal features Stand 01 01 2011 Seite 7 von 85 User Manual MartServices eS n exM a rt That s e business 3 Base of all MartLinks A MartLink provides a direct entry into the portal or commands a service ofthe portal This is accessed via an http s Post Request that is answered by an html page URL Structure The MartLink i
31. asket XML In case of failure skip this part deliverableState available requested amount is available partial available requested amount is partly available not available requested amount is not available not requested request was not check by the ERP System see command S Envelope xmIns S http schemas xmlsoap org soap envelope gt lt S Body gt lt ns2 getBasketResponse xmlIns ns2 http api businessmart de services emartservices exportTypes 2009 06 23 lt ResponseHeader Responseld bbd10c317c8270e816b9e91ec2d6 Responseld lt ResponseHeader gt basket transactionld undefined formatVersion bmXML 1 11 gt docs doc sequenceNumber 1 gt docHeader version 1 11 type Basket lt documentinfo source eMartSilentCommerce gt creationDate 2010 01 20T13 37 00Z creationDate lt documentNumbenw5QKEBgjaRsAAAEmyPADUUu8 lt documentNumber gt Stand 01 01 2011 Seite 29 von 85 User Manual MartServices eS n exM a rt That s e business lt status NEW_EXPORTED lt status gt lt moduleName basket lt moduleName gt lt documentinfo gt supplier lt technicalName gt tequip lt technicalName gt supplier orderer role normal gt lt portalAccount marketplace nexMartc marketplace organisationBDE999999 organisation lt loginXVorname Nachname lt login gt lt country DE lt country lt customerNumber12345 amp custom
32. bot Dir at lstensdet ab ZI Dokuments ten Ill ordneregeneschsften Weitere Schritte gt _ en SE Einzelpreis Gesamt dp 1 79 44 75 EET zuschlagsposttion gt EXE Aus Katalog gt Bearbeitene lichen Haer Pedo sea zuberechnen verkauf 1351 32 6 PE 0 08 DEES Geden L G v TED __Bretatangen mI Erkh k die Ordrungszahl 03 09 2008 14 21 bmo lesen disbolohdisbelo mdb Figure 26 Prices and Availabilities of Products 10 2 2 Attributes Process MartService Modules The following happens in the background The shopping basket will be sent to the portal to start an order request from the ERP system of the supplier In order to use the feature price and availability of products a ticket number returns to the computer system during the upload of the shopping basket That allows the user to ask for prices WebService and availabilities of products The order request is started Get Basket automatically on the portal after the shopping basket is arrived The computer system retrieves the requested data of the shopping basket by the ticket number The following is a representation of the scenario described above 1 The user starts to upload the shopping basket as XML to the portal by a click or something similar depends on the implementation The shopping basket is visible in the portal under Open Basket 2 The users computer system gets a ticket number back which identifie
33. cess of processing a request The Business objects must be attached to the response EMBWKF201240 22500040 Warning basketld Basket not synchronized successfully with ERP for export EMTFMT302030 31901130 Error Error transforming data into eXML EMTSEC301010 31901210 Error Authorization error Happens when external component can provides incorrect login and password during POST request EMBWKF301210 32500010 Error basketld Basket not found for BasketID EMBWKF301220 32500020 Error buyerName Buyer is not owner of Basket for BasketID EMBWKF301230 32500030 Error basketld BasketStatus wrong for export EMBWKF301240 32500040 Error basketld Basket not synchronized successfully with ERP for export EMTSYS403050 41901900 Fatal General error Uncontrollable exception Table 12 Error Codes Stand 01 01 2011 Seite 77 von 85 User Manual MartServices nexwart That s e business LoginError Password is incorrect LoginInvalid User is incorrect or does not exist BuyerCompanyNotAuthorized Company is not authorized for this MartService BuyerNotAllowed User is not activated forthis MartService UknownBuyerCompany Name of company is incorrect or unknown Supplier Supplier is incorrect SellerCompanyNotFound Name ofthe supplier is incorrect SellerNotAllowed Supplier is not activated for this MartLink InvalidForSellerCompany LocaleErr
34. ckfragen zu Farbton und Lieferverf gbarkeit informieren D ABBRECHEN D BERNEHMEN Je 1 1 vertrauensw rdige Sites E Figure 22 Color does not exist The user gets a note if no product configuration is set figure 22 8 4 Technical Implementation 8 4 1 URL The MartLink ID for ProductDetail is configureproduct Default values can be transferred for the product configuration in the request These are set as a preselection They will be ignored if at least one is invalid Stand 01 01 2011 Seite 43 von 85 User Manual MartServices eS n exM a rt That s e business 8 4 2 Request The following parameters in the table apply for the MartLink ConfigureProduct as well as all general parameters from chapter 3 Name Type Required Description Optional SupplierArticle String 1 128 required Unique article number of the Number product given by the supplier e itive n Ge Mostly it is the order number or the GTIN former EAN Code conditioning1 String 0 255 optional The default settings for the product configuration can be passed in the conditioning2 String 0 255 optional fields conditioning1 to 5 colorNo and colorText conditioning3 String 0 255 optional conditioning4 String 0 255 optional conditioning5 String 0 255 optional colorNo String 0 255 optional colorText String 0 255 optional Table 4 Request ConfigureProduct Stan
35. d 01 01 2011 Seite 44 von 85 User Manual MartServices eS n exM a rt That s e business 8 4 3 Response The following parameters in the table apply for the MartLink ConfigureProduct as well as all general parameters from chapter 3 Name Type Required Description Optional conditioning1 String 0 255 optional The default settings for the product configuration will be passed in the field conditioning1 to 5 conditioning2 String 0 255 optional conditioning3 String 0 255 optional conditioning4 String 0 255 optional conditioning5 String 0 255 optional colorNo String 0 255 optional The parameter transmits the color code The absolute term color is transmitted if no valid hue has been selected colorText String 0 255 optional The user description of the color is inserted here if no valid hue has been selected in the parameter colorNo Table 5 Response ConfigureProduct Stand 01 01 2011 Seite 45 von 85 User Manual MartServices af n exM a rt That s e business 8 5 Advanced Settings Another product configuration is the Extended Warranty figure 23 and Purpose figure 24 aay diabolo Firma Muster AG GIE Datei Bearbeiten Anskht Extras ei amp P LO Se so E Startseite Zur ck Drucken Seitenansicht Navigation Favoriten moser de diabolo de Sto de imatro de Aktualisieren es demomart die demo bestellplattform de
36. e is indicated in the part WebService to run and route one and the same WebService parallel Traceability of the Response The information of a WebService for tracing is provided in the response This information could be used for debugging The following information is provided PortallD The portal identification which is generated by the Response HostName The name of the host which is generated by the response This information is used only for internal use and tracking errors TimeStamp A time stamp that holds the date and time of the created Response Seite 64 von 85 User Manual MartServices eS n exM a rt That s e business 12 9 Exceptions and Error Handling A result set is transmitted with a summary of the set in the response of the WebServices The Summary Results Summary can contain the values success info warning error or fatal Success Successful execution ofthe WebService infos Successful execution of a WebService with additional information warning Partly successful execution of a WebService with possible different standard conduct Additional information is provided error The execution of the WebService without additional negative impact is not possible An error description is provided fatal Cancellation of a WebService with a negative impact or indeterminate state An error description is provided The Result Summary presents the highest lev
37. e and therefore not available for order EMBPLQ301050 ERROR Availability check for this article is currently not possible EMBPLQ301080 ERROR Error in quantity unit EMBPLQ301090 ERROR Error in quantity unit EMBPLQ301120 ERROR There are positions with incorrect quantity units EMBPLQ301130 ERROR Quantities alert with report EMBPLQ301170 ERROR Text fields are truncated when booking in the ERP Quantity unit or packaging do not match the data of the supplier EMBPLQ302010 ERROR system EMBPLQ302020 ERROR The minimum order quantity was not reached EMBPLS201020 WARNING Article in unknown in the ERP EMBPLS201040 WARNING Article is currently not available EMBPLS201050 WARNING Article is no longer available discontinued item EMBPLS201060 WARNING Article error ARTICLE ID NO PRICE EMBPLS201070 WARNING Article warning with report EMBPLS201190 WARNING Text fields are truncated when booking in the ERP EMBPLS301010 ERROR ERP format error in the article number EMBPLS301020 ERROR Unknown article number in the system of the supplier EMBPLS301030 ERROR ERP article number error The reason is not precisely defined Stand 01 01 2011 Seite 73 von 85 User Manual MartServices nexwart That s e business MessageCode Level MessageText EMBPLS301040 ERROR Article is currently not available EMBPLS301050 ERROR Article is no longer available discontinued item EMBPLS301060 ERROR ERP Price on request Please contact your supplier
38. el of the Result Level This shall apply success lt info lt warning lt error lt fatal The following parameters are transmitted for each entry in the Result Set result code The symbolic code of Results is constructed in the following format NNNN L CCCC NNNN is the number of the WebService 0000 correlate to general Results L is the Level O success 1 info 2 warning 3 error und 4 fatal and CCCC is the error code result text A plaintext message can be sent to the error code in this field The language is based on the WebService Locale the fallback is English ProcessOrder response with an error message for format errors Stand 01 01 2011 Seite 65 von 85 User Manual MartServices nexwart That s e business 12 10 Technical Implementation 12 10 1 Request Parameter The following parameters in the table apply for the WebService ProcessOrder as well as all general parameters from chapter 4 8 1 Name Type Required Description Optional client name String 1 128 required The name ofthe called client case sensitive client emailAddress String 0 256 optional The email address of the client for een feedback of technical problems webService id String 1 128 required The identifier of the calling case sensitive WERSEINICE webService version String 1 32 required The Version of the WebService ase inseneitiv named in the WebServicelD webSer
39. erNumber lt portalAccount gt exchangeFormabbmXML 1 11 exchangeFormab lt orderer gt lt invoiceAddress gt postalAddress name value Admin type first name value Admin type last gt name value nexMart GmbH amp amp Co KG type company gt streebGropiusplatz 10 lt street postcode 70563 postcode city Stuttgart city country DE country lt postalAddress gt lt invoiceAddress gt shipping type normal gt shippingAddress lt flagUseERPShipToAddress gt true lt flagUseERPShipToAddress gt shipping lt headerAttributes gt lt flagCompleteShipping true lt flagCompleteShipping lt currency EUR lt currency gt Stand 01 01 2011 Seite 30 von 85 User Manual MartServices eS n exM a rt That s e business orderConfirmation value jakob sroda businessmart de orderResponseFlag false addressType mail gt lt headerAttributes gt lt docHeader positions position deliverableState not requested orderableState orderable id 1 gt quantity value 10 0 unit type gt article manufacturerArticleNumben60215961 manufacturerArticleNumber lt articleName gt Freie Position articleName catalogueArticleCode 60215961 catalogueArticleCode catalogueNumbepbmetabo catalogueNumben lt articlePrice type list gt value 0 0 value lt articlePrice gt article positionPrice type list gt totalVa
40. es 8 2 Configuration of Products The configuration may differ from product to product and depends on the settings of the seller Especially the following configurations are possible Product colors Advanced setting Extended Warranty Advanced setting Purpose wet color fabric e g sandpaper 8 3 Product Colors Product colors can be configured for some products such as lacquers In the ERP program of the customer opens a window Advanced Settings when the MartLink ConfigureProduct is called The customer can select the relevant color in the opened window see figure 20 Stand 01 01 2011 Seite 40 von 85 User Manual MartServices af n exM a rt That s e business Datei Besbeken Ansicht Extras 7 gt Norwarts amp D E V amp a Drucken Seitenansicht Navigation Favoriten moser de diabolo de Sto de imatro de Aktualisieren o a Startseite Zur ck momart die demo bestellplattform der businessmart ag Zusatzeinstellungen WB 100 Art ir 14865001 Farbsystem Farbton RAL _ gl m BERNEHMEN J Copyright 2000 2005 by businessMart AG powered by gt businessMart ki Figure 20 Configuration of Product Colors The color test will open ifthe user clicks on the icon Sal appropriate colors are listed after entering ofthe color system and the desired hue The color ofthe product is configured after clicking the Apply b
41. euawmace E Osernanme lieferbar teilweise lieferbar richt lieferbar Angabe zur Zeit richt m glich K A keine Direktverbinduna zum System des Lieferanten gt nicht bestellbar Z Copyright 2000 2005 by businessMert AG poweredbyw businessMart 09 12 2005 14 37 sabine wasner 108fn home sabine wasner diabclo mdb u Figure 10 All functionalities of the portal are available 5 4 Takeover of Shopping Baskets The shopping basket can be loaded into the own IT System by clicking the Apply button The user can send an ERP request and check prices and availability of products before the shopping basket will be accepted That is only possible when the supplier has an ERP connection Stand 01 01 2011 Seite 22 von 85 User Manual MartServices af n exM a rt That s e business LIEFERANT Toqup Warenkorb sen Tequigi i Tequip Kurzinfo i mehr information Mindestbestellwert Mindermengenzuschlag Frachttreigrenae Versandkosten Gefahrengulzuschiag Weltere Wisrenkorbinfomationen Warenkorb Kopfdaten Objekt Bite w hlen Kunden Nr Name 9513574 Mustermann z Dauwen D aramoumretm Anzahl der Positionen 2 Zusatzinformationen einisusbenden Pos Artikel tir L sch m Menge Einheit EAN Code Bezeichnung Preis Summe Status Ki t fo St ck 09001 Sicherheits Federspanner EUR 1 54 EUR 16 40 kA Sm 3000036056125 gt fo Stack y aan Druckluftechrouber ER
42. has to be sent automatically by the computer after a certain time It is recommended to wait 5 seconds plus 2 seconds for each position before a renewed pick up of the shopping basket is possible The collection may be performed several times until the desired state of the shopping basket is reached The shopping basket cannot be collected again if the synchronization is completed Stand 01 01 2011 Seite 53 von 85 User Manual MartServices 10 3 The Process Stand 01 01 2011 nexwart That s e business View Prices and Availability Again the client creates a shopping basket in his own computer and requests prices and availabilities of products by clicking a button Then a pop up with the information will be called The shopping basket cannot be changed that way and is only used for viewing 10 3 1 Practicable Example with Screenshots The processes are not perceived by the user It is just one click to get the latest prices and availabilities of products In this case the technical modules are linked in a way that they start each other sg BIER LIIS 5 Statseke Turis Drucken Sekenansicht Navigation Favorken Iren de dabo de Aktualisieren kalkulation angebot bearbeiten 2005 00011 EI Angebot Bl Kabulstionsdetats z ten TI Crdneregerschaften le Nactischlager E buchen Wetere Schritte Produkte recherchieren 2 7 RE
43. hat the user can call prices and availability with one click The order request is automatically triggered once the shopping basket was sent on the portal by UploadBasket This function is controlled by the parameter command The order request is sent to the ERP system Then the request is edited and returns After that the prices and availability are ready for retrieval The request to collect the shopping basket has to be sent automatically by the computer after a certain time It is recommended to wait 5 seconds plus 2 seconds for each position before a renewed pick up of the shopping basket is possible Stand 01 01 2011 Seite 59 von 85 User Manual MartServices nexMart That s e business It is a login of a user of the buyer company needed to display a shopping basket That means a buyer agent is also able to call a shopping basket which was created by an employee of the same company 10 4 Online Request of Price and Availability Another possibility to check price and availability of products is to use the portal interface But it is not necessary to change the application to the web browser and to login separately He can use the direct entry into the portal without logging in by an integrated portal interface into the own computer Entry into the Portal Q Create SB Order Request Price Availability SSS gt Se 2 nex KMa rt EDP system 3l Duebel ERP system Customer rg Supplier Figure 34
44. hes Design von Form und Funktion sind unsere Sehlagbohrmasehinen gt Nahezu r ckschlagfreies Arasiten beim Schlagbohren Bohren und Schrauben bequem und sicher zu handhaben Mit gro em Bedienkomfort ist das Gerat auch in all Anzahl der Produkte 6 Y Wezeichnung v Artikekiir vesis vw 300 Visi eem Bohrmaschine zeng ara K 7 i 1100 Pres pro Stuck Press pro Stuck Ere tlane taniche Bonrmaschine Tar firs tre reet ck EI 259 Viat Eloktronik Hohrmasching mms arm w c en Praspro Sich Preis pro St ck re stens Fandiche Donrmaschne f r hre tagne aret E 46b Viet ektroni Bohrmaschine am mno q is se en BE Keon Katekog sichibw Js Sotwere downlad Gre dete handliche Bunrmeschie f r nre ke Amet Stack fe Gras Braum bk W Eles Rotana ks Kategoriesuche 18 Pres pro iid Pre pro Stick um Constare Siectranis tr konstate Drehzahl bei Beeching mt z Figure 7 Entry Point into the Catalogue The product search is also available and the user can access it at any time UEFERANT Tea Suche Anzahl der Produkte 1 Die Ergebnisse lassen sich unterschiedlich sortieren indem Sie die entsprechende Spalten berschrift anklicken Y Preis vun page poga bk pto Sti E Preis pro Stuck Freis ES E Copyright 2300 3005 by busiressMar AG Impressum JKontelt Figure 8 Entry Point into the Product Search page It is an additional opportunity to jump directly into a ne
45. ich von 12 bis 40 mm Durchmesser ausgelegt m glicher Bohrbereich 4 bis 28 mm Durchmesser Vielseitiger einsatz Der richtige Hammer also f r die Elektro Sanit r Heizungs und Klimainstallation sowie f r Renovierung Fassaden und Ger stbau Mitgeliefertes Zubeh r Fettube 1x 1615430005 Handwerkerkoffer 1 x 2605438294 Tiefenanschlag 1x 1613001010 Zusatzgriff 1x 2602025112 Bedienungsanleitung Bedienungsanleitung Highlights Hochwertige Materialien und Pr zisionsteile f r lange Lebensdauer gt Fett Depot im Bohrfutter zur optimalen Schmierung der Werkzeugaufnahme Einfache Einstellung und Fixierung des Tiefenanschlags gt b Service Deckel f r einfachen Kohle und Kabelwechsel gt Mit Vibrationsdampfungssystem YDS f r besonders wirksame Schonung der Gelenke Electronic und variable Drehzahl f r pr zises amp nbohren Gro er integrierter Umschalter zum Hammern oder zum Bohren ohne Schlag Figure 2 Kaufm nnische Daten Produktgattung Statistische Warennummer EAN Code Technische Daten Abgabeleistung Bohrleistung in Beton mittlere H rte Bohr in Beton mit Durchbruchbohrern Bohr in Beton mit SDS max Hohlbohrkronen Bohr in Beton mit SDS max Wendel Bohrer Drehmoment am Bohrer Einzelschlagst rke Empfohlener Bohrbereich Maschinengewicht Mei elleistung in Beton mittlere H rte Hennaufnahme Nenn Drehzahl Schlagzahl bei Nenn Drehzahl Breite St Gewicht St
46. ink sees eren 7 2 3 Definition WebService esee 7 2 4 System and Operating Conditions 7 3 Base of all MartLinks EE 8 3 4 Bde ED 9 3 2 Passing of Request Parameter eese 9 3 3 Passing of Response Parameter 9 3 4 Transfer Method EEN 10 3 5 Error ispum 10 3 6 International Use eeeeeeeeeeee seen 10 3 7 SO CUTILY 11 3 8 Version Management 11 3 9 Traceability of the Response EN 11 3 10 Necessary Parameter for all MartLinks 11 ELOM EE CDL m 12 SLOPE CLiopbic e 13 4 Prod ctDetalls etr riri ere Cr E nai 14 4 1 FUR CEIOM PEE 14 4 2 Key FeatllIGS iss cose eee e trees ear een voee sees esae eue nie ense esu e UR abus 14 4 3 Customer Benefits EEN 14 4 4 Whatdetailsaredisplayed en 14 4 5 Integration into the ff 16 4 5 Technical Implementation 16 4 6 1 WIR e A P 16 4 6 2 CHIC 17 4 6 3 Response 17 4 6 4 Multiple Hits in Search 17 4 6 5 No Hit in Search 18 Stand 01 01 2011 Seite 3 von 85 User Manual MartServices eS n exM a rt That s e business 5 Takeover of Shopping Baskets 19 5 1 FUNCTION E 19 5 2 Entry Point into the Portal ae see 19 5 3 Fill the Shopping E sauna 21 5 4 Takeover of Shopping Baskets eese 22 5 5 Already created Shopping Baskets E 24 5 6 Technical Implementation
47. klicken 1 950 Watt Elektronik Bohrmaschine 110 Eine kleine handliche Bohrmaschine f r Ihre tagliche Arbeit 5 Kilo Bohrhammer Cum 110 Constant Electronic f r konstante Drehzahl bei Belastung 7 Kilo Bohrhammer me 110 Liegt an der Spitze seiner Klasse der 7 Kilo Bohrhammer 11070 zum Mei eln und Bohren 11 Kilo Bohrhammer z 110 Starker Universalhammer zum schnellen Bohren und Mei eln Figure 4 Displayed list by multiple hits in search 4 6 5 NoHitin Search If the product is not available on the portal the following message is displayed EA Das Produkt wurde nicht gefunden Figure 5 No hit in search Stand 01 01 2011 Seite 18 von 85 User Manual MartServices nexwart That s e business 5 Takeover of Shopping Baskets 5 1 Function The function Takeover of Shopping Baskets allows to fill a shopping basket on the portal interface and then to transfer to the disposition of the own IT System All existing portal functions for filling a shopping basket are available for the customer e g the product catalogues of the supplier and the product search After filling the shopping basket is transferred directly into the IT System or is saved as an open shopping basket The open shopping basket can be picked up later The user books the shopping basket on its own program EDP system Customer Entry into the Portal Create SB 3 OrderRequest T P
48. llD Error Handling NoRightStorefrontMainLogin No rights for login Your account has not yet been released Your login is failed You can start to work if you are registered You have to enter your account number BDE name and password Please contact your in house manager for this information FirstLogin Login has to be done first Your data have to be confirmed Your login is failed You can start to work if you finished the registration process on the homepage of the portal Please enter your account number BDE name and password on the homepage and confirm your data Please contact your in house manager for this information NoBasketViewRight No rights to view the shopping basket The requested action could not be executed because the necessary right is not activated Rights are managed by your in house manager Please log off and on again if you were able to perform this operation before Please contact your in house manager if you receive this message again Seite 48 von 85 User Manual MartServices nexwart That s e business 10 Prices and Availability 10 1 10 2 The Process Stand 01 01 2011 Current prices and availabilities of products can be checked by the MartService order request The order request is done with a filled shopping basket which is enriched with the latest information from the ERP system of the supplier There are three different courses of action to start a
49. lowing is a representation of the scenario described above 1 The user starts to upload the shopping basket as XML to the portal by a click or something similar depends on the implementation The shopping basket is visible in the portal under Open Basket 2 The user s computer system gets a ticket number back which identifies the submitted shopping basket Stand 01 01 2011 Seite 55 von 85 User Manual MartServices eS nexMart That s e business 3 Atthe same time an order request is automatically started The shopping basket is requested in the ERP system ofthe supplier by the portal 4 Thecurrent data return and the shopping basket is ready for collection in the OrderCentre of the portal 5 The EDP system makes a request to the portal for displaying the shopping basket SB by using the ticket number TN 6 The shopping basket will be displayed as a pop up SendSBto Portal Ticket Number Order Request j D Price Availability Request with TN EDP system Import C ecc ERP system Customer Vere Supplier Figure 31 Scenario 2 Schematic Process Attributes of Shopping The interface is displayed in the respective colors of the portal Basket View Basis of representation is OrderDetail from the MartLink OrderCenter The title of the page is Shopping Basket the first header Shopping Basket of dd mm yyyy at hh mm am pm All buttons are removed The only p
50. lue 0 0 totalValue positionPrice positionAttributes lt flagFreePosition gt true lt flagFreePosition gt lt positionAttributes gt results result reference position article catalogueArticleCode code EMBPOS202030 level warning gt customAttribute value Free position type string name textMessage result results position positions docFooter lt counter1 lt counter gt grandTotals grandTotalNetPrice 0 0 grandTotalNetPrice grandTotalTa 0 0 grandTotalTax Stand 01 01 2011 Seite 31 von 85 User Manual MartServices eS n exM a rt That s e business grandTotalGrossPrice 0 0 grandTotalGrossPrice lt grandTotals gt lt docFooter gt results result reference CACreateResult code EMBWKF101010 level success customAttribute value CreateResult success type string name textMessage gt result results doo docs results result reference basketld code EMBWKF301240 level error gt lt customAttribute value Basket not synchronized successfully with ERP for export type string name textMessage gt result results lt basket lt results gt result reference CACreateResult code EMBWKF101010 level success customAttribute value CreateResult success type string name textMessage gt lt resulb results lt ns2 getBasketResponse gt lt S Body gt lt S
51. lue for configurable field does not exist EMBOHC301070 ERROR Incorrect value for configurable field EMBOHC301080 ERROR Multiple error for configurable fields EMBOTH303330 ERROR Error in the order number EMBPLC201010 WARNING Product configuration warning with report EMBPLC301010 ERROR Product configuration error with report EMBPLC301020 ERROR Error in product configuration EMBPLC301030 ERROR No product configuration possible EMBPLP301010 ERROR Requested currency is not supported Stand 01 01 2011 Seite 72 von 85 User Manual MartServices nexwart That s e business MessageCode Level MessageText EMBPLQ201040 WARNING Article is currently not available EMBPLQ201060 WARNING Article is partly available EMBPLQ201070 WARNING Quantity and unit changed by the suppliers system EMBPLQ201080 INFO Amount was increased to a minimum order quantity EMBPLQ201090 INFO Amount was increased to the next packaging unit EMBPLQ201110 INFO Amount was reduced to maximum order quantity EMBPLQ201130 WARNING Quantities alert with report EMBPLQ201140 WARNING Begin of a set Next set without a beginning EMBPLQ201150 WARNING Quantity and unit changed and rounded by the system of the supplier EMBPLQ201160 INFO Availability check for this article is currently not possible EMBPLQ201170 WARNING Text fields are truncated when booking in the ERP EMBPLQ301030 ERROR The maximum order quantity is exceeded EMBPLQ301040 ERROR Article is currently not availabl
52. motepost method transmits the parameters directly to the client just like the remoteget method However the general parameters will be transmitted in contrast to the remoteget method The GET method doesn t transfer the general MartLink Response parameter because of the limited number of possible characters e g 2048 for Microsoft Internet Explorer 3 5 Error Reports An error may occur because of an invalid authentication authorization or invalid parameters in the Request If an error occurs there will be an error page with a list of missing parameters 3 6 International Use Following parameters have to be submitted for the internationalization of the MartLinks MartLinkLocale MartLinkLocal is a valid local ID of 4 letters The first 2 letters define the language according to ISO 639 and the last 2 letters define the country according to ISO 3166 MartLinkCurrency MartLinkCurrency is a valid currency ID of 3 letters according to ISO 4217 Stand 01 01 2011 Seite 10 von 85 User Manual MartServices eS n exM a rt That s e business 3 7 Security The transmission path for the request needs to be secured Also the authentication and authorization has to be ensured for the caller to guarantee the security of the MartLink The security of the transmission path is given by the use of the http s protocol The parameters of the transmission will be left unprotected by the use of http protocol Therefore we recommend
53. n order request with a shopping basket All three courses of action are possible with certain components of the MartServices Prices und Availabilities in the own Shopping Basket The client creates a shopping basket in his own computer and requests prices and availabilities of products by clicking a button like Order Inquiry As a result the latest data are displayed in the shopping basket 10 2 1 Practicable Example with Screenshots The processes are not perceived by the user It is just one click to get the latest prices and availabilities of products In this case the technical modules are linked in a way that they start each other Firma Must diabolo Firma Muster AG Date Besbeten each Extras a A pe amp amp iw e B mh Tet D Stolk Kratz K 1 0 et KG ep tg Kon Stoke Kratz K 1 0 get nt TET owe f see 125 5 6 9 00 1450 42 Angebot drucken Angebot abschlie en 6 00 Br suschal ZRZ3 1 683 65 09 03 200 14 21 bmo lezen E 1d sbclol diabolo mdb Figure 25 Possible Implementation Order Request Seite 49 von 85 User Manual MartServices ab nexMart That s e business Datei Bearbeten Ansicht Extras a s amp G amp E Surtseke sick Drucken Seenanskht Newgation Favarken moserde dek de Aktualisieren kalkulation angebot bearbeiten 2005 00011 Ange
54. nexwart That s e business MessageCode Level MessageText EMBBUY301090 ERROR ERP customer has no read permission EMBBUY301100 ERROR ERP customer has no write permission EMBBUY301110 ERROR ERP customer cannot be executed Wrong customer ID EMBBUY301120 ERROR ERP customer financially EMBBUY301130 ERROR ERP unknown error in the customer ID EMBBUY301140 ERROR ERP customer has exceeded credit limit The currency is changed by the ERP of the supplier through the EMBBUY301150 ERROR requested customer number EMBBUY301160 ERROR Customer has delivery stop in the supplier s ERP EMBBUY301170 ERROR Customer error with report EMBBUY301180 ERROR Field Service error in registration of the customer EMBBUY301190 ERROR Field Service customer not found EMBBUY301200 ERROR Field Service customer has no right to order at the supplier EMBBUY301210 ERROR Field staff has no right to order for the customer EMBBUY301220 ERROR Field Service error in registration of the customer EMBBUY301230 ERROR ERP error in the delivery address EMBLOC201020 ERROR Specified language is not supported EMBOHC201010 WARNING The supplier has not specified a configurable field EMBOHC201020 WARNING No configurable field with this name defined EMBOHC201030 WARNING Value of the configurable field incorrectly EMBOHC201040 WARNING Multiple warnings for configurable fields EMBOHC301050 ERROR Required values for configurable fields do not exist EMBOHC301060 ERROR Required va
55. nglish Stand 01 01 2011 Seite 68 von 85 User Manual MartServices nexwart That s e business 12 10 3 Results Result Level Result Code Result Text Success 000200000 Order is accepted and will be processed error 000230010 Format error Order document could not be parsed info 000011100 The WebService is deprecated and is put out of service in the future Please contact the provider info 000011110 The Version of the WebServices is deprecated The continued use of the version is not recommended Please contact the provider error 000031100 Client Name is missing error 000032100 WebService is unknown wrong WebServicelD error 000032200 WebService Version unknown error 000032300 WebService temporarily out of action error 000032400 Unknown portal error 000032500 Supplier invalid error 000032600 Locale invalid error 000032700 Currency invalid error 000032800 TAN invalid not yet implemented error 000033100 Authentication or authorization of the the specified user has failed unknown Organization User combination or wrong password error 000033200 Authorization for the called WebService is not available no rights Stand 01 01 2011 Seite 69 von 85 User Manual MartServices eS n exM a rt That s e business 13 FAQ Error Possible Cause Proposed Solution No Basket ID returned BDE user password is invalid
56. ning with report EMBSEL201080 WARNING Supplier does not support the currency in eMart EMBSEL301010 ERROR Unknown supplier Stand 01 01 2011 Seite 74 von 85 User Manual MartServices nexwart That s e business MessageCode Level MessageText EMBSEL301020 ERROR No supplier was given in the order EMBSEL301030 ERROR Supplier is offline EMBSEL301040 ERROR Supplier does not support the currency in eMart EMBSEL301050 ERROR The ERP of the supplier does not support the requested currency EMBSEL301060 ERROR Sales Centre error with report EMBSEL301070 ERROR The currency of the suppliers ERP is not supported by eMart EMBSHP201110 WARNING Format error in the delivery date EMBSHP201120 WARNING Invalid delivery date EMBSHP201130 WARNING Supplier does not accept the requested delivery date too early EMBSHP201140 WARNING Supplier does not accept the requested delivery date too late EMBSHP201150 WARNING ERP delivery warning with report EMBSHP301010 ERROR Error in the shipping method Error in the requested delivery date format error date is in the past EMBSHP301020 ERROR or too far in the future EMBSHP301030 ERROR Requested delivery date is too far in the future EMBSHP301040 ERROR ERP format error in the delivery date EMBSHP301050 ERROR ERP invalid delivery date EMBSHP301060 ERROR Supplier does not accept the requested delivery date too early EMBSHP301070 ERROR Supplier does not accept the requested delivery date too late
57. ny bushissstdert AD mpresaum Worth s Fertig 22 11 2005 11 27 marcel huser 106Fnihomelmarcal huberlidiabolo mb The shopping basket can be filled from the catalogue or the product search page All suppliers can be selected It is also possible to convert already stored order templates to new shopping baskets In general all functionalities of the portal are available Stand 01 01 2011 Seite 21 von 85 User Manual MartServices af n exM a rt That s e business Ed NS D Ci G Startseite Zur ck Vorwarts Drucken Seitenansicht Navigation Favorken moser de diabolo de Sto de imstro de Aktualisieren demomart die demo bestellplattform der businessmart ag Ei demomart die demo bestellplattfo A uer reais ETSI Tequip Kurzinfo M Mindestbestellwert Mindermengenzuschlag Frachtfreigrenze Versandkosten Gefahrengutzuschlag Weitere Warenkorbinfomationenr i mehr information Warenkorb Kopfdaten el Usfeescheine Objekt Bite wenen s Kunden Nr Name 3513574 Mustermann D AKTUALISIEREN D AUF AKTIONEN PR FEN Ihr Warenkorb ist leer Pos Artikel Nr iD Menge Einheit EAN Code Bezeichnung Preis Summe Bemerkung o I Bemerkung Schnelertassungszeilen D axtuaus eren AUF AKTIONEN PR FEN Name der Bestelvorlage EI vortace msmun E wantwkons specnern ij WARENKoRS LOSCHEN pl oest
58. of the selected s shopping basket The ID is el unique forthe particular portal Stand 01 01 2011 Seite 52 von 85 User Manual MartServices eS n exM a rt That s e business Table 8 Request Parameter for GetBasket lt soapenv Envelope xmIns soapenv http schemas xmlsoap org soap envelope xmins ns http api businessmart de services emartservices exportTypes 2009 06 23 soapenv Header soapenv Body lt ns getBasketRequest gt lt RequestHeader gt lt Clientld SoapUI_Client lt Clientld gt lt RequestHeader lt buyer gt portalldxabnahme nexmart de portalld organization BDE999999 organization userNameVorname Nachname userName password c password lt buyen lt basketld gt w5QKEBgjaRsAAAEmyPADUUu8 amp lt basketld gt lt ns getBasketRequest lt soapenv Body gt lt Soapenv Envelope gt Figure 28 Example of a Shopping Basket Request Link of Modules The two modules have to be linked together so that the user can call prices and availability with one click The order request is automatically triggered once the shopping basket was sent on the portal by UploadBasket This function is controlled by the parameter command with the value simulate The order request is sent to the ERP system Then the request is edited and returns After that the prices and availability are ready for retrieval The request to collect the shopping basket
59. on The order confirmation will be sent as an email after the successful processing of the order The normal correction process is started and a task generated when an error occurs during the ordering process In contrast to the normal order correction is this task delegated to the customer first and only after a specified time is it automatically delegated to the Organizer Stand 01 01 2011 Seite 62 von 85 User Manual MartServices eS n exM a rt That s e business 12 1 Service Routing The routing of the WebService is performed by the URL and the general WebService request parameter The following are the relevant parameters with their current values WebService ld ProcessOrder WebService Version 1 0 WebService PortallD WebService Supplierld valid name of the supplier 12 2 URL URL for the Test System http soa2 businessmart de ProcessOrderWebServiceAdapterRouter services ProcessOrder URL for the Live System http soa1 businessmart de ProcessOrderWebServiceAdapterRouter services ProcessOrder 12 3 International Use The parameters WebService Locale and WebService Currency have to be in the Request of the WebService These parameters control the following All texts of the shopping basket which are depending on the language are interpreted as default if no language is specified in the order document The order confirmation is generated in that language All s
60. or Country name is not correct for example de DE StoreFrontModeError StoreClientTargetURLError GeneralError General Unknown error Please contact your Support Team DetermineProductFailed Unknown article number only for MartLink ProductDetail Stand 01 01 2011 Table 13 Error Codes Seite 78 von 85 User Manual MartServices 14 2 VBA Example Shopping Basket Takeover nexwart That s e business VBA Example Shopping Basket Takeover Option Compare Database Option Explicit Private Sub cmdBack Click Navigate back On Error Resume Next ocxWeb GoBack End Sub Private Sub cmdForward Click Navigate forward On Error Resume Next ocxWeb GoForward End Sub Private Sub cmdLaunch Click Navigate to Mart links page ocxWeb Navigate txtLinkPage End Sub Stand 01 01 2011 Seite 79 von 85 User Manual MartServices eS n exM a rt That s e business VBA Example Shopping Basket Takeover Private Sub cmdLaunchService Click Generate SOAP Envelope Dim stXML As String stXML funcFormatXML xml version 1 0 encoding UTF 8 2 0 stXML stXML amp funcFormatXML lt soapenv Envelope xmins soapenv http schemas xmlsoap org soap envelope xmlns xsd http www w3 0rg 2001 XMLSchema xmIns xsi http www w3 org 2001 XMLSchema instance gt 0 StXML stXML amp funcFormatXML soapenv Body 1 stXM
61. ossible action is to open and collapse the position fields Characteristics of the modules fieldservice and pricing are not included in this package Stand 01 01 2011 Seite 56 von 85 User Manual MartServices Stand 01 01 2011 TO BBEA Warenkorb wv nexMart That s e business L nexMart das Fachhandelsportal f r Eisenwaren Werkzeuge Beschl ge Microsoft Internet Explorer provided by IE DN S intermal 1 4_SW Architecture Produkt _und_Releaseplanung Packages Mattlink_ViewBasket gfx SX_OrderHistoryView ViewOrderD etail htm Warenkorb vom 10 12 2005 um 16 50 Uhr Firmenadresse nexMart Lieferant Testbestellungen Curiestra e 70563 Stuttgart Bearbeiter Deutschland Ihre Bestell Nr Lieferanten kun GmbH Auftrags Nr Eisenstr 94 00000 Stuttgart Deutschland Versandart Terminversand Lieferadresse Wahrung Kunden Nr Name Bestelltext Besteller eMail gesch Kontakt arunas gedgaudas businessMart de Wunschlieferdatum Tequip Jens Stahl tequip_0k999 15 12 2005 EUR 999999 nexMart KG Bitte liefern Tor 1 Herr M llermaier Zusammenfassung der Bestellung Pos Artikel Nr ID Menge Einheit EAN Code 1 1 St ck 41010 001 4007140066390 Bezeichnung 300 Watt Elektronik Bohrmaschin Zusetzinformationen ein ausblenden Summe Status Eures 2 Meldungen amp Hinweis Anbruchmenge N chste Menge ohne Anbruch 10 00 St ck t Hinweis Angabe nicht m
62. pecifications of the currency in the shopping basket are interpreted as default if nothing else is specified in the Order document The order confirmation is generated in that currency 12 4 Security The transmission path for the request needs to be secured Also has the authentication and authorization to be ensured for the caller to guarantee the security of the WebService https The security of the transmission path is given by the use of the http s protocol Stand 01 01 2011 Seite 63 von 85 User Manual MartServices eS n exM a rt That s e business Authentication The user password combination is transmitted for authentication 12 5 12 6 12 7 12 8 Stand 01 01 2011 The user is identified by Buyer Organization and Buyer UserName and authorized by Buyer UserPassword Both have to match an activated and valid ID on the portal In addition the user must have the right to use the ProcessOrder WebService Format of the Order The order returns as bM OrderXML V1 1 in the answer of theWebService SOAP document Client Information The name ofthe client will be transmitted by the parameter Name for statistical purpose The parameter Client eMailAdress can transmit information about errors and incidents which cannot be returned in the response of a WebService A description of the malfunction will be sent at this address Version Management WebServices will be further developed The version of the WebServic
63. r businessmart ag Zusatzeinstellungen Tequipf E 300 Watt Elektronik Bohrmaschine Art Nr 7777 001 Garantieverlangerung 3 Jahre gt Vorw rts Q Ihre Auswahl des Farbsystems Farbtons f hrt zu keinem Ergebnis Bitte berpr fen Sie die korrekte Eingabe Falls Ihre Auswahl korrekt ist k nnen Sie die Information in den Warenkorb bernehmen Ihr zust ndiges Arbeitszettel VerkaufsCenter wird Sie bei R ckfragen zu Farbton und Lieferverf gbarkeit informieren FS a Lieferscheine Copyright 2000 2005 by businessMart AG powered by AP businessMart Figure 23 Advanced Settings Extended Warranty Ki diabolo Firma Muster AG mp l l sl Datei Bearbeiten Ansiht Extras a D Isi Li V a Vorw rts Drucken Seitenansicht Navigation Favoriten moser de diabolo de Sto de imatro de Aktualisieren a D Startseite Zur ck za demomart die demo bestellplattform der businessmart ag S E Age Zusatzeinstellungen Teq uig Schleifpapier Art Nr 7777 003 Verwendung T Hass M Farbe KR Gewebe D OB ERNEHMEN j Ihre Auswahl des Farbsystems Farbtons f hrt zu keinem Ergebnis Bitte berpr fen Sie die korrekte Eingabe Falls Ihre Auswahl korrekt ist k nnen Sie die Information in den Warenkorb bernehmen Ihr zust ndiges VerkaufsCenter wird Sie bei R ckfragen zu Farbton und Lieferverf gbarkeit informieren a Copyrigh
64. r the Live System http ws nexmart net services emart UploadBasket 2010 08 17 The related schema is available at http ws nexmart net services emart UploadBasket 2010 08 17 wsdl Stand 01 01 2011 Seite 51 von 85 User Manual MartServices n exM a rt That s e business We are happy to provide you an example of this project soapUl Shopping Basket ID The Basket ID is used to identify the shopping basket on the corresponding portal The Basket UUID of the shopping basket is used to map this ID Parameter The following parameters in the table apply for the WebService GetBasket as well as all general parameters from chapter 4 Name Type Required Description Optional command String Optional An ERP request is made if simulate is transferred basket bmXML 1 11 xsd Required The shopping basket as Order Basket XML document Table 6 Request Parameter WebService Upload Basket Name Type Required Description Optional basketld String Required Identifier of the selected shopping basket The ID is unique for the particular portal Table 7 Response Parameter WebService UploadBasket The possible Result Codes are available at http api test businessmart de services emartservices doc eMartServices Er orCodes html WebService See chapter WebService GetBasket GetBasket Name Type Required Description Optional basketld String 128 Required Identifier
65. rUserName name surname amp BasketID 7uoKEBhjJ10AAAENZQS KMUK gt ViewBasket da 3 2 Passing of Request Parameter The parameters for calling a MartLink are passed in http s Request using POST Please keep attention to capitalization of the parameter An error page will occur if invalid parameters prevent the call of the first page of the MartLink 3 3 Passing of Response Parameter The result of a MartLink is initiated by the last user action and transmits the corresponding response parameters to the client from the ClientTargetURL The response can be transmitted by four different methods to the client These are specified in the ClientRequestMethode Stand 01 01 2011 Seite 9 von 85 User Manual MartServices eS n exM a rt That s e business 3 4 Transfer Method localget A response page is transmitted to the client by means of a redirect The specified URL of the ClientRequestURL is transmitted with the parameter GET during the loading process The general request parameters are not transmitted to the client Localpost The localpost method works like the localget method except that the data are transmitted via POST to the client and the general request parameters are included remoteget The remoteget method transmits the parameter directly to the client via GET That is only possible ifthe client is directly accessible from outside The general parameters are not transmitted remotepost The re
66. rice Availability 8 Import nexMart a gt businessMart ERP system Supplier 5 2 Entry Point into the Catalogue Stand 01 01 2011 Figure 6 Schematic representation of the process Entry Point into the Portal The composition of the shopping baskets can be done from different entry points in the portal The user can browse for products access product details and place the product in the shopping basket by using the entry point Seite 19 von 85 User Manual MartServices Entry Point into the Product Search page Entry Point into the Shopping Basket Stand 01 01 2011 neXMart That s e business Doe sutet Amkht Dar 7 Katalog eos Tequigg i c Produkte Bildnavigation Elektrowerkzeuge Bohrmaschinen e Erssttelle CD Dr ucktutisehrauber e a Schleifmaschinen E gt Handwerzeuge J qom E gt Sonderwerzuuge Zusatzeinsteilungen gt Betestiqunostechnik Ersatzteile gt Technische Darstellung der Daten gt Lacke Sie brauchen mehr Power Elektronik Eine Maine nandliche Bohrmaschine f r Ihre tagliche Arbeit Herausragende Merkmale Bohrr Unsere Schlagbohrmascninen berzeugen durch hohes S Tiihon tungsvenm gen und modemste Technik Mit gro en Bedionungskomfort k nnen untarschiadlichete Ardalten gt berspannungsscnutz materialgererht ausgef hn werden Aufgrund inves ergonomischen Slimlime Dasigns die perfelts Abstmmung Ergonomisc
67. rsanch Sonia Hofmann Online Hole 01 092005 08 05 1 EUR 99 00 gebucht versandt Sora Hofmann Onine Techriches Magazin 2507 2005 18 32 1 EUR 93 00 gebucht versari Sonja Hofmann Onine Holz 260520050952 1 EUR 12 77 gebucht versandt Sera Hofmann Online Techniches Magazin 230520051918 1 EUR5363422 gebucht 230520051238 1 EUR 99 00 gebucht versant Bestelportal Soris Hofmann Online i Sees Hofmann Online Holz go 230520051148 1 EUR 167 00 gebucht versandt Som Hofmann Online Holz 23052005 11 18 1 EUR 16700 gebucht versandt a Copyright 2000 2005 by businessMart AG poweredby at businessMart zi 18 12 2005 10 37 sabine wasner IGSfn homel sabine wasner dlabolo mdb 7 Figure 17 Entry point into the Order Centre Stand 01 01 2011 Seite 33 von 85 User Manual MartServices eS n exM a rt That s e business 6 3 Search and Filter Orders can be filtered and searched according to certain criteria The user can select the filter or enter keywords on the interface These settings can also be displayed automatically when the Order Centre is called These settings can be specified as request parameters Lieferant Teaup Mitarbeiter Sonja Hofmann Status gebucht Kostenstelle Alle Bestellzeitraum Bestell Nr B ae Figure 18 Input and filtration to search for orders 6 4 Differences to the Online Features The MartLink cannot perform all functions of the storefront
68. s 5 6 Technical Implementation Devices of MartServices The takeover of shopping baskets consists of a MartLink and a WebService The MartLink PickBasket is used to access the portal MartLink from the own IT System The WebService GetBasket is used to pick up PickBasket a shopping basket from the portal and to transfer the shopping basket into the IT System of the user After the takeover of the order the MartLink returns supplier ID shopping basket ID checksum and TransActionNumber expiration date Stand 01 01 2011 Seite 24 von 85 User Manual MartServices n exM a rt That s e business 5 7 MartLink PickBasket 5 7 1 URL The MartLink ID to PickBasket is pickbasket https lt Portal URL gt martlink pickbasket 5 7 2 Request The following parameters in the table apply forthe MartLink OrderCenter as well as all general parameters from chapter 3 Name Type Required Description Optional TargetPage String required This parameter is for choosing the basket entry point from shopping basket catalogue product search or open catalog E ao duree a shopping baskets openbaskets i The specification of a supplier MartLink Supplierld is necessary for the entry into shopping basket catalogue and product search 5 7 3 Response The Response of the MartLink is initiated by clicking Apply Shopping Basket The following parameters in the table apply for
69. s established according to the following pattern http PORTAL martlink lt SERVICE gt PORTAL is the URL of the portal und SERVICE the name of the MartLinks or WebServices Illustration http www portal de martlink productdetail Parameter There are parameters which apply to all MartLinks and have to be implemented as well as specific parameters which are needed only for the particular MartLinks In Chapter 3 are all request and response parameters listed which apply to all MartLinks alike In addition the individual parameters have to be considered These are listed in the individual chapters Illustration An authentication and authorization of the user and the order number or GTIN EAN code of the device is required in the case of the MartLink ProductDetail For example the parameter ProductID and a String as the value is sent in the http Post Request Stand 01 01 2011 Seite 8 von 85 User Manual MartServices eS n exM a rt That s e business 3 1 URL The URL for the http s Protocol of a MartLink is established according to the following pattern http lt Portal URL gt martlink lt MartLink Id gt or https lt Portal URL gt martlink lt MartLink Id gt Portal URL is the base URL of the portal and MartLink Id is the identifier of the called MartLink e g a Get call with a HTML Link a href http demomart nexmart de martlink viewbasket BuyerOrganization BDE amp Buye
70. s the submitted shopping basket 3 Atthe same time an order request is automatically started The shopping basket is requested in the ERP system of the supplier by the portal 4 The current data return and the shopping basket is ready for collection in the OrderCentre of the portal Stand 01 01 2011 Seite 50 von 85 User Manual MartServices nexMart That s e business 5 The EDP system makes a request to the portal to collect the shopping basket SB by using the ticket number TN It is recommended to wait 5 seconds plus 2 seconds for each position before a renewed pick up of the shopping basket is possible 6 The shopping basket will be sent in XML format to the computer The state of the shopping basket can be determined from the Resultcode SendSB to Portal Ticket Number Order Request Price Availability mu Requestwith TN nexwart EDP system Import Ol businessMart ERP system Customer O Supplier Figure 27 Scenario 1 Schematic Process 10 2 3 Technical Implementation The scenario is technically implemented with WebServices You will find specific information in this chapter Please read also the general information about WebServices from chapter 11 The following modules are needed for scenario 1 WebService UploadBasket WebService GetBasket WebService URL for the Test System UploadBasket http ws test nexmart net services emart UploadBasket 2010 08 ay URL fo
71. sOrder as well as all general parameters from chapter 4 8 2 Name Type Required Description Optional webService portalld String 1 128 Yes Name of the portal case insensitive webService hostName String 1 256 No The name of the host which is generated by the response This information is used only for internal use and tracking case sensitive errors webService DateTime No Atime stamp that holds the timestamp date and time of the created Response Stand 01 01 2011 Seite 67 von 85 User Manual MartServices eS n exM a rt That s e business Name Type Required Description Optional security signature String 1 1024 not yet A valid signature on all parts ease sensitive implemented except the signature itself results summary String Yes Conclusion of the WebService attributes of results success info call for detailed description warning error see chapter 4 7 fatal case insensitive result code String 11 Yes The symbolic code of Results is constructed in the following format NNNN L CCCC NNNN is the number of the WebService 0000 correlate to general Results L is the Level O2success 1 info 2 warning 3 error und 4 fatal and CCCC is the error code attributes of results result text String Optional A plaintext message can be sent to the error code in this 10 4096 field The language is based on the WebService Locale the fallback is E
72. scenario is technically implemented with a WebServices and a MartLink You will find specific information in this chapter Please read also the general information about MartLinks and WebServices from chapter 3 and 4 The following modules are needed for scenario 2 WebService UploadBasket MartLink ViewBasket WebService See chapter WebService UploadBasket UploadBasket Stand 01 01 2011 Seite 58 von 85 User Manual MartServices n exM a rt That s e business MartLink ViewBasket The following parameters in the table apply for the MartLink ViewBasket as well as all general parameters from chapter 4 URL The MartLink ID for ViewBasket is viewbasket https Portal URL martlink viewbasket Name Type Required Description Optional BasketID String 128 Required 24 digit UUID of the shopping basket e g ATDBHGBd9iwAAAD2c8N v vhn In the GET method escaped e g ATDBHGBd9iwAAAD2c8N v 2evhn case sensitive ClientTargetURL String 1 512 Required URL of the client to whom the Request is sent ClientRequestMethod String 1 32 Required Method by which the Response to the calling localget ae localpost Client is passed MartLinkld String 1 128 Required Identifier of the calling MartLinks e g ViewBasket case sensitive Table 9 Request Parameter for the MartLink ViewBasket Link of Modules The two modules have to be linked together so t
73. t is not available on the referenced portal 5 8 4 Request Parameter The following parameters in the table apply for the WebService GetBasket as well as all general parameters from chapter 4 Name Type Required Description Optional basketld String 128 required Identifier of the selected shopping basket The ID is case Schale unique forthe particular portal soapenv Envelope xmIns soapenv http schemas xmlsoap org soap envelope xmlIns ns http api businessmart de services emartservices exportTypes 2009 06 23 gt soapenv Header lt soapenv Body gt lt ns getBasketRequest gt lt RequestHeader gt lt Clientld SoapUI_Client lt Clientld gt lt RequestHeader lt buyer gt portalldxabnahme nexmart de portalld organization BDE999999 organization lt userName Vorname Nachname lt userName gt password cpassword lt buyen basketld w5QKEBgjaRsAAAEmyPADUUUS8 basketld lt ns getBasketRequest soapenv Body lt soapenv Envelope gt Figure 15 Example of a GetBasket Request Stand 01 01 2011 Seite 28 von 85 User Manual MartServices e n exM a rt That s e business 5 8 5 Response Parameter The following parameters in the table apply for the WebService GetBasket as well as all general parameters from chapter 4 Name Type Required Description Optional basket bmXML 1 11 xsd optional The shopping basket returns as Order B
74. t 2000 2005 by businessMart AG powered by a businessMart Figure 24 Advanced Settings Purpose Stand 01 01 2011 Seite 46 von 85 User Manual MartServices eS n exM a rt That s e business 9 MartLink AutoLogin The MartLink AutoLogin is a call of the eMart surface with an automatic login Full Functionality The surface contains the full functionality of eMart with all menus etc Regular CI The surface has to appear in the regular portal shop CI Direct entry to Shopping Basket The user goes direct to the shopping basket by calling the parameter BasketlD Verification of Rights The rights of the user login and the authority of the requested function are checked Fallback The login is based on the settings ofthe user if no BasketlD is handed over by the system Call of URL https Portal URL martlink autologin Call of Parameter Parameter Required OrderScan configuration value BuyerOrganization Yes BuyerOrganization BuyerUserName Yes BuyerUserName BuyerUserPassword BuyerUserPassword Stand 01 01 2011 Seite 47 von 85 User Manual MartServices Stand 01 01 2011 wv nexwart That s e business Parameter Required OrderScan configuration value ClientTargetURL MartLinkLocale MartLinkCurrency ClientTargetURL Yes ClientName Yes ClientName ClientRequestMethod ClientRequestMethod MartLinkld Yes MartLinkld MartLinkVersion Yes MartLinkVersion MartLinkPortallD Porta
75. t parameter of a MartLink 3 10 2 Response Name Type Guaranteed Description PortallD String 1 128 Yes Identifier of the portal which enerated the R nse case insensitive generated the Response HostName String 1 256 No Name of the System which generated the Response This information is used only for internal use and tracking errors case sensitive ResponseTimeStamp DateTime No Atime stamp that holds the date and time of the created Response Table 2 General Response parameter of a MartLink Stand 01 01 2011 Seite 13 von 85 User Manual MartServices eS n exM a rt That s e business 4 Product Details 4 1 4 2 4 3 4 4 Stand 01 01 2011 Function Product and delivery information can be accessed by your own ERP There is no need of a portal login In this way your usual computer system can be enriched by numerous information of products from all suppliers of the portal Key Features Link to product details from an external system e g ERP System Call of product details of a supplier e g spare parts accessories user manuals etc Show the product details in a browser window via URL or integrated in the computer interface This feature can be activated for every supplier und customer Customer Benefits The user obtains detailed information on products without a portal login or leaving his usual program Efficient call of product details witho
76. tServices eS n exM a rt That s e business 9 MaitLitnk Autologin sense ae 47 10 Prices and Availability EEN 49 A ENEE te TEE 49 10 2 Prices und Availabilities in the own Shopping Basket 49 10 2 1 Paractical Example with Srceenshots 49 10 2 2 Attrtbutes Drocess eessessssssssesssesssesesesssesesesesessreeee 50 10 2 3 Technical Implementation 51 10 3 View Prices and Availability esee 54 10 3 1 Practical Examples with Screenshots 54 10 3 2 Attributes Process essssssssesssssssssssesssssesesesereserssereee 55 10 3 3 Technical Implementation cessere 58 10 4 Online Request of Price and Availability 60 11 Base of all WebServices sssesesesesesesesesosesesesesesereseeeseseseeeseeese 61 11 1 1 Request for new structure sees 61 11 1 2 Response for new structur eese 61 12 WebService ProcessOrder eese eere eene 62 12 1 Service Routing cesses esee esent nnne 63 edv EE HEC D RM 63 12 3 International Se iicet rens 63 LP TEMEST D ES 63 12 5 Format der Bestellung 64 12 6 Client Information 64 12 7 Version Management 64 12 8 Traceability of the Response eese 64 12 9 Exceptions and Error Handling o ocurren eoo 65 12 10 Technische Implementierung 66 12 10 1 Request bar
77. tem http ws test businessmart de services emart ExportBasket 2009 06 23 URL for the Live System http ws businessmart de services emart ExportBasket 2009 06 23 The related Schema is available at http api test businessmart de services emartservices doc xsd HtmlDoc Exp ortBasketData xsd html The routing of the WebService is performed by the URL and the general WebService request parameter The following are the relevant parameters with their current values WebService PortallD WebService organization WebService userName WebService password WebService basketld 5 8 2 Format of the Shopping Basket The shopping basket returns as bM OrderXML V1 1 bmXML 1 11 in the answer of theWebService SOAP document Ask for the specification of bM OrderXML V1 1 in case you have not received these 5 8 3 Exceptional Act An exception is set for the WebService GetBasket AWarning will be created if the shopping basket gets modified during the process of the MartLink PickBasket and the WebService GetBasket This is examined by the Checksum The shopping basket returns with a Warning if the ERP System of the supplier cannot be accessed or a reconciliation error occurs AnErroris shown if the shopping basket cannot be exported Stand 01 01 2011 Seite 27 von 85 User Manual MartServices eS n exM a rt That s e business An Error is shown if the Basket ld of a referenced shopping baske
78. the MartLink ProductDetail as well as all general parameters from chapter 3 Name Type Required Description Optional Supplierld String 128 guaranteed The Supplierld identifies the einsame supplier ofthe compiled shopping basket Basketld String 128 guaranteed Identifier of the selected shopping basket The ID is unique for the nsitive SES particular portal Stand 01 01 2011 Seite 25 von 85 User Manual MartServices eS nexMart That s e business Name Type Required Description Optional CheckSum Integer not yet A checksum of the selected implemented shopping basket will guarantee that no changes in the shopping basket remain unnoticed during the selection and the further process of the shopping basket TAN Integer not yet The transaction number for the implemented WebService GetBasket is required and allows invalidating the process PickBasket ValidUntil DateTime not yet ValidUntil is the information about implemented how long the Transaction ID stays validity i SupplierId tequip A BasketId Kt4KEBhjxe4AAAEHjArUFUuHD CheckSum 1133364079246 TAN 0 Figure 14 Example for the unhidden Response Stand 01 01 2011 Seite 26 von 85 User Manual MartServices eS n exM a rt That s e business 5 8 WebService GetBasket We are happy to provide an example to illustrate the project soapUI WebService GetBasket 5 8 1 URL URL for the Test Sys
79. ty gt 3 stXML stXML amp funcFormatXML basketld amp txtBasketld amp basketld 3 StXML stXML amp funcFormatXML checlo 3 StXML stXML amp funcFormatXML checkSum amp txtCheckSum amp lt checkSum gt 4 stXML stXML amp funcFormatXML checlo 3 Stand 01 01 2011 Seite 80 von 85 User Manual MartServices eS n exM a rt That s e business VBA Example Shopping Basket Takeover stXML stXML amp funcFormatXML ExportBasketRequesb 2 StXML stXML amp funcFormatXML lt soapenv Body gt 1 stXML stXML amp funcFormatXML soapenv Envelope 0 Display SOAP Message txtRequest Replace stXML vbTab Transfer SOAP Message to SOA Dim xmlRequest As New XMLHTTP With xmlRequest Open POST txtWebServiceURL False txtLogin txtPwd setRequestHeader Content Type text xml Bei Fehlern den Wert application x www form urlencoded f r Content Type verwenden setRequestHeader SOAPAction getBasket send stXML End With Display response txtResult Replace xmlRequest responseText x gt amp vbCrLf amp lt End Sub Private Sub cmdRestore Click Call form load event Call Form Load Empty text boxes txtSupplierlD txtCheckSum txtBasketld txtTAN txtBDE BDE999999 Stand 01 01 2011 Seite 81 von 85 User Manual MartServices eS n exM a rt That s e business VBA E
80. ut time consuming search Extensive product details for users who do not order via internet browser The user receives all the information of a product quick and easy except it is not offered by the seller on the portal What details are displayed Depending on the database all product information is available except it is not offered by the seller It could be Details to the article Product description commercial and technical data Photos of products and usage Spare parts Accessories Variations User manuals Seite 14 von 85 User Manual MartServices nexwart That s e business Dimensioned and exploded drawings Other datasheets Prices will not be displayed PRODUKTDETAILS ERSATZTEILE ZUBEH R WEITERE 5 Kilo Bohrhammer 11060 Kurzbeschreibung Constant Electronic f r konstante Drehzahl bei Belastung Stand 01 01 2011 Produktdetails Ausf hrliche Beschreibung Constant Electronic f r konstante Drehzahl bei Belastung Stellrad f r vorw hlbare Drehzahl Schlagzahl bzw Schlagst rke SDS max Werkzeugaufnahme f r sichere und schnelle Verriegelung kompakte bertragung des Drehmoments mit integriertem Staubschutz Universalhammer zum Bohren und Mei eln Pictogramme Cae Langste Lebensdauer Der neue 5 Kilo Bohrhammer ein echter Dauerlaufer hat die l ngste Lebensdauer seiner Klasse Starke Technik Die Technik des 11060 ist speziell auf den Bohrbere
81. utton Stand 01 01 2011 Seite 41 von 85 User Manual MartServices af n exM a rt That s e business 3 demomart die Demo Bestellplattform der businessMart AG MIO o Farbtonpr fung Farbsystem e sx Farbton D os J Ihre Auswahl ergab 50 Farbt ne Farbsystem Farbton Sto Farbton RAL 1001 Beige RAL1001 RAL 1002 Sandgelb RAL1002 RAL 1004 Goldgelb RAL1004 RAL 1006 Maisgelo RAL1006 RAL 1018 Zinkgelb RAL1018 RAL 1020 Olivgelb RAL1020 RAL 1021 Rapsgelb RAL1021 RAL 1036 Perlgold RAL1036 RAL 3000 Feuerrot RAL3000 RAL 3003 Rubinrot RAL3003 RAL 3005 Weinrot RAL3005 RAL 3009 Oxidrot RAL3009 RAL 3011 Braunrot RAL3011 RAL 3012 Beigerot RAL3012 RAL 3014 Altrosa RAL3014 Farbt ne 1 bis 15 von 50 E 1234 gt D Assrechen a Erg Vertrauensw rdge Sites Figure 21 Color check The user gets a note if the required color does not exist figure 21 Stand 01 01 2011 Seite 42 von 85 User Manual MartServices ab nexMart That s e business Z demomart die Demo Bestellplattform der businessMart AG Mien soft In Farbtonpr fung Farbsystem RAL v Farbton Jorange D PR FEN Ihre Auswahl f hrte zu keinem Ergebnis Ihre Auswahl des Farbsystems F arbtons f hrt zu keinem Ergebnis Bitte berpr fen Sie die korrekte Eingabe Falls Ihre Auswahl korrekt ist k nnen Sie die Information in den Warenkorb bernehmen Ihr zust ndiges VerkaufsCenter wird Sie bei R
82. vice String 1 128 required Name ofthe portal portati case insensitive webService String 1 128 optional A valid identifier of a supplier SES case insensitive webService locale String 4 required A valid locale ID consists three case sensitive parts ISO 639 Language Code 2 letter lower case separator _ ISO 3166 Country Code 2 letter upper case e g de DE de AT en GB webService String 3 required A valid currency ID according to currency Geet ISO 4217 e g EUR CHF USD etc webService tan Integer not yet A valid TransActionNumber implemented Stand 01 01 2011 Seite 66 von 85 User Manual MartServices n exM a rt That s e business Name Type Required Description Optional buyer organization String 9 required ID of the customers company consist 3 letters and 6 digits case sensitive e g BDE999999 buyer userName String 1 255 required The username of the customer consists of lt name gt lt surname gt case sensitive Special characters are not allowed buyer password String 8 128 required Password of the user case sensitive security signature String 1 1024 not yet A valid signature on all parts Ee implemented except the signature itself order bmXML 1 11 xsd required The processed order as Order Basket XML document 12 10 2 Response The following parameters in the table apply for the WebService Proces
83. w shopping basket At that point the user can enter the article numbers in the fast entry lines Seite 20 von 85 User Manual MartServices neXMart That s e business Dae Bewbeben Ansicht Extras Figure 9 PickBasket 5 3 Fill the Shopping Basket R E Vi x 2 Sehenersicht evgation Favoriten m TELA zi n ndis tellplattform der businessmart ag uererant exe d AKTUELL SERVICE D porta ADMIN IMFO Land Deutschland Beschrelbung Versandart KEE Status Buchung maghch Budget EUR 15 000 00 Abrechnungszeraum He Quartal Genehmigurgsorozess nicht gefunden Vorkaufsconter Bitte w hlen Sie ein Versaufscenter Stutgart z Die mil einem gekenn2eichnolen Felder m ssen unbauingl ausgef ll werden Dl dctunusicxen Euraconen proren Anzahl der Positionen 1 g Pos Artiket Me L sch D Menge Einheit EAN Code Bezeichnung Preis Summe St v E ox a nes 300 V sft lektronik Bohrmeschine ara m A gt po weier ar Bemerkung F Seene E zeien T Schielerfsesungezele e geg Gesamt netto LII Dl ocunisism ms BRIE Gesamt brutto EUR 14404 Nome dee Strate El vortace mamm fj Wakemcoen sericnenm P warenxonn L schen g wsmu uwcmucww Bicterter feimeise leterber richtletertr 2 Angebe zur Zei richt pcdlch k A keine Diretiverondung zum System des Listererten 9 richt bestelbar 8 CogyrefY 2000 2005
84. xample Shopping Basket Takeover txtLogin Admin Admin txtPwd passwort txtPortallD demomart de Clear web component ocxWeb Navigate ocxWeb Navigate txtLinkPage ocxWeb Navigate txtLocalHTML End Sub Private Sub Form Load Fill text boxes with default settings txtLocalHTML file c Temp test html txtLinkPage http demomart businessmart de links html MartLinkPickBasket txtWebServiceURL http swa2 businessmart de GetBasketAdapterRouter services ExportBasket txtBDE BDE999999 txtLogin Admin Admin txtPwd passwort txtPortallD demomart de End Sub Private Sub ocxWeb_NavigateComplete2 ByVal pDisp As Object URL As Variant Variable declaration Dim intCounter As Integer Check if test page has been loaded If InStr 1 URL Mid txtLocalHTML InStrRev txtLocalHTML 2 gt O Then Get parameter string Dim stParameters As String Stand 01 01 2011 Seite 82 von 85 User Manual MartServices nexwart That s e business VBA Example Shopping Basket Takeover stParameters Mid URL InStr 1 URL 1 Split parameters into array Dim arrParameters As String arrParameters Split stParameters amp Get parameters and their corresponding values Dim arrParamValues As String Dim stResult As String For intCounter 0 To UBound arrParameters 1 arrParamValues Split arrParameters intCounter Select Case arrPar

User Manual MartServices

Contents

Download Pdf Manuals

Related Search

Related Contents