NAV undefined
undefined O'zbekcha English Русский
bash

Введение

Api Url http://api.bts.uz:8080/index.php

Version 1.0 End point http://api.bts.uz:8080/index.php

Mahalliy Buyurtmalar

Создать заявку

curl
--request POST \
--url "http://api.bts.uz:8080/index.php?r=v1/order/add" \
--header "Authorization: Bearer <token>"
--header 'content-type: application/json'
--data{
         "senderDelivery":1,
         "senderCityId":3,
         "senderAddress":"г.Ташкент,ул.Бобур,5-А",
         "senderReal":"Jurabek Turdiyev",
         "senderPhone":"+998 99 1234567",
         "weight":2,
         "packageId":4,
         "postTypeId":16,
         "postTypes":[
              {
                  "name": "Книга",
                  "code": "ZFD21AD",
                  "count": 1
              },
              {
                  "name": "Блокнот",
                  "code": "AV2321",
                  "count": 2
              }
         ],
         "receiverDelivery":1,
         "receiver":"Odil Ahkmedov",
         "receiverCityId":3,
         "receiverAddress":"Гозо зима. 41 дом",
         "clientId":abc123mn12,
         "volume":0,
         "takePhoto":1,
         "piece":1,
         "senderDate":"2018-02-06",
         "receiverDate":"2018-02-07",
         "receiverPhone":"+998 99 1234567",
         "receiverPhone1":null,
        }

SUCCESS

{
    "orderId": 229234,
    "customer": {
        "id": 79,
        "name": "ООО JOHD "
    },
    "status": {
        "id": 1,
        "info": "В клиенте"
    },
    "senderRegion": {
        "id": 2,
        "name": "Андижанская область"
    },
    "senderCity": {
        "id": 3,
        "name": "Асакинский район",
        "regionId": 2
    },
    "senderBranch": {
        "id": 93,
        "name": "ASAKA BTS"
        "regionId": 2
    },
    "senderDelivery": 1,
    "senderAddress": "г.Ташкент,ул.Бабаева,7-А",
    "senderReal": "Jurabek Turdiyev",
    "senderPhone": "+998 99 1234567",
    "receiver": "Odil Ahkmedov",
    "receiverRegion": {
        "id": 2,
        "name": "Андижанская область"
    },
    "receiverCity": {
        "id": 3,
        "name": "Асакинский район"
    },
    "receiverBranch": {
        "id": 93,
        "name": "ASAKA BTS"
        "regionId": 2
    },
    "receiverDelivery": 1,
    "receiverAddress": "Гозо зима. 41 дом",
    "receiverPhone": "+998 99 1234568",
    "receiverPhone1": null,
    "package": {
        "id": 8,
        "name": "BTS ПАКЕТИ"
    },
    "postType": {
        "id": 4,
        "name": "ДОКУМЕНТЫ"
    },
    "cost": "12000.00",
    "weight": "2.000",
    "piece": 1,
    "clientId": abc123mn12,
    "volume": 0,
    "takePhoto": 0,
    "senderSign": null,
    "receiverSign": null,
    "senderDate": "2018-02-06",
    "receiverDate": "2018-02-07",
    "barcode": "60000006106"
    "labelEncode": "<encoded_file>"
}

Failure Validation error

{
"errors": {
    "senderPhone": [
        "Необходимо заполнить «Телефон»."
    ],
    "weight": [
        "Необходимо заполнить «Кг»."
    ]
}
}

HTTP Request

POST /order/add

Query Parameters

Parameter Type Description
senderCityId* integer Город отправителя. Список городов
senderAddress* string Адрес отправителя
senderDelivery integer 1-Вызов курьера, 0-самовывоз в офис BTS.
senderReal* string Ф.И.О отправителя
senderPhone* string Телефон номер отправителя
weight* double вес отправки
packageId* integer вид упаковки. Виды упаковок
postTypeId* integer тип отправки Типы отправок
receiver* string Ф.И.О получателя
receiverAddress* string Адрес получателя
receiverDelivery integer 1-Если курьер доставит, 0- если получатель сам забирает с офиса BTS.
receiverCityId* integer Город получателя. Список городов
receiver_branch_id integer receiverDelivery = 0 yuborilsa receiver_branch_id qiymatiga "receiverCityId" da mavjud bolgan ofis "id"si biriktiriladiСписок филиалов
clientId string Штрих-код клиента
volume number объем (объем = длина*высота*ширина) отправки
takePhoto integer 1 - требуется фото получателя, 0 - необизаятелно. поумолчание 0. Принимаемые значения
is_test integer 1 - для тестирования, 0 - необизаятелно. поумолчание 0. Принимаемые значения
senderSign string подпись Отправителя
receiverSign string подпись получателя
piece integer место отправки, поумолчание 1
senderDate date Дата отправки, поумолчанию дата завяки
receiverDate date Дата получения, поумолчанию дата завяки
receiverPhone* string Телефон получателя
receiverPhone1 string Дополнительные телефон номер получателя
bringBackMoney integer 1-надо вернут денги за товарь, 0 - нет наложенные платеж.
back_money integer надо указать сумму при bringBackMoney равно 1.
bringBackWaybill integer 1-надо возврат документ
additionalInfo string Комментария (Один экземпляр документа возвращается)
labelEncode string Shtrix-kod (fayl)

Информация о заявке

Http request

GET /order/detail&id=<orderId>

Parameter Type Description
orderId integer Номер заказа 
curl
--request GET \
--url "http://api.bts.uz:8080/index.php?r=v1/order/detail&id=<orderId>" \
--header "Authorization: Bearer <token>"

JSON формат:

{
    "orderId": "<orderId>",
    "customer": {
        "id": 79,
        "name": "ООО JOHD "
    },
    "status": {
        "id": 1,
        "info": "В клиенте"
    },
    "senderRegion": {
        "id": 2,
        "name": "Андижанская область"
    },
    "senderCity": {
        "id": 3,
        "name": "Асакинский район",
        "regionId": 2
    },
    "senderBranch": {
        "id": 93,
        "name": "ASAKA BTS"
        "regionId": 2
    },
    "senderDelivery": 1,
    "senderAddress": "г.Ташкент,ул.Бабаева,7-А",
    "senderPhone": "+998 99 1234567",
    "receiver": "Odil Ahkmedov",
    "receiverRegion": {
        "id": 2,
        "name": "Андижанская область"
    },
    "receiverCity": {
        "id": 3,
        "name": "Асака туман"
    },
    "receiverBranch": {
        "id": 93,
        "name": "ASAKA BTS"
        "regionId": 2
    },
    "receiverDelivery": 1,
    "receiverAddress":"Гозо зима. 41 дом",
    "receiverPhone": "+998 99 1234568",
    "receiverPhone1": null,
    "package": {
        "id": 8,
        "name": "BTS ПАКЕТИ"
    },
    "postType": {
        "id": 4,
        "name": "ДОКУМЕНТЫ"
    },
    "cost": "12000.00",
    "weight": "2.000",
    "piece": 1,
    "volume": "0",
    "urgent": 0,
    "takePhoto": 0,
    "senderSign": null,
    "receiverSign": null,
    "senderDate": "2018-02-06",
    "receiverDate": "2018-02-07",
    "barcode": "60000006106"
    "labelEncode": "<encoded_file>"

    
}

