Skip to main content

Create New Transport Auction

POST 
/company/auction

Create a new freight transport auction following a structured flow. Requires valid JWT authentication and verification of an active payment plan.

Allows companies to publish transport offers to receive bids from carriers.

Objective​

Facilitate the creation of public or private transport auctions with all the necessary information for carriers to bid on the service.

Use Cases​

  • Create a public auction to receive multiple offers from carriers
  • Generate a draft auction to review before publishing
  • Save frequent route configurations as favorites

Validation Flow​

flowchart TD
  A[Receive Request] --> B{User Authenticated?}
  B -->|No| C[401 Unauthorized]
  B -->|Yes| D{Active Payment Plan?}
  D -->|No| E[404 No Payment Plan]
  D -->|Yes| F{Dates in UTC?}
  F -->|No| G[400 Invalid Date Format]
  F -->|Yes| H{Valid Addresses?}
  H -->|No| I[400 Invalid Address]
  H -->|Yes| J{Positive Weights/Volume?}
  J -->|No| K[400 Invalid Cargo]
  J -->|Yes| L[Create Auction - 201]

Request​

Responses​

Auction created successfully