Claims

You may find descriptions of endpoints for work with claims bellow.

Filter claims

post

Authorizations

authorization & XApiKey

authorizationstringRequired

x-api-keystringRequired

Header parameters

x-api-keystringRequired

This is the eshop key you receive during onboarding.

authorizationstringRequired

Token you get from calling /users/login

Body

application/json

pageinteger · min: 1Optional

Page number, can be used for pagination

Default: 1Example: 1

itemsinteger · min: 1 · max: 1000Optional

items per page

Default: 10Example: 30

Responses

200

Success response

application/json

401

Unauthorized response

application/json

post

/claims/filter

HTTPcURLJavaScriptPython

POST /v2/claims/filter HTTP/1.1
Host: gw.new.skladon.net
authorization: text
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 194

{
  "page": 1,
  "items": 30,
  "columns": [
    "eshopClaimId",
    "claimCause",
    "status"
  ],
  "sorts": [
    {
      "column": "eshopClaimId",
      "direction": "DESC"
    }
  ],
  "filters": [
    [
      {
        "column": "claimCause",
        "operator": "eq",
        "value": "lost"
      }
    ]
  ]
}

{
  "statusCode": 200,
  "message": "text",
  "data": {
    "data": [
      {
        "eshopClaimId": "text",
        "eshopOrderId": "text",
        "description": "text",
        "note": "text",
        "eshopNote": "text",
        "claimCause": "lost",
        "claimCauseOthersType": "text",
        "files": [
          {
            "fileName": "invoice.pdf",
            "fileType": "invoice",
            "fileSize": "text",
            "type": "invoice",
            "data": "someBase64",
            "id": 1
          }
        ]
      }
    ],
    "request": {
      "page": 1,
      "items": 30,
      "columns": [
        "eshopClaimId",
        "claimCause",
        "status"
      ],
      "sorts": [
        {
          "column": "eshopClaimId",
          "direction": "DESC"
        }
      ],
      "filters": [
        [
          {
            "column": "claimCause",
            "operator": "eq",
            "value": "lost"
          }
        ]
      ]
    },
    "totalCount": 430
  }
}

Get claim

get

Authorizations

authorization & XApiKey

authorizationstringRequired

x-api-keystringRequired

Path parameters

eshopClaimIdstringRequired

Header parameters

x-api-keystringRequired

This is the eshop key you receive during onboarding.

authorizationstringRequired

Token you get from calling /users/login

Responses

200

Success response

application/json

401

Unauthorized response

application/json

404

Not found response

application/json

get

/claims/{eshopClaimId}

HTTPcURLJavaScriptPython