Удалить заявку

Http request

GET /order/cancel&id=<orderId>

Parameter Type Description
orderId integer Номер заказа 
curl
--request GET \
--url "http://api.bts.uz:8080/index.php?r=v1/order/cancel&id=<orderId>" \
--header "Authorization: Bearer <token>"

JSON формат:

{
    "orderId": "229234",
    "status": {
        "id": 0,
        "name": "Cancelled Order"
    },
}

Калькулятор заявки

Цена заявки.

Http Request

POST /order/calculate

curl
--request POST \
--url "http://api.bts.uz:8080/index.php?r=v1/order/calculate" \
--header "Authorization: Bearer <token>"\
--data
{
    "senderCityId": 3,
    "receiverCityId": 3,
    "weight": 1,
    "volume": null,
    "senderDate": "2018-02-06",
    "senderDelivery": 1,
    "receiverDelivery": 1
}

SUCCESS

{
    "summaryPrice": 10000,
    "requestData": {
        "weight": 1,
        "volume": null,
        "senderCityId": 3,
        "receiverCityId": 3,
        "senderDate": "2018-02-06",
        "senderDelivery": 1,
        "receiverDelivery": 1
    }
}

FAILURE

{
    "errors": {
        "senderCityId": [
            "Необходимо заполнить «Город от-я»."
        ]
    }
}
Parameter Type Description
senderCityId* integer Город отправителя. Список городов
weight* double вес отправки
receiverCityId* integer Город получателя. Список городов
volume number объем (объем = длина*высота*ширина) отправки
senderDate date Дата отправки, поумолчанию дата завяки
senderDelivery integer 2-Вызов курьера(с дальнего посёлка), 1-Вызов курьера(город), 0-самовывоз в офис BTS.
receiverDelivery integer 2-Если курьер доставит(с дальнего посёлка), 1-Если курьер доставит(город), 0- если получатель сам забирает с офиса BTS.

Текущее состояние

Http request

GET /order/track&id=<orderId>

curl
--request GET \
--url "http://api.bts.uz:8080/index.php?r=v1/order/track&id=<orderId>" \
--header "Authorization: Bearer <token>"
Parameter Type Description
orderId integer ID заявки

SUCCESS

{
    "orderId": 229234,
    "status": {
        "id": 1,
        "name": "new"
    }
}

Отслеживание

Http request

GET /order/history&id=<orderId>

Parameter Type Description
orderId integer ID заявки 
curl
--request GET \
--url "http://api.bts.uz:8080/index.php?r=v1/order/history&id=<orderId>" \
--header "Authorization: Bearer <token>"

SUCCESS:

{
   {
    "message": "message1",
    "timestamp": 1720690236,
    "status_id": 4,
    "location": "QUSHBEGI BTS (PVZ)"
   },
   {
    "message": "message2",
    "timestamp": 1720690321,
    "status_id": 5,
    "location": "JARQO'RG'ON BTS"
   },
}

Причины отмены

Http request

GET v1/order/cancellation&id=<orderId>

Parameter Type Description
orderId integer ID заявки 
curl
--request GET \
--url "http://api.bts.uz:8080/index.php?r=v1/order/cancellation&id=<orderId>" \
--header "Authorization: Bearer <token>"

SUCCESS:

[
   {
    "employee": "Jon Done",
    "description": "Saqlash muddati tugagan",
    "date": 2024-08-20 14:29:06
   },
   {
    "employee": "Jon Done",
    "description": "Noto`g`ri manzil",
    "date": 2024-08-23 14:29:06
   }
]

Список статусов

id info
0 Отказ
1 У отправителя
2 Курьер принял
3 В офисе отправления
4 В офисе доставки
5 Курьер доставляет
6 Доставлен
7 Возврат
8 В промежуточном офисе
10 В сортировочном центре (РЦ)
31 На складе
32 В мешке
33 В перевозке
34 В РЦ Курьера

Заявки Международный

Создать заявку

curl
--request POST \
--url "http://api.bts.uz:8080/index.php?r=v1/international/add" \
--header "Authorization: Bearer <token>"
--header 'content-type: application/json'
--data{
         "ParcelNumber":"366489851",
         "ReceiverPhone":"+998 99 1234567",
         "ReceiverPhone1":"+998 88 1234567",
         "ReceiverPatronymic":"Johnson",
         "ReceiverSurname":"Elizabeth"
         "ReceiverFirstName":"Emily",
         "ReceiverPassposrtSerial":"AC",
         "ReceiverPassposrtNumber":"0579415",
         "ReceiverPinfl":"12345678912345",
         "ReceiverAddress":"г.Ташкент,ул.Бобур,5-А",
         "ReceiverCustomsAgree":"1",
         "ParcelWeight":"13",
         "ParcelValue":"3",
         "ParcelDeclareCurrency":"RUB",
         "ReceiverCityId":"3",
         "ReceiverBranchId":62,
         "ReceiverDelivery":0,
         "products":{
            {
                "ProductDescription":"Футболка1",
                "ProductDescriptionRu":"ФутболкаRu1",
                "ProductQuantity":"2",
                "ProductWeight":"4",
                "ProductDeclareValue":"1",
                "ProductUrl":"url1",
                "ProductUnit":"kg",
                "HsCodeIs":"6211390000",
                "ProductModel":"2324345",
                "ProductImei":"2342342341245",
            },
            {
                "ProductDescription":"Футболка2",
                "ProductDescriptionRu":"ФутболкаRu2",
                "ProductQuantity":"1",
                "ProductWeight":"5",
                "ProductDeclareValue":"1",
                "ProductUrl":"url2",
                "ProductUnit":"kg",
                "HsCodeIs":"546567565",
                "ProductModel":"6523434",
                "ProductImei":"324234523412",
            },
            {
                ....
            }
         }
        }

SUCCESS

