Amazon
/
Direct Fulfillment Purchase Order
  • Specification
  • EDI Inspector
Stedi maintains this guide based on public documentation from Amazon. Contact Amazon for official EDI specifications. To report any errors in this guide, please contact us.
Go to Stedi Network
Amazon logo

X12 850 Direct Fulfillment Purchase Order

X12 Release 4010

This Draft Standard for Trial Use contains the format and establishes the data contents of the Purchase Order Transaction Set (850) for use within the context of an Electronic Data Interchange (EDI) environment. The transaction set can be used to provide for customary and established business and industry practice relative to the placement of purchase orders for goods and services. This transaction set should not be used to convey purchase order changes or purchase order acknowledgment information.

Delimiters
  • ~ Segment
  • * Element
  • > Component
EDI samples
  • B2B Order
View the latest version of this implementation guide as an interactive webpage
https://www.stedi.com/app/guides/view/amazon/direct-fulfillment-purchase-order/01GWA7NFME9CGDRE07EB0N4SKR
Powered by
Build EDI implementation guides at stedi.com
Overview
ISA
-
Interchange Control Header
Max use 1
Required
GS
-
Functional Group Header
Max use 1
Required
heading
ST
010
Transaction Set Header
Max use 1
Required
BEG
020
Beginning Segment for Purchase Order
Max use 1
Required
CUR
040
Currency
Max use 1
Required
REF
050
Order Number
Max use 1
Optional
REF
050
Store Number
Max use 1
Optional
DTM
150
Delivery Requested
Max use 1
Optional
DTM
150
Requested Ship
Max use 1
Optional
N9 Loop
detail
PO1 Loop
PO1
010
Baseline Item Data
Max use 1
Required
CTP Loop
MSG
289
Title or Description of goods
Max use 1
Optional
MSG
290
Gift Message
Max use 1
Optional
GE
-
Functional Group Trailer
Max use 1
Required
IEA
-
Interchange Control Trailer
Max use 1
Required
ISA

Interchange Control Header

RequiredMax use 1

To start and identify an interchange of zero or more functional groups and interchange-related control segments

Example
ISA-01
I01
Authorization Information Qualifier
Required
Identifier (ID)

Code to identify the type of information in the Authorization Information

00
No Authorization Information Present (No Meaningful Information in I02)
ISA-02
I02
Authorization Information
Required
String (AN)
Min 10Max 10

Information used for additional identification or authorization of the interchange sender or the data in the interchange; the type of information is set by the Authorization Information Qualifier (I01)

ISA-03
I03
Security Information Qualifier
Required
Identifier (ID)

Code to identify the type of information in the Security Information

00
No Security Information Present (No Meaningful Information in I04)
ISA-04
I04
Security Information
Required
String (AN)
Min 10Max 10

This is used for identifying the security information about the interchange sender or the data in the interchange; the type of information is set by the Security Information Qualifier (I03)

ISA-05
I05
Interchange ID Qualifier
Required
Identifier (ID)
Min 2Max 2

Qualifier to designate the system/method of code structure used to designate the sender or receiver ID element being qualified

Codes
ISA-06
I06
Interchange Sender ID
Required
String (AN)
Min 15Max 15

Identification code published by the sender for other parties to use as the receiver ID to route data to them; the sender always codes this value in the sender ID element

ISA-07
I05
Interchange ID Qualifier
Required
Identifier (ID)
Min 2Max 2

Qualifier to designate the system/method of code structure used to designate the sender or receiver ID element being qualified

Codes
ISA-08
I07
Interchange Receiver ID
Required
String (AN)
Min 15Max 15

Identification code published by the receiver of the data; When sending, it is used by the sender as their sending ID, thus other parties sending to them will use this as a receiving ID to route data to them

ISA-09
I08
Interchange Date
Required
Date (DT)
YYMMDD format

Date of the interchange

ISA-10
I09
Interchange Time
Required
Time (TM)
HHMM format

Time of the interchange

ISA-11
I10
Interchange Control Standards Identifier
Required
Identifier (ID)

Code to identify the agency responsible for the control standard used by the message that is enclosed by the interchange header and trailer

U
U.S. EDI Community of ASC X12, TDCC, and UCS
ISA-12
I11
Interchange Control Version Number
Required
Identifier (ID)

This version number covers the interchange control segments

00401
Draft Standards for Trial Use Approved for Publication by ASC X12 Procedures Review Board through October 1997
ISA-13
I12
Interchange Control Number
Required
Numeric (N0)
Min 9Max 9

A control number assigned by the interchange sender

ISA-14
I13
Acknowledgment Requested
Required
Identifier (ID)
Min 1Max 1

Code sent by the sender to request an interchange acknowledgment (TA1)

0
No Acknowledgment Requested
1
Interchange Acknowledgment Requested
ISA-15
I14
Usage Indicator
Required
Identifier (ID)
Min 1Max 1

Code to indicate whether data enclosed by this interchange envelope is test, production or information

I
Information
P
Production Data
T
Test Data
ISA-16
I15
Component Element Separator
Required
String (AN)
Min 1Max 1

Type is not applicable; the component element separator is a delimiter and not a data element; this field provides the delimiter used to separate component data elements within a composite data structure; this value must be different than the data element separator and the segment terminator

>
Component Element Separator

Functional Group Header

RequiredMax use 1

To indicate the beginning of a functional group and to provide control information

Example
GS-01
479
Functional Identifier Code
Required
Identifier (ID)

Code identifying a group of application related transaction sets

PO
Purchase Order (850)
GS-02
142
Application Sender's Code
Required
String (AN)
Min 2Max 15

Code identifying party sending transmission; codes agreed to by trading partners

GS-03
124
Application Receiver's Code
Required
String (AN)
Min 2Max 15

