XML Tag Reference

Coding Note

Below are tag-by-tag listings of each XML document in the NAMM B2B standard. Each tag is followed by a brief description and a flag indicating whether the tag is required in the particular document. Nested tags are indented to indicate the hierarchical structure of the documents.

Complex (parent) elements are shown here as separate start and end tags (e.g., <Location> ... </Location>), while simple (child) elements are shown as “empty” tags (e.g., <Name/>) for improved readability in this document. These tags would of course be coded in live documents with start tags, data, and end tags (e.g., <Name>MusicMax Corporation</Name>).

While most pertinent metadata in these documents is coded as nested tags (e.g., <Barcode> <ID>4959112079274</ID> <Type>GTIN-13</Type> </Barcode>), some metadata is coded instead as attribute/value pairs (e.g., <Price type="MSRP" Currency="USD">980.00</Price>). Attributes are shown here on separate lines below the tags to which they belong (as nested tags would be, except without enclosing <>s), and their descriptions begin with the notation "Attribute:".

Elements and attributes required by the XSD schemas are marked with an X in the Req column. If a child element or attribute is marked required but its parent element is not, it means that the parent is still optional but, if used, it must contain the required child elements or attributes.



Important Note:
Most of the XML tags used in these files are mixed-case, as in <PartyIdType>; this coding technique is valid XML, and is used by design to improve human readability. However, XML code is case-sensitive, so users must be exceptionally careful to maintain proper tag case when creating and processing these files within their own editors, applications, and systems.

Party Document

Party – party-v2009.1.xml

Tag

Description

Req

<?xml version="1.0" encoding="UTF-8"?>

XML declaration

X

<NAMM_PARTY version="2009.1">

File-level Start tag

X

<RevisionDate/>

Revision date

X

<TradingPartner>

Top-level Start tag

X

<PartyId/>

GLN/NAMM partner ID

X

<PartyIdType/>

ID type

X

<Name/>

Partner company name

X

<DBA/>

Partner Doing Business As name

 

<URL/>

Partner company website

 

<Locations>

Start tag

X

<Location>

Start tag

X

<PartyId/>

GLN/NAMM location ID

X

<PartyIdType/>

ID type designation

X

<Description/>

Partner location description

 

<Name/>

Partner location name

 

<DBA/>

Location Doing Business As name

 

<Address>

Start tag

 

<Attn/>

Location contact person

 

<Address1/>

Location address line 1

 

<Address2/>

Location address line 2

 

<Address3/>

Location addressl ine 3

 

<City/>

Location city

 

<State/>

Location state

 

<PostalCode/>

Location zip/postal code

 

<Country/>

Location country

 

<CountryCode/>

Location country code

 

</Address>

End tag

 

<Phone/>

Location phone number

 

<Fax/>

Location fax number

 

<Email/>

Location email address

 

<StartDate/>

Address valid as of date

 

<EndDate/>

Address invalid as of date

 

</Location>

End tag

X

</Locations>

End tag

X

</TradingPartner>

End tag

X

</NAMM_PARTY>

End tag

X

Item Document

Item – item-v2011.1.xml

Tag

Description

Req

<?xml version="1.0" encoding="utf-8"?>

XML declaration

X

<NAMM_ITEM version="2011.1">

File-level Start tag

X

<Timestamp/>

Date/time stamp for this document

X

<Id/>

Document ID

X

<SupplierId/>

GLN/NAMM partner ID

X

<Items>

Start tag

X

<Item>

Start tag

X

<SupplierItemId/>

Supplier product identifier

X

<SupplierModel/>

Supplier model identifier

X

<SupplierItemDesc/>

Supplier item description

X

<Kit/>

Item SKU made up of other SKUs

X

<Serialized/>

Item has a serial number

X

<BrandName/>

Item brand name

X

<CountryOrigin/>

Country of origin

 

<Length/>

Item length

X

<Width/>

Item width

X

<Height/>

Item height

X

<DimUOM/>

Dimension unit of measure (1)

X

<Weight/>

Item weight

X

<WeightUOM/>

Weight unit of measure (1)

X

<AnnounceDate/>

Item announcement date

X

<AvailableDate/>

Item availability date

X

<UnavailableDate/>

Item unavailability date

 

<EndOfProductionDate/>

Item end of production date

 

<ReplacementID/>

Item replacement ID

 

<WarrantyPartTerm/>

Parts warranty term (length)

X

<WarrantyPartUOM/>

Parts warranty unit of measure (1)

X

