SeaBid + Basta Integration
Technical overview of how SeaBid extends the Basta auction platform for seafood commerce
System Architecture
Basta Provides
Core Auction Engine
- ◆
Sale & Item Management
createSale, createItemForSale, publishSale
- ◆
Real-Time Bidding
bidOnItem, bid increment tables, closingTimeCountdown
- ◆
Bidder Authentication
Bidder tokens, session management
- ◆
Auction Lifecycle
UNPUBLISHED → PUBLISHED → OPEN → CLOSING → CLOSED
- ◆
Webhooks
Bid placed, auction ending, auction closed events
SeaBid Adds
Seafood Commerce Layer
- ◆
Supplier Management
Farm profiles, certifications (ASC, FDA, MAST), locations
- ◆
Shipment & Voyage Tracking
Eimskip integration, live GPS, container management
- ◆
Weight-Based Pricing
$/lb pricing, floated weights, lot calculations
- ◆
Temperature Monitoring
IoT sensors, cold chain verification, alerts
- ◆
Traceability Certificates
Full journey tracking, QR codes
- ◆
PFEX Operations
Transload workflow, service fees, staging
Data Model Mapping
| SeaBid Concept | Basta Equivalent | Notes |
|---|---|---|
| Supplier | — | SeaBid only (extended data) |
| Shipment | — | SeaBid only (pre-auction logistics) |
| Auction Sale | Sale | 1:1 mapping via createSale() |
| Auction Lot | Item | 1:1 mapping via createItemForSale() |
| Starting bid ($/lb) | startingBid | SeaBid converts $/lb → cents |
| Reserve ($/lb) | reserve | SeaBid converts $/lb → cents |
| Bid | Bid | Via bidOnItem() with bidder token |
| Service Fees | — | SeaBid extends (not native to Basta) |
| Traceability Cert | — | SeaBid only |
Integration Flow
Supplier Creates Auction
SeaBid UI → calls Basta createSale() with sale metadata
Add Lots to Sale
For each lot → calls Basta createItemForSale() with weight, grade, starting bid
Publish Sale
When ready → calls Basta publishSale() to make visible to bidders
Live Bidding
Basta handles all bidding via bidOnItem() with bidder tokens
Webhook Events
Basta sends webhooks for bid placed, auction closing, auction closed → SeaBid updates UI
Post-Auction
SeaBid handles checkout, service fees, PFEX operations, delivery — Basta not involved
Questions for Basta Team
We'd love to discuss:
- 1.
Item Schema Extensibility
Can we add custom fields to Items? (weight in lbs, size grade, origin country, traceability certificate ID)
- 2.
Webhook Events
What events are available? We need: bid placed, auction ending (5 min warning), auction closed, reserve met/not met
- 3.
Bid Increment Tables
Can bid increments be expressed in $/lb? (e.g., $0.05 increments) Or do we need to convert to cents?
- 4.
Real-Time Updates
How does Basta handle real-time bid updates? WebSockets, Server-Sent Events, or polling?
- 5.
Analytics & Reporting API
Does Basta provide APIs for bid history analytics, bidder behavior, and sale performance metrics?