2023-01-01 00:00:00 persion مستندات راهنمای حسابفا واسط API ،متدهای دریافت کالاها و خدمات، ذخیره، حذف، لیست موجودی اول دوره، به روز رسانی موجودی اول دوره کالاها https://www.hesabfa.com/img/hesabfa-logo.png https://www.hesabfa.com/help/api/item متدهای API کالاها و خدمات در نرم افزار حسابداری آنلاین حسابفا

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


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 واحد مالیاتی
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": "کارتن",
		      "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 واحد مالیاتی
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: '3753',
                Active: true,
		     TaxId: "1301234567890",
		     TaxUnit: "کارتن",
		     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 کد کالا یا خدمات
Active وضعیت کالا: فعال یا غیرفعال
TaxId کد مالیاتی
TaxUnit واحد مالیاتی
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: '735315',
                Active: true,
		     TaxId: "1301234567890",
		     TaxUnit: "کارتن",
		     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 واحد مالیاتی
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: "کارتن",
			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: "کارتن",
			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 واحد مالیاتی
nodeFamily دسته بندی کالا: یک فیلد متنی که به فرمت زیر می توان دسته بندی کالا یا خدمات را در آن تعریف کرد.
برای کالا: "کالاها: دسته 1: دسته 2: ..."
برای خدمات: "خدمات: دسته 1: دسته 2: ..."
priceList لیست قیمت
title عنوان
currency واحد پول
price قیمت
Copyed
{
	apiKey: 'asdfASR^%FDHdsfg456',
	userId: 'mail@example.com',
	password: '123456',
	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: "کارتن",
		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 واحد مالیاتی
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: 'عدد',
		Stock: 10,
		BuyPrice: 500000,
		SellPrice: 550000,
		PurchasesTitle: 'Samsung Galaxy J7',
		SalesTitle: 'Samsung Galaxy J7',
		Tag: '',
		Description: '',
		ProductCode: '45812',
		Active: true,
		TaxId: "1301234567890",
		TaxUnit: "کارتن",
		NodeFamily: 'کالاها : موبایل : سامسونگ',
		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 واحد مالیاتی
nodeFamily دسته بندی کالا: یک فیلد متنی که به فرمت زیر می توان دسته بندی کالا یا خدمات را در آن تعریف کرد.
برای کالا: "کالاها: دسته 1: دسته 2: ..."
برای خدمات: "خدمات: دسته 1: دسته 2: ..."
priceList قیمت پیش فرض
title عنوان
currency واحد پول
price قیمت
Copyed
{
	apiKey: 'asdfASR^%FDHdsfg456',
	userId: 'mail@example.com',
	password: '123456',
	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: "کارتن",
		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 واحد مالیاتی
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: "کارتن"
		},{
			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: "کارتن"
		}]
	}
 } 
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 کد کالا یا خدمات
Copyed
{
	Success: true,
	ErrorCode: 0,
	ErrorMessage: "",
	Result: 
	[
		   {
		       "Code": "000001",
		       "Tag": "115",
		       "Quantity": 0.000000,
		       "Barcode": "650077842",
		       "SellPrice": 1570000.000,
		       "ProductCode": "PCS-873300"
		   },
		   {
		       "Code": "000002",
		       "Tag": "230",
		       "Quantity": 16.000000,
		       "Barcode": "89504564",
		       "SellPrice": 275000.0000,
		       "ProductCode": "PCS-873301"
		   },
		   {
		       "Code": "000003",
		       "Tag": "227",
		       "Quantity": 2.000000,
		       "Barcode": "78900877",
		       "SellPrice": 442500.0000,
		       "ProductCode": "PCS-873302"
		   },
		   {
		       "Code": "000004",
		       "Tag": "112",
		       "Quantity": 30.000000,
		       "Barcode": "87554698",
		       "SellPrice": 3789200.0000,
		       "ProductCode": "PCS-873303"
		   },
		   {…},
		   {…}
	]
} 
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 کد کالا یا خدمات
Warehouse آرایه ای از موجودی کالا در تمامی انبارها
Code کد انبار
Quantity موجودی در انبار
Copyed
{
	"Success": true,
	"ErrorCode": 0,
	"ErrorMessage": "",
	"Result": [
		{
			"Code": "000005",
			"Tag": "",
			"Quantity": 5.000000,
			"ProductCode": "4980",
			"Barcode": "504056",
			"SellPrice": 133900.0000,
			"Warehouse": [
				{
					"Code": 11,
					"Quantity": -1.000000
				},
				{
					"Code": 12,
					"Quantity": 7.000000
				}
			]
		},
		{
			"Code": "000006",
			"Tag": "",
			"Quantity": 1.000000,
			"ProductCode": "16936",
			"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
}