UN layout formatting specification for UBL Order Cancellation instances

$Date: 2004/09/09 01:30:40 $(UTC)


Contents

1. Order cancellation formatting specification
1.1. Status
1.2. Example rendering
1.3. Layout order and information
1.4. Namespaces
2. Miscellaneous information
3. Party information
3.1. Seller
3.2. Cancellation number
3.3. Date
3.4. Purchase order date
3.5. Buyer’s reference
3.6. Seller’s reference
3.7. Consignee
3.8. Buyer
3.9. Cancellation reason
3.10. Response
3.11. Cancellation notes
3.12. Country of origin
3.13. Country of destination
4. Delivery and transport
4.1. Mode of transport
4.2. Date of despatch
4.3. Means of transport
4.4. Place of despatch
4.5. Vessel/flight No.
4.6. Port of loading
4.7. Port of discharge
4.8. Place of delivery
4.9. Terms of delivery
4.10. Location
4.11. Special terms
4.12. Terms of payment
4.13. Currency of payment
5. Consignment information
5.1. Shipping marks; container number
5.2. No. and kind of packages; description of goods
5.3. Total gross weight (kg)
5.4. Total cube(m3)
5.5. Total net weight (kg)
6. Line item information
6.1. Item / References
6.2. Description
6.3. Country of origin
6.4. Commodity code
6.5. Quantity
6.6. Unit price
7. Summary information
7.1. Name of contact and telephone no.
7.2. Place and date of issue
7.3. Signature

1.  Order cancellation formatting specification

This formatting specification describes a rendering of the UBL Order Cancellation document model according to a subset of the United Nations Layout Key for Trade Documents guidelines for application for the 320 Acknowledgement of Order form:

  • 320 Acknowledgement of Order: Document acknowledging an undertaking to fulfill an order and confirming conditions or acceptance of conditions.

For a list of all formatting specifications and an overview of the documentation conventions, please visit the formatting specification home page.

1.1.  Status

This specification has no formal status at this time. It should not be considered a reference interpretation of UBL documents. Feedback is sought from users of stylesheets that implement this formatting specification regarding suggestions for change for consideration by the OASIS UBL committees for incorporation into these formatting specifications.

Presentational semantics may never be formalized or normative in the UBL project due to differing international requirements and conventions for the presentation of information found in business documents. This document contains only examples from a few of what will probably be many available UBL stylesheet libraries.

1.2.  Example rendering

The following is an example rendering that illustrates the position and decoration of the information items found in an instance of the document type:

1.3.  Layout order and information

Items in this formatting specification are ordered roughly from the laid out fields on the form in the order left-to-right, top to bottom.

Important: the rendering of a number of fields is very simplified, reflecting a Western European interpretation of a subset of fields (as in names and addresses). User requirements need to be better understood for the level of granularity in these formatting specifications.

1.4.  Namespaces

The following namespaces are mapped to the prefixes in the expressions below:

  • xmlns:xo="urn:oasis:names:specification:ubl:schema:xsd:OrderCancellation-1.0"

  • xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-1.0"

  • xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-1.0"

2.  Miscellaneous information

This information shows up in the window-title bar of the HTML browser, and in the document title supported by some XSL-FO processors.

3. Party information

Header information is associated with the form as a whole, not to the individual items of goods.

3.1. Seller

Box Label: "Seller"

Table 1. XPath information

XPath addresses
/​xo:OrderCancellation/​cac:SellerParty/​cac:Party/​cac:PartyName/​cbc:Name
/​xo:OrderCancellation/​cac:SellerParty/​cac:Party/​cac:Address/​cbc:BuildingNumber
/​xo:OrderCancellation/​cac:SellerParty/​cac:Party/​cac:Address/​cbc:StreetName
/​xo:OrderCancellation/​cac:SellerParty/​cac:Party/​cac:Address/​cbc:CityName
/​xo:OrderCancellation/​cac:SellerParty/​cac:Party/​cac:Address/​cbc:CountrySubentity
/​xo:OrderCancellation/​cac:SellerParty/​cac:Party/​cac:Address/​cac:CountrySubentityCode
/​xo:OrderCancellation/​cac:SellerParty/​cac:Party/​cac:Address/​cbc:PostalZone
/​xo:OrderCancellation/​cac:SellerParty/​cac:Party/​cac:Address/​cac:Country/​cbc:Name

Table 2. Box Geometry

row1height6
column1width4

Table 3. Box Borders

line-beforetrue
line-aftertrue
line-starttrue
line-endtrue