Code identifying party receiving transmission. Codes agreed to by trading partners

Required
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

Required
Time (TM)
HHMM, HHMMSS, HHMMSSD, or HHMMSSDD format

Time expressed in 24-hour clock time as follows: HHMM, or HHMMSS, or HHMMSSD, or HHMMSSDD, where H = hours (00-23), M = minutes (00-59), S = integer seconds (00-59) and DD = decimal seconds; decimal seconds are expressed as follows: D = tenths (0-9) and DD = hundredths (00-99)

GS-06
28
Group Control Number
Required
Numeric (N0)
Min 1Max 9

Assigned number originated and maintained by the sender

GS-07
455
Responsible Agency Code
Required
Identifier (ID)
Min 1Max 2

Code used in conjunction with Data Element 480 to identify the issuer of the standard

T
Transportation Data Coordinating Committee (TDCC)
X
Accredited Standards Committee X12
GS-08
480
Version / Release / Industry Identifier Code
Required
String (AN)

Code indicating the version, release, subrelease, and industry identifier of the EDI standard being used, including the GS and GE segments; if code in DE455 in GS segment is X, then in DE 480 positions 1-3 are the version number; positions 4-6 are the release and subrelease, level of the version; and positions 7-12 are the industry or trade association identifiers (optionally assigned by user); if code in DE455 in GS segment is T, then other formats are allowed

004010
Draft Standards Approved for Publication by ASC X12 Procedures Review Board through October 1997

Heading

ST
010
Heading > ST

Transaction Set Header

RequiredMax use 1

To indicate the start of a transaction set and to assign a control number

Example
ST-01
143
Transaction Set Identifier Code
Required
Identifier (ID)

Code uniquely identifying a Transaction Set

  • The transaction set identifier (ST01) used by the translation routines of the interchange partners to select the appropriate transaction set definition (e.g., 810 selects the Invoice Transaction Set).
850
Purchase Order
ST-02
329
Transaction Set Control Number
Required
Numeric (N)
Min 4Max 9

Identifying control number that must be unique within the transaction set functional group assigned by the originator for a transaction set

BEG
020
Heading > BEG

Beginning Segment for Purchase Order

RequiredMax use 1

To indicate the beginning of the Purchase Order Transaction Set and transmit identifying numbers and dates

Usage notes

BEG^00^DS^TesT0008596^^20070808~

Example
BEG-01
353
Transaction Set Purpose Code
Required
Identifier (ID)

Code identifying purpose of transaction set

00
Original
BEG-02
92
Purchase Order Type Code
Required
Identifier (ID)

Code specifying the type of Purchase Order

DS
Dropship

Always "DS" for regular non-gift orders. Amazon-branded packing slip will include prices.

SS
Supply or Service Order

Always "SS" for B2B Orders. This will be the indicator that the Amazon-branded packing slip should include prices.

ZZ
Mutually Defined

Always "ZZ" for gift orders. This will be the indicator that the Amazon-branded packing slip should not include prices.

BEG-03
324
Purchase Order Number
Required
String (AN)
Min 1Max 22

Identifying number for Purchase Order assigned by the orderer/purchaser

Usage notes

This will be the Amazon encrypted Shipment ID, which is case sensitive. This number is unique - if a duplicate Shipment ID is ever received it should be rejected via the OFR (855).

Format: AlphaNumeric

Example: DjntsVrFN (Dj2sV3fN is a different Shipment ID than Dj2Sv3FN).

This number should appear on the Amazon-branded packing slip and must be returned to Amazon in the OFR (855), ASN (856), and INV (810) messages.

Required
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

  • BEG05 is the date assigned by the purchaser to purchase order.
Usage notes

This is the Order Date (CCYYMMDD) expressed in UTC format. This should appear on the packing slip.

CUR
040
Heading > CUR

Currency

RequiredMax use 1

To specify the currency (dollars, pounds, francs, etc.) used in a transaction

Usage notes

CUR^BT^USD~

Example
CUR-01
98
Entity Identifier Code
Required
Identifier (ID)

Code identifying an organizational entity, a physical location, property or an individual

BT
Bill-to-Party
CUR-02
100
Currency Code
Required
Identifier (ID)

Code (Standard ISO) for country in whose currency the charges are specified

USD
US Dollar
REF
050
Heading > REF

Order Number

OptionalMax use 1

To specify identifying information

Usage notes

REF^OQ^100-0000000-3091800~

Example
Variants (all may be used)
REFStore Number
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

OQ
Order Number
REF-02
127
Reference Identification
Optional
String (AN)
Min 1Max 30

Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier

Usage notes

This will be the Amazon.com 19 digit Customer Order Number.

Format: Numeric 3-7-7

Example: 123-1234567-1234567
*Dashes will be included.
This number is NOT unique and may be used with more than one shipment. This number will appear on the packing slip and must be returned to Amazon in the INV (810) message.

REF^OQ^100-0000000-3091800~

REF
050
Heading > REF

Store Number

OptionalMax use 1

To specify identifying information

Usage notes

REF^ST^1~

Example
Variants (all may be used)
REFOrder Number
REF-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

ST
Store Number
REF-02
127
Reference Identification
Optional
String (AN)
Min 1Max 30

Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier

Usage notes

This is an internal Amazon.com code representing the web-site where the customer order was placed. This value does not need to be returned to Amazon in any other messages.

DTM
150
Heading > DTM

Delivery Requested

OptionalMax use 1

To specify pertinent dates and times

Usage notes

Date/Time that order is expected to be Delivered. Also known as Delivery Requested date or Promised Delivery date (PDD).

DTM^002^20180405^1200*GM~

Example
Variants (all may be used)
DTMRequested Ship
If Time Code (DTM-04) is present, then Time (DTM-03) is required
DTM-01
374
Date/Time Qualifier
Required
Identifier (ID)