<WarrantyLabTerm/>

Labor warranty term (length)

X

<WarrantyLabUOM/>

Labor warranty unit of measure (1)

X

<Condition/>

Item condition

 

<Barcodes>

Start tag

X

<Barcode>

Start tag

X

<ID/>

Item numeric barcode

X

<Type/>

Item barcode type

X

</Barcode>

End tag

X

</Barcodes>

End tag

X

<Pricing>

Start tag

 

<Price/>

Item price

 

type

Attribute: price type

X

Currency

Attribute: price Currency

X

Qty

Attribute: price quantity

 

</Pricing>

End tag

 

<Containers>

Start tag

X

<Container>

Start tag

X

<Type/>

Container type

X

<Length/>

Container length

X

<Width/>

Container width

X

<Height/>

Container height

X

<DimUOM/>

Dimensions unit of measure (1)

X

<Weight/>

Container weight

X

<WeightUOM/>

Weight unit of measure (1)

X

<UOM/>

Container unit of measure (1)

X

<QtyPerUOM/>

Item quantity per unit of measure

X

<Barcodes>

Start tag

 

<Barcode>

Start tag

 

<ID/>

Container numeric barcode

X

<Type/>

Container barcode type

X

</Barcode>

End tag

 

</Barcodes>

End tag

 

</Container>

End tag

X

</Containers>

End tag

X

<MarketingInfo>

Start tag

X

<PrimaryCategory/>

Item primary category

X

<ProductURL/>

Item URL

 

<ItemDescLong/>

Item long description

 

<SecondaryCategories>

Start tag

 

<Category/>

Item secondary category

 

</SecondaryCategories>

End tag

 

<Bullets>

Start tag

 

<Bullet/>

Item bullet point

 

</Bullets>

End tag

 

<Media>

Start tag

 

<Images>

Start tag

 

<Image/>

Item image

 

Audience

Attribute: image intended audience

 

View

Attribute: image intended view

 

Caption

Attribute: image caption

 

CarouselSequence

Attribute: image carousel sequence

 

</Images>

End tag

 

<Videos>

Start tag

 

<Video/>

Item video

 

Audience

Attribute: video intended audience

 

type

Attribute: video type

X

Caption

Attribute: video caption

 

</Videos>

End tag

 

<Documents>

Start tag

 

<Document/>

Item document

 

Audience

Attribute: document intended audience

 

type

Attribute: document type

X

Caption

Attribute: document caption

 

</Documents>

End tag

 

<Audios>

Start tag

 

<Audio/>

Item audio

 

Audience

Attribute: audio intended audience

 

type

Attribute: audio type

X

Caption

Attribute: audio caption

 

</Audios>

End tag

 

</Media>

End tag

X

<Keywords>

Start tag

 

<Keyword/>

Item marketing keyword

 

</Keywords>

End tag

 

</MarketingInfo>

End tag

X

<ExtendedAttributes>

Start tag

 

<Data>

Start tag

 

Name

Attribute: data name

X

<Topic>

Start tag

 

<SuperTitle/>

Item supertitle

 

<Title/>

Item title

 

<SubTitle/>

Item subtitle

 

<Credits/>

Item credits

 

<Contributor/>

Item contributor

 

primary

Attribute: primary credit

X

Contribution

Attribute: primary contribution

X

ContributorName

Attribute: contributor name

X

ContributorNameReversed

Attribute: contributor name reversed

X

<Copyright>

Start tag

 

<CopyrightLine/>

Topic copyright text

 

</Copyright>

End tag

 

</Topic>

End tag

 

<Contributor/>

Other contributor

 

primary

Attribute: primary credit

X

Contribution

Attribute: primary contribution

X

ContributorName

Attribute: contributor name

X

ContributorNameReversed

Attribute: contributor name reversed

X

</Data>

End tag

 

</ExtendedAttributes>

End tag

 

<RelatedItems>

Start tag

 

<RelatedItem>

Start tag

 

type

Attribute: related item type

X

included

Attribute: related item included

 

<SupplierItemID/>

Related item supplier item ID

X

<Barcode>

Start tag

 

<ID>

Related item numeric barcode

X

<Type>

Related item barcode type

X

</Barcode>

End tag

 

</RelatedItem>

End tag

 

</RelatedItems>

End tag

 

<ItemFamily/>

Item family

 

property

Attribute: family property

X

code

Attribute: family code

X

<Availability>

Start tag

 

<QtyOnHand/>

Item quantity on hand

 

<Available/>

