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


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

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

apiKey
userId
password
loginToken
پارامترهای اجباری برای تمامی متدها
(مشاهدۀ توضیحات)
code کد حسابداری کالای مورد نظر
Copyed
{
    "apiKey": "your-api-key",
    "loginToken": "your-login-token",
    "code": "000001"
}
Copyed
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"
}'
Copyed
<?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);
Copyed
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);
    });
Copyed
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)
Copyed
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 قیمت
Copyed
{
    "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
            }
        ]
    }
}
Copyed
URL:https://api.hesabfa.com/v1/item/getByBarcode

پارامترها :

apiKey
userId
password
loginToken
پارامترهای اجباری برای تمامی متدها
(مشاهدۀ توضیحات)
barcode بارکد کالای مورد نظر
Copyed
{
    "apiKey": "your-api-key",
    "loginToken": "your-login-token",
    "barcode": "345345345345"
}
Copyed
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"
}'
Copyed
<?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);
Copyed
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);
    });
Copyed
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)
Copyed
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 قیمت
مثال:
Copyed
{
    "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
            }
        ]
    }
}
Copyed
URL:https://api.hesabfa.com/v1/item/getById

پارامترها :

apiKey
userId
password
loginToken
پارامترهای اجباری برای تمامی متدها
(مشاهدۀ توضیحات)
idList آرایه‌ای از id کالاها و خدمات
Copyed
{
    "apiKey": "your-api-key",
    "loginToken": "your-login-token",
    "idList": [
        1,
        2,
        3
    ]
}
Copyed
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
    ]
}'
Copyed
<?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);
Copyed
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);
    });
Copyed
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)
Copyed
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 قیمت
Copyed
{
    "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
                }
            ]
        }
    ]
}
Copyed
URL:https://api.hesabfa.com/v1/item/getItems

پارامترها :

apiKey
userId
password
loginToken
پارامترهای اجباری برای تمامی متدها
(مشاهدۀ توضیحات)
queryInfo Object فیلتر و مرتب‌سازی (مشاهدۀ توضیحات)
Copyed
{
    "apiKey": "your-api-key",
    "loginToken": "your-login-token",
    "queryInfo": {
        "sortBy": "Code",
        "sortDesc": true,
        "take": 20,
        "skip": 0,
        "filters": [
            {
                "property": "Name",
                "operator": "*",
                "value": "Galaxy"
            }
        ]
    }
}
Copyed
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"
            }
        ]
    }
}'
Copyed
<?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);
Copyed
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);
    });
Copyed
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)
Copyed
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 قیمت
Copyed
{
    "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
                    }
                ]
            }
        ]
    }
}
Copyed
URL:https://api.hesabfa.com/v1/item/save

پارامترها :

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 قیمت
Copyed
{
    "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
            }
        ]
    }
}
Copyed
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
            }
        ]
    }
}'
Copyed
<?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);
Copyed
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);
    });
Copyed
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)
Copyed
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 قیمت
Copyed
{
    "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
            }
        ]
    }
}
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 وضعیت کالا: فعال یا غیرفعال
salesTaxable مشمول مالیات فروش (true یا false)
purchaseTaxable مشمول مالیات خرید (true یا false)
taxType نوع مالیات ( جدول نوع مالیات کالا)
taxId کد مالیاتی
taxUnit واحد مالیاتی
reorderPoint نقطه سفارش مجدد
leadTime زمان تحویل (روز)
minimumOrder حداقل سفارش
nodeFamily دسته‌بندی کالاها: یک فیلد متنی است که با این فرمت می‌توانید دسته‌بندی کالا یا خدمات را تعریف کنید:
برای کالاها «کالاها: دستۀ ۱:، دستۀ ۲ و به همین ترتیب تا دستۀ ...»
برای خدمات «خدمات: دستۀ ۱:، دستۀ ۲ و به همین ترتیب تا دستۀ ...»
priceList قیمت پیش‌فرض
title عنوان
currency واحد پول
price قیمت
Copyed
{
    "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
        }
    ]
}
Copyed
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
        }
    ]
}'
Copyed
<?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);
Copyed
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);
    });
Copyed
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)
Copyed
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 قیمت
Copyed
{
    "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
        }
    ]
}
Copyed
URL: https://api.hesabfa.com/v1/item/delete

پارامترها :

apiKey
userId
password
loginToken
پارامترهای اجباری برای تمامی متدها
(مشاهدۀ توضیحات)
code کد حسابداری کالای مورد نظر
Copyed
{
    "apiKey": "your-api-key",
    "loginToken": "your-login-token",
    "code": "00001"
}
Copyed
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"
}'
Copyed
<?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);
Copyed
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);
    });
Copyed
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)
Copyed
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 قرار می‌گیرد.
Copyed
{
    "Success": true,
    "ErrorCode": 0,
    "ErrorMessage": "",
    "Result": true
}
Copyed
URL:https://api.hesabfa.com/v1/item/GetQuantity

پارامترها :

apiKey
userId
password
loginToken
پارامترهای اجباری برای تمامی متدها
(مشاهدۀ توضیحات)
warehouseCode کد انبار (اختیاری)
codes آرایه‌ای از کد کالاها (اختیاری، حداکثر 2000 کد)
Copyed
{
    "apiKey": "your-api-key",
    "loginToken": "your-login-token",
    "warehouseCode": 12,
    "codes": [
        "000005",
        "6",
        "7"
    ]
}
Copyed
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"
    ]
}'
Copyed
<?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);
Copyed
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);
    });
