Purpose

This web service is designed to change contract request by nhs employee. NHS ADMIN SIGNER should enrich contract request with information about itself, sum and place of the contract request. NHS signer could change only contract request in status = NEW, all other statuses can't be changed.

...

Request

fields for request

• nhs_signer_base
• nhs_contract_price
• nhs_payment_method

Validation

Validate token

• Verify the validity of access token
  • Return 401 in case validation fails
• Check if token is not expired
  • in case error return 401 - "Token is expired"

...

• Check if user is active
  • in case error return 403 - (user is not active)
• check nhs_legal_entity is active
  • in case error return 403 - (Client is not active)
• Check user role = "NHS ADMIN SIGNER"
  • in case error return 403 "User is not allowed to perform this action"

Validate scopes

• Check user scopes in order to perform this action (scope = 'contract_requests:update')
  • Return 403 in case invalid scope(s) "Your scope does not allow to access this resource. Missing allowances: contract_requests:update"

Validate contract request status

...

• Validate contract request id exists in DB
  • in case error return 404 ("Contract request with id=$id doesn't exist")
• Validate request according to json schema
  • in case error return 422 ("validation failed")
• validate nhs_contract_price 
  • nhs_contract_price should be > 0
    • in case error return 422 ("Contract price could not be negative")

Response

set 

contract_request_update_response.json_schema

...