Technical Documentation In order to link your ERP System ...€¦ · Technical Documentation In...

30
Technical Documentation In order to link your ERP System to nexMart System processes, description of interface and nomenclature

Transcript of Technical Documentation In order to link your ERP System ...€¦ · Technical Documentation In...

Page 1: Technical Documentation In order to link your ERP System ...€¦ · Technical Documentation In order to link your ERP ... In the best case all further ... If data are not available

Technical Documentation

In order to link your ERP System to nexMart

System processes, description of interface and nomenclature

Page 2: Technical Documentation In order to link your ERP System ...€¦ · Technical Documentation In order to link your ERP ... In the best case all further ... If data are not available

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

Page 3: Technical Documentation In order to link your ERP System ...€¦ · Technical Documentation In order to link your ERP ... In the best case all further ... If data are not available

Technical specification for nexMart-specific CSV-formatSeite 3 von 30

29.05.2008

Page 4: Technical Documentation In order to link your ERP System ...€¦ · Technical Documentation In order to link your ERP ... In the best case all further ... If data are not available

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

Page 5: Technical Documentation In order to link your ERP System ...€¦ · Technical Documentation In order to link your ERP ... In the best case all further ... If data are not available

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

Page 6: Technical Documentation In order to link your ERP System ...€¦ · Technical Documentation In order to link your ERP ... In the best case all further ... If data are not available

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.

Page 7: Technical Documentation In order to link your ERP System ...€¦ · Technical Documentation In order to link your ERP ... In the best case all further ... If data are not available

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

Page 8: Technical Documentation In order to link your ERP System ...€¦ · Technical Documentation In order to link your ERP ... In the best case all further ... If data are not available

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.

Page 9: Technical Documentation In order to link your ERP System ...€¦ · Technical Documentation In order to link your ERP ... In the best case all further ... If data are not available

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

Page 10: Technical Documentation In order to link your ERP System ...€¦ · Technical Documentation In order to link your ERP ... In the best case all further ... If data are not available

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:

- Email

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

Page 11: Technical Documentation In order to link your ERP System ...€¦ · Technical Documentation In order to link your ERP ... In the best case all further ... If data are not available

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)

Page 12: Technical Documentation In order to link your ERP System ...€¦ · Technical Documentation In order to link your ERP ... In the best case all further ... If data are not available

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.

Page 13: Technical Documentation In order to link your ERP System ...€¦ · Technical Documentation In order to link your ERP ... In the best case all further ... If data are not available

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

Page 14: Technical Documentation In order to link your ERP System ...€¦ · Technical Documentation In order to link your ERP ... In the best case all further ... If data are not available

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.

Page 15: Technical Documentation In order to link your ERP System ...€¦ · Technical Documentation In order to link your ERP ... In the best case all further ... If data are not available

Technical specification for nexMart-specific CSV-formatSeite 15 von 30

29.05.2008

Page 16: Technical Documentation In order to link your ERP System ...€¦ · Technical Documentation In order to link your ERP ... In the best case all further ... If data are not available

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.

Page 17: Technical Documentation In order to link your ERP System ...€¦ · Technical Documentation In order to link your ERP ... In the best case all further ... If data are not available

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.

Page 18: Technical Documentation In order to link your ERP System ...€¦ · Technical Documentation In order to link your ERP ... In the best case all further ... If data are not available

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.

Page 19: Technical Documentation In order to link your ERP System ...€¦ · Technical Documentation In order to link your ERP ... In the best case all further ... If data are not available

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)

Page 20: Technical Documentation In order to link your ERP System ...€¦ · Technical Documentation In order to link your ERP ... In the best case all further ... If data are not available

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)

Page 21: Technical Documentation In order to link your ERP System ...€¦ · Technical Documentation In order to link your ERP ... In the best case all further ... If data are not available

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.

Page 22: Technical Documentation In order to link your ERP System ...€¦ · Technical Documentation In order to link your ERP ... In the best case all further ... If data are not available

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.

Page 23: Technical Documentation In order to link your ERP System ...€¦ · Technical Documentation In order to link your ERP ... In the best case all further ... If data are not available

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)

Page 24: Technical Documentation In order to link your ERP System ...€¦ · Technical Documentation In order to link your ERP ... In the best case all further ... If data are not available

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.

Page 25: Technical Documentation In order to link your ERP System ...€¦ · Technical Documentation In order to link your ERP ... In the best case all further ... If data are not available

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.

Page 26: Technical Documentation In order to link your ERP System ...€¦ · Technical Documentation In order to link your ERP ... In the best case all further ... If data are not available

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;

Page 27: Technical Documentation In order to link your ERP System ...€¦ · Technical Documentation In order to link your ERP ... In the best case all further ... If data are not available

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

Page 28: Technical Documentation In order to link your ERP System ...€¦ · Technical Documentation In order to link your ERP ... In the best case all further ... If data are not available

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.

Page 29: Technical Documentation In order to link your ERP System ...€¦ · Technical Documentation In order to link your ERP ... In the best case all further ... If data are not available

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

Page 30: Technical Documentation In order to link your ERP System ...€¦ · Technical Documentation In order to link your ERP ... In the best case all further ... If data are not available

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

[email protected]

David Neuscheler

Pre- and aftersales

+49 (0)711 / 99783 – 393

[email protected]