مستندات نحوه ارتباط با API:
آخرین به روز رسانی:
در صورتی که افزونه APi بر روی برنامه شما فعال نیست می توانید از طریق صفحه خرید آنلاین خریداری نمایید و در همان لحظه این افزونه در برنامه ی شما فعال می شود.
- برای راه اندازی وب سرویس، در برنامه ی ته حساب، منوی پرونده، گزینه ی APi را انتخاب نمایید و فقط فعال سازی APi را انتخاب نمایید.
- فرمت آدرس URL به این شکل می باشد:
- در حالت LOCAL: https://127.0.0.1:8081/
- یا به آدرس آی پی اختصاصی شما (استاتیک):
- برای مثال: https://5.12.34.56:8081/
- آدرس URL دارای Endpoint نمی باشد.
- درخواست ها حتما به HTTPS ارسال شود.
- در صورتی که در برنامه ی POSTMAN با خطای Valid نبودن SSL مواجه شدید، در بخش تنظیمات POSTMAN گزینه ی SSL Certificate verification رو خاموش نمایید.
- از متد POST استفاده نمایید.
- برای تست ابتدا به صورت Local بررسی نمایید، درصورتی که صفحه “وب سرویس فعال می باشد” در مرورگر باز شد، از طریق اینترنت تست خود را انجام دهید، در صورت بروز مشکل، Port forwading، آی پی و استاتیک و فایروال را بررسی نمایید.
- در Authorization Bearer توکن ساخته شده در بخش تنظیمات API در برنامه ارسال شود. در صورتی که توکن به درستی ارسال نشود با این پیغام مواجه می شوید: Unsupported authorization scheme.
- در پارامتر
Sabte_Kol_Or_Movaghat_0_1
اگر عدد ۱ ارسال شود سند ثبت کل می شود، اگر ۰ ارسال شود سند به شکل موقت ثبت می شود و در بخش اسناد موقت قابل رویت می باشد. - در پارامتر
MazanehIsMesghalOrGeram_0_1
اگر عدد ۰ ارسال شود مزنه هر مثقال می باشد و اگر ۱ ارسال شود هر گرم می باشد. - در پارامتر
IsMotefaregheOrAbshode_0_1
اگر عدد ۰ ارسال شود متفرقه و ۱ آبشده می باشد. - در پارامتر
IsVoroodOrKhorooj_0_1
اگر ۰ وارد شود نوع سند دریافتی/ورود و اگر ۱ وارد شود پرداختی/خروج می باشد. - در پارامتر
BuyOrSale_0_1
اگر عدد ۱ ارسال شود نوع سند خرید و اگر ۰ ارسال شود نوع سند فروش می باشد. - پارامتر
Radif_Number
عدد ۱ ارسال شود. - در صورتی که
IsMotefaregheOrAbshode_0_1
عدد ۱ ارسال شده است بایدAng_Number
وName_az
مقدار داشته باشند. - پارامتر
Name_az
به معنای نام آزمایشگاه می باشد. - پارامتر
Ang_Number
به معنای شماره انگ می باشد. - تاریخ ها شمسی می باشد.
- دستور های زیر در بخش Body ارسال شود.
- قالب تمامی درخواست ها و پاسخ ها، JSON می باشد.
لیست دستور ها:
(در قالب JSON در Body ارسال شود)
RFID
ارسال لیست تگ های RFID خوانده شده:
{"epcList":["E123456789123456", "E123456789123457","E123456789123458"]}
دریافت مشخصات تگ RFID:
{"GetInfo":[
, "E123456789123456"
"E123456789123457"]}
دریافت مشخصات تگ RFID (با تصویر):
{"GetInfoWithImage":["E123456789123456", "E123456789123457"]}
حساب ها
دریافت مانده حساب و تفکیک ته حساب مشتری:
{"getmandehesabbycode":["1","2","3"]}
ثبت مشتری/حساب جدید:
{"DoNewMoshtari":["Name","GoroupName","Tel","Address"]}
لیست مشتری/حساب ها: (از کد حساب تا کد حساب)
{"DoListMoshtari":[From_Code,To_Code]}
آبشده و متفرقه
ثبت سند ورود و خروج آبشده و متفرقه:
{"DoNewSanadVKHGOLD":[Sabte_Kol_Or_Movaghat_1_0, Moshtari_Code, Factor_Number, Radif_Number, Shamsi_Year, Shamsi_Month, Shamsi_Day, Vazn, Ayar, Ang_Number, Name_az, IsVoroodOrKhorooj_0_1, IsMotefaregheOrAbshode_0_1]}
ثبت سند خرید و فروش آبشده و متفرقه:
{"DoNewSanadBuySaleGOLD":[Sabte_Kol_Or_Movaghat_1_0, Moshtari_Code, Factor_Number, Radif_Number, Shamsi_Year, Shamsi_Month, Shamsi_Day, Vazn, Ayar, Ang_Number, Name_az, BuyOrSale_0_1, Mazaneh, MazanehIsMesghalOrGeram_0_1, IsMotefaregheOrAbshode_0_1, MablaghKol]}
سکه
ثبت سند ورود و خروج سکه:
{"DoNewSanadVKHSEKEH":[Sabte_Kol_Or_Movaghat_1_0, Moshtari_Code, Factor_Number, Radif_Number, Shamsi_Year, Shamsi_Month, Shamsi_Day, Vazn, Ayar, Count, Name_Sekeh, IsVoroodOrKhorooj_0_1]}
ثبت سند خرید و فروش سکه:
{"DoNewSanadBuySaleSEKEH":[Sabte_Kol_Or_Movaghat_1_0, Moshtari_Code, Factor_Number, Radif_Number, Shamsi_Year, Shamsi_Month, Shamsi_Day, Vazn, Ayar, Count, Name_Sekeh, BuyOrSale_0_1, Mazaneh, MablaghKol]}
مالی
ثبت سند ورود و خروج وجه نقد:
{"DoNewSanadVKHVaghNaghd":[Sabte_Kol_Or_Movaghat_1_0, Moshtari_Code, Factor_Number, Radif_Number, Shamsi_Year, Shamsi_Month, Shamsi_Day, IsVoroodOrKhorooj_0_1, Mablagh, Sharh]}
کارساخته
ثبت سند خرید و فروش کارساخته:
{"DoNewSanadBuySaleKar":[1Sabte_Kol_Or_Movaghat_1_0, 2Moshtari_Code, 3Factor_Number, 4Radif_Number, 5Shamsi_Year, 6Shamsi_Month, 7Shamsi_Day, 8Vazn, 9Ayar, 10Count, 11Name_Kar, 12BuyOrSale_0_1, 13Mazaneh, 14MazanehIsMesghalOrGeram_0_1, 15MablaghKol, 16OjratTedadiOrGerami_0_1, 17Darsad_Maliat, 18MeghdarMaliat, 19Darsad_Sood, 20Darsad_Talayee, 21IsMarjoo_1_0, 22PoolSang, 23PictureFileName, 24Ojrat]}
ثبت سند ورود و خروج کارساخته:
{"DoNewSanadVKHKar":[1Sabte_Kol_Or_Movaghat_1_0, 2Moshtari_Code, 3Factor_Number, 4Radif_Number, 5Shamsi_Year, 6Shamsi_Month, 7Shamsi_Day, 8Vazn, 9Ayar, 10Count, 11Name_Kar, 12IsVoroodOrKhorooj_0_1, 13OjratTedadiOrGerami_0_1, 14MablaghKol, 15Darsad_Maliat, 16MeghdarMaliat, 17Darsad_Talayee, 18IsMarjoo_1_0, 19PictureFileName, 20Ojrat, 21PoolSang]}
اتیکت
دریافت مشخصات اتیکت از طریق شناسه ی کار:
{"getetiketinfobycode":["1","2","3"]}
دریافت مشخصات اتیکت از طریق شناسه ی کار با تصویر:
{"getetiketinfobycodewithimage":["1","2","3"]}
لیست اتیکت ها: (از شناسه کار تا شناسه کار)
{"DoListEtiket":[From_Code, To_Code, WithPhoto_1_0]}
WithPhoto
: درصورتی که مقدار یک در این پارامتر ارسال شود لیست اتیکت ها با تصویر دریافت می شود.
لیست اتیکت ها: (فیلتر بر اساس کد کار)
{"DoList_EtiketByCodeKar":["Code_Kar_String"]}
ثبت سند خرید و فروش اتیکت:
{"DoNewSanadBuySaleEtiket":[1_Sabte_Kol_Or_Movaghat_1_0, 2_Moshtari_Code, 3_Factor_Number, 4_Radif_Number, 5_Shamsi_Year, 6_Shamsi_Month, 7_Shamsi_Day, 8_0, 9_0, 10_0, 11_"", 12_BuyOrSale_0_1, 13_Mazaneh, 14_MazanehIsMesghalOrGeram_0_1, 15_MablaghKol, 16_OjratTedadiOrGerami_0_1, 17_Darsad_Maliat, 18_MeghdarMaliat, 19_Darsad_Sood, 20_Darsad_Talayee, 21_IsMarjoo_1_0, 22_PoolSang, 23_PictureFileName, 24_Ojrat, 25_Shenase]}
ثبت سند ورود و خروج اتیکت:
{"DoNewSanadVKHEtiket":[1_Sabte_Kol_Or_Movaghat_1_0, 2_Moshtari_Code, 3_Factor_Number, 4_Radif_Number, 5_Shamsi_Year, 6_Shamsi_Month, 7_Shamsi_Day, 8_0, 9_0, 10_0, 11_"", 12_BuyOrSale_0_1, 13_0, 14_0, 15_MablaghKol, 16_OjratTedadiOrGerami_0_1, 17_Darsad_Maliat, 18_MeghdarMaliat, 19_0, 20_Darsad_Talayee, 21_IsMarjoo_1_0, 22_PoolSang, 23_PictureFileName, 24_Ojrat, 25_Shenase]}
سند
لیست اسناد ثبت شده:
{"DoListAsnad":[Count_Last,Moshtari_Code,"AzTarikhShamsi","TaTarikhShamsi"]}
Count_Last
: تعداد اسناد به ترتیب تاریخ از آخر
AzTarikhShamsi
: فیلتر از تاریخ: ۰۱-۰۱-۱۴۰۳
TaTarikhShamsi
: فیلتر تا تاریخ : ۰۱-۰۲-۱۴۰۳
استعلام سند ثبت شده توسط APi:
{"DoNewSanadInquiry":[Moshtari_Code, Factor_Number, Shamsi_Year, Shamsi_Month, Shamsi_Day]}
حذف سند:
{"DoDeleteSanad":[Factor_Code]}
Factor_Code
: کد منحصر به فرد سند برگشت داده شده در متد های ثبت سند