Products / Entity

Bulk Update Products

This endpoint allows you to update a Multiple Products (100 entities for request) information from the user's ForceManager implementation database.
In order to update Multiple Products, you just have to specify the attributes you want to modify and complete with the up to date information. It is not necessary to send all attributes.

You will only be able to update an Account after first providing the Session Key. To know how you can obtain the Session Key, go to Authentication.

HEADERS

ParameterValueDescription
Content-Typeapplication/jsonLanguage in which all request and response bodies are encoded
Accept*/*Any data of whatever mime type is accepted
X-Session-KeyAUTH_TOKENThis field must be completed with the token obtained at the authentication

REQUEST

This endpoint allows updating the information of Multiple Products. In order to update an Account, you just have to specify the attributes you want to modify and complete with the up to date information. It is not necessary to send all attributes.

You have to send an Array with the following JSON data:

ParameterTypeDescription
guidStringUnique operation identifier
dataObjectJSONObject with the Account data (same data as Create Account method)
idIntegerUnique Account's identifier

You can check the "data" object in the following table:

ParameterTypeDescription
categoryIdObject, NullId of the Category that the Product belongs to (see Categories resource)
costNumberCost of the Product
descriptionStringDescription of the Product
extIdStringExternal ID of the Product from a third party system (ERP, CRM, Accounting System)
familyIdIntegerId of the Family that the Product belongs to (see Families resource)
maxDiscountNumberMaximum discount that can be applied to the Product in percents
modelStringProduct name
notAvailableBooleanIf true, the Product is not available
permissionLevelIntegerDefines the visibility of the Product. Set from 1 to 5 being 5 the highest level of permission
priceNumberSpecific price for the Product
stockIntegerAmount of Product in stock
readOnlyBooleanIf true, the Product can not be modified or deleted

RESPONSE

Returns a JSON with information about the Account just updated.

AttributeTypeDescription
MessageStringShows the operation status

RESPONSE CODES

StatusDescription
200 OKShows if operation succeeded
400 Bad RequestShows when an invalid request or the requested service is not available
put/products/bulk

Request

  • Base URL: https://api.forcemanager.com/api/v4
  • URL: https://api.forcemanager.com/api/v4/products/bulk
  • Auth: API key in header X-Session-Key

Headers

Acceptstring

Request body

object[] required

Response

Bulk Update Products

Changes

No recorded changes to this operation across all 1 revision of this API.