Item availability

X

<QueryURL/>

Item query URL

 

</Availability>

End tag

 

</Item>

End tag

X

</Items>

End tag

X

</NAMM_ITEM>

End tag

X

(1) See Appendix A, "Codes Tables".

Functional Acknowledgement

Functional Acknowledgement – funack-v2009.1.xml

Tag

Description

Req

<?xml version="1.0" encoding="UTF-8" ?>

XML declaration

X

<NAMM_FunctionalAcknowledgement version="2009.1">

File-level Start tag

X

<Timestamp/>

Date/time stamp for this document

X

<Id/>

Document ID

X

<Supplier>

Start tag

X

<PartyId/>

Supplier GLN/NAMM ID

X

</Supplier>

End tag

X

<SoldTo>

Start tag

X

<PartyId/>

Buyer GLN/NAMM ID

X

</SoldTo>

End tag

X

<StatusCode/>

Status indicator code (1)

X

<StatusMessage/>

Status message/description (1)

X

</NAMM_FunctionalAcknowledgement>

End tag

X

(1) SeeAppendix A, "Codes Tables".

Pricebook

Price Book – pricebook-v2011.0.xml

Tag

Description

Req

<?xml version="1.0" encoding="UTF-8" ?>

XML declaration

X

<NAMM_PRICEBOOK version="2011.0">

File-level Start tag

X

<Timestamp/>

Date/time stamp for this document

X

<Supplier>

Start tag

X

<PartyId/>

Supplier GLN/NAMM ID

X

<Name/>

Supplier company name

 

<Address>

Start tag

 

<Address1/>

Supplier address line 1

 

<Address2/>

Supplier address line 2

 

<Address3/>

Supplier address line 3

 

<City/>

Supplier city

 

<State/>

Supplier state

 

<PostalCode/>

Supplier postal code

 

<Country/>

Supplier country

 

<CountryCode/>

Supplier country code

 

</Address>

End tag

 

</Supplier>

End tag

X

<SoldTo>

Start tag

X

<PartyId/>

Buyer GLN/NAMM ID

X

<Name/>

Buyer company name

 

<Address>

Start tag

 

<Address1/>

Buyer address line 1

 

<Address2/>

Buyer address line 2

 

<Address3/>

Buyer address line 3

 

<City/>

Buyer city

 

<State/>

Buyer state

 

<PostalCode/>

Buyer postal code

 

<Country/>

Buyer country

 

<CountryCode/>

Buyer country code

 

</Address>

End tag

 

</SoldTo>

End tag

X

<Items>

Start tag

X

<Item/>

Item info

X

EffectiveDate

Attribute: item effective date/time

 

<BarCodeId/>

Item digital barcode representation

X

<BarCodeType/>

Item barcode type

X

<SupplierItemId/>

Supplier item ID

 

<Levels/>

Start tag

X

<Level/>

Start tag

X

<Price/>

Price

X

Currency

Attribute: price currency code

X

type

Attribute: price type

X

<LevelMin/>

Level minimum

X

<LevelMax/>

Level maximum

X

<LevelUOM/>

Level unit of measure

X

</Level>

End tag

X

</Levels>

End tag

X

</Item>

End tag

X

</Items>

End tag

X

</NAMM_PRICEBOOK>

End tag

X

Purchase Order

Purchase Order – po-v2009.2.xml

Tag

Description

Req

<?xml version="1.0" encoding="UTF-8" ?>

XML declaration

X

<NAMM_PO version="2009.2">

File-level Start tag

X

<Id/>

Document ID

X

<Timestamp/>

Date/time stamp for this document

X

<POHeader>

Start tag

X

<SoldTo>

Start tag

X

<PartyId/>

Buyer GLN/NAMM ID

X

<Name/>

Buyer company name

 

<Address>

Start tag

 

<Attn/>

Buyer contact person

 

<Address1/>

Buyer address line 1

 

<Address2/>

Buyer address line 2

 

<Address3/>

Buyer address line 3

 

<City/>

Buyer city

 

<State/>

Buyer state

 

<PostalCode/>

Buyer postal code

 

<Country/>

Buyer country

 

<CountryCode/>

Buyer country code

 

</Address>

End tag

 

</SoldTo>

End tag

X

<BillTo>

Start tag

X

<PartyId/>

Payor GLN/NAMM ID

X

<Name/>

Payor company name

 

<Address>

Start tag

 

<Attn/>

Payor contact person

 

<Address1/>

Payor address line 1

 

<Address2/>

