Add User Location The Add User Location API allows the admin to add a location assignment to a particular user. This user will only be able to manage the orders and shipments of their specified location in the OMS interfaces.
Version 2.0 Call https://integration.shopatron.com/api/usermgmt/v1/user/{userID}/location Supported Formats JSON HTTP Method POST Schema https://integration.shopatron.com/api/usermgmt/v1/schema/addUserLocation.json
Note that the core URL may be different from the standard production environment, depending on the configuration.
The .json address above can be used to access the schema within Postman. An example use of the User Management API follows below, or view sample Postman collection
Example In this example, the user will be assigned the following location properties:
User ID 00000 Being assigned to Location 5
Required Parameters The following parameters are required for all instances of this call:
Parameter Type Description locationID integer The fulfillment location ID that the user is being assigned to.
Optional Parameters These are the other details that can be supplied while adding a new location:
Parameter Type Description manufacturerID integer A unique identifier for the manufacturer that the user is associated with. Note that this will be read-only. retailerID integer A unique identifier for the retailer associated with this user. catalogID integer A unique identifier for the catalog associated with this user.
The Full Request Using the URL format as outlined above, the entire call is fairly simple to put together. This sample will add the designated location to the user. The Shopatron-User-ID key will need to be added to the header and filled with the ID of the user making the request, for security purposes.
The user being modified is designated in the URL endpoint:
https://integration.shopatron.com/api/usermgmt/v1/user/00000/location Meanwhile, the location and any other optional parameters are noted in the body of the request:
{
"locationID":"5"
}
The returned response should be 200 OK. There will not be any data returned, but using the Get User Locations request will allow one to confirm that the change was made.
