Lost orders

Creating a lost order

The “Lost orders” tool allows you to add and view requests for orders that you think belong to you but failed to be displayed in your sales stats. The advertiser will re-evaluate whether the sale should indeed be attributed to you.

Parameters

HTTP METHOD	AUTHORIZATION	URL	PARAMETERS	NOTE
POST	Authorization: Bearer {token}	https://gs.kit.global/api/v1/lost-orders/	List of parameters	JSON response

Your authorization token can be found in the XML API section.

List of parameters for the request

TITLE	TYPE	MANDATORY	PARAMETER LIMITS	ACCEPTABLE VALUES
order_id	string	Yes	Maximum length 255 characters
order_date	date	Yes	Over the past 3 months	%d.%m.%Y или %Y-%m-%d
order_total	float	Yes	2 characters after the floating point
merchant_id	integer	Yes		List of advertisers
attachment	file	Yes	JPEG/JPG/PNG/PDF, size not over 10MB
description	string	No	Maximum length 255 characters

Example of use

An example request using the curl utility:

curl -L -H 'Authorization: Bearer {access_token}' -X POST https://gs.kit.global/api/v1/lost-orders/
-F 'order_id=GS123L' \
-F 'order_date=24.07.2018' \
-F 'order_total=554.34' \
-F 'merchant_id=54376' \
-F 'attachment=@/example/FS859YVnMiY.jpg' \
-F 'description=really my order'

An example of a JSON API server response:

{
    "id": 5796,
    "order_id": "2342lost",
    "order_date": "2021-06-28",
    "description": "Creating the item with API",
    "attachment": "http://https://gs.kit.global/api/v1/lost-orders/",
    "merchant_id": 54376,
    "merchant_name": "merchant.com",
    "order_updated_date": "2021-07-27",
    "order_total": 12020.22,
    "order_status": "in_waiting",
    "ticket_state": "in_work"
}

Description of API server response fields:

TITLE	DESCRIPTION
`id`	Request ID
`order_id`	Order number
`order_date`	Order date
`description`	Request description
`attachment`	Uploaded file path
`merchant_id`	Advertiser ID
`merchant_name`	Advertiser name
`order_updated_date`	Order update date
`order_total`	Order amount
`order_status`	Order status
`ticket_state`	Request status

List of lost orders