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

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

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

پارامترهای اجباری:

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

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

Success
ErrorCode
ErrorMessage
 (مشاهدۀ توضیحات)
Result Object کالا یا خدمات مورد نظر
Code کد حسابداری کالا یا خدمات
Name نام کالا یا خدمات
Barcode بارکد کالا یا خدمات
ItemType نوع ( جدول نوع کالا/خدمات)
Unit واحد اصلی خرید و فروش
SubUnit واحد فرعی خرید و فروش
ConversionFactor ضریب تبدیل (واحد اصلی خرید و فروش به واحد فرعی)
Stock موجودی کالا
BuyPrice قیمت خرید
SellPrice قیمت فروش
PurchasesTitle عنوان در فاکتور فروش
SalesTitle عنوان در فاکتور خرید
NodeFamily مسیر دسته‌بندی
Tag فیلد متنی قابل استفاده توسط برنامه‌نویس
Description توضیحات
ProductCode کد کالا یا خدمات
Active وضعیت کالا: فعال یا غیرفعال
TaxId کد مالیاتی
TaxUnit واحد مالیاتی
ReorderPoint نقطه سفارش
LeadTime زمان انتظار
MinimumOrder حداقل سفارش
PriceList لیست قیمت
Title عنوان
Currency واحد پول
Price قیمت
Copyed 
{
     Success: true,
     ErrorCode: 0,
     ErrorMessage: "",
     Result: {
        "Code": "000001",
        "Name": "Galaxy J7 گوشی موبایل",
        "Barcode": "345345345345",
        "ItemType": 0,
        "Unit": "عدد",
        "SubUnit": "کارتن",
        "ConversionFactor": 10.000000,
        "Stock": 10,
        "BuyPrice": 500000,
        "SellPrice": 550000,
        "PurchasesTitle": "Samsung Galaxy J7",
        "SalesTitle": "Samsung Galaxy J7",
        "NodeFamily": "دیجیتال:موبایل:سامسونگ",
        "Tag": "",
        "Description": "",
        "ProductCode": "745921",
        "Active": true,
        "TaxId": "1301234567890",
        "TaxUnit": "کارتن",
        "ReorderPoint": 12.000000,
        "LeadTime": 3,
        "MinimumOrder": 5.000000,
        "PriceList": [
            {
                "Title": "عمده",
                "Currency": "IRR",
                "Price": 520000
            },
            {
                "Title": "همکار",
                "Currency": "IRR",
                "Price": 525000
            },
            {
                "Title": "مشتری ویژه",
                "Currency": "IRR",
                "Price": 540000
            }
        ]
    }
}
Copyed
URL:https://api.hesabfa.com/v1/item/getByBarcode

پارامترها :

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

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

Success
ErrorCode
ErrorMessage
 (مشاهدۀ توضیحات)
