<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE article [
<!ENTITY % nsuri SYSTEM "nsuri.ent">
%nsuri;
]>
<article>
<title>UN aligned layout formatting specification for UBL Order Response Simple instances</title>
<articleinfo>
<copyright><year>2004</year><holder>OASIS</holder></copyright>
<pubdate>$Date: 2004/09/09 01:30:40 $(UTC)</pubdate>
</articleinfo>
<section>
<title>
Order response simple formatting specification</title>
<para>
This formatting specification describes a rendering of the UBL Order Response Simple 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:</para>
<itemizedlist>
<listitem><para>
320 Acknowledgement of Order: Document acknowledging an undertaking to fulfill an order and confirming conditions or acceptance of conditions.</para>
</listitem>
</itemizedlist>
<para>
For a list of all formatting specifications and an overview of the documentation conventions, please visit the <ulink url="../index.html">formatting specification home page</ulink>.</para>
<section>
<title>
Status</title>
<para>
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.</para>
<para>
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.</para>
</section>

<section>
<title>
Example rendering</title>
<para>
The following is an example rendering that illustrates the position and decoration of the information items found in an instance of the document type:</para>
<itemizedlist>
<listitem><para>
PDF printable format (A4 page size)</para>
<itemizedlist>
<listitem><para>
<ulink url="pdf/UN320OrderResponseSimple.Example-a4.pdf"><literal>UN320OrderResponseSimple.Example-a4.pdf</literal></ulink></para>
</listitem>
</itemizedlist>
</listitem>
<listitem><para>
PDF printable format (US-letter page size)</para>
<itemizedlist>
<listitem><para>
<ulink url="pdf/UN320OrderResponseSimple.Example-us.pdf"><literal>UN320OrderResponseSimple.Example-us.pdf</literal></ulink></para>
</listitem>
</itemizedlist>
</listitem>
<!--
<listitem><para>
PDF printable format (US letter page size)</para>
<itemizedlist>
<listitem><para>
<ulink url="samples/UN632ReceiptAdvice.UN632ReceiptAdviceInstance1-us.pdf"><literal>UN632ReceiptAdvice.UN632ReceiptAdviceInstance1-us.pdf</literal></ulink></para>
</listitem>
</itemizedlist>
</listitem>
<listitem><para>
HTML browser format</para>
<itemizedlist>
<listitem><para>
<ulink url="samples/UN632ReceiptAdvice.UN632ReceiptAdviceInstance1.html"><literal>UN632ReceiptAdvice.UN632ReceiptAdviceInstance1.html</literal></ulink></para>
</listitem>
</itemizedlist>
</listitem>
-->
</itemizedlist>
</section>
<section>
<title>
Layout order and information</title>
<para>
At this stage, the layout has been created as no official layout is available.</para>
<para>
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.</para>
<para>
Certain descriptions are verbatim quotes from the United Nations guidelines document.</para>
<para>
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.</para>
</section>
<section>
<title>
Namespaces</title>
<para>
The following namespaces are mapped to the prefixes in the expressions below:</para>
<itemizedlist>
<listitem><para>
<literal>&ns-rs;</literal></para>
</listitem>
<listitem><para>
<literal>&ns-cac;</literal></para>
</listitem>
<listitem><para>
<literal>&ns-cbc;</literal></para>
</listitem>
</itemizedlist>
</section>
</section>
<section role="items">
<title>
Miscellaneous information</title>
<para>
The following information is unrelated to the visible fields of the form.</para>
<section role="item">
<title>
Document header information</title>
<table role="xpath"><title>XPath information</title><tgroup cols="1"><tbody><row><entry role="groups"/><entry role="rows"/><entry role="cols"/><entry role="xpath"><literal>/rs:OrderResponseSimple/cac:OrderReference/cac:SellersID</literal></entry></row><row><entry role="groups"/><entry role="rows"/><entry role="cols"/><entry role="xpath"><literal>/rs:OrderResponseSimple/cbc:IssueDate</literal></entry></row></tbody></tgroup></table>
<para>
This information shows up in the window-title bar of the HTML browser, and in the document title supported by some XSL-FO processors.</para>
</section>
</section>