This field is intended to show the name and address of the buyer of goods or the originator of the documents, as the case may be.

Note that only one of cbc:CountrySubentity and cac:CountrySubentityCode need be used, with preference to cbc:CountrySubentity if it exists.

3.2. Cancellation number

Box Label: "Cancellation number"

Table 4. XPath information

XPath address
/​xo:OrderCancellation/​xo:ID

Table 5. Box Geometry

row1height2
column5width2

Table 6. Box Borders

line-beforetrue
line-aftertrue
line-starttrue
line-endtrue

This number is a unique number assigned to the order cancellation by the buyer.

3.3. Date

Box Label: "Date"

Table 7. XPath information

XPath address
/​xo:OrderCancellation/​xo:IssueDateTime

Table 8. Box Geometry

row3height2
column5width2

Table 9. Box Borders

line-beforetrue
line-aftertrue
line-starttrue
line-endtrue

This field states the date of the order cancellation.

3.4. Purchase order date

Box Label: "Purchase order date"

Table 10. XPath information

XPath address
/​xo:OrderCancellation/​cac:OrderReference/​cbc:IssueDate

Table 11. Box Geometry

row3height2
column7width2

Table 12. Box Borders

line-beforetrue
line-aftertrue
line-starttrue
line-endtrue

This fields provides the issue date of the original order

3.5. Buyer’s reference

Box Label: "Buyer’s reference"

Table 13. XPath information

XPath address
/​xo:OrderCancellation/​cac:OrderReference/​cac:BuyersID

Table 14. Box Geometry

row5height2
column5width2

Table 15. Box Borders

line-beforetrue
line-aftertrue
line-starttrue
line-endtrue

This field provides the buyer's reference to the original order.

3.6. Seller’s reference

Box Label: "Seller’s reference"

Table 16. XPath information

XPath address
/​xo:OrderCancellation/​cac:OrderReference/​cac:SellersID

Table 17. Box Geometry

row5height2
column7width2

Table 18. Box Borders

line-beforetrue
line-aftertrue
line-starttrue
line-endtrue

This field provides a seller assigned reference to the order corresponding to this order cancellation.

3.7. Consignee

Box Label: "Consignee"

Table 19. Box Geometry

row7height6
column1width4

Table 20. Box Borders

line-beforetrue
line-aftertrue
line-starttrue
line-endtrue

At this time this field is not being used in the order cancellation.

3.8. Buyer

Box Label: "Buyer"

Table 21. XPath information

XPath addresses
/​xo:OrderCancellation/​cac:BuyerParty/​cac:Party/​cac:PartyName/​cbc:Name
/​xo:OrderCancellation/​cac:BuyerParty/​cac:Party/​cac:Address/​cbc:BuildingNumber
/​xo:OrderCancellation/​cac:BuyerParty/​cac:Party/​cac:Address/​cbc:StreetName
/​xo:OrderCancellation/​cac:BuyerParty/​cac:Party/​cac:Address/​cbc:CityName
/​xo:OrderCancellation/​cac:BuyerParty/​cac:Party/​cac:Address/​cbc:CountrySubentity
/​xo:OrderCancellation/​cac:BuyerParty/​cac:Party/​cac:Address/​cac:CountrySubentityCode
/​xo:OrderCancellation/​cac:BuyerParty/​cac:Party/​cac:Address/​cbc:PostalZone
/​xo:OrderCancellation/​cac:BuyerParty/​cac:Party/​cac:Address/​cac:Country/​cbc:Name

Table 22. Box Geometry

row7height6
column5width4

Table 23. Box Borders

line-beforetrue
line-aftertrue
line-starttrue
line-endtrue

These fields are used to provide the name and address of the buyer of the goods involved in the transaction.

Note that only one of cbc:CountrySubentity and cac:CountrySubentityCode need be used, with preference to cbc:CountrySubentity if it exists.

3.9. Cancellation reason

Box Label: "Cancellation reason"

Table 24. XPath information

XPath address
/​xo:OrderCancellation/​xo:CancellationNote

Table 25. Box Geometry

row13height2
column1width4

Table 26. Box Borders

line-beforetrue
line-aftertrue
line-starttrue
line-endtrue

This free format text field is used to provide the reason for the cancellation of the referenced order.

3.10. Response

Box Label: "Response"

Table 27. XPath information

XPath address
/​xo:OrderCancellation/​xo:ResponseRequiredIndicator

Table 28. Box Geometry

row13height2
column5width4

Table 29. Box Borders

line-beforetrue
line-aftertrue
line-starttrue
line-endtrue