Result Object کالا یا خدمات مورد نظر
Code کد حسابداری کالا یا خدمات
Name نام کالا یا خدمات
Barcode بارکد کالا یا خدمات
ItemType نوع ( جدول نوع کالا/خدمات)
Unit واحد اصلی خرید و فروش
SubUnit واحد فرعی خرید و فروش
ConversionFactor ضریب تبدیل(واحد اصلی خرید و فروش به واحد فرعی)
Stock موجودی
BuyPrice قیمت خرید
SellPrice قیمت فروش
PurchasesTitle عنوان در فاکتور فروش
SalesTitle عنوان در فاکتور خرید
NodeFamily مسیر دسته‌بندی
Tag فیلد متنی قابل استفاده توسط برنامه‌نویس
Description توضیحات
ProductCode کد کالا یا خدمات
Active وضعیت کالا: فعال یا غیرفعال
TaxId کد مالیاتی
TaxUnit واحد مالیاتی
ReorderPoint نقطه سفارش
LeadTime زمان انتظار
MinimumOrder حداقل سفارش
PriceList لیست قیمت
Title عنوان
Currency واحد پول
Price قیمت
مثال:
Copyed 
{
     Success: true,
     ErrorCode: 0,
     ErrorMessage: "",
     Result: {
        "Code": "000001",
        "Name": "Galaxy J7 گوشی موبایل",
        "Barcode": "345345345345",
        "ItemType": 0,
        "Unit": "عدد",
        "SubUnit": "کارتن",
        "ConversionFactor": 10.000000,
        "Stock": 10,
        "BuyPrice": 500000,
        "SellPrice": 550000,
        "PurchasesTitle": "Samsung Galaxy J7",
        "SalesTitle": "Samsung Galaxy J7",
        "NodeFamily": "دیجیتال:موبایل:سامسونگ",
        "Tag": "",
        "Description": "",
        "ProductCode": "745921",
        "Active": true,
        "TaxId": "1301234567890",
        "TaxUnit": "کارتن",
        "ReorderPoint": 12.000000,
        "LeadTime": 3,
        "MinimumOrder": 5.000000,
        "PriceList": [
            {
                "Title": "عمده",
                "Currency": "IRR",
                "Price": 520000
            },
            {
                "Title": "همکار",
                "Currency": "IRR",
                "Price": 525000
            },
            {
                "Title": "مشتری ویژه",
                "Currency": "IRR",
                "Price": 540000
            }
        ]
    }
}
Copyed
URL:https://api.hesabfa.com/v1/item/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 نام کالا یا خدمات
Barcode بارکد کالا یا خدمات
ItemType نوع ( جدول نوع کالا/خدمات)
Unit واحد اصلی خرید و فروش
SubUnit واحد فرعی خرید و فروش
ConversionFactor ضریب تبدیل (واحد اصلی خرید و فروش به واحد فرعی)
Stock موجودی کالا
BuyPrice قیمت خرید
SellPrice قیمت فروش
PurchasesTitle عنوان در فاکتور فروش
SalesTitle عنوان در فاکتور خرید
NodeFamily مسیر دسته‌بندی
Tag فیلد متنی قابل استفاده توسط برنامه‌نویس
Description توضیحات
ProductCode کد کالا یا خدمات
LastPurchaseCost آخرین قیمت خرید
Active وضعیت کالا: فعال یا غیرفعال
TaxId کد مالیاتی
TaxUnit واحد مالیاتی
ReorderPoint نقطه سفارش
LeadTime زمان انتظار
MinimumOrder حداقل سفارش
PriceList لیست قیمت
Title عنوان
Currency واحد پول
Price قیمت
Copyed 
{
     Success: true,
     ErrorCode: 0,
     ErrorMessage: "",
     Result: {
        "Code": "000001",
        "Name": "Galaxy J7 گوشی موبایل",
        "Barcode": "345345345345",
        "ItemType": 0,
        "Unit": "عدد",
        "SubUnit": "کارتن",
        "ConversionFactor": 10.000000,
        "Stock": 10,
        "BuyPrice": 500000,
        "SellPrice": 550000,
        "PurchasesTitle": "Samsung Galaxy J7",
        "SalesTitle": "Samsung Galaxy J7",
        "NodeFamily": "دیجیتال:موبایل:سامسونگ",
        "Tag": "",
        "Description": "",
        "ProductCode": "745921",
        "Active": true,
        "TaxId": "1301234567890",
        "TaxUnit": "کارتن",
        "ReorderPoint": 12.000000,
        "LeadTime": 3,
        "MinimumOrder": 5.000000,
        "PriceList": [
            {
                "Title": "عمده",
                "Currency": "IRR",
                "Price": 520000
            },
            {
                "Title": "همکار",
                "Currency": "IRR",
                "Price": 525000
            },
            {
                "Title": "مشتری ویژه",
                "Currency": "IRR",
                "Price": 540000
            }
        ]
    }
}
Copyed
URL:https://api.hesabfa.com/v1/item/getItems

پارامترها :

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: 'Galaxy'
			}
		]
	}
 }

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