Payor address line 2

 

<Address3/>

Payor address line 3

 

<City/>

Payor city

 

<State/>

Payor state

 

<PostalCode/>

Payor postal code

 

<Country/>

Payor country

 

<CountryCode/>

Payor country code

 

</Address>

End tag

 

</BillTo>

End tag

X

<BuyerOrderId/>

Buyer purchase order number/ID

X

<Supplier>

Start tag

X

<PartyId/>

Supplier GLN/NAMM ID

X

<Name/>

Supplier company name

 

<Address>

Start tag

 

<Attn/>

Supplier contact person

 

<Address1/>

Supplier address line 1

 

<Address2/>

Supplier address line 2

 

<Address3/>

Supplier address line 3

 

<City/>

Supplier city

 

<State/>

Supplier state

 

<PostalCode/>

Supplier postal code

 

<Country/>

Supplier country

 

<CountryCode/>

Supplier country code

 

</Address>

End tag

 

</Supplier>

End tag

X

<TermsCode/>

Terms code (1)

X

<TermsDays/>

Number of days for payment

 

<TermsDate/>

Date payment is due

 

<TermsPercent/>

Percentage terms

 

<TermsPercentDays/>

Number of days for percentage terms

 

<ShipInstructions/>

Shipping instructions

 

<TranspCode/>

Transport method code (1)

X

<TranspDesc/>

Transport description (1)

 

<TranspCarrier/>

Transport carrier name

 

<TranspTime/>

Expected transport time

 

<TranspTerms/>

Transport terms

 

<IncoTermsCode/>

International terms code (1)

 

<IncoTermsDesc/>

International terms description (1)

 

<POComments/>

Buyer comments

 

<DateOrdered/>

Order date

X

<DateBeginShip/>

Date to begin shipment

 

<DateEndShip/>

Date to end shipment

 

<DateCancel/>

Date to cancel order if not shipped

 

<Backorder/>

Allow backorder

X

<BuyerName/>

Individual buyer name

 

<PORevisionNumber/>

Purchase Order revision number

X

<POStatusIndicator/>

New or Updated PO

X

<ASNRequirement/>

Require ASN

X

<POFileType/>

Pre-accepted or Accepted PO

X

<ShipTo>

Start tag

X

<PartyId/>

Receiver GLN/NAMM ID

X

<Name/>

Receiver company name

 

<Address>

Start tag

 

<Attn/>

Receiver contact person

 

<Address1/>

Receiver address line 1

 

<Address2/>

Receiver address line 2

 

<Address3/>

Receiver address line 3

 

<City/>

Receiver city

 

<State/>

Receiver state

 

<PostalCode/>

Receiver postal code

 

<Country/>

Receiver country

 

<CountryCode/>

Receiver country code

 

</Address>

End tag

 

</ShipTo>

End tag

X

</POHeader>

End tag

X

<PODetail>

Start tag

X

<Items>

Start tag

X

<Item>

Start tag

X

<POLineNbr/>

Purchase Order line number

X

<BuyerItemId/>

Buyer item ID

X

<BuyerItemDesc/>

Buyer item description

 

<Qty/>

Quantity

X

<QtyUOM/>

Quantity unit of measure (1)

X

<UCValue/>

Unit cost value

X

<UCCurrencyCode/>

Unit cost currency code

X

<RetailValue/>

Retail value

 

<RetailCurrencyCode/>

Retail currency code

 

<ICQtyPerUOM/>

Inner Carton quantity per Unit of Measure

 

<ICOUM/>

Inner Carton Unit of Measure

 

<MCQtyPerUOM/>

Master Carton quantity per Unit of Measure

 

<MCUOM/>

Master Carton Unit of Measure

 

<SupplierItemId/>

Supplier item ID

 

<BarCodeId/>

Digital barcode representation

X

<BarCodeType/>

Barcode description

X

<DateBeginShip/>

Item beginning shiping date

 

<DateEndShip/>

Item end shipping date

 

<DateCancel/>

Item cancel date

 

</Item>

End tag

X

</Items>

End tag

X

</PODetail>

End tag

X

</NAMM_PO>

End tag

X

(1) See Appendix A, "Codes Tables".

PO Status Request

PO Status Request – postatusrequest-v2011.0.xml

Tag

Description

Req

<?xml version="1.0" encoding="UTF-8" ?>

XML declaration

X

<NAMM_POStatusRequest version="2011.0">

File-level Start tag

X

<Timestamp/>

Date/time stamp for this document

X