This field indicates if the sender of the cancellation requires a response to this message, if the indicator returns true then 'Response Required' would be printed in this form field, if the indicator returns false then 'No Response Required' would be printed.

3.11. Cancellation notes

Box Label: "Cancellation notes"

Table 30. XPath information

XPath address
/​xo:OrderCancellation/​cbc:Note

Table 31. Box Geometry

row15height2
column1width4

Table 32. Box Borders

line-beforetrue
line-aftertrue
line-starttrue
line-endtrue

This free format text field is used to provide any other information that may be relevant to the cancellation.

3.12. Country of origin

Box Label: "Country of origin"

Table 33. Box Geometry

row15height2
column5width2

Table 34. Box Borders

line-beforetrue
line-aftertrue
line-starttrue
line-endtrue

At this time this field is not being used in the order cancellation.

3.13. Country of destination

Box Label: "Country of destination"

Table 35. Box Geometry

row15height2
column7width2

Table 36. Box Borders

line-beforetrue
line-aftertrue
line-starttrue
line-endtrue

At this time this field is not being used in the order cancellation.

4. Delivery and transport

Transportation fields are header-like and applicable to the entire order cancellation.

4.1. Mode of transport

Box Label: "Mode of transport"

Table 37. Box Geometry

row17height2
column1width2

Table 38. Box Borders

line-beforetrue
line-aftertrue
line-starttrue
line-endtrue

At this time this field is not being used in the order cancellation.

4.2. Date of despatch

Box Label: "Date of despatch"

Table 39. Box Geometry

row17height2
column3width2

Table 40. Box Borders

line-beforetrue
line-aftertrue
line-starttrue
line-endtrue

At this time this field is not being used in the order cancellation.

4.3. Means of transport

Box Label: "Means of transport"

Table 41. Box Geometry

row19height2
column1width2

Table 42. Box Borders

line-beforetrue
line-aftertrue
line-starttrue
line-endtrue

At this time this field is not being used in the order cancellation.

4.4. Place of despatch

Box Label: "Place of despatch"

Table 43. Box Geometry

row19height2
column3width2

Table 44. Box Borders

line-beforetrue
line-aftertrue
line-starttrue
line-endtrue

At this time this field is not being used in the order cancellation.

4.5. Vessel/flight No.

Box Label: "Vessel/flight No."

Table 45. Box Geometry

row21height2
column1width2

Table 46. Box Borders

line-beforetrue
line-aftertrue
line-starttrue
line-endtrue

At this time this field is not being used in the order cancellation.

4.6. Port of loading

Box Label: "Port of loading"

Table 47. Box Geometry

row21height2
column3width2

Table 48. Box Borders

line-beforetrue
line-aftertrue
line-starttrue
line-endtrue

At this time this field is not being used in the order cancellation.

4.7. Port of discharge

Box Label: "Port of discharge"

Table 49. Box Geometry

row23height2
column1width2

Table 50. Box Borders

line-beforetrue
line-aftertrue
line-starttrue
line-endtrue

At this time this field is not being used in the order cancellation.

4.8. Place of delivery

Box Label: "Place of delivery"

Table 51. Box Geometry

row23height2
column3width2

Table 52. Box Borders

line-beforetrue
line-aftertrue
line-starttrue
line-endtrue

At this time this field is not being used in the order cancellation.

4.9. Terms of delivery

Box Label: "Terms of delivery"

Table 53. Box Geometry

row17height2
column5width2

Table 54. Box Borders

line-beforetrue
line-after
line-starttrue
line-end

At this time this field is not being used in the order cancellation.

4.10. Location

Box Label: "Location"

Table 55. Box Geometry

row17height2
column7width2

Table 56. Box Borders

line-beforetrue
line-after
line-start
line-endtrue

At this time this field is not being used in the order cancellation.

4.11. Special terms

Box Label: "Special terms"

Table 57. Box Geometry

row19height2
column5width4

Table 58. Box Borders

line-before
line-after
line-starttrue
line-endtrue

At this time this field is not being used in the order cancellation.

4.12. Terms of payment

Box Label: "Terms of payment"

Table 59. Box Geometry

row21height2
column5width2

Table 60. Box Borders

line-before
line-after
line-starttrue
line-end

At this time this field is not being used in the order cancellation.

4.13. Currency of payment

Box Label: "Currency of payment"

Table 61. Box Geometry

row21height2
column7width2

Table 62. Box Borders

line-before
line-after
line-start
line-endtrue

At this time this field is not being used in the order cancellation.

5. Consignment information

The consignment information holds generic details and totals relating to all the goods items in the order cancellation.

