Table of Contents

minLevel	1
maxLevel	3

Purpose

...

This method allows to update new contract record in DB through the NHS IT system

Specification

...

Page Properties
Link
https://ehealthmisapi1.docs.apiary.io/#reference/private.-contracts/private-contracts/private.-update-contract
Resource
/api/admin/contracts/{{id}}
Scope
private_contracts:write
Components
Contracts
Microservices
API paragraph not found
Protocol type
REST
Request type
PUT
Sync/Async
Sync
Public/Private/Internal
Private

Logic

...

This method allows to update new contract record in DB through the NHS IT system
...
Input parameter
Values
Type
Description
Example
id
String
`801f37f5-52c8-477e-aba5-a1d01876d210`

Request structure

...

See on Apiary

Expand

title	Response example

Code Block

{
  "start_date": "2017-04-20",
  "end_date": "2017-04-20",
  "status": "VERIFIED",
  "contractor_legal_entity_id": "56440c03-e218-432a-b417-9574b2b287bd",
  "contractor_owner_id": "54fea667-62cf-4688-ae9e-31acc19d986d",
  "contractor_base": "на підставі закону про Медичне обслуговування населення",
  "contractor_payment_details": {
    "bank_name": "Банк номер 1",
    "MFO": "351005",
    "payer_account": "32009102701026"
  },
  "contractor_rmsp_amount": 50000,
  "external_contractor_flag": true,
  "external_contractors": [
    {
      "legal_entity": {
        "id": "b075f148-7f93-4fc2-b2ec-2d81b19a9b7b",
        "name": "Клініка Ноунейм"
      },
      "contract": {
        "number": "1234567",
        "issued_at": "2018-01-01",
        "expires_at": "2019-01-01"
      },
      "divisions": [
        {
          "id": "2922a240-63db-404e-b730-09222bfeb2dd",
          "name": "Бориспільське відділення Клініки Ноунейм",
          "medical_service": "Послуга ПМД"
        }
      ]
    }
  ],
  "nhs_signer_id": "da8cc932-7bca-4048-a3ff-9b07f901a860",
  "nhs_signer_base": "на підставі наказу",
  "nhs_legal_entity_id": "e5f76afb-4d96-4279-bcf1-0308457e6b64",
  "nhs_payment_method": "prepayment",
  "is_suspended": false,
  "issue_city": "Київ",
  "nhs_contract_price": 50000,
  "contract_number": "0000-9EAX-XT7X-3115",
  "status_reason": "default",
  "parent_contract_id": "09106b70-18b0-4726-b0ed-6bda1369fd52",
  "id_form": "PMD",
  "nhs_signed_date": "2017-04-20",
  "type": "CAPITATION",
  "reason": "не було виконано умов контракту",
  "signed_content_location": "bucket_name/folder_identifier/file_name"
}

Authorize

...

Verify the validity of api-key
Return 401 in case validation fails
Verify the validity of token
Return 401 in case validation fails
Check scopes in order to perform this action (scope = 'private_contracts:write')
Return 403 in case invalid scope(s)
Request to process the request using a token in the headers

Headers

...

Наприклад:
Content-Type:application/json
api-key:c2778f3064753ea70de870a53795f5c9

Request data validation

...

The following attributes must be validated
...
Only authenticated and authorized user can use this service
Contract must be valid and consistent, i.e. all "foreign keys" must be valid
Deleted contract (is_active = false) couldn't be updated

Processing

...

Update system attributes
Attribute
Value
updated_at
now() timastamp
updated_by
User from token
...
4. Event manager (trigger logic)

Response structure

...

See on Apiary

Example:

Expand

title	Response example

Code Block