<section role="items">
<title>Party information</title>
<para>Header information is associated with the form as a whole, not to the individual items of goods.</para>
<section role="item">
<title>Seller</title>
<table role="xpath"><title>XPath information</title><tgroup cols="1"><tbody><row><entry role="groups"/><entry role="rows"/><entry role="cols"/><entry role="xpath">
<literal>/rs:OrderResponseSimple/cac:SellerParty/cac:Party/cac:PartyName/cbc:Name</literal>
</entry></row><row><entry role="groups"/><entry role="rows"/><entry role="cols"/><entry role="xpath">
<literal>/rs:OrderResponseSimple/cac:SellerParty/cac:Party/cac:Address/cbc:BuildingNumber</literal>
</entry></row><row><entry role="groups"/><entry role="rows"/><entry role="cols"/><entry role="xpath">
<literal>/rs:OrderResponseSimple/cac:SellerParty/cac:Party/cac:Address/cbc:StreetName</literal>
</entry></row><row><entry role="groups"/><entry role="rows"/><entry role="cols"/><entry role="xpath">
<literal>/rs:OrderResponseSimple/cac:SellerParty/cac:Party/cac:Address/cbc:CityName</literal>
</entry></row><row><entry role="groups"/><entry role="rows"/><entry role="cols"/><entry role="xpath">
<literal>/rs:OrderResponseSimple/cac:SellerParty/cac:Party/cac:Address/cbc:CountrySubentity</literal>
</entry></row><row><entry role="groups"/><entry role="rows"/><entry role="cols"/><entry role="xpath">
<literal>/rs:OrderResponseSimple/cac:SellerParty/cac:Party/cac:Address/cac:CountrySubentityCode</literal>
</entry></row><row><entry role="groups"/><entry role="rows"/><entry role="cols"/><entry role="xpath">
<literal>/rs:OrderResponseSimple/cac:SellerParty/cac:Party/cac:Address/cbc:PostalZone</literal>
</entry></row><row><entry role="groups"/><entry role="rows"/><entry role="cols"/><entry role="xpath">
<literal>/rs:OrderResponseSimple/cac:SellerParty/cac:Party/cac:Address/cac:Country/cbc:Name</literal>
</entry></row></tbody></tgroup></table>
<para>This field is intended to show the name and address of the
sender of goods or the originator of the documents, as the case may
be.</para>
<para>Note that only one of <literal>cbc:CountrySubentity</literal> and <literal>cac:CountrySubentityCode</literal> need be used, with preference to <literal>cbc:CountrySubentity</literal> if it exists.</para>
</section>
<section role="item">
<title>Seller's reference</title>
<table role="xpath"><title>XPath information</title><tgroup cols="1"><tbody><row><entry role="groups"/><entry role="rows"/><entry role="cols"/><entry role="xpath">
<literal>/rs:OrderResponseSimple/cac:OrderReference/cac:SellersID</literal>
</entry></row></tbody></tgroup></table>
<para>This number is a unique number assigned to the order response simple by the seller.</para>
</section>
<section role="item">
<title>Date</title>
<table role="xpath"><title>XPath information</title><tgroup cols="1"><tbody><row><entry role="groups"/><entry role="rows"/><entry role="cols"/><entry role="xpath">
<literal>/rs:OrderResponseSimple/cbc:IssueDate</literal>
</entry></row></tbody></tgroup></table>
<para>This field states the date of the order response simple.</para>
</section>
<section role="item">
<title>Buyer's reference</title>
<table role="xpath"><title>XPath information</title><tgroup cols="1"><tbody><row><entry role="groups"/><entry role="rows"/><entry role="cols"/><entry role="xpath">
<literal>/rs:OrderResponseSimple/cac:OrderReference/cac:BuyersID</literal>
</entry></row></tbody></tgroup></table>
<para>This field provides a reference to the original order.</para>
</section>
<section role="item">
<title>Purchase order date</title>
<table role="xpath"><title>XPath information</title><tgroup cols="1"><tbody><row><entry role="groups"/><entry role="rows"/><entry role="cols"/><entry role="xpath">
<literal>/rs:OrderResponseSimple/cac:OrderReference/cbc:IssueDate</literal>
</entry></row></tbody></tgroup></table>
<para>This field provides the issue date of the original order.</para>
</section>
<section role="item">
<title>Consignee</title>
<para>At this time this field is not being used in the order response simple.</para>
</section>
<section role="item" id="buyer">
<title>Buyer</title>
<table role="xpath"><title>XPath information</title><tgroup cols="1"><tbody><row><entry role="groups"/><entry role="rows"/><entry role="cols"/><entry role="xpath">
<literal>/rs:OrderResponseSimple/cac:BuyerParty/cac:Party/cac:PartyName/cbc:Name</literal>
</entry></row><row><entry role="groups"/><entry role="rows"/><entry role="cols"/><entry role="xpath">
<literal>/rs:OrderResponseSimple/cac:BuyerParty/cac:Party/cac:Address/cbc:BuildingNumber</literal>
</entry></row><row><entry role="groups"/><entry role="rows"/><entry role="cols"/><entry role="xpath">
<literal>/rs:OrderResponseSimple/cac:BuyerParty/cac:Party/cac:Address/cbc:StreetName</literal>
</entry></row><row><entry role="groups"/><entry role="rows"/><entry role="cols"/><entry role="xpath">
<literal>/rs:OrderResponseSimple/cac:BuyerParty/cac:Party/cac:Address/cbc:CityName</literal>
</entry></row><row><entry role="groups"/><entry role="rows"/><entry role="cols"/><entry role="xpath">
<literal>/rs:OrderResponseSimple/cac:BuyerParty/cac:Party/cac:Address/cbc:CountrySubentity</literal>
</entry></row><row><entry role="groups"/><entry role="rows"/><entry role="cols"/><entry role="xpath">
<literal>/rs:OrderResponseSimple/cac:BuyerParty/cac:Party/cac:Address/cac:CountrySubentityCode</literal>
</entry></row><row><entry role="groups"/><entry role="rows"/><entry role="cols"/><entry role="xpath">
<literal>/rs:OrderResponseSimple/cac:BuyerParty/cac:Party/cac:Address/cbc:PostalZone</literal>
</entry></row><row><entry role="groups"/><entry role="rows"/><entry role="cols"/><entry role="xpath">
<literal>/rs:OrderResponseSimple/cac:BuyerParty/cac:Party/cac:Address/cac:Country/cbc:Name</literal>
</entry></row></tbody></tgroup></table>
<para>These fields are used to provide the name and address of the buyer of the goods involved in the transaction.</para>
<para>Note that only one of <literal>cbc:CountrySubentity</literal> and <literal>cac:CountrySubentityCode</literal> need be used, with preference to <literal>cbc:CountrySubentity</literal> if it exists.</para>
</section>

