مستندات نحوه ارتباط با API ته حساب:

سازگار با نسخه ته حساب:
آخرین به روز رسانی مستندات:
موارد جدید اضافه شده
  • امکان دریافت موجودی کارساخته، آبشده و متفرقه، حساب بانکی
  • امکان ثبت اسناد با جنس فلز نقره و پلاتین
  • امکان ثبت چند ردیف در یک سند برای تمامی درخواست های ثبت سند
  • امکان دریافت اطلاعات جدول اتیکت ها
  • اضافه شدن خروجی جدید در بخش مانده حساب ها
  • دریافت آخرین مانده حساب و تفکیک ته حساب بر اساس کد گروه حساب
  • امکان فیلتر نمایش نوع سند مشخص در لیست اسناد
  • امکان دریافت تراز آبشده، سکه و ارز با تنظیمات بیشتر
  • حواله
  • مانده حساب وزنی و مالی هر سند در لیست اسناد
  • تراز آبشده، سکه و ارز
  • امکان ویرایش مشخصات حساب، مشتری
  • امکان ثبت کد حساب دلخواه در ثبت حساب، مشتری جدید
فعال سازی سرویس API در برنامه ته حساب
  • برای راه اندازی وب سرویس، در برنامه ی ته حساب، منوی پرونده، گزینه ی APi را انتخاب نمایید و فقط فعال سازی APi را انتخاب نمایید.
  • برای تست ابتدا به صورت Local بررسی نمایید، درصورتی که صفحه “وب سرویس فعال می باشد” در مرورگر باز شد، از طریق اینترنت تست خود را انجام دهید، در صورت بروز مشکل، Port forwading، آی پی استاتیک و فایروال را بررسی نمایید.
  • برای فعال بودن سرویس API، باید برنامه ی ته حساب بر روی سیستم اصلی باز باشد ولی نیازی نیست ورود به برنامه انجام شود.
ارسال کد توکن جهت افزایش امنیت (Authorization)
  • در Authorization Bearer توکن ساخته شده در بخش تنظیمات API در برنامه ارسال شود. در صورتی که توکن به درستی ارسال نشود با پیغام خطا مواجه می شوید.
  • برای مثال در cURL:
--header 'Authorization: Bearer C1X4Y8L3W2B1B8P4W7F7O5H8U4D5U7X6Q5L3P6U3T2Q5G2N7J6Y4T4W5U7H6U2A8Y7F2X5X5T2M2V7A2' \
اتصال به محیط های مختلف (Header)
  • جهت اتصال به محیط مورد نظر در بخش Header، نام محیط را در کلید DBName ارسال نمایید:
  • برای مثال: (cURL)
  • --header 'DBName: DB' \
  • برای بانک اطلاعاتی اکسس، نام فولدر محیط ارسال شود: DB1 محیط یک، DB محیط اصلی
  • برای بانک اطلاعاتی SQL Server، نام دیتابیس محیط ارسال شود: TahesabDB1 محیط یک، TahesabDB محیط اصلی
نکات مهم
  • فرمت آدرس URL به این شکل می باشد:
  • در حالت LOCAL: https://127.0.0.1:8081/
  • یا به آدرس آی پی اختصاصی شما (استاتیک):
  • برای مثال: https://5.12.34.56:8081/
  • آدرس URL دارای Endpoint نمی باشد.
  • درخواست ها حتما به HTTPS ارسال شود.
  • از متد POST استفاده نمایید.
  • تاریخ ها شمسی می باشد.
  • قالب تمامی درخواست ها و پاسخ ها، JSON می باشد.
پیاده سازی در POSTMAN
  • متد POST را انتخاب نمایید.
  • آدرس URL همان آی پی سیستمی که ته حساب APi فعال می باشد وارد نمایید.
  • در بخش Authorization گزینه Bearer Token را انتخاب نمایید و کد توکن را از داخل نرم افزار ته حساب بخش Api به این بخش کپی نمایید.
  • در بخش Header، یک هدر جدید به نام DBName اضافه نمایید و مقدار آن را برای مثال TahesabDB وارد نمایید.
  • در بخش Body یکی از درخواست های زیر را بسته به نیازتان وارد نمایید.
  • برای مثال: {"DoListNameSekeh":[]}
  • کلید SEND را بفشارید.
  • جواب متناسب با درخواست شما برگشت داده می شود.
  • در صورتی که با خطای Valid نبودن SSL مواجه شدید، در بخش تنظیمات POSTMAN گزینه ی SSL Certificate verification رو خاموش نمایید.
