نگاه کلی
پیکربندی
جدول کدهای خطا
جدول انواع
متدهای اشخاص
متدهای کالاها و خدمات
متدهای فاکتور
متدهای دریافت و پرداخت
متدهای رسید و حواله انبار
متدهای ثبت سند حسابداری
متدهای اقلام تخفیف دار
هوک تغییرات
سایر متدها
متدهای دریافت گزارش
متدهای سیستم استعلام
نمونه کد
2023-01-01 00:00:00 persion متدهای API اشخاص در نرم افزار حسابداری آنلاین حسابفا https://www.hesabfa.com/img/hesabfa-logo.png https://www.hesabfa.com/help/api/Contact متدهای اشخاص-حسابفا

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

Copyed
URL: https://api.hesabfa.com/v1/contact/get

پارامترها :

apiKey
userId
password
loginToken 		پارامتر های اجباری برای تمامی متد ها
(مشاهده توضیحات)
code کد شخص مورد نظر
Copyed 
{
     apiKey: 'asdfASR^%FDHdsfg456',
     userId: 'mail@example.com',
     password: '123456',
     loginToken: 'f6b912...45fdc',
     code: '00001'
}

آیتم های موجود در پاسخ:

Success
ErrorCode
ErrorMessage
 (مشاهده توضیحات)
Result Object نگهدارنده اطلاعات شخص
Code کد شخص
Name نام شخص
Company شرکت
FirstName نام
LastName نام خانوادگی
ContactType نوع شخص (جدول نوع اشخاص)
NationalCode کد/شناسه ملی
EconomicCode کد اقتصادی
RegistrationNumber شماره ثبت
Address آدرس شخص
City شهر
State استان
PostalCode کد پستی
Phone شماره تلفن
Fax شماره فکس
Mobile شماره موبایل
Email ایمیل
Website وب سایت
RegistrationDate تاریخ ثبت نام
Note یادداشت
SharePercent درصد سهام
Liability بدهکاری
Credits بستانکاری
ContactCredit اعتبار مالی
Tag فیلد متنی قابل استفاده توسط برنامه نویس
Active وضعیت شخص: فعال یا غیرفعال
TaxType نوع مالیات (جدول نوع مالیات شخص)
NodeFamily دسته بندی شخص: یک فیلد متنی که به فرمت زیر می باشد.
"اشخاص: دسته 1: دسته 2: ..."
Copyed 
    {
        Success: true,
        ErrorCode: 0,
        ErrorMessage: "",
        Result:{
            Code: '0001',
            Name: 'شرکت توحید',
            Company: 'شرکت توحید',
            FirstName: 'محمد',
            LastName: 'محمدی',
            ContactType: 2,
            NationalCode: '65465465465',
            EconomicCode: '13232323221',
            RegistrationNumber: '9879898798798',
            Address: "",
            City: 'تهران',
            State: 'تهران',
            PostalCode: '2154665656',
            Phone: '02188664523',
            Fax: '02188664524',
            Mobile: '09361234567',
            Email: 'info@sample.com',
            Website: "",
            RegistrationDate: '2018/05/14 13:10:22',
            Note: "",
            SharePercent: 0,
            Liability: 0,
            Credits: 0,
            ContactCredit: 0,
            Tag: '',
            Active: true,
            TaxType: 5,
            NodeFamily: 'اشخاص:اشخاص حقوقی:سازمان ها'
        }
    }
Copyed
URL: https://api.hesabfa.com/v1/contact/getById

پارامترها :

apiKey
userId
password
loginToken 		پارامتر های اجباری برای تمامی متد ها
(مشاهده توضیحات)
idList id شخص یا اشخاص مورد نظر
Copyed 
{
    apiKey: 'asdfASR^%FDHdsfg456',
    userId: 'mail@example.com',
    password: '123456',
    loginToken: 'f6b912...45fdc',
    idList: [1,2,3]
}

آیتم های موجود در پاسخ:

Success
ErrorCode
ErrorMessage
 (مشاهده توضیحات)
