SpotGo
  1. Freight
SpotGo
  • Getting started
    • Introduction
    • Authentication
    • Opportunities vs Orders
    • Mappings
  • Order
    • Orders Processing
    • /api/v1/orders/file
      POST
    • /api/v1/orders
      POST
    • /api/v2/orders/{orderId}
      GET
    • /api/v1/orders/{orderId}/file
      GET
  • Opportunity
    • Opportunities (Freight Qoutes)
    • /api/v1/opportunities
      POST
    • /api/v1/opportunities/file
      POST
    • /api/v1/opportunities/image
      POST
    • /api/v1/opportunities/{opportunityId}
      GET
    • /api/v1/opportunities/{opportunityId}/custom
      GET
    • /api/v1/opportunities/{opportunityId}/default
      GET
  • Freight
    • Freight publish
    • /api/v1/freights
      POST
    • /api/v1/freights/{freightId}
      PUT
    • /api/v1/freights/{freightId}
      DELETE
  • Vehicles
    • /api/v1/vehicles
      POST
    • /api/v1/vehicles
      GET
    • /api/v1/vehicles/{vehicleId}
      PUT
    • /api/v1/vehicles/{vehicleId}
      DELETE
    • /api/v1/vehicles/{vehicleId}
      GET
  • Feedback
    • /api/v1/feedback
  • Webhook
    • Webhooks flow
    • /api/v1/webhooks
    • /api/v1/webhooks
    • /api/v1/webhooks/{subscriptionId}
  • Documents
    • Documents processing
    • /api/v1/documents
    • /api/v1/documents/{documentId}/file
    • /api/v1/documents/invoice/{documentId}
    • /api/v1/documents/receipt/{documentId}
    • /api/v1/documents/cmr/{documentId}
  • AccountManagement
    • /api/v1/accounts
    • /api/v1/accounts/block
  1. Freight

Freight publish

These endpoints is used for freight publishing to freight exchanges via SpotGo platform.

Limitations#

Currently, API only supports 2 locations as maximum
If coordinates are not provided with the location, coordinates will be get using third-party service base on the country and postal code
Loading/Unloading maximum end date is DateTimeUTC.Now + 30 days
The loading start date must be greater than DateTimeUTC.Now + 15 minutes
1 Request equal 1 freight per user

Workflow#

Every 30-60 minutes each freight is uplifted (updated) on external exchanges to make it stand out
If all payment information is provided and price auto increase functionality is enabled it will increase the price every X hours
If the Loading location datetime range is provided for instance 2023-06-22 08:00 - 17:00 system automatically updates loading DateTime until it reaches 2023-06-22 17:00
When the loading starts time reaches DateTime UTC.Now the freight automatically is archived and deleted from all exchanges

Recomendations#

Do not delete and create freights trying to make them more visible as it's already done by SpotGo.
Distribute the freights publishing and updates in time to avoid hit rate limits from Freight Exchanges and SpotGo.
Provide externalNumber for better traceability

Freight Exchanges Mappings#

1 - Trans.eu
2 - Timocom
3 - Teleroute
4 - Cargo.lt
5 - LardiTrans
6 - Spedition.Net
7 - Della.eu
8 - Cargopedia.Net
9 - 123Cargo.eu
10 - FaFa
11 - Spedimo
12 - Nexogen
13 - WTransnet
14 - Roolz
15 - Haulage Exchange
16 - Transporeon Marketplace
100 - Inside
Modified at 2025-05-06 05:03:41
Previous
/api/v1/opportunities/{opportunityId}/default
Next
/api/v1/freights
Built with