Success
ErrorCode
ErrorMessage
 (مشاهدۀ توضیحات)
Result درون فیلد result آرایه‌ای از کالاها قرار می‌گیرد.
TotalCount تعداد کل
FilteredCount تعداد فیلتر شده
From شمارۀ ردیف شروع
To شمارۀ ردیف خاتمه
List لیستی از Object های نگهدارندۀ اطلاعات کالاها یا خدمات است. هر Object ساختار زیر را شامل می‌شود:
Code کد حسابداری کالا یا خدمات
Name نام کالا یا خدمات
Barcode بارکد کالا یا خدمات
ItemType نوع ( جدول نوع کالا/خدمات)
Unit واحد اصلی خرید و فروش
SubUnit واحد فرعی خرید و فروش
ConversionFactor ضریب تبدیل (واحد اصلی خرید و فروش به واحد فرعی)
Stock موجودی کالا
BuyPrice قیمت خرید
SellPrice قیمت فروش
PurchasesTitle عنوان در فاکتور فروش
SalesTitle عنوان در فاکتور خرید
NodeFamily مسیر دسته‌بندی
Tag فیلد متنی قابل استفاده توسط برنامه‌نویس
Description توضیحات
ProductCode کد کالا یا خدمات
Active وضعیت کالا: فعال یا غیرفعال
TaxId کد مالیاتی
TaxUnit واحد مالیاتی
ReorderPoint نقطه سفارش
LeadTime زمان انتظار
MinimumOrder حداقل سفارش
PriceList لیست قیمت
Title عنوان
Currency واحد پول
Price قیمت
Copyed 
{
	Success: true,
	ErrorCode: 0,
	ErrorMessage: "",
	Result: {
		TotalCount: 20,        
		FilteredCount: 2,      
		From: 1,               
		To: 2,                 
		List: [
            {               
			Code: '000001',
			Name: 'Galaxy J7 گوشی موبایل',
			Barcode: '345345345345',
			ItemType: 0,
			Unit: "عدد",
			SubUnit: "کارتن",
			ConversionFactor: 10.000000,
			Stock: 10,
			BuyPrice: 500000,
			SellPrice: 550000,
			PurchasesTitle: 'Samsung Galaxy J7',
			SalesTitle: 'Samsung Galaxy J7',
			NodeFamily: 'دیجیتال:موبایل:سامسونگ',
			Tag: '',
			Description: '',
			ProductCode: '5612',
			Active: true,
			TaxId: "1301234567890",
			TaxUnit: "کارتن",
            ReorderPoint: 12.000000,
            LeadTime: 3,
            MinimumOrder: 5.000000,     
			PriceList: [
                    {
                        "Title": "عمده",
                        "Currency": "IRR",
                        "Price": 520000
                    },
                    {
                        "Title": "همکار",
                        "Currency": "IRR",
                        "Price": 525000
                    },
                    {
                        "Title": "مشتری ویژه",
                        "Currency": "IRR",
                        "Price": 540000
                    }
                ]
            },
            {
			Code: '000002',
			Name: 'Galaxy S7 گوشی موبایل',
			Barcode: '8465456742345',
			ItemType: 0,
			Unit: 'عدد',
			Stock: 12,
			BuyPrice: 700000,
			SellPrice: 750000,
			PurchasesTitle: 'Samsung Galaxy S7',
			SalesTitle: 'Samsung Galaxy S7',
			NodeFamily: 'دیجیتال:موبایل:سامسونگ',
			Tag: '',
			Description: '',
			ProductCode: '5613',
			Active: true,
			TaxId: "1301234567890",
			TaxUnit: "کارتن",
            ReorderPoint: 12.000000,
            LeadTime: 3,
            MinimumOrder: 5.000000,             
			PriceList: [
                    {
                        "Title": "عمده",
                        "Currency": "IRR",
                        "Price": 520000
                    },
                    {
                        "Title": "همکار",
                        "Currency": "IRR",
                        "Price": 525000
                    },
                    {
                        "Title": "مشتری ویژه",
                        "Currency": "IRR",
                        "Price": 540000
                    }
                ]
            }
        ]
    }
}
Copyed
URL:https://api.hesabfa.com/v1/item/save