{
    "ParcelNumber": "366489851"
    "ReceiverPhone": "+998 99 1234567",
    "ReceiverPhone1": "+998 88 1234567",
    "ReceiverPatronymic": 2,
    "ReceiverSurname": Elizabeth,
    "ReceiverFirstName": Emily,
    "ReceiverPassposrtSerial": AC,
    "ReceiverPassposrtNumber": 0579415,
    "ReceiverPinfl": 12345678912345,
    "ReceiverAddress":"г.Ташкент,ул.Бобур,5-А",
    "ReceiverCustomsAgree": 1,
    "ParcelWeight": "4"
    "ParcelValue": "312412 "
    "ParcelDeclareCurrency": "RUB"
    "ReceiverDelivery": 0,
    "branch": {
        "ReceiverBranchId": 62,
        "name": "ASAKA BTS"
    },
    "city": {
        "ReceiverCityId": 3,
        "name": "Асакинский район"
    },
    "products": {
        {
            "ProductDescription": "Футболка1",
            "ProductDescriptionRu": "ФутболкаRu1",
            "ProductQuantity": "2",
            "ProductWeight": "4",
            "ProductDeclareValue": "1",
            "ProductUrl": "url1",
            "ProductUnit": "kg",
            "HsCodeIs": "6211390000",
            "ProductModel": "2324345",
            "ProductImei": "2342342341245"
        },
        {
            "ProductDescription": "Футболка2",
            "ProductDescriptionRu": "ФутболкаRu2",
            "ProductQuantity": "1",
            "ProductWeight": "5",
            "ProductDeclareValue": "1",
            "ProductUrl": "url2",
            "ProductUnit": "kg",
            "HsCodeIs": "546567565",
            "ProductModel": "6523434",
            "ProductImei": "324234523412"
        },
        {
            ....
        }
    },
}

Failure Validation error

{
"errors": {
    "ReceiverPhone": [
        "Необходимо заполнить «Телефон»."
    ],
    "ParcelWeight": [
        "Необходимо заполнить «Кг»."
    ]
}
}

HTTP Request

POST /international/add

Query Parameters

Parameter Type Description
ParcelNumber* string _ParcelNumber
ReceiverPhone* string _ReceiverPhone
ReceiverPhone1 string _ReceiverPhone1
ReceiverPatronymic string _ReceiverPatronymic
ReceiverSurname* string _ReceiverSurname
ReceiverFirstName* string _ReceiverFirstName
ReceiverPassposrtSerial* string _ReceiverPassposrtSerial
ReceiverPassposrtNumber* string _ReceiverPassposrtNumber
ReceiverPinfl* string _ReceiverPinfl
ReceiverAddress string _ReceiverAddress
ReceiverCustomsAgree string _ReceiverCustomsAgree
ParcelWeight* string _ParcelWeight
ParcelValue string _ParcelValue
ParcelDeclareCurrency* string _ParcelDeclareCurrency
ReceiverCityId integer Город получателя. Список городов
ReceiverBranchId integer receiverDelivery = 0 yuborilsa receiver_branch_id qiymatiga "receiverCityId" da mavjud bolgan ofis "id"si biriktiriladiСписок филиалов
ReceiverDelivery* string 1-Вызов курьера, 0-самовывоз в офис BTS.
products array Product_array
ProductDescription* text _ProductDescription
ProductDescriptionRu* text _ProductDescriptionRu
ProductQuantity* string _ProductQuantity
ProductWeight* string _ProductWeight
ProductDeclareValue* string _ProductDeclareValue
ProductUrl* string _ProductUrl
ProductUnit* string Weight:Kilogram (kg),Gram (g),Tonne (t). Quantity: Piece (pcs). Volume: Litre (L), Millilitre (mL), Cubic meter (m³)
HsCodeIs* string _HsCodeIs
ProductModel string _ProductModel
ProductImei string _ProductImei

Текущее состояние

Http request

GET /international/track-by-barcode&barcode=<barcode>

curl
--request GET \
--url "http://api.bts.uz:8080/index.php?r=v1/international/track-by-barcode&barcode=<barcode>" \
--header "Authorization: Bearer <token>"
Parameter Type Description
barcode string Штрих-код заявки

SUCCESS

{
    "barcode": 01000865704,
    "status": {
        "code": 200,
        "message": "In the sorting center"
    }
}

Манифест

curl
--request POST \
--url "http://api.bts.uz:8080/index.php?r=v1/international/manifest" \
--header "Authorization: Bearer <token>"
--header 'content-type: application/json'
--data{
         "ManifestNumber":"12345672121",
         "Parcels"{
            {
                "ParcelNumber":"867465466877546"
            },
            {
                "ParcelNumber":"543655876765767"
            }
         },
         "ManifestDetails"{
                "ParcelsCount":"2",
                "Date":"2024-10-10"
         },
        }

SUCCESS

{
    "success": true,
    "message": "Manifest processed successfully.."
}

Failure Validation error

{
"errors": {
    "ManifestNumber": [
        "ManifestNumber cannot be blank.."
    ],
    "ParcelsCount": [
        "ParcelsCount cannot be blank.."
    ]
}
}

HTTP Request

POST /international/manifest

Query Parameters

Parameter Type Description
ManifestNumber* string _ManifestNumber
Date* string Date
ParcelNumber* string ParcelNumber
ParcelsCount* string ParcelsCount

Список статусов

code info
100 Yuboruvchida
110 Bojxonaga kirdi
120 Bojxonadan chiqdi
130 Bojxona tomonidan bekor qilindi
200 Saralash markazida
300 Qabul qiluvchi ofisida
400 Kuryer yetkazmoqda
500 Yetkazib berildi

Справочник

Список городов