Code specifying type of date or time, or both date and time

002
Delivery Requested
Optional
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

Usage notes

Date expressed CCYYMMDD.

Optional
Time (TM)
HHMM, HHMMSS, HHMMSSD, or HHMMSSDD format

Time expressed in 24-hour clock time as follows: HHMM, or HHMMSS, or HHMMSSD, or HHMMSSDD, where H = hours (00-23), M = minutes (00-59), S = integer seconds (00-59) and DD = decimal seconds; decimal seconds are expressed as follows: D = tenths (0-9) and DD = hundredths (00-99)

Usage notes

Time expressed HHMM.

DTM-04
623
Time Code
Optional
Identifier (ID)

Code identifying the time. In accordance with International Standards Organization standard 8601, time can be specified by a + or - and an indication in hours in relation to Universal Time Coordinate (UTC) time; since + is a restricted character, + and - are substituted by P and M in the codes that follow

GM
Greenwich Mean Time
DTM
150
Heading > DTM

Requested Ship

OptionalMax use 1

To specify pertinent dates and times

Usage notes

Date/Time that order is expected to be shipped. Also known as Requested Ship date or Expected Ship date (ExSD).

DTM^010^20180330^1200*GM~

Example
Variants (all may be used)
DTMDelivery Requested
If Time Code (DTM-04) is present, then Time (DTM-03) is required
DTM-01
374
Date/Time Qualifier
Required
Identifier (ID)

Code specifying type of date or time, or both date and time

010
Requested Ship
Optional
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

Usage notes

Date expressed CCYYMMDD.

Optional
Time (TM)
HHMM, HHMMSS, HHMMSSD, or HHMMSSDD format

Time expressed in 24-hour clock time as follows: HHMM, or HHMMSS, or HHMMSSD, or HHMMSSDD, where H = hours (00-23), M = minutes (00-59), S = integer seconds (00-59) and DD = decimal seconds; decimal seconds are expressed as follows: D = tenths (0-9) and DD = hundredths (00-99)

Usage notes

Time expressed HHMM.

DTM-04
623
Time Code
Optional
Identifier (ID)

Code identifying the time. In accordance with International Standards Organization standard 8601, time can be specified by a + or - and an indication in hours in relation to Universal Time Coordinate (UTC) time; since + is a restricted character, + and - are substituted by P and M in the codes that follow

GM
Greenwich Mean Time
N9 Loop
RequiredMax >1
N9
295
Heading > N9 Loop > N9

Reference Identification

RequiredMax use 1

To transmit identifying information as specified by the Reference Identification Qualifier

Usage notes

N9^ZZ^01~

Example
N9-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

ZZ
Mutually Defined
N9-02
127
Reference Identification
Optional
String (AN)

Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier

01
This shipment completes your order.
02
We've sent this part of your order to ensure quicker service. The other items will ship separately at not additional shipping cost.
03
As you requested, we've sent this part of your order to ensure quicker service. The other items will ship separately.
04
This shipment represents part of your gift. The other portion of your gift is shipping separately.
05
We hope you enjoy your gift, and we'd love to see you soon at www.amazon.com.
06
For detailed information about your orders, please visit Your Account. You can also print invoices, change your email address and payment settings, alter your communication preferences, and much more - 24 hours a day - at http://www.amazon.com/your-account.
07
Visit http://www.amazon.com/returns to return any item - including gifts - in unopened or original condition within 30 days for a full refund (other restrictions apply). Please have your order ID ready. Thanks for shopping at Amazon.com, and please come again!
MSG
300
Heading > N9 Loop > MSG

Message Text

RequiredMax use 1000

To provide a free-form format that allows the transmission of text information

Usage notes

MSG^This shipment completes your order.~

Example
MSG-01
933
Free-Form Message Text
Required
String (AN)
Min 1Max 264

Free-form message text

Usage notes

Text of Order Status Message, related to Order Status Message Code. The most current order status message will be provided by Amazon.com

If 01 then Order Status Message = This shipment completes your order.

If 02 then Order Status Message = We've sent this part of your order to ensure quicker service. The other items will ship separately at not additional shipping cost.

If 03 then Order Status Message = As you requested, we've sent this part of your order to ensure quicker service. The other items will ship separately.

If 04 then Order Status Message = This shipment represents part of your gift. The other portion of your gift is shipping separately.

If 05 then Order Status Message = We hope you enjoy your gift, and we'd love to see you soon at www.amazon.com.

If 06 then Order Status Message = For detailed information about your orders, please visit Your Account. You can also print invoices, change your email address and payment settings, alter your communication preferences, and much more - 24 hours a day - at http://www.amazon.com/your-account.

If 07 then Order Status Message = Visit http://www.amazon.com/returns to return any item - including gifts - in unopened or original condition within 30 days for a full refund (other restrictions apply). Please have your order ID ready. Thanks for shopping at Amazon.com, and please come again!

This will appear on the Amazon-branded packing slip.

N9 Loop end
N1 Bill-to-Party
RequiredMax 1
Variants (all may be used)
CustomerShip FromShip To
N1
310
Heading > Bill-to-Party > N1

Name

RequiredMax use 1

To identify a party by type of organization, name, and code

Usage notes

N1^BT^Amazon.com.kydc,Inc.^92^KYDC~

Example
N1-01
98
Entity Identifier Code
Required
Identifier (ID)

Code identifying an organizational entity, a physical location, property or an individual

BT
Bill-to-Party
Required
String (AN)
Min 1Max 60

Free-form name

Usage notes

This will be the name of the Amazon location to bill for goods and services. This may vary by FC. May vary by order (e.g. Amazon.com.kydc.Inc).

