افزونه API

مستندات نحوه ارتباط با 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 می باشد.

نمونه

نمونه ی ارسالی به طور مثال برای ثبت سند ورود آبشده:
ثبت کل شود، حساب کد ۱۱۵، شماره سند ۲، شماره ردیف ۱، تاریخ ۱۴۰۳/۰۶/۱۹، وزن ۱.۵ گرم، عیار ۷۵۰، نام آزمایشگاه خالی، شماره انگ خالی، ورود، آبشده
{"DoNewSanadVKHGOLD":[1, 115, 2, 1, 1403, 06, 19, 1.5, 750,"","", 0, 0]}
نمونه پاسخ دریافتی:
{"OK": "0060019112024090914040472011"}
در پاسخ، کد منحصر به فرد هر سند بر گشت داده می شود.
در خواست در قالب cURL:
curl --location --request GET 'https://127.0.0.1:8081' \
--header 'Authorization: Bearer G3Y5C5A2P3T28L1A5T1F4J1K1R6J5S6U3T8D4QO1N7U1' \
--header 'Content-Type: application/json' \
--data-raw '{"DoNewSanadVKHGOLD":[1, 115, 2, 1, 1403, 06, 19, 1.5, 750,"","", 0, 0]}'

لیست دستور ها:

(در قالب 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]}

ثبت سند خرید و فروش اتیکت:

{"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]}

Count_Last: تعداد اسناد به ترتیب تاریخ از آخر

استعلام سند ثبت شده توسط APi:

{"DoNewSanadInquiry":[Moshtari_Code, Factor_Number, Shamsi_Year, Shamsi_Month, Shamsi_Day]}

حذف سند:

{"DoDeleteSanad":[Factor_Code]}

Factor_Code: کد منحصر به فرد سند برگشت داده شده در متد های ثبت سند


چه میزان این مطلب مفید بود ؟

برای امتیاز دادن کلیک کنید

میانگین رای ها: / ۵. تعداد رای ها:

تا الان رای داده نشده

متاسفیم که این مطلب مفید نبود

لطفا به ما در بهبود این مطلب کمک کنید

لطفا بفرمایید ما چطور این مطلب رو بهبود بدیم؟