id regionId Название товара должно быть заполнено
1 14 город Шахрисабз
2 3 Папский район
3 2 Асакинский район
4 5 Ташкентский район
5 5 город Янгийуль
6 5 город Ахангаран
7 5 город Нурафшон
8 11 город Нукус
9 11 Тахиаташский район
10 4 город Хива
11 11 Амударьинский район
12 11 Берунийский район
13 11 Кандикульский район
14 11 Караузякский район
15 11 Кегейлийский район
16 11 Кунградский район
17 11 Муйнакский район
18 11 Нукусский район
19 11 Тахтакупырский район
20 11 Турткульский район
21 11 Ходжейлийский район
22 11 Чимбайский район
23 11 Шуманайский район
24 11 Элликкалинский район
25 2 город Андижан
26 2 город Ханабад
27 2 Андижанский район
28 2 Балыкчинский район
29 2 Булакбашинский район
30 2 Бозский район
31 2 Джалалкудукский район
32 2 Избасканский район
33 2 Улугнорский район
34 2 Мархаматский район
35 2 Пахтаабадский район
36 2 Ходжаабадский район
37 2 Алтынкульский район
38 2 Кургантепинский район
39 2 Шахриханский район
40 7 город Бухара
41 7 город Каган
42 7 Бухарский район
43 7 Бабкентский район
44 7 Джандарский район
45 7 Каганский район
46 7 Алатский район
47 7 Пешкунский район
48 7 Ромитанский район
49 7 Шафирканский район
50 7 Каракульский район
51 7 Караулбазарский район
52 7 Гиждуванский район
53 9 Арнасайский район
54 9 Бахмальский район
55 9 Галляаральский район
56 9 Дустликский район
57 9 город Джизак
58 9 Жиззах
59 9 Зарбдорский район
60 9 Зафарабадский район
61 9 Заминский район
62 9 Мирзачульский район
63 9 Пахтакорский район
64 9 Фаришский район
65 9 Янгиабадский район
66 14 город Карши
67 14 Каршинский район
68 14 Мубарекский район
69 14 Гузарский район
70 14 Камашинский район
71 14 Чиракчинский район
72 14 Шахризабский район
73 14 Касбинский район
74 14 Касанский район
75 14 Китабский район
76 14 Нишанский район
77 14 Миришкорский район
78 14 Дехканабадский район
79 14 Яккабагский район
80 10 город Навойи
81 10 город Заравшан
82 10 Карманинский район
83 10 Тамдынский район
84 10 Навбахорский район
85 10 Нуратинский район
86 10 Хатырчинский район
87 10 Кызылтепинский район
88 10 Кенимехский район
89 10 город Учкудук
90 3 город Наманган
91 3 Мингбулакский район
92 3 Касансайский район
93 3 Наманганский район
94 3 Нарынский район
95 3 Туракурганский район
96 3 Уйчинский район
97 3 Учкурганский район
98 3 Чартакский район
99 3 Чустский район
100 3 Янгикурганский район
101 8 город Самарканд
102 8 Ургутсский район
103 8 Пахтаачинский район
104 8 Каттакурганский район
105 8 Самаркандский район
106 8 Булунгурский район
107 8 Джамбайский район
108 8 Кошрабадский район
109 8 Нарпайский район
110 8 Тайлякский район
111 8 Пастдаргомский район
112 8 Нуробадский район
113 8 город Каттакурган
114 8 Пайарыкский район
115 8 Акдарьинский район
116 8 Иштыханский район
117 13 город Термез
118 13 Термезский район
119 13 Музрабадский район
120 13 Алтынсайский район
121 13 Денаусский район
122 13 Сарыассийский район
123 13 Кизирикский район
124 13 Джаркурганский район
125 13 Ангорский район
126 13 Кумкурганский район
127 13 Байсунский район
128 13 Шурчинский район
129 13 Шерабадский район
130 13 Узунский район
131 12 город Гулистан
132 12 город Янгиер
133 12 город Ширин
134 12 Окалтынский район
136 12 Гулистанский район
137 12 Мирзаабадский район
138 12 Сайхунабадский район
139 12 Сардобинский район
140 12 Сырдарьинский район
141 12 Хавастский район
142 5 город Ангрен
143 5 город Бекабад
144 5 город Алмалык
145 5 город Чирчик
146 5 Бекабадский район
147 5 Бостанлыкский район
148 5 Кибрайский район
149 5 Зангиатинский район
150 5 Куйи-чирчикский район
151 5 Аккурганский район
152 5 Паркентский район
154 5 Урта-чирчикский район
155 5 Чиназский район
156 5 Юкори чирчикский район
157 5 Букинский район
158 5 Янгийульский район
159 5 Ахангаранский район
160 15 город Фергана
161 15 город Маргилан
162 15 город Кувасай
163 15 город Коканд
164 15 Багдадский район
165 15 Бувайдинский район
166 15 Дангаринский район
167 15 Язьяванский район
168 15 Алтыарыкский район
169 15 Бешарыкский район
170 15 Куштепинский район
171 15 Риштанский район
172 15 Сохский район
173 15 Ташлакский район
174 15 Учкуприкский район
175 15 Ферганский район
176 15 Узбекистанский район
177 15 Кувинский район
178 15 Фуркатский район
179 4 город Ургенч
180 4 Багатский район
181 4 Ургенчский район
182 4 Кушкупырский район
183 4 Ханкинский район
184 4 Янгиарыкский район
185 4 Хивинский район
186 4 Янгибазарский район
187 4 Хазараспский район
188 4 Шаватский район
189 4 Гурленский район
190 6 Бектемирский район
191 6 Мирабадский район
192 6 М.Улугбекский район
193 6 Сергелийсикй район
194 6 Алмазарский район
195 6 Учтепинский район
196 6 Яшнабадский район
197 6 Чилонзарский район
198 6 Шайхантахурский район
199 6 Юнусабадский район
200 6 Яккасарайский район
201 5 Пскентский район
167 15 Ёзёвон туман
58 9 Шароф Рашидов
217 11 Бўзатов тумани
14 11 Қораузак туман
219 14 Kokdala tumani
218 4 Тупроққалъа туман
135 12 Боёвут туман
220 13 Бандихон

Регионы

id name
4 Хорезмская область
15 Ферганская область
5 Ташкентская область
6 Ташкент
12 Сырдарьинская область
13 Сурхандарьинская область
8 Самаркандская область
3 Наманганская область
10 Навоийская область
14 Кашкадарьинская область
11 Каракалпакстан
9 Джизакская область
7 Бухарская область
2 Андижанская область

Филиалы

Http request

GET /directory/branches&regionId=<Id>

Parameter Type Description
regionId integer Номер региона (Не обязательно) 
curl
--request GET \
--url "http://api.bts.uz:8080/index.php?r=directory/branches&regionId=<Id>" \
--header "Authorization: Bearer <token>"

JSON формат:

{
  {
    "id": 10,
    "name": "KARSHI BTS",
    "regionId": 14,
    "cityId": 66,
    "address": "KARSHI 5-Mikro rayon ul. Nasaf. or: Nikoh uyi orqa tomoni ",
    "lat_long": "38.837395,65.783467",
    "phone": "1230",
    "video_link": "https://youtu.be/g6TsS5PLTF0",
    "working_hours": {
        "1": "08:00-20:00",
        "2": "08:00-20:00",
        "3": "08:00-20:00",
        "4": "08:00-20:00",
        "5": "08:00-20:00",
        "6": "08:00-16:00",
        "7": "08:00-16:00"
    }
  },
}

Филиалы (cityId)

Http request

GET /directory/branches-with-city&cityId=<Id>

Parameter Type Description
cityId integer Номер города (Не обязательно) 
curl
--request GET \
--url "http://api.bts.uz:8080/index.php?r=directory/branches-with-city&cityId=<Id>" \
--header "Authorization: Bearer <token>"

JSON формат:

{
  {
    "id": 79,
    "name": "MALIKA BOZOR BTS",
    "regionId": 6,
    "cityId": 198,
    "address": "Toshkent, Labzak ko'ch 2/122. Mag 118 or: Tramvay aylanasi",
    "lat_long": "41.338727,69.269875",
    "phone": "1230",
    "video_link": "",
    "working_hours": {
        "1": "09:00-18:00",
        "2": "09:00-18:00",
        "3": "09:00-18:00",
        "4": "09:00-18:00",
        "5": "09:00-18:00",
        "6": "09:00-18:00",
        "7": "09:00-18:00"
    }
  },
  {
    "id": 24,
    "name": "SHAYXONTOHUR BTS",
    "regionId": 6,
    "cityId": 198,
    "address": "TASHKENT, ul. Furkat 6. Mo'ljal: Xadra,Asaka Bankni orqasi",
    "lat_long": "41.319124,69.240262",
    "phone": "1230",
    "video_link": "https://youtu.be/g6TsS5PLTF0",
    "working_hours": {
        "1": "27/7",
        "2": "27/7",
        "3": "27/7",
        "4": "27/7",
        "5": "27/7",
        "6": "27/7",
        "7": "27/7"
    }
  }
}

Типы отправок