Result Object نگهدارنده اطلاعات شخص
Code کد شخص
Name نام شخص
Company شرکت
FirstName نام
LastName نام خانوادگی
ContactType نوع شخص (جدول نوع اشخاص)
NationalCode کد/شناسه ملی
EconomicCode کد اقتصادی
RegistrationNumber شماره ثبت
Address آدرس شخص
City شهر
State استان
PostalCode کد پستی
Phone شماره تلفن
Fax شماره فکس
Mobile شماره موبایل
Email ایمیل
Website وب سایت
RegistrationDate تاریخ ثبت نام
Note یادداشت
SharePercent درصد سهام
Liability بدهکاری
Credits بستانکاری
ContactCredit اعتبار مالی
Tag فیلد متنی قابل استفاده توسط برنامه نویس
Active وضعیت شخص: فعال یا غیرفعال
TaxType نوع مالیات (جدول نوع مالیات شخص)
NodeFamily دسته بندی شخص: یک فیلد متنی که به فرمت زیر می باشد.
"اشخاص: دسته 1: دسته 2: ..."
Copyed 
{
    Success: true,
    ErrorCode: 0,
    ErrorMessage: "",
    Result:{
        Code: '0001',
        Name: 'شرکت توحید',
        Company: 'شرکت توحید',
        FirstName: 'محمد',
        LastName: 'محمدی',
        ContactType: 2,
        NationalCode: '65465465465',
        EconomicCode: '13232323221',
        RegistrationNumber: '9879898798798',
        Address: "",
        City: 'تهران',
        State: 'تهران',
        PostalCode: '2154665656',
        Phone: '02188664523',
        Fax: '02188664524',
        Mobile: '09361234567',
        Email: 'info@sample.com',
        Website: "",
        RegistrationDate: '2018/05/14 13:10:22',
        Note: "",
        SharePercent: 0,
        Liability: 0
        Credits: 0,
        ContactCredit: 0,
        Tag: '',
        Active: true,
        TaxType: 5,
        NodeFamily: 'اشخاص:اشخاص حقوقی:سازمان ها'
    }
}
Copyed
URL: https://api.hesabfa.com/v1/contact/getcontacts

پارامترها :

apiKey
userId
password
loginToken 		پارامتر های اجباری برای تمامی متد ها
(مشاهده توضیحات)
queryInfo Object فیلتر و مرتب سازی (مشاهده توضیحات)
Copyed 
{
    apiKey: 'asdfASR^%FDHdsfg456',
    userId: 'mail@example.com',
    password: '123456',
    loginToken: 'f6b912...45fdc',
    queryInfo:{
        SortBy: 'Code',
        SortDesc: true,
        Take: 20,
        Skip: 0,
        Filters:[{
            Property: 'Name',
            Operator: '*',
            Value: 'شرکت'
            }
        ]
    }
}

آیتم های موجود در پاسخ:

Success
ErrorCode
ErrorMessage
 (مشاهده توضیحات)