N1-03
66
Identification Code Qualifier
Required
Identifier (ID)

Code designating the system/method of code structure used for Identification Code (67)

92
Assigned by Buyer or Buyer's Agent
N1-04
67
Identification Code
Required
String (AN)

Code identifying a party or other code

  • This segment, used alone, provides the most efficient method of providing organizational identification. To obtain this efficiency the "ID Code" (N104) must provide a key to the table maintained by the transaction processing party.
KYDC
Amazon.com.kydc, Inc
NVDC
Fulfill.tnds, Inc
TNDS
Amazon.com.nvdc, Inc
N1 Bill-to-Party end
N1 Customer
RequiredMax 1
Variants (all may be used)
Bill-to-PartyShip FromShip To
N1
310
Heading > Customer > N1

Name

RequiredMax use 1

To identify a party by type of organization, name, and code

Usage notes

N1^LW^Lord Voldemort~

Example
N1-01
98
Entity Identifier Code
Required
Identifier (ID)

Code identifying an organizational entity, a physical location, property or an individual

LW
Customer
Required
String (AN)
Min 1Max 50

Free-form name

Usage notes

Customer Bill To Name. This is a free form text field and may contain special characters (standard UTF8). Max length is 50 characters. This should appear on the Amazon-branded packing slip.

N2
320
Heading > Customer > N2

Additional Name Information

OptionalMax use 2

To specify additional names or those longer than 35 characters in length

Usage notes

N2^Darla Hopkins~

Example
Required
String (AN)
Min 1Max 60

Free-form name

Usage notes

Customer Bill To Address Line 3. This is a free from text field and may contain special characters (standard UTF8). Max length is 60 characters. This should appear on the Amazon-branded packing slip. Note: Bill To Address can be International.

Optional
String (AN)
Min 1Max 60

Free-form name

N3
330
Heading > Customer > N3

Address Information

RequiredMax use 2

To specify the location of the named party

Usage notes

N3^4 Privet Drive~

Example
N3-01
166
Address Information
Required
String (AN)
Min 1Max 60

Address information

Usage notes

Customer Bill To Address Line 1. This is a free from text field and may contain special characters (standard UTF8). Max length is 60 characters. This should appear on the Amazon-branded packing slip.

Bill To Address can be International.

N3-02
166
Address Information
Optional
String (AN)
Min 1Max 60

Address information

Usage notes

Customer Bill To Address Line 2. This is a free from text field and may contain special characters (standard UTF8). Max length is 60 characters. This should appear on the Amazon-branded packing slip.

Bill To Address can be International.

N4
340
Heading > Customer > N4

Geographic Location

RequiredMax use >1

To specify the geographic place of the named party

Usage notes

N4^LOS ANGELES^CA^90033-4310^US~

Example
N4-01
19
City Name
Required
String (AN)
Min 2Max 50

Free-form text for city name

  • A combination of either N401 through N404, or N405 and N406 may be adequate to specify a location.
Usage notes

Customer Bill To City Name. Max length is 50 characters. This should appear on the Amazon-branded packing slip.

Bill To Address can be International.

N4-02
156
State or Province Code
Required
Identifier (ID)
Min 2Max 2

Code (Standard State/Province) as defined by appropriate government agency

  • N402 is required only if city name (N401) is in the U.S. or Canada.
Usage notes

Customer Bill To State. This should appear on the Amazon-branded packing slip.

Bill To Address can be International.

N4-03
116
Postal Code
Required
Identifier (ID)
Min 3Max 15

Code defining international postal zone code excluding punctuation and blanks (zip code for United States)

Usage notes

Customer Bill To Postal Code. Max length is 15 characters. This should appear on the Amazon-branded packing slip.

Bill To Address can be International.

N4-04
26
Country Code
Required
Identifier (ID)
Min 2Max 3

Code identifying the country

Usage notes

Customer Bill To Country Code. ISO 2 character country code will be used. This should appear on the Amazon-branded packing slip.

Bill To Address can be International.

PER
360
Heading > Customer > PER

Administrative Communications Contact

OptionalMax use >1

To identify a person or office to whom administrative communications should be directed

Usage notes

PER^ZZ^^^^TE^1212613979~

Example
If either Communication Number Qualifier (PER-03) or Communication Number (PER-04) is present, then the other is required
If either Communication Number Qualifier (PER-05) or Communication Number (PER-06) is present, then the other is required
PER-01
366
Contact Function Code
Required
Identifier (ID)

Code identifying the major duty or responsibility of the person or group named

ZZ
Mutually Defined
Optional
String (AN)
Min 1Max 60

Free-form name

Usage notes

Customer Bill To Party Name. This is a free form text field and may contain special characters (standard UTF8). This field is optional and only sent when provided by the customer.

PER-03
365
Communication Number Qualifier
Optional
Identifier (ID)

Code identifying the type of communication number

EM
Electronic Mail
PER-04
364
Communication Number
Optional
String (AN)
Min 1Max 80

Complete communications number including country or area code when applicable

Usage notes

Customer Bill To Party Email Address. This is a free form text field and may contain special characters (standard UTF8). This field is optional and only sent when provided by the customer.

PER-05
365
Communication Number Qualifier
Optional
Identifier (ID)

Code identifying the type of communication number

TE
Telephone
PER-06
364
Communication Number
Optional
String (AN)
Min 1Max 80

Complete communications number including country or area code when applicable

Usage notes

Customer Bill To Party Phone Number. This is a free form text field and may contain special characters (standard UTF8). This field is optional and only sent when provided by the customer.

N1 Customer end
N1 Ship From
RequiredMax 1
Variants (all may be used)
Bill-to-PartyCustomerShip To
N1
310
Heading > Ship From > N1

Name

RequiredMax use 1

To identify a party by type of organization, name, and code