GET /v2/claims/{eshopClaimId} HTTP/1.1
Host: gw.new.skladon.net
authorization: text
x-api-key: text
Accept: */*

{
  "statusCode": 200,
  "message": "text",
  "data": {
    "eshopClaimId": "text",
    "eshopOrderId": "text",
    "description": "text",
    "note": "text",
    "eshopNote": "text",
    "claimCause": "lost",
    "claimCauseOthersType": "text",
    "files": [
      {
        "fileName": "invoice.pdf",
        "fileType": "invoice",
        "fileSize": "text",
        "type": "invoice",
        "data": "someBase64",
        "id": 1
      }
    ],
    "products": [
      {
        "claimedQuantity": 1,
        "sku": "text",
        "lineState": "E",
        "resendQuantity": 1
      }
    ],
    "transportPrice": 2990,
    "goodsPrice": 2990,
    "totalServicePrice": 2990,
    "compensationCurrency": "CZK",
    "status": "received"
  }
}

Create claim

post

Authorizations

authorization & XApiKey

authorizationstringRequired

x-api-keystringRequired

Header parameters

x-api-keystringRequired

This is the eshop key you receive during onboarding.

authorizationstringRequired

Token you get from calling /users/login

Body

application/json

eshopClaimIdstring · min: 1Required

eshopOrderIdstring · min: 1Required

descriptionstring · min: 1Required

notestring · min: 1Optional

eshopNotestringOptional

Note from e-shop that is not shown to the customer

claimCausestring · enumRequiredPossible values:

claimCauseOthersTypestring · min: 1Optional

Responses

200

Success response

application/json

401

Unauthorized response

application/json

404

Not found response

application/json

409

Conflict response

application/json

post

/claims

HTTPcURLJavaScriptPython

POST /v2/claims HTTP/1.1
Host: gw.new.skladon.net
authorization: text
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 326

{
  "eshopClaimId": "text",
  "eshopOrderId": "text",
  "description": "text",
  "note": "text",
  "eshopNote": "text",
  "claimCause": "lost",
  "claimCauseOthersType": "text",
  "files": [
    {
      "fileName": "invoice.pdf",
      "fileType": "invoice",
      "fileSize": "text",
      "type": "invoice",
      "data": "someBase64"
    }
  ],
  "products": [
    {
      "claimedQuantity": 1,
      "sku": "text",
      "lineState": "E"
    }
  ]
}

{
  "statusCode": 200,
  "message": "text",
  "data": {
    "eshopClaimId": "text",
    "eshopOrderId": "text",
    "description": "text",
    "note": "text",
    "eshopNote": "text",
    "claimCause": "lost",
    "claimCauseOthersType": "text",
    "files": [
      {
        "fileName": "invoice.pdf",
        "fileType": "invoice",
        "fileSize": "text",
        "type": "invoice",
        "data": "someBase64",
        "id": 1
      }
    ],
    "products": [
      {
        "claimedQuantity": 1,
        "sku": "text",
        "lineState": "E",
        "resendQuantity": 1
      }
    ],
    "transportPrice": 2990,
    "goodsPrice": 2990,
    "totalServicePrice": 2990,
    "compensationCurrency": "CZK",
    "status": "received"
  }
}

Update claim

put

Authorizations

authorization & XApiKey

authorizationstringRequired

x-api-keystringRequired

Path parameters

eshopClaimIdstringRequired

Header parameters

x-api-keystringRequired

This is the eshop key you receive during onboarding.

authorizationstringRequired

Token you get from calling /users/login

Body

application/json

eshopClaimIdstring · min: 1Required

eshopOrderIdstring · min: 1Required

descriptionstring · min: 1Required

notestring · min: 1Optional

eshopNotestringOptional

Note from e-shop that is not shown to the customer

claimCausestring · enumRequiredPossible values:

claimCauseOthersTypestring · min: 1Optional

Responses

200

Success response

application/json

401

Unauthorized response

application/json

404

Not found response

application/json

put

/claims/{eshopClaimId}

HTTPcURLJavaScriptPython

PUT /v2/claims/{eshopClaimId} HTTP/1.1
Host: gw.new.skladon.net
authorization: text
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 269

{
  "eshopClaimId": "text",
  "eshopOrderId": "text",
  "description": "text",
  "note": "text",
  "eshopNote": "text",
  "claimCause": "lost",
  "claimCauseOthersType": "text",
  "files": [
    {
      "fileName": "invoice.pdf",
      "fileType": "invoice",
      "fileSize": "text",
      "type": "invoice",
      "data": "someBase64",
      "id": 1
    }
  ]
}

{
  "statusCode": 200,
  "message": "text",
  "data": {
    "eshopClaimId": "text",
    "eshopOrderId": "text",
    "description": "text",
    "note": "text",
    "eshopNote": "text",
    "claimCause": "lost",
    "claimCauseOthersType": "text",
    "files": [
      {
        "fileName": "invoice.pdf",
        "fileType": "invoice",
        "fileSize": "text",
        "type": "invoice",
        "data": "someBase64",
        "id": 1
      }
    ],
    "products": [
      {
        "claimedQuantity": 1,
        "sku": "text",
        "lineState": "E",
        "resendQuantity": 1
      }
    ],
    "transportPrice": 2990,
    "goodsPrice": 2990,
    "totalServicePrice": 2990,
    "compensationCurrency": "CZK",
    "status": "received"
  }
}