PUT api/agreements/articleline

Updates an article line on agreement.

Request Information

URI Parameters

None.

Body Parameters

AgreementArticleLinePutRequest
NameDescriptionTypeAdditional information
AgreementNumber

Number of agreement

 integer

None.
ArticleNo

Article number

 integer

Required
Price

decimal(18,2)

 decimal number

None.
DiscountFactor

Discount factor, 1.0 = 100% discount, 0.5 = 50% discount
decimal(18,4)

 decimal number

None.
ValidFrom

Date when article line is valid from

 date

None.
ValidTo

Date when article line is valid to

 date

None.
CalculatedPrice

If true, discount will not appear on orderlines

 boolean

Required
Blocked

If true, customer is not allowed to order the article

 boolean

Required

Remarks

Add line if it doesn't exist

Example

None.

Request Formats

application/json, text/json

Sample: 
{
  "AgreementNumber": 1,
  "ArticleNo": 2,
  "Price": 1.0,
  "DiscountFactor": 1.0,
  "ValidFrom": "12/21/2025 1:04:19 PM",
  "ValidTo": "12/21/2025 1:04:19 PM",
  "CalculatedPrice": true,
  "Blocked": true
}

application/xml, text/xml

Sample: 
<AgreementArticleLinePutRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Compilator.DDAPI.DTO.Agreement">
  <ArticleNo>2</ArticleNo>
  <Blocked>true</Blocked>
  <CalculatedPrice>true</CalculatedPrice>
  <DiscountFactor>1</DiscountFactor>
  <Price>1</Price>
  <ValidFrom>2025-12-21T13:04:19.1888884+00:00</ValidFrom>
  <ValidTo>2025-12-21T13:04:19.1888884+00:00</ValidTo>
  <AgreementNumber>1</AgreementNumber>
</AgreementArticleLinePutRequest>

application/x-www-form-urlencoded

Sample:

Failed to generate the sample for media type 'application/x-www-form-urlencoded'. Cannot use formatter 'JQueryMvcFormUrlEncodedFormatter' to write type 'AgreementArticleLinePutRequest'.

Response Information

Resource Description

AgreementArticleLinePutResponse
NameDescriptionTypeAdditional information
Errors

List of errors when updating an article line on agreement

 Collection of PutAgreementArticleLineError

None.
Success

Returns true if article line is updated on agreement

 boolean

None.

Response Formats

application/json, text/json

Sample: 
{
  "Errors": [
    {
      "ErrorCode": 1,
      "ErrorMessage": "sample string 1"
    },
    {
      "ErrorCode": 1,
      "ErrorMessage": "sample string 1"
    }
  ],
  "Success": true
}

application/xml, text/xml

Sample: 
<AgreementArticleLinePutResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Compilator.DDAPI.DTO.Agreement">
  <Errors>
    <PutAgreementArticleLineError>
      <ErrorCode>InternalServerError</ErrorCode>
      <ErrorMessage>sample string 1</ErrorMessage>
    </PutAgreementArticleLineError>
    <PutAgreementArticleLineError>
      <ErrorCode>InternalServerError</ErrorCode>
      <ErrorMessage>sample string 1</ErrorMessage>
    </PutAgreementArticleLineError>
  </Errors>
  <Success>true</Success>
</AgreementArticleLinePutResponse>