Usage notes

N1^SF^ABCD^92^ABCD~

Example
N1-01
98
Entity Identifier Code
Required
Identifier (ID)

Code identifying an organizational entity, a physical location, property or an individual

SF
Ship From
Required
String (AN)
Min 1Max 60

Free-form name

Usage notes

This will be the Amazon code representing the warehouse that the order should ship from. This is usually a four character alpha code (e.g. ABCD).

N1-03
66
Identification Code Qualifier
Required
Identifier (ID)

Code designating the system/method of code structure used for Identification Code (67)

92
Assigned by Buyer or Buyer's Agent
N1-04
67
Identification Code
Required
String (AN)
Min 2Max 80

Code identifying a party or other code

  • This segment, used alone, provides the most efficient method of providing organizational identification. To obtain this efficiency the "ID Code" (N104) must provide a key to the table maintained by the transaction processing party.
Usage notes

This will be the Amazon code representing the warehouse that the order should ship from. This is usually a four character alpha code (e.g. ABCD). Same as N102.

N1 Ship From end
N1 Ship To
RequiredMax 1
Variants (all may be used)
Bill-to-PartyCustomerShip From
N1
310
Heading > Ship To > N1

Name

RequiredMax use 1

To identify a party by type of organization, name, and code

Usage notes

N1^ST^Harry Potter~

Example
N1-01
98
Entity Identifier Code
Required
Identifier (ID)

Code identifying an organizational entity, a physical location, property or an individual

ST
Ship To
Required
String (AN)
Min 1Max 50

Free-form name

Usage notes

Ship To Name. This is a free form text field and may contain special characters (standard UTF8). Max length is 50 characters. This should appear on the Amazon-branded packing slip.

N2
320
Heading > Ship To > N2

Additional Name Information

OptionalMax use 2

To specify additional names or those longer than 35 characters in length

Usage notes

N2^Darla Dinkins~

Example
Required
String (AN)
Min 1Max 50

Free-form name

Usage notes

Ship To Attention. This is a free form text field and may contain special characters (standard UTF8). Max length is 50 characters. This should appear on the Amazon-branded packing slip.

If Ship To Attention is not provided by the customer, but Address Line 3 is provided, N201 will contain a space and N202 will contain Address Line 3.

Optional
String (AN)
Min 1Max 60

Free-form name

Usage notes

Ship To Address Line 3. This is a free form text field and may contain special characters (standard UTF8). Max length is 60 characters. This should appear on the Amazon-branded packing slip.

N3
330
Heading > Ship To > N3

Address Information

RequiredMax use 2

To specify the location of the named party

Usage notes

N3^4 Privet Drive~

Example
N3-01
166
Address Information
Required
String (AN)
Min 1Max 60

Address information

Usage notes

Ship To Address Line 1. This is a free form text field and may contain special characters (standard UTF8). Max length is 60 characters. This should appear on the Amazon-branded packing slip.

N3-02
166
Address Information
Optional
String (AN)
Min 1Max 60

Address information

Usage notes

Ship To Address Line 2. This is a free form text field and may contain special characters (standard UTF8). Max length is 60 characters. This should appear on the Amazon-branded packing slip.

N4
340
Heading > Ship To > N4

Geographic Location

RequiredMax use >1

To specify the geographic place of the named party

Usage notes

N4^Little Whinging^CA^90033-4310^US^CC^United States~

Example
If Location Identifier (N4-06) is present, then Location Qualifier (N4-05) is required
N4-01
19
City Name
Required
String (AN)
Min 2Max 50

Free-form text for city name

  • A combination of either N401 through N404, or N405 and N406 may be adequate to specify a location.
Usage notes

Ship To City Name. Max length is 50 characters. This should appear on the Amazon-branded packing slip.

N4-02
156
State or Province Code
Required
Identifier (ID)
Min 2Max 2

Code (Standard State/Province) as defined by appropriate government agency

  • N402 is required only if city name (N401) is in the U.S. or Canada.
Usage notes

Ship To State or Province. This should appear on the Amazon-branded packing slip.

N4-03
116
Postal Code
Required
Identifier (ID)
Min 3Max 15

Code defining international postal zone code excluding punctuation and blanks (zip code for United States)

Usage notes

Ship To Postal Code. Max length is 15 characters. This should appear on the Amazon-branded packing slip.

N4-04
26
Country Code
Required
Identifier (ID)
Min 2Max 3

Code identifying the country

Usage notes

Ship To Country Code. ISO 2 character country code will be used. This should appear on the Amazon-branded packing slip.

N4-05
309
Location Qualifier
Optional
Identifier (ID)

Code identifying type of location

CC
Country
N4-06
310
Location Identifier
Optional
String (AN)
Min 1Max 30

Code which identifies a specific location

Usage notes

Ship To Country Name. Max length is 30 characters.

TD5
390
Heading > Ship To > TD5

Carrier Details (Routing Sequence/Transit Time)

RequiredMax use 12

To specify the carrier and sequence of routing and provide transit time information

Usage notes

TD5^^92^UPS_DOM_3DAY_RES^^^^ZZ^RES~

Example
If Location Qualifier (TD5-07) is present, then Location Identifier (TD5-08) is required
TD5-02
66
Identification Code Qualifier
Required
Identifier (ID)

Code designating the system/method of code structure used for Identification Code (67)

  • When specifying a routing sequence to be used for the shipment movement in lieu of specifying each carrier within the movement, use TD502 to identify the party responsible for defining the routing sequence, and use TD503 to identify the actual routing sequence, specified by the party identified in TD502.
92
Assigned by Buyer or Buyer's Agent
TD5-03
67
Identification Code
Required
String (AN)
Min 2Max 80

Code identifying a party or other code

Usage notes

