نگاه کلی
پیکربندی
جدول کدهای خطا
جدول انواع
متدهای اشخاص
متدهای کالاها و خدمات
متدهای فاکتور
متدهای دریافت و پرداخت
متدهای رسید و حوالۀ انبار
متدهای ثبت سند حسابداری
متدهای اقلام تخفیف‌دار
متدهای انتقال بین بانکی
هوک تغییرات
متدهای دیگر
متدهای دریافت گزارش
متدهای سیستم استعلام
نمونۀ کد

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

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 وب سایت
BirthDate تاریخ تولد
WeddingDate تاریخ ازدواج
MembershipDate تاریخ عضویت
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: "",
            BirthDate: '2000/05/04',
            WeddingDate: '2021/05/14',
            MembershipDate: '2023/01/14',
            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 وب سایت
BirthDate تاریخ تولد
WeddingDate تاریخ ازدواج
MembershipDate تاریخ عضویت
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: "",
        BirthDate: '2000/05/04',
        WeddingDate: '2021/05/14',
        MembershipDate: '2023/01/14',
        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 وب سایت
BirthDate تاریخ تولد
WeddingDate تاریخ ازدواج
MembershipDate تاریخ عضویت
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: "",
            BirthDate: '2000/05/04',
            WeddingDate: '2021/05/14',
            MembershipDate: '2023/01/14',
            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: "",
            BirthDate: '2000/05/04',
            WeddingDate: '2021/05/14',
            MembershipDate: '2023/01/14',
            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 وب سایت
BirthDate تاریخ تولد
WeddingDate تاریخ ازدواج
MembershipDate تاریخ عضویت
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 وب سایت
BirthDate تاریخ تولد
WeddingDate تاریخ ازدواج
MembershipDate تاریخ عضویت
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: "",
        BirthDate: '2000/05/04',
        WeddingDate: '2021/05/14',
        MembershipDate: '2023/01/14',
        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 وب سایت
BirthDate تاریخ تولد
WeddingDate تاریخ ازدواج
MembershipDate تاریخ عضویت
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 وب سایت
BirthDate تاریخ تولد
WeddingDate تاریخ ازدواج
MembershipDate تاریخ عضویت
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: "",
        BirthDate: '2000/05/04',
        WeddingDate: '2021/05/14',
        MembershipDate: '2023/01/14',
        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: "",
        BirthDate: '2000/05/04',
        WeddingDate: '2021/05/14',
        MembershipDate: '2023/01/14',
        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..."
    }
}