Result درون فیلد result آرایه ای از اشخاص قرار میگیرد.
TotalCount تعداد کل
FilteredCount تعداد فیلتر شده
From شماره ردیف شروع
To شماره ردیف خاتمه
List لیستی از Objectهای نگهدارنده اطلاعات اشخاص می باشد. هر Object شخص شامل ساختار زیر می باشد:
Code کد شخص
Name نام شخص
Company شرکت
FirstName نام
LastName نام خانوادگی
ContactType نوع شخص (جدول نوع اشخاص)
NationalCode کد/شناسه ملی
EconomicCode کد اقتصادی
RegistrationNumber شماره ثبت
Address آدرس شخص
City شهر
State استان
PostalCode کد پستی
Phone شماره تلفن
Fax شماره فکس
Mobile شماره موبایل
Email ایمیل
Website وب سایت
RegistrationDate تاریخ ثبت نام
Note یادداشت
SharePercent درصد سهام
Liability بدهکاری
Credits بستانکاری
ContactCredit اعتبار مالی
Tag فیلد متنی قابل استفاده توسط برنامه نویس
Active وضعیت شخص: فعال یا غیرفعال
TaxType نوع مالیات (جدول نوع مالیات شخص)
NodeFamily دسته بندی شخص: یک فیلد متنی که به فرمت زیر می باشد.
"اشخاص: دسته 1: دسته 2: ..."
Copyed 
{
    Success: true,
    ErrorCode: 0,
    ErrorMessage: "",
    Result: {
        TotalCount:20,        
        FilteredCount:2,      
        From:1,              
        To:2,                 
        List:[{               
            Code: '0001',
            Name: 'شرکت توحید',
            Company: 'شرکت توحید',
            FirstName: 'محمد',
            LastName: 'محمدی',
            ContactType: 2,
            NationalCode: '65465465465',
            EconomicCode: '13232323221',
            RegistrationNumber: '9879898798798',
            Address: "",
            City: 'تهران',
            State: 'تهران',
            PostalCode: '2154665656',
            Phone: '02188664523',
            Fax: '02188664524',
            Mobile: '09361234567',
            Email: 'info@sample.com',
            Website: "",
            RegistrationDate: '2018/05/14 13:10:22',
            Note: "",
            SharePercent: 0,
            Liability: 0,
            Credits: 0,
            ContactCredit: 0,
            Tag: '',
            Active: true,
            TaxType: 5,
            NodeFamily: 'اشخاص:اشخاص حقوقی:سازمان ها'
        },{
            Code: '0002',
            Name: 'شرکت آزمایشی',
            Company: 'شرکت آزمایشی',
            FirstName: 'رضا',
            LastName: 'محمدی',
            ContactType: 2,
            NationalCode: '65465465465',
            EconomicCode: '13232323221',
            RegistrationNumber: '9879898798798',
            Address: "",
            City: 'تهران',
            State: 'تهران',
            PostalCode: '2154665656',
            Phone: '02188664523',
            Fax: '02188664524',
            Mobile: '09361234567',
            Email: 'info@sample.com',
            Website: "",
            RegistrationDate: '2018/05/14 13:10:22',
            Note: "",
            SharePercent: 0,
            Liability: 0,
            Credits: 0,
            ContactCredit: 0,
            Tag: '',
            Active: false,
            TaxType: 5,
            NodeFamily: 'اشخاص:اشخاص حقوقی:سازمان ها'
        }]
    }
}
Copyed
URL: https://api.hesabfa.com/v1/contact/save

پارامترها :

apiKey
userId
password
loginToken 		پارامتر های اجباری برای تمامی متد ها
(مشاهده توضیحات)
contact Object نگهدارنده اطلاعات شخص می باشد.هر Object شامل ساختار زیرمی باشد :

* آیتم های ستاره دار ضروری هستند.
code کد شخص
در صورتی که کد شخص را وارد نکنید، شخص جدید ذخیره می شود.
در صورتی که کد وارد شود و موجود باشد، اطلاعات ویرایش می شود.
در صورتی که کد وارد شود و موجود نباشد، شخص با آن کد ذخیره خواهد شد.
*name نام شخص
company شرکت
firstName نام
lastName نام خانوادگی
* contactType نوع شخص (جدول نوع اشخاص)
nationalCode کد/شناسه ملی
economicCode کد اقتصادی
registrationNumber شماره ثبت
address آدرس شخص
city شهر
state استان
postalCode کد پستی
phone شماره تلفن
fax شماره فکس
mobile شماره موبایل
email ایمیل
website وب سایت
note یادداشت
contactCredit اعتبار مالی
tag فیلد متنی قابل استفاده توسط برنامه نویس
taxType نوع مالیات (جدول نوع مالیات شخص)
active وضعیت شخص: فعال یا غیرفعال
nodeFamily دسته بندی شخص: یک فیلد متنی که به فرمت زیر می توان دسته بندی شخص را در آن تعریف کرد.
"اشخاص: دسته 1: دسته 2: ..."
Copyed 
{
    apiKey: 'asdfASR^%FDHdsfg456',
    userId: 'mail@example.com',
    password: '123456',
    loginToken: 'f6b912...45fdc',
    contact: {                
        code: '0001',
        name: 'شرکت توحید',
        firstName: 'محمد',
        lastName: 'محمدی',
        contactType: 2,
        nodeFamily: 'اشخاص:اشخاص حقوقی:سازمان ها'
    }
}

آیتم های موجود در پاسخ:

Success
ErrorCode
ErrorMessage
 (مشاهده توضیحات)