<Id/>

Document ID

X

<Supplier>

Start tag

X

<PartyId/>

Supplier GLN/NAMM ID

X

</Supplier>

End tag

X

<SoldTo>

Start tag

X

<PartyId/>

Buyer GLN/NAMM ID

X

</SoldTo>

End tag

X

<BuyerOrderIds>

Start tag

X

<BuyerOrderId/>

Buyer order ID

X

</BuyerOrderIds>

End tag

X

</NAMM_POStatusRequest>

End tag

X

PO Status / Det Ack

PO Status / Detailed Acknowledgement – postatus-v2011.0.xml

Tag

Description

Req

<?xml version="1.0" encoding="UTF-8" ?>

XML declaration

X

<NAMM_POStatus version="2011.0">

File-level Start tag

X

<POStatusRequestId/>

PO ID of status request

X

<Timestamp/>

Date/time stamp for this document

X

<BuyerOrderId/>

Buyer order ID

X

<DateOrdered/>

Date ordered

X

<BuyerName/>

Buyer name

 

<Supplier>

Start tag

X

<PartyId/>

Supplier GLN/NAMM ID

X

<Name/>

Supplier company name

 

<Address>

Start tag

 

<Attn/>

Supplier contact person

 

<Address1/>

Supplier address line 1

 

<Address2/>

Supplier address line 2

 

<Address3/>

Supplier address line 3

 

<City/>

Supplier city

 

<State/>

Supplier state

 

<PostalCode/>

Supplier postal code

 

<Country/>

Supplier country

 

<CountryCode/>

Supplier country code

 

</Address>

End tag

 

</Supplier>

End tag

X

<SoldTo>

Start tag

X

<PartyId/>

Buyer GLN/NAMM ID

X

<Name/>

Buyer company name

 

<Address>

Start tag

 

<Attn/>

Buyer contact person

 

<Address1/>

Buyer address line 1

 

<Address2/>

Buyer address line 2

 

<Address3/>

Buyer address line 3

 

<City/>

Buyer city

 

<State/>

Buyer state

 

<PostalCode/>

Buyer postal code

 

<Country/>

Buyer country

 

<CountryCode/>

Buyer country code

 

</Address>

End tag

 

</SoldTo>

End tag

X

<StatusCode/>

Status code

X

<PaymentTerms>

Start tag

X

<StatusCode/>

Payment status code (1)

X

<StatusMessage/>

Payment status message

 

<TermsCode/>

Payment terms code (1)

 

<TermsPercent/>

Payment terms percent

 

</PaymentTerms>

End tag

X

<ShipmentTerms>

Start tag

X

<StatusCode/>

Shipment status code (1)

X

</ShipmentTerms>

End tag

X

<Items>

Start tag

X

<Item>

Start tag

X

<POLineNbr/>

Item line number

X

<SequenceNbr/>

Item sequence number

X

<StatusCode/>

Item status code (1)

X

<StatusMessage/>

Item status message

 

<Qty/>

Item quantity

 

<RetailValue/>

Item retail value

 

<UCValue/>

Item UC value

 

<EstimatedShipDate/>

Item estimated ship date

 

<ShipDate/>

Item ship date

 

type

Attribute: item ship date type

 

<SupplierOrderId/>

Item supplier order ID

 

</Item>

End tag

X

</Items>

End tag

X

</NAMM_POStatus>

End tag

X

(1) See Appendix A, "Codes Tables".

Advanced Shipping Notice

Advanced Shipping Notice – asn-v2009.2.xml

Tag

Description

Req

<?xml version="1.0" encoding="UTF-8"?>

XML declaration

X

<NAMM_ASN version="2009.2">

File-level Start tag

X

<Id/>

Document ID

X

<Timestamp/>

Date/time stamp for this document

X

<ShipmentHeader>

Start tag

X

<ShipmentType/>

Shipment type description

 

<ShipmentId/>

Supplier ASN document number

X

<Shipped/>

Shipment date

 

<EstDeliver/>

Estimated delivery date

 

<Supplier>

Start tag

X

<PartyId/>

Supplier GLN/NAMM ID

X

<Name/>

Supplier company name

 

<Address>

Start tag

 

<Attn/>

Supplier contact person

 

<Address1/>

Supplier address line 1

 

<Address2/>

Supplier address line 2

<Address3/>

Supplier address line 3

 

<City/>

Supplier city

 

<State/>

Supplier state

 

<PostalCode/>

Supplier postal code

 

<Country/>

Supplier country

 