پارامترها :

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

(به یاد داشته باشید که آیتم‌های ستاره‌دار * ضروری‌اند)
code کد حسابداری کالا یا خدمات
اگر کد کالا را وارد نکنید، به‌عنوان کالای جدید ذخیره می‌شود.
اگر کد وارد شده در سیستم موجود باشد، اطلاعات آن ویرایش می‌شود.
اگر کد وارد شده موجود نباشد، کالا با آن کد ذخیره خواهد شد.
*name نام کالا
*itemType نوع ( جدول نوع کالا/خدمات )
barcode بارکد کالا/خدمات
unit واحد اصلی خرید و فروش
subUnit واحد فرعی خرید و فروش
conversionFactor ضریب تبدیل (واحد اصلی خرید و فروش به واحد فرعی)
buyPrice قیمت خرید
sellPrice قیمت فروش
purchasesTitle عنوان در فاکتور فروش
salesTitle عنوان در فاکتور خرید
tag فیلد متنی قابل استفاده توسط برنامه‌نویس
description توضیحات
productCode کد کالا یا خدمات
active وضعیت کالا: فعال یا غیرفعال
taxId کد مالیاتی
taxUnit واحد مالیاتی
reorderPoint نقطه سفارش
leadTime زمان انتظار
minimumOrder حداقل سفارش
nodeFamily دسته‌بندی کالاها: یک فیلد متنی است که با این فرمت می‌توانید دسته‌بندی کالا یا خدمات را تعریف کنید:
برای کالاها «کالاها: دستۀ ۱:، دستۀ ۲ و به همین ترتیب تا دستۀ ...»
برای خدمات «خدمات: دستۀ ۱:، دستۀ ۲ و به همین ترتیب تا دستۀ ...»
priceList لیست قیمت
title عنوان
currency واحد پول
price قیمت
Copyed 
{
	apiKey: 'asdfASR^%FDHdsfg456',
	loginToken: 'f6b912...45fdc',
	item: {                
		name: 'Galaxy J7 گوشی موبایل',
		barcode: '345345345345',
		itemType: 0,
		unit: 'عدد',
		buyPrice: 500000,
		sellPrice: 550000,
		purchasesTitle: 'Samsung Galaxy J7',
		salesTitle: 'Samsung Galaxy J7',
		tag: '',
		description: '',
		productCode: '45612',
		active: true,
		taxId: "1301234567890",
		taxUnit: "کارتن",
           reorderPoint: 12.000000,
           leadTime: 3,
           minimumOrder: 5.000000,        
		nodeFamily: 'کالاها : موبایل : سامسونگ',
		priceList: [
            {
                "title": "عمده",
                "currency": "IRR",
                "price": 520000
            },
            {
                "title": "همکار",
                "currency": "IRR",
                "price": 525000
            },
            {
                "title": "مشتری ویژه",
                "currency": "IRR",
                "price": 540000
            }
        ]
    }
}

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

Success
ErrorCode
ErrorMessage
 (مشاهدۀ توضیحات)