Result در صورت موفقیت آمیز بودن، Object شخص ذخیره شده یا ویرایش شده درون Result قرار می گیرد.
Code کد شخص
Name نام شخص
Company شرکت
FirstName نام
LastName نام خانوادگی
ContactType نوع شخص (جدول نوع اشخاص)
NationalCode کد/شناسه ملی
EconomicCode کد اقتصادی
RegistrationNumber شماره ثبت
Address آدرس شخص
City شهر
State استان
PostalCode کد پستی
Phone شماره تلفن
Fax شماره فکس
Mobile شماره موبایل
Email ایمیل
Website وب سایت
Note یادداشت
ContactCredit اعتبار مالی
Tag فیلد متنی قابل استفاده توسط برنامه نویس
TaxType نوع مالیات – مقادیر مجاز: 5 – 6 – 7 - 8
Active وضعیت شخص: فعال یا غیرفعال
NodeFamily دسته بندی شخص: یک فیلد متنی که به فرمت زیر می باشد.
"اشخاص: دسته 1: دسته 2: ..."
Copyed 
{
    Success: true,
    ErrorCode: 0,
    ErrorMessage: "",
    Result: {                
        Code: '0001',
        Name: 'شرکت توحید',
        Company: 'شرکت توحید',
        FirstName: 'محمد',
        LastName: 'محمدی',
        ContactType: 2,
        NationalCode: '65465465465',
        EconomicCode: '13232323221',
        RegistrationNumber: '9879898798798',
        Address: "",
        City: 'تهران',
        State: 'تهران',
        PostalCode: '2154665656',
        Phone: '02188664523',
        Fax: '02188664524',
        Mobile: '09361234567',
        Email: 'info@sample.com',
        Website: "",
        RegistrationDate: '2018/05/14 13:10:22',
        Note: "",
        SharePercent: 0,
        Liability: 0,
        Credits: 0,
        ContactCredit: 0,
        Tag: '',
        Active: true,
        TaxType: 5,
        NodeFamily: 'اشخاص:اشخاص حقوقی:سازمان ها'
    }
}
Copyed
URL: https://api.hesabfa.com/v1/contact/batchsave

پارامترها :

apiKey
userId
password
loginToken 		پارامتر های اجباری برای تمامی متد ها
(مشاهده توضیحات)
contacts لیستی از Objectهای نگهدارنده اطلاعات اشخاص می باشد.هر Object شامل ساختار زیر می باشد :

* آیتم های ستاره دار ضروری هستند.
code کد شخص
در صورتی که کد شخص را وارد نکنید، شخص جدید ذخیره می شود.
در صورتی که کد وارد شود و موجود باشد، اطلاعات ویرایش می شود.
در صورتی که کد وارد شود و موجود نباشد، شخص با آن کد ذخیره خواهد شد.
*name نام شخص
company شرکت
firstName نام
lastName نام خانوادگی
* contactType نوع شخص (جدول نوع اشخاص)
nationalCode کد/شناسه ملی
economicCode کد اقتصادی
registrationNumber شماره ثبت
address آدرس شخص
city شهر
state استان
postalCode کد پستی
phone شماره تلفن
fax شماره فکس
mobile شماره موبایل
email ایمیل
website وب سایت
note یادداشت
contactCredit اعتبار مالی
tag فیلد متنی قابل استفاده توسط برنامه نویس
active وضعیت شخص: فعال یا غیرفعال
taxType نوع مالیات (جدول نوع مالیات شخص)
nodeFamily دسته بندی شخص: یک فیلد متنی که به فرمت زیر می باشد.
"اشخاص: دسته 1: دسته 2: ..."
Copyed 
{
    apiKey: 'asdfASR^%FDHdsfg456',
    userId: 'mail@example.com',
    password: '123456',
    loginToken: 'f6b912...45fdc',
    contacts:[{                
        code: '0001',
        name: 'شرکت توحید',
        firstName: 'محمد',
        lastName: 'محمدی',
        contactType: 2,
        nodeFamily: 'اشخاص:اشخاص حقوقی:سازمان ها'
    }, {
        name: 'رضا علی پور',
        contactType: 1
    }]
}

آیتم های موجود در پاسخ:

Success
ErrorCode
ErrorMessage
 (مشاهده توضیحات)
