Table of Contents

ForSea Supplier Integration

This documentation is for suppliers integrating with the ForSea / ProcureLink platform. It explains how to build and send JSON/XML payloads for each stage of the procurement cycle, how documents link together, and what every field means.

The procurement cycle

A complete transaction on ForSea flows through four stages in order:

Step Stage Document You…
1 🟢 RFQ Request For Quote Receive from the Buyer
2 🟡 Quote Supplier Quotation Send your prices
3 🟠 PO Purchase Order Receive from the Buyer
4 🟣 POC Order Confirmation Send to confirm

Each document must carry specific reference fields that link it to the previous document. If these linking fields are wrong, the platform cannot chain the documents together.

Important

Before building any payload, read the Document Linking guide. It explains the AGI / AAG / ON linking rules that every integration must get right.

Where to start

Tip

First time integrating with ForSea? Start here → Document Linking guide It gives you the full chain overview, the three linking qualifiers explained, and a troubleshooting section for the most common mistakes.

Note

Ready to build payloads? Go to the field table for the stage you are working on:

Note

Testing in Postman?

  • Base URL: https://test.procurelink.global
  • Authentication: POST /api/Auth/Token with your test credentials
  • Use Authorization: Bearer <token> on all transaction requests

Test environment endpoints

Endpoint Method Description
/api/Auth/Token POST Get a Bearer token (Buyer or Supplier credentials)
/api/Transaction/RFQ POST Create or update an RFQ
/api/Transaction/Quote POST Create or update a Quote
/api/Transaction/Order POST Create or update a PO
/api/Transaction/OrderConfirm POST Create or update a POC

All endpoints require Authorization: Bearer <token> and Content-Type: application/json.

Quick reference

I need to… Go to…
Understand how documents link together Document Linking
Look up a specific field for the Quote Quote Field Table
Look up a specific field for the PO PO Field Table
Look up a specific field for the POC POC Field Table
See the full API reference Swagger
Get a one-page cheat sheet Cheat Sheet