Upsert a Contract

post/contractmanager.save

Creates or updates a Contract. To update a Contract, specify an existing uniqueName.

Securitybasic or X-PriceFx-jwt
Request
Request Body schema: application/json
required
object
required
object
version
any
typedId
any
uniqueName
any
label
required
string non-empty
targetDate
required
string non-empty
workflowStatus
required
string non-empty
headerText
required
string non-empty
required
Array of objects non-empty unique
Array (non-empty)
name
string non-empty
label
string non-empty
lookupTableId
any
url
any
type
string non-empty
value
any
valueHint
any
readOnly
any
filter
any
parameterGroup
any
labelTranslations
any
addUnknownValues
any
typedId
any
alwaysEditable
any
inputs
Array of objects
parameterConfig
object
formattingOptions
object
valueOptions
any
required
object
openFolders
Array of objects
gridViewState
string non-empty
selectedNodes
Array of objects
outputs
required
Array of objects
lastUpdateByName
any
createdByName
any
submittedByName
any
calculationStatus
required
number
dirty
required
boolean
refreshInputs
required
boolean
nodeId
required
number
userGroupEdit
any
userGroupViewDetails
any
serverMessages
required
Array of objects
additionalInfo1
any
additionalInfo2
any
additionalInfo3
any
additionalInfo4
any
numberOfAttachments
required
number
creationWorkflowStatus
any
creationWorkflowCurrentStep
any
creationWorkflowStepCount
any
creationWorkflowStepLabel
any
signature
any
required
Array of objects non-empty unique
Array (non-empty)
version
any
typedId
any
clicId
any
Array of objects non-empty unique
outputs
Array of objects
dirty
boolean
lineId
string non-empty
parentId
any
calculationStatus
number
editabilityStatus
number
label
string non-empty
startDate
any
endDate
any
priceRecordId
any
customerGroup
any
object
calculationBaseJson
string non-empty
object
folder
boolean
treeLabel
string non-empty
createDate
string non-empty
createdBy
number
lastUpdateDate
string non-empty
lastUpdateBy
number
contractTermType
string non-empty
customerGroup
any
required
object
label
any
productFieldName
required
string non-empty
productFieldLabel
required
string non-empty
productFieldValue
required
string non-empty
productFilterCriteria
any
externalRef
any
contractStatus
required
string non-empty
startDate
required
string non-empty
endDate
required
string non-empty
status
required
string non-empty
required
Array of objects non-empty unique
Array (non-empty)
key
any
message
required
string non-empty
hasWorkflowHistory
required
boolean
renderInfo
any
approvedByName
any
deniedByName
any
approvalRequiredEmailAttachmentsJson
any
createDate
required
string non-empty
createdBy
required
number
lastUpdateDate
required
string non-empty
lastUpdateBy
required
number
supersededBy
any
prevRev
any
rootUniqueName
any
Responses
200

Example response

