technical documentation in order to link your erp system ...€¦ · technical documentation in...
TRANSCRIPT
Technical Documentation
In order to link your ERP System to nexMart
System processes, description of interface and nomenclature
Technical specification for nexMart-specific CSV-formatSeite 2 von 30
29.05.2008
nexMart reserves the right to change the content of this document at any time without notification.
The information given in the document are 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 businessMart AG. Software referring the
documentation is property of the Copyright-owner.
Copyright © 2000 – 2008 nexMart. All rights reserved.
Date Version Author Amendment
28.03.2006 1.0 Taso Mussilarikos
BusinessMart AG
Commission number
Adaption of field description
Adaption of examples in chapter 5.1
30.03.2006 1.0 Sabine Haim
nexMart
GmbH&Co.KG
English translation
09.05.2006 1.3 Taso Mussilarikos
BusinessMart AG
Commission-Number for Orderresponse
Qualifier for commissionnumber in orders (field
H26)
Fildes H30 and H31 used as internal duplicate-ID
and nexmart-ordernumber
10.10.2006 1.4 Holger Werner
nexMart
GmbH&Co.KG
Terms of Transport H17: Changed from „EXPRS“
to EXPR
29.05.2008 1.4.5 Holger Werner
nexMart GmbH &
Co. KG
Quantitiy Unit, Dial Up Connections, new terms
of delivery, Explanation Fields P21-23,
corrections terms of delivery
16.03.2010 1.4.5 Dirk Brundelius,
nM
Correction of emailaddresses
13.04.2010 1.4.6 Dirk Brundelius,
nM
Correction of Explanation Deliveryaddress (H11-
16)
17.08.2010 1.4.7 David Neuscheler Page 10: information about body orders
26.04.2013 1.4.7 Dirk Brundelius Definition separator, chapter 4
Technical specification for nexMart-specific CSV-formatSeite 3 von 30
29.05.2008
Technical specification for nexMart-specific CSV-formatSeite 4 von 30
29.05.2008
Index
Index ____________________________________________________ 4
1.The way of placing an order from your erp system to nexMart 6
1.1. Manual import of an order to nexMart ___________________ 7
1.2. Automated order process via nexMart ___________________ 9
1.2.1.Order process and collection of raw data _______________ 9
1.2.2.Preparation of data ___________________________________ 9
1.2.3.Configuration of the connection ______________________ 10
1.2.4.Transmission of data _________________________________ 11
1.2.5.Work steps __________________________________________ 12
1.2.6.Import of returning order confirmations ______________ 12
1.2.7.Illustration of returned information to nexMart _______ 12
1.2.8. Schematic illustration of an order data (imp. & exp.) ____ 13
2.Import errors ___________________________________________ 13
2.1. Errors in import files _________________________________ 14
3.Receipt of order confirmation ____________________________ 14
4.nexMart-specific CSV format _____________________________ 17
5.Example for Export CSV (minimal) _________________________ 19
6.Specification : header data for nexMart specific CSV format _ 20
6.1 Explanation of the header data __________________________ 20
7.Specification: position data for nexMart-specific CSV format 23
Technical specification for nexMart-specific CSV-formatSeite 5 von 30
29.05.2008
7.1. Explanations of position data __________________________ 24
8.Appendix ________________________________________________ 26
8.1 Examples of orders in csv format _______________________ 26
8.2. Nomenclature ________________________________________ 27
8.2.1. Units _______________________________________________ 27
8.2.2.further codes _______________________________________ 28
8.2.3.Supplier’s identification ______________________________ 28
8.2.4.Glossary ____________________________________________ 28
8.3. Your contact person __________________________________ 30
Technical specification for nexMart-specific CSV-formatSeite 6 von 30
29.05.2008
1. The way of placing an order from your erp system
to nexMart
The way of
placing an
order
Up to now your orders which have been generated from your ERP system has been sent via fax to
each single supplier.
Besides that your ERP sytem offers the possibility to place an order electronically as data file. The
order can be send to nexMart per Email, FTP, or via http(s)-post. Now the order will be checked on
plausibility, which means if all mandatory fields are filled out and if all article numbers are
available.
Your orders will be transmitted automatically to the supplier where they will be processed by an
“Inventory management system”/ Dealer ERP system.
As soon as the order is completely confirmed and accepted, you will be informed about the delivery
status (availability of items, delivery times and conditions) by Email.
Beside the possiblility to import orders manually to nexMart (browser), the orders also can be
transferred automatically from your ERP system to nexMart.
An order can occur in two different ways:
a) By registration on nexMart (manual process)
You access nexMart and click at <PORTAL> | <ORDER CENTRE>. There you can find already stored
orders which can be modified, send or deleted now. Furthermore you have the possibility to
start an availability check or an individual price check.
Technical specification for nexMart-specific CSV-formatSeite 7 von 30
29.05.2008
b) Without registration on nexMart (silent commerce)
The entire process is regulated automatically from your ERP system without access on nexMart.
You decide the way of ordering and can find all information referring your placed orders from
your ERP system within your EDP system.
After processing of data on nexMart the result will be imported into your ERP system again and can
be processed again. Further processes will be illustrated individually in your ERP system.
In order to assure a secure import and export of information the following guideline has been
worked out.
1.1. Manual import of an order to nexMart
Register at www.nexMart.net. Choose from the menu bar Portal and hereunder IMPORT.
A list will show you all open and saved orders which have been imported or complied online.
Thereby you have the possibility to store several orders from a supplier.
Instructions within the head of an order have the following meaning:
Report of Line Description
Technical specification for nexMart-specific CSV-formatSeite 8 von 30
29.05.2008
Import data
on nexMart
1 Supplier Selected supplier of the order
2 Source Source of the order - Import or Online
3 Order number Your order number (from file or online)
4 Date Date of order
5 Positions Number of positions
6 Total amount Total amount of the order
7 Status Within shopping
basket case
Actual (open)shopping basket case
Stored Stored shopping basket case
8 Buttons
With just one click you will be transferred to the shopping
basket case and can modify your order
The order will be transferred to the supplier with just one click.
Due to this button you can delete your order. Now the order will
not appear within the order overview.
While importing data errors can occur (e.g. the access for the desired supplier is missing, the
desired delivery data is in the past). This will be shown to you in an editable window. This order can
be modified and re-imported immediately.
Technical specification for nexMart-specific CSV-formatSeite 9 von 30
29.05.2008
1.2. Automated order process via nexMart
1.2.1. Order process and collection of raw data
An automated order process via nexMart starts after having placed an order,
- Manually (import of data)
- After occurrence of a certain event (event-controlled) or
- controlled by time (batch-controlled)
with collecting the raw data within your ERP system.
In order to place an order on nexMart certain information are necessary. This fields which are
mandatory are marked.
In the best case all further data necessarily for the process will be completed automatically from
the information deposited on nexMart. This information can be data of delivery address or other
relevant references (e.g. your supplier-specific customer number).
In case you wish to use further functions at nexMart additonal information of your ERP system
necessary.
This relates for example:
- An alternative delivery address,
- Kind of delivery,
- Desired delivery date & time,
- Your own order number,
- Additional order text.
1.2.2. Preparation of data
If data are not available in a standardized format data will be edited according to one of the
following formates:
- XML (openTRANS, SAP-XML, own standard)
- CSV (own standard)
- ASCII (own standard, BOSCH Extranet)
- EDIFACT
Technical specification for nexMart-specific CSV-formatSeite 10 von 30
29.05.2008
Detailed information referring other data formats can be find in following documents. This
(always updated) specifications can be downloaded under: www.nexMart.de, ERP downloads.
Automated orders will be lead to the purchasing level at first. In order to be assure this
allocation it is obligatory to indicate your personal user dates (e.g.: customer number and user
name - but not the password) within your order dates.
Processed orders are listed under „Portal “-> „order center“ .
1.2.3. Configuration of the connection
After selecting the medium of transmission this will be configurated and initialized.
Herefore, actually we offer the choice of the following protocols:
-FTP
-http(s)
The dates of communication have to be installed and have to be deposited on the ERP system.
If you should use the element Email, the order will be send to
- [email protected] (Germany)
- [email protected] (Austria)
- [email protected] (Switzerland)
- [email protected] (Spain)
- [email protected] (NL/BE/LU/Global)
The order will be shown within the menu bar under Portal | order center. Here it is possible to
delete the order, to transfer the order into the shopping basket and after all to send it to the
supplier.
This (half)-automated way of ordering represents the preliminary stage of the so called
SilentCommerce. Thus you can check if your order is complete and without errors and
furthermore it deliver an insight into functions of nexMart at the same time.
After a short test period you only adjust the addressee of you order to [email protected],
[email protected] , [email protected], [email protected], [email protected]
From now on the order process is fully automatic.
No more need to access or other interventions.
Technical specification for nexMart-specific CSV-formatSeite 11 von 30
29.05.2008
It’s so easy to handle!
Comment about mail-orders: Because of increasing problems with spam, nexMart integrated
some mechanism to avoid spasm. For that reason some versions of transmission could cause
problems:
1. Mails send by a dial-up connection (e. g. analog modem)
2. Mails from not identified mail-servers.
In this cases, the orders will not be accepted by the nexMart or businessMart mail-server.
If you recognize related problems, please contact the nexMart helpdesk (+34 902 30 92 92)
Please make sure that you send your order as an attachment. It is not possible to send the
order in the e-Mail body.
If you should prefer the transmission way FTP we require some information in order to configure
your FTP Account. Those are:
- Company
- Level of automation (half or fully automated)
- Email address for confirmation of order (in case of no transmission in field H29)
If you should desire to receive the confirmation of order via FTP please note that in your enquiry.
Otherwise please get in contact with us therewith we can send you all necessary connection
data.
For an installation of http(s) please get directly in contact with us.
1.2.4. Transmission of data
As soon as the connection is established data will be transmitted through the favorite medium.
Hereby the files are usually protocolled with:
- Send-status,
- MessageID,
- Date,
- Numbers of blocks
- And other identification (e.g. transaction numbers)
Technical specification for nexMart-specific CSV-formatSeite 12 von 30
29.05.2008
1.2.5. Work steps
(1) The ERP system generates a list which will be stored as e.g. table in a database or as flatfile
(ASCII) on a local file system.
(2) Within certain time intervals (batch-controlled) or as result of a certain events (event-
controlled) the ERP system will be told to process a data-transmission to nexMart.
(3) The content of the table (a flatfile) will be imported and converted into one of the
standardized or nexMart-compatible formates and the header will be generated. An unique
code will be inserted to the header (field H3) and stored as a file.
(4) Afterwards an Email with the particular country domain e.g. [email protected] will be
generated and the file will be send as an attachment. Another possibility is to store the file
into the folder “orders” on your FTTP Account.
1.2.6. Import of returning order confirmations
The order confirmation returns from nexMart in the same standardized data file of the order and
the medium of transmission. Notwithstanding you can choose between Email and FTP for
returning the message while using the transmission way on FTP.
In the next step these will be processed by reference, enrichment or aggregation on the data
level. At this point the information returned is assigned to the initiating order and the status
returned of each position. Further rules (Business Rules) can be integrated, e.g. depositation of
other alternatives. As data are now available in the ERP system structure they are stored
automatically at the corresponding places.
1.2.7. Illustration of returned information to nexMart
In order to make the results visible to the responsible person the information gained are edited
and issued on a graphical user interface (GUI).
Now you can see the status of your online-order in a common way of your ERP system display
surface.
Technical specification for nexMart-specific CSV-formatSeite 13 von 30
29.05.2008
1.2.8. Schematic illustration of an order data (import and export)
2. Import errors
Technical or syntactical errors respectively invalid inputs will be detectived through a pre-
processing system and will be returned to sender’s address by routine-error-treatments.
If the data can be imported in a technical point of view further data examinations will follow on
nexMart.
If an error status is shown on a file or a mail within the import overview this can be due to different
causes.
Please change your settings in your ERP system, in order to remove the error.
Auslöser
Sam m eln
der
Rohdaten
Aufbereiten
der Daten
Auslöser
(Listen)
(Detect)
Verarbeiten
der Daten
Daten weg-
schreiben
Darstellung
Ergebnis
W aW i
Export
W aW i
Im port
nexM art
Verarbeitung
Sender Em pfängernexM art
Konfig.
Verbindung
In ternet Services
Optional
Log protocol requested
Technical specification for nexMart-specific CSV-formatSeite 14 von 30
29.05.2008
2.1. Errors in import files
Format error
The import file contains invalid symbols or necessary symbols are missing (e.g. Semicolon as
separator) or keywords (HDR, POS). nexMart is not able to recognize the structure of the order.
Invalid format
Each field content with an incorrect format is issued.
Data contain invalid values, e.g. invalid date format.
Invalid Data
The data indicated are not registered on nexMart respectively a wrong supplier or a non existing
nexMart user has been stated.
Each field content with an invalid format is issued.
3. Receipt of order confirmation
In order to keep you fully informed about your order status you receive an order confirmation
from nexMart by Email. There you can see exactly all your articles ordered.
Technical specification for nexMart-specific CSV-formatSeite 15 von 30
29.05.2008
Technical specification for nexMart-specific CSV-formatSeite 16 von 30
29.05.2008
Besides this confirmation you will also find attached in your Email a CSV file, including identical
information like in the mail-body, machine-readable transmitted.
Technical specification for nexMart-specific CSV-formatSeite 17 von 30
29.05.2008
4. nexMart-specific CSV format
In order to guarantee you the absolute usage of all functions within nexMart we developed for this
purpose a CSV specific format.
CSV represent the classical sequential processing format type.
The data neither are structured nor grouped and one data record corresponds to one line.
The strength of this format is its wide spreading (e.g.: MS Office) because it is a supported format for
the exchange of database contents. Furthermore this format is – due to its line-orientated structure –
predestined for the usage of script languages as e.g. Perl.
The allocation of the processing level (header, item level) occur through a definite code (identifier) at
the beginning of the line.
Orders placed at several manufacturers are realized through a new header respectively alternative
supplier addresses are introduced by building blocks.
A reason for an error rate in the format is the separator itself: In order to avoid mistakes within the
interpretation of the data the separator has to be filtered carefully from the text fields.
In the view of the ERP system this exchange format is at the same time export- as well as import
format. Due to that a clear reflux of information to orders is granted.
ON position level some fields are just installed for the purpose of place holdes for status information.
Data possibly registered while processing an export will not be processed but actualized by the
supplier after ERP request.
The positions can be grouped optionally beneath the characteristic “supplier” according to
o order number
o differing delivery address
o responsible person
o name of purchaser
o way of dispatch (desired delivery date with delivery date)
In other words, an order must be defined for each seller in a separate block. Ordered positions can
be partitioned furthermore. For this further respectively different criteria will be set through a new
header.
The given information are valid for the following positions until the next header line.
Technical specification for nexMart-specific CSV-formatSeite 18 von 30
29.05.2008
Conventions:
General
agreement
Notation for floating fields (Float, up to 3 decimal places)
Decimal separator:“.“ (dot)
No further grouping patterns
Example: 1000.000 ( in words: „one thousand dot zero“ )
Convention to
CSV format
Separator
the character for the separator is “;“ ( Semicolon, ASCIIhex 0x3B)
No other separator is allowed
Convention
about
character
encodings
Character encoding
The character encodings US-ASCII, UTF-8, UTF-16 (Little Endian and Big Endian) and
Windows-1252 are supported. ISO-8859-1 is also supported when no control characters
(U+0080 to U+009F) are used.
Technical specification for nexMart-specific CSV-formatSeite 19 von 30
29.05.2008
5. Example for Export CSV (minimal)
Only mandatory fields & position numbers
Attention:
Within the strings (e.g. name etc.) „;“ (semicolons) are not allowed !
Example:
HDR;1.0;NOID;metabo;BDE123456;Jens.Stahl;
POS;;00001;AN-1234;12;PCE;
POS;;00002;AN-2004/A;1.500;LTR;
POS;;00003;AN-5308;5;PCE;
Attention:
Position numbers can be counted supplier comprehensive. The increment is arbitrarily.
This facilitates the allocation (referencing) while re-importing status information to single
positions.
Field
Nr.
Name Mandatory
field
Field
length
(Byte)
ERP
function
Format
H1 Identification „HDR“ Yes 3 I/E (CHAR)
H2 Version number „1.0“ Yes 3 I/E (CHAR)
H3 Message ID Yes 128 I/E (CHAR)
H4 Supplier name (supplier) Yes 35 I/E (CHAR)
H5 Dealer ID (nexMart customer nr.) Yes 9 I/E (CHAR)
H6 Purchasing name (NexMart Login) Yes 64 I/E (CHAR)
H7 Supplier customer number 12 I/E (CHAR)
H8 Customer name (Company name) 35 I/E (CHAR)
H9 Customer order number 35 I/E (CHAR)
H10 Order date* 8 I/E (DATE: yyyymmdd)
H11 Delivery address – Name 35 I/E (CHAR)
H12 Delivery address - Name 2 35 I/E (CHAR)
H13 Delivery address – Street 35 I/E (CHAR)
Technical specification for nexMart-specific CSV-formatSeite 20 von 30
29.05.2008
6. Specification: header data for nexMart specific CSV
format
6.1 Explanation of the header data
H1 Static – always „HDR“
H2 Static – „1.0“
H3 „MessageID“ contains a 128 byte huge explicit key generated from the system
(E.g. created by a database sequence) in order to filter duplicated orders. In case of no
examination of a duplication this field has to be marked as „NOID“.
Example: „BDE123456-20010215-131500-0001“
H4 „Supplier name“ is just the company name without further identification. The name is
written in small letters, special characters or blanks have to be replaced by “_“.
H14 Delivery address – zio code 5 I/E (CHAR)
H15 Delivery address – City 30 I/E (CHAR)
H16 Delivery address – Country
(nach ISO 3166)
2 I/E (CHAR)
H17 Kind of delivery 5 I/E (CHAR)
H18 Delivery date (In total)* 8 I/E (DATE: yyyymmdd )
H19 Delivery time (In total)* 8 I/E (DATE: hh:mm)
H20 Header text01 35 I/E (CHAR)
H21 Header text02 35 I/E (CHAR)
H22 K Header text03 35 I/E (CHAR)
H23 Commission field (value) 1024 I/E (CHAR)
H24 Name of responsible person 35 I/E (CHAR)
H25 Responsible person Tel01 23 I/E (CHAR)
H26 Responsible person Tel02 23 I/E (CHAR)
H27 Responsible person Fax 23 I/E (CHAR)
H28 E-Mail for error notification 35 I/E (CHAR)
H29 E-Mail for order confirmation 41 I/E (CHAR)
H30 ID for duplicates 35 I (Char)
H31 Order-ID from nexMart 35 I (Char)
Technical specification for nexMart-specific CSV-formatSeite 21 von 30
29.05.2008
In the appendix you will find the correct descriptions of supplier.
H5 The „Buyer-ID“is at the same time the BDE-number which you use when accessing
nexMart. For example: BDE123456
H6 As in field H5 you need the „name of the purchaser“ from the user-account for your access
on nexMart. For example: Jens.Stahl
H7-8 „Customer number“ and „Customer name“ just will be considered if for the person
named in field H6 „name of purchaser“ more than one account is registered on the
supplier.
In this case we will check if correlating user data are registered and admitted on nexMart.
If this should not be the case an error message will be produced.
In case of doubt please keep the fields unmarked.
H9 „Order-number„ is the number generated from the ERP system (= internal).
H10 Please pay attention to the format of date.
H11-16 „Delivery address - XXX“ possibility to give an one-time-delivery-address. If the fields stay
empty, the default-address at nexMart or the supplier is used. Please note that several
suppliers charge additional costs for unique delivery addresses. Without a countrycode in
these fields the country from the ordering-party (central) out of the portal will be used.
H17 „method of delivery“:
„EXPR“ ( Express) (also possible is “EXPRS”)
„NORML“ (Normal)
„DDELD“ (desired delivery date)
„PICKUP” (pick up)
“CONSI” (consignation)
“RELES” (release order)
The method of delivery „DDELD“ describes in connection with the content of fields H18 „
delivery date“ and H19 „delivery time “ the desired delivery date of the entire order per
supplier (that means that all articles must be available at this date. If you should not wish
a desired delivery date the standard way of dispatch „normal“ is chosen automatically.
Technical specification for nexMart-specific CSV-formatSeite 22 von 30
29.05.2008
H18-H19 „Delivery date“ / „Delivery time“ will be overwritten on position level through possible
information referring delivery date or time.
H23 Value of the field commission
In Orders the commission-number is always combined with file H26
H24-28 „Responsible person“ are supplier specific fields which are transferred directly to the
supplier’s ERP system. The information deposited in the fields H20-H23 „Header XX“ will
be transferred to the defined person in form of a notification. (Not all suppliers support
this optional function.)
H24 Responsible person’s name
H25 Responsible person’s phonenumber
H26 Qualifier for H23
In orders this field may be used as commission. If field H23 contains a
commissionnumber the value of H26 has to be “CommissionNumber”.
H27 Responsible persons fax-number
H28 Responsible persons e-Mail-address
Error reports, which has to be send to a other address then in H29, can be named here.
H29 Please indicate your Email-address here for order confirmation.
In case you left this field empty the order confirmation or an error message returns to
sender’s address.
H30 nexMart internal ID to recognize duplicates. Only used in order confirmations.
H31 nexMart order-ID given by nexMart. Only used in order confirmations.
Technical specification for nexMart-specific CSV-formatSeite 23 von 30
29.05.2008
7. Specification: position data for nexMart-specific
CSV format
Legend to 5. and 6.
* All date and time date in GMT (Greenwich Mean Time)
n whole-numbered value (0-9)
I Just Import into the ERP system (will be filled from nexMart)
I/E Can be used from the ERP system while import or export
Field
nr.
Description Mandat
ory field
Field
length
(Byte)
ERP function Format
P1 Identification code „POS“ Yes 3 I/E (CHAR)
P2 Status 3 I (CHAR)
P3 Order position number 5 I/E (CHAR)
P4 Article number Yes 20 I/E (CHAR)
P5 Quantity (nnnnnn.nnn) Yes 10 I/E (NUM: Float.3)
P6 Quantity unit (corr. UNECE)
UNECE)UNECE)Recommendation 20)
Yes 3 I/E (CHAR)
P7 Packaging unit
(nnnnnn.nnn)
10 I/E (NUM: Float.3 )
P8 Delivery date per pos. (day) * (day) 8 I/E (DATE: yyyymmdd )
P9 Delivery date per pos. (time)* (time) 5 I/E (DATE: hh:mm)
P10 Order number from supplier
( für OrderTracking )
35 I (CHAR)
P11 Article number from buyer
( Memo Händler )
20 I/E (CHAR)
P12 Commission number 15 I/E (CHAR)
P13 Price (nnnnnnnn.nnn) 12 I (NUM: Float.3 )
P14 Currency
(nach ISO 4217 )
3 I/E (CHAR)
P15 unit price ( PEn ) 3 I/E (CHAR)
P16 Total position price
(nnnnnnnn.nnn)
12 I/E (NUM: Float.3 )
P17 Discount 1 ( nn.nnn ) 6 I/E (NUM: Float.3 )
P18 Discount 2 ( nn.nnn ) 6 I/E (NUM: Float.3 )
P19 Discount 3 ( nn.nnn ) 6 I/E (NUM: Float.3 )
P20 Order number from buyer 35 I/E (CHAR)
P21 Position text01 35 I/E (CHAR)
P22 Position text02 35 I/E (CHAR)
P23 Position text03 35 I/E (CHAR)
P24 Filler (optional ) 27 - (CHAR: BLANK)
Technical specification for nexMart-specific CSV-formatSeite 24 von 30
29.05.2008
7.1. Explanations of position data
P1 Static – always “POS”
P2 „Status“ is a return value to the status of the position and can take the following
numerical values.
Flag Description of status
0 Article available
1 Article partly available
2 Article not available
3 Information not possible
4 No connection to the supplier
5 Unidentified item number
7 Error during the process of ordering
P3 „Order position number“ can be numbered continuously over all suppliers (it is useful for
reference purposes during the re-import of status information )
P4 An article can be explicitly referenced through the supplier „article number“ or through an
EAN code. Slight variations concerning article numbers can be recognized through an
identification mechanism and can be processed furthermore (e.g. the article number from
Rothenberger 36720 is recognized as 3.6720 ).
P5 „Quantity“ number of articles ordered
P6 „Quantity unit“ the enclosed appendix illustrate the nomenclature of the quantity units we
use.
P7 „Packaging unit “describes the size of packaging (e.g. the entry 100 corresponds to 100
pieces per unit)
P8/P9 „Delivery date per position“/ „Delivery time per position“ are dominant. Information not
corresponding to this correct format will be overwritten.
Technical specification for nexMart-specific CSV-formatSeite 25 von 30
29.05.2008
P10 „Order number from supplier „ is the order number from the supplier and is used from
nexMart first of all for the tracing of parcels. Furthermore this information is used for
documentation purposes concerning an order process by the ERP system or as reference
in case of questions.
P11 “Supplier article number“ contain the internal item number of the ERP system. This
facilitates the identification of articles while receiving the delivery.
P12 Your commission number.
P13 According to the ERP connection from the supplier to nexMart, nexMart transfers your
individual price conditions directly from the ERP system or the catalogue price registered
on the portal.
P14 The currency is normally EUR. A list of further currencies can be seen in the appendix.
P15 „price unit“ represents the price per quantity (price per size /quanity respectively decimal
exponent -> PE2: price per 100, PE3: price per 1000)
P17- P19 “Discounts” are indicated in percent, up to three decimal places.
P20 “Order number on position level
P21-23 In “position text” should be carried additional article text information’s.
Technical specification for nexMart-specific CSV-formatSeite 26 von 30
29.05.2008
8. Appendix
8.1 Examples of orders in csv format
(Multiple suppliers)
Order Rothenberger (6 positions to sales department; common way of dispatch)
HDR;1.0;NOID;rothenberger;BDE123456;Jens.Stahl;077777;Müllermaier;08004711;20010312;Mülle
rmaier Werkzeughandel;Verkauf;Stahlweg
23;77777;Eisenhüttenstadt;DE;NORML;;;Beispieltext;aus Bestellimport;"order data.csv";
Value of commission field;Herr
Stahl;0711/4712;0177/4713;0711/4799;[email protected];[email protected]
POS;;ID001;5.5699;1;PCE;
POS;;ID002;5.5203;3;PCE;2;
POS;;;5.3326;2;PCE;
POS;;;5.5033;2;PCE;
POS;;;5.3333;1;PCE;
POS;;;5.3350;3;PCE;
Order Rothenberger (2 positions with desired delivery date: 14.05.2002, 15 :00 to alternative delivery address: warehouse )
HDR;1.0;NOID;rothenberger;BDE123456;Jens.Stahl;077777;Müllermaier;08004711;20010312;Mülle
rmaier Werkzeughandel;Lager;Maschinenweg
12;77777;Eisenhüttenstadt;DE;DDELD;20020514;15:00;auch Beispieltext;zweiter
Teilauftrag;zur selben Datei; Value of commission field;Herr
Stahl;0711/4712;0177/4713;0711/4799;[email protected];[email protected]
POS;;;6.9000;1;PCE;
POS;;;6.9100;2;PCE;
Further orders (minimal versions)
HDR;1.0;NOID;elu_dewalt;BDE123456;Jens.Stahl;
POS;;;SB13EKS;1;PCE;
POS;;;DW004K2C;1;PCE;
POS;;;DW004K2C;1;PCE;
HDR;1.0;NOID;mafell;BDE123456;Jens.Stahl;
POS;;;913501;2;PCE;
POS;;;951101;1;PCE;
POS;;;950601;1;PCE;
Technical specification for nexMart-specific CSV-formatSeite 27 von 30
29.05.2008
8.2 Nomenclature
8.2.1. Units
Quantity unit *
Unit Abbreviation
piece PCE
set SET
number of packs NMP
100 packs CNP
100 pages CLF
Length* meter MTR
decimeter DMT
centimeter CMT
millimeter MMT
Area* m² MTK
dm² DMK
cm² CMK
mm² MMK
Metric volume* m³ MTQ
dm³ DMQ
cm³ CMQ
mm³ MMQ
Mass* tonne TNE
double centner (100 kg) DTN
kilogram KGM
centigram CGM
gram GRM
milligram MGM
Mass volume* liter LTR
centiliter CLT
deciliter DLT
milliliter MLT
* Reference: UNECE recommendation 20 3A
Technical specification for nexMart-specific CSV-formatSeite 28 von 30
29.05.2008
8.2.2. further codes
Countries *
Unit Abbreviation
Germany DE
Austria AT
Switzerland CH
...
Currencies ** Euro EUR
Austria: EUR
Switzerland: Franc CHF
... ...
* reference: ISO 3316-1
** reference: ISO 4217
8.2.3. Supplier’s identification
In order to get an actual list of our suppliers, please take a look at www.nexmart.net in tab “Contact & Downloads”:
http://www.nexmart.net/en/kontakt-downloads/downloads/warenwirtschaft.html
8.2.4. Glossary
ERP-System
ERP stands for “Enterprise Resource Planner". ERP systems are the huge „elephant programs“
beneath business applications. They spreaded increasingly from the core field of the production
planning to all other business fields.
SAP for example offers the support for the following business fields: resource planning, production
planning, financial accountancy, human resources up to sales & distribution and others.
“Inventory-management System” (Dealer ERP system)
This are programs for the documentation of the stock. With this program data of the order are stored
from receipt of articles until article issue.
Technical specification for nexMart-specific CSV-formatSeite 29 von 30
29.05.2008
We cooperate with various system partners. You will find the current list of our partners under:
www.nexmart.net
Technical specification for nexMart-specific CSV-formatSeite 30 von 30
29.05.2008
8.3. Your contact person
If you should have further questions, suggestions or problems referring the installation of the
interface or while testing the process of ordering please do not hesitate to contact us.
Your contact persons from nexMart are:
Fotini Menteli
Specialised Trade Consultant
+49 (0)711 / 99783 - 331
David Neuscheler
Pre- and aftersales
+49 (0)711 / 99783 – 393