Copyed
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)
Copyed
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);
نکات ضروری
  1. اگر warehouseCode ارسال شود و سیستم انبارداری فعال باشد، کالاها و موجودی همان انبار برگردانده می‌شود. اگر warehouseCode ارسال نشود یا سیستم انبارداری فعال نباشد، همۀ کالاها با موجودی کل برگردانده می‌شوند.
  2. اگر codes ارسال شود، فقط کالاهایی که کدشان در آرایۀ codes است برگردانده می‌شوند؛ در غیر این صورت، همۀ کالاها برگردانده می‌شوند.

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

Success
ErrorCode
ErrorMessage
(مشاهدۀ توضیحات)
Result آرایه‌ای از موجودی کالاها. هر مورد ساختار زیر را دارد:
Code کد حسابداری کالا
Tag فیلد متنی قابل استفاده توسط برنامه‌نویس
Quantity تعداد
Barcode بارکد کالا/خدمات
ProductCode کد کالا/ خدمات
SellPrice قیمت فروش
LastVendor آخرین تأمین کننده
Id شناسه تأمین کننده
Code کد تأمین کننده
DisplayName نام تأمین کننده
LastPurchaseCost آخرین قیمت خرید
LastPurchaseDate تاریخ آخرین خرید
Copyed
{
    "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"
        }
    ]
}
Copyed
URL:https://api.hesabfa.com/v1/item/GetQuantity2

پارامترها :

apiKey
userId
password
loginToken
پارامترهای اجباری برای تمامی متدها
(مشاهدۀ توضیحات)
codes آرایه‌ای از کد کالاها (اختیاری، حداکثر 2000 کد)
Copyed
{
    "apiKey": "your-api-key",
    "loginToken": "your-login-token",
    "codes": [
        "000005",
        "000006"
    ]
}
Copyed
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"
    ]
}'
Copyed
<?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);
Copyed
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);
    });
Copyed
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)
Copyed
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);
نکات ضروری
  1. اگر سیستم انبارداری فعال باشد، موجودی کل و موجودی هر انبار برگردانده می‌شود؛ اگر غیرفعال باشد، فقط موجودی کل کالاها برگردانده می‌شود.
  2. اگر codes ارسال شود، فقط کالاهایی که کدشان در آرایۀ codes است برگردانده می‌شوند؛ در غیر این صورت، همۀ کالاها برگردانده می‌شوند.

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

Success
ErrorCode
ErrorMessage
(مشاهدۀ توضیحات)
Result آرایه‌ای از موجودی کالاها. هر مورد ساختار زیر را دارد:
Code کد حسابداری کالا
Tag فیلد متنی قابل استفاده توسط برنامه‌نویس
Quantity تعداد در سیستم حسابداری
Barcode بارکد کالا/خدمات
ProductCode کد کالا/خدمات
SellPrice قیمت فروش
LastVendor آخرین تأمین کننده
Id شناسه تأمین کننده
Code کد تأمین کننده
DisplayName نام تأمین کننده
LastPurchaseCost آخرین قیمت خرید
LastPurchaseDate تاریخ آخرین خرید
Warehouse آرایه‌ای از موجودی کالا در همۀ انبارها
Code کد انبار
Quantity موجودی در انبار
Copyed
{
    "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
                }
            ]
        }
    ]
}
Copyed
URL:https://api.hesabfa.com/v1/item/UpdateOpeningQuantity

پارامترها :

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

* فیلدهای ستاره‌دار الزامی هستند.

*code کد کالا
*quantity تعداد (باید بزرگتر از صفر باشد)
*unitPrice مبلغ واحد (باید بزرگتر از صفر باشد)
warehouseCode کد انبار
Copyed
{
    "apiKey": "your-api-key",
    "loginToken": "your-login-token",
    "items": [
        {
            "code": "000001",
            "quantity": 3,
            "unitPrice": 250000,
            "warehouseCode": 12
        },
        {
            "code": "000002",
            "quantity": 5,
            "unitPrice": 378000
        }
    ]
}
Copyed
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
        }
    ]
}'
Copyed
<?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);
Copyed
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);
    });
Copyed
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)
Copyed
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);
نکات ضروری
  1. با فراخوانی این متد، موجودی اول دورۀ کالاها در تراز افتتاحیه ثبت و سند افتتاحیه متناسب با آن ویرایش می‌شود. پیش از فراخوانی این متد، مطمئن شوید که سهامداران در حسابفا تعریف شده‌اند.
  2. انجام این عمل تنها در اولین سال مالی ممکن است.
  3. فقط موجودی کالاهای ارسال‌شده به‌روزرسانی می‌شود و موجودی کالاهای دیگری که در تراز افتتاحیه ثبت شده‌اند، تغییر نمی‌کند.
  4. تعداد و قیمت واحد باید بزرگ‌تر از صفر باشند؛ در غیر این صورت، ثبت نمی‌شوند.
  5. این متد را فقط در ابتدای سال مالی فراخوانی کنید؛ فراخوانی آن در میانۀ سال مالی، موجودی سیستم را دچار اختلال می‌کند.

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

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