Response Schema: application/json
object
node
string non-empty
Array of objects non-empty unique
Array (non-empty)
version
number
typedId
string non-empty
uniqueName
string non-empty
label
string non-empty
targetDate
string non-empty
workflowStatus
string non-empty
headerText
string
Array of objects non-empty unique
viewState
any
outputs
Array of objects
lastUpdateByName
string non-empty
createdByName
string non-empty
submittedByName
any
calculationStatus
number
dirty
boolean
refreshInputs
boolean
nodeId
any
userGroupEdit
any
userGroupViewDetails
any
serverMessages
Array of objects
additionalInfo1
any
additionalInfo2
any
additionalInfo3
any
additionalInfo4
any
numberOfAttachments
number
creationWorkflowStatus
any
creationWorkflowCurrentStep
any
creationWorkflowStepCount
any
creationWorkflowStepLabel
any
signature
any
Array of objects non-empty unique
customerGroup
any
object
externalRef
any
contractStatus
string non-empty
startDate
string non-empty
endDate
string non-empty
status
string non-empty
approvedByName
any
deniedByName
any
approvalRequiredEmailAttachmentsJson
any
hasWorkflowHistory
boolean
renderInfo
any
Array of objects non-empty unique
createDate
string non-empty
createdBy
number
lastUpdateDate
string non-empty
lastUpdateBy
number
supersededBy
any
prevRev
any
rootUniqueName
string non-empty
status
required
number
Request samples
application/json
{
  • "data": {
    • "contract": {
      • "version": null,
      • "typedId": null,
      • "uniqueName": null,
      • "label": "New Agreement & Promotion",
      • "targetDate": "2022-01-04",
      • "workflowStatus": "DRAFT",
      • "headerText": "header text",
      • "inputs": [
        • {
          },
        • {
          }
        ],
      • "viewState": {
        • "openFolders": [
          ],
        • "gridViewState": "({field:[{name:\"CLITN_Status\",frozen:true,width:25},{name:\"CLITN_Status1\",frozen:true,width:25},{name:\"dirtyField\",frozen:true,width:25},{name:\"CLITN_Desc\",frozen:true},{name:\"label\"},{name:\"customerGroup\",visible:false},{name:\"productGroup\",visible:false},{name:\"INPUT_Discount__\",visible:false},{name:\"OUTPUT_CustomerGroup\",visible:false},{name:\"OUTPUT_ProductGroup\",visible:false},{name:\"OUTPUT_StandardDiscount\",visible:false}]})",
        • "selectedNodes": [
          ]
        },
      • "outputs": [ ],
      • "lastUpdateByName": null,
      • "createdByName": null,
      • "submittedByName": null,
      • "calculationStatus": 2,
      • "dirty": false,
      • "refreshInputs": false,
      • "nodeId": 0,
      • "userGroupEdit": null,
      • "userGroupViewDetails": null,
      • "serverMessages": [
        • "Agreements & Promotions calculated successfully"
        ],
      • "additionalInfo1": null,
      • "additionalInfo2": null,
      • "additionalInfo3": null,
      • "additionalInfo4": null,
      • "numberOfAttachments": 0,
      • "creationWorkflowStatus": null,
      • "creationWorkflowCurrentStep": null,
      • "creationWorkflowStepCount": null,
      • "creationWorkflowStepLabel": null,
      • "signature": null,
      • "lineItems": [
        • {
          }
        ],
      • "customerGroup": null,
      • "productGroup": {
        • "label": null,
        • "productFieldName": "sku",
        • "productFieldLabel": "ProductID",
        • "productFieldValue": "B-0002",
        • "productFilterCriteria": null
        },
      • "externalRef": null,
      • "contractStatus": "DRAFT",
      • "startDate": "2022-01-04",
      • "endDate": "2022-01-04",
      • "status": "DRAFT",
      • "serverMessagesExtended": [
        • {
          }
        ],
      • "hasWorkflowHistory": false,
      • "renderInfo": null,
      • "approvedByName": null,
      • "deniedByName": null,
      • "approvalRequiredEmailAttachmentsJson": null,
      • "createDate": "2022-01-04T15:00:47",
      • "createdBy": 2147490187,
      • "lastUpdateDate": "2022-01-04T15:00:47",
      • "lastUpdateBy": 2147490187,
      • "supersededBy": null,
      • "prevRev": null,
      • "rootUniqueName": null
      }
    }
}
Response samples
application/json
{
  • "response": {
    • "node": "string",
    • "data": [
      • {
        • "version": 0,
        • "typedId": "string",
        • "uniqueName": "string",
        • "label": "string",
        • "targetDate": "string",
        • "workflowStatus": "string",
        • "headerText": "string",
        • "inputs": [
          ],
        • "viewState": null,
        • "outputs": [
          ],
        • "lastUpdateByName": "string",
        • "createdByName": "string",
        • "submittedByName": null,
        • "calculationStatus": 0,
        • "dirty": true,
        • "refreshInputs": true,
        • "nodeId": null,
        • "userGroupEdit": null,
        • "userGroupViewDetails": null,
        • "serverMessages": [
          ],
        • "additionalInfo1": null,
        • "additionalInfo2": null,
        • "additionalInfo3": null,
        • "additionalInfo4": null,
        • "numberOfAttachments": 0,
        • "creationWorkflowStatus": null,
        • "creationWorkflowCurrentStep": null,
        • "creationWorkflowStepCount": null,
        • "creationWorkflowStepLabel": null,
        • "signature": null,
        • "lineItems": [
          ],
        • "customerGroup": null,
        • "productGroup": {
          },
        • "externalRef": null,
        • "contractStatus": "string",
        • "startDate": "string",
        • "endDate": "string",
        • "status": "string",
        • "approvedByName": null,
        • "deniedByName": null,
        • "approvalRequiredEmailAttachmentsJson": null,
        • "hasWorkflowHistory": true,
        • "renderInfo": null,
        • "serverMessagesExtended": [
          ],
        • "createDate": "string",
        • "createdBy": 0,
        • "lastUpdateDate": "string",
        • "lastUpdateBy": 0,
        • "supersededBy": null,
        • "prevRev": null,
        • "rootUniqueName": "string"
        }
      ],
    • "status": 0
    }
}