Pre-Advice

Version: 2.4, Date: 2026-09-29

Revision history

Date	Version	Description
2025-02-21	1.0	Initial version.
2025-06-27	2.0	added View the Despatch-Advice API schema documentation
2025-08-25	2.1	Update existing Pre-Advice example + added confirmation examples
2025-09-01	2.2	Update Pre-Advice example + added scenarios
2025-12-03	2.3	Added expected.handlingUnitCount
2026-09-29	2.4	added Pre-advice acknowledgement to API schema documentation
2026-10-07	2.5	Update flow diagrams + added Pre-advice acknowledgement

Purpose

Reserve trailer capacity at carriers for pallet shipments.

Integration touch points

The Pre-Advice is initiated by sending a request from SAP to Viya using an EDI/api message. Viya will create a Pre-Advice, indicating capacity needed to ship goods. After creation, Viya will message the carrier as defined in the Pre-Advice. The next step depends on the integration state of this carrier:

EDI/api Integrated Pre-Advice

The carrier has a Pre-Advice integration: an EDI/api message is send to the carrier. A direct response is expected. This response is then handled in Viya. Viya will sent to SAP with an EDI/api message containing the result.

E-mail Integrated Pre-Advice

The carrier has no Pre-Advice EDI/api integration, but accepts e-mail requests for the Pre-Advice: an e-mail with the request will be send to the defined e-mail address. This e-mail contains a link to secured Viya webpage that is specific for this Pre-Advice. On this page, the carrier can confirm or decline the Pre-Advice request. Viya will sent to SAP with an EDI/api message containing the result.

Pre-advice acknowledgement

Disconnected process triggered by either the E-mail intergrated pre-advice response or a specific status code provided by the carrier, where the pre-advice For the E-mail integrated pre-advice, as well as for carriers that don’t support pre-advice (whenever configured), a disconnected process is in place to inform SAP of the pre-advice approval/refusal.

No integration configured

The carrier has no Pre-Advice integration (or Viya-integrated alternative) and does not accept e-mail requests: as there is no Pre-Advice possibility, the SAP request will be followed by a direct decline of the request as there is no possiblity to fulfil the request.

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 can be sent multiple times until dispatched. An updated Pre-Advice is sent again to the carrier, depending on carrier capabilities.

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.
• Method: POST
• Endpoint: to be provided by SAP
• Headers:
  • Content-Type: application/json
  • Authorization or authentication indicated by SAP

Payload

See Pre-advice acknowledgement documentation