<section role="item">
<title>Rejection reason / Rejection note</title>
<table role="xpath"><title>XPath information</title><tgroup cols="1"><tbody><row><entry role="groups"/><entry role="rows"/><entry role="cols"/><entry role="xpath">
<literal>/rs:OrderResponseSimple/rs:RejectionNote</literal>
</entry></row></tbody></tgroup></table>
<para>This field provides free text information relating to the order response simple.</para>
</section>

<section role="item">
<title>Order response status</title>
<table role="xpath"><title>XPath information</title><tgroup cols="1"><tbody><row><entry role="groups"/><entry role="rows"/><entry role="cols"/><entry role="xpath">
<literal>/rs:OrderResponseSimple/rs:DocumentStatusCode</literal>
</entry></row></tbody></tgroup></table>
<para>This field provides the status of the order response simple, the response status code should be translated into text form for clarity.</para>
</section>

<section role="item">
<title>Country of origin</title>
<para>At this time this field is not being used in the order response simple.</para>
</section>
<section role="item">
<title>Country of destination</title>
<para>At this time this field is not being used in the order response simple.</para>
</section>
</section>
<section role="items">
<title>Delivery and transport</title>
<para>Transportation fields are header-like and applicable to the
entire order response simple.</para>
<section role="item">
<title>Mode of transport</title>
<para>At this time this field is not being used in the order response simple.</para>
</section>
<section role="item">
<title>Date of despatch</title>
<para>At this time this field is not being used in the order response simple.</para>
</section>
<section role="item">
<title>Means of transport</title>
<para>At this time this field is not being used in the order response simple.</para>
</section>
<section role="item">
<title>Place of despatch</title>
<para>At this time this field is not being used in the order response simple.</para>
</section>
<section role="item">
<title>Vessel/flight no.</title>
<para>At this time this field is not being used in the order response simple.</para>
</section>
<section role="item">
<title>Port of loading</title>
<para>At this time this field is not being used in the order response simple.</para>
</section>
<section role="item">
<title>Port of discharge</title>
<para>At this time this field is not being used in the order response simple.</para>
</section>
<section role="item">
<title>Place of delivery</title>
<para>At this time this field is not being used in the order response simple.</para>
</section>
<section role="item">
<title>Terms of delivery</title>
<para>At this time this field is not being used in the order response simple.</para>
</section>
<section role="item">
<title>Location</title>
<para>At this time this field is not being used in the order response simple.</para>
</section>
<section role="item">
<title>Special terms</title>
<para>At this time this field is not being used in the order response simple.</para>
</section>
<section role="item">
<title>Terms of payment</title>
<para>At this time this field is not being used in the order response simple.</para>
</section>
<section role="item">
<title>Currency of payment</title>
<para>At this time this field is not being used in the order response simple.</para>
</section>
</section>
<section role="items">
<title>Consignment information</title>
<para>The consignment information holds generic details and totals relating to all the goods items in the order response simple.</para>
<section role="item">
<title>Shipping marks; container number</title>
<para>At this time this field is not being used in the order response simple.</para>
</section>
<section role="item">
<title>No. and kind of packages; description of goods</title>
<para>At this time this field is not being used in the order response simple.</para>
</section>
<section role="item">
<title>Total gross weight (kg)</title>
<para>At this time this field is not being used in the order response simple.</para>
</section>
<section role="item">
<title>Total cube (m3)</title>
<para>At this time this field is not being used in the order response simple.</para>
</section>
<section role="item">
<title>Total net weight (kg)</title>
<para>At this time this field is not being used in the order response simple.</para>
</section>
</section>
<section role="items" id="lineitem">
<title>Line item information</title>
<para>Line item information is associated with the individual item of goods in the order response simple.</para>

