RFQ – 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 1: Interchange
| Field Name | XML Example | Description/Info |
|---|---|---|
| Sender | <Sender="11934"/> |
Required, TradeNetID of the buyer (sender). [Format – Number] |
| Recipient | <Recipient="45690"/> |
Required, TradeNetID of the supplier (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="20240527"/> |
Required, Date the document was prepared [Format – YYYYMMDD] |
| Preparation Time | <PreparationTime="1206"/> |
Required, Time the document was prepared [Format – HHMM] |
| Control Reference | <ControlReference="7780640369599120242705120622"/> |
Required, Unique reference identifying the document in the sender's system. Note, this will be returned on the Quote as the AGI Reference. [Format – String] |
| Sender Code Qualifier | <SenderCodeQualifier="ZEX"/> |
Optional, Needs to be hardcoded [Format – String] |
| Recipient Code Qualifier | <RecipientCodeQualifier="ZEX"/> |
Optional, Needs to be hardcoded [Format – String] |
Table 2: Request For Quote
| Field Name | XML Example | Description/Info |
|---|---|---|
| Currency Code | <CurrencyCode="EUR"/> |
Required, Indicates the currency used in the RFQ. [Format – String] |
| Document Mode | 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 |
|
| Function Code | <FunctionCode="_9"/> |
Required, Function for the new RFQ |
| Function Code (1 or 5) | FunctionCode="_1" or FunctionCode="_5" MUST INCLUDE:1) MessageNumber="9000187268"2) <Reference Qualifier="ACW" ReferenceNumber="RequestForQuote:343098"/> |
Cancellation or Replacement. Must include: • (1) Original: MessageNumber • (2) ACW Reference to Original Control Reference. |
| Line Item Count | <LineItemCount="6"/> |
Required, Total number of line items in the RFQ. [Format – Number] |
| Message Number | <MessageNumber="27524V00010"/> |
Required, This number is assigned to this document throughout its life cycle. It will be returned on the Quote as the MessageNumber. [Format - Char 40.] |
| Release Number | <ReleaseNumber="96A"/> |
Required, Needs to be hardcoded [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. |
| Priority | <Priority="High"/> |
Optional, Priority of the RFQ set by the Buyer: · Low · Medium · High · Critical |
| Transport Mode Code | <TransportModeCode="_1"/> |
Optional, Transport mode indicator: • 1 - Maritime • 2 - Rail • 3 - Road • 4 – Air |
| Message Reference Number | <MessageReferenceNumber="77806401727524"/> |
Required, Cross-reference to other messages, required by MTML. [Format – String] |
| Association Assigned Code | <AssociationAssignedCode="MARL10"/> |
Required, Needs to be hardcoded [Format – String] |
Table 3: Date Time Period
| Field Name | XML Example | Description/Info |
|---|---|---|
| Vessel ETA | <DateTimePeriod Value="202405300000" Qualifier="_132" FormatQualifier="_203"/> |
Optional, Estimated Arrival time of vessel (local time) [Format – YYYYMMDDHHMM] |
| Vessel ETD | <DateTimePeriod Value="202406300000" Qualifier="_133" FormatQualifier="_203"/> |
Optional, Estimated time of Departure of vessel [Format – YYYYMMDDHHMM] |
| Requested Delivery Date | <DateTimePeriod Value="202406200000" Qualifier="_2" FormatQualifier="_203"/> |
Optional, Requested Delivery Date (local time) [Format – YYYYMMDDHHMM] |
| Advise By | <DateTimePeriod Value="202406150000" Qualifier="_175" FormatQualifier="_203"/> |
Optional, Advise Before date (GMT) [Format – YYYYMMDDHHMM] |
| Document Date | <DateTimePeriod Value="202405271206" Qualifier="_137" FormatQualifier="_203"/> |
Required, Document Date assigned by purchaser system when the document is posted. [Format – YYYYMMDDHHMM] |
Table 4: Parties
| Field Name | XML Example | Description/Info |
|---|---|---|
| Buyer - BY | <Party Name="Aiden Smith Ltd BY" Qualifier="BY"> |
Required, Details of the purchaser. [Format – String] |
| Street Address (Buyer) | <StreetAddress>7783 Palm Ave, San Diego, CA 92109</StreetAddress> |
Optional, Purchaser address. [Format – String] |
| Contact (Buyer) | <Contact Name="Aiden Smith" FunctionCode="PD"> |
Optional, Details of main contact for the buyer. [Format – String] |
| Communication Method (Buyer - TE) | <CommunicationMethod Number="BY (312) 667-9052" Qualifier="TE"/> |
Optional, Buyer phone number. [Format – String] |
| Communication Method (Buyer - FX) | <CommunicationMethod Number="BY (312) 667-9053" Qualifier="FX"/> |
Optional, Buyer fax number [Format – String]. |
| Communication Method (Buyer - EM) | <CommunicationMethod Number="aiden.smith@example.com" Qualifier="EM"/> |
Optional, Buyer 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 address. [Format – String] |
| Contact (Consignee) | <Contact Name="Lucas Gray CONSIGNEE CONTACT NAME" FunctionCode="PD"> |
Optional, Details of main contact for the consignee. [Format – String] |
| Communication Method (Consignee - TE) | <CommunicationMethod Number="CN (541) 752-3236" Qualifier="TE"/> |
Optional, Consignee phone number. [Format – String] |
| Communication Method (Consignee - FX) | <CommunicationMethod Number="CN (541) 752-3237" Qualifier="FX"/> |
Optional, Consignee fax number. [Format – String] |
| Communication Method (Consignee - EM) | <CommunicationMethod Number="lucas.gray@example.com" Qualifier="EM"/> |
Optional, Consignee email address. [Format – String] |
| 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, Details of 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 name and unique identification. [Format – String] |
| Port | <PartyLocation Port="Amsterdam" Qualifier="ZUC"/> |
Required, Indicates the location of the party, including the port and its qualifier. Can be empty [Format – String] |
| Payment Terms - ZTP | <Comments Qualifier="ZTP"><Value>NET 60 DAYS</Value></Comments> |
Required, Payment terms associated with the RFQ. [Format – String] |
| General Terms - ZTC | <Comments Qualifier="ZTC"><Value>General Purchaser Terms & Requirements</Value></Comments> |
Required, General terms provided by the purchaser for the RFQ. [Format – String] |
| Purchase Order - PUR | <Comments Qualifier="PUR"><Value>UHF frequency should be set for present available UHF on board</Value></Comments> |
Required, Specific comments from the purchaser related to the RFQ. [Format – String] |
| Subject / Title of the RFQ | <Comments Qualifier="ZAT"><Value>RADIO & PENS/PENCILS</Value></Comments> |
Required, Additional details or comments for the RFQ. [Format – String] |
| RFQ Reference | <Reference Qualifier="UC" ReferenceNumber="27524V00010"/> |
Optional, This is the human-readable reference. This is usually the RFQ Number displayed in the Buyers system. [Format – String] |
Table 5: Line Items
| Field Name | XML Example | Description/Info |
|---|---|---|
| Line-Item Number | <LineItem Number="1"/> |
Required, Line items must be numeric integers (decimals not allowed). TradeNet allows gaps in the sequences, eg 1, 3, 4, 7. This sequence should be maintained on the response document. [Format – Number] |
| Quantity | <Quantity="1.0000"/> |
Required, Quantity of the item requested. [Format – Number] |
| Type Code | <TypeCode="BP"/> |
Optional, Part Reference Type. BP - Buyer's part number EN - International Article Numbering Association (EAN) MF - Manufacturer's (producer's) article number UP - Universal product code (UPC) VP - Vendor's (seller's) part number ZIM - IMPA Number ZIS - ISSA Number ZMA - Mariner's Annual number [Format - Char 12] |
| Description | <Description>Walkie-Talkie 3000</Description> |
Required, Description of the line item. [Format – String] |
| Identification | <Identification="414C4558414E4445501"/> |
Optional, Unique identifier for the item. [Format – String] |
| Measure Unit Qualifier | <MeasureUnitQualifier="PCS"/> |
Optional, Unit of measurement for the line item (e.g., PCS = Pieces). [Format – String] |
| Comments (Line Item) | <Comments Qualifier="LIN"><Value/></Comments> |
Optional, Comments specific to this line item. [Format – String] |
| Section | <Section Name="" ModelNumber="" Manufacturer="MK: IMPA" SerialNumber="" DepartmentType="M10"/> |
Optional, Metadata about the item in the line item (e.g., manufacturer, serial number, etc.). [Format – String] |
Table 1-5: Contains all RFQ Web Fields, their respective MTML fields, and some comments