the good guys purchase order implementation guide
TRANSCRIPT
Message Implementation
Guideline (MIG)
The Good Guys
Purchase Order
Implementation Guide
Audience: The Good Guys Suppliers
Version: 1.5
Status: Final
Issue Date: 12-Oct-2011
Written by: Sudhir Rajai
Solution Architect
eVision Pty Ltd
© eVision Pty Ltd 2012- Commercial In Confidence 2
The Good Guys – Purchase Order Implementation Guide
CONTENTS
DOCUMENT PROPERTIES .................................................................................................................... 3
Copyright ....................................................................................................................................... 3
Change History .............................................................................................................................. 3
PURCHASE ORDER BUSINESS RULES .................................................................................................... 4
SEGMENT HIERARCHY ......................................................................................................................... 5
Header Section .............................................................................................................................. 5
Detail Section................................................................................................................................. 5
Summary Section ........................................................................................................................... 5
SEGMENT DEFINITIONS ....................................................................................................................... 6
EXAMPLES ........................................................................................................................................ 27
Clarification ................................................................................................................................. 27
Samples ....................................................................................................................................... 28
TRANSMISSION ................................................................................................................................. 31
CONTACT DETAILS ............................................................................................................................ 32
eVision - MessageXchange ........................................................................................................... 32
The Good Guys ............................................................................................................................ 32
© eVision Pty Ltd 2012- Commercial In Confidence 3
The Good Guys – Purchase Order Implementation Guide
DOCUMENT PROPERTIES
Copyright
This document is the property of:
Evision Pty Ltd. Level 3, 488 Bourke Street, Melbourne Vic 3000 www.eVision.com.au
This Message Implementation Guide has been created for The Good Guys.
Unauthorized access, copying, replication and usage for a purpose other than for which this is intended is
prohibited by Copyright Laws.
The holder is responsible for incorporating revisions into his copy of the document and keeping the
contents up-to-date.
Change History
Version Date Updated by Nature of Amendment
1.5 12-Oct-2011 Sudhir Rajai Separated Message Envelope, Purchase Order and Purchase Order Response MIGs
© eVision Pty Ltd 2012- Commercial In Confidence 4
The Good Guys – Purchase Order Implementation Guide
PURCHASE ORDER BUSINESS RULES
The Good Guys will be sending the Purchase orders to their suppliers.
Upon receipt of these orders, suppliers are required to send back a CONTRL message.
Suppliers are required to send Purchase order responses regardless of whether there are any issues
with the order or not. Issues will often include:
Item quantity ordered
Item price
Delivery date
© eVision Pty Ltd 2012- Commercial In Confidence 5
The Good Guys – Purchase Order Implementation Guide
SEGMENT HIERARCHY
Header Section
Position Group / Segment Usage Max. Use
0010 UNH - Message header M 1
0020 BGM - Beginning of message M 1
0030 DTM - Date/time/period M 35
0070 FTX - Free text C 99
0080 Segment Group 1 C 10
0090 RFF - Reference M 1
0110 Segment Group 2 C 99
0120 NAD - Name and address M 1
0210 Segment Group 5 C 5
0220 CTA - Contact information M 1
0230 COM - Communication contact C 5
0280 Segment Group 7 C 5
0290 CUX - Currencies M 1
0320 Segment Group 8 C 10
0330 PAT - Payment terms basis M 1
Detail Section
Position Group / Segment Usage Max. Use
0930 Segment group 25 C 200000
0940 LIN - Line item M 1
0950 PIA - Additional product id C 25
0980 QTY - Quantity C 10
1180 Segment Group 28 C 25
1190 PRI - Price details M 1
1240 Segment Group 29 C 10
1250 RFF - Reference M 1
1400 Segment Group 33 C 9999
1410 LOC - Place/location identification M 1
1420 QTY - Quantity C 1
1430 DTM - Date/time/period C 5
Summary Section
Position Group / Segment Usage Max. Use
2090 UNS - Section control M 1
2100 MOA - Monetary amount C 12
2110 CNT - Control total C 10
2160 UNT - Message trailer M 1
© eVision Pty Ltd 2012- Commercial In Confidence 6
The Good Guys – Purchase Order Implementation Guide
SEGMENT DEFINITIONS
Segment: BGM - Beginning of message
Purpose: To start, identify and specify an interchange.
Example: BGM+220+20023530+9'
Position Segment Usage Representation
010 C002 DOCUMENT/MESSAGE NAME C
1001
Document/message name, coded 220 - Order
C an..3
020 1004 Document/message number C an..35
030 1225 Message function, coded 9 – Original 7 - Duplicate
C an..3
© eVision Pty Ltd 2012- Commercial In Confidence 7
The Good Guys – Purchase Order Implementation Guide
Segment: DTM - Date/time/period
Purpose: To specify date, and/or time, or period.
Example: DTM+137:20111012:102' DTM+2:20111019:102'
Position Segment Usage Representation
010 C507 DATE/TIME/PERIOD M
2005
Date/time/period qualifier
137 - Order date
2 – Requested delivery date
M an..3
2380 Date/time/period C an..35
2379
Date/time/period format qualifier
102 - CCYYMMDD C an..3
© eVision Pty Ltd 2012- Commercial In Confidence 8
The Good Guys – Purchase Order Implementation Guide
Segment: FTX - Free text
Purpose: To provide free form or coded text information.
Example: FTX+PUR+++QUOTE CT7809560 DIRECT DEL FRIDAY 07/10/11 TEL 53363788 NO INVOICE WI:TH GOODS'
Position Segment Usage Representation
010 4451 Text subject qualifier
PUR - Purchasing information M an..3
020 4453 Text function, coded C an..3
030 C107 TEXT REFERENCE C
4441 Free text, coded M an..3
040 C108 TEXT LITERAL C
4440 Free text M an..70
4440 Free text C an..70
4440 Free text C an..70
4440 Free text C an..70
4440 Free text C an..70
© eVision Pty Ltd 2012- Commercial In Confidence 9
The Good Guys – Purchase Order Implementation Guide
Segment: RFF - Reference
Purpose: To specify a reference. Contains The Good Guys Group Number. Used to identify collated orders.
Example: RFF+BO:ALO2465'
Position Segment Usage Representation
010 C506 REFERENCE M
1153
Reference qualifier
BO - Blanket order number M an..3
1154 Reference number C an..35
© eVision Pty Ltd 2012- Commercial In Confidence 10
The Good Guys – Purchase Order Implementation Guide
Segment: NAD - Name and address
Purpose: To specify the name/address and their related function.
Example:
NAD+BY+9377779129296::9' NAD+SU+9377778616193::9' NAD+ST+9330833000139::9' NAD+UD+++KITSET KITCHENS+KITSET KITCHENS 822 LA TROBE STRE:LABEL BOX BAPP2798+BALLARAT+VIC+3350+AU'
Position Segment Usage Representation
010 3035
Party qualifier
BY – Buyer
SU – Supplier
ST - Ship to
UD - Ultimate customer
M an..3
020 C082 PARTY IDENTIFICATION DETAILS C
3039 Party id. identification M an..35
1131 Code list qualifier C an..3
3055
Code list responsible agency, coded
9 - EAN (International Article Numbering association) C an..3
030 C058 NAME AND ADDRESS C
040 C080 PARTY NAME C
3036 Party name M an..35
3036 Party name C an..35
3036 Party name C an..35
3036 Party name C an..35
3036 Party name C an..35
050 C059 STREET C
3042 Street and number/p.o. box M an..35
© eVision Pty Ltd 2012- Commercial In Confidence 11
The Good Guys – Purchase Order Implementation Guide
3042 Street and number/p.o. box C an..35
3042 Street and number/p.o. box C an..35
060 3164 City name C an..35
070 3229 Country sub-entity identification C an..9
080 3251 Postcode identification C an..9
090 3207 Country, coded C an..3
Notes:
1. In case of direct to customer delivery, segment NAD+UD will be sent in addition to NAD+BY, NAD+ST and
NAD+SU.
© eVision Pty Ltd 2012- Commercial In Confidence 12
The Good Guys – Purchase Order Implementation Guide
Segment: CTA - Contact information
Purpose: To identify a person or a department to whom communication should be directed.
Example: CTA+GR+:KITSET KITCHENS'
Position Segment Usage Representation
010 3139 Contact function, coded
GR - Goods receiving contact C an..3
020 C056 DEPARTMENT OR EMPLOYEE DETAILS C
3413 Department or employee identification C an..17
3412 Department or employee C an..35
© eVision Pty Ltd 2012- Commercial In Confidence 13
The Good Guys – Purchase Order Implementation Guide
Segment: COM - Communication contact
Purpose: To identify a communication number of a department or a person to whom communication should be directed.
Example: COM+53363788:TE'
Position Segment Usage Representation
010 C076 COMMUNICATION CONTACT M
3148 Communication number M an..512
3155
Communication channel qualifier
TE - Telephone number
FX - Fax number
M an..3
© eVision Pty Ltd 2012- Commercial In Confidence 14
The Good Guys – Purchase Order Implementation Guide
Segment: CUX - Currencies
Purpose: To specify currencies used in the transaction and relevant details for the rate of exchange.
Example: CUX+2:AUD:9'
Position Segment Usage Representation
010 C504 CURRENCY DETAILS C
6347
Currency details qualifier
2 - Reference currency M an..3
6345 Currency, coded C an..3
6343
Currency qualifier
9 - Order currency C an..3
© eVision Pty Ltd 2012- Commercial In Confidence 15
The Good Guys – Purchase Order Implementation Guide
Segment: PAT - Payment terms basis
Purpose: To specify the payment terms basis.
Example: PAT+7+6:::0' PAT+7+6:::STANDARD TERMS'
Position Segment Usage Representation
010 4279 Payment terms type qualifier
7 - Extended M an..3
020 C110 PAYMENT TERMS C
4277
Terms of payment identification
6 - No drafts M an..17
1131 Code list qualifier C an..3
3055 Code list responsible agency, coded C an..3
4276 Terms of payment C an..35
4276 Terms of payment C an..35
© eVision Pty Ltd 2012- Commercial In Confidence 16
The Good Guys – Purchase Order Implementation Guide
Segment: LIN - Line item
Purpose: To identify a line item and configuration.
Example: LIN+1++9316561030150:EN'
Position Segment Usage Representation
010 1082 Line item number C n..6
020 1229 Action request/notification, coded C an..3
030 C212 ITEM NUMBER IDENTIFICATION C
7140 Item number C an..35
7143
Item number type, coded
EN - International Article Numbering Association (EAN) C an..3
© eVision Pty Ltd 2012- Commercial In Confidence 17
The Good Guys – Purchase Order Implementation Guide
Segment: PIA - Additional product id
Purpose: To specify additional item identification codes.
Example: PIA+1+WRF900CS:IN'
Position Segment Usage Representation
010 4347 Product id. function qualifier
1 - Additional identification M an..3
020 C212 ITEM NUMBER IDENTIFICATION M
7140 Item number C an..35
7143
Item number type, coded
IN - Buyer's item number C an..3
© eVision Pty Ltd 2012- Commercial In Confidence 18
The Good Guys – Purchase Order Implementation Guide
Segment: QTY - Quantity
Purpose: To specify a pertinent quantity.
Example: QTY+21:1:EA'
Position Segment Usage Representation
010 C186 QUANTITY DETAILS M
6063
Quantity qualifier
21 - Ordered quantity M an..3
6060 Quantity M n..15
6411 Measure unit qualifier C an..3
© eVision Pty Ltd 2012- Commercial In Confidence 19
The Good Guys – Purchase Order Implementation Guide
Segment: PRI - Price details
Purpose: To specify price information.
Example: PRI+AAA:420.00::INV'
Position Segment Usage Representation
010 C509 PRICE INFORMATION C
5125
Price qualifier
AAA - Wholesale Price Excluding GST M an..3
5118 Price C n..15
5375 Price type, coded C an..3
5387
Price type qualifier
INV - Invoice price C an..3
© eVision Pty Ltd 2012- Commercial In Confidence 20
The Good Guys – Purchase Order Implementation Guide
Segment: RFF - Reference
Purpose: To specify a reference. Contains The Good Guys department information. Used for Promotional Over-ride Code.
Example: RFF+PD:CT7809560'
Position Segment Usage Representation
010 C506 REFERENCE M
1153
Reference qualifier
PD - Promotion deal number M an..3
1154 Reference number C an..35
© eVision Pty Ltd 2012- Commercial In Confidence 21
The Good Guys – Purchase Order Implementation Guide
Segment: LOC - Place/location identification
Purpose: To identify a place of delivery.
Example: LOC+7+9330833000139::9'
Position Segment Usage Representation
010 3227 Place/location qualifier
7 - Place of delivery M an..3
020 C517 LOCATION IDENTIFICATION C
3225 Place/location identification C an..25
1131 Code list qualifier C an..3
3055
Code list responsible agency, coded
9 - EAN (International Article Numbering association) C an..3
© eVision Pty Ltd 2012- Commercial In Confidence 22
The Good Guys – Purchase Order Implementation Guide
Segment: QTY - Quantity
Purpose: To specify a pertinent quantity.
Example: QTY+11:1:EA'
Position Segment Usage Representation
010 C186 QUANTITY DETAILS M
6063
Quantity qualifier
11 - Split quantity M an..3
6060 Quantity M n..15
6411 Measure unit qualifier C an..3
© eVision Pty Ltd 2012- Commercial In Confidence 23
The Good Guys – Purchase Order Implementation Guide
Segment: DTM - Date/time/period
Purpose: To specify date, and/or time, or period.
Example: DTM+2:20111007:102'
Position Segment Usage Representation
010 C507 DATE/TIME/PERIOD M
2005
Date/time/period qualifier
2 - Requested delivery date/time M an..3
2380 Date/time/period C an..35
2379
Date/time/period format qualifier
102 - CCYYMMDD C an..3
© eVision Pty Ltd 2012- Commercial In Confidence 24
The Good Guys – Purchase Order Implementation Guide
Segment: UNS - Section control
Purpose: To separate header, detail and summary sections of a message.
Example: UNS+S'
Position Segment Usage Representation
010 0081 Section identification
S - Detail/summary section separation M a1
© eVision Pty Ltd 2012- Commercial In Confidence 25
The Good Guys – Purchase Order Implementation Guide
Segment: MOA - Monetary amount
Purpose: To specify a monetary amount.
Example: MOA+86:420.01'
Position Segment Usage Representation
010 C516 MONETARY AMOUNT M
5025
Monetary amount type qualifier
86 - Message total monetary amount M an..3
5004 Monetary amount C n..18
© eVision Pty Ltd 2012- Commercial In Confidence 26
The Good Guys – Purchase Order Implementation Guide
Segment: CNT - Control total
Purpose: To provide control total.
Example: CNT+2:2'
Position Segment Usage Representation
010 C270 CONTROL M
6069
Control qualifier
2 - Number of line items in message M an..3
6066 Control value M n..18
© eVision Pty Ltd 2012- Commercial In Confidence 27
The Good Guys – Purchase Order Implementation Guide
EXAMPLES
Clarification
The Good Guys use GLN (Global Location Number) issued by GS1 as the party and location identifier
in NAD and LOC segments.
In case of direct to customer delivery, NAD+UD will be sent in addition to NAD+BY, NAD+SU and
NAD+ST. The real physical delivery should be sent to NAD+UD.
The currency code in CUX can have either AUD or NZD as currency.
Currently The Good Guys’ orders are issued for a particular store or ultimate customer only. Hence,
LOC-QTY at line level can be omitted at supplier end.
Price amounts at all levels are excluding GST.
EA and MTR are used as unit of measurements.
© eVision Pty Ltd 2012- Commercial In Confidence 28
The Good Guys – Purchase Order Implementation Guide
Samples
STORE DELIVERY
UNA:+.? '
UNB+UNOA:3+9377779129296:ZZ+9377778058474:ZZ+111012:0451+25695976'
UNH+0023530+ORDERS:D:96A:UN:EAN008'
BGM+220+20023530+9'
DTM+137:20111012:102'
DTM+2:20111019:102'
RFF+BO:TGGSCAC'
NAD+BY+9377779129296::9'
NAD+SU+9377778058474::9'
NAD+ST+9330833000054::92'
CUX+2:AUD:9'
PAT+7+6:::STANDARD TERMS'
LIN+1++9324008009928:EN'
PIA+1+EC1018:IN'
QTY+21:2:EA'
PRI+AAA:59.00::INV'
LOC+7+9330833000054::9'
QTY+11:2:EA'
DTM+2:20111019:102'
UNS+S'
MOA+86:118.00'
CNT+2:1'
UNT+21+0023530'
UNZ+1+25695976'
© eVision Pty Ltd 2012- Commercial In Confidence 29
The Good Guys – Purchase Order Implementation Guide
DIRECT TO CUSTOMER DELIVERY
UNA:+.? '
UNB+UNOA:3+9377779129296:ZZ+9377778616193:ZZZ+111006:0000+25438770'
UNH+0019354+ORDERS:D:96A:UN:EAN008'
BGM+220+20019354+9'
DTM+137:20111006:102'
DTM+2:20111007:102'
FTX+PUR+++QUOTE CT7809560 DIRECT DEL FRIDAY 07/10/11 TEL 53363788 NO INVOICE WI:TH GOODS'
RFF+BO:DIR KITSET'
NAD+BY+9377779129296::9'
NAD+SU+9377778616193::9'
NAD+ST+9330833000139::92'
NAD+UD+++KITSET KITCHENS+KITSET KITCHENS 822 LA TROBE STRE:LABEL BOX BAPP2798+BALLARAT+VIC+3350+AU'
CTA+GR+:KITSET KITCHENS'
COM+53363788:TE'
CUX+2:AUD:9'
PAT+7+6:::STANDARD TERMS'
LIN+1++9316561030150:EN'
PIA+1+WRF900CS:IN'
QTY+21:1:EA'
© eVision Pty Ltd 2012- Commercial In Confidence 30
The Good Guys – Purchase Order Implementation Guide
PRI+AAA:420.00::INV'
RFF+PD:CT7809560'
LOC+7+9330833000139::9'
QTY+11:1:EA'
DTM+2:20111007:102'
LIN+2++:EN'
PIA+1+ACS:IN'
QTY+21:1:EA'
PRI+AAA:.01::INV'
RFF+PD:CT7809560'
LOC+7+9330833000139::9'
QTY+11:1:EA'
DTM+2:20111007:102'
UNS+S'
MOA+86:420.01'
CNT+2:2'
UNT+34+0019354'
UNZ+1+25438770'
© eVision Pty Ltd 2012- Commercial In Confidence 31
The Good Guys – Purchase Order Implementation Guide
TRANSMISSION The transmission type defines the protocol or method used to receive or send the message. The
messagexchange.com provides number of types of transmission. Please arrange your preferred type of
transmission with the MessageXchange Support & Activation team.
© eVision Pty Ltd 2012- Commercial In Confidence 32
The Good Guys – Purchase Order Implementation Guide
CONTACT DETAILS
eVision - MessageXchange
3/488 Bourke Street
Melbourne, VIC
Australia, 3000
P: +613 8622 0200
Technical support
P: 1300769414
The Good Guys
Toni Green B2B Project Leader The Good Guys Phone: +61 3 9330 6540 E-mail: [email protected]