Orders / Statuses

Create Order Status

This endpoint allows you to create an Order Status based on JSON input.

You will only be able to create an Order Status 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 BODY

AttributeTypeDescription
branchVisibilityObject, NullIn which Branch the Order Status is visible
descriptionBRStringOrder Status label in Brasilian Portuguese
descriptionDEStringOrder Status label in German
descriptionDKStringOrder Status label in Dutch
descriptionEN (Required)StringOrder Status label in English
descriptionESStringOrder Status label in Spanish
descriptionFRStringOrder Status label in French
descriptionITStringOrder Status label in Italian
descriptionPTStringOrder Status label in Portuguese
descriptionRUStringOrder Status label in Russian
descriptionUSStringOrder Status label in American English
wonBooleanIf true, the Order has been won
lostBooleanIf true, the Order has been lost
orderIntegerhe position of the Order Status in the Order Statuses value list

RESPONSE

AttributeType
IdId assigned to the new Order Status
MessageThe operation status

RESPONSE CODES

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

Request

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

Headers

Acceptstring

Request body

descriptionENstring
orderinteger
wonboolean
lostboolean

Response

Create Order Status

Changes

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