نمونه درخواست ارسالی (cURL)
  • نمونه ی ارسالی به طور مثال برای ثبت سند ورود آبشده:
  • ثبت کل شود، حساب کد ۱۱۵، شماره سند ۲، شماره ردیف ۱، تاریخ ۱۴۰۳/۰۶/۱۹، وزن ۱.۵ گرم، عیار ۷۵۰، نام آزمایشگاه خالی، شماره انگ خالی، ورود، آبشده
  • {"DoNewSanadVKHGOLD":[1, 115, 2, 1, 1403, 6, 19, 1.5, 750,"","", 0, 0]}
  • در خواست در قالب 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, 6, 19, 1.5, 750,"","", 0, 0]}'
  • نمونه پاسخ دریافتی:
  • {"OK": "0060019112024090914040472011"}
  • در پاسخ، کد منحصر به فرد هر سند بر گشت داده می شود.

لیست درخواست ها: (Body)

(در قالب JSON در Body ارسال شود)

تراز و موجودی

موجودی حساب بانکی

(Request) درخواست ارسال شده در Body:

{"GetMojoodiBank":["Name_Bank"]}

(Response) نتیجه برگشت داده شده:

{
    {
        "Name": "Mellat",
        "Mande": 2507000000.000,
        "GardeshVariz": 48170100000.000,
        "GardeshBardasht": 45663100000.000
    }
}
موجودی آبشده و متفرقه بر اساس عیار

(Request) درخواست ارسال شده در Body:

{"GetMojoodiAbshodeMotefareghe":[Ayar, Jens_Felez]}

JensFelez: عدد ۰: همه ی فلز ها، عدد ۱: طلا، عدد ۲: پلاتین، عدد ۳: نقره

(Response) نتیجه برگشت داده شده:

{
    {
        "Ayar": "750",
        "VaznMojood": 100051.650
    }
}
موجودی کارساخته

(Request) درخواست ارسال شده در Body:

{"GetMojoodiKarSakhte":["Name_Kar", Jens_Felez]}

JensFelez: عدد ۰: همه ی فلز ها، عدد ۱: طلا، عدد ۲: پلاتین، عدد ۳: نقره

(Response) نتیجه برگشت داده شده:

{
    {
        "Name": "مدال اوا",
        "VaznMojood": -100.250,
        "TedadMojood": -66.000
    }
}
تراز آبشده، سکه و ارز

(Request) درخواست ارسال شده در Body:

{"DoTarazAbshodeSekehArz":[BaEhtesabSekeh, JensFelez]}

BaEhtesabSekeh: در صورتی که این پارامتر ۰ ارسال شود، سکه هم در تراز محاسبه نمی شود، در صورتی که عدد ۱ ارسال شود، محاسبه می شود.

JensFelez: عدد ۰: همه ی فلز ها، عدد ۱: طلا، عدد ۲: پلاتین، عدد ۳: نقره

(Response) نتیجه برگشت داده شده:

{ "Vazn": 15388/82, "Pool": 185290127470, "تمام سکه ۸۶": ۱, "تمام سکه زیر ۸۶": ۴, "ربع سکه ۸۶": ۲, "ربع سکه زیر ۸۶ ": ۰, "نیم سکه ۸۶ ": ۳, "نیم سکه زیر ۸۶": ۱, "USD": 3481, "TRY": 550, "AED": 74340, "EUR": 100 }

حساب ها و مشتریان

دریافت آخرین مانده حساب و تفکیک ته حساب بر اساس کد گروه حساب

(Request) درخواست ارسال شده در Body:

{"GetMandeHesabByGID":["1"]}

(Response) نتیجه برگشت داده شده:

{ "MandeHesab": [{ "Code": "1", "MandeyeKolBePool": "6410963766", "MandeyeKolBeTALA": "97.236", "MandeyeMali": "25119906", "MandeyeVazni": "96.855", "MandeMenhayeSekeBePool": "16047584886", "MandeMenhayeSekeBeTala": "243.396", "MandeMenhayeSeke": "243.015", "Seke_sekehname": "-30", "MandeyeArz_USD": "-2005" }, { "Code": "3", "MandeyeKolBePool": "-6514081600", "MandeyeKolBeTALA": "-98.8", "MandeyeVazni": "-98.8" }] }
دریافت آخرین مانده حساب و تفکیک ته حساب چند مشتری همزمان

(Request) درخواست ارسال شده در Body:

{"getmandehesabbycode":["1","2","3"]}

(Response) نتیجه برگشت داده شده:

{ "MandeHesab": [{ "Code": "1", "MandeyeKolBePool": "6410963766", "MandeyeKolBeTALA": "97.236", "MandeyeMali": "25119906", "MandeyeVazni": "96.855", "MandeMenhayeSekeBePool": "16047584886", "MandeMenhayeSekeBeTala": "243.396", "MandeMenhayeSeke": "243.015", "Seke_sekehname": "-30", "MandeyeArz_USD": "-2005" }, { "Code": "3", "MandeyeKolBePool": "-6514081600", "MandeyeKolBeTALA": "-98.8", "MandeyeVazni": "-98.8" }] }
دریافت مانده حساب و تفکیک ته حساب یک مشتری تا تاریخ مشخص

(Request) درخواست ارسال شده در Body:

{"GetMandeHesabByTarikh":["1","1403-08-06"]}

مانده حساب و تفکیک ته حساب یک مشتری فقط تا تاریخ مشخص شده محاسبه می شود.

(Response) نتیجه برگشت داده شده:

{ "MandeyeKolBePool": "6410963766", "MandeyeKolBeTALA": "97.236", "MandeyeMali": "25119906", "MandeyeVazni": "96.855", "MandeMenhayeSekeBePool": "16047584886", "MandeMenhayeSekeBeTala": "243.396", "MandeMenhayeSeke": "243.015", "Seke_sekehname": "-30", "MandeyeArz_USD": "-2005" }
ثبت مشتری، حساب جدید

(Request) درخواست ارسال شده در Body:

{"DoNewMoshtari":["Name","GroupName", "Tel", "Address", "CodeMeli", "Tarikh_Tavalod", "Moaref", "Code_Moaref", Moshtari_Code]}

Moshtari_Code: در صورتی که این پارامتر -۱ ارسال شود کد حساب خودکار ساخته می شود.

(Response) نتیجه برگشت داده شده:

{ "OK": 11113 }

کد حساب برگشت داده می شود.

ویرایش مشتری، حساب

(Request) درخواست ارسال شده در Body:

{"DoEditMoshtari":["Name","GroupName", "Tel", "Address", "CodeMeli", "Tarikh_Tavalod", "Moaref", "Code_Moaref", Moshtari_Code]}

در صورتی که عدد -۱ در هر پارامتری ارسال شود، آن فیلد تغییر نمی کند.

برای مثال برای تغییر فقط تلفن حساب کد ۵، درخواست به این شکل ارسال می شود:

{"DoEditMoshtari":["-1","-1", "9121234567", "-1", "-1", "-1", "-1", "-1", 5]}

(Response) نتیجه برگشت داده شده:

{"OK": 11113}

کد حساب ویرایش شده، برگشت داده می شود.

لیست مشتری، حساب ها (از کد حساب تا کد حساب)

(Request) درخواست ارسال شده در Body:

{"DoListMoshtari":[From_Code,To_Code]}

(Response) نتیجه برگشت داده شده:

{ "۱": { "Code": 1, "Name": "moshtari1", "GID": "4", "GoroupName": "sazande", "Mobile": "09121231231", "CodeMelli": "", "Address": "", "City": "tehran", "Rasteh": 2, "BDate": null }, "2": { "Code": 2, "Name": "moshtari2", "GID": "1", "GoroupName": "bazar", "Mobile": "", "CodeMelli": "", "Address": "", "City": "tehran", "Rasteh": 0, "BDate": null } }
لیست مشتری، حساب ها (فیلتر بر اساس شماره تلفن)