5.1. Shipping marks; container number

Box Label: "Shipping marks; container number"

Table 63. Box Geometry

row25height8
column1width2

Table 64. Box Borders

line-beforetrue
line-aftertrue
line-starttrue
line-end

At this time this field is not being used in the order cancellation.

5.2. No. and kind of packages; description of goods

Box Label: "No. and kind of packages; description of goods"

Table 65. Box Geometry

row25height8
column3width4

Table 66. Box Borders

line-beforetrue
line-aftertrue
line-start
line-end

At this time this field is not being used in the order cancellation.

5.3. Total gross weight (kg)

Box Label: "Total gross weight (kg)"

Table 67. Box Geometry

row25height4
column7width1

Table 68. Box Borders

line-beforetrue
line-aftertrue
line-start
line-end

At this time this field is not being used in the order cancellation.

5.4. Total cube(m3)

Box Label: "Total cube(m3)"

Table 69. Box Geometry

row25height4
column8width1

Table 70. Box Borders

line-beforetrue
line-after
line-start
line-endtrue

At this time this field is not being used in the order cancellation.

5.5. Total net weight (kg)

Box Label: "Total net weight (kg)"

Table 71. Box Geometry

row29height4
column7width1

Table 72. Box Borders

line-beforetrue
line-aftertrue
line-starttrue
line-endtrue

At this time this field is not being used in the order cancellation.

6. Line item information

Line item information is associated with the individual item of goods in the order cancellation.

6.1. Item / References

Box Label: "Item / References"

Table 73. Box Geometry

row33height16
column1width1

Table 74. Box Borders

line-beforetrue
line-aftertrue
line-starttrue
line-endtrue

At this time this field is not being used in the order cancellation.

6.2. Description

Box Label: "Description"

Table 75. Box Geometry

row33height16
column2width2

Table 76. Box Borders

line-beforetrue
line-aftertrue
line-starttrue
line-endtrue

At this time this field is not being used in the order cancellation.

6.3. Country of origin

Box Label: "Country of origin"

Table 77. Box Geometry

row15height2
column5width2

Table 78. Box Borders

line-beforetrue
line-aftertrue
line-starttrue
line-endtrue

At this time this field is not being used in the order cancellation.

6.4. Commodity code

Box Label: "Commodity code"

Table 79. Box Geometry

row33height16
column5width1

Table 80. Box Borders

line-beforetrue
line-aftertrue
line-start
line-endtrue

At this time this field is not being used in the order cancellation.

6.5. Quantity

Box Label: "Quantity"

Table 81. Box Geometry

row33height16
column6width1

Table 82. Box Borders

line-beforetrue
line-aftertrue
line-starttrue
line-endtrue

At this time this field is not being used in the order cancellation.

6.6. Unit price

Box Label: "Unit price"

Table 83. Box Geometry

row33height16
column7width1

Table 84. Box Borders

line-beforetrue
line-aftertrue
line-starttrue
line-end

At this time this field is not being used in the order cancellation.

7. Summary information

Summary information is associated to the entire order cancellation.

7.1. Name of contact and telephone no.

Box Label: "Name of contact and telephone no."

Table 85. Box Geometry

row51height2
column6width3

Table 86. Box Borders

line-beforetrue
line-aftertrue
line-starttrue
line-endtrue

These fields provides the contact name and telephone number for this order cancellation.

7.2. Place and date of issue

Box Label: "Place and date of issue"

Table 87. XPath information

XPath addresses
/​xo:OrderCancellation/​cac:BuyerParty/​cac:Party/​cac:Address/​cbc:CityName
/​xo:OrderCancellation/​cac:BuyerParty/​cac:Party/​cac:Address/​cbc:CountrySubentity
/​xo:OrderCancellation/​cac:BuyerParty/​cac:Party/​cac:Address/​cac:CountrySubentityCode
/​xo:OrderCancellation/​xo:IssueDateTime

Table 88. Box Geometry

row53height2
column6width3

Table 89. Box Borders

line-beforetrue
line-aftertrue
line-starttrue
line-endtrue

The above fields provide information relating to the date and place of issue of the order cancellation.

Note that only one of cbc:CountrySubentity and cac:CountrySubentityCode need be used, with preference to cbc:CountrySubentity if it exists.

7.3. Signature

Box Label: "Signature"

Table 90. Box Geometry

row55height2
column6width3

Table 91. Box Borders

line-beforetrue
line-aftertrue
line-starttrue
line-endtrue

This field is not currently being filled automatically as it is a manual entry.