id name
4 ДОКУМЕНТЫ
5 ЗАПЧАСТИ
6 МЕДИКАМЕНТЫ
7 ОРГТЕХНИКА
8 КНИГИ
9 СТЕКЛОИЗДЕЛИЯ
10 РЕКЛАМНЫЕ ИЗДЕЛИЯ
11 ОДЕЖДА-ОБУВИ
12 СОТ.ТЕЛЕФОН
13 ПАСПОРТ
14 ПАРФЮМЕРИЯ
15 ПРОДУКТЫ
16 ХИМИКАТЫ
17 ПРОТЕЗЫ ( ТИШ )
18 СЕМЕНА / УРУГЛАР
19 ПЛАСТИК КАРТА
20 ПЕЧАТЬ
21 САНТЕХНИКА
22 МЕБЕЛЬ
23 МЕД.ИНСТРУМЕНТ
24 ТКАНЬ - МАТЕРИАЛ
25 ОБОРУДОВАНИЕ
26 КАНЦТОВАРЫ
27 ХОЗТОВАРЫ
28 ИГРУШКИ
29 БИЖУТЕРИЯ
30 КОСМЕТИКА
31 БЫТОВАЯ ТЕХНИКА
32 СУХОФРУКТЫ
33 СТРОЙМАТЕРИАЛЫ

Виды упаковок

id name
4 СУМКА
5 КОНТЕЙНЕР
6 КОНВЕРТ
7 КОРОБКА
8 BTS ПАКЕТИ
9 БЕЗ УПАКОВКИ
10 ЗAВОДСКAЯ УПAКОВКA

Да или Нет

значения описания
1 Включено
0 Выключенный

Список статусов

id info
0 Отказ
1 У отправителя
2 Курьер принял
3 В офисе отправления
4 В офисе доставки
5 Курьер доставляет
6 Доставлен
7 Возврат
8 В промежуточном офисе
10 В сортировочном центре (РЦ)
31 На складе
32 В мешке
33 В перевозке
34 В РЦ Курьера

Fulfillment WMS

Http request

POST /auth

curl \
--request POST \
--url "http://wms.bts:8040/v1/auth/login" \
--header  "accept: "application/json"
--header  "Content-Type: "application/json"
--data '{
    "login": "login",
    "password": "password"
}'

SUCCESS:


  {
    "access_token": "string",
    "refresh_token": "string"
  }
Parameter Type Description
login string foydalanuvchi inn yoki tel raqam, tuldrish shart
password string parolni tuldirish shart

Создание поставщика

Http request

POST v1/purveyor/create

curl \
--request POST \
--url "http://wms.bts.uz:8040/v1/purveyor/create" \
--header  "Authorization: "Bearer token"
--header  "accept: "application/json"
--header  "Content-Type: "application/json"
--data '{
    "group": "group",
    "code": "code",
    "name": "name",
    "full_name": "full_name",
    "name_eng": "name_eng",
    "stock_percentage": "stock_percentage",
    "stock_expiry": "stock_expiry",
    "legal_entity": "legal_entity",
    "inn": "inn",
    "kpp": "kpp",
    "okpp": "okpp",
    "is_buyer": "is_buyer",
    "main_delivery_address": "main_delivery_address",
    "depositor": "depositor",
    "contract_number": "contract_number",
    "contract_date": "contract_date",
    "bank_details": "bank_details",
    "contact_info": "contact_info",
    "additional_details": "additional_details",
    "is_supplier": "is_supplier"
}'

SUCCESS:


  {
    "message": "Record successfully created.",
    "data": {
        "id": 14,
        "group": "string",
        "code": "string",
        "name": "string",
        "full_name": "string",
        "name_eng": "string",
        "contractBankDetail": {
            "id": 11,
            "supplier_buyer_id": 14,
            "contract_number": "string",
            "contract_date": "2024-11-11",
            "bank_details": "string",
            "contact_info": "string",
            "additional_details": "string",
            "main_delivery_address": "string"
        },
        "entityType": {
            "id": 11,
            "stock_percentage": "0.00",
            "stock_expiry": 0,
            "supplier_buyer_id": 14,
            "legal_entity": true
        },
        "supplierBuyerStatus": {
            "id": 11,
            "supplier_buyer_id": 14,
            "is_supplier": true,
            "is_buyer": true,
            "depositor": true
        },
        "taxInfo": {
            "id": 11,
            "supplier_buyer_id": 14,
            "inn": "string",
            "kpp": "string",
            "okpo": "string"
        },
        "_links": {
            "self": {
                "href": "http:/wms.bts.uz:8040/v1/purveyor/view?id=14"
            }
        }
    }
}
Parameter Type Description
group string Группа товаров обязательна
code string Необходимо ввести код продукта
name string Название товара должно быть заполнено
full_name string Полное наименование товара обязательно.
name_eng string Английское название (название продукта на английском языке)
stock_percentage string Процент резерва доступности
stock_expiry string Действует до
legal_entity boolean Юридическое/физическое лицо (Da/Net)
inn integer Идентификационный номер налогоплательщика (ИНН)
kpp integer Регистрационный код компании
okpp integer Поставщик:
is_buyer boolean Клиент (Да/Сеть)
main_delivery_address string Основной адрес доставки
depositor boolean Кладовщик (кладовщик, ответственный за товар)
contract_number integer Номер контракта
contract_date string Дата контракта
bank_details string Банковские реквизиты
contact_info string Контактная информация
additional_details string Дополнительная информация
is_supplier boolean Поставщик (Да/Сеть)

Список поставщиков

Http request

GET v1/purveyor/clients

curl \
--request GET \
--url "http://wms.bts.uz:8040/v1/purveyor/clients" \
--header  "Authorization: "Bearer token"
--header  "accept: "application/json"
--header  "Content-Type: "application/json"

SUCCESS:


  {
    "message": "Data successfully retrieved.",
    "data": {
        "items": [
            {
                "id": 12,
                "group": "string",
                "code": "string",
                "name": "string",
                "full_name": "string",
                "name_eng": "string",
                "contractBankDetail": {
                    "id": 9,
                    "supplier_buyer_id": 12,
                    "contract_number": "string",
                    "contract_date": "2024-10-10",
                    "bank_details": "string",
                    "contact_info": "string",
                    "additional_details": "string",
                    "main_delivery_address": "string"
                },
                "entityType": {
                    "id": 9,
                    "stock_percentage": "20.00",
                    "stock_expiry": 0,
                    "supplier_buyer_id": 12,
                    "legal_entity": true
                },
                "supplierBuyerStatus": {
                    "id": 9,
                    "supplier_buyer_id": 12,
                    "is_supplier": true,
                    "is_buyer": true,
                    "depositor": true
                },
                "taxInfo": {
                    "id": 9,
                    "supplier_buyer_id": 12,
                    "inn": "string",
                    "kpp": "string",
                    "okpo": "string"
                },
                "_links": {
                    "self": {
                        "href": "http://wms.bts.uz:8040/v1/purveyor/view?id=12"
                    }
                }
            }
        ],
        "_links": {
            "self": "/v1/purveyor/clients?page=1",
            "first": "/v1/purveyor/clients?page=1",
            "last": "/v1/purveyor/clients?page=1"
        },
        "_meta": {
            "totalCount": 11,
            "pageCount": 1,
            "currentPage": 1,
            "perPage": 20
        }
    }
}
Parameter Type Description
group string Группа товаров обязательна
code string Необходимо ввести код продукта
name string Название товара должно быть заполнено
full_name string Полное наименование товара обязательно.
name_eng string Английское название (название продукта на английском языке)
stock_percentage string Процент резерва доступности
stock_expiry string Действует до
legal_entity boolean Юридическое/физическое лицо (Da/Net)
inn integer Идентификационный номер налогоплательщика (ИНН)
kpp integer Регистрационный код компании
okpp integer Поставщик:
is_buyer boolean Клиент (Да/Сеть)
main_delivery_address string Основной адрес доставки
depositor boolean Кладовщик (кладовщик, ответственный за товар)
contract_number integer Номер контракта
contract_date string Дата контракта
bank_details string Банковские реквизиты
contact_info string Контактная информация
additional_details string Дополнительная информация
is_supplier boolean Поставщик (Да/Сеть)

supplier_buyer_status_title

Http request

POST v1/purveyor/client-status

curl \
--request POST \
--url "http://wms.bts.uz:8040/v1/purveyor/client-status" \
--header  "Authorization\: "Bearer token"
--header  "accept\: "application/json"
--header  "Content-Type\: "application/json"
--data '{
    "status" => [
                  {"id": 1,"status": "ok"},
                  {"id": 2,"status": "ok"}
       ]
}'

SUCCESS:


{
  "message": "supplier-buyers successfully updated to delivered status"
}
Parameter Type Description
status array Вам нужно отправить ID успешно сохраненных purveyor со статусом OK.

Создание товара

Http request

POST v1/product/create

curl \
--request POST \
--url "http://wms.bts.uz:8040/v1/product/create" \
--header  "Authorization: "Bearer token"
--header  "accept: "application/json"
--header  "Content-Type: "application/json"
--data '{
    "group": "group",
    "code": "code",
    "name": "name",
    "full_name": "full_name",
    "gtin": "gtin",
    "article": "article",
    "nomenclature_type": "nomenclature_type",
    "shelf_life_stock": "shelf_life_stock",
    "abc_class": "abc_class",
    "kis_code": "kis_code",
    "comment": "comment",
    "is_set": "is_set",
    "weight": "weight",
    "net_weight": "net_weight",
    "min_shelf_life_stock": "min_shelf_life_stock",
    "name_eng": "name_eng",
    "tsd_name": "tsd_name",
    "volume": "volume",
    "net_volume": "net_volume",
    "shelf_life_deviation_days": "shelf_life_deviation_days",
    "min_shelf_life_period": "min_shelf_life_period",
    "shelf_life_deviation_period": "shelf_life_deviation_period",
    "depositor": "depositor",
    "seasonal_abc_coefficient": "seasonal_abc_coefficient",
    "specification": "specification",
    "storage_period_days": "storage_period_days",
    "default_status": "default_status",
    "temperature_mode": "temperature_mode",
    "base_packaging": "base_packaging",
    "billing_packaging": "billing_packaging",
    "report_packaging": "report_packaging",
    "unit": "unit"
}'

SUCCESS:


  {
    "message": "Record successfully created.",
    "data": {
        "id": 34,
        "supplier_buyer_id": 5,
        "group": "string",
        "code": "12345",
        "name": "string",
        "full_name": "string",
        "gtin": "1234",
        "article": "string",
        "nomenclature_type": "string",
        "unit": "string",
        "comment": "string",
        "productPackagin": {
            "id": 5,
            "product_id": 34,
            "base_packaging": "string",
            "billing_packaging": "string",
            "report_packaging": "string"
        },
        "productShelfLive": {
            "id": 8,
            "product_id": 34,
            "shelf_life_stock": "40.00",
            "min_shelf_life_stock": "33.00",
            "shelf_life_deviation_days": 0,
            "shelf_life_period": 0,
            "min_shelf_life_period": 0,
            "shelf_life_deviation_period": 0,
            "storage_period_days": 0,
            "specification": "string",
            "temperature_mode": "string"
        },
        "productTechnical": {
            "id": 15,
            "product_id": 34,
            "weight": "20.000",
            "net_weight": "50.000",
            "volume": "30.000",
            "net_volume": "60.000",
            "is_set": true,
            "kis_code": "string",
            "default_status": "string"
        },
        "_links": {
            "self": {
                "href": "http:/wms.bts.uz:8040:/v1/product/view?id=34"
            }
        }
    }
}
Parameter Type Description
group string Группа товаров обязательна
code string Необходимо ввести код продукта
name string Название товара должно быть заполнено
full_name string Полное наименование товара обязательно.
gtin integer GTIN (глобальный номер предмета торговли) необходимо заполнить.
article string Артикул товара (номер артикула) должен быть заполнен.
nomenclature_type string Тип номенклатуры (вид продукции) должен быть заполнен.
shelf_life_stock integer Резерв годности (максимальный срок годности продукта) должен быть восполнен.
abc_class string Класс ABC (классификация продукции согласно анализу ABC)
kis_code string Код KIS (код компьютерной информационной системы) должен быть заполнен.
comment string Комментарий (дополнительный комментарий или комментарий)
is_set boolean To'plam (komplektmi yoki yo'qmi) 1 yoki 0 tuldirish shart
weight integer Вес (вес товара) должен быть указан
net_weight integer Вес нетто (вес нетто в упаковке) должен быть указан.
min_shelf_life_stock string Минимальный срок годности запаса (минимальный срок годности на момент поступления)
name_eng string Английское название (название продукта на английском языке)
tsd_name string Имя ТСД (имя, используемое в терминалах или сканерах)
volume integer Размер (размер изделия) необходимо заполнить
net_volume integer Чистый объем (объем нетто в упаковке) должен быть заполнен.
shelf_life_deviation_days string Отклонение срока годности в днях (максимальное отклонение)
min_shelf_life_period integer Минимальный срок годности (минимальный срок годности на момент поступления)
shelf_life_deviation_period string Период отклонения срока годности (период максимального отклонения)
depositor string Кладовщик (кладовщик, ответственный за товар)
seasonal_abc_coefficient integer Сезонный коэффициент ABC (коэффициент согласно ABC-анализу сезонных продуктов)
specification string Спецификация (описание товара или технические требования) должна быть заполнена.
storage_period_days string Срок годности в днях (максимальный срок годности продукта)
default_status string Статус по умолчанию (начальный статус продукта)
temperature_mode string Температурный режим (температура хранения продукта) должен быть заполнен.
base_packaging string Обязательно заполнение основной упаковки (основной упаковки товара).
billing_packaging string Биллинговый пакет (пакет, используемый в процессе биллинга)
report_packaging string Обертка отчета (обертка, используемая для отчетов)
unit integer Необходимо указать единицу измерения (например, кг, единицу, литр).

Список товаров

Http request

GET v1/product/clients

curl \
--request GET \
--url "http://wms.bts.uz:8040/v1/product/clients" \
--header  "Authorization: "Bearer token"
--header  "accept: "application/json"
--header  "Content-Type: "application/json"

SUCCESS:


  {
    "message": "Data successfully retrieved.",
    "data": {
        "items": [
            {
                "id": 39,
                "supplier_buyer_id": 5,
                "group": "stringcceee",
                "code": "stringcccee",
                "name": "stringcceee",
                "full_name": "string",
                "gtin": "112",
                "article": "string",
                "nomenclature_type": "11",
                "unit": "22",
                "comment": "string",
                "productPackagin": {
                    "id": 7,
                    "product_id": 39,
                    "base_packaging": "string",
                    "billing_packaging": "string",
                    "report_packaging": "string"
                },
                "productShelfLive": {
                    "id": 10,
                    "product_id": 39,
                    "shelf_life_stock": "22.00",
                    "min_shelf_life_stock": "0.00",
                    "shelf_life_deviation_days": 2,
                    "shelf_life_period": 2,
                    "min_shelf_life_period": 2,
                    "shelf_life_deviation_period": 2,
                    "storage_period_days": 2,
                    "specification": "string",
                    "temperature_mode": "string"
                },
                "productTechnical": {
                    "id": 18,
                    "product_id": 39,
                    "weight": "88.000",
                    "net_weight": "55.000",
                    "volume": "77.000",
                    "net_volume": "44.000",
                    "is_set": true,
                    "kis_code": "99",
                    "default_status": "string"
                },
                "_links": {
                    "self": {
                        "href": "http://wms.bts.uz:8040/v1/product/view?id=39"
                    }
                }
            }
        ],
        "_links": {
            "self": "/v1/product/clients?page=1",
            "first": "/v1/product/clients?page=1",
            "last": "/v1/product/clients?page=1"
        },
        "_meta": {
            "totalCount": 3,
            "pageCount": 1,
            "currentPage": 1,
            "perPage": 20
        }
    }
}
Parameter Type Description
group string Группа товаров обязательна
code string Необходимо ввести код продукта
name string Название товара должно быть заполнено
full_name string Полное наименование товара обязательно.
gtin integer GTIN (глобальный номер предмета торговли) .
article string Артикул товара (номер артикула) должен быть заполнен.
nomenclature_type string Тип номенклатуры (вид продукции) должен быть заполнен.
shelf_life_stock integer Резерв годности (максимальный срок годности продукта) должен быть восполнен.
abc_class string Класс ABC (классификация продукции согласно анализу ABC)
kis_code string Код KIS (код компьютерной информационной системы) должен быть заполнен.
comment string Комментарий (дополнительный комментарий или комментарий)
is_set boolean To'plam (komplektmi yoki yo'qmi) 1 yoki 0
weight integer Вес (вес товара) должен быть указан
net_weight integer Вес нетто (вес нетто в упаковке) должен быть указан.
min_shelf_life_stock string Минимальный срок годности запаса (минимальный срок годности на момент поступления)
name_eng string Английское название (название продукта на английском языке)
tsd_name string Имя ТСД (имя, используемое в терминалах или сканерах)
volume integer Размер (размер изделия)
net_volume integer Чистый объем (объем нетто в упаковке) должен быть заполнен.
shelf_life_deviation_days string Отклонение срока годности в днях (максимальное отклонение)
min_shelf_life_period integer Минимальный срок годности (минимальный срок годности на момент поступления)
shelf_life_deviation_period string Период отклонения срока годности (период максимального отклонения)
depositor string Кладовщик (кладовщик, ответственный за товар)
seasonal_abc_coefficient integer Сезонный коэффициент ABC (коэффициент согласно ABC-анализу сезонных продуктов)
specification string Спецификация (описание товара или технические требования) должна быть заполнена.
storage_period_days string Срок годности в днях (максимальный срок годности продукта)
default_status string Статус по умолчанию (начальный статус продукта)
temperature_mode string Температурный режим (температура хранения продукта) должен быть заполнен.
base_packaging string Обязательно заполнение основной упаковки (основной упаковки товара).
billing_packaging string Биллинговый пакет (пакет, используемый в процессе биллинга)
report_packaging string Обертка отчета (обертка, используемая для отчетов)
unit integer Необходимо указать единицу измерения (например, кг, единицу, литр).

Обновить статус продуктов, которые будут получены

Http request

POST v1/product/client-status

curl \
--request POST \
--url "http://wms.bts.uz:8040/v1/product/client-status" \
--header  "Authorization\: "Bearer token"
--header  "accept\: "application/json"
--header  "Content-Type\: "application/json"
--data '{
    "status" => [
                  {"id": 1,"status": "ok"},
                  {"id": 2,"status": "ok"}
       ]
}'

SUCCESS:


{
  "message": "products successfully updated to delivered status"
}
Parameter Type Description
status array Вам нужно отправить ID успешно сохраненных product со статусом OK.

Прием товаров

Http request

POST v1/receiving-goods/create

curl \
--request POST \
--url "http://wms.bts.uz:8040/v1/receiving-goods/create" \
--header  "Authorization: "Bearer token"
--header  "accept: "application/json"
--header  "Content-Type: "application/json"
--data '{
    "number": "number",
    "date": "date",
    "counterparty": "counterparty",
    "arrival_date": "arrival_date",
    "comment": "comment",
    "vehicle_model": "vehicle_model",
    "vehicle_number": "vehicle_number",
    "driver_name": "driver_name",
    "driver_document": "driver_document",
    "contract_number": "contract_number",
    "contract_date": "contract_date",
    "nomenclature": "nomenclature",
    "quantity": "quantity",
    "price": "price",
    "total_amount": "total_amount",
    "kis_number": "kis_number",
    "kis_date": "kis_date",
    "accept_by_places": "accept_by_places",
    "vehicle_type": "vehicle_type",
    "vat_rate": "vat_rate",
    "vat_amount": "vat_amount",
    "price_includes_vat": "price_includes_vat",
    "discount_amount": "discount_amount",
    "under_delivery_percent": "under_delivery_percent",
    "over_delivery_percent": "over_delivery_percent",
    "nomenclature_package": "nomenclature_package",
    "package_quantity": "package_quantity"
}'

SUCCESS:


  {
    "message": "Record successfully created.",
    "data": {
        "id": 11,
        "number": "string",
        "date": "2024-11-11",
        "counterparty": "string",
        "arrival_date": "2024-11-11",
        "comment": "string",
        "vehicle_model": "string",
        "vehicle_number": "string",
        "driver_name": "string",
        "driver_document": "string",
        "contract_number": "string",
        "contract_date": "2024-11-11",
        "acceptance_gate": null,
        "nomenclature": "string",
        "quantity": 11,
        "price": "44.00",
        "total_amount": "55.00",
        "supplierDetail": {
            "id": 8,
            "supplier_id": 11,
            "kis_number": null,
            "kis_date": "2024-11-11",
            "accept_by_places": true,
            "vehicle_type": null,
            "vat_rate": "444.00",
            "vat_amount": "66.00",
            "price_includes_vat": true,
            "discount_amount": "44.00",
            "under_delivery_percent": "20.00",
            "over_delivery_percent": "30.00"
        },
        "supplierPackage": {
            "id": 2,
            "supplier_id": 11,
            "nomenclature_package": "string",
            "package_quantity": 0
        },
        "_links": {
            "self": {
                "href": "http:/wms.bts.uz:8040/v1/receiving-goods/view?id=11"
            }
        }
    }
}
Parameter Type Description
number integer Требуется номер доставки
date string Дата доставки обязательна
counterparty string Необходимо заполнить контрагента (организацию доставки груза).
arrival_date string Дата получения посылки
comment string Комментарий (дополнительный комментарий или комментарий)
vehicle_model string Модель автомобиля
vehicle_number integer Регистрационный номер транспортного средства
driver_name string Полное имя водителя
driver_document string Документ, связанный с водителем (паспорт, права и т.д.)
contract_number integer Номер контракта
contract_date string Дата контракта
nomenclature string Номенклатура (вид груза или перечень продукции) должна быть заполнена.
quantity integer Необходимо указать количество товара.
price integer Необходимо заполнить цену за одну штуку или единицу товара.
total_amount integer Общая сумма (цена * количество) должна быть заполнена.
kis_number integer Номер заказа в системе КИС
kis_date string Дата внесения заказа в систему КИС
accept_by_places boolean Принимать по грузовому отсеку (верно/неверно)
vehicle_type string Тип транспортного средства (например, грузовик, автобус)
vat_rate integer Ставка НДС (в процентах)
vat_amount integer сумма НДС
price_includes_vat boolean Включает ли цена НДС (верно/неверно)
discount_amount integer Сумма скидки
under_delivery_percent integer Процент недоставленной продукции
over_delivery_percent integer Процент перепоставленного товара
nomenclature_package string Вид номенклатурной упаковки
package_quantity integer Количество упаковок

Список получаемых товаров

Http request

GET v1/receiving-goods/clients

curl \
--request GET \
--url "http://wms.bts.uz:8040/v1/receiving-goods/clients" \
--header  "Authorization: "Bearer token"
--header  "accept: "application/json"
--header  "Content-Type: "application/json"

SUCCESS:


  {
    "message": "Data successfully retrieved.",
    "data": {
        "items": [
            {
                "id": 10,
                "number": "string",
                "date": "2024-11-11",
                "counterparty": "string",
                "arrival_date": "2024-11-11",
                "comment": "string",
                "vehicle_model": "string",
                "vehicle_number": "string",
                "driver_name": "string",
                "driver_document": "string",
                "contract_number": "string",
                "contract_date": "2024-11-11",
                "acceptance_gate": null,
                "nomenclature": "string",
                "quantity": 20,
                "price": "200.00",
                "total_amount": "2000.00",
                "supplierDetail": {
                    "id": 7,
                    "supplier_id": 10,
                    "kis_number": null,
                    "kis_date": "2024-11-11",
                    "accept_by_places": true,
                    "vehicle_type": null,
                    "vat_rate": "20.00",
                    "vat_amount": "30.00",
                    "price_includes_vat": true,
                    "discount_amount": "40.00",
                    "under_delivery_percent": "25.00",
                    "over_delivery_percent": "50.00"
                },
                "supplierPackage": {
                    "id": 1,
                    "supplier_id": 10,
                    "nomenclature_package": "string11",
                    "package_quantity": 0
                },
                "_links": {
                    "self": {
                        "href": "http://wms.bts.uz:8040/v1/receiving-goods/view?id=10"
                    }
                }
            }
        ],
        "_links": {
            "self": "/v1/receiving-goods/clients?page=1",
            "first": "/v1/receiving-goods/clients?page=1",
            "last": "/v1/receiving-goods/clients?page=1"
        },
        "_meta": {
            "totalCount": 2,
            "pageCount": 1,
            "currentPage": 1,
            "perPage": 20
        }
    }
}
Parameter Type Description
number integer Требуется номер доставки
date string Дата доставки обязательна
counterparty string Необходимо заполнить контрагента (организацию доставки груза).
arrival_date string Дата получения посылки
comment string Комментарий (дополнительный комментарий или комментарий)
vehicle_model string Модель автомобиля
vehicle_number integer Регистрационный номер транспортного средства
driver_name string Полное имя водителя
driver_document string Документ, связанный с водителем (паспорт, права и т.д.)
contract_number integer Номер контракта
contract_date string Дата контракта
nomenclature string Номенклатура (вид груза или перечень продукции) должна быть заполнена.
quantity integer Необходимо указать количество товара.
price integer Необходимо заполнить цену за одну штуку или единицу товара.
total_amount integer Общая сумма (цена * количество) должна быть заполнена.
kis_number integer Номер заказа в системе КИС
kis_date string Дата внесения заказа в систему КИС
accept_by_places boolean Принимать по грузовому отсеку (верно/неверно)
vehicle_type string Тип транспортного средства (например, грузовик, автобус)
vat_rate integer Ставка НДС (в процентах)
vat_amount integer сумма НДС
price_includes_vat boolean Включает ли цена НДС (верно/неверно)
discount_amount integer Сумма скидки
under_delivery_percent integer Процент недоставленной продукции
over_delivery_percent integer Процент перепоставленного товара
nomenclature_package string Вид номенклатурной упаковки
package_quantity integer Количество упаковок

Обновить статус товара к получению

Http request

POST v1/receiving-goods/client-status

curl \
--request POST \
--url "http://wms.bts.uz:8040/v1/receiving-goods/client-status" \
--header  "Authorization\: "Bearer token"
--header  "accept\: "application/json"
--header  "Content-Type\: "application/json"
--data '{
    "status" => [
                  {"id": 1,"status": "ok"},
                  {"id": 2,"status": "ok"}
       ]
}'

SUCCESS:


{
  "message": "supplier successfully updated to delivered status"
}
Parameter Type Description
status array Вам нужно отправить ID успешно сохраненных receiving_goods со статусом OK.

Ошибки

Код ошибки Значение
400 Bad Request -- Your request sucks
401 Unauthorized -- Your API key is wrong
403 Forbidden -- The kitten requested is hidden for administrators only
404 Not Found -- The specified kitten could not be found
405 Method Not Allowed -- You tried to access a kitten with an invalid method
406 Not Acceptable -- You requested a format that isn't json
410 Gone -- The kitten requested has been removed from our servers
429 Too Many Requests -- You're requesting too many kittens! Slow down!
500 Internal Server Error -- We had a problem with our server. Try again later.
503 Service Unavailable -- We're temporarially offline for maintanance. Please try again later.
bash