PO – ForSea Document Fields Table
Tip
New to ForSea? Read the Document Linking guide first to understand how RFQ → Quote → PO → POC connect before using this table.
Table 14: Interchange Section
| Field Name | XML Example | Description |
|---|---|---|
| Sender | <Sender="11934"/> |
Required, TradeNetID of the sender. [Format – Number] |
| Recipient | <Recipient="58848"/> |
Required, TradeNetID of the recipient. [Format – Number] |
| Identifier | <Identifier="UNOC"/> |
Required, Needs to be hardcoded [Format – String] |
| Version Number | <VersionNumber="2"/> |
Required, Needs to be hardcoded [Format – String] |
| Preparation Date | <PreparationDate="20240521"/> |
Required, Date the document was prepared [Format – YYYYMMDD] |
| Preparation Time | <PreparationTime="0800"/> |
Required, Time the document was prepared [Format – HHMM] |
| Control Reference | <ControlReference="77806413696413"/> |
Required, Unique reference identifying the document. [Format – String] |
| Sender Code Qualifier | <SenderCodeQualifier="ZEX"/> |
Required, Needs to be hardcoded [Format – String] |
| Recipient Code Qualifier | <RecipientCodeQualifier="ZEX"/> |
Required, Needs to be hardcoded [Format – String] |
Table 15: Order Section
| Field Name | XML Example | Description |
|---|---|---|
| Currency Code | <CurrencyCode="EUR"/> |
Required, Currency of the order. |
| Function Code | <FunctionCode="_9"/> |
• 1 - Cancellation. It is advised to send the entire message again when cancelling a message, including a reference to the cancelled message in a Reference message segment with qualifier=ACW. • 5 - Replacement. When replacing a message, the complete message should be sent, reference the message to be replaced in a Reference message segment with qualifier=ACW. • 9 – Original Required, Function of the order (e.g., _9 = New Order). |
| Line Item Count | <LineItemCount="1"/> |
Required, Total number of line items in the order. [Format – Number] |
| Message Number | <MessageNumber="27524V00010"/> |
Required, Message Number. Must match Supplier Quote MessageNumber. [Format – String] |
| Release Number | <ReleaseNumber="96A"/> |
Required, Needs to be hardcoded [Format – String] |
| Priority | <Priority="High"/> |
Optional, Priority of the order. [Format – String] |
| Version Number | <VersionNumber="D"/> |
Required, Needs to be hardcoded [Format – String] |
| Controlling Agency | <ControllingAgency="UN"/> |
Required, Needs to be hardcoded [Format – String] |
| Delivery Terms Code | <DeliveryTermsCode="EXW"/> |
Optional, Compliant systems will contain INCOTERMS 1990 standard. |
| Transport Mode Code | <TransportModeCode="_1"/> |
Optional, Mode of transport for the order. [Format – String] |
| Message Reference Number | <MessageReferenceNumber="960390800010128"/> |
Optional, Reference to other related messages. [Format – String] |
| Association Assigned Code | <AssociationAssignedCode="MARL10"/> |
Required, Needs to be hardcoded [Format – String] |
Table 16: DateTimePeriod Section
| Field Name | XML Example | Description |
|---|---|---|
| Vessel ETA | <DateTimePeriod Value="202405230000" Qualifier="_132" FormatQualifier="_203"/> |
Optional, Estimated Arrival (local time) [Format – YYYYMMDDHHMM] |
| Vessel ETD | <DateTimePeriod Value="202405300000" Qualifier="_133" FormatQualifier="_203"/> |
Optional, Estimated Departure (local time) [Format – YYYYMMDDHHMM] |
| Advise By | <DateTimePeriod Value="202405230800" Qualifier="_2" FormatQualifier="_203"/> |
Optional, Advise Before (GMT) [Format – YYYYMMDDHHMM] |
| Requested Delivery Date | <DateTimePeriod Value="202405230800" Qualifier="_175" FormatQualifier="_203"/> |
Optional, Requested Delivery Date (local time). [Format – YYYYMMDDHHMM] |
| Document Date | <DateTimePeriod Value="202405210000" Qualifier="_137" FormatQualifier="_203"/> |
Required, Preparation date and time of the document, assigned by purchaser system when created. [Format – YYYYMMDDHHMM] |
Table 17: Parties Section
| Field Name | XML Example | Description |
|---|---|---|
| Buyer - BY | <Party Name="Aiden Smith Ltd BY" Qualifier="BY"> |
Required, Details of the buyer. [Format – String] |
| Street Address (Buyer) | <StreetAddress>7783 Palm Ave, San Diego, CA 92109</StreetAddress> |
Optional, Buyer's address. [Format – String] |
| Contact (Buyer) | <Contact Name="Aiden Smith" FunctionCode="PD"> |
Optional, Contact person for the buyer. [Format – String] |
| Communication Method (Buyer - TE) | <CommunicationMethod Number="BY (312) 667-9052" Qualifier="TE"/> |
Optional, Buyer's phone number. [Format – String] |
| Communication Method (Buyer - FX) | <CommunicationMethod Number="BY (312) 667-9053" Qualifier="FX"/> |
Optional, Buyer's fax number. [Format – String] |
| Communication Method (Buyer - EM) | <CommunicationMethod Number="aiden.smith@example.com" Qualifier="EM"/> |
Optional, Buyer's email address. [Format – String] |
| Consignee - CN | <Party Name="Emily Johnson Ltd CN" Qualifier="CN"> |
Required, Details of the consignee. [Format – String] |
| Street Address (Consignee) | <StreetAddress>Consignee Address 112 Oak Street, Eugene, OR 97401</StreetAddress> |
Optional, Consignee's address. [Format – String] |
| Contact (Consignee) | <Contact Name="Lucas Gray CONSIGNEE CONTACT NAME" FunctionCode="PD"> |
Optional, Contact person for the consignee. [Format – String] |
| Communication Method (Consignee - TE) | <CommunicationMethod Number="CN (541) 752-3236" Qualifier="TE"/> |
Optional, Consignee's phone number. [Format – String] |
| Communication Method (Consignee - FX) | <CommunicationMethod Number="CN (541) 752-3237" Qualifier="FX"/> |
Optional, Consignee's fax number. [Format – String] |
| Communication Method (Consignee - EM) | <CommunicationMethod Number="lucas.gray@example.com" Qualifier="EM"/> |
Optional, Consignee's email address. [Format – String] |
| Vendor - VN | <Party Name="ALEX VN" Qualifier="VN"> |
Required, Details of the vendor. [Format – String] |
| Street Address (Vendor) | <StreetAddress>58 Birchwood Drive, #20-03</StreetAddress> |
Optional, Vendor's address. [Format – String] |
| Contact (Vendor) | <Contact Name="ALEX TEST SUPPLIER" FunctionCode="SR"> |
Optional, Contact person for the vendor. [Format – String] |
| Communication Method (Vendor - TE) | <CommunicationMethod Number="VN (702) 555-4389" Qualifier="TE"/> |
Optional, Vendor's phone number. [Format – String] |
| Communication Method (Vendor - FX) | <CommunicationMethod Number="VN (702) 555-4390" Qualifier="FX"/> |
Optional, Vendor's fax number. [Format – String] |
| Communication Method (Vendor - EM) | <CommunicationMethod Number="william.brown@example.com" Qualifier="EM"/> |
Optional, Vendor's email address. [Format – String] |
| Invoice - IV | <Party Name="ALEX TEST BUYER" Qualifier="IV" CountryCode="CY"> |
Required, Details of the invoice recipient. [Format – String] |
| Street Address (Invoice) | <StreetAddress>ALEX TEST BUYER</StreetAddress> |
Optional, Invoice recipient's address. [Format – String] |
| Contact (Invoice) | <Contact Name="" FunctionCode="SR"> |
Optional, Contact person for the invoice recipient. |
| Communication Method (Invoice - TE) | <CommunicationMethod Number="BA (413) 774-6201" Qualifier="TE"/> |
Optional, Invoice recipient's phone number. [Format – String] |
| Communication Method (Invoice - FX) | <CommunicationMethod Number="BA (413) 774-6202" Qualifier="FX"/> |
Optional, Invoice recipient's fax number. [Format – String] |
| Communication Method (Invoice - EM) | <CommunicationMethod Number="alexander.davis@example.com" Qualifier="EM"/> |
Optional, Invoice recipient's email address. [Format – String] |
| Vessel - UD | <Party Name="M/V Pythagoras" Qualifier="UD" Identification="5980127"> |
Required, Details of the vessel, including its unique identification. [Format – String] |
| PartyLocation | <PartyLocation Port="Amsterdam" Qualifier="ZUC"/> |
Optional, Port location for the vessel. [Format – String] |
Table 18: Comments Section
| Field Name | XML Example | Description |
|---|---|---|
| Payment Terms | <Comments Qualifier="ZTP"><Value>45 DAYS NET - CONDITION: PREVIOUS OUTSTANDINGS REPAID</Value></Comments> |
Optional, Payment terms for the order. [Format – String] |
| Purchasing Terms | <Comments Qualifier="ZTC"><Value>GENERAL PURCHASING TERMS FROM PURCHASER</Value></Comments> |
Optional, General terms from the purchaser. [Format – String] |
| PO Stage | <Comments Qualifier="PUR"><Value>COMMENTS FROM PURCHASER AT PO STAGE</Value></Comments> |
Optional, Comments specific to the purchase order stage. |
| Additional Info | <Comments Qualifier="ZAT"><Value>RADIO & PENS/PENCILS</Value></Comments> |
Optional, Additional notes or instructions. [Format – String] |
Table 19: References Section
| Field Name | XML Example | Description |
|---|---|---|
| Reference (UC) | <Reference Qualifier="UC" ReferenceNumber="{BuyerOrderNumber}"/> |
UC – Buyer’s Order Number. Must be included in PO.XML. [Format – String] |
| Reference (AAG) | <Reference Qualifier="AAG" ReferenceNumber="{SupplierQuotationNumber}"/> |
AAG – Supplier’s Quotation Number (as provided in the supplier quote payload). Must be included in PO.XML to reference the awarded supplier quote. [Format – String] |
Note: UC must contain the buyer’s Order Number. AAG must contain the supplier’s Quotation Number exactly as received in the supplier quotation payload. ON must not be used in PO.XML, as it is not a valid qualifier under MTML PO.
Table 20: Line Items Section
| Field Name | XML Example | Description |
|---|---|---|
| Line Item (1) | <LineItem Number="1" Quantity="1" TypeCode="BP" Description="Walkie-Talkie 3000X" Identification="994C4158414E4445501" MonetaryAmount="1" MeasureUnitQualifier="PCE"/> |
Required, Details of the first line item. [Format – String] |
| Comments (Line Item 1) | <Comments Qualifier="LIN"><Value>Also comments on this Line Item</Value></Comments> |
Optional, Additional comments specific to the first line item. [Format – String] |
| Section Details (Line Item 1) | <Section Name="Name Comments" ModelNumber="Model Comments" Manufacturer="Manufacturer Comments" SerialNumber="Serial # Comments" DepartmentType="Department M10 Comments"/> |
Optional, Additional section details for the line item. [Format – String] |
| Price Details (Line Item 1 - Gross) | <PriceDetails Value="1" TypeCode="QT" Qualifier="CAL" TypeQualifier="GRP"/> |
Optional, Pricing details for the first line item (gross price). [Format – Number] |
| Price Details (Line Item 1 - Discount) | <PriceDetails Value="0" TypeCode="QT" Qualifier="CAL" TypeQualifier="DPR"/> |
Optional, Line item discounts are represented as an amount per unit in MTML [Format – Number] |
Table 21: Monetary Amount Section
| Field Name | XML Example | Description |
|---|---|---|
| Freight Cost | <MonetaryAmount Qualifier="_64" Value="0"/> |
Optional, Details of quoted freight price, if any [Format – Number] |
| Line-Item Amount | <MonetaryAmount Qualifier="_79" Value="2"/> |
Required, Total line items amount. Sum of all line item monetary amounts [Format – Number] |
| Packaging Cost | <MonetaryAmount Qualifier="_106" Value="0"/> |
Optional, Details of quoted packaging cost, if any [Format – Number] |
| Discount (%) | <MonetaryAmount Qualifier="_204" Value="0"/> |
Optional, Discounted amount. For discounts not covered by line item discounts. Stored in the database as a percentage amount. [Format – Number] |
| Total Charge | <MonetaryAmount Qualifier="_259" Value="2"/> |
Required, Total charges: Total [Line Item Amount] + [Packaging Cost] + [Freight Cost] – [Discount (%)]. [Format – Number] |
Table 13-21: Contains all PO Web fields, their corresponding MTML Fields and some comments