نام موجودیت :تفصیلی
نام سیستمی : Detail
مسیر api ها : https://app.samyarcloud2.ir/Detail
کلید اصلی : DetailId
ویژگیها (properties)
لیست فیلدهای موجودیت تفصیلی در زیر آمده است .
ویژگی | عنوان | نوع ثبت | نوع | موجودیت اصلی | شرح |
DetailId | شناسه تفصیلی | سیستمی | int | کلید اصلی | |
DetailCode | کد تفصیلی | اجباری | int | بخش آخر کد تفصیلی | |
DetailGroupId | شناسه گروه تفصیلی | اجباری | int | ||
DetailGroupCode | کد گروه تفصیلی | سیستمی | int | ||
FullCode | کد کامل تفصیلی | فقط خواندنی | string | کد گروه تفصیلی + کد تفصیلی | |
Cheque_BankId | شناسه حساب بانک مربوطه | اختیاری | int | تفصیلی | مخصوص حسابهای دارای کاربری چک |
Cheque_Bank_Title | عنوان حساب بانک مربوطه | اختیاری | string | تفصیلی | مخصوص حسابهای دارای کاربری چک |
Cheque_Bank_FullCode | کد کامل حساب بانک مربوطه | اختیاری | string | تفصیلی | مخصوص حسابهای دارای کاربری چک |
Person_PersonType | نوع شخص | اختیاری | int | تفصیلی | مخصوص اشخاص و شرکتها 1-شخص 2-شرکت |
Person_Name | نام و نام خانوادگی / نام شرکت | اختیاری | string | مخصوص اشخاص و شرکتها | |
Person_FirstName | نام | اختیاری | string | مخصوص اشخاص | |
Person_LastName | نام خانوادگی | اختیاری | string | مخصوص اشخاص | |
Person_Brand | نام شرکت شخص | اختیاری | string | مخصوص اشخاص | |
Person_NationalCode | کد ملی / شناسه ملی | اختیاری | string | مخصوص اشخاص و شرکتها | |
Person_EconomicCode | کد اقتصادی | اختیاری | string | مخصوص اشخاص و شرکتها | |
Person_RegisterNo | شماره ثبت شرکت | اختیاری | string | مخصوص شرکتها | |
Person_Address | آدرس | اختیاری | string | مخصوص اشخاص و شرکتها | |
Person_Phone | تلفن | اختیاری | string | مخصوص اشخاص و شرکتها | |
Person_Fax | فکس | اختیاری | string | مخصوص اشخاص و شرکتها | |
Person_Mobile | موبایل | اختیاری | string | مخصوص اشخاص و شرکتها | |
Person_Email | ایمیل | اختیاری | string | مخصوص اشخاص و شرکتها | |
Person_PostalCode | کد پستی | اختیاری | string | مخصوص اشخاص و شرکتها | |
Person_AccountNumber | شماره حساب | اختیاری | string | مخصوص اشخاص و شرکتها | |
Person_CardNumber | شماره کارت | اختیاری | string | مخصوص اشخاص و شرکتها | |
Person_ShebaNumber | شماره شبا | اختیاری | string | مخصوص اشخاص و شرکتها | |
Person_Ceo | نام مدیر عامل | اختیاری | string | مخصوص شرکتها | |
Person_FinantionalManager | نام مدیر مالی | اختیاری | string | مخصوص اشخاص و شرکتها | |
Person_AccountCredit | حد اعتبار مانده حساب | اختیاری | decimal | مخصوص اشخاص و شرکتها | |
Person_ChequeCredit | حد اعتبار چکهای وصول نشده | اختیاری | decimal | مخصوص اشخاص و شرکتها | |
Person_TaxStatus | وضعیت مالیات | اختیاری | int | مخصوص اشخاص و شرکتها 5- مشمول مالیات 6- مشمول ماده 81 ق.م.م 7- غیرمشمول مالیات 8- مصرف کننده نهایی | |
StateId | شناسه استان | اختیاری | int | استان | مخصوص اشخاص و شرکتها |
State_Title | عنوان استان | فقط خواندنی | string | استان | مخصوص اشخاص و شرکتها |
CityId | شناسه شهر | اختیاری | int | شهر | مخصوص اشخاص و شرکتها |
City_Title | عنوان شهر | فقط خواندنی | string | شهر | مخصوص اشخاص و شرکتها |
IsSecret | محرمانه | اجباری | boolean | دسترسی به حسابهای محرمانه محدود می باشد | |
Locked | مسدود شده | اجباری | boolean | حساب مسدود شده را نمی توان استفاده کرد | |
InActivityReason | علت مسدود شدن | اختیاری | string | ||
ReferenceKey | شناسه مرجع | سیستمی | string | مخصوص استفاده در سایر سیستم ها | |
DebtDiff | مانده بدهکار | فقط خواندنی | decimal | ||
DebtDiff | مانده بستانکار | فقط خواندنی | decimal | ||
Diff | مانده | فقط خواندنی | decimal | مانده بدهکار منهای مانده بستانکار | |
CreatedDate | تاریخ ایجاد | سیستمی | date | ||
CreatedUserID | شناسه کاربر ایجاد کننده | اجباری | int | کاربران | |
ModifiedDate | تاریخ ویرایش | سیستمی | date | ||
ModifiedUserID | شناسه کاربر ویرایش کننده | اجباری | int | کاربران |
متد ایجاد
مسیر : https://app.samyarcloud2.ir/Detail/Create
متد ارسال : POST
نمونه پارامترهای ارسالی جهت ایجاد تفصیلی در زیر آمده است .
پارامترهای ورودی ایجاد
DetailCode:
Title: محمد محمدی - سامیار
DetailGroupId: 11
ِCheque_BankId:
Person_PersonType: 1
Person_Name: محمد محمدی
Person_FirstName: محمد
Person_LastName: محمدی
Person_Brand: سامیار
Person_NationalCode: 09954525124
Person_EconomicCode:
Person_RegisterNo:
Person_Address: خ پیروزی
Person_Phone:
Person_Fax:
Person_Mobile: 09122111111
Person_Email: a@b.com
Person_PostalCode:
Person_AccountNumber:
Person_ShebaNumber:
Person_CardNumber:
Person_Ceo:
Person_FinantionalManager:
Person_ChequeCredit:
Person_AccountCredit:
Person_CreditControlType:
Person_Desc:
Locked: false
IsSecret: false
InActivityReason:
CityId:
Person_TaxStatus:
پارامترهای خروجی ایجاد
در صورتی که عملیات با موفقیت انجام شود MessageType برابر 3 ، در صورتی که با اخطار انجام شود عدد 2 و در صورتی که با خطا مواجه شده و انجام نشود برابر 1 خواهد بود.
{
"Person_PersonTypeStr": "شخص",
"Person_TaxStatusStr": null,
"LockedStr": "خیر",
"IsSecretStr": "خیر",
"Message": "آیتم با موفقیت اضافه شد .",
"MessageType": 3,
"FullCode": "1006",
"DebtDiff": 0.0,
"CreditDiff": 0.0,
"Diff": 0.0,
"Cheque_Bank_Title": null,
"Cheque_Bank_FullCode": null,
"StateId": null,
"State_Title": null,
"City_Title": null,
"ReferenceKey": null,
"CreatedDate": null,
"CreatedUserID": null,
"ModifiedDate": null,
"ModifiedUserID": null,
"DetailId": 248,
"DetailGroup": null,
"DetailGroupId": 4,
"DetailGroupTitle": "اشخاص",
"DetailCode": 6,
"Title": "محمد محمدی - سامیار",
"Cheque_BankId": null,
"Person_PersonType": 1,
"Person_Name": "محمد محمدی",
"Person_FirstName": "محمد",
"Person_LastName": "محمدی",
"Person_Brand": "سامیار",
"Person_NationalCode": "09954525124",
"Person_EconomicCode": null,
"Person_RegisterNo": null,
"Person_Address": "خ پیروزی",
"Person_Phone": null,
"Person_Fax": null,
"Person_Mobile": "09122111111",
"Person_Email": "a@b.com",
"Person_PostalCode": null,
"Person_AccountNumber": null,
"Person_CardNumber": null,
"Person_ShebaNumber": null,
"Person_Ceo": null,
"Person_FinantionalManager": null,
"Person_ChequeCredit": null,
"Person_AccountCredit": null,
"Person_Desc": null,
"Locked": false,
"InActivityReason": null,
"IsSecret": false,
"CityId": null,
"Person_TaxStatus": null
}
دریافت لیست گروههای تفصیلی
برای دریافت لیست گروههای تفصیلی و تفصیلی2 از درخواست زیر استفاده کنید
متد ارسال: GET
Query String Parameters:
domain: DetailGroup
parentId: -1
view: 0
خروجی:
[
{value: 0, text: "", data: "0,0"}
{value: 1, text: "اموال", data: "31,1"}
{value: 2, text: "چک", data: "12,2"}
{value: 3, text: "درآمد", data: "41,3"}
{value: 4, text: "اشخاص", data: "11,4"}
{value: 5, text: "عمومی", data: "91,5"}
{value: 6, text: "نقد و بانک", data: "13,6"}
{value: 7, text: "هزینه", data: "51,7"}
{value: 8, text: "دسته بندی اشخاص (مدل دوم استفاده از شناور ها )", data: "81,5"}
{value: 9, text: "مشتریان", data: "14,4"}
{value: 18, text: "همکاران", data: "21,4"}
{value: 20, text: "اشخاص شعبه 2", data: "17,4"}
{value: 21, text: "پروژه ها", data: "18,1"}
{value: 24, text: "مراکز هزینه", data: "80,7"}
]
متد ویرایش
مسیر : https://app.samyarcloud2.ir/Detail/Update
متد ارسال : POST
نمونه پارامترهای ارسالی جهت ویرایش تفصیلی در زیر آمده است .
در متد ویرایش فقط DetailId اجباری می باشد .
پارامترهای ورودی ویرایش
DetailId: 248
DetailCode: 0006
Title: محمد محمدی - سامیار
Person_PersonType: 1
Person_Name: محمد محمدی
Person_FirstName: محمد
Person_LastName: محمدی
Person_Brand: سامیار
Person_NationalCode: 09954525124
Person_EconomicCode:
Person_RegisterNo:
Person_Address: خ پیروزی - پیروزی 42
Person_Phone:
Person_Fax:
Person_Mobile: 09122111111
Person_Email: a@b.com
Person_PostalCode:
Person_AccountNumber:
Person_ShebaNumber:
Person_CardNumber:
Person_Ceo:
Person_FinantionalManager: رضا رضایی
Person_ChequeCredit: 12,000,000
Person_AccountCredit: 150,000,000
Person_CreditControlType:
Person_Desc:
Locked: false
IsSecret: false
InActivityReason:
CityId: 1901000
Person_TaxStatus: 7
پارامترهای خروجی ویرایش
مشابه متد ایجاد
متد حذف
مسیر : https://app.samyarcloud2.ir/ِDetail/Delete/{DetailId}
متد ارسال : POST
پارامترهای ورودی حذف
DetailId Ex : https://app.samyarcloud2.ir/Detail/Delete/28
پارامترهای خروجی حذف
{ DetailId: 28 Message: “آیتم با موفقیت حذف شد .” MessageType: 3 }
متد گرفتن یک آیتم (Get)
مسیر : https://app.samyarcloud2.ir/Detail/Get/{DetailId}
متد ارسال : GET
این متد کلید یک موجودیت را دریافت کرده و مقادیر مربوط با آن را برمی گرداند .
پارامترهای ورودی Get
DetailId Ex : https://app.samyarcloud2.ir/Detail/Get/24
پارامترهای خروجی Get
مشابه متد ایجاد
متد گرفتن همه آیتم ها (GetSome)
مسیر: https://app.samyarcloud2.ir/Detail/GetSome
روش ارسال : POST
پارامترهای ورودی GetSome
پارامتر view مقادیر زیر را می تواند داشته باشد
0 : عدم مشاهده ستونهای مانده حساب – مشاهده حسابهای مسدود شده – مشاهده اطلاعات تماس اشخاص
1 : مشاهده ستونهای مانده حساب – مشاهده حساب های مسود شده – عدم مشاهده اطلاعات تماس اشخاص
2 : مشاهده ستونهای مانده حساب – عدم مشاهده حساب های مسود شده – عدم مشاهده اطلاعات تماس اشخاص
3 : مشاهده حساب های مسود شده – مشاهده ستونهای مانده حساب – مشاهده اطلاعات شخص
10 : مشاهده ستونهای مانده حساب – عدم مشاهده حساب های مسدود شده – عدم مشاهده اطلاعات تماس اشخاص
12 : مشاهده ستونهای مانده حساب – عدم مشاهده حساب های مسدود شده – عدم مشاهده اطلاعات تماس اشخاص – فقط مشاهده حسابهای نقد و بانک
13 : مشاهده ستونهای مانده حساب – عدم مشاهده حساب های مسدود شده – عدم مشاهده اطلاعات تماس اشخاص – فقط مشاهده حسابهای چک
14 : مشاهده ستونهای مانده حساب – مشاهده حساب های مسدود شده – عدم مشاهده اطلاعات تماس اشخاص – فقط مشاهده حسابهای اشخاص و شرکتها
MasterId: 0 // استفاده نشده
Skip: 0 // استفاده نشده
Take: 10000 // تعداد آیتم برگشتی
OrderField: Title // مرتب سازی بر اساس
Order: asc // صعودی یا نزولی
View: 1
Force: false // استفاده نشده
parameters: // استفاده نشده
پارامترهای خروجی GetSome
{
"itemCount": 6,
"startTime": "2019/09/01 10: 00:11.1135", // زمان دریافت درخواست در سرور
"endTime": "2019/09/01 10: 00:11.7785", // زمان پاسخ به درخواست در سرور
"extra": null,
"values": [
{
"Person_PersonTypeStr": null,
"Person_TaxStatusStr": null,
"LockedStr": "خیر",
"IsSecretStr": "خیر",
"Message": null,
"MessageType": 0,
"FullCode": "1101",
"DebtDiff": 0.0,
"CreditDiff": 0.0,
"Diff": 0.0,
"Cheque_Bank_Title": null,
"Cheque_Bank_FullCode": null,
"StateId": null,
"State_Title": null,
"City_Title": null,
"ReferenceKey": null,
"CreatedDate": null,
"CreatedUserID": null,
"ModifiedDate": null,
"ModifiedUserID": null,
"DetailId": 90,
"DetailCode": 1,
"DetailGroup": null,
"DetailGroupId": 4,
"DetailGroupTitle": "اشخاص",
"Title": "وحید امیری مقدم ...",
"Cheque_BankId": null,
"Person_PersonType": null,
"Person_Name": null,
"Person_FirstName": null,
"Person_LastName": null,
"Person_Brand": null,
"Person_NationalCode": null,
"Person_EconomicCode": null,
"Person_RegisterNo": null,
"Person_Address": null,
"Person_Phone": null,
"Person_Fax": null,
"Person_Mobile": null,
"Person_Email": null,
"Person_PostalCode": null,
"Person_AccountNumber": null,
"Person_CardNumber": null,
"Person_ShebaNumber": null,
"Person_Ceo": null,
"Person_FinantionalManager": null,
"Person_ChequeCredit": null,
"Person_AccountCredit": null,
"Person_Desc": null,
"Locked": false,
"InActivityReason": null,
"IsSecret": false,
"CityId": null,
"Person_TaxStatus": null
}
,...
]
}
متد گرفتن تفصیلی های یک گروه تفصیلی خاص (GetSomeByMasterId)
مسیر : https://app.samyarcloud2.ir/Detail/GetSomeByMasterId
روش ارسال : POST
تفصیلی های ذیل یک گروه تفصیلی خاص را برمی گرداند
پارامترهای ورودی GetSomeByMasterId
MasterId: 24 // شناسه گروه تفصیلی
Skip: 0 // استفاده نشده
Take: 10000 // تعداد آیتم برگشتی
OrderField: Title // مرتب سازی بر اساس
Order: asc // صعودی یا نزولی
View: 1 // مشابه متد GetSome
Force: false // استفاده نشده
parameters: // استفاده نشده
پارامترهای خروجی GetSomeByMasterId
مشابه GetSome
متد جستجو (GetSomeByMasterIdAndParams)
مسیر : https://app.samyarcloud2.ir/Detail/GetSomeByMasterIdAndParams
روش ارسال : POST
از این متد برای جستجوی تفصیلی استفاده می شود .
پارامترهای ورودی GetSomeByMasterIdAndParams
MasterId: 95 //شناسه گروه تفصیلی
Skip: 0 // استفاده نشده
Take: 10000 // حداکثر تعداد آیتم برگشتی
OrderField: Title // مرتب سازی بر اساس فیلد
Order: asc // صعودی یا نزولی
View: 3 // در GetSome توضیح داده شده است
Force: true // سیستمی
parameters:
{
"params": null, // استفاده نشده
"filter": {
"FromFullCode": "72010001", // کد تفصیلی از
"ToFullCode": "72010001", // کد تفصیلی تا
"Title": "ا", // عنوان شامل
"Person_Mobile": "0912", // موبایل شامل
"Person_Address": "پیروزی", // آدرس شامل
"FromPerson_AccountCredit": "1000", // اعتبار حساب از
"ToPerson_AccountCredit": "1000000000.00", // اعتبار حساب تا
"FromPerson_ChequeCredit": "10000", // احتبار چک از
"ToPerson_ChequeCredit": "500000000", // اعتبار چک تا
}
}
پارامترهای خروجی GetSomeByMasterIdAndParams
مشابه GetSome