Mercedes.Agency.Orchestration.API

<back to all web services

CreateOneAdminOrderRequest

Order
Requires Authentication
The following routes are available for this service:
POST/v1/oneAdmin/orderCreates an order for a selected vehicle via the Agency APIThis endpoint is called from the OneAdmin portal to create a vehicle order. It builds the order request object for the Agency API before calling it to create the order. The information it retrieves and builds for the Agency API request include 1.) The customer. 2.) The vehicle. 3.) Ourright purchase. 4.) Motability. 5.) Offers applicable to the vehicle Validation is performed on the input data which includes checking for mandatory items: 1.} Customer details 2.) Vehicle Vin 3.) Agent 4.) GSSN Outlet Id 5.) Source 6.) Order Type 7.) Customer Location Id 8.) Estimated Handover Date
CreateOneAdminOrderRequest Parameters:
NameParameterData TypeRequiredDescription
CustomerLocationIdbodyint?No
CreateOrderBase Parameters:
NameParameterData TypeRequiredDescription
SourceformSourceNo
GssnIdformstringYes
AdditionalInformationformstringYes
CashformboolNo
FinanceformboolNo
CustomerformCustomerYes
VehicleformVehicleYes
FinanceCriteriaformFinanceCriteriaYes
BackOrderGuidformGuid?No
TagUrlformstringNo
OutrightPurchaseformOutrightPurchaseNo
MotabilityformboolNo
MotabilityPricingIdformint?No
FinanceApplicationReferenceformstringYes
SpecialistformboolNo
GasIdformstringYes
PersonalisedItemOfferIdsformint[]No
SuggestedVinformstringNo
NonOptimumReasonformstringNo
MotabilityTypeformMotabilityTypeNo
EstimatedHandoverDateformstringYes
Source Enum:
NameValue
OnlineShowroom1
OneAdmin2
Customer Parameters:
NameParameterData TypeRequiredDescription
ProfileIdformGuid?No
PreferencesformPreferencesNo
SalesforceCustomer Parameters:
NameParameterData TypeRequiredDescription
CustomerIdformstringYes
IsCiamformboolNo
CompanyNameformstringYes
TitleformstringYes
FirstnameformstringYes
SurnameformstringYes
EmailAddressformstringYes
TelephoneformstringYes
AddressformAddressYes
ModeformCustomerModeNo
Address Parameters:
NameParameterData TypeRequiredDescription
PropertyformstringYes
StreetformstringYes
TownformstringYes
CountyformstringYes
LocalityformstringYes
PostcodeformstringYes
CustomerMode Enum:
NameValue
Private1
Business2
Motability3
Preferences Parameters:
NameParameterData TypeRequiredDescription
OptinEmailformboolNo
OptinPostformboolNo
OptinSMSformboolNo
OptinTelephoneformboolNo
Vehicle Parameters:
NameParameterData TypeRequiredDescription
VinformstringNo
FinanceCriteria Parameters:
NameParameterData TypeRequiredDescription
KeyformstringYes
NameformstringYes
TypeformstringYes
IsDefaultformboolNo
TermformTermYes
DepositformDepositYes
MileageformMileageYes
AdvanceRentalsformAdvanceRentalsYes
IsPersonalisedformboolNo
RegularPaymentformstringYes
PartExchangeformstringYes
SettlementformstringYes
CustomerTypeformstringYes
VehicleTypeformVehicleTypeNo
Term Parameters:
NameParameterData TypeRequiredDescription
OptionsformList<Option>Yes
Option Parameters:
NameParameterData TypeRequiredDescription
IsDefaultformboolNo
ValueformintNo
Deposit Parameters:
NameParameterData TypeRequiredDescription
DefaultformstringYes
Mileage Parameters:
NameParameterData TypeRequiredDescription
OptionsformList<Option>Yes
AdvanceRentals Parameters:
NameParameterData TypeRequiredDescription
OptionsformList<Option>Yes
VehicleType Enum:
UNASSIGNED
NEW
USED
OutrightPurchase Parameters:
NameParameterData TypeRequiredDescription
IsOutrightPurchaseformboolNo
ReferenceformstringYes
DiscountRateformdecimalNo
Bm7NSTformstringYes
IsBackOrderformboolNo
IsCOPConverterformboolNo
MotabilityType Enum:
NameValue
PIP1
WPMS2
UNASSIGNED3
CreateOrderResponse Parameters:
NameParameterData TypeRequiredDescription
GuidformstringYes
ReferenceformstringYes
ResponseStatusformResponseStatusYes
BackOrderReferenceformstringYes

To override the Content-type in your clients, use the HTTP Accept Header, append the .other suffix or ?format=other

HTTP + OTHER

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /v1/oneAdmin/order HTTP/1.1 
Host: prod-api-agency-orch-mb-dhc.rapp-customers.co.uk 
Accept: text/jsonl
Content-Type: text/jsonl
Content-Length: length

{"CustomerLocationId":0,"Source":"OnlineShowroom","GssnId":"String","AdditionalInformation":"String","Cash":false,"Finance":false,"Customer":{"ProfileId":"00000000000000000000000000000000","Preferences":{"OptinEmail":false,"OptinPost":false,"OptinSMS":false,"OptinTelephone":false},"CustomerId":"String","IsCiam":false,"CompanyName":"String","Title":"String","Firstname":"String","Surname":"String","EmailAddress":"String","Telephone":"String","Address":{"Property":"String","Street":"String","Town":"String","County":"String","Locality":"String","Postcode":"String"},"Mode":"Private"},"Vehicle":{"Vin":"String"},"FinanceCriteria":{"Key":"String","Name":"String","Type":"String","IsDefault":false,"Term":{"Options":[{"IsDefault":false,"Value":0}]},"Deposit":{"Default":"String"},"Mileage":{"Options":[{"IsDefault":false,"Value":0}]},"AdvanceRentals":{"Options":[{"IsDefault":false,"Value":0}]},"IsPersonalised":false,"RegularPayment":"String","PartExchange":"String","Settlement":"String","CustomerType":"String","VehicleType":"UNASSIGNED"},"BackOrderGuid":"00000000000000000000000000000000","TagUrl":"String","OutrightPurchase":{"IsOutrightPurchase":false,"Reference":"String","DiscountRate":0,"Bm7NST":"String","IsBackOrder":false,"IsCOPConverter":false},"Motability":false,"MotabilityPricingId":0,"FinanceApplicationReference":"String","Specialist":false,"GasId":"String","PersonalisedItemOfferIds":[0],"SuggestedVin":"String","NonOptimumReason":"String","MotabilityType":"PIP","EstimatedHandoverDate":"String"}

HTTP/1.1 200 OK
Content-Type: text/jsonl
Content-Length: length

{"Guid":"String","Reference":"String","ResponseStatus":{"ErrorCode":"String","Message":"String","StackTrace":"String","Errors":[{"ErrorCode":"String","FieldName":"String","Message":"String","Meta":{"String":"String"}}],"Meta":{"String":"String"}},"BackOrderReference":"String"}