Pre-advice

Version: 2.0, Date: 2025-06-27

Revision history

DateVersionDescription
2025-02-211.0Initial version.
2025-06-272.0added View the Despatch-Advice API schema documentation

Purpose

Reserve trailer capacity at carriers for pallet shipments.

Integration touch points

Diagram

State

  • The endpoint will be available for testing latest 1-oct-2025.

Pre-advice request

payload

  • The expected API documentation is available in the API documentation.

  • SAP will request a pre-advice to Viya.

    • Information required:
      • SAP pre-advice reference
      • Carrier
      • Pickup address
      • Destination address (at least country, the more details the better)
      • Expected loadmeter
      • Expected pickup date/time
    • Information optional:
      • Expected delivery date/time
    • Alternatively users can enter pre-advice information in Viya, not requiring SAP to request the pre-advice.
  • Viya will create the pre-advice and communicate it to the carrier in carrier desired format.

Pre-advice confirmation

  • At some point the carrier will confirm(or decline) the pre-advice.
    • At confirmation a booking reference is included.
  • Viya feeds the confirmed pre-advice information back to SAP
    • Alternatively this can be skipped in case no SAP integration is required. but upon despatch advice this booking reference or pre-advice reference is needed to link the pre-advice to the despatch advice.