Table of Contents

Quote – 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 6: Interchange

Field Name XML Example Description
Control Reference <ControlReference="QN270524-1"/> Required, This will be returned as AAG Reference on the PO if the PO was awarded from this Quote. [Format – String]
Identifier <Identifier="UNOC"/> Required, Needs to be hardcoded [Format – String]
Preparation Date <PreparationDate="240527"/> Required, Date the document was prepared [Format – YYMMDD]
Preparation Time <PreparationTime="1400"/> Required, Time the document was prepared [Format – HHMM]
Recipient <Recipient="11934"/> Required, TradeNetID of the recipient. [Format – Number]
Recipient Code Qualifier <RecipientCodeQualifier="ZEX"/> Required, Needs to be hardcoded [Format – String]
Sender <Sender="45690"/> Required, TradeNetID of the sender. [Format – Number]
Sender Code Qualifier <SenderCodeQualifier="ZEX"/> Required, Needs to be hardcoded [Format – String]
Version Number <VersionNumber="2"/> Required, Needs to be hardcoded [Format – String]

Table 7: Quote Section

Field Name XML Example Description
Message Number <MessageNumber="SC7386"/> Required, Unique identifier for the Quote. Contains the Order ID of the RFQ appended to “SC”.
Currency Code <CurrencyCode="EUR"/> Required, Indicates the currency used in the Quote. [Format – String]
Function Code <FunctionCode="_9"/> Required, Function of the Quote (e.g., _9 = New Quote). [Format – String]
Line Item Count <LineItemCount="3"/> Required, Total number of line items in the Quote. [Format – Number]
Message Reference Number <MessageReferenceNumber="QN270524-1"/> Optional, Cross-reference to other messages. Required by MTML
Priority <Priority="High"/> Optional, Priority of the Quote. [Format – String]
Tax Status <TaxStatus="Taxable"/> Optional, Format – per list:
• Exempt
• NotTaxable
• Taxable
Supplier may change the value sent by the Buyer if necessary.
[Format – String]
Association Assigned Code <AssociationAssignedCode="MARL10"/> Required, Needs to be hardcoded [Format – String]
Controlling Agency <ControllingAgency="UN"/> Required, Needs to be hardcoded [Format – String]
Release Number <ReleaseNumber="96A"/> Required, Needs to be hardcoded [Format – String]
Version Number <VersionNumber="D"/> Required, Needs to be hardcoded [Format – String]

Table 8: Date Time Period

Field Name XML Example Description
Document Date <DateTimePeriod Qualifier="_137" FormatQualifier="_203" Value="202405271400"/> Required, Preparation date and time of the document. [Format – YYYYMMDDHHMM]
Order By <DateTimePeriod Qualifier="_175" FormatQualifier="_203" Value="202406240000"/> Optional, Deadline, or validity period for the document. [Format – YYYYMMDDHHMM]
Supplier Delivery Time <DateTimePeriod Qualifier="_69" FormatQualifier="_804" Value="10"/> Optional, Delivery time (in days) [Format – YYYYMMDDHHMM]
Good Until <DateTimePeriod Qualifier="_36" FormatQualifier="_203" Value="202406250000"/> Optional, Date the Quote is good until. [Format – YYYYMMDDHHMM]

Table 9: 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 associated with the Quote. [Format – String]
Subject / Title of Document <Comments Qualifier="ZAT"><Value>RADIO & PENS/PENCILS</Value></Comments> Optional, Subject / Title of the Quote. [Format – String]

Table 10: Reference Section

Field Name XML Example Description
Reference (UC) <Reference Qualifier="UC" ReferenceNumber="QN270524-1"/> Required, Unique reference number associated with the Quote. [Format – String]
Reference (AGI) <Reference Qualifier="AGI" ReferenceNumber=""/> Optional, AGI Reference.
Must Match Buyer RFQ Control Reference. [Format – String]

Table 11: Parties Section

Field Name XML Example Description
Vendor - VN <Party Name="William Brown VN" Qualifier="VN"> Required, Details of the vendor. [Format – String]
Street Address (Vendor) <StreetAddress>58 Birchwood Drive, #20-03</StreetAddress> Optional, Vendor address. [Format – String]
Contact (Vendor) <Contact Name="William Brown" FunctionCode="SR"> Optional, Main contact for the vendor. [Format – String]
Communication Method (Vendor - TE) <CommunicationMethod Number="VN (702) 555-4389" Qualifier="TE"/> Optional, Vendor phone number. [Format – String]
Communication Method (Vendor - FX) <CommunicationMethod Number="VN (702) 555-4390" Qualifier="FX"/> Optional, Vendor fax number. [Format – String]
Communication Method (Vendor - EM) <CommunicationMethod Number="william.brown@example.com" Qualifier="EM"/> Optional, Vendor 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]
Buyer - BA <Party Name="ALEX TEST BUYER" Qualifier="BA" CountryCode="CY"> Required, Details of the buyer. [Format – String]
Street Address (Buyer) <StreetAddress>ALEX TEST BUYER</StreetAddress> Optional, Buyer address. [Format – String]
Contact (Buyer) <Contact Name="" FunctionCode="SR"> Optional, Main contact for the buyer. [Format – String]
Communication Method (Buyer - TE) <CommunicationMethod Number="BA (413) 774-6201" Qualifier="TE"/> Optional, Buyer phone number. [Format – String]
Communication Method (Buyer - FX) <CommunicationMethod Number="BA (413) 774-6202" Qualifier="FX"/> Optional, Buyer fax number. [Format – String]
Communication Method (Buyer - EM) <CommunicationMethod Number="alexander.davis@example.com" Qualifier="EM"/> Optional, Buyer email address. [Format – String]
Consignee - CN <Party Qualifier="CN" City="Amsterdam" CountryCode="CY" Name="Emily Johnson Ltd CN"> Required, Details of the consignee. [Format – String] [Format – String]
Street Address (Consignee) <StreetAddress>Consignee Address 112 Oak Street, Eugene, OR 97401</StreetAddress> Optional, Consignee address. [Format – String]

Table 12: Line Items Section

Field Name XML Example Description
Line Item (1) <LineItem Number="1" Description="Walkie-Talkie 3000" Identification="994C4558414E4445501" MeasureUnitQualifier="PCS" MonetaryAmount="10" Quantity="1" TypeCode="BP" Weight="1.1"/> Required, Details of the first line item. [Format – String]
Gross Price <PriceDetails Qualifier="CAL" TypeCode="QT" TypeQualifier="GRP" Value="9.50"/> Optional, GRP (Gross Price). This is the price per unit. Typecode is always ‘QT’ for Quoted Price [Format – Number]
Discount Price <PriceDetails Qualifier="CAL" TypeCode="QT" TypeQualifier="DPR" Value="0.50"/> Optional, Line item discounts are represented as an amount per unit in MTML**[Format – Number]**

Table 13: 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 6-13: Contains all Quote Web Fields, their respective MTML fields, and some comments