متدهای کالاها و خدمات در مستندات رابط برنامهنویسی حسابفا
پارامترهای اجباری:
|
apiKey userId password loginToken |
پارامترهای اجباری برای تمامی متدها
(مشاهدۀ توضیحات) |
| code | کد حسابداری کالای مورد نظر |
curl -X POST https://api.hesabfa.com/v1/item/get \
-H "Content-Type: application/json" \
-d '{
"apiKey": "your-api-key",
"loginToken": "your-login-token",
"code": "000001"
}'
<?php
$data = [
'apiKey' => 'your-api-key',
'loginToken' => 'your-login-token',
'code' => '000001'
];
$ch = curl_init("https://api.hesabfa.com/v1/item/get");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$result = json_decode($response, true);
const data = {
apiKey: "your-api-key",
loginToken: "your-login-token",
code: "000001"
};
fetch("https://api.hesabfa.com/v1/item/get", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify(data)
})
.then(response => response.json())
.then(result => {
console.log(result);
});
import requests
data = {
"apiKey": "your-api-key",
"loginToken": "your-login-token",
"code": "000001"
}
response = requests.post(
"https://api.hesabfa.com/v1/item/get",
json=data
)
result = response.json()
print(result)
using System.Net.Http.Json;
using var client = new HttpClient();
var data = new
{
apiKey = "your-api-key",
loginToken = "your-login-token",
code = "000001"
};
var response = await client.PostAsJsonAsync("https://api.hesabfa.com/v1/item/get", data);
var result = await response.Content.ReadAsStringAsync();
Console.WriteLine(result);
آیتمهای موجود در پاسخ:
|
Success ErrorCode ErrorMessage |
(مشاهدۀ توضیحات) |
| Result | Object اطلاعات کالا یا خدمت، با ساختار زیر: |
| Id | شناسه کالا یا خدمات (برای سرویس دریافت با ID) |
| Code | کد حسابداری کالا یا خدمات |
| Name | نام کالا یا خدمات |
| ItemType | نوع ( جدول نوع کالا/خدمات) |
| Unit | واحد اصلی خرید و فروش |
| SubUnit | واحد فرعی خرید و فروش |
| ConversionFactor | ضریب تبدیل (واحد اصلی خرید و فروش به واحد فرعی) |
| Barcode | بارکد کالا یا خدمات |
| Stock | موجودی کالا |
| BuyPrice | قیمت خرید |
| SellPrice | قیمت فروش |
| PurchasesTitle | عنوان در فاکتور فروش |
| SalesTitle | عنوان در فاکتور خرید |
| NodeId | شناسه دستهبندی |
| NodeName | نام دستهبندی (آخرین بخش NodeFamily) |
| NodeFamily | مسیر دستهبندی |
| Tag | فیلد متنی قابل استفاده توسط برنامهنویس |
| Description | توضیحات |
| ProductCode | کد کالا یا خدمات |
| Active | وضعیت کالا: فعال یا غیرفعال |
| SalesTaxable | مشمول مالیات فروش (true یا false) |
| PurchaseTaxable | مشمول مالیات خرید (true یا false) |
| TaxType | نوع مالیات ( جدول نوع مالیات کالا) |
| TaxId | کد مالیاتی |
| TaxUnit | واحد مالیاتی |
| ReorderPoint | نقطه سفارش مجدد |
| LeadTime | زمان تحویل (روز) |
| MinimumOrder | حداقل سفارش |
| PriceList | لیست قیمت |
| Title | عنوان |
| Currency | واحد پول |
| Price | قیمت |
{
"Success": true,
"ErrorCode": 0,
"ErrorMessage": "",
"Result": {
"Id": 79641,
"Code": "000001",
"Name": "Galaxy J7 گوشی موبایل",
"ItemType": 0,
"Unit": "عدد",
"SubUnit": "کارتن",
"ConversionFactor": 10,
"Barcode": "345345345345",
"Stock": 10,
"BuyPrice": 500000,
"SellPrice": 550000,
"PurchasesTitle": "Samsung Galaxy J7",
"SalesTitle": "Samsung Galaxy J7",
"NodeId": 43,
"NodeName": "سامسونگ",
"NodeFamily": "دیجیتال:موبایل:سامسونگ",
"Tag": "",
"Description": "",
"ProductCode": "745921",
"Active": true,
"SalesTaxable": true,
"PurchaseTaxable": true,
"TaxType": 3,
"TaxId": "1301234567890",
"TaxUnit": "کارتن",
"ReorderPoint": 0,
"LeadTime": 0,
"MinimumOrder": 0,
"PriceList": [
{
"Title": "عمده",
"Currency": "IRR",
"Price": 520000
},
{
"Title": "همکار",
"Currency": "IRR",
"Price": 525000
},
{
"Title": "مشتری ویژه",
"Currency": "IRR",
"Price": 540000
}
]
}
}
پارامترها :
|
apiKey userId password loginToken |
پارامترهای اجباری برای تمامی متدها
(مشاهدۀ توضیحات) |
| barcode | بارکد کالای مورد نظر |
curl -X POST https://api.hesabfa.com/v1/item/getByBarcode \
-H "Content-Type: application/json" \
-d '{
"apiKey": "your-api-key",
"loginToken": "your-login-token",
"barcode": "345345345345"
}'
<?php
$data = [
'apiKey' => 'your-api-key',
'loginToken' => 'your-login-token',
'barcode' => '345345345345'
];
$ch = curl_init("https://api.hesabfa.com/v1/item/getByBarcode");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$result = json_decode($response, true);
const data = {
apiKey: "your-api-key",
loginToken: "your-login-token",
barcode: "345345345345"
};
fetch("https://api.hesabfa.com/v1/item/getByBarcode", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify(data)
})
.then(response => response.json())
.then(result => {
console.log(result);
});
import requests
data = {
"apiKey": "your-api-key",
"loginToken": "your-login-token",
"barcode": "345345345345"
}
response = requests.post(
"https://api.hesabfa.com/v1/item/getByBarcode",
json=data
)
result = response.json()
print(result)
using System.Net.Http.Json;
using var client = new HttpClient();
var data = new
{
apiKey = "your-api-key",
loginToken = "your-login-token",
barcode = "345345345345"
};
var response = await client.PostAsJsonAsync("https://api.hesabfa.com/v1/item/getByBarcode", data);
var result = await response.Content.ReadAsStringAsync();
Console.WriteLine(result);
آیتمهای موجود در پاسخ:
|
Success ErrorCode ErrorMessage |
(مشاهدۀ توضیحات) |
| Result | Object اطلاعات کالا یا خدمت، با ساختار زیر: |
| Id | شناسه کالا یا خدمات (برای سرویس دریافت با ID) |
| Code | کد حسابداری کالا یا خدمات |
| Name | نام کالا یا خدمات |
| ItemType | نوع ( جدول نوع کالا/خدمات) |
| Unit | واحد اصلی خرید و فروش |
| SubUnit | واحد فرعی خرید و فروش |
| ConversionFactor | ضریب تبدیل(واحد اصلی خرید و فروش به واحد فرعی) |
| Barcode | بارکد کالا یا خدمات |
| Stock | موجودی |
| BuyPrice | قیمت خرید |
| SellPrice | قیمت فروش |
| PurchasesTitle | عنوان در فاکتور فروش |
| SalesTitle | عنوان در فاکتور خرید |
| NodeId | شناسه دستهبندی |
| NodeName | نام دستهبندی (آخرین بخش NodeFamily) |
| NodeFamily | مسیر دستهبندی |
| Tag | فیلد متنی قابل استفاده توسط برنامهنویس |
| Description | توضیحات |
| ProductCode | کد کالا یا خدمات |
| Active | وضعیت کالا: فعال یا غیرفعال |
| SalesTaxable | مشمول مالیات فروش (true یا false) |
| PurchaseTaxable | مشمول مالیات خرید (true یا false) |
| TaxType | نوع مالیات ( جدول نوع مالیات کالا) |
| TaxId | کد مالیاتی |
| TaxUnit | واحد مالیاتی |
| ReorderPoint | نقطه سفارش مجدد |
| LeadTime | زمان تحویل (روز) |
| MinimumOrder | حداقل سفارش |
| PriceList | لیست قیمت |
| Title | عنوان |
| Currency | واحد پول |
| Price | قیمت |
مثال:
{
"Success": true,
"ErrorCode": 0,
"ErrorMessage": "",
"Result": {
"Id": 79641,
"Code": "000001",
"Name": "Galaxy J7 گوشی موبایل",
"ItemType": 0,
"Unit": "عدد",
"SubUnit": "کارتن",
"ConversionFactor": 10,
"Barcode": "345345345345",
"Stock": 10,
"BuyPrice": 500000,
"SellPrice": 550000,
"PurchasesTitle": "Samsung Galaxy J7",
"SalesTitle": "Samsung Galaxy J7",
"NodeId": 43,
"NodeName": "سامسونگ",
"NodeFamily": "دیجیتال:موبایل:سامسونگ",
"Tag": "",
"Description": "",
"ProductCode": "745921",
"Active": true,
"SalesTaxable": true,
"PurchaseTaxable": true,
"TaxType": 3,
"TaxId": "1301234567890",
"TaxUnit": "کارتن",
"ReorderPoint": 0,
"LeadTime": 0,
"MinimumOrder": 0,
"PriceList": [
{
"Title": "عمده",
"Currency": "IRR",
"Price": 520000
},
{
"Title": "همکار",
"Currency": "IRR",
"Price": 525000
},
{
"Title": "مشتری ویژه",
"Currency": "IRR",
"Price": 540000
}
]
}
}
پارامترها :
|
apiKey userId password loginToken |
پارامترهای اجباری برای تمامی متدها
(مشاهدۀ توضیحات) |
| idList | آرایهای از id کالاها و خدمات |
curl -X POST https://api.hesabfa.com/v1/item/getById \
-H "Content-Type: application/json" \
-d '{
"apiKey": "your-api-key",
"loginToken": "your-login-token",
"idList": [
1,
2,
3
]
}'
<?php
$data = [
'apiKey' => 'your-api-key',
'loginToken' => 'your-login-token',
'idList' => [
1,
2,
3
]
];
$ch = curl_init("https://api.hesabfa.com/v1/item/getById");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$result = json_decode($response, true);
const data = {
apiKey: "your-api-key",
loginToken: "your-login-token",
idList: [
1,
2,
3
]
};
fetch("https://api.hesabfa.com/v1/item/getById", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify(data)
})
.then(response => response.json())
.then(result => {
console.log(result);
});
import requests
data = {
"apiKey": "your-api-key",
"loginToken": "your-login-token",
"idList": [
1,
2,
3
]
}
response = requests.post(
"https://api.hesabfa.com/v1/item/getById",
json=data
)
result = response.json()
print(result)
using System.Net.Http.Json;
using var client = new HttpClient();
var data = new
{
apiKey = "your-api-key",
loginToken = "your-login-token",
idList = new object[]
{
1,
2,
3
}
};
var response = await client.PostAsJsonAsync("https://api.hesabfa.com/v1/item/getById", data);
var result = await response.Content.ReadAsStringAsync();
Console.WriteLine(result);
آیتمهای موجود در پاسخ:
|
Success ErrorCode ErrorMessage |
(مشاهدۀ توضیحات) |
| Result | Object اطلاعات کالا یا خدمت، با ساختار زیر: |
| Id | شناسه کالا یا خدمات (برای سرویس دریافت با ID) |
| Code | کد حسابداری کالا یا خدمات |
| Name | نام کالا یا خدمات |
| ItemType | نوع ( جدول نوع کالا/خدمات) |
| Unit | واحد اصلی خرید و فروش |
| SubUnit | واحد فرعی خرید و فروش |
| ConversionFactor | ضریب تبدیل (واحد اصلی خرید و فروش به واحد فرعی) |
| Barcode | بارکد کالا یا خدمات |
| Stock | موجودی کالا |
| BuyPrice | قیمت خرید |
| SellPrice | قیمت فروش |
| PurchasesTitle | عنوان در فاکتور فروش |
| SalesTitle | عنوان در فاکتور خرید |
| NodeId | شناسه دستهبندی |
| NodeName | نام دستهبندی (آخرین بخش NodeFamily) |
| NodeFamily | مسیر دستهبندی |
| Tag | فیلد متنی قابل استفاده توسط برنامهنویس |
| Description | توضیحات |
| ProductCode | کد کالا یا خدمات |
| LastPurchaseCost | آخرین قیمت خرید |
| Active | وضعیت کالا: فعال یا غیرفعال |
| SalesTaxable | مشمول مالیات فروش (true یا false) |
| PurchaseTaxable | مشمول مالیات خرید (true یا false) |
| TaxType | نوع مالیات ( جدول نوع مالیات کالا) |
| TaxId | کد مالیاتی |
| TaxUnit | واحد مالیاتی |
| ReorderPoint | نقطه سفارش مجدد |
| LeadTime | زمان تحویل (روز) |
| MinimumOrder | حداقل سفارش |
| PriceList | لیست قیمت |
| Title | عنوان |
| Currency | واحد پول |
| Price | قیمت |
{
"Success": true,
"ErrorCode": 0,
"ErrorMessage": "",
"Result": [
{
"Id": 79641,
"Code": "000001",
"Name": "Galaxy J7 گوشی موبایل",
"ItemType": 0,
"Unit": "عدد",
"SubUnit": "کارتن",
"ConversionFactor": 10,
"Barcode": "345345345345",
"Stock": 10,
"BuyPrice": 500000,
"SellPrice": 550000,
"PurchasesTitle": "Samsung Galaxy J7",
"SalesTitle": "Samsung Galaxy J7",
"NodeId": 43,
"NodeName": "سامسونگ",
"NodeFamily": "دیجیتال:موبایل:سامسونگ",
"Tag": "",
"Description": "",
"ProductCode": "745921",
"Active": true,
"SalesTaxable": true,
"PurchaseTaxable": true,
"TaxType": 3,
"TaxId": "1301234567890",
"TaxUnit": "کارتن",
"ReorderPoint": 0,
"LeadTime": 0,
"MinimumOrder": 0,
"PriceList": [
{
"Title": "عمده",
"Currency": "IRR",
"Price": 520000
},
{
"Title": "همکار",
"Currency": "IRR",
"Price": 525000
},
{
"Title": "مشتری ویژه",
"Currency": "IRR",
"Price": 540000
}
]
}
]
}
پارامترها :
|
apiKey userId password loginToken |
پارامترهای اجباری برای تمامی متدها
(مشاهدۀ توضیحات) |
| queryInfo | Object فیلتر و مرتبسازی (مشاهدۀ توضیحات) |
{
"apiKey": "your-api-key",
"loginToken": "your-login-token",
"queryInfo": {
"sortBy": "Code",
"sortDesc": true,
"take": 20,
"skip": 0,
"filters": [
{
"property": "Name",
"operator": "*",
"value": "Galaxy"
}
]
}
}
curl -X POST https://api.hesabfa.com/v1/item/getItems \
-H "Content-Type: application/json" \
-d '{
"apiKey": "your-api-key",
"loginToken": "your-login-token",
"queryInfo": {
"sortBy": "Code",
"sortDesc": true,
"take": 20,
"skip": 0,
"filters": [
{
"property": "Name",
"operator": "*",
"value": "Galaxy"
}
]
}
}'
<?php
$data = [
'apiKey' => 'your-api-key',
'loginToken' => 'your-login-token',
'queryInfo' => [
'sortBy' => 'Code',
'sortDesc' => true,
'take' => 20,
'skip' => 0,
'filters' => [
[
'property' => 'Name',
'operator' => '*',
'value' => 'Galaxy'
]
]
]
];
$ch = curl_init("https://api.hesabfa.com/v1/item/getItems");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$result = json_decode($response, true);
const data = {
apiKey: "your-api-key",
loginToken: "your-login-token",
queryInfo: {
sortBy: "Code",
sortDesc: true,
take: 20,
skip: 0,
filters: [
{
property: "Name",
operator: "*",
value: "Galaxy"
}
]
}
};
fetch("https://api.hesabfa.com/v1/item/getItems", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify(data)
})
.then(response => response.json())
.then(result => {
console.log(result);
});
import requests
data = {
"apiKey": "your-api-key",
"loginToken": "your-login-token",
"queryInfo": {
"sortBy": "Code",
"sortDesc": True,
"take": 20,
"skip": 0,
"filters": [
{
"property": "Name",
"operator": "*",
"value": "Galaxy"
}
]
}
}
response = requests.post(
"https://api.hesabfa.com/v1/item/getItems",
json=data
)
result = response.json()
print(result)
using System.Net.Http.Json;
using var client = new HttpClient();
var data = new
{
apiKey = "your-api-key",
loginToken = "your-login-token",
queryInfo = new
{
sortBy = "Code",
sortDesc = true,
take = 20,
skip = 0,
filters = new object[]
{
new
{
property = "Name",
@operator = "*",
value = "Galaxy"
}
}
}
};
var response = await client.PostAsJsonAsync("https://api.hesabfa.com/v1/item/getItems", data);
var result = await response.Content.ReadAsStringAsync();
Console.WriteLine(result);
آیتمهای موجود در پاسخ:
|
Success ErrorCode ErrorMessage |
(مشاهدۀ توضیحات) |
| Result | Object نتیجه، شامل اطلاعات صفحهبندی و آرایۀ کالاها و خدمات (List): |
| TotalCount | تعداد کل |
| FilteredCount | تعداد فیلتر شده |
| From | شمارۀ ردیف شروع |
| To | شمارۀ ردیف خاتمه |
| List | آرایهای از Objectهای اطلاعات کالا یا خدمت. هر Object ساختار زیر را دارد: |
| Id | شناسه کالا یا خدمات (برای سرویس دریافت با ID) |
| Code | کد حسابداری کالا یا خدمات |
| Name | نام کالا یا خدمات |
| ItemType | نوع ( جدول نوع کالا/خدمات) |
| Unit | واحد اصلی خرید و فروش |
| SubUnit | واحد فرعی خرید و فروش |
| ConversionFactor | ضریب تبدیل (واحد اصلی خرید و فروش به واحد فرعی) |
| Barcode | بارکد کالا یا خدمات |
| Stock | موجودی کالا |
| BuyPrice | قیمت خرید |
| SellPrice | قیمت فروش |
| PurchasesTitle | عنوان در فاکتور فروش |
| SalesTitle | عنوان در فاکتور خرید |
| NodeId | شناسه دستهبندی |
| NodeName | نام دستهبندی (آخرین بخش NodeFamily) |
| NodeFamily | مسیر دستهبندی |
| Tag | فیلد متنی قابل استفاده توسط برنامهنویس |
| Description | توضیحات |
| ProductCode | کد کالا یا خدمات |
| Active | وضعیت کالا: فعال یا غیرفعال |
| SalesTaxable | مشمول مالیات فروش (true یا false) |
| PurchaseTaxable | مشمول مالیات خرید (true یا false) |
| TaxType | نوع مالیات ( جدول نوع مالیات کالا) |
| TaxId | کد مالیاتی |
| TaxUnit | واحد مالیاتی |
| ReorderPoint | نقطه سفارش مجدد |
| LeadTime | زمان تحویل (روز) |
| MinimumOrder | حداقل سفارش |
| PriceList | لیست قیمت |
| Title | عنوان |
| Currency | واحد پول |
| Price | قیمت |
{
"Success": true,
"ErrorCode": 0,
"ErrorMessage": "",
"Result": {
"TotalCount": 20,
"FilteredCount": 2,
"From": 1,
"To": 2,
"List": [
{
"Id": 79641,
"Code": "000001",
"Name": "Galaxy J7 گوشی موبایل",
"ItemType": 0,
"Unit": "عدد",
"SubUnit": "کارتن",
"ConversionFactor": 10,
"Barcode": "345345345345",
"Stock": 10,
"BuyPrice": 500000,
"SellPrice": 550000,
"PurchasesTitle": "Samsung Galaxy J7",
"SalesTitle": "Samsung Galaxy J7",
"NodeId": 43,
"NodeName": "سامسونگ",
"NodeFamily": "دیجیتال:موبایل:سامسونگ",
"Tag": "",
"Description": "",
"ProductCode": "5612",
"Active": true,
"SalesTaxable": true,
"PurchaseTaxable": true,
"TaxType": 3,
"TaxId": "1301234567890",
"TaxUnit": "کارتن",
"ReorderPoint": 0,
"LeadTime": 0,
"MinimumOrder": 0,
"PriceList": [
{
"Title": "عمده",
"Currency": "IRR",
"Price": 520000
},
{
"Title": "همکار",
"Currency": "IRR",
"Price": 525000
},
{
"Title": "مشتری ویژه",
"Currency": "IRR",
"Price": 540000
}
]
},
{
"Id": 79642,
"Code": "000002",
"Name": "Galaxy S7 گوشی موبایل",
"ItemType": 0,
"Unit": "عدد",
"SubUnit": "",
"ConversionFactor": 0,
"Barcode": "8465456742345",
"Stock": 12,
"BuyPrice": 700000,
"SellPrice": 750000,
"PurchasesTitle": "Samsung Galaxy S7",
"SalesTitle": "Samsung Galaxy S7",
"NodeId": 43,
"NodeName": "سامسونگ",
"NodeFamily": "دیجیتال:موبایل:سامسونگ",
"Tag": "",
"Description": "",
"ProductCode": "5613",
"Active": true,
"SalesTaxable": true,
"PurchaseTaxable": true,
"TaxType": 3,
"TaxId": "1301234567890",
"TaxUnit": "کارتن",
"ReorderPoint": 0,
"LeadTime": 0,
"MinimumOrder": 0,
"PriceList": [
{
"Title": "عمده",
"Currency": "IRR",
"Price": 520000
},
{
"Title": "همکار",
"Currency": "IRR",
"Price": 525000
},
{
"Title": "مشتری ویژه",
"Currency": "IRR",
"Price": 540000
}
]
}
]
}
}
پارامترها :
|
apiKey userId password loginToken |
پارامترهای اجباری برای تمامی متدها
(مشاهدۀ توضیحات) |
| item | Object اطلاعات کالا یا خدمت، با ساختار زیر: * فیلدهای ستارهدار الزامی هستند. |
| code |
کد حسابداری کالا یا خدمات اگر کد کالا را وارد نکنید، بهعنوان کالای جدید ذخیره میشود. اگر کد وارد شده در سیستم موجود باشد، اطلاعات آن ویرایش میشود. اگر کد وارد شده موجود نباشد، کالا با آن کد ذخیره خواهد شد. |
| *name | نام کالا |
| *itemType | نوع ( جدول نوع کالا/خدمات ) |
| barcode | بارکد کالا/خدمات |
| unit | واحد اصلی خرید و فروش |
| subUnit | واحد فرعی خرید و فروش |
| conversionFactor | ضریب تبدیل (واحد اصلی خرید و فروش به واحد فرعی) |
| buyPrice | قیمت خرید |
| sellPrice | قیمت فروش |
| purchasesTitle | عنوان در فاکتور فروش |
| salesTitle | عنوان در فاکتور خرید |
| tag | فیلد متنی قابل استفاده توسط برنامهنویس |
| description | توضیحات |
| productCode | کد کالا یا خدمات |
| active | وضعیت کالا: فعال یا غیرفعال |
| salesTaxable | مشمول مالیات فروش (true یا false) |
| purchaseTaxable | مشمول مالیات خرید (true یا false) |
| taxType | نوع مالیات ( جدول نوع مالیات کالا) |
| taxId | کد مالیاتی |
| taxUnit | واحد مالیاتی |
| reorderPoint | نقطه سفارش مجدد |
| leadTime | زمان تحویل (روز) |
| minimumOrder | حداقل سفارش |
| nodeFamily |
دستهبندی کالاها: یک فیلد متنی است که با این فرمت میتوانید دستهبندی کالا یا خدمات را تعریف کنید:
برای کالاها «کالاها: دستۀ ۱:، دستۀ ۲ و به همین ترتیب تا دستۀ ...» برای خدمات «خدمات: دستۀ ۱:، دستۀ ۲ و به همین ترتیب تا دستۀ ...» |
| priceList | لیست قیمت |
| title | عنوان |
| currency | واحد پول |
| price | قیمت |
{
"apiKey": "your-api-key",
"loginToken": "your-login-token",
"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,
"salesTaxable": true,
"purchaseTaxable": true,
"taxType": 3,
"taxId": "1301234567890",
"taxUnit": "کارتن",
"reorderPoint": 0,
"leadTime": 0,
"minimumOrder": 0,
"nodeFamily": "کالاها : موبایل : سامسونگ",
"priceList": [
{
"title": "عمده",
"currency": "IRR",
"price": 520000
},
{
"title": "همکار",
"currency": "IRR",
"price": 525000
},
{
"title": "مشتری ویژه",
"currency": "IRR",
"price": 540000
}
]
}
}
curl -X POST https://api.hesabfa.com/v1/item/save \
-H "Content-Type: application/json" \
-d '{
"apiKey": "your-api-key",
"loginToken": "your-login-token",
"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,
"salesTaxable": true,
"purchaseTaxable": true,
"taxType": 3,
"taxId": "1301234567890",
"taxUnit": "کارتن",
"reorderPoint": 0,
"leadTime": 0,
"minimumOrder": 0,
"nodeFamily": "کالاها : موبایل : سامسونگ",
"priceList": [
{
"title": "عمده",
"currency": "IRR",
"price": 520000
},
{
"title": "همکار",
"currency": "IRR",
"price": 525000
},
{
"title": "مشتری ویژه",
"currency": "IRR",
"price": 540000
}
]
}
}'
<?php
$data = [
'apiKey' => 'your-api-key',
'loginToken' => 'your-login-token',
'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,
'salesTaxable' => true,
'purchaseTaxable' => true,
'taxType' => 3,
'taxId' => '1301234567890',
'taxUnit' => 'کارتن',
'reorderPoint' => 0,
'leadTime' => 0,
'minimumOrder' => 0,
'nodeFamily' => 'کالاها : موبایل : سامسونگ',
'priceList' => [
[
'title' => 'عمده',
'currency' => 'IRR',
'price' => 520000
],
[
'title' => 'همکار',
'currency' => 'IRR',
'price' => 525000
],
[
'title' => 'مشتری ویژه',
'currency' => 'IRR',
'price' => 540000
]
]
]
];
$ch = curl_init("https://api.hesabfa.com/v1/item/save");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$result = json_decode($response, true);
const data = {
apiKey: "your-api-key",
loginToken: "your-login-token",
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,
salesTaxable: true,
purchaseTaxable: true,
taxType: 3,
taxId: "1301234567890",
taxUnit: "کارتن",
reorderPoint: 0,
leadTime: 0,
minimumOrder: 0,
nodeFamily: "کالاها : موبایل : سامسونگ",
priceList: [
{
title: "عمده",
currency: "IRR",
price: 520000
},
{
title: "همکار",
currency: "IRR",
price: 525000
},
{
title: "مشتری ویژه",
currency: "IRR",
price: 540000
}
]
}
};
fetch("https://api.hesabfa.com/v1/item/save", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify(data)
})
.then(response => response.json())
.then(result => {
console.log(result);
});
import requests
data = {
"apiKey": "your-api-key",
"loginToken": "your-login-token",
"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,
"salesTaxable": True,
"purchaseTaxable": True,
"taxType": 3,
"taxId": "1301234567890",
"taxUnit": "کارتن",
"reorderPoint": 0,
"leadTime": 0,
"minimumOrder": 0,
"nodeFamily": "کالاها : موبایل : سامسونگ",
"priceList": [
{
"title": "عمده",
"currency": "IRR",
"price": 520000
},
{
"title": "همکار",
"currency": "IRR",
"price": 525000
},
{
"title": "مشتری ویژه",
"currency": "IRR",
"price": 540000
}
]
}
}
response = requests.post(
"https://api.hesabfa.com/v1/item/save",
json=data
)
result = response.json()
print(result)
using System.Net.Http.Json;
using var client = new HttpClient();
var data = new
{
apiKey = "your-api-key",
loginToken = "your-login-token",
item = new
{
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,
salesTaxable = true,
purchaseTaxable = true,
taxType = 3,
taxId = "1301234567890",
taxUnit = "کارتن",
reorderPoint = 0,
leadTime = 0,
minimumOrder = 0,
nodeFamily = "کالاها : موبایل : سامسونگ",
priceList = new object[]
{
new
{
title = "عمده",
currency = "IRR",
price = 520000
},
new
{
title = "همکار",
currency = "IRR",
price = 525000
},
new
{
title = "مشتری ویژه",
currency = "IRR",
price = 540000
}
}
}
};
var response = await client.PostAsJsonAsync("https://api.hesabfa.com/v1/item/save", data);
var result = await response.Content.ReadAsStringAsync();
Console.WriteLine(result);
آیتمهای موجود در پاسخ:
|
Success ErrorCode ErrorMessage |
(مشاهدۀ توضیحات) |
| Result | در صورت موفقیت، Object کالا یا خدمت ذخیرهشده یا ویرایششده در Result قرار میگیرد. ساختار آن به شرح زیر است: |
| Id | شناسه کالا یا خدمات (برای سرویس دریافت با ID) |
| Code | کد حسابداری کالا |
| Name | نام کالا |
| ItemType | نوع ( جدول نوع کالا/خدمات ) |
| Stock | موجودی کالا |
| Unit | واحد اصلی خرید و فروش |
| SubUnit | واحد فرعی خرید و فروش |
| ConversionFactor | ضریب تبدیل (واحد اصلی خرید و فروش به واحد فرعی) |
| Barcode | بارکد کالا/خدمات |
| BuyPrice | قیمت خرید |
| SellPrice | قیمت فروش |
| PurchasesTitle | عنوان در فاکتور فروش |
| SalesTitle | عنوان در فاکتور خرید |
| Tag | فیلد متنی قابل استفاده توسط برنامهنویس |
| Description | توضیحات |
| ProductCode | کد کالا |
| Active | وضعیت کالا: فعال یا غیرفعال |
| SalesTaxable | مشمول مالیات فروش (true یا false) |
| PurchaseTaxable | مشمول مالیات خرید (true یا false) |
| TaxType | نوع مالیات ( جدول نوع مالیات کالا) |
| TaxId | کد مالیاتی |
| TaxUnit | واحد مالیاتی |
| ReorderPoint | نقطه سفارش مجدد |
| LeadTime | زمان تحویل (روز) |
| MinimumOrder | حداقل سفارش |
| PriceList | لیست قیمت |
| NodeId | شناسه دستهبندی |
| NodeName | نام دستهبندی (آخرین بخش NodeFamily) |
| NodeFamily |
دستهبندی کالا: یک فیلد متنی که به فرمت زیر می باشد.
برای کالا: "کالاها: دسته 1: دسته 2: ..." برای خدمات: "خدمات: دسته 1: دسته 2: ..." |
| Title | عنوان |
| Currency | واحد پول |
| Price | قیمت |
{
"Success": true,
"ErrorCode": 0,
"ErrorMessage": "",
"Result": {
"Id": 79641,
"Code": "000001",
"Name": "Galaxy J7 گوشی موبایل",
"ItemType": 0,
"Unit": "عدد",
"SubUnit": "",
"ConversionFactor": 0,
"Barcode": "345345345345",
"Stock": 10,
"BuyPrice": 500000,
"SellPrice": 550000,
"PurchasesTitle": "Samsung Galaxy J7",
"SalesTitle": "Samsung Galaxy J7",
"NodeId": 43,
"NodeName": "سامسونگ",
"NodeFamily": "کالاها : موبایل : سامسونگ",
"Tag": "",
"Description": "",
"ProductCode": "45812",
"Active": true,
"SalesTaxable": true,
"PurchaseTaxable": true,
"TaxType": 3,
"TaxId": "1301234567890",
"TaxUnit": "کارتن",
"ReorderPoint": 0,
"LeadTime": 0,
"MinimumOrder": 0,
"PriceList": [
{
"Title": "عمده",
"Currency": "IRR",
"Price": 520000
},
{
"Title": "همکار",
"Currency": "IRR",
"Price": 525000
},
{
"Title": "مشتری ویژه",
"Currency": "IRR",
"Price": 540000
}
]
}
}
پارامترها :
|
apiKey userId password loginToken |
پارامترهای اجباری برای تمامی متدها
(مشاهدۀ توضیحات) |
| items | آرایهای از Objectهای اطلاعات کالا یا خدمت. هر Object ساختار زیر را دارد: * فیلدهای ستارهدار الزامی هستند. |
| code |
کد حسابداری کالا یا خدمات اگر کد کالا را وارد نکنید، بهعنوان کالای جدید ذخیره میشود. اگر کد وارد شده در سیستم موجود باشد، اطلاعات آن ویرایش میشود. اگر کد وارد شده موجود نباشد، کالا با آن کد ذخیره خواهد شد. |
| *name | نام کالا |
| *itemType | نوع ( جدول نوع کالا/خدمات ) |
| barcode | بارکد کالا/خدمات |
| unit | واحد اصلی خرید و فروش |
| subUnit | واحد فرعی خرید و فروش |
| conversionFactor | ضریب تبدیل(واحد اصلی خرید و فروش به واحد فرعی) |
| buyPrice | قیمت خرید |
| sellPrice | قیمت فروش |
| purchasesTitle | عنوان در فاکتور فروش |
| salesTitle | عنوان در فاکتور خرید |
| tag | فیلد متنی قابل استفاده توسط برنامهنویس |
| description | توضیحات |
| productCode | کد کالا یا خدمات |
| active | وضعیت کالا: فعال یا غیرفعال |
| salesTaxable | مشمول مالیات فروش (true یا false) |
| purchaseTaxable | مشمول مالیات خرید (true یا false) |
| taxType | نوع مالیات ( جدول نوع مالیات کالا) |
| taxId | کد مالیاتی |
| taxUnit | واحد مالیاتی |
| reorderPoint | نقطه سفارش مجدد |
| leadTime | زمان تحویل (روز) |
| minimumOrder | حداقل سفارش |
| nodeFamily |
دستهبندی کالاها: یک فیلد متنی است که با این فرمت میتوانید دستهبندی کالا یا خدمات را تعریف کنید:
برای کالاها «کالاها: دستۀ ۱:، دستۀ ۲ و به همین ترتیب تا دستۀ ...» برای خدمات «خدمات: دستۀ ۱:، دستۀ ۲ و به همین ترتیب تا دستۀ ...» |
| priceList | قیمت پیشفرض |
| title | عنوان |
| currency | واحد پول |
| price | قیمت |
{
"apiKey": "your-api-key",
"loginToken": "your-login-token",
"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": "",
"salesTaxable": true,
"purchaseTaxable": true,
"taxType": 3,
"taxId": "1301234567890",
"taxUnit": "کارتن",
"reorderPoint": 0,
"leadTime": 0,
"minimumOrder": 0,
"nodeFamily": "کالاها : موبایل : سامسونگ"
},
{
"name": "Galaxy S7 گوشی موبایل",
"itemType": 0
}
]
}
curl -X POST https://api.hesabfa.com/v1/item/batchSave \
-H "Content-Type: application/json" \
-d '{
"apiKey": "your-api-key",
"loginToken": "your-login-token",
"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": "",
"salesTaxable": true,
"purchaseTaxable": true,
"taxType": 3,
"taxId": "1301234567890",
"taxUnit": "کارتن",
"reorderPoint": 0,
"leadTime": 0,
"minimumOrder": 0,
"nodeFamily": "کالاها : موبایل : سامسونگ"
},
{
"name": "Galaxy S7 گوشی موبایل",
"itemType": 0
}
]
}'
<?php
$data = [
'apiKey' => 'your-api-key',
'loginToken' => 'your-login-token',
'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' => '',
'salesTaxable' => true,
'purchaseTaxable' => true,
'taxType' => 3,
'taxId' => '1301234567890',
'taxUnit' => 'کارتن',
'reorderPoint' => 0,
'leadTime' => 0,
'minimumOrder' => 0,
'nodeFamily' => 'کالاها : موبایل : سامسونگ'
],
[
'name' => 'Galaxy S7 گوشی موبایل',
'itemType' => 0
]
]
];
$ch = curl_init("https://api.hesabfa.com/v1/item/batchSave");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$result = json_decode($response, true);
const data = {
apiKey: "your-api-key",
loginToken: "your-login-token",
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: "",
salesTaxable: true,
purchaseTaxable: true,
taxType: 3,
taxId: "1301234567890",
taxUnit: "کارتن",
reorderPoint: 0,
leadTime: 0,
minimumOrder: 0,
nodeFamily: "کالاها : موبایل : سامسونگ"
},
{
name: "Galaxy S7 گوشی موبایل",
itemType: 0
}
]
};
fetch("https://api.hesabfa.com/v1/item/batchSave", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify(data)
})
.then(response => response.json())
.then(result => {
console.log(result);
});
import requests
data = {
"apiKey": "your-api-key",
"loginToken": "your-login-token",
"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": "",
"salesTaxable": True,
"purchaseTaxable": True,
"taxType": 3,
"taxId": "1301234567890",
"taxUnit": "کارتن",
"reorderPoint": 0,
"leadTime": 0,
"minimumOrder": 0,
"nodeFamily": "کالاها : موبایل : سامسونگ"
},
{
"name": "Galaxy S7 گوشی موبایل",
"itemType": 0
}
]
}
response = requests.post(
"https://api.hesabfa.com/v1/item/batchSave",
json=data
)
result = response.json()
print(result)
using System.Net.Http.Json;
using var client = new HttpClient();
var data = new
{
apiKey = "your-api-key",
loginToken = "your-login-token",
items = new object[]
{
new
{
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 = "",
salesTaxable = true,
purchaseTaxable = true,
taxType = 3,
taxId = "1301234567890",
taxUnit = "کارتن",
reorderPoint = 0,
leadTime = 0,
minimumOrder = 0,
nodeFamily = "کالاها : موبایل : سامسونگ"
},
new
{
name = "Galaxy S7 گوشی موبایل",
itemType = 0
}
}
};
var response = await client.PostAsJsonAsync("https://api.hesabfa.com/v1/item/batchSave", data);
var result = await response.Content.ReadAsStringAsync();
Console.WriteLine(result);
آیتمهای موجود در پاسخ:
|
Success ErrorCode ErrorMessage |
(مشاهدۀ توضیحات) |
| Result | در صورت موفقیت، آرایهای از کالاها و خدمات ذخیرهشده یا ویرایششده در Result قرار میگیرد. هر مورد ساختار زیر را دارد: |
| Id | شناسه کالا یا خدمات (برای سرویس دریافت با ID) |
| Code | کد حسابداری کالا |
| Name | نام کالا |
| ItemType | نوع ( جدول نوع کالا/خدمات ) |
| Stock | موجودی کالا |
| Unit | واحد اصلی خرید و فروش |
| SubUnit | واحد فرعی خرید و فروش |
| ConversionFactor | ضریب تبدیل(واحد اصلی خرید و فروش به واحد فرعی) |
| Barcode | بارکد کالا/خدمات |
| BuyPrice | قیمت خرید |
| SellPrice | قیمت فروش |
| PurchasesTitle | عنوان در فاکتور فروش |
| SalesTitle | عنوان در فاکتور خرید |
| Tag | فیلد متنی قابل استفاده توسط برنامهنویس |
| Description | توضیحات |
| ProductCode | کد کالا یا خدمات |
| Active | وضعیت کالا: فعال یا غیرفعال |
| SalesTaxable | مشمول مالیات فروش (true یا false) |
| PurchaseTaxable | مشمول مالیات خرید (true یا false) |
| TaxType | نوع مالیات ( جدول نوع مالیات کالا) |
| TaxId | کد مالیاتی |
| TaxUnit | واحد مالیاتی |
| ReorderPoint | نقطه سفارش مجدد |
| LeadTime | زمان تحویل (روز) |
| MinimumOrder | حداقل سفارش |
| NodeId | شناسه دستهبندی |
| NodeName | نام دستهبندی (آخرین بخش NodeFamily) |
| NodeFamily |
دستهبندی کالا: یک فیلد متنی که به فرمت زیر می باشد.
برای کالا: "کالاها: دسته 1: دسته 2: ..." برای خدمات: "خدمات: دسته 1: دسته 2: ..." |
| PriceList | قیمت پیشفرض |
| Title | عنوان |
| Currency | واحد پول |
| Price | قیمت |
{
"Success": true,
"ErrorCode": 0,
"ErrorMessage": "",
"Result": [
{
"Id": 79641,
"Code": "000001",
"Name": "Galaxy J7 گوشی موبایل",
"ItemType": 0,
"Unit": "عدد",
"SubUnit": "",
"ConversionFactor": 0,
"Barcode": "345345345345",
"Stock": 10,
"BuyPrice": 500000,
"SellPrice": 550000,
"PurchasesTitle": "Samsung Galaxy J7",
"SalesTitle": "Samsung Galaxy J7",
"NodeId": 43,
"NodeName": "دیجیتال/موبایل/سامسونگ",
"NodeFamily": "دیجیتال/موبایل/سامسونگ",
"Tag": "",
"Description": "",
"ProductCode": "75134",
"Active": true,
"SalesTaxable": true,
"PurchaseTaxable": true,
"TaxType": 3,
"TaxId": "1301234567890",
"TaxUnit": "کارتن",
"ReorderPoint": 0,
"LeadTime": 0,
"MinimumOrder": 0,
"PriceList": null
},
{
"Id": 79642,
"Code": "000002",
"Name": "Galaxy S7 گوشی موبایل",
"ItemType": 0,
"Unit": "",
"SubUnit": "",
"ConversionFactor": 0,
"Barcode": "",
"Stock": 0,
"BuyPrice": 0,
"SellPrice": 0,
"PurchasesTitle": "",
"SalesTitle": "",
"NodeId": 43,
"NodeName": "",
"NodeFamily": "",
"Tag": "",
"Description": "",
"ProductCode": "",
"Active": true,
"SalesTaxable": true,
"PurchaseTaxable": true,
"TaxType": 3,
"TaxId": "1301234567890",
"TaxUnit": "کارتن",
"ReorderPoint": 0,
"LeadTime": 0,
"MinimumOrder": 0,
"PriceList": null
}
]
}
پارامترها :
|
apiKey userId password loginToken |
پارامترهای اجباری برای تمامی متدها
(مشاهدۀ توضیحات) |
| code | کد حسابداری کالای مورد نظر |
curl -X POST https://api.hesabfa.com/v1/item/delete \
-H "Content-Type: application/json" \
-d '{
"apiKey": "your-api-key",
"loginToken": "your-login-token",
"code": "00001"
}'
<?php
$data = [
'apiKey' => 'your-api-key',
'loginToken' => 'your-login-token',
'code' => '00001'
];
$ch = curl_init("https://api.hesabfa.com/v1/item/delete");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$result = json_decode($response, true);
const data = {
apiKey: "your-api-key",
loginToken: "your-login-token",
code: "00001"
};
fetch("https://api.hesabfa.com/v1/item/delete", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify(data)
})
.then(response => response.json())
.then(result => {
console.log(result);
});
import requests
data = {
"apiKey": "your-api-key",
"loginToken": "your-login-token",
"code": "00001"
}
response = requests.post(
"https://api.hesabfa.com/v1/item/delete",
json=data
)
result = response.json()
print(result)
using System.Net.Http.Json;
using var client = new HttpClient();
var data = new
{
apiKey = "your-api-key",
loginToken = "your-login-token",
code = "00001"
};
var response = await client.PostAsJsonAsync("https://api.hesabfa.com/v1/item/delete", data);
var result = await response.Content.ReadAsStringAsync();
Console.WriteLine(result);
آیتمهای موجود در پاسخ:
|
Success ErrorCode ErrorMessage |
(مشاهدۀ توضیحات) |
| Result | در صورت موفقیت، مقدار true در Result قرار میگیرد. |
پارامترها :
|
apiKey userId password loginToken |
پارامترهای اجباری برای تمامی متدها
(مشاهدۀ توضیحات) |
| warehouseCode | کد انبار (اختیاری) |
| codes | آرایهای از کد کالاها (اختیاری، حداکثر 2000 کد) |
{
"apiKey": "your-api-key",
"loginToken": "your-login-token",
"warehouseCode": 12,
"codes": [
"000005",
"6",
"7"
]
}
curl -X POST https://api.hesabfa.com/v1/item/GetQuantity \
-H "Content-Type: application/json" \
-d '{
"apiKey": "your-api-key",
"loginToken": "your-login-token",
"warehouseCode": 12,
"codes": [
"000005",
"6",
"7"
]
}'
<?php
$data = [
'apiKey' => 'your-api-key',
'loginToken' => 'your-login-token',
'warehouseCode' => 12,
'codes' => [
'000005',
'6',
'7'
]
];
$ch = curl_init("https://api.hesabfa.com/v1/item/GetQuantity");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$result = json_decode($response, true);
const data = {
apiKey: "your-api-key",
loginToken: "your-login-token",
warehouseCode: 12,
codes: [
"000005",
"6",
"7"
]
};
fetch("https://api.hesabfa.com/v1/item/GetQuantity", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify(data)
})
.then(response => response.json())
.then(result => {
console.log(result);
});
import requests
data = {
"apiKey": "your-api-key",
"loginToken": "your-login-token",
"warehouseCode": 12,
"codes": [
"000005",
"6",
"7"
]
}
response = requests.post(
"https://api.hesabfa.com/v1/item/GetQuantity",
json=data
)
result = response.json()
print(result)
using System.Net.Http.Json;
using var client = new HttpClient();
var data = new
{
apiKey = "your-api-key",
loginToken = "your-login-token",
warehouseCode = 12,
codes = new object[]
{
"000005",
"6",
"7"
}
};
var response = await client.PostAsJsonAsync("https://api.hesabfa.com/v1/item/GetQuantity", data);
var result = await response.Content.ReadAsStringAsync();
Console.WriteLine(result);
نکات ضروری
- اگر warehouseCode ارسال شود و سیستم انبارداری فعال باشد، کالاها و موجودی همان انبار برگردانده میشود. اگر warehouseCode ارسال نشود یا سیستم انبارداری فعال نباشد، همۀ کالاها با موجودی کل برگردانده میشوند.
- اگر codes ارسال شود، فقط کالاهایی که کدشان در آرایۀ codes است برگردانده میشوند؛ در غیر این صورت، همۀ کالاها برگردانده میشوند.
آیتمهای موجود در پاسخ:
|
Success ErrorCode ErrorMessage |
(مشاهدۀ توضیحات) |
| Result | آرایهای از موجودی کالاها. هر مورد ساختار زیر را دارد: |
| Code | کد حسابداری کالا |
| Tag | فیلد متنی قابل استفاده توسط برنامهنویس |
| Quantity | تعداد |
| Barcode | بارکد کالا/خدمات |
| ProductCode | کد کالا/ خدمات |
| SellPrice | قیمت فروش |
| LastVendor | آخرین تأمین کننده |
| Id | شناسه تأمین کننده |
| Code | کد تأمین کننده |
| DisplayName | نام تأمین کننده |
| LastPurchaseCost | آخرین قیمت خرید |
| LastPurchaseDate | تاریخ آخرین خرید |
{
"Success": true,
"ErrorCode": 0,
"ErrorMessage": "",
"Result": [
{
"Code": "000001",
"Tag": "115",
"Quantity": 0,
"ProductCode": "PCS-873300",
"Barcode": "650077842",
"SellPrice": 1570000,
"LastVendor": {
"Id": 1,
"Code": "000251",
"DisplayName": "شرکت آرمان شبکه"
},
"LastPurchaseCost": 1220000,
"LastPurchaseDate": "2025-10-05T00:00:00"
},
{
"Code": "000002",
"Tag": "230",
"Quantity": 16,
"ProductCode": "PCS-873301",
"Barcode": "89504564",
"SellPrice": 275000,
"LastVendor": {
"Id": 1,
"Code": "000251",
"DisplayName": "شرکت آرمان شبکه"
},
"LastPurchaseCost": 1220000,
"LastPurchaseDate": "2025-10-04T00:00:00"
}
]
}
پارامترها :
|
apiKey userId password loginToken |
پارامترهای اجباری برای تمامی متدها
(مشاهدۀ توضیحات) |
| codes | آرایهای از کد کالاها (اختیاری، حداکثر 2000 کد) |
{
"apiKey": "your-api-key",
"loginToken": "your-login-token",
"codes": [
"000005",
"000006"
]
}
curl -X POST https://api.hesabfa.com/v1/item/GetQuantity2 \
-H "Content-Type: application/json" \
-d '{
"apiKey": "your-api-key",
"loginToken": "your-login-token",
"codes": [
"000005",
"000006"
]
}'
<?php
$data = [
'apiKey' => 'your-api-key',
'loginToken' => 'your-login-token',
'codes' => [
'000005',
'000006'
]
];
$ch = curl_init("https://api.hesabfa.com/v1/item/GetQuantity2");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$result = json_decode($response, true);
const data = {
apiKey: "your-api-key",
loginToken: "your-login-token",
codes: [
"000005",
"000006"
]
};
fetch("https://api.hesabfa.com/v1/item/GetQuantity2", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify(data)
})
.then(response => response.json())
.then(result => {
console.log(result);
});
import requests
data = {
"apiKey": "your-api-key",
"loginToken": "your-login-token",
"codes": [
"000005",
"000006"
]
}
response = requests.post(
"https://api.hesabfa.com/v1/item/GetQuantity2",
json=data
)
result = response.json()
print(result)
using System.Net.Http.Json;
using var client = new HttpClient();
var data = new
{
apiKey = "your-api-key",
loginToken = "your-login-token",
codes = new object[]
{
"000005",
"000006"
}
};
var response = await client.PostAsJsonAsync("https://api.hesabfa.com/v1/item/GetQuantity2", data);
var result = await response.Content.ReadAsStringAsync();
Console.WriteLine(result);
نکات ضروری
- اگر سیستم انبارداری فعال باشد، موجودی کل و موجودی هر انبار برگردانده میشود؛ اگر غیرفعال باشد، فقط موجودی کل کالاها برگردانده میشود.
- اگر codes ارسال شود، فقط کالاهایی که کدشان در آرایۀ codes است برگردانده میشوند؛ در غیر این صورت، همۀ کالاها برگردانده میشوند.
آیتمهای موجود در پاسخ:
|
Success ErrorCode ErrorMessage |
(مشاهدۀ توضیحات) |
| Result | آرایهای از موجودی کالاها. هر مورد ساختار زیر را دارد: |
| Code | کد حسابداری کالا |
| Tag | فیلد متنی قابل استفاده توسط برنامهنویس |
| Quantity | تعداد در سیستم حسابداری |
| Barcode | بارکد کالا/خدمات |
| ProductCode | کد کالا/خدمات |
| SellPrice | قیمت فروش |
| LastVendor | آخرین تأمین کننده |
| Id | شناسه تأمین کننده |
| Code | کد تأمین کننده |
| DisplayName | نام تأمین کننده |
| LastPurchaseCost | آخرین قیمت خرید |
| LastPurchaseDate | تاریخ آخرین خرید |
| Warehouse | آرایهای از موجودی کالا در همۀ انبارها |
| Code | کد انبار |
| Quantity | موجودی در انبار |
{
"Success": true,
"ErrorCode": 0,
"ErrorMessage": "",
"Result": [
{
"Code": "000005",
"Tag": "",
"Quantity": 5.0,
"Barcode": "504056",
"ProductCode": "4980",
"SellPrice": 133900.0,
"LastVendor": {
"Id": 1,
"Code": "000251",
"DisplayName": "شرکت آرمان شبکه"
},
"LastPurchaseCost": 1220000.0,
"LastPurchaseDate": "2025-10-05T00:00:00",
"Warehouse": [
{
"Code": 11,
"Quantity": -1.0
},
{
"Code": 12,
"Quantity": 7.0
}
]
},
{
"Code": "000006",
"Tag": "",
"Quantity": 1.0,
"Barcode": "6260136100720",
"ProductCode": "16936",
"SellPrice": 597500.0,
"LastVendor": {
"Id": 1,
"Code": "000251",
"DisplayName": "شرکت آرمان شبکه"
},
"LastPurchaseCost": 1220000.0,
"LastPurchaseDate": "2025-10-04T00:00:00",
"Warehouse": [
{
"Code": 11,
"Quantity": 5.0
},
{
"Code": 12,
"Quantity": -1.0
}
]
}
]
}
پارامترها :
|
apiKey userId password loginToken |
پارامترهای اجباری برای تمامی متدها
(مشاهدۀ توضیحات) |
| items | آرایهای از Objectهای اطلاعات کالا. هر Object ساختار زیر را دارد: * فیلدهای ستارهدار الزامی هستند. |
| *code | کد کالا |
| *quantity | تعداد (باید بزرگتر از صفر باشد) |
| *unitPrice | مبلغ واحد (باید بزرگتر از صفر باشد) |
| warehouseCode | کد انبار |
{
"apiKey": "your-api-key",
"loginToken": "your-login-token",
"items": [
{
"code": "000001",
"quantity": 3,
"unitPrice": 250000,
"warehouseCode": 12
},
{
"code": "000002",
"quantity": 5,
"unitPrice": 378000
}
]
}
curl -X POST https://api.hesabfa.com/v1/item/UpdateOpeningQuantity \
-H "Content-Type: application/json" \
-d '{
"apiKey": "your-api-key",
"loginToken": "your-login-token",
"items": [
{
"code": "000001",
"quantity": 3,
"unitPrice": 250000,
"warehouseCode": 12
},
{
"code": "000002",
"quantity": 5,
"unitPrice": 378000
}
]
}'
<?php
$data = [
'apiKey' => 'your-api-key',
'loginToken' => 'your-login-token',
'items' => [
[
'code' => '000001',
'quantity' => 3,
'unitPrice' => 250000,
'warehouseCode' => 12
],
[
'code' => '000002',
'quantity' => 5,
'unitPrice' => 378000
]
]
];
$ch = curl_init("https://api.hesabfa.com/v1/item/UpdateOpeningQuantity");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$result = json_decode($response, true);
const data = {
apiKey: "your-api-key",
loginToken: "your-login-token",
items: [
{
code: "000001",
quantity: 3,
unitPrice: 250000,
warehouseCode: 12
},
{
code: "000002",
quantity: 5,
unitPrice: 378000
}
]
};
fetch("https://api.hesabfa.com/v1/item/UpdateOpeningQuantity", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify(data)
})
.then(response => response.json())
.then(result => {
console.log(result);
});
import requests
data = {
"apiKey": "your-api-key",
"loginToken": "your-login-token",
"items": [
{
"code": "000001",
"quantity": 3,
"unitPrice": 250000,
"warehouseCode": 12
},
{
"code": "000002",
"quantity": 5,
"unitPrice": 378000
}
]
}
response = requests.post(
"https://api.hesabfa.com/v1/item/UpdateOpeningQuantity",
json=data
)
result = response.json()
print(result)
using System.Net.Http.Json;
using var client = new HttpClient();
var data = new
{
apiKey = "your-api-key",
loginToken = "your-login-token",
items = new object[]
{
new
{
code = "000001",
quantity = 3,
unitPrice = 250000,
warehouseCode = 12
},
new
{
code = "000002",
quantity = 5,
unitPrice = 378000
}
}
};
var response = await client.PostAsJsonAsync("https://api.hesabfa.com/v1/item/UpdateOpeningQuantity", data);
var result = await response.Content.ReadAsStringAsync();
Console.WriteLine(result);
نکات ضروری
- با فراخوانی این متد، موجودی اول دورۀ کالاها در تراز افتتاحیه ثبت و سند افتتاحیه متناسب با آن ویرایش میشود. پیش از فراخوانی این متد، مطمئن شوید که سهامداران در حسابفا تعریف شدهاند.
- انجام این عمل تنها در اولین سال مالی ممکن است.
- فقط موجودی کالاهای ارسالشده بهروزرسانی میشود و موجودی کالاهای دیگری که در تراز افتتاحیه ثبت شدهاند، تغییر نمیکند.
- تعداد و قیمت واحد باید بزرگتر از صفر باشند؛ در غیر این صورت، ثبت نمیشوند.
- این متد را فقط در ابتدای سال مالی فراخوانی کنید؛ فراخوانی آن در میانۀ سال مالی، موجودی سیستم را دچار اختلال میکند.
آیتمهای موجود در پاسخ:
|
Success ErrorCode ErrorMessage |
(مشاهدۀ توضیحات) |
| Result | در صورت موفقیت، مقدار true در Result قرار میگیرد. |