Result در صورت موفقیت‌آمیز بودن، Object کالای ذخیره یا ویرایش شده درون Result قرار می‌گیرد.
Code کد حسابداری کالا
Name نام کالا
ItemType نوع ( جدول نوع کالا/خدمات )
Barcode بارکد کالا/خدمات
Unit واحد اصلی خرید و فروش
SubUnit واحد فرعی خرید و فروش
ConversionFactor ضریب تبدیل (واحد اصلی خرید و فروش به واحد فرعی)
BuyPrice قیمت خرید
SellPrice قیمت فروش
PurchasesTitle عنوان در فاکتور فروش
SalesTitle عنوان در فاکتور خرید
Tag فیلد متنی قابل استفاده توسط برنامه‌نویس
Description توضیحات
ProductCode کد کالا
Active وضعیت کالا: فعال یا غیرفعال
TaxId کد مالیاتی
TaxUnit واحد مالیاتی
ReorderPoint نقطه سفارش
LeadTime زمان انتظار
MinimumOrder حداقل سفارش
NodeFamily دسته‌بندی کالا: یک فیلد متنی که به فرمت زیر می باشد.
برای کالا: "کالاها: دسته 1: دسته 2: ..."
برای خدمات: "خدمات: دسته 1: دسته 2: ..."
Title عنوان
Currency واحد پول
Price قیمت
Copyed 
{
     Success: true,
     ErrorCode: 0,
     ErrorMessage: "",
     Result: {
        "Code": "000001",
        "Name": "Galaxy J7 گوشی موبایل",
        "Barcode": "345345345345",
        "ItemType": 0,
        "Unit": "عدد",
        "SubUnit": "کارتن",
        "ConversionFactor": 10.000000,
        "Stock": 10,
        "BuyPrice": 500000,
        "SellPrice": 550000,
        "PurchasesTitle": "Samsung Galaxy J7",
        "SalesTitle": "Samsung Galaxy J7",
        "NodeFamily": "دیجیتال:موبایل:سامسونگ",
        "Tag": "",
        "Description": "",
        "ProductCode": "745921",
        "Active": true,
        "TaxId": "1301234567890",
        "TaxUnit": "کارتن",
        "ReorderPoint": 12.000000,
        "LeadTime": 3,
        "MinimumOrder": 5.000000,
        "PriceList": [
            {
                "Title": "عمده",
                "Currency": "IRR",
                "Price": 520000
            },
            {
                "Title": "همکار",
                "Currency": "IRR",
                "Price": 525000
            },
            {
                "Title": "مشتری ویژه",
                "Currency": "IRR",
                "Price": 540000
            }
        ]
    }
}
Copyed
URL: https://api.hesabfa.com/v1/item/batchSave

پارامترها :

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

(به یاد داشته باشید که آیتم‌های ستاره‌دار * ضروری‌اند)
code کد حسابداری کالا یا خدمات
اگر کد کالا را وارد نکنید، به‌عنوان کالای جدید ذخیره می‌شود.
اگر کد وارد شده در سیستم موجود باشد، اطلاعات آن ویرایش می‌شود.
اگر کد وارد شده موجود نباشد، کالا با آن کد ذخیره خواهد شد.
*name نام کالا
*itemType نوع ( جدول نوع کالا/خدمات )
barcode بارکد کالا/خدمات
unit واحد اصلی خرید و فروش
subUnit واحد فرعی خرید و فروش
conversionFactor ضریب تبدیل(واحد اصلی خرید و فروش به واحد فرعی)
buyPrice قیمت خرید
sellPrice قیمت فروش
purchasesTitle عنوان در فاکتور فروش
salesTitle عنوان در فاکتور خرید
tag فیلد متنی قابل استفاده توسط برنامه‌نویس
description توضیحات
productCode کد کالا یا خدمات
active وضعیت کالا: فعال یا غیرفعال
taxId کد مالیاتی
taxUnit واحد مالیاتی
reorderPoint نقطه سفارش
leadTime زمان انتظار
minimumOrder حداقل سفارش
nodeFamily دسته‌بندی کالاها: یک فیلد متنی است که با این فرمت می‌توانید دسته‌بندی کالا یا خدمات را تعریف کنید:
برای کالاها «کالاها: دستۀ ۱:، دستۀ ۲ و به همین ترتیب تا دستۀ ...»
برای خدمات «خدمات: دستۀ ۱:، دستۀ ۲ و به همین ترتیب تا دستۀ ...»
priceList قیمت پیش‌فرض
title عنوان
currency واحد پول
price قیمت
Copyed 
{
	apiKey: 'asdfASR^%FDHdsfg456',
	loginToken: 'f6b912...45fdc',
	items: [
        {                
		code: '000001',
		name: 'Galaxy J7 گوشی موبایل',
		barcode: '345345345345',
		itemType: 0,
		unit: 'عدد',
		buyPrice: 500000,
		sellPrice: 550000,
		purchasesTitle: 'Samsung Galaxy J7',
		salesTitle: 'Samsung Galaxy J7',
		tag: '',
		description: '',
		productCode: '75134',
		active: '',
		taxId: "1301234567890",
		taxUnit: "کارتن",
        reorderPoint: 12.000000,
        leadTime: 3,
        minimumOrder: 5.000000        
		nodeFamily: 'کالاها : موبایل : سامسونگ'
        },
        {
		name: 'Galaxy S7 گوشی موبایل',
		itemType: 0,
        }
    ]
}

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

