PO Confirmation – 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 22: Interchange Section
| Field Name | XML Example | Description |
|---|---|---|
| Sender | <Sender="58848"> |
Required, Unique identifier for the sender. [Format – Number] |
| Recipient | <Recipient="11934"> |
Required, Unique identifier for the recipient. [Format – Number] |
| Identifier | <Identifier="UNOC"> |
Required, Needs to be hardcoded [Format – String] |
| Preparation Date | <PreparationDate="20240528"> |
Required, Date the document was prepared [Format – YYYYMMDD] |
| Preparation Time | <PreparationTime="1200"> |
Required, Time the document was prepared [Format – HHMM] |
| Sender Code Qualifier | <SenderCodeQualifier="ZEX"> |
Required, Needs to be hardcoded [Format – String] |
| Recipient Code Qualifier | <RecipientCodeQualifier="ZEX"> |
Required, Needs to be hardcoded [Format – String] |
| Control Reference | <ControlReference="77806413696419"> |
Required, Reference number for document control. [Format – String] |
| Version Number | <VersionNumber="2"> |
Required, Needs to be hardcoded [Format – String] |
Table 23: Order Confirmation Attributes
| Field Name | XML Example | Description |
|---|---|---|
| Message Reference Number | <MessageReferenceNumber="960390800910125"> |
Optional, Cross-reference to other messages. |
| Line Item Count | <LineItemCount="2"> |
Required, Number of line items in the order. [Format – Number] |
| Function Code | <FunctionCode="_9"> |
Required, Needs to be hardcoded [Format – String] |
| Message Number | <MessageNumber="27524V00010"> |
Required, Message Number. Must match Supplier Quote MessageNumber. [Format – String] |
| Currency Code | <CurrencyCode="EUR"> |
Required, Currency used for all monetary values in the message. [Format – String] |
| Priority | <Priority="High"> |
Optional, Priority level of the order. [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] |
| Delivery Terms Code | <DeliveryTermsCode="EXW"> |
Optional, Incoterm code specifying delivery terms. [Format – String] |
| Transport Mode Code | <TransportModeCode="_1"> |
Optional, Code specifying the mode of transport. [Format – String] |
Table 24: DateTimePeriods
| 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] |
| Requested Delivery Date | <DateTimePeriod Value="202405281300" Qualifier="_2" 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. [Format – YYYYMMDDHHMM] |
Table 25: Parties
| 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" 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. |
| Contact (Vendor) | <Contact Name="ALEX TEST SUPPLIER" FunctionCode="SR"> |
Optional, Contact person for the vendor. |
| Communication Method (Vendor - TE) | <CommunicationMethod Number="VN (702) 555-4389" Qualifier="TE"/> |
Optional, Vendor's phone number. |
| Communication Method (Vendor - FX) | <CommunicationMethod Number="VN (702) 555-4390" Qualifier="FX"/> |
Optional, Vendor's fax number. |
| Communication Method (Vendor - EM) | <CommunicationMethod Number="william.brown@example.com" Qualifier="EM"/> |
Optional, Vendor's email address. |
| Invoice - IV | <Party Name="ALEX TEST BUYER" Qualifier="IV" CountryCode="CY"> |
Required, Details of the invoice recipient. |
| Street Address (Invoice) | <StreetAddress>ALEX TEST BUYER</StreetAddress> |
Optional, Invoice recipient's address. |
| 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. |
| Communication Method (Invoice - FX) | <CommunicationMethod Number="BA (413) 774-6202" Qualifier="FX"/> |
Optional, Invoice recipient's fax number. |
| Communication Method (Invoice - EM) | <CommunicationMethod Number="alexander.davis@example.com" Qualifier="EM"/> |
Optional, Invoice recipient's email address. |
Table 26: Comments
| Field Name | XML Example | Description |
|---|---|---|
| Payment Terms | <Comments Qualifier="ZTP"><Value>45 DAYS NET - CONDITION: PREVIOUS OUTSTANDINGS REPAID</Value></Comments> |
Optional, Supplier may change the value sent by the Buyer if necessary. [Format – String] |
| General Terms | <Comments Qualifier="ZTC"><Value>GENERAL PURCHASING TERMS FROM PURCHASER</Value></Comments> |
Optional, Format – Char 2048. Supplier may change the value sent by the Buyer if necessary. [Format – String] |
| Buyer Comments | <Comments Qualifier="PUR"><Value>COMMENTS FROM PURCHASER AT PO STAGE</Value></Comments> |
Optional, General comments [Format – String] |
| Title/ Subject | <Comments Qualifier="ZAT"><Value>RADIO & PENS/PENCILS</Value></Comments> |
Optional, Defaulted to Subject on the RFQ. [Format – String] |
Table 27: References
| Field Name | XML Example | Description |
|---|---|---|
| Reference | <Reference Qualifier="UC" ReferenceNumber="27524V00010" /> |
Optional, This is the human-readable reference. [Format – String] |
| Reference | <Reference Qualifier="ON" ReferenceNumber="123456789" /> |
Only valid in Order Confirmation and Order Response messages, where it must match the PO Control Reference. [Format – String] |
Table 28: Line Items
| Field Name | XML Example | Description |
|---|---|---|
| Line Item Number | <LineItem Number="1"> |
Required, Unique identifier for the line item. [Format – Number] |
| Description | <Description="Walkie-Talkie 3000X"> |
Required, Brief description of the item ordered. [Format – String] |
| Quantity | <Quantity="1"> |
Required, Number of units ordered. [Format – Number] |
| Type Code | <TypeCode="BP"> |
Required, Needs to be hardcoded [Format – String] |
| Identification | <Identification="994C4158414E4445501"> |
Required, Unique identification number or code associated with the item. [Format – String] |
| Monetary Amount | <MonetaryAmount="1"> |
Required, Price or cost associated with a single unit of the item. [Format – Number] |
| Measure Unit Qualifier (UOM) | <MeasureUnitQualifier="PCE"> |
Required, Unit of measure for the item (e.g., piece, kilogram, etc.). [Format – String] |
| Comments | <Comments Qualifier="LIN"><Value> Also comments on this Line Item </Value></Comments> |
Optional, Additional comments or notes related to the line item. [Format – String] |
| Section Name | <Section Name="Name Comments" ModelNumber="Model Comments" Manufacturer="Manufacturer Comments" SerialNumber="Serial # Comments" DepartmentType="Department M10 Comments"/> |
Optional, Detailed section information for the line item. [Format – String] |
| Price Details (Normal) | <PriceDetails Value="1" TypeCode="QT" Qualifier="CAL" TypeQualifier="GRP"/> |
Required, Normal price details for the line item, indicating type and qualifiers. [Format – Number] |
| Price Details (Discount) | <PriceDetails Value="0" TypeCode="QT" Qualifier="CAL" TypeQualifier="DPR"/> |
Required, Line item discounts are represented as an amount per unit in MTML [Format – Number] |
Table 29: 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 22-29: Contains all Order Confirmation fields, their corresponding MTML Fields, and some comments