Skip to main content

Create private auction

POST 
/company/auction/private

Creates a private auction with direct assignment to a specific trucker. Requires valid JWT authentication and multitenant company permissions.

🚚 Specific Flow for Private/Direct Shipments​

🔐 Step 1: Permission Validation​

  • Authentication: Valid JWT token
  • Permissions: Active multitenant account verification
  • Plan: Payment plan confirmation that allows private auctions

👥 Step 2: Trucker Selection​

  • Identification: Specify trucker (trucker ID)
  • Verification: Trucker must be active and available
  • Relationship: Must have previous commercial relationship or agreement

🚛 Step 3: Vehicle Assignment (Optional)​

  • Specificity: Define vehicle if specific type is required
  • Ownership: Vehicle must belong to assigned trucker
  • Capacity: Verify that vehicle can handle weight/volume

📋 Step 4: Shipment Data Configuration​

Mandatory fields unique to private auctions:

  • is_private: true - Marks auction as private
  • trucker: "TRK_ID" - ID of assigned trucker

Specific optional fields:

  • vehicle: "VH_ID" - ID of specific vehicle required

🚀 Step 5: Creation and Direct Notification​

POST /company/auction/private
  • Initial state: draft (same as public auctions)
  • Visibility: Only visible to assigned trucker
  • Notification: Direct alert to specific trucker
  • No competition: Does not appear in public marketplace

💬 Step 6: Direct Negotiation​

  • Communication: Direct channel company ↔ trucker
  • Flexibility: Possibility to adjust terms without competitors
  • Agility: Faster process by eliminating bidding period

✅ Step 7: Simplified Acceptance​

  • Single offer: Trucker sends their proposal
  • Binary decision: Accept or reject (no comparison with others)
  • Speed: Immediate award process

🎯 Private Flow Advantages​

⚡ Speed​

  • Elimination of offer waiting period
  • Direct communication without intermediaries
  • Immediate award decision

🤝 Commercial Relationships​

  • Strengthening bonds with trusted truckers
  • Service guarantee through established relationship
  • Negotiated prices based on volume/frequency

🔒 Confidentiality​

  • Shipment information not publicly exposed
  • Protection of sensitive commercial data
  • Total control over who accesses information

📊 Specific Use Cases​

Specialized Transport​

  • Dangerous goods: Truckers with specific licenses
  • Temperature controlled: Vehicles with refrigeration
  • Oversized: Truckers with special permits

Urgent Shipments​

  • Critical timing: Known trucker available immediately
  • No waiting: Elimination of bidding period
  • Reliability: Proven track record of compliance

Established Commercial Relationships​

  • Framework contracts: Truckers with previous agreements
  • Negotiated rates: Pre-established prices by volume
  • Premium services: Truckers with additional services

⚠️ Specific Validations for Private Auctions​

  • Active trucker: Operational status verification
  • Available vehicle: Availability confirmation on dates
  • Adequate capacity: Weight/volume within vehicle limits
  • Necessary permits: Trucker enabled for cargo type
  • Coverage area: Trucker operates on required routes

Request​

Responses​

Private auction created successfully.