Success
ErrorCode
ErrorMessage
 (مشاهدۀ توضیحات)
Result در صورت موفقیت آمیز بودن، آرایه‌ای از کالاهای ذخیره شده یا ویرایش شده درون Result قرار می گیرد.
Code کد حسابداری کالا
Name نام کالا
ItemType نوع ( جدول نوع کالا/خدمات )
Barcode بارکد کالا/خدمات
Unit واحد اصلی خرید و فروش
SubUnit واحد فرعی خرید و فروش
ConversionFactor ضریب تبدیل(واحد اصلی خرید و فروش به واحد فرعی)
BuyPrice قیمت خرید
SellPrice قیمت فروش
PurchasesTitle عنوان در فاکتور فروش
SalesTitle عنوان در فاکتور خرید
Tag فیلد متنی قابل استفاده توسط برنامه‌نویس
Description توضیحات
ProductCode کد کالا یا خدمات
Active وضعیت کالا: فعال یا غیرفعال
TaxId کد مالیاتی
TaxUnit واحد مالیاتی
ReorderPoint نقطه سفارش
LeadTime زمان انتظار
MinimumOrder حداقل سفارش
NodeFamily دسته‌بندی کالا: یک فیلد متنی که به فرمت زیر می باشد.
برای کالا: "کالاها: دسته 1: دسته 2: ..."
برای خدمات: "خدمات: دسته 1: دسته 2: ..."
PriceList قیمت پیش‌فرض
Title عنوان
Currency واحد پول
Price قیمت
Copyed 
{
     Success: true,
     ErrorCode: 0,
     ErrorMessage: "",
     Result: [{    
			Code: '000001',
			Name: 'Galaxy J7 گوشی موبایل',
			Barcode: '345345345345',
			ItemType: 0,
			Unit: 'عدد',
			Stock: 10,
			BuyPrice: 500000,
			SellPrice: 550000,
			PurchasesTitle: 'Samsung Galaxy J7',
			SalesTitle: 'Samsung Galaxy J7',
			NodeFamily: 'دیجیتال/موبایل/سامسونگ',
			Tag: '',
			Description: '',
			ProductCode: '75134',
			Active: true,
  		    TaxId: "1301234567890",
			TaxUnit: "کارتن",
            ReorderPoint: 12.000000,
            LeadTime: 3,
            MinimumOrder: 5.000000
		},{
			Code: '000002',
			Name: 'Galaxy S7 گوشی موبایل',
			Barcode: '',
			ItemType: 0,
			Unit: '',
			Stock: 0,
			BuyPrice: 0,
			SellPrice: 0,
			PurchasesTitle: '',
			SalesTitle: '',
			NodeFamily: '',
			Tag: '',
			Description: '',
			ProductCode: '',
			Active: true,
			TaxId: "1301234567890",
			TaxUnit: "کارتن",
            ReorderPoint: 12.000000,
            LeadTime: 3,
            MinimumOrder: 5.000000
		}]
	}
 }
