Integration Notes

How SeaBid maps to Basta.app's auction API

Basta API Mapping

SeaBid Concept	Basta API Entity	Notes
Supplier	SeaBid only	Extended data not in Basta (certifications, locations, sustainability)
Shipment	SeaBid only	Pre-auction logistics, voyage tracking, containers
Auction Sale	`Sale`	`createSale()` mutation
Auction Lot	`Item`	`createItemForSale()` mutation
Starting bid/lb	`startingBid`	Needs `$/lb → cents` conversion
Reserve/lb	`reserve`	Optional hidden reserve price
Bid	`Bid`	`bidOnItem()` mutation
Service fees	SeaBid extends	Not native to Basta - we add transload, re-ice, transport
Traceability cert	SeaBid only	SeaThru-style certificate, our data layer

Integration Points

Create Auction Sale

When supplier creates auction → call Basta createSale()

createSale({ title, dates, closingMethod })

Add Lots/Items

For each lot → call Basta createItemForSale()

createItemForSale({ saleId, title, startingBid })

Publish Sale

When ready → call Basta publishSale()

publishSale({ saleId })

Handle Bidding

Bidding uses Basta bidOnItem() with bidder tokens

bidOnItem({ itemId, amount, bidderToken })

Receive Webhooks

Webhooks receive bid events, status changes

POST /webhooks/basta → { event, data }

SeaBid Extends

Add traceability, service fees, supplier data, shipment tracking

// Our data layer on top of Basta

What SeaBid Adds on Top of Basta

🏢

Supplier Management

Certifications (ASC, FDA, MAST), farm locations, sustainability profiles

🚢

Shipment Tracking

Voyage tracking from origin (Iceland/Faroe Islands), vessel info, ETA

📦

Container Management

iTUB container types: Tub (~500lb), Box (55lb), Pallet (24×boxes)

💰

Service Fee Calculation

Transload, re-ice, split-up, transport fees per lb by zone

🔍

Traceability Certificates

SeaThru-style journey tracking, QR codes, carbon footprint

⚖️

Weight-Based Pricing

$/lb pricing instead of flat price, per-lb bid increments

Questions for Basta Team

1
Can we extend Item schema for custom fields (weight, size grade, origin)?
2
Webhook events for bid placed, auction ending, auction closed?
3
Can bidIncrementTable support per-lb increments?
4
Multi-currency support timeline? (ISK for Icelandic sellers)
5
Can Sale have custom metadata for service fees?
6
Real-time bid subscription via WebSocket available?

Example: Creating a Sale with Lots

// 1. Create Sale in Basta
const sale = await basta.createSale({
  title: "Laxey Premium Salmon - December 2024",
  description: "Fresh Atlantic Salmon from Vestmannaeyjar, Iceland",
  closingMethod: "OVERLAPPING",
  closingTimeCountdown: 60, // 60 sec extension
  dates: {
    openDate: "2024-12-11T14:00:00Z",
    closingDate: "2024-12-11T16:00:00Z",
  },
});

// 2. Create Items (Lots) for Sale
const lot = await basta.createItemForSale({
  saleId: sale.id,
  title: "#1 Premium Iceland Tub - 7/8kg",
  description: "Fresh whole HOG Atlantic salmon...",
  startingBid: 500, // $5.00/lb in cents
  bidIncrementTable: {
    rules: [{ lowRange: 0, highRange: null, step: 5 }] // $0.05
  },
});

// 3. Store SeaBid-specific data in our DB
await seabid.storeLotExtension({
  bastaItemId: lot.id,
  totalWeightLbs: 498,
  sizeGrades: ["7/8"],
  supplierId: "laxey",
  origin: "IS",
  serviceFees: {
    transloadPerLb: 0.15,
    reIcePerLb: 0.05,
    transportPerLb: 0.35,
  },
  traceabilityCertificateId: "CERT-LXY-2024-001",
});

// 4. Publish when ready
await basta.publishSale({ saleId: sale.id });

Architecture Overview

Suppliers

Laxey, Hiddenfjord

SeaBid

Suppliers, Shipments, Traceability, Fees

Basta.app

Sales, Items, Bids

Buyers

US Seafood Distributors

Upstream

Certifications, Farm data, Shipments

Platform

Auction logic, Payments, Webhooks

Downstream

Orders, Delivery, Traceability

SeaBid Prototype v0.1 · Built with Next.js 14 · Designed for Basta.app integration