{
  "meta": {
    "code": 200,
    "url": "https://example.com/resource",
    "type": "object",
    "request_id": "req-adasdoijasdojsda"
  },
  "data": {
    "id": "8be63914-a278-470b-b868-1af5b9087332",
    "start_date": "2017-04-20",
    "end_date": "2017-04-20",
    "status": "VERIFIED",
    "contractor_legal_entity_id": "56440c03-e218-432a-b417-9574b2b287bd",
    "contractor_owner_id": "54fea667-62cf-4688-ae9e-31acc19d986d",
    "contractor_base": "на підставі закону про Медичне обслуговування населення",
    "contractor_payment_details": {
      "bank_name": "Банк номер 1",
      "MFO": "351005",
      "payer_account": "32009102701026"
    },
    "contractor_rmsp_amount": 50000,
    "external_contractor_flag": true,
    "external_contractors": [
      {
        "legal_entity": {
          "id": "b075f148-7f93-4fc2-b2ec-2d81b19a9b7b",
          "name": "Клініка Ноунейм"
        },
        "contract": {
          "number": "1234567",
          "issued_at": "2018-01-01",
          "expires_at": "2019-01-01"
        },
        "divisions": [
          {
            "id": "2922a240-63db-404e-b730-09222bfeb2dd",
            "name": "Бориспільське відділення Клініки Ноунейм",
            "medical_service": "Послуга ПМД"
          }
        ]
      }
    ],
    "nhs_signer_id": "da8cc932-7bca-4048-a3ff-9b07f901a860",
    "nhs_signer_base": "на підставі наказу",
    "nhs_legal_entity_id": "e5f76afb-4d96-4279-bcf1-0308457e6b64",
    "nhs_payment_method": "prepayment",
    "is_suspended": false,
    "issue_city": "Київ",
    "nhs_contract_price": 50000,
    "contract_number": "0000-9EAX-XT7X-3115",
    "status_reason": "default",
    "parent_contract_id": "09106b70-18b0-4726-b0ed-6bda1369fd52",
    "id_form": "PMD",
    "nhs_signed_date": "2017-04-20",
    "type": "CAPITATION",
    "reason": "не було виконано умов контракту",
    "signed_content_location": "bucket_name/folder_identifier/file_name",
    "medical_programs": [
      "d313342c-0b3c-443b-a92e-afb78d1e8086"
    ],
    "is_active": true,
    "inserted_at": "2017-04-20T19:14:13Z",
    "inserted_by": "e1453f4c-1077-4e85-8c98-c13ffca0063e",
    "updated_at": "2017-04-20T19:14:13Z",
    "updated_by": "2922a240-63db-404e-b730-09222bfeb2dd"
  }
}

Versions Compared

Old Version 25

New Version 26

Key

Purpose

This method allows to update new contract record in DB through the NHS IT system

Specification

Logic

This method allows to update new contract record in DB through the NHS IT system
...
Input parameter
Values
Type
Description
Example
id
String
`801f37f5-52c8-477e-aba5-a1d01876d210`

Request structure

Authorize

Headers

Наприклад:
Content-Type:application/json
api-key:c2778f3064753ea70de870a53795f5c9

Request data validation

The following attributes must be validated
...
Only authenticated and authorized user can use this service
Contract must be valid and consistent, i.e. all "foreign keys" must be valid
Deleted contract (is_active = false) couldn't be updated

Processing

Update system attributes
Attribute
Value
updated_at
now() timastamp
updated_by
User from token
...
4. Event manager (trigger logic)

Response structure

Post-processing processes

API paragraph not found

HTTP status codes

HTTP status code
Message
What caused the error
200

...

Page Comparison

Versions Compared

Old Version 25

New Version 26

Key

Purpose

This method allows to update new contract record in DB through the NHS IT system

Specification

Logic

This method allows to update new contract record in DB through the NHS IT system...Input parameterValuesTypeDescriptionExampleidString801f37f5-52c8-477e-aba5-a1d01876d210

Request structure

Authorize

Headers

Наприклад:Content-Type:application/jsonapi-key:c2778f3064753ea70de870a53795f5c9

Request data validation

The following attributes must be validated...Only authenticated and authorized user can use this serviceContract must be valid and consistent, i.e. all "foreign keys" must be validDeleted contract (is_active = false) couldn't be updated

Processing

Update system attributesAttributeValueupdated_atnow() timastampupdated_byUser from token...4. Event manager (trigger logic)

Response structure

Post-processing processes

API paragraph not found

HTTP status codes

HTTP status codeMessageWhat caused the error 200 ...

This method allows to update new contract record in DB through the NHS IT system
...
Input parameter
Values
Type
Description
Example
id
String
`801f37f5-52c8-477e-aba5-a1d01876d210`

Наприклад:
Content-Type:application/json
api-key:c2778f3064753ea70de870a53795f5c9

The following attributes must be validated
...
Only authenticated and authorized user can use this service
Contract must be valid and consistent, i.e. all "foreign keys" must be valid
Deleted contract (is_active = false) couldn't be updated

Update system attributes
Attribute
Value
updated_at
now() timastamp
updated_by
User from token
...
4. Event manager (trigger logic)

HTTP status code
Message
What caused the error
200

...