<section role="item">
<title>Item / References</title>
<para>At this time this field is not being used in the order response simple.</para>
</section>
<section role="item">
<title>Description</title>
<para>At this time this field is not being used in the order response simple.</para>
</section>
<section role="item">
<title>Country of origin</title>
<para>At this time this field is not being used in the order response simple.</para>
</section>
<section role="item">
<title>Commodity code</title>
<para>At this time this field is not being used in the order response simple.</para>
</section>
<section role="item">
<title>Quantity</title>
<para>At this time this field is not being used in the order response simple.</para>
</section>
<section role="item">
<title>Unit price</title>
<para>At this time this field is not being used in the order response simple.</para>
</section>
</section>

<section role="items">
<title>Summary information</title>
<para>Summary information is associated to the entire order response simple.</para>
<section role="item">
<title>Notes</title>
<table role="xpath"><title>XPath information</title><tgroup cols="1"><tbody><row><entry role="groups"/><entry role="rows"/><entry role="cols"/><entry role="xpath">
<literal>/rs:OrderResponseSimple/cbc:Note</literal>
</entry></row>
</tbody></tgroup></table>
<para>This notes field is used for any free text information that relates to the entire order response simple.</para>
</section>

<section role="item">
<title>Seller's company and telephone no.</title>
<table role="xpath"><title>XPath information</title><tgroup cols="1"><tbody><row><entry role="groups"/><entry role="rows"/><entry role="cols"/><entry role="xpath">
<literal>/rs:OrderResponseSimple/cac:SellerParty/cac:Party/cac:PartyName/cbc:Name</literal>
</entry></row><row><entry role="groups"/><entry role="rows"/><entry role="cols"/><entry role="xpath">
<literal>/rs:OrderResponseSimple/cac:SellerParty/cac:Party/cac:Contact/cbc:Telephone</literal>
</entry></row></tbody></tgroup></table>
<para>These fields identified the name of the seller's company and a contact telephone number.</para>
</section>
<section role="item">
<title>Name of contact</title>
<table role="xpath"><title>XPath information</title><tgroup cols="1"><tbody><row><entry role="groups"/><entry role="rows"/><entry role="cols"/><entry role="xpath">
<literal>/rs:OrderResponseSimple/cac:SellerParty/cac:Party/cac:Contact/cbc:Name</literal>
</entry></row></tbody></tgroup></table>
<para>This field identified the name of the seller's contact.</para>
</section>

<section role="item">
<title>Date</title>
<table role="xpath"><title>XPath information</title><tgroup cols="1"><tbody><row><entry role="groups"/><entry role="rows"/><entry role="cols"/><entry role="xpath">
<literal>/rs:OrderResponseSimple/cbc:IssueDate</literal>
</entry></row></tbody></tgroup></table>
<para>This field provide the date of issue of the order response simple.</para>
</section>
<section role="item">
<title>Signature</title>
<para>This field is not currently being filled automatically as it is a manual entry.</para>
</section>
</section>
</article>