<CountryCode/>

Supplier country code

 

</Address>

End tag

 

</Supplier>

End tag

X

<ShipFrom>

Start tag

X

<PartyId/>

Shipper GLN/NAMM ID

X

<Name/>

Shipper company name

 

<Address>

Start tag

 

<Attn/>

Shipper contact person

 

<Address1/>

Shipper address line 1

 

<Address2/>

Shipper address line 2

 

<Address3/>

Shipper address line 3

 

<City/>

Shipper city

 

<State/>

Shipper state

 

<PostalCode/>

Shipper postal code

 

<Country/>

Shipper country

 

<CountryCode/>

Shipper country code

 

</Address>

End tag

 

</ShipFrom>

End tag

X

<ShipmentRefs>

Start tag

 

<MasterBOL/>

Shipment master Bill Of Lading number

 

<PRONbr/>

Shipment PRO number

 

<ConfNbr/>

Shipment confirmation number

 

</ShipmentRefs>

End tag

 

<ShipmentQty>

Start tag

X

<ContainerQty/>

Number of units per container

X

<ShipmentItemQty/>

Number of units in shipment

 

</ShipmentQty>

End tag

X

<Volume>

Start tag

 

<VolumeValue/>

Shipment volume value

 

<VolumeUOMCode/>

Volume unit of measure (1)

 

<VolumeUOMDesc/>

Volume unit of measure description (1)

 

</Volume>

End tag

 

<Weight>

Start tag

 

<WeightValue/>

Shipment weight value

 

<WeightUOMCode/>

Weight unit of measure (1)

 

<WeightUOMDesc/>

Weight unit of measure description (1)

 

</Weight>

End tag

 

<TranspCode/>

Transportation code (1)

 

<TranspDesc/>

Transportation description (1)

 

<SoldTo>

Start tag

X

<PartyId/>

Buyer GLN/NAMM ID

X

<Name/>

Buyer company name

 

<Address>

Start tag

 

<Attn/>

Buyer contact person

 

<Address1/>

Buyer address line 1

 

<Address2/>

Buyer address line 2

 

<Address3/>

Buyer address line 3

 

<City/>

Buyer city

 

<State/>

Buyer state

 

<PostalCode/>

Buyer postal code

 

<Country/>

Buyer country

 

<CountryCode/>

Buyer country code

 

</Address>

End tag

 

</SoldTo>

End tag

X

<ShipTo>

Start tag

X

<PartyId/>

Receiver GLN/NAMM ID

X

<Name/>

Receiver company name

 

<Address>

Start tag

 

<Attn/>

Receiver contact person

 

<Address1/>

Receiver address line 1

 

<Address2/>

Receiver address line 2

 

<Address3/>

Receiver address line 3

 

<City/>

Receiver city

 

<State/>

Receiver state

 

<PostalCode/>

Receiver postal code

 

<Country/>

Receiver country

 

<CountryCode/>

Receiver country code

 

</Address>

End tag

 

</ShipTo>

End tag

X

<Vehicle>

Start tag

 

<VehicleId/>

Shipper vehicle ID

 

<VehicleType/>

Shipper vehicle type

 

<SealId/>

Shipper container seal ID

 

</Vehicle>

End tag

 

</ShipmentHeader>

End tag

X

<Orders>

Start tag

X

<Order>

Start tag

X

<BuyerOrderId/>

Buyer purchase order ID

X

<Containers>

Start tag

X

<Container>

Start tag

X

<ContainerId/>

Shipper container ID

 

<ShipperTrackingNumber/>

Shipper tracking number

 

<Item>

Start tag

X

<ItemId>

Start tag

X

<BarCodeId/>

Item digital barcode representation

X

<BarCodeType/>

Item barcode type

X

<BuyerItemId/>

Item buyer ID

X

<BuyerItemDesc/>

Item buyer description

 

<SupplierItemId/>

Supplier item ID

X

<SupplierItemDesc/>

Supplier item description

 

</ItemId>

End tag

X

<POLineNbr/>

Purchase Order line number

X

<ItemQty>

Start tag

X

<Qty/>

Item quantity

X

<ItemUOMCode/>

Item unit of measure (1)

 

<ItemUOMDesc/>

Item unit of measure description (1)

 

</ItemQty>

End tag

X

<ItemAttrs>

Start tag

 

<SerialNbrs>

Start tag

 

<SerialNbr/>

Item serial number

 

</SerialNbrs>

End tag

 

<StdPack>

Start tag

 