Copyed
URL: https://api.hesabfa.com/v1/item/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/item/GetQuantity

پارامترها :

apiKey
userId
password
loginToken 		پارامترهای اجباری برای تمامی متدها
(مشاهدۀ توضیحات)
warehouseCode کد انبار (اختیاری)
codes کد کالاها (اختیاری)
Copyed 
{
     apiKey: 'asdfASR^%FDHdsfg456',
     userId: 'mail@example.com',
     password: '123456',
     loginToken: 'f6b912...45fdc',
     warehouseCode: 12,			
     codes: ['000005','6','7']	       
 }
نکته‌های ضروری:
  1. اگر پارامتر warehouseCode وجود داشته و سیستم انبارداری نیز فعال باشد، موجودی و کالاهای ثبت شده در همان انبار فرستاده خواهد شد. اگر پارامتر warehouseCode وجود ندارد یا سیستم انبارداری فعال نباشد، کل کالاها و موجودی کلی کالاها ارسال می‌شود.
  2. اگر پارامترcodes وجود داشته باشد، فقط کالاهای دارای کد در آرایۀ codes، فرستاده خواهند شد. اگر پارامتر codes موجود نباشد، تمامی کالاها ارسال می‌شوند.

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

Success
ErrorCode
ErrorMessage
 (مشاهدۀ توضیحات)
Result در صورت موفقیت‌آمیز بودن، مقدار true درون Result قرار می‌گیرد.
Code کد حسابداری کالا
Tag فیلد متنی قابل استفاده توسط برنامه‌نویس
Quantity تعداد
Barcode بارکد کالا/خدمات
SellPrice قیمت فروش
ProductCode کد کالا/ خدمات
LastPurchaseCost آخرین قیمت خرید
LastVendor آخرین تأمین کننده
Code کد تأمین کننده
DisplayName نام تأمین کننده
Copyed 
{
	Success: true,
	ErrorCode: 0,
	ErrorMessage: "",
	Result: [
        {
            "Code": "000001",
            "Tag": "115",
            "Quantity": 0.000000,
            "Barcode": "650077842",
            "SellPrice": 1570000.000,
            "ProductCode": "PCS-873300",
            "LastPurchaseCost": 1220000.000,
            "LastVendor": {
                "Id": 1,
                "Code": "000251",
                "DisplayName": "شرکت آرمان شبکه"
            }
        },
        {
            "Code": "000002",
            "Tag": "230",
            "Quantity": 16.000000,
            "Barcode": "89504564",
            "SellPrice": 275000.0000,
            "ProductCode": "PCS-873301",
            "LastPurchaseCost": 1220000.000,
            "LastVendor": {
                "Id": 1,
                "Code": "000251",
                "DisplayName": "شرکت آرمان شبکه"
            }
        },
        {…},
        {…}
    ]
}
Copyed
URL:https://api.hesabfa.com/v1/item/GetQuantity2

پارامترها :

apiKey
userId
password
loginToken 		پارامترهای اجباری برای تمامی متدها
(مشاهدۀ توضیحات)
codes آرایه‌ای از کد کالاها
Copyed 
{
	"apiKey": "...",
	"loginToken": "...",
	"codes": ["000005", "000006"]
}
نکته‌های ضروری:
  1. اگر سیستم انبارداری فعال است، موجودی کل و موجودی در تمام انبارها فرستاده می‌شود. اگر سیستم انبارداری فیرفعال باشد، فقط موجودی کلی کالاها فرستاده خواهد شد.
  2. اگر پارامترcodes وجود داشته باشد، فقط کالاهای دارای کد در آرایۀ codes ارسال می‌شوند. اگر پارامتر codes نباشد، تمام کالاها فرستاده خواهد شد.

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

Success
ErrorCode
ErrorMessage
 (مشاهدۀ توضیحات)