Amazon.com defined Ship Method Codes indicating shipping carrier and shipment service level. Ship Method Codes are case and format sensitive. The Ship Method Code sent in the 850 should be the same Ship Method Code returned in the corresponding 856.

Ship Method Codes are vendor specific and will be provided to each vendor during the implementation process.

Value examples:
USPS_DS (Priority Mail)
USPS_SMART_MAIL
UPS_2ND
UPS_DOM_3DAY_RES
UPS_GR_COM
UPS_GR_RES
UPS_NEXT
UPS_NEXT_SAVER
FEDEX_NEXT_PRI
FEDEX_NEXT_STD
FEDEX_SECOND
FEDEX_3DAY

To see the full list of ship methods in use -- including both the code and the friendly name -- search the Help section on 'ship methods'.

TD5-07
309
Location Qualifier
Optional
Identifier (ID)

Code identifying type of location

ZZ
Mutually Defined
TD5-08
310
Location Identifier
Optional
String (AN)
Min 1Max 30

Code which identifies a specific location

Usage notes

This field specifies the "Ship to Address Type".

N1 Ship To end
Heading end

Detail

PO1 Loop
RequiredMax >1
PO1
010
Detail > PO1 Loop > PO1

Baseline Item Data

RequiredMax use 1

To specify basic and most frequently used line item data

  • PO102 is required.
Usage notes

PO1^1^1^EA^6.35^NT^SK^1110007^^^TP^Kitchen^BL^1^ZZ^Amazon.com, LLC~

Example
If Basis of Unit Price Code (PO1-05) is present, then Unit Price (PO1-04) is required
If either Product/Service ID Qualifier (PO1-12) or Product/Service ID (PO1-13) is present, then the other is required
If either Product/Service ID Qualifier (PO1-10) or Product/Service ID (PO1-11) is present, then the other is required
If either Product/Service ID Qualifier (PO1-08) or Product/Service ID (PO1-09) is present, then the other is required
PO1-01
350
Assigned Identification
Required
String (AN)
Min 1Max 20

Alphanumeric characters assigned for differentiation within a transaction set

  • PO101 is the line item identification.
Usage notes

Line Item ID. The Line Item ID must be retained and referred to in subsequent messages (855, 856, 810). This number is generally sequential (1, 2, 3, etc.).

The combination of PO101 and PO107 should remain constant throughout the order cycle and across messages. Whenever the number in PO101 is used the information will reference the item in PO107.

PO1-02
330
Quantity Ordered
Required
Decimal number (R)
Min 1Max 15

Quantity ordered

Usage notes

Quantity Ordered. This should appear on the p-slip.

PO1-03
355
Unit or Basis for Measurement Code
Required
Identifier (ID)

Code specifying the units in which a value is being expressed, or manner in which a measurement has been taken

EA
Each
PO1-04
212
Unit Price
Optional
Decimal number (R)
Min 1Max 15

Price per unit of product, service, commodity, etc.

Usage notes

This is Amazon's Expected Cost for the product, not including fulfillment charges.

Format: Two Decimals (e.g. 9.00). This should Not be on the Amazon-branded packing slip.

PO1-05
639
Basis of Unit Price Code
Optional
Identifier (ID)

Code identifying the type of unit price for an item

NT
Net
PO1-06
235
Product/Service ID Qualifier
Required
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

  • PO106 through PO125 provide for ten different product/service IDs per each item. For example: Case, Color, Drawing No., U.P.C. No., ISBN No., Model No., or SKU.
SK
Stock Keeping Unit (SKU)
PO1-07
234
Product/Service ID
Required
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

This will be the Product ID of the item being ordered. This should appear on the Amazon-branded packing slip.

Product ID's will vary by vendor and will be agreed upon before beginning the implementation process (SKU, UPC, ASIN, etc.).

PO1-08
235
Product/Service ID Qualifier
Optional
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

B6
Author Code
PO1-09
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

Author Name. This will only be sent when applicable. If sent, this should appear on the Amazon-branded packing slip.

PO1-10
235
Product/Service ID Qualifier
Optional
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

B4
Binding Code
TP
Product Type Code
PO1-11
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

This will be the Binding Description (e.g. Hardback). This will only be sent when applicable. If sent, this should appear on the Amazon-branded packing slip.

PO1-12
235
Product/Service ID Qualifier
Optional
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

BL
Brand/Label
PO1-13
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

This will be the Merchant Branding of the item. This value does not need to be printed on the Amazon-branded packing slip or returned to Amazon in any corresponding messages.

PO1-14
235
Product/Service ID Qualifier
Required
Identifier (ID)

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

ZZ
Mutually Defined
PO1-15
234
Product/Service ID
Required
String (AN)
Min 1Max 48

Identifying number for a product or service

Usage notes

This will be the Seller Of Record of the item. This should appear on the Amazon-branded packing slip.

CTP Loop
OptionalMax >1
CTP
040
Detail > PO1 Loop > CTP Loop > CTP

Pricing Information

RequiredMax use 1

To specify pricing information

Usage notes

CTP^^PUR^14.17~

Example
CTP-02
236
Price Identifier Code
Optional
Identifier (ID)

Code identifying pricing specification

PUR
Purchase
CTP-03
212
Unit Price
Optional
Decimal number (R)
Min 1Max 15

Price per unit of product, service, commodity, etc.

  • See Figures Appendix for an example detailing the use of CTP03 and CTP04.
  • See Figures Appendix for an example detailing the use of CTP03, CTP04 and CTP07.
Usage notes

This will be the Amazon Price to Customer.

Format: Two Decimals (e.g. 9.00). This will be in the currency expressed in CUR02. This should appear on the Amazon-branded packing slip.

CTP Loop end
SAC Loop
OptionalMax >1
SAC
130
Detail > PO1 Loop > SAC Loop > SAC

