1. Aftersales Interface
  • autoX API Reference
    • Introduction
  • Marketing Interface
    • Overview
    • Lead Create
      POST
    • Appointment Create
      POST
    • Opportunity Create
      POST
    • Transaction Push⬩
      POST
    • Transaction Update⬩
      POST
  • Website Interface
    • Overview
    • Get Showroom List
      GET
    • Get Make Data
      GET
    • Get Model Data
      GET
    • Get Sales Org Data
      GET
    • Get Equipment Stock Data
      GET
    • Get Characteristics Data of Equipment
      GET
    • Get Material Addons Data
      GET
    • Get Bill Of Material Data
      GET
    • Get Equipment Price
      POST
    • Vehicle Enquiry Create
      POST
  • Payment Gateway Interface
    • Overview
    • Payment Link Create⬩
      POST
    • Payment Link Cancel⬩
      POST
    • Payment Notification
      POST
    • Payment Status Check⬩
      POST
  • Aftersales Interface
    • Overview
    • Check Workload Capacity
      POST
    • Service Request Push⬩
      POST
    • Get Parts Price & Stock
      POST
    • Work Estimate Create
      POST
    • Service Request Update⬩
      POST
  • Call Center Integration
    • Overview
    • Data Fetch
    • Transaction Sync
    • Queue Upload⬩
  • Survey Interface
    • Overview
    • Update Survey Score
  • OEM Interface
    • Overview
    • Accounts Data
    • Parts Sales Data
    • Parts Stock Data
    • Customer Data
    • Labour Sales Data
    • Vehicle Data
    • Vehicle Sales Data
    • Service History Data
    • Open Repair Orders Data
    • Open Repair Orders Customer Data
    • Workshop Transactions Data
    • Workshop Transactions Customer Data
    • Future Booking Data
  1. Aftersales Interface

Overview

The Aftersales Interface module provides a set of endpoints that connect autoX on SAP S/4HANA with third-party workshop management and parts pricing platforms. It supports both inbound API calls – where a third-party system queries or creates data in autoX – and outbound webhook callbacks, where autoX pushes data to an external system based on a configurable trigger or manual action.

Use the Check Workload Capacity endpoint to determine whether a workshop has sufficient capacity to accept a new booking on a given date. Returns a boolean entry flag and the remaining balance capacity in hours.
Use the Service Request Push outbound webhook to push a new or updated service request from autoX to an external system. autoX POSTs the service request payload to an external system endpoint based on a configurable trigger or manual action.
Use the Get Parts Price & Stock endpoint to retrieve the sales price and available stock for a given material. The price returned is inclusive of any applicable surcharge. The bin location is returned where warehouse management is configured for the plant.
Use the Work Estimate Create endpoint to create a work estimate in SAP S/4HANA against an existing service request. The work estimate is created with one or more labour/product/sublet/petty-cash/consumable line items.
Use the Service Request Update outbound webhook to push a status update to an external system as a service request progresses through autoX – such as Vehicle Intake Completed, Service Order Completed, or Billing Completed.

Service Request Batch (SFTP)
In addition to the real-time Service Request Push webhook, autoX supports a scheduled batch export of service request data as a CSV flat file. The file is generated daily based on appointment date and plant, and delivered to a partner-configured endpoint via SFTP. The file name follows the format RO {date} {time}.CSV.
FieldDescription
JobNumberService request number
AccountNoSAP sold-to-party (customer) number
AppointmentDateAppointment date and time in ISO 8601 format (UTC)
BookedWorkService request description
BookedWorkCodeBooked work operation code
BookedWorkPriceExTaxBooked work price excluding tax
BookedWorkPriceIncTaxBooked work price including tax
CustomerNameFull name of the Business Partner
TitleCustomer title (salutation)
FirstNameCustomer first name
LastNameCustomer last name
Name1Organisation name line 1
Name2Organisation name line 2
PhoneNoCustomer telephone number
MobileNoCustomer mobile number
EmailCustomer email address
Street1Address line 1
Street2Address line 2
CityCity
CountryCountry code
StateRegion or emirate code
PostalCodePostal code
VehicleDescriptionVehicle equipment description
LicensePlateVehicle licence plate number
MileageRecorded odometer reading
MOTDueMOT due date
ServiceDueNext service due date in ISO 8601 format (UTC)
ManufacturerVINVehicle Identification Number (VIN)
PlantPlant code of the servicing location

Parts Price & Stock Batch (SFTP)
In addition to the real-time Get Parts Price & Stock endpoint, autoX supports a scheduled batch export of parts pricing and stock data as a CSV flat file. The file is generated daily and delivered to a partner-configured endpoint via SFTP. The file name follows the format T-PL-{date}.CSV.
FieldDescription
MaterialSAP material number
MaterialDescriptionMaterial description
PriceSales price inclusive of any applicable surcharge
StockAvailable stock quantity
SurchargeSurcharge rate applied to the base price
BinLocationBin or storage location of the material in the warehouse
Previous
Payment Status Check⬩
Next
Check Workload Capacity
Built with