(Request) درخواست ارسال شده در Body:

{"DoListMoshtari":[9121231231]}

شماره موبایل بدون صفر وارد شود.

(Response) نتیجه برگشت داده شده:

{ "۱": { "Code": 1, "Name": "moshtari1", "GID": "4", "GoroupName": "sazande", "Mobile": "09121231231", "CodeMelli": "", "Address": "", "City": "tehran", "Rasteh": 2, "BDate": null }}
لیست نام انواع سکه

(Request) درخواست ارسال شده در Body:

{"DoListNameSekeh":[]}

(Response) نتیجه برگشت داده شده:

[{ "Name": "10 گرم", "Vazn": 10.000, "Ayar": 999.900 }, { "Name": "2.5 گرم", "Vazn": 2.500, "Ayar": 999.900 }, { "Name": "5 گرم", "Vazn": 5.000, "Ayar": 999.900 }, { "Name": "آزادی", "Vazn": 8.130, "Ayar": 900.000 }, { "Name": "امامی", "Vazn": 8.130, "Ayar": 900.000 }, { "Name": "ربع سکه", "Vazn": 2.020, "Ayar": 900.000 }, { "Name": "نیم انس", "Vazn": 10.000, "Ayar": 999.900 }, { "Name": "نیم سکه", "Vazn": 4.060, "Ayar": 900.000 }, { "Name": "یک انس", "Vazn": 20.000, "Ayar": 999.900 }, { "Name": "یک گرم", "Vazn": 1.000, "Ayar": 999.900 }]
لیست نام حساب های بانکی

(Request) درخواست ارسال شده در Body:

{"DoListHesabBanki":[]}

(Response) نتیجه برگشت داده شده:

[{ "Name_Bank": "mellat" }, { "Name_Bank": "mellat 2" }, { "Name_Bank": "saderat" }, { "Name_Bank": "melli tankhah }]

آبشده و متفرقه

ثبت سند ورود و خروج آبشده و متفرقه

(Request) درخواست ارسال شده در Body:

{"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, "Sharh", Factor_Code, HavalehBe_Mcode, Multi_Radif, JensFelez]}

پارامتر ها در ابتدای صفحه در بخش “توضیحات پارامتر های ارسالی” شرح داده .

(Response) نتیجه برگشت داده شده:

{ "OK": "00250326120250301160030137522", "Sh_factor": "522" }
ثبت سند خرید و فروش آبشده و متفرقه

(Request) درخواست ارسال شده در Body:

{"DoNewSanadBuySaleGOLD":[Sabte_Kol_Or_Movaghat_1_0, Moshtari_Code, Factor_Number, Radif_Number, Shamsi_Year, Shamsi_Month, Shamsi_Day, Vazn, Ayar, 0, "", BuyOrSale_0_1, Mazaneh, MazanehIsMesghalOrGeram_0_1, IsMotefaregheOrAbshode_0_1, MablaghKol, "Sharh", Code_Factor, HavalehBe_Mcode, MultiRadif, Jens_Felez]}

پارامتر ها در ابتدای صفحه در بخش “توضیحات پارامتر های ارسالی” شرح داده .

(Response) نتیجه برگشت داده شده:

{ "OK": "00250326120250301160030137522", "Sh_factor": "522" }

سکه

ثبت سند ورود و خروج سکه

(Request) درخواست ارسال شده در Body:

{"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, "Sharh", Factor_Code, -1, MultiRadif, Jens_Felez]}

پارامتر ها در ابتدای صفحه در بخش “توضیحات پارامتر های ارسالی” شرح داده .

(Response) نتیجه برگشت داده شده:

{ "OK": "00250326120250301160030137522", "Sh_factor": "522" }
ثبت سند خرید و فروش سکه

(Request) درخواست ارسال شده در Body:

{"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, "Sharh", Factor_Code, -1, MultiRadif]}

پارامتر ها در ابتدای صفحه در بخش “توضیحات پارامتر های ارسالی” شرح داده .

(Response) نتیجه برگشت داده شده:

{ "OK": "00250326120250301160030137522", "Sh_factor": "522" }

مالی

ثبت سند ورود و خروج وجه نقد

(Request) درخواست ارسال شده در Body:

{"DoNewSanadVKHVaghNaghd":[Sabte_Kol_Or_Movaghat_1_0, Moshtari_Code, Factor_Number, Radif_Number, Shamsi_Year, Shamsi_Month, Shamsi_Day, IsVoroodOrKhorooj_0_1, Mablagh, "Sharh", Factor_Code, HavalehBe_Mcode, MultiRadif]}

پارامتر ها در ابتدای صفحه در بخش “توضیحات پارامتر های ارسالی” شرح داده .

(Response) نتیجه برگشت داده شده:

{ "OK": "00250326120250301160030137522", "Sh_factor": "522" }
ثبت سند دریافت از مشتری به بانک و پرداخت به مشتری از بانک

(Request) درخواست ارسال شده در Body:

{"DoNewSanadVKHBank":[Sabte_Kol_Or_Movaghat_1_0, Moshtari_Code, Factor_Number, Radif_Number, Shamsi_Year, Shamsi_Month, Shamsi_Day, IsDayaftAzMoshtariOrPardakhtBeMoshtari_0_1, Mablagh, "Sharh", "Name_Bank", "Code_Rahgiri", Factor_Code, -1 , MultiRadif]}

پارامتر ها در ابتدای صفحه در بخش “توضیحات پارامتر های ارسالی” شرح داده .

(Response) نتیجه برگشت داده شده:

{ "OK": "00250326120250301160030137522", "Sh_factor": "522" }
ثبت سند تخفیف ما به مشتری و مشتری به ما

(Request) درخواست ارسال شده در Body:

{"DoNewSanadTakhfif":[Sabte_Kol_Or_Movaghat_1_0, Moshtari_Code, Factor_Number, Radif_Number, Shamsi_Year, Shamsi_Month, Shamsi_Day, IsMaBeMoshtariOrMoshtariBeMa_0_1, Mablagh, "Sharh", Factor_Code, -1, MultiRadif]}

پارامتر ها در ابتدای صفحه در بخش “توضیحات پارامتر های ارسالی” شرح داده .

(Response) نتیجه برگشت داده شده:

{ "OK": "00250326120250301160030137522", "Sh_factor": "522" }
ثبت سند طلب ما و بدهی ما

(Request) درخواست ارسال شده در Body:

{"DoNewSanadTalabBedehi":[Sabte_Kol_Or_Movaghat_1_0, Moshtari_Code, Factor_Number, Radif_Number, Shamsi_Year, Shamsi_Month, Shamsi_Day, IsBedehiOrTalab_0_1, Mablagh, "Sharh", "Baabat", Vazn, Factor_Code, HavalehBe_Mcode, MultiRadif]}

پارامتر ها در ابتدای صفحه در بخش “توضیحات پارامتر های ارسالی” شرح داده .

(Response) نتیجه برگشت داده شده:

{ "OK": "00250326120250301160030137522", "Sh_factor": "522" }

کارساخته

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

(Request) درخواست ارسال شده در Body:

{"DoNewSanadBuySaleKar":[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_Vazn, 9_Ayar, 10_Count, 11_"Name_Kar", 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_"Sharh", 26_Factor_Code, 27_-1,28_MultiRadif, Jens_Felez]}

پارامتر ها در ابتدای صفحه در بخش “توضیحات پارامتر های ارسالی” شرح داده .

(Response) نتیجه برگشت داده شده:

{ "OK": "00250326120250301160030137522", "Sh_factor": "522" }
ثبت سند ورود و خروج کارساخته

(Request) درخواست ارسال شده در Body:

{"DoNewSanadVKHKar":[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_Vazn, 9_Ayar, 10_Count, 11_"Name_Kar", 12IsVoroodOrKhorooj_0_1, 13_OjratTedadiOrGerami_0_1, 14_MablaghKol, 15_Darsad_Maliat, 16_MeghdarMaliat, 17_Darsad_Talayee, 18_IsMarjoo_1_0, 19_"PictureFileName", 20_Ojrat, 21_PoolSang, 22_"Sharh", 23_Factor_Code, 24_HavalehBe_Mcode, 25_MultiRadif, 26_Jens_Felez]}

پارامتر ها در ابتدای صفحه در بخش “توضیحات پارامتر های ارسالی” شرح داده .

(Response) نتیجه برگشت داده شده:

{ "OK": "00250326120250301160030137522", "Sh_factor": "522" }

اتیکت

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

(Request) درخواست ارسال شده در Body:

{"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, 26_"Sharh", 27_Factor_Code, 28_0, 29_MultiRadif]}

پارامتر ها در ابتدای صفحه در بخش “توضیحات پارامتر های ارسالی” شرح داده .

(Response) نتیجه برگشت داده شده:

{ "OK": "00250326120250301160030137522", "Sh_factor": "522" }
ثبت سند ورود و خروج اتیکت

(Request) درخواست ارسال شده در Body:

{"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_VoroodOrKhorooj_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, 26_"Sharh", 27_Factor_Code, 28_0, 29_MultiSanad]}

پارامتر ها در ابتدای صفحه در بخش “توضیحات پارامتر های ارسالی” شرح داده .

(Response) نتیجه برگشت داده شده:

{ "OK": "00250326120250301160030137522", "Sh_factor": "522" }
دریافت فایل تصویر اتیکت بر اساس نام فایل

(Request) درخواست ارسال شده در Body:

{"GetEtiketPictureByFileName":["File_Name"]}

(Response) نتیجه برگشت داده شده:

همانند Web Server تصویر قابل دسترسی می باشد.
دریافت مشخصات اتیکت از طریق شناسه ی کار

(Request) درخواست ارسال شده در Body:

{"getetiketinfobycode":["1","2","3"]}

(Response) نتیجه برگشت داده شده:

{ "۱": { "Code": "1", "Code_Kar": "111", "Size": "", "Color": "", "Vitrin": "123", "Ayar": "750", "Sharh": "", "Name": "Angoshtar", "Vazn": "66.000", "IsMojood": "0", "OnlinePrice": "5327738958/67", "MazaneDarVazn": "4351512000", "DarsadSood": "0", "Sood": "0", "DarsadVAT": "9", "VAT": "80605895/67", "PoolSang": "895621063", "DarsadVazn": "0.000", "Mazaneh": "65932000", "MazanehGetTime": "2025/03/01 14:09:01", "OjratDarVazn": "0", "Base64Photo": "", "PictureFileName": "" } }

در فیلد MazanehGetTime زمان دریافت قیمت هر گرم درج می شود، با استفاده از این فیلد می توان دقیق بودن قیمت را بررسی نمود.

دریافت مشخصات اتیکت از طریق شناسه ی کار با تصویر

(Request) درخواست ارسال شده در Body:

{"getetiketinfobycodewithimage":["1","2","3"]}

(Response) نتیجه برگشت داده شده:

در این درخواست، تصویر اتیکت به شکل Base64enconding در جواب، برگشت داده می شود.
لیست اتیکت ها (از شناسه کار تا شناسه کار)

(Request) درخواست ارسال شده در Body:

{"DoListEtiket":[From_Code, To_Code, WithPhoto_1_0]}

WithPhoto: درصورتی که مقدار یک در این پارامتر ارسال شود لیست اتیکت ها با تصویر دریافت می شود.

(Response) نتیجه برگشت داده شده:

{ "۱": { "Code": "1", "Code_Kar": "111", "Size": "", "Color": "", "Vitrin": "123", "Ayar": "750", "Sharh": "", "Name": "انگشتر", "Vazn": "66.00", "IsMojood": "0", "OnlinePrice": "5236262958/67", "MazaneDarVazn": "4260036000", "DarsadSood": "0", "Sood": "0", "DarsadVAT": "9", "VAT": "80605895/67", "PoolSang": "895621063", "DarsadVazn": "0.00", "Mazaneh": "64546000", "MazanehGetTime": "2025/03/01 16:27:52", "OjratDarVazn": "0", "Base64Photo": "", "PictureFileName": "" }, "2": { "Code": "2", "Code_Kar": "A02", "Size": "", "Color": "", "Vitrin": "", "Ayar": "750", "Sharh": "", "Name": "تراشخور", "Vazn": "3.17", "IsMojood": "0", "OnlinePrice": "204610820", "MazaneDarVazn": "204610820", "DarsadSood": "0", "Sood": "0", "DarsadVAT": "9", "VAT": "0", "PoolSang": "0", "DarsadVazn": "0.00", "Mazaneh": "64546000", "MazanehGetTime": "2025/03/01 16:27:52", "OjratDarVazn": "0", "Base64Photo": "", "PictureFileName": "Etiket-202.jpg" } }
لیست اتیکت ها (فقط اتیکت های به روز شده)

(Request) درخواست ارسال شده در Body:

{"DoListGetUpdatedEtiket":["AzTarikh","TaTarikh"]}

این درخواست لیست اتیکت هایی که در این محدوده ی تاریخ ثبت، ویرایش یا فروخته شده اند را برمی گرداند.

این درخواست مناسب برای به روز کردن موجودی کالای سایت یا اپلیکیشن شما می باشد.

(Response) نتیجه برگشت داده شده:

خروجی همانند لیست اتیکت ها می باشد.
لیست اتیکت ها (فیلتر بر اساس کد کار)

(Request) درخواست ارسال شده در Body:

{"DoList_EtiketByCodeKar":["Code_Kar_String"]}

(Response) نتیجه برگشت داده شده:

خروجی همانند لیست اتیکت ها می باشد.
دریافت اطلاعات جدول اتیکت ها

(Request) درخواست ارسال شده در Body:

(Response) نتیجه برگشت داده شده:

{"GetEtiketTableInfo":[]}
{
    "CountALL": "140",
    "MinCode": "1",
    "MaxCode": "140"
}

سند

لیست اسناد ثبت شده

(Request) درخواست ارسال شده در Body:

{"DoListAsnad":[Count_Last,Moshtari_Code,"AzTarikhShamsi","TaTarikhShamsi","FilterNoSanad"]}

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

Moshtari_Code: اگر “” ارسال شود اسناد همه ی مشتری ها برگشت داده می شود

AzTarikhShamsi: فیلتر از تاریخ: ۰۱-۰۱-۱۴۰۳

TaTarikhShamsi: فیلتر تا تاریخ : ۰۱-۰۲-۱۴۰۳

FilterNoSanad: فقط اسناد مشخص شده برگشت داده می شوند، مثلا: “ورود وجه نقد” یا “خروج کارساخته”، در این پارامتر باید نوع سند جهت فیلتر ارسال شود.

(Response) نتیجه برگشت داده شده:

{ "۱۴۸۲۸۰": { "Radif": 1, "Factor_Code": "00722634120250212143506919484", "MCode": 1, "Tarikh": "1403/10/26", "ZamanSabt": "1403/11/24 14:35:06", "NO": "خرید طلا", "Sh_Factor": 484, "Vazn": 12.63, "No_Kar": "null", "Ayar": 750.00, "Fi": "null", "Mazaneh": 4600000.00, "Count": "null", "TabdilVazn": -12.63, "Mali": 10000000.00, "Name_Bank": null, "Tarikh_Cheq": null, "Sh_Cheq": null, "Sh_Posht_Check": null, "Operation_Date": null, "Sh_Sharti": null, "Name_az": null, "Baabat": null, "Sharh1": "sharh", "Sharh2": null }, "148281": { "Radif": 1, "Factor_Code": "1234567890123456789012347", "MCode": 1, "Tarikh": "1403/10/26", "ZamanSabt": "1403/11/24 14:35:15", "NO": "خرید طلا", "Sh_Factor": 485, "Vazn": 12.63, "No_Kar": "null", "Ayar": 750.00, "Fi": "null", "Mazaneh": 4600000.00, "Count": "null", "TabdilVazn": -12.63, "Mali": 10000000.00, "Name_Bank": null, "Tarikh_Cheq": null, "Sh_Cheq": null, "Sh_Posht_Check": null, "Operation_Date": null, "Sh_Sharti": null, "Name_az": null, "Baabat": null, "Sharh1": "sharh", "Sharh2": null } }
استعلام سند ثبت شده توسط APi

(Request) درخواست ارسال شده در Body:

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

(Response) نتیجه برگشت داده شده:

{ "۱۴۸۲۸۰": { "Radif": 1, "Factor_Code": "00722634120250212143506919484", "MCode": 1, "Tarikh": "1403/10/26", "ZamanSabt": "1403/11/24 14:35:06", "NO": "خرید طلا", "Sh_Factor": 484, "Vazn": 12.63, "No_Kar": "null", "Ayar": 750.00, "Fi": "null", "Mazaneh": 4600000.00, "Count": "null", "TabdilVazn": -12.63, "Mali": 10000000.00, "Name_Bank": null, "Tarikh_Cheq": null, "Sh_Cheq": null, "Sh_Posht_Check": null, "Operation_Date": null, "Sh_Sharti": null, "Name_az": null, "Baabat": null, "Sharh1": "sharh", "Sharh2": null }, "148281": { "Radif": 1, "Factor_Code": "1234567890123456789012347", "MCode": 1, "Tarikh": "1403/10/26", "ZamanSabt": "1403/11/24 14:35:15", "NO": "خرید طلا", "Sh_Factor": 485, "Vazn": 12.63, "No_Kar": "null", "Ayar": 750.00, "Fi": "null", "Mazaneh": 4600000.00, "Count": "null", "TabdilVazn": -12.63, "Mali": 10000000.00, "Name_Bank": null, "Tarikh_Cheq": null, "Sh_Cheq": null, "Sh_Posht_Check": null, "Operation_Date": null, "Sh_Sharti": null, "Name_az": null, "Baabat": null, "Sharh1": "sharh", "Sharh2": null } }
حذف سند

(Request) درخواست ارسال شده در Body:

{"DoDeleteSanad":["Factor_Code"]}

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

(Response) نتیجه برگشت داده شده:

{ ["DELETED": "00250326120250301160030137522"] }

RFID

دریافت مشخصات تگ RFID (با تصویر)

(Request) درخواست ارسال شده در Body:

{"GetInfoWithImage":["E123456789123456", "E123456789123457"]}

(Response) نتیجه برگشت داده شده:

در این درخواست، تصویر اتیکت به شکل Base64enconding در جواب، برگشت داده می شود.
دریافت مشخصات تگ RFID

(Request) درخواست ارسال شده در Body:

{"GetInfo":["E123456789123456","E123456789123457"]}

با ارسال این درخواست، مشخصات اتیکت های مرتبط با این تگ ها برگشت داده می شود

(Response) نتیجه برگشت داده شده:

{ "e123456789123456": { "Code": "1", "Code_Kar": "111", "Size": "", "Color": "", "Vitrin": "123", "Ayar": "750", "Sharh": "", "Name": "Angoshtar", "Vazn": "66.000", "IsMojood": "0", "OnlinePrice": "5327738958/67", "MazaneDarVazn": "4351512000", "DarsadSood": "0", "Sood": "0", "DarsadVAT": "9", "VAT": "80605895/67", "PoolSang": "895621063", "DarsadVazn": "0.000", "Mazaneh": "65932000", "MazanehGetTime": "2025/03/01 14:09:01", "OjratDarVazn": "0", "Base64Photo": "", "PictureFileName": "" } }
ارسال لیست تگ های RFID خوانده شده

(Request) درخواست ارسال شده در Body:

{"epcList":["E123456789123456", "E123456789123457","E123456789123458"]}

با ارسال این کد، تگ های ارسال شده به نرم افزار منتقل می شود و در بخش مربوطه قرار می گیرد.

(Response) نتیجه برگشت داده شده:

مقداری برگشت داده نمی شود.

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

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

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

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

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

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

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