Service, Promotion, Allowance, or Charge Information

RequiredMax use 1

To request or identify a service, promotion, allowance, or charge; to specify the amount or percentage for the service, promotion, allowance, or charge

Usage notes

SAC^S^B790^^^^^^^^^^^^^N~

Example
SAC-01
248
Allowance or Charge Indicator
Required
Identifier (ID)

Code which indicates an allowance or charge for the service specified

  • If SAC01 is "A" or "C", then at least one of SAC05, SAC07, or SAC08 is required.
S
Service
SAC-02
1300
Service, Promotion, Allowance, or Charge Code
Optional
Identifier (ID)

Code identifying the service, promotion, allowance, or charge

B790
Crafting
SAC-15
352
Description
Optional
String (AN)

A free-form description to clarify the related data elements and their content

Usage notes

This will be used to indicate Gift Wrap usage.

Valid Values:
Y - Yes, the item is to be gift wrapped
N - No, the item is not to be gift wrapped

If this segment is not sent, the item is not to be gift wrapped.

N
No, the item is not to be gift wrapped
Y
Yes, the item is to be gift wrapped
SAC Loop end
MSG
289
Detail > PO1 Loop > MSG

Title or Description of goods

OptionalMax use 1

To provide a free-form format that allows the transmission of text information

Usage notes

Product description or book title to be printed at the line item level on the Amazon-branded packing slip

Example:
MSG^Designer Mug with Lid, Red~

Example
MSG-01
933
Free-Form Message Text
Required
String (AN)
Min 1Max 264

Free-form message text

Usage notes

Title or Description of goods. May contain special characters (standard UTF8) Max length is 264. This should appear on the Amazon-branded packing slip.

MSG
290
Detail > PO1 Loop > MSG

Gift Message

OptionalMax use 1

To provide a free-form format that allows the transmission of text information

Usage notes

Gift Message to be printed beneath line item on Amazon-branded packing slip

Example:
MSG^Happy Birthday, I hope you enjoy your gift!~

Example
MSG-01
933
Free-Form Message Text
Required
String (AN)
Min 1Max 264

Free-form message text

Usage notes

This will be the Gift Message. This is a free form text field and may contain special characters (standard UTF8). This field is not edited, it is sent as the customer has entered it. Max length is 264 characters. This should appear on the Amazon-branded packing slip.

PO1 Loop end
Detail end

Summary

CTT Loop
RequiredMax >1
CTT
010
Summary > CTT Loop > CTT

Transaction Totals

RequiredMax use 1

To transmit a hash total for a specific element in the transaction set

  • The number of line items (CTT01) is the accumulation of the number of PO1 segments. If used, hash total (CTT02) is the sum of the value of quantities ordered (PO102) for each PO1 segment.
Usage notes

CTT^1^1~

Example
CTT-01
354
Number of Line Items
Required
Numeric (N0)
Min 1Max 6

Total number of line items in the transaction set

Usage notes

Total number of line items in the transaction set.

CTT-02
347
Hash Total
Required
Decimal number (R)
Min 1Max 10

Sum of values of the specified data element. All values in the data element will be summed without regard to decimal points (explicit or implicit) or signs. Truncation will occur on the left most digits if the sum is greater than the maximum size of the hash total of the data element.

## Example:
-.0018 First occurrence of value being hashed.
.18 Second occurrence of value being hashed.
1.8 Third occurrence of value being hashed.
18.01 Fourth occurrence of value being hashed.

1855 Hash total prior to truncation.
855 Hash total after truncation to three-digit field.

Usage notes

This will be the total number of units being requested.

CTT Loop end
SE
030
Summary > SE

Transaction Set Trailer

RequiredMax use 1

To indicate the end of the transaction set and provide the count of the transmitted segments (including the beginning (ST) and ending (SE) segments)

Example
SE-01
96
Number of Included Segments
Required
Numeric (N0)
Min 1Max 10

Total number of segments included in a transaction set including ST and SE segments

SE-02
329
Transaction Set Control Number
Required
Numeric (N)
Min 4Max 9

Identifying control number that must be unique within the transaction set functional group assigned by the originator for a transaction set

Summary end

Functional Group Trailer

RequiredMax use 1

To indicate the end of a functional group and to provide control information

Example
GE-01
97
Number of Transaction Sets Included
Required
Numeric (N0)
Min 1Max 6

Total number of transaction sets included in the functional group or interchange (transmission) group terminated by the trailer containing this data element

GE-02
28
Group Control Number
Required
Numeric (N0)
Min 1Max 9

Assigned number originated and maintained by the sender

Interchange Control Trailer

RequiredMax use 1

To define the end of an interchange of zero or more functional groups and interchange-related control segments

Example
IEA-01
I16
Number of Included Functional Groups
Required
Numeric (N0)
Min 1Max 5

A count of the number of functional groups included in an interchange

IEA-02
I12
Interchange Control Number
Required
Numeric (N0)
Min 9Max 9

A control number assigned by the interchange sender

EDI Samples

B2B Order

