Sourcings

Sourcing allows sellers to request products from sourcing agents, with built-in chat and payment features.

List Sourcings

GET/sourcings🔒 Session — can viewAny

Paginated list of sourcing requests. Different views for Sellers and Sourcing Agents.

Create Sourcing Request

POST/sourcings/store🔒 Session — can create

Submit a new sourcing request. Returns the reference and ID.

Request data is validated via step validation. See Validate Steps below.

Response (JSON):

{
  "reference": "SRC-00001",
  "id": "uuid-string"
}

Validate Steps

POST/sourcings/validate-steps🔒 Session

Validate sourcing form steps before final submission.

Update Sourcing Status

PATCH/sourcings/{item}/update-status🔒 Session

Update the status of a sourcing request.

Returns the updated sourcing chat resource.

Set Prices

POST/sourcings/{item}/set-prices🔒 Session

Set purchase and selling prices for a sourced product. Sends a real-time notification to the seller.

Pay by Wallet

POST/sourcings/{item}/pay-by-wallet🔒 Session — can payByWallet

Pay for a sourcing request using account balance. Deducts from balance, creates a PAID invoice, and records balance history.

Delete Sourcings (Bulk)

DELETE/sourcings/delete🔒 Session — can delete

Bulk delete sourcing requests.

Field	Type	Required	Description
ids	array	Yes	Array of sourcing IDs

---

Sourcing Chat

Each sourcing request has a built-in chat between the seller and sourcing agent.

View Chat

GET/sourcings/{item}/chat🔒 Session

Open the chat interface for a sourcing request.

Load Messages

GET/sourcings/{item}/chat/messages🔒 Session

Retrieve chat messages for a sourcing request.

Send Text Message

POST/sourcings/{item}/chat/send-text-message🔒 Session

Send a text message in the sourcing chat.

Send Image Message

POST/sourcings/{item}/chat/send-image-message🔒 Session

Send an image message in the sourcing chat.