<ICQtyPerUOM/>

Inner Carton quantity per Unit of Measure

 

<ICOUM/>

Inner Carton Unit of Measure

 

<StdPackType/>

Item package type

 

</StdPack>

End tag

 

<StdContainer>

Start tag

 

<MCQtyPerUOM/>

Master Carton quantity per Unit of Measure

 

<MCUOM/>

Master Carton Unit of Measure

 

<StdContainerType/>

Item container type

 

</StdContainer>

End tag

 

</ItemAttrs>

End tag

 

</Item>

End tag

 

</Container>

End tag

X

</Containers>

End tag

X

</Order>

End tag

X

</Orders>

End tag

X

</NAMM_ASN>

End tag

X

(1) See Appendix A, "Codes Tables".

Invoice

Invoice – invoice-v2009.2.xml

Tag

Description

Req

<?xml version="1.0" encoding="UTF-8"?>

XML declaration

X

<NAMM_Invoice version="2009.2">

File-level Start tag

X

<InvoiceHeader>

Start tag

X

<Id/>

Document ID

X

<Timestamp/>

Date/time stamp for this document

X

<SoldTo>

Start tag

X

<PartyId/>

Buyer GLN/NAMM ID

X

<Name/>

Buyer company name

 

</SoldTo>

End tag

X

<InvoiceId/>

Vendor invoice number

X

<InvoiceType/>

Invoice type

X

<Supplier>

Start tag

X

<PartyId/>

Supplier GLN/NAMM ID

X

<Name/>

Supplier company name

 

<Address>

Start tag

 

<Attn/>

Supplier contact person

 

<Address1/>

Supplier address line 1

 

<Address2/>

Supplier address line 2

 

<Address3/>

Supplier address line 3

 

<City/>

Supplier city

 

<State/>

Supplier state

 

<PostalCode/>

Supplier postal code

 

<Country/>

Supplier country

 

<CountryCode/>

Supplier country code

 

</Address>

End tag

 

</Supplier>

End tag

X

<RemitTo>

Start tag

X

<PartyId/>

Payee GLN/NAMM ID

X

<Name/>

Payee company name

 

<Address>

Start tag

 

<Attn/>

Payee contact person

 

<Address1/>

Payee address line 1

 

<Address2/>

Payee address line 2

 

<Address3/>

Payee address line 3

 

<City/>

Payee city

 

<State/>

Payee state

 

<PostalCode/>

Payee postal code

 

<Country/>

Payee country

 

<CountryCode/>

Payee country code

 

</Address>

End tag

 

</RemitTo>

End tag

X

<BillTo>

Start tag

X

<PartyId/>

Payor GLN/NAMM ID

X

<Name/>

Payor company name

 

<Address>

Start tag

 

<Attn/>

Payor contact person

 

<Address1/>

Payor address line 1

 

<Address2/>

Payor address line 2

 

<Address3/>

Payor address line 3

 

<City/>

Payor city

 

<State/>

Payor state

 

<PostalCode/>

Payor postal code

 

<Country/>

Payor country

 

<CountryCode/>

Payor country code

 

</Address>

End tag

 

</BillTo>

End tag

X

<ShipTo>

Start tag

X

<PartyId/>

Receiver GLN/NAMM ID

X

<Name/>

Receiver company name

 

<Address>

Start tag

 

<Attn/>

Receiver contact person

 

<Address1/>

Receiver address line 1

 

<Address2/>

Receiver address line 2

 

<Address3/>

Receiver address line 3

 

<City/>

Receiver city

 

<State/>

Receiver state

 

<PostalCode/>

Receiver postal code

 

<Country/>

Receiver country

 

<CountryCode/>

Receiver country code

 

</Address>

End tag

 

</ShipTo>

End tag

X

<TermsCode/>

Terms code (1)

X

<TermsDays/>

Number of days for payment

 

<TermsDate/>

Date payment is due

 

<TermsPercent/>

Percentage terms

 

<TermsPercentDays/>

Number of days for percentage terms

 

<ShipInstructions/>

Shipping instructions

 

<TranspCode/>

Transport method code (1)

 

<TranspDesc/>

Transport description (1)

 

<TranspCarrier/>

Transport carrier name

 

<TranspTime/>

Expected transport time

 

<TranspTerms/>

Transport terms

 

<IncoTermsCode/>

International terms code (1)

 

<IncoTermsDesc/>

International terms description (1)

 

<InvoiceDate/>

Invoice date

X

<InvoiceDueDate/>

Date payment is due

