POST/api/deals

Create deal

Body:

Content TypeValue
application/json

Headers

HeaderValueRequired
Acceptapplication/jsontrue
AuthorizationYour authorization tokentrue
ChannelYour channel valuetrue
x-api-version2.0true

Request Example body

{
  "kind": "ExampleDeal",
  "parent":null,
  "appRef": null,
  "parties": [
    {
      "key": "QRM1",
      "role": "Sender"
    },
    {
      "key": "QRM2",
      "role": "Receiver"
    }
  ],
}
{
  "kind": "LcDeal",
  "parent":null,
  "appRef": null,
  "parameters": [
    {
      "key": "DocNumber",
      "value": "123"
    },
    {
      "key": "Item",
      "value": "Pepper"
    },
    {
      "key": "DeliveryDate",
      "value": "2020-08-08"
    },
    {
      "key": "Quantity",
      "value": "10"
    }
  ],
  "parties": [
    {
      "key": "QRM1",
      "role": "Seller"
    },
    {
      "key": "QRM2",
      "role": "Buyer"
    },
    {
      "key": "QRM3",
      "role": "Bank"
    }
  ],
  "transitions": [
    {
      "status": "NEW",
      "statusNext": "OfferReq",
      "roles": [
         "Seller"
       ]
    },
    {
      "status": "OfferOk",
      "statusNext": "LcReq",
      "roles": [
         "Buyer"
       ]
    },
    {
      "status": "LcFail",
      "statusNext": "LcReq",
      "roles": [
         "Buyer"
       ]
    },
    {
      "status": "Payment",
      "statusNext": "Closed",
      "roles": [
         "Seller"
       ]
    }
  ]
}
{
  "kind": "FirstDeal",
  "parent":null,
  "appRef": null,
  "parties": [
     {
       "key": "QRM1",
       "role": "AnyRole1"
     },
     {
       "key": "QRM2",
       "role": "AnyRole2"
     }
  ],
}

Response

Returned if the request is successful.

HeadersValue
content-typeapplication/json; charset=utf-8
api-supported-versionsSupported versions. Example: 1.0, 2.0
Content TypeValue
application/json

Example body:

{
  "queueId": 15897,
  "localDealId": 3456
}

Returned in case of request validation error.

HeadersValue
content-typeapplication/json; charset=utf-8
api-supported-versionsSupported versions. Example: 1.0, 2.0
Content TypeValue
application/json

Example body:

{
  "errorMessage": "DealKind LcDeal not found"
}

Returned if the authentication credentials are incorrect or missing.

Content TypeValue
anyDepends on authentication proxy

Returned in case of unpredictable error.

HeadersValue
content-typeapplication/json; charset=utf-8
api-supported-versionsSupported versions. Example: 1.0, 2.0
Content TypeValue
application/json

Example body:

{
  "errorMessage": "Transitions must have single start state "NEW""
}

GET/api/deals

Get deals list

Query parameters:

KeyTypeDescriptionRequired
pageNumberintegerPaging: positionfalse
pageSizeintegerPaging: returned items countfalse

Headers

HeaderValueRequired
Acceptapplication/jsontrue
AuthorizationYour authorization tokentrue
ChannelYour channel valuetrue
x-api-version2.0true

Request Example

curl -X GET "https://qrm1.kekker.com/api/deals"
-H "accept: application/json"
-H "Authorization: {AUTHORIZATION}"
-H "channel: {CHANNEL}"
-H "x-api-version: 2.0"

Response

Returned if the request is successful.

HeadersValue
content-typeapplication/json; charset=utf-8
api-supported-versionsSupported versions. Example: 1.0, 2.0
Content TypeValue
application/json

Example body:


 {
  "pageNumber": 1,
  "pageSize": 10,
  "totalRecords": 3,
  "data": [
    {
      "dealId": "ad04c39314184ac0847304fc22eaac75:fc5567d419c647e0b4f8806dc8d3a9ae",
      “localDealId”:3511,
      "kind": "FirstDeal",
      "version": 8,
      "status": "CargoGot"
    },
    {
      "dealId": null,
      “localDealId”:3510,
      "kind": "FirstDeal",
      "version": 0,
      "status": null
    },
    {
      "dealId": "ad04c39314184ac0847304fc22eaac75:57af8d5e2cde483b84f761038bd902ff",
      “localDealId”:3509,
      "kind": "FirstDeal",
      "version": 3,
      "status": "CONFIRMED"
    }
  ]
}

Returned if the authentication credentials are incorrect or missing.

Content TypeValue
anyDepends on authentication proxy

Returned in case of unpredictable error.

