Part Synergy Motorad Custom Integration
Version | Date | Name | Applied changes |
---|---|---|---|
v1.0 | 01.07.2025 | Bogomil Pavlov | First Publish |
In order to incorporate the custom integration for each warehouse we want to build a centralized structure where we gonna add all the authorization and setup details which later on will connect to the relevant location. In order to achieve this we will need to have a new structure with the following details:
Part Synergy Warehouse Integration
Field Name | Type | Require | Default | Comment |
---|---|---|---|---|
Active | checkbox | No | false | |
Name | varchar | Yes | ||
API Type | dropdown | Yes | List with all available custom API integration we have for PartSynergy warehouses | |
API URL | varchar | No | ||
API Username | varchar | No | ||
API Password | varchar | No | ||
API Access Token | varchar | No | ||
API Account | varchar | No | ||
Create Order | checkbox | No | false | |
Get Shipment | checkbox | No | false | |
Get Stock | checkbox | No | false | |
Get Price | checkbox | No | false |
Integration Documentation:
https://api.motorstate.com/swagger-ui/index.html
Create Order
When we are creating order via API we will have to take into consideration that we will also pick order item for export to FTP and both should work together. The trigger for order creation should be:
Part Synergy Warehouse Integration > Active = Yes
Product in Order > Exported = No
Product in Order > Custom Filter = To be equal to the Location Id. (If we have custom filter = 2 and we have added Part Synergy Warehouse Integration for Burco Location which id is also 2 we want to pick the order)
Order > Status = “Ready for Shipping”
Request:
POST https://api.motorstate.com/api/Order - Part Synergy Warehouse Integration > API URL
Header: apiKey - Part Synergy Warehouse Integration > API Access Token
{
"PurchaseOrderNumber": "string",
"RequestId": "string",
"ShippingMethodCode": "string",
"PaymentMethodCode": "string",
"CreditCardLast4": "string",
"Lines": [
{
"LineNumber": 0,
"PartNumber": "string",
"QuantityShip": 0,
"QuantityBackOrder": 0,
"BackOrderType": "string",
"Comment": "string"
}
],
"DropShipAddress": {
"Name": "string",
"Contact": "string",
"Line1": "string",
"Line2": "string",
"City": "string",
"State": "string",
"PostalCode": "string",
"Country": "string",
"Phone": "string",
"FaxNumber": "string",
"Email": "string"
},
"SpecialInstructions": "string",
"SignatureRequired": true,
"FreightOptions": {
"LiftGateRequired": true,
"ResidentialDelivery": true,
"CallBeforeDelivery": true
},
"InternationalContact": {
"Name": "string",
"PhoneNumber": "string"
},
"PickUpDate": "2025-07-01T20:55:03.184Z",
"RetailMarketplace": "string"
}
Get Stock
When we are getting the stock levels we have to use the Warehouse Line Codes Check - Channel Spyder.xlsx to obtain the master line code. The file is on the FTP and is updated on a daily basis and based on this file we have to map the Location > Name with the Column A and obtain the Master Line Code from column D and concatenate it with the Part Number (175|100073)
Request:
GET https://api.motorstate.com/api/ProductAvailabilityChange - Part Synergy Warehouse Integration > API URL
Header:
apiKey - Part Synergy Warehouse Integration > API Access Token
fromDateTime -
Response:
[
{
"PartNumber": "string",
"UpdatedOn": "2025-07-01T21:01:30.377Z",
"QuantityAvailable": 0,
"StatusType": "string",
"IsDeleted": true
}
]