X

<BuyerName/>

Buyer company name

 

<SalesRep/>

Supplier sales representative name

 

<Comments/>

Comments

 

</InvoiceHeader>

End tag

X

<InvoiceSummary>

Start tag

X

<TotalItemLines/>

Invoice number of item lines

X

<TotalItemQty/>

Invoice item quantity

X

<LineTotal/>

Value of all item lines

X

<FreightTotal/>

Freight total amount

X

<SalesTax/>

Sales tax amount

X

<MiscCharge/>

Miscellaneous charges

X

<InvoiceTotal/>

Total invoice amount

X

</InvoiceSummary>

End tag

X

<InvoiceDetail>

Start tag

X

<Items>

Start tag

X

<Item>

Start tag

X

<BuyerOrderId/>

Buyer order ID

X

<SupplierOrderId/>

Supplier order ID

X

<InvoiceLineNbr/>

Invoice item line number

X

<POLineNbr/>

Purchase Order line number

X

<BuyerItemId/>

Buyer item ID

X

<Qty/>

Quantity

X

<QtyUOM/>

Quantity unit of measure (1)

X

<UCValue/>

Unit cost

X

<UCCurrencyCode/>

Unit cost currency code

X

<ExtendedCostValue/>

Extended cost

X

<ExtendedCurrencyCode/>

Extended cost currency code

X

<RetailValue/>

Unit retail value

 

<RetailCurrencyCode/>

Retail value currency code

 

<SupplierItemId/>

Supplier item ID

X

<SupplierItemDesc/>

Supplier item description

X

<PackListNbr/>

Packing list number

 

<ShipmentIds>

Start tag

X

<ShipmentId/>

Shipment ID

X

</ShipmentIds>

End tag

X

<DateShipped/>

Date of shipment

X

<BarCodeId/>

Digital barcode representation

X

<BarCodeType/>

Barcode type

X

</Item>

End tag

X

</Items>

End tag

X

</InvoiceDetail>

End tag

X

</NAMM_Invoice>

End tag

X

(1) See Appendix A, "Codes Tables".

Sell Through

Sell Through – sellthrough-v2012.1.xml

Tag

Description

Req

<?xml version="1.0" encoding="UTF-8" ?>

XML declaration

X

<NAMM_SELLTHROUGH version="2012.1">

File-level Start tag

X

<Id/>

Document ID

X

<Timestamp/>

Date/time stamp for this document

X

<StartDate/>

Start date

X

<EndDate/>

End date

X

<SoldTo>

Start tag

X

<PartyId/>

Buyer GLN/NAMM ID

X

<Name/>

Buyer company name

<Address>

Start tag

 

<Attn/>

Buyer contact person

 

<Address1/>

Buyer address line 1

 

<Address2/>

Buyer address line 2

 

<Address3/>

Buyer address line 3

 

<City/>

Buyer city

 

<State/>

Buyer state

 

<PostalCode/>

Buyer postal code

 

<Country/>

Buyer country

 

<CountryCode/>

Buyer country code

 

</Address>

End tag

 

</SoldTo>

End tag

X

<Supplier>

Start tag

X

<PartyId/>

Supplier GLN/NAMM ID

X

<Name/>

Supplier company name

 

<Address>

Start tag

 

<Attn/>

Supplier contact person

 

<Address1/>

Supplier address line 1

 

<Address2/>

Supplier address line 2

 

<Address3/>

Supplier address line 3

 

<City/>

Supplier city

 

<State/>

Supplier state

 

<PostalCode/>

Supplier postal code

 

<Country/>

Supplier country

 

<CountryCode/>

Supplier country code

 

</Address>

End tag

 

</Supplier>

End tag

X

<Locations>

Start tag

X

<Location>

Start tag

X

LocationID

Attribute: location ID

X

<Items>

Start tag

X

<Item>

Start tag

X

<BuyerItemId/>

Buyer item ID

X

<SupplierItemId/>

Supplier item ID

X

<BarCodeId/>

Item digital barcode representation

X

<BarCodeType/>

Item barcode type

X

<Qty/>

Item quantity

X

<QtyUOM/>

Item quantity per unit of measure

X

<SalesTotal/>

Sales total amount

X

<SalesTotalCurrencyCode/>

Sales total currency code

X

<QtyOnHand/>

Item quantity on hand

</Item>

End tag

X

</Items>

End tag

X

</Location>

End tag

X

</Locations>

End tag

X

</NAMM_SELLTHROUGH>

End tag

X