HeadersValue
content-typeapplication/json; charset=utf-8
api-supported-versionsSupported versions. Example: 1.0, 2.0
Content TypeValue
application/json

Example body:

{
  "errorMessage": "Internal error"
}

POST/api/deals/{id}

Change deal state

Query parameters:

KeyTypeDescriptionType
idstringIdentifier for the deal (local or global)string

Body:

Content TypeValue
application/json

Headers

HeaderValueRequired
Acceptapplication/jsontrue
AuthorizationYour authorization tokentrue
ChannelYour channel valuetrue
x-api-version2.0true

Request Example body

{
  "status": "OfferOk",
  "remark": "Offer accepted",
  "parameters": [
    {
      "key": "Quantity",
      "value": "9"
    },
  ],
  "files": [
    {
      "kind": "Offer acceptance",
      "localId": "c19131e4-b9c1-4dce-8cae-b8d00f50fc61",
    },
    {
      "kind": "bill",
      "receivers": ["QRM1"],
      "localPath": "E:\\Files\\bill_1324.pdf",
    }
  ],
  "status": "OfferOk",
  "remark": "Offer accepted",
}

Response

Returned if the request is successful.

HeadersValue
content-typeapplication/json; charset=utf-8
api-supported-versionsSupported versions. Example: 1.0, 2.0
Content TypeValue
application/jsonIdentifier for the deals queue action (type: long)

Example body:

33302

Returned in case of request validation error.

HeadersValue
content-typeapplication/json; charset=utf-8
api-supported-versionsSupported versions. Example: 1.0, 2.0
Content TypeValue
application/json

Example body:

{
  "errorMessage": "Deal not found"
}

Returned if the authentication credentials are incorrect or missing.

Content TypeValue
anyDepends on authentication proxy

Returned in case of unpredictable error.

HeadersValue
content-typeapplication/json; charset=utf-8
api-supported-versionsSupported versions. Example: 1.0, 2.0
Content TypeValue
application/json

Example body:

{
    "errorMessage": "Internal error"
}

GET/api/deals/{id}

Get extended deal information

Query parameters:

KeyTypeDescriptionType
idstringIdentifier for the deal (local or global)string

Headers

HeaderValueRequired
Acceptapplication/jsontrue
AuthorizationYour authorization tokentrue
ChannelYour channel valuetrue
x-api-version2.0true

Request Example with global identifier

curl -X GET "https://qrm1.kekker.com/api/deals/ad04c39314184ac0847304fc22eaac75:57af8d5e2cde483b84f761038bd902ff"
-H "accept: application/json"
-H "Authorization: {AUTHORIZATION}"
-H "channel: {CHANNEL}"
-H "x-api-version: 2.0"

Request Example with local identifier

curl -X GET "https://qrm1.kekker.com/api/deals/30501"
-H "accept: application/json"
-H "Authorization: {AUTHORIZATION}"
-H "channel: {CHANNEL}"
-H "x-api-version: 2.0"

Response

Returned if the request is successful.

HeadersValue
content-typeapplication/json; charset=utf-8
api-supported-versionsSupported versions. Example: 1.0, 2.0
Content TypeValue
application/json

Example body:

{
  "dealId": "ad04c39314184ac0847304fc22eaac75:57af8d5e2cde483b84f761038bd902ff",
  "localDealId": 3502,
  "kind": "FirstDeal",
  "version": 3,
  "status": "CONFIRMED",
  "parent": null,
  "appRef": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "parameters": [
    {
      "key": "Item",
      "value": "Pepper"
    },
    {
      "key": "Quantity",
      "value": "10"
    }
  ],
  "parties": [
    {
      "key": "QRM1",
      "role": "SENDER"
    },
    {
      "key": "QRM2",
      "role": "RECEIVER"
    }
  ],
  "transitions": [
    {
      "status": "NEW",
      "statusNext": "SENT",
      "roles": ["SENDER"]
    },
    {
      "status": "SENT",
      "statusNext": "CONFIRMED",
      "roles": ["RECEIVER"]
    },
    {
      "status": "CONFIRMED",
      "statusNext": "Closed",
      "roles": [ "SENDER", "RECEIVER" ]
    }
  ],
  "files": [
    {
      "kind": "OFFER",
      "appRef": "7b7a5542-e6e3-4543-b666-815550345713",
      "receivers": [
        "QRM1",
        "QRM2"
      ],
      "localPath": "E:\Files\bfdd4bef74bf4af5b09561a924c4a20b_main.txt",
      "localId": "c19131e4-b9c1-4dce-8cae-b8d00f50fc61",
      "version": 2,
      "status": "SENT"
    }
  ],
  "history": [
    {
      "status": "SENT",
      "version": 2,
      "remark": "REMARK",
      "executor": "CLIENT1"
    },
    {
      "status": "CONFIRMED",
      "version": 3,
      "remark": "REMARK2",
      "executor": "CLIENT2"
    }
  ]
}

