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

دریافت

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

Request
Response

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

apiKey
userId
password
loginToken پارامتر های اجباری برای تمامی متد ها
(مشاهده توضیحات)

code	کد حسابداری کالای مورد نظر

{
     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	قیمت

{
     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
				}
			]
            }
 }

دریافت از طریق بارکد

URL:https://api.hesabfa.com/v1/item/getByBarcode

Request
Response

پارامترها :

apiKey
userId
password
loginToken پارامتر های اجباری برای تمامی متد ها
(مشاهده توضیحات)

barcode بارکد کالای مورد نظر

{
     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	قیمت

مثال:

{
     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
				}
			]		
            }
 }

دریافت از طریق Id

URL:https://api.hesabfa.com/v1/item/getById

Request
Response

پارامترها :

apiKey
userId
password
loginToken پارامتر های اجباری برای تمامی متد ها
(مشاهده توضیحات)

idList id کالا یا کالاهای مورد نظر

{
     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	قیمت

{
     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
				}
			]	
            }
 }

دریافت لیست

URL:https://api.hesabfa.com/v1/item/getitems

Request
Response

پارامترها :

apiKey
userId
password
loginToken پارامتر های اجباری برای تمامی متد ها
(مشاهده توضیحات)

queryInfo Object فیلتر و مرتب سازی (مشاهده توضیحات)

{
	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	قیمت

{
	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
				}
			]	

		}]
	}
}

ذخیره

URL:https://api.hesabfa.com/v1/item/save

Request
Response

پارامترها :

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	قیمت

{
	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	قیمت

{
     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
				}
			]	

	}
 }

ذخیره گروهی

URL: https://api.hesabfa.com/v1/item/batchsave

Request
Response

پارامترها :

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	قیمت

{
	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	قیمت

{
     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: "کارتن"
		}]
	}
 }

حذف

URL: https://api.hesabfa.com/v1/item/delete

Request
Response

پارامترها :

apiKey
userId
password
loginToken پارامتر های اجباری برای تمامی متد ها
(مشاهده توضیحات)

code	کد حسابداری کالای مورد نظر

{
     apiKey: 'asdfASR^%FDHdsfg456',
     userId: 'mail@example.com',
     password: '123456',
     loginToken: 'f6b912...45fdc',
     code: '00001'
 }

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

Success
ErrorCode
ErrorMessage (مشاهده توضیحات)

Result در صورت موفقیت آمیز بودن مقدار true درون Result قرار می گیرد.

{
	Success: true,
	ErrorCode: 0,
	ErrorMessage: "",
	Result: true
}

لیست موجودی کالاها

URL:https://api.hesabfa.com/v1/item/GetQuantity

Request
Response

پارامترها :

apiKey
userId
password
loginToken پارامتر های اجباری برای تمامی متد ها
(مشاهده توضیحات)

warehouseCode	کد انبار (اختیاری)
codes	کد کالاها (اختیاری)

{
     apiKey: 'asdfASR^%FDHdsfg456',
     userId: 'mail@example.com',
     password: '123456',
     loginToken: 'f6b912...45fdc',
     warehouseCode: 12,			
     codes: ['000005','6','7']	       
 }

نکات ضروری

در صورتی که پارامتر warehouseCode وجود داشته باشد و سیستم انبارداری هم فعال باشد، موجودی و کالاهای ثبت شده در انبار ذکر شده ارسال خواهد شد. در صورت عدم وجود پارامتر warehouseCode یا عدم فعال بودن سیستم انبارداری، کل کالاها و موجودی کلی کالا ارسال خواهد شد.
در صورتی که پارامتر codes وجود داشته باشد، فقط کالاهایی که کد آنها در آرایه codes وجود داشته باشند، ارسال خوهند شد. در صورت عدم وجود پارامتر codes کلیه کالاها ارسال خواهند شد.

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

Success
ErrorCode
ErrorMessage (مشاهده توضیحات)

Result در صورت موفقیت آمیز بودن مقدار true درون Result قرار می گیرد.

Code	کد حسابداری کالا
Tag	فیلد متنی قابل استفاده توسط برنامه نویس
Quantity	تعداد
Barcode	بارکد کالا/خدمات
SellPrice	قیمت فروش
ProductCode	کد کالا یا خدمات

{
	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"
		   },
		   {…},
		   {…}
	]
}

لیست موجودی کالاها ۲

URL:https://api.hesabfa.com/v1/item/GetQuantity2

Request
Response

پارامترها :

apiKey
userId
password
loginToken پارامتر های اجباری برای تمامی متد ها
(مشاهده توضیحات)

codes آرایه ای از کد کالاها

{
	"apiKey": "...",
	"loginToken": "...",
	"codes": ["000005", "000006"]
}

نکات ضروری

در صورتی که سیستم انبارداری فعال باشد، موجودی کل و موجودی در تمامی انبارها ارسال خواهد شد. در صورت عدم فعال بودن سیستم انبارداری، فقط موجودی کلی کالا ارسال خواهد شد.
در صورتی که پارامتر codes وجود داشته باشد، فقط کالاهایی که کد آنها در آرایه codes وجود داشته باشند، ارسال خوهند شد. در صورت عدم وجود پارامتر codes کلیه کالاها ارسال خواهند شد.

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

Success
ErrorCode
ErrorMessage (مشاهده توضیحات)

Result در صورت موفقیت آمیز بودن مقدار true درون Result قرار می گیرد.

Code	کد حسابداری کالا
Tag	فیلد متنی قابل استفاده توسط برنامه نویس
Quantity	تعداد در سیستم حسابداری
Barcode	بارکد کالا/خدمات
SellPrice	قیمت فروش
ProductCode	کد کالا یا خدمات
Warehouse	آرایه ای از موجودی کالا در تمامی انبارها

Code	کد انبار
Quantity	موجودی در انبار

{
	"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
				}
			]
		}
	]
}

به روز رسانی موجودی اول دوره کالاها

URL:https://api.hesabfa.com/v1/item/UpdateOpeningQuantity

Request
Response

پارامترها :

apiKey
userId
password
loginToken پارامتر های اجباری برای تمامی متد ها
(مشاهده توضیحات)

items

لیستی از Objectهای نگهدارنده اطلاعات کالاها می باشد.هر Object شامل ساختار زیر می باشد:

* آیتم های ستاره دار ضروری هستند.

*code	کد کالا
*quantity	تعداد (باید بزرگتر از صفر باشد)
*unitPrice	مبلغ واحد (باید بزرگتر از صفر باشد)
warehouseCode	کد انبار

{
     apiKey: 'asdfASR^%FDHdsfg456',
     userId: 'mail@example.com',
     password: '123456'
     items: [{
		code: "000001",
		quantity: 3,
		unitPrice: 250000,
		warehouseCode: 12
	}, {
		code: "000002",
		quantity: 5,
		unitPrice: 378000
	}]
 }

نکات ضروری

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

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

Success
ErrorCode
ErrorMessage (مشاهده توضیحات)

Result در صورت موفقیت آمیز بودن مقدار true درون Result قرار می گیرد.

{
	Success: true,
	ErrorCode: 0,
	ErrorMessage: "",
	Result: null
}

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

دریافت

دریافت از طریق بارکد

دریافت از طریق Id

دریافت لیست

ذخیره

ذخیره گروهی

حذف

لیست موجودی کالاها

لیست موجودی کالاها ۲

به روز رسانی موجودی اول دوره کالاها