RosettaNet XML Message Guideline
2A12_MG_V01_00_00_ProductMasterNotification.htm (12-Nov-2001  00:00:00)

This document has been prepared by RosettaNet (http://www.rosettanet.org) from requirements
gathered during the cluster/segment workshops and in conformance with the RosettaNet methodology.

 

1

1

fromRole.PartnerRoleDescription

2

1

       |-- ContactInformation

3

1

       |    |-- contactName.FreeFormText

4

1

       |    |-- EmailAddress

5

0..1

       |    |-- facsimileNumber.CommunicationsNumber

6

1

       |    |-- telephoneNumber.CommunicationsNumber

7

1

       |-- GlobalPartnerRoleClassificationCode

8

1

       |-- PartnerDescription

9

1

       |    |-- BusinessDescription

10

1

       |    |    |-- GlobalBusinessIdentifier

11

1

       |    |    |-- GlobalSupplyChainCode

12

1

       |    |-- GlobalPartnerClassificationCode

13

1

GlobalDocumentFunctionCode

14

1

ProductMaster

15

1..n

       |-- ProductMasterLineItem

16

1

       |    |-- GlobalProductUnitOfMeasureCode

17

0..n

       |    |-- PartnerContact

18

1

       |    |    |-- ContactInformation

19

1

       |    |    |    |-- contactName.FreeFormText

20

0..1

       |    |    |    |-- EmailAddress

21

0..1

       |    |    |    |-- facsimileNumber.CommunicationsNumber

22

0..1

       |    |    |    |-- telephoneNumber.CommunicationsNumber

23

0..1

       |    |    |-- ProprietaryContactRoleIdentifier

24

1

       |    |-- ProductAttributeInformation

25

1

       |    |    |-- GlobalAssemblyLevelCode

26

0..1

       |    |    |-- GlobalProductClassificationCode

27

1

       |    |    |-- ProductIdentificationInformation

28

0..1

       |    |    |    |-- GlobalProductIdentifier

29

0..n

       |    |    |    |-- PartnerProductFamilyIdentification

30

1

       |    |    |    |    |-- GlobalPartnerClassificationCode

31

1

       |    |    |    |    |-- ProprietaryProductIdentifier

32

0..1

       |    |    |    |    |-- revisionIdentifier.FreeFormText

33

0..n

       |    |    |    |-- PartnerProductIdentification

34

1

       |    |    |    |    |-- GlobalPartnerClassificationCode

35

1

       |    |    |    |    |-- ProprietaryProductIdentifier

36

0..1

       |    |    |    |    |-- revisionIdentifier.FreeFormText

37

0..1

       |    |    |-- ProprietaryCommodityIdentifier

38

0..1

       |    |    |-- TextualDescription

39

0..1

       |    |    |    |-- detail.FreeFormText

40

0..1

       |    |    |    |-- primary.FreeFormText

41

0..1

       |    |    |    |-- summary.FreeFormText

42

0..1

       |    |-- ProductDistributionInformation

43

1

       |    |    |-- isAvailableToShip.AffirmationIndicator

44

1

       |    |    |-- isWaiverRequiredToShip.AffirmationIndicator

45

0..1

       |    |    |-- safetyStockQuantity.ProductQuantity

46

0..1

       |    |    |-- shippingAvailabilityDate.DatePeriod

47

0..1

       |    |    |    |-- beginDate.DateStamp

48

0..1

       |    |    |    |-- endDate.DateStamp

49

0..1

       |    |-- ProductLifecycleInformation

50

0..1

       |    |    |-- discontinuationDate.DateStamp

51

1

       |    |    |-- GlobalProductLifeCycleStatusCode

52

0..1

       |    |    |-- manufactureDate.DatePeriod

53

0..1

       |    |    |    |-- beginDate.DateStamp

54

0..1

       |    |    |    |-- endDate.DateStamp

55

0..1

       |    |    |-- releasedDate.DateStamp

56

0..1

       |    |-- ProductProcurementInformation

57

0..1

       |    |    |-- ChangeOrderWindow

58

0..1

       |    |    |    |-- cancelOrderWindow.TimeDuration

59

0..1

       |    |    |    |-- changeOrderWindow.TimeDuration

60

0..1

       |    |    |-- GlobalABCCode

61

0..n

       |    |    |-- GlobalProductProcurementTypeCode

62

1

       |    |    |-- isAvailableToOrder.AffirmationIndicator

63

1

       |    |    |-- isOnAllocation.AffirmationIndicator

64

1

       |    |    |-- isWaiverRequiredToOrder.AffirmationIndicator

65

0..1

       |    |    |-- orderingAvailabilityDate.DatePeriod

66

0..1

       |    |    |    |-- beginDate.DateStamp

67

0..1

       |    |    |    |-- endDate.DateStamp

68

0..1

       |    |    |-- orderPolicyDays.CountableAmount

69

0..1

       |    |    |-- OrderQuantity

70

0..1

       |    |    |    |-- minimumOrderQuantity.ProductQuantity

71

0..1

       |    |    |    |-- multipleOrderQuantity.ProductQuantity

72

0..1

       |    |    |    |-- sampleOrderQuantity.ProductQuantity

73

0..n

       |    |    |-- ProductLeadTime

74

1

       |    |    |    |-- GlobalIntervalCode

75

1

       |    |    |    |-- GlobalLeadTimeClassificationCode

76

1

       |    |    |    |-- PeriodNumber

77

0..1

       |    |    |-- scrapPercent.PercentAmount

78

1

thisDocumentGenerationDateTime.DateTimeStamp

79

1

thisDocumentIdentifier.ProprietaryDocumentIdentifier

80

1

toRole.PartnerRoleDescription

81

0..1

       |-- ContactInformation

82

1

       |    |-- contactName.FreeFormText

83

1

       |    |-- EmailAddress

84

0..1

       |    |-- facsimileNumber.CommunicationsNumber

85

1

       |    |-- telephoneNumber.CommunicationsNumber

86

1

       |-- GlobalPartnerRoleClassificationCode

87

1

       |-- PartnerDescription

88

1

       |    |-- BusinessDescription

89

1

       |    |    |-- GlobalBusinessIdentifier

90

1

       |    |    |-- GlobalSupplyChainCode

91

1

       |    |-- GlobalPartnerClassificationCode

 

Guideline Information

7: GlobalPartnerRoleClassificationCode

Entity Instances

Product Information Distributor

 

11, 90: GlobalSupplyChainCode

Entity Instances

Information Technology: The information technology supply chain.
Electronic Components: The electronic components supply chain.

Semiconductor Manufacturing: The semiconductor manufacturing supply chain.

 

12, 30, 34, 91: GlobalPartnerClassificationCode

Entity Instances
Carrier: Product carrier for transporting goods in supply chain.
Distributor: Product distributor in supply chain.
End User: Product end user in supply chain.
End User Government: End user government.
Financier: Financial service provider in supply chain
Manufacturer: Product manufacturer in supply chain.
Retailer: Product retailer in supply chain.
Shopper: Product shopper in supply chain.
Freight Forwarder: Product freight forwarder for transporting goods in supply chain.
Broker: Representative of a third party.
Customs Broker: Product customs broker in supply chain.
Warehouser: Product warehouser in supply chain.
Distribution Center: Product distributor in supply chain.
Contract Manufacturer: The party responsible for the services rendered.
Reseller: A party buys goods from a manufacturer and resells them to customers unchanged.
Original Equipment Manufacturer: Product manufacturer of original equipment in the supply chain.

 

18: GlobalDocumentFunctionCode

Entity Instances
Request: The business document is a request for a business action to be performed by a partner

 

16: GlobalProductUnitOfMeasureCode

Entity Instances
10 Kilogram Drum
10,000 Gallon Tankcar
100 Board Feet
100 Pound Drum
1000-pack
100-Pack
10-pack
115 Kilogram Drum
15 Kilogram Drum
20 Foot Container
20,000 Gallon Tankcar
20-Pack
25 Kilogram Bulk Bag
300 Kilogram Bulk Bag
40 Foot Container
50 Pound Bag
500 Kilogram Bulk Bag
50-pack
55 Gallon Drum
Acre
Actual Pounds
Aluminum Pounds Only
Ampere
Bag
Bale
Ball
Band
Bar
Barrel
Barrel, Imperial
Barrels Per Day
Barrels Per Minute
Base Box
Base Weight
Basket
Batch
Batt
Batting Pound
Beam
Becquerel/kilogram
Belt
Billet
Bin
Block
Board
Board Feet
Bolt
Bottle
Box
British Thermal Unit (BTU)
British Thermal Units (BTUs) Per Cubic Foot
British Thermal Units (BTUs) Per Pound
Bucket
Bulk
Bulk Car Load
Bulk Pack
Bundle
Bunks
Bushel
Bushel, Dry Imperial
Calorie
Can
Candela
Canister
Car
Carat
Carboy
Card
Carload
Carton
Cartridge
Case
Cask
Cassette
Catchweight
Cell
Centiliter
Centimeter
Centipoise (CPS)
Chains (Land Survey)
Chest
Coil
Coil Group
Composite Product Pounds (Total Weight)
Cone
Connector
Container
Cover
Crate
Crate
Cubic centimeter
Cubic centimeter/second
Cubic Foot
Cubic inch
Cubic yard
Cubicmeter
Cup
Cycles
Cylinder
Day
Deal
Decimeter
Degree Celsius
Degree Fahrenheit
Dep. Factor
Die
Disk (Disc)
Dispenser
Display
Dozen
Dram
Drum
Dry Pounds
Each
Electrical Capacitance
Fluid Ounce
Fluid Ounce (Imperial)
Fluid Ounce US
Foot
Fuel Usage (Gallons)
Gage Systems
Gallon
Gigajoules
Gill (Imperial)
Grain
Gram
Gram/Cubic Centimeter
Gram/square meter
Grams Per 100 Centimeters
Grams Per 100 Grams
Grams Per Cubic Centimeter
Grams Per Kilogram
Grams Per Liter
Grams Per Milliliter
Grams Per Square Centimeter
Grams Per Square Meter
Great Gross (Dozen Gross)
Gross
Gross Barrels
Gross Gallons
Gross Kilogram
Gross Ton
Gross Yard
Group
Half Gallon
Half Hour
Half Liter
Hank
Heat lots
Hectare
Hectoliter
Hectopascal
Hertz
Hour
Hours
Hundred Boxes
Hundred Count
Hundred Sheets
Hundredth of a Carat
Imperial Gallons
Inch
Jar
Joint
Joule
Keg
Kelvin
Kiloampere
Kilobecquerel/Kilogram
Kilogram
Kilogram per cubic meter
Kilogram/Kilogram
Kilogram/square meter
Kilogramm pro Sekunde
Kilohertz
Kilojoule
Kilometer
Kilometer/hour
Kiloohm
Kilovolt
Kilowatt
Kilowatt-hour
Kit
Kubikdezimeter
Kubikmeter pro Sekunde
Lifts
Link
Liquid Pounds
Liter
Load
Lot
Lug
Mat
Megagram
Megagrams Per Hour
Megahertz
Megapascal
Megawatt
Meter
Meter pro Quadratsekunde
Meters per second
Micrograms Per Cubic Meter
Micrometer
Microsecond
Mikrogram/cubic meter
Mile
Milliampere
Millibar
Milligram/cubic meter
Milligram/kilogram
Milligram/Liter
Milligrams Per Cubic Meter
Milligrams Per Square Meter
Millijoule
Milliliter
Millimeter
Millimeter H20
Millimol
Millimol/kilogram
Million BTU's
Millipascal seconds
Millisecond
Millitesla
Millivolt
Milliwatt
Minute
Miter
Mol
Mol/kilogram
Month
Multichip
Nanometer
Nanosecond
Net Barrels
Net Gallons
Net Imperial Gallons
Net Liters
Newton
Ohm
One
One Thousand Pieces
Ounce
Ounce
Pack (PAK)
Package
Packet
Pad
Pail
Pair
Pallet
Pallet (Lift)
Pallet/Unit Load
Pallete
Panel
Parcel
Parts per billion (US)
Parts per million
Pascal
Pascal second
Pennyweight
Per Hundred Pieces
Percent
Percent Per 1000 Hours
Percent Weight
Percentage
Piece
Pint - US liquid
Pint U.S. Dry
Plate
Pound
Pounds Per 1000 Square Feet
Pounds Per Foot
Pounds Per Gallon
Pounds Per Piece of Product
Pounds Per Pound of Product
Pounds Per Thousand
Quart - US liquid
Rack
Ream of 500 Sheets
Reel
Ring
Rod
Roll
Sack
Second
SET
Set
Sheet
Sheet-Metric measure
Shipment
Shot
Skein
Skid
Sleeve
Slip Sheet
Spool
Square
Square foot
Square inch
Square kilometer
Square meter
Square meter/second
Square mile
Square millimeter
Square Yard
Statute Mile
Stick
Strip
Super Bulk Bag
Tablet
Tank
Tank Truck
Tesla
Thousand
Ton
Tonne
Torr
Tote
Track Foot
Trailer
Train
Tray
Troy
Troy OZ
Truckload
Tube
Unitless Unit of Measure
US gallon
US pound
US ton
Vial
Volt
Wafer
Watt
Week
WF
Wrap
Yard
Year

 

18: ContactInformation

Constraint At least one of EmailAddress, facsimileNumber or telephoneNumber is mandatory.

 

25: GlobalAssemblyLevelCode

Entity Instances

Top Level Assembly
Phantom: A product that is not currently stocked, assembled or purchased, but does have a Bill of Materials (BOM)
Sub Assembly
Component

 

26: GlobalProductClassificationCode

Entity Instances

UNSPSC codes as published by ECCMA (http://www.eccma.org).

 

27: ProductIdentificationInformation

Constraint At least one occurrence of GlobalProductIdentifier, PartnerProductFamilyIdentification or PartnerProductIdentification is mandatory.

 

38: TextualDescription

Constraint At least one occurrence of detail, primary or summary is mandatory.

 

51: GlobalProductLifecycleStatusCode

Entity Instances

Active
EOL:  End Of Life
Obsolete
On Hold
Unavailable through program

Unreleased

 

57: ChangeOrderWindow

Constraint At least one occurrence of cancelOrderWindow or changeOrderWindow is mandatory.

 

60: GlobalABCCode

Entity Instances

A:  Highest Importance
B:  Medium Importance
C:  Lowest Importance

 

61: GlobalProductProcurementTypeCode

Entity Instances

NCNR: Non-Cancelable, Non-Returnable
Allocation
Supply Split
VMI:  Vendor Management Inventory
Bulk
Sub Contract
JIT: Just in Time
Not Applicable

 

69: OrderQuantity

Constraint At least one occurrence of minimumOrderQuantity, multipleOrderQuantity or sampleOrderQuantity is mandatory.

 

73: ProductLeadTime

Constraint There must be at least one occurrence of ProductLeadTime, unless isOnAllocation is "yes", in which case ProductLeadTime is optional.

 

74: GlobalIntervalCode

Entity Instances

Calendar day: Period given as a number of days including weekends and holidays.
1st week of the month
2nd week of the month
3rd week of the month
4th week of the month
5 day work week: Monday through Friday
5th week of the month
Calendar week: Period given as a number of 7day-weeks including holidays.
Day
Friday
Half month
Half year
Hour
Indefinite: An indefinite period.
Minute
Monday
Monday through Friday
Monday through Saturday
Monday through Sunday
Month
Two week period
Quarter: Period of three months.
Saturday
Sunday
Ten days period: Period of 10 days.
Thursday
Tuesday
Wednesday
Week
Work day
Working days: Days when the partner company normally works.
Year
Half week
Two month period: Period of two months
Four month period: Period of four months

 

75: GlobalLeadTimeClassificationCode

Entity Instances

Dock to Stock

Time period required to move product from a product seller's or product receiver's dock through a warehousing process until the product is documented as available for buyer's use. If the seller's dock is identified, this lead time also includes carrier transit time between seller's dock to buyer's dock.

Procurement

Time period required by a buyer to process a quote or internal demand signal to issue a purchase order.

Assembly

Time period required by a company production line to manufacture a component or module from sub components. This lead time may include actual manufacturing cycle time, testing time, and queuing time.

Transit

Time period required to move a product from one location to another.

Order Processing

Time period required by a seller to receive a purchase order and respond with a confirmation to the buyer.

Market

Time period quoted by a seller for the availability of product. This lead time includes actual manufacturing cycle time and existing sales order queue.

 

86: GlobalPartnerRoleClassificationCode

Entity Instances

Product Information User

 

Business Properties

Name

Definition

fromRole

The role initiating a business document exchange.

contactName

Name of the contact person(s) within the organization.

facsimileNumber

The numerical schema designed to achieve contact via facsimile.

telephoneNumber

The numerical schema designed to achieve contact via telephone.

revisionIdentifier

Free form text that identifies a revision to a proprietary product identifier.

detail

Free form description containing all attributes of the program or product.

primary

The basic attributes that describe a program or product.

summary

Description containing only the most important attributes of a product or program.

isAvailableToShip

Indicates whether the product is available to ship.

isWaiverRequiredToShip

Indicates whether a waiver is required to ship the product.

safetyStockQuantity

The quantity of the Safety Stock

shippingAvailabilityDate

These are the first and last dates the product can be shipped.

beginDate

The start date of a date period.

endDate

The end date of a date period.

discontinuationDate

This is the date that the product must be discontinued from use in a design.

manufactureDate

These are the first and last dates the product will be manufactured.

releasedDate

This is the date that the product converts from a prototype to a released design version status.

cancelOrderWindow

The number of days before the seller's confirmed scheduled ship date that the product buyer can no longer cancel the order.

changeOrderWindow

The number of days before the seller's confirmed scheduled ship date that the product buyer can no longer change the order.

isAvailableToOrder

Indicates whether the product is available to order.

isOnAllocation

Indicates whether the product is on allocation.

isWaiverRequiredToOrder

Indicates whether a waiver is required to order the product.

orderingAvailabilityDate

These are the first and last dates a purchase order can be accepted for a product.

orderPolicyDays

Number of consecutive calendar days of product demand that is added together to determine the quantity to order or to assemble. If product is purchased or assembled in discrete lots, this value will be zero.

minimumOrderQuantity

The minimum order quantity able to be purchased.

multipleOrderQuantity

The ordering multiple for this part.

sampleOrderQuantity

The maximum ordering quantity for samples of this part.

scrapPercent

The expected loss from a lot, batch or run, expressed as percentage. This is the inverse of the expected yield from a lot, batch or run.

thisDocumentGenerationDateTime

The date-time stamp indicating when this document was generated.

thisDocumentIdentifier

Unique tracking identification number that identifies the business document being sent.

toRole

The role receiving the document in a business document exchange.

 

Business Data Entities

Name

Definition

PartnerRoleDescription

The collection of business properties that describes a business partners' role in a partner interface process.

ContactInformation

The collection of business properties that provides communication and address information for contacting a person, organization or business.

PartnerDescription

The collection of business properties that describes a business partners' identity and their function in a supply chain.

BusinessDescription

The collection of business properties that describes a business identity and location.

BusinessIdentification

The collection of business properties that describes a business identity.

PartnerBusinessIdentification

The collection of business properties that describes a business identity in proprietary terms.

ProductMaster

The collection of business properties that describes product master requirements information.

ProductMasterLineItem

The collection of business properties that describes product master requirements information for an individual product.

PartnerContact

The collection of business properties that describes a person to contact at the partner organization and their role with respect to the product.

ProductAttributeInformation

The collection of business properties that describes attributes of the product.

ProductIdentificationInformation

The collection of business properties that describes product identification.

PartnerProductFamilyIdentification

The collection of business properties that describes proprietary product family information.

PartnerProductIdentification

The collection of business properties that describes proprietary part information.

TextualDescription

The collection of business properties in free form text in a specified language.

ProductDistributionInformation

The collection of business properties that describes distribution information about the product.

DatePeriod

The number of days specified by a start and end date stamp.

ProductLifecycleInformation

The collection of business properties that describes lifecycle information about the product.

ProductProcurementInformation

The collection of business properties that describes procurement information about the product.

ChangeOrderWindow

The collection of business properties that describes time constraints for canceling or changing an order once it has been placed.

OrderQuantity

The collection of business properties that describes constraints on the quantities in which the product can be ordered.

ProductLeadTime

The collection of business properties that describes lead time information about the product

 

Fundamental Business Data Entities

Name

Definition

Data Type

Min

Max

Representation

FreeFormText

Unformatted text.

String

1

 

 

EmailAddress

Electronic mail address. 

String

1

 

 

CommunicationsNumber

The electro-technical communication number, e.g., telephone number, facsimile number, pager number.

String

1

30

X(30)

GlobalPartnerRoleClassificationCode

Identifying a partner role within a Supply Chain.  Could be additional value to an existing code table

String

1

 

 

GlobalBusinessIdentifier

A unique business identifier. The DUNS number is specified by RosettaNet.

Integer

9

9

9(9)

ProprietaryBusinessIdentifier

A unique business identifier assigned and administered by a private authority.

String

1

 

 

ProprietaryDomainIdentifier

A descriptor that is used to categorize an organization or business entity that is in the Proprietary Business Identifier.

String

1

 

 

ProprietaryIdentifierAuthority

A unique name that identifies an organization or business entity that is responsible for managing one or more lists of identifiers.

String

1

 

 

GlobalSupplyChainCode

Code identifying the supply chain for the partner's function.

String

1

 

 

GlobalPartnerClassificationCode

Code identifying a partner's function in the supply chain.

String

1

 

 

GlobalDocumentFunctionCode

Code identifying the function of a document as either a request or a response.

String

1

 

 

GlobalProductUnitOfMeasureCode

Code identifying a product unit of measure.

String

1

 

 

ProprietaryContactRoleIdentifier

An internal identifier used to describe the role of the contact in the partner organization with respect to the product, for example, their job title.

String

1

 

 

GlobalAssemblyLevelCode

States that describe the level of assembly

String

1

 

 

GlobalProductClassificationCode

Product classification code. RosettaNet has adopted the UNSPSC.

String

1

 

 

GlobalProductIdentifier

Global unique product identifier. RosettaNet has adopted the Global Trade Identification Number (GTIN).

String

14

14

9(14)

ProprietaryProductIdentifier

An internal identifier used to identify a product.

String

1

 

 

ProprietaryCommodityIdentifier

An internal identifier used to assign a commodity code to a part.

String

1

 

 

AffirmationIndicator

Used to indicate "yes", "no" statements.

String

2

3

 

ProductQuantity

A quantity specifying the number of product units.

Real

1

 

 

DateStamp

Specifies a specific date. Date stamp based on the ISO 8601 specification. The "Z" following the day identifier (DD) is used to indicate Coordinated Universal Time. Informal format: YYYYMMDDZ

Date

9

9

9(8)X

GlobalProductLifecycleStatusCode

States that describe the product lifecycle. 

String

1

 

 

TimeDuration

A relative period of time specified as a single quantity. The lexical representation for this quantity is the [ISO 8601] representation YYYYMMDDThhmmss.sss, preceded by an optional sign (+ or -), where "YYYY" represents the number of years, "MM" the number of months and "DD" the number of days. The letter "T" is the date/time separator and "hh", "mm", "ss.sss" represent number of hours, minutes and seconds respectively. Note that this representation allows for fractional seconds. For example, to indicate a duration of 1 year, 2 months, 3 days, 10 hours, and 30 minutes, one would write: 00010203T103000

String

1

20

S9(8)X9(6)V9(3)

GlobalABCCode

Code identifying manufacturing process classifications for inventory used to communicate inventory importance to a company based upon cost and usage. 

String

1

 

 

GlobalProductProcurementTypeCode

States that describe product procurement conditions.

String

1

 

 

CountableAmount

Dimensionless magnitude, e.g. number of products.

PositiveInteger

1

15

9(15)

GlobalIntervalCode

Code specifying a standard interval

String

1

 

 

GlobalLeadTimeClassificationCode

Code identifying the time period required to move or process product communicated by a seller to a buyer

String

1

 

 

PeriodNumber

The number of measurable units in a date/time period.

NaturalNumber

1

10

9(10)

PercentAmount

Percent

NaturalNumber

1

3

9(3)

ProprietaryBusinessDivisionIdentifier

A proprietary identifier for a business division source site.

String

1

 

 

DateTimeStamp

Specifies an instance in time. Based on the ISO 8601 specification where "YYYY" represents the year, "MM" the month and "DD" the day. The letter "T" is the date/time separator and "hh", "mm", "ss.sss" represent hour, minute and second respectively. This representation is immediately followed by a "Z" to indicate Coordinated Universal Time. Informal format: YYYYMMDDThhmmss

DateTime

13

20

9(8)X9(6)V9(3)X

ProprietaryDocumentIdentifier

Unique identifier, i.e. a numeric value or alpha-numeric value, for a business document.

String

1