Returned in case of request validation error.

HeadersValue
content-typeapplication/json; charset=utf-8
api-supported-versionsSupported versions. Example: 1.0, 2.0
Content TypeValue
application/json

Example body:

{
  "errorMessage": "Deal not found"
}

Returned if the authentication credentials are incorrect or missing.

Content TypeValue
anyDepends on authentication proxy

Returned in case of unpredictable error.

HeadersValue
content-typeapplication/json; charset=utf-8
api-supported-versionsSupported versions. Example: 1.0, 2.0
Content TypeValue
application/json

Example body:

{
    "errorMessage": "Internal error"
}

GET/api/deals/templates

Get deal templates list

Query parameters:

KeyTypeDescriptionRequired
pageNumberintegerPaging: positionfalse
pageSizeintegerPaging: returned items countfalse

Headers

HeaderValueRequired
Acceptapplication/jsontrue
AuthorizationYour authorization tokentrue
x-api-version2.0true

Request Example

curl -X GET "https://qrm1.kekker.com/api/deals/template"
-H "accept: application/json"
-H "Authorization: {AUTHORIZATION}"
-H "x-api-version: 2.0"

Response

Returned if the request is successful.

HeadersValue
content-typeapplication/json; charset=utf-8
api-supported-versionsSupported versions. Example: 1.0, 2.0
Content TypeValue
application/json

Example body:

{
  "pageNumber": 1,
  "pageSize": 10,
  "totalRecords": 2,
  "data": [
    {
    "dealKind": "ExampleDeal",
    "description": "Example deal",
    "transitions": [
      {
        "status": "NEW",
        "statusNext": "Created",
        "roles":[ "Sender"]
      },
      {
        "status": "Created",
        "statusNext": "Sent",
        "roles": ["Sender"]
      },
      {
        "status": "Sent",
        "statusNext": "Received",
        "roles": ["Receiver"]
      },
      {
        "status": "Received",
        "statusNext": "Approved",
        "roles": ["Receiver"]
      },
      {
        "status": "Received",
        "statusNext": "Refused",
        "roles": ["Receiver"]
      }
    ]
   },
   {
   "name": "FreeDeal",
   "description": "Free deal template",
   "transitions": []
   }
  ]
}

Returned if the authentication credentials are incorrect or missing.

Content TypeValue
anyDepends on authentication proxy

Returned in case of unpredictable error.

HeadersValue
content-typeapplication/json; charset=utf-8
api-supported-versionsSupported versions. Example: 1.0, 2.0
Content TypeValue
application/json

Example body:

{
    "errorMessage": "Internal error"
}

GET/api/deals/{id}/tech

Get deals blockchain contract

Query parameters:

KeyTypeDescriptionType
idstringIdentifier for the deal (local or global)string

Headers

HeaderValueRequired
Acceptapplication/jsontrue
AuthorizationYour authorization tokentrue
ChannelYour channel valuetrue
x-api-version2.0true

Request Example

curl -X GET "https://qrm1.kekker.com/api/deals/3501/tech"
-H "accept: application/json"
-H "Authorization: {AUTHORIZATION}"
-H "channel: {CHANNEL}"
-H "x-api-version: 2.0"

Response

Returned if the request is successful.

HeadersValue
content-typeapplication/json; charset=utf-8
api-supported-versionsSupported versions. Example: 1.0, 2.0
Content TypeValue
application/jsonBlockchain contract address (type: string)

Example body:

cb8851f85e103031d12181056b554d6af9571ce9

Returned in case of request validation error.

HeadersValue
content-typeapplication/json; charset=utf-8
api-supported-versionsSupported versions. Example: 1.0, 2.0
Content TypeValue
application/json

Example body:

{
  "errorMessage": "Deal not found"
}

Returned if the authentication credentials are incorrect or missing.

Content TypeValue
anyDepends on authentication proxy

Returned in case of unpredictable error.

HeadersValue
content-typeapplication/json; charset=utf-8
api-supported-versionsSupported versions. Example: 1.0, 2.0
Content TypeValue
application/json

Example body:

{
    "errorMessage": "Internal error"
}

Test the platform’s powerful features now

By submitting this form, you confirm that you have read and agree to our privacy policy and terms of service