Result در صورت موفقیت آمیز بودن، لیستی از اشخاص ذخیره شده یا ویرایش شده درون Result قرار می گیرد.
Code کد شخص
Name نام شخص
Company شرکت
FirstName نام
LastName نام خانوادگی
ContactType نوع شخص (جدول نوع اشخاص)
NationalCode کد/شناسه ملی
EconomicCode کد اقتصادی
RegistrationNumber شماره ثبت
Address آدرس شخص
City شهر
State استان
PostalCode کد پستی
Phone شماره تلفن
Fax شماره فکس
Mobile شماره موبایل
Email ایمیل
Website وب سایت
Note یادداشت
ContactCredit اعتبار مالی
Tag فیلد متنی قابل استفاده توسط برنامه نویس
TaxType نوع مالیات (جدول نوع مالیات شخص)
Active وضعیت شخص: فعال یا غیرفعال
NodeFamily دسته بندی شخص: یک فیلد متنی که به فرمت زیر می باشد.
"اشخاص: دسته 1: دسته 2: ..."
Copyed 
{
    Success: true,
    ErrorCode: 0,
    ErrorMessage: "",
    Result: [{                
        Code: '0001',
        Name: 'شرکت توحید',
        Company: 'شرکت توحید',
        FirstName: 'محمد',
        LastName: 'محمدی',
        ContactType: 2,
        NationalCode: '65465465465',
        EconomicCode: '13232323221',
        RegistrationNumber: '9879898798798',
        Address: "",
        City: 'تهران',
        State: 'تهران',
        PostalCode: '2154665656',
        Phone: '02188664523',
        Fax: '02188664524',
        Mobile: '09361234567',
        Email: 'info@sample.com',
        Website: "",
        RegistrationDate: '2018/05/14 13:10:22',
        Note: "",
        SharePercent: 0,
        Liability: 0,
        Credits: 0,
        ContactCredit: 0,
        Tag: '',
        Active: true,
        TaxType: 5,
    }, {                
        Code: '0005',
        Name: 'رضا علی پور',
        Company: '',
        FirstName: '',
        LastName: '',
        ContactType: 1,
        NationalCode: '',
        EconomicCode: '',
        RegistrationNumber: '',
        Address: "",
        City: '',
        State: '',
        PostalCode: '',
        Phone: '',
        Fax: '',
        Mobile: '',
        Email: '',
        Website: "",
        RegistrationDate: '2018/05/14 13:10:22',
        Note: "",
        SharePercent: 0,
        Liability: 0,
        Credits: 0,
        ContactCredit: 0,
        Tag: '',
        Active: false,
        TaxType: 5,
        NodeFamily: 'اشخاص:اشخاص حقوقی:سازمان ها'
    }]
}
Copyed
URL: https://api.hesabfa.com/v1/contact/delete

پارامترها :

apiKey
userId
password
loginToken 		پارامتر های اجباری برای تمامی متد ها
(مشاهده توضیحات)
code کد شخص مورد نظر
Copyed 
{
    apiKey: 'asdfASR^%FDHdsfg456',
    userId: 'mail@example.com',
    password: '123456',
    loginToken: 'f6b912...45fdc',
    code: '00001'
}

آیتم های موجود در پاسخ:

Success
ErrorCode
ErrorMessage
 (مشاهده توضیحات)
Result در صورت موفقیت آمیز بودن مقدار true درون Result قرار می گیرد.
Copyed 
{
    Success: true,
    ErrorCode: 0,
    ErrorMessage: "",
    Result: true
}
Copyed
URL: https://api.hesabfa.com/v1/contact/getContactLink

پارامترها :

apiKey
userId
password
loginToken 		پارامتر های اجباری برای تمامی متد ها
(مشاهده توضیحات)
code کد شخص مورد نظر
showAllAccounts نمایش سایر حسابها(پیشفرض false)
days تعداد روز اعتبار (پیشفرض 30 روز)
Copyed 
{
    apiKey: 'asdfASR^%FDHdsfg456',
    userId: 'mail@example.com',
    password: '123456',
    loginToken: 'f6b912...45fdc',
    code: '00001',
    showAllAccounts: true,
    days: 3
}

آیتم های موجود در پاسخ:

Success
ErrorCode
ErrorMessage
Result 		(مشاهده توضیحات)
Link لینک کارت حساب شخص
Copyed 
{
    Success: true,
    ErrorCode: 0,
    ErrorMessage: "",
    Result: {
        Link: "https://app.hesabfa.com/public/contact/bfe03..."
    }
}