Result در صورت موفقیت‌آمیز بودن، مقدار true درون Result قرار می‌گیرد.
Code کد حسابداری کالا
Tag فیلد متنی قابل استفاده توسط برنامه‌نویس
Quantity تعداد در سیستم حسابداری
Barcode بارکد کالا/خدمات
SellPrice قیمت فروش
ProductCode کد کالا/خدمات
LastPurchaseCost آخرین قیمت خرید
LastVendor آخرین تأمین کننده
Code کد تأمین کننده
DisplayName نام تأمین کننده
Warehouse آرایه‌ای از موجودی کالاها در تمام انبارها
Code کد انبار
Quantity موجودی در انبار
Copyed 
{
    "Success": true,
    "ErrorCode": 0,
    "ErrorMessage": "",
    "Result": [
        {
            "Code": "000005",
            "Tag": "",
            "Quantity": 5.000000,
            "ProductCode": "4980",
            "LastPurchaseCost": 1220000.000,
            "LastVendor": {
                "Id": 1,
                "Code": "000251",
                "DisplayName": "شرکت آرمان شبکه"
            }
        },
        "Barcode": "504056",
        "SellPrice": 133900.0000,
        "Warehouse": [
            {
                "Code": 11,
                "Quantity": -1.000000
            },
            {
                "Code": 12,
                "Quantity": 7.000000
            }
        ]
    },
    {
        "Code": "000006",
        "Tag": "",
        "Quantity": 1.000000,
        "ProductCode": "16936",
        "LastPurchaseCost": 1220000.000,
        "LastVendor": {
            "Id": 1,
            "Code": "000251",
            "DisplayName": "شرکت آرمان شبکه"
        }
    },
    "Barcode": "6260136100720",
    "SellPrice": 597500.0000,
    "Warehouse": [
        {
            "Code": 11,
            "Quantity": 5.000000
        },
        {
            "Code": 12,
            "Quantity": -1.000000
        }
    ]
}
]
}
Copyed
URL:https://api.hesabfa.com/v1/item/UpdateOpeningQuantity

پارامترها :

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

(به یاد داشته باشید که آیتم‌های ستاره‌دار * ضروری‌اند)

*code کد کالا
*quantity تعداد (باید بزرگتر از صفر باشد)
*unitPrice مبلغ واحد (باید بزرگتر از صفر باشد)
warehouseCode کد انبار
Copyed 
{
     apiKey: 'asdfASR^%FDHdsfg456',
     userId: 'mail@example.com',
     password: '123456'
     items: [{
		code: "000001",
		quantity: 3,
		unitPrice: 250000,
		warehouseCode: 12
	}, {
		code: "000002",
		quantity: 5,
		unitPrice: 378000
	}]
 }
نکته‌های ضروری:
  1. موجودی اول دورۀ کالاها با فراخوانی این متد در تراز افتتاحیه ثبت می‌شود. سند افتتاحیه نیز به تناسب اطلاعات ویرایش خواهد شد. پیش از فراخوانی این متد مطمئن شوید که سهامداران در سیستم حسابفا تعریف شده‌اند.
  2. انجام این عمل تنها در اولین سال مالی ممکن است.
  3. فقط موجودی کالاهای ارسال شده به‌روز رسانی می‌شوند و موجودی کالاهای دیگری که اکنون در تراز افتتاحیه ثبت شده‌اند، تغییر نخواهند کرد.
  4. تعداد و قیمت واحد باید بزرگتر از صفر باشد، وگرنه ثبت نمی‌شوند.
  5. توجه داشته باشید که این متد فقط در شروع سال مالی فراخوانی شود. اگر چنین فراخوانی را در میانۀ سال مالی انجام دهید، در موجودی سیستم اختلال ایجاد خواهد کرد.

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

Success
ErrorCode
ErrorMessage
 (مشاهدۀ توضیحات)
Result در صورت موفقیت‌آمیز بودن، مقدار true درون Result قرار می‌گیرد.
Copyed 
{
	Success: true,
	ErrorCode: 0,
	ErrorMessage: "",
	Result: null
}