ISA*00* *00* *ZZ*AMAZONDS *01*RECEIVERID *220428*1230*U*00401*000000013*0*P*>~
GS*PO*AMAZONDS*RECEIVERID*20220428*123038*96*X*004010~
ST*850*0001~
BEG*00*SS*T7Fd9Zn55**20220428~
CUR*BT*USD~
REF*OQ*002-9977742-6703449~
REF*ST*1~
DTM*010*20220503*2030*GM~
DTM*002*20220507*0659*GM~
N9*ZZ*03~
MSG*As you requested, we've sent this part of your order to ensure quicker service. The other items will ship separately.~
N9*ZZ*06~
MSG*For detailed information about your orders, please visit Your Account. You can also print invoices, change your e-mail address and payment settings, alter your communication preferences, and much more-24 hours a day-at http://www.amazon.com/your-account.~
N9*ZZ*07~
MSG*Visit http://www.amazon.com/returns to return any item-including gifts-in unopened or original condition within 30 days for a full refund(other restrictions apply). Please have your order ID ready. Thanks for shopping at Amazon.com, and please come again!~
N1*BT*Amazon.com.kydc,Inc.*92*KYDC~
N1*SF*WHSE*92*WHSE~
N1*ST*Jennifer Smith~
N3*93 Hardwood Ln~
N4*Rochester*NY*14616-1629*US*CC*United States~
TD5**92*UPS_GR_RES****ZZ*RES~
N1*LW*Jennifer Smith~
N3*93 Hardwood Ln~
N4*Rochester*NY*14616-1629*US~
PER*ZZ****TE*2065551214~
PO1*1*1*EA*2.41*NT*SK*1092189***TP*Kitchen*BL*1*ZZ*Amazon.com, LLC~
CTP**PUR*6.54~
MSG*Chicago Cutlery Essentials 3-1/2-Inch Parer Knife~
CTT*1*1~
SE*28*0001~
GE*1*96~
IEA*1*000000013~

Gift Order

ISA*00* *00* *ZZ*AMAZONDS *ZZ*RECEIVERID *220428*1230*U*00401*000000021*0*P*>~
GS*PO*AMAZONDS*RECEIVERID*20220428*123038*98*X*004010~
ST*850*0001~
BEG*00*ZZ*T7Fd9Zn57**20220428~
CUR*BT*USD~
REF*OQ*123-4567890-1234567~
REF*ST*1~
DTM*010*20220503*2030*GM~
DTM*002*20220507*0659*GM~
N9*ZZ*05~
MSG*We hope you enjoy your gift, and we'd love to see you soon at www.amazon.com.~
N9*ZZ*06~
MSG*For detailed information about your orders, please visit Your Account. You can also print invoices, change your email address and payment settings, alter your communication preferences, and much more - 24 hours a day - at http://www.amazon.com/your-account.~
N9*ZZ*07~
MSG*Visit http://www.amazon.com/returns to return any item - including gifts - in unopened or original condition within 30 days for a full refund (other restrictions apply). Please have your order ID ready. Thanks for shopping at Amazon.com, and please come again!~
N1*BT*Amazon.com.KYDC Inc*92*KYDC~
N1*SF*WHSE*92*WHSE~
N1*ST*William Smith~
N2*William Smith~
N3*1415 Lake Lane~
N4*Auburn*WA*98092*US~
TD5**92*UPS_GR_RES****ZZ*RES~
N1*LW*Sam Smith~
N3*135 Mountain Rd~
N4*Orting*WA*98391*US~
PO1*1*1*EA*22.10*NT*SK*B0000E2RIA*****BL*1*ZZ*Amazon.com~
SAC*S*B790*************Y~
MSG*Elephant Vanilla Chai, 4lb.~
MSG*Happy Anniversary!~
CTT*1*1~
SE*29*0001~
GE*1*98~
IEA*1*000000021~

Multiple Item Order

ISA*00* *00* *ZZ*AMAZONDS *01*RECEIVERID *220428*1230*U*00401*000000040*1*P*>~
GS*PO*AMAZONDS*RECEIVERID*20220428*123038*95*X*004010~
ST*850*0001~
BEG*00*DS*T7Fd9Zn54**20220428~
CUR*BT*USD~
REF*OQ*111-3973054-1555434~
REF*ST*1~
DTM*010*20220503*2030*GM~
DTM*002*20220507*0659*GM~
N9*ZZ*01~
MSG*This shipment completes your order.~
N9*ZZ*06~
MSG*For detailed information about your orders, please visit Your Account. You can also print invoices, change your e-mail address and payment settings, alter your communication preferences, and much more-24 hours a day-at http://www.amazon.com/your-account.~
N9*ZZ*07~
MSG*Visit http://www.amazon.com/returns to return any item-including gifts-in unopened or original condition within 30 days for a full refund(other restrictions apply). Please have your order ID ready. Thanks for shopping at Amazon.com, and please come again!~
N1*BT*Amazon.com.kydc,Inc.*92*KYDC~
N1*SF*WHSE*92*WHSE~
N1*ST*Charlie Smith~
N2*Darla Smith~
N3*11254 Main St*Suite 112~
N4*Seattle*WA*98104*US*CC*United States~
TD5**92*UPS_GR_RES****ZZ*RES~
N1*LW*Amber Smith~
N3*123 Anderson Avenue~
N4*Seattle*WA*98103*US~
PER*ZZ****TE*2065551212~
PO1*1*3*EA*18.04*NT*SK*1617*****BL*1*ZZ*Amazon.com~
CTP**PUR*19.99~
MSG*Wide Tracker Activity Walker~
PO1*2*2*EA*54.42*NT*SK*4927*****BL*1*ZZ*Amazon.com~
CTP**PUR*59.99~
MSG*Deluxe Cozy Convertible~
PO1*3*1*EA*18*NT*SK*9876*****BL*1*ZZ*Amazon.com~
CTP**PUR*34.99~
MSG*Red Rattle~
CTT*3*6~
SE*35*0001~
GE*1*95~
IEA*1*000000040~

Stedi is a registered trademark of Stedi, Inc. All names, logos, and brands of third parties listed on this page are trademarks of their respective owners (including “X12”, which is a trademark of X12 Incorporated). Stedi, Inc. and its products and services are not endorsed by, sponsored by, or affiliated with these third parties. Use of these names, logos, and brands is for identification purposes only, and does not imply any such endorsement, sponsorship, or affiliation.