Smart Distribution систем нь бусад системтэй API сервис дамжуулан мэдээлэл солилцох, мэдээлэл харах, хадгалах зорилгоор ашиглагдана. API холболтын гэрээ байгуулснаар Смарт Дистро Системс ХХК талаас гаргаж өгсөн нэвтрэх нэр, нууц үгийг таны баталгаат цахим шууданд хүргүүлэх болно.
Тавигдах шаардлага:1.
Програм нь REST API ашиглах
2.
JSON форматаар мэдээлэл солилцох,
3.
OAuth2 хамгаалалтын фраймворкыг дэмжин ажиллах боломжтой байх
Сервисүүд:
Нэг удаагийн токен авах
Харилцагчийн дэлгэрэнгүй жагсаалт харуулах
Борлуулалтын жагсаалт харуулах /хугацаа хооронд/
Борлуулалтын дэлгэрэнгүй жагсаалт харуулах /баримт бүрээр/
Авлага цуглуулалт хадгалах
Тест хийхэд шаардлагатай зүйлс:1.
API хөгжүүлэлтийн тест шалгах платформ, жишээ нь: Postman
access_token - Нэг удаагийн токен авах
Сервис тус бүрийг дуудахдаа нэг удаагийн токен авч холбогдоно. Тухайн токены идэвхитэй хугацаагаар нэг удаагийн токен үүсгэх хугацааг тохируулахыг анхаарна уу.Оролт:
Method: Get
Authorization: Type хэсэгт No Auth сонгох
Headers: Key хэсэгт Content-Type, ValueТайлбар: Системийн нэвтрэх нэр болон нууц үгийг Смарт Дистро Систес ХХК - с өгөх бөгөөд харилцагч өөрчлөх боломжгүй байна. Хэрэв нууц үгээ мартсан тохиолдолд баталгаат имэйл хаягаар энэ тухай мэдэгдэж дахин шинээр авна.№ | Талбарын нэр | Талбар | Өгөгдлийн төрөл |
---|
1 | username | Хэрэглэгчийн нэр | string |
2 | password | Хэрэглэгчийн нууц үг | string |
№ | Талбарын нэр | Талбар | Өгөгдлийн төрөл |
---|
1 | access_token | Токен | string |
2 | token_type | Токены төрөл | string |
3 | expires_in | Токен дуусах хугацаа | string |
customers - Харилцагчийн дэлгэрэнгүй жагсаалт авах
Харилцагчийн дэлгэрэнгүй мэдээлэл харуулах сервисОролт:
Method: Get
Authorization: Type хэсэгт Bearer Token сонгох№ | Талбарын нэр | Талбар | Өгөгдлийн төрөл |
---|
1 | Token | Токен | string |
№ | Талбарын нэр | Талбар | Өгөгдлийн төрөл |
---|
1 | id | Харилцагчийн код | string |
2 | name | Харилцагчийн нэр | string |
3 | registrynumber | Регистрийн дугаар | string |
4 | address | Хаяг | string |
5 | mobile | Утасны дугаар | string |
6 | parentcustomerid | Толгой харилцагчийн код | string |
sale - Борлуулалтын жагсаалт харуулах /хугацаа хооронд/
Харилцагчийн дэлгэрэнгүй мэдээлэл харуулах сервисОролт:
Method: Get
Authorization: Type хэсэгт Bearer Token сонгох№ | Талбарын нэр | Талбар | Өгөгдлийн төрөл |
---|
1 | Token | Токен | string |
2 | beginDate | Эхлэх огноо | date |
3 | endDate | Дуусах огноо | date |
№ | Талбарын нэр | Талбар | Өгөгдлийн төрөл |
---|
1 | documentnumber | Баримтын дугаар | string |
2 | documentdate | Баримтын огноо | string |
3 | documentdesc | Баримтын утга | string |
4 | customerid | Хаяг | string |
5 | parentregistrynumber | Харилцагчийн код | string |
6 | parentcustomerid | Толгой харилцагчийн РД | string |
saleitem - Борлуулалтын дэлгэрэнгүй жагсаалт харуулах /баримт бүрээр/
Харилцагчийн дэлгэрэнгүй мэдээлэл харуулах сервисОролт:
Method: Get
Authorization: Type хэсэгт Bearer Token сонгох№ | Талбарын нэр | Талбар | Өгөгдлийн төрөл |
---|
1 | Token | Токен | string |
2 | documentNumber | Баримтын дугаар | int |
№ | Талбарын нэр | Талбар | Өгөгдлийн төрөл |
---|
1 | itemid | Барааны код | string |
2 | itemname | Барааны нэр | string |
3 | qty | Тоо ширхэг | string |
4 | price | Үнэ | string |
5 | amount | Нийт дүн | string |
6 | discountamount | Хөнгөлөлтийн дүн | string |
7 | payamount | Төлөх дүн | string |