POST /v2/manual-document/preferences/list/details

Route Info

شرح عملکرد (Functionality)

این مسیر برای دریافت جزئیات کامل معین (Moeen) و تفصیل (Preference) استفاده می‌شود. ورودی شامل آرایه‌ای از رکوردها است که هر کدام شامل:

این متد با منطق زیر کار می‌کند:

پارامترهای ورودی (JSON Body)

Body:

{
  "data": [
    {
      "moeen": "110203",
      "preference": 120000145
    }
  ],
  "branch": 1
}

خروجی موفق (Success Response)

در صورت موفقیت، خروجی شامل آرایه‌ای از آیتم‌های پردازش شده:

{
  "items": [
    {
      "moeen": {
        "id": 25,
        "serialId": 25,
        "details": {
          "aggregation": 1
        },
        "code": "110203",
        "text": "110203 - فروش | فروش داخلی"
      },
      "preference": {
        "id": "title-15",
        "code": 120000145,
        "table": "title",
        "text": "هزینه تعمیرات",
        "financial": false
      }
    }
  ],
  "meta": {
    "timestamp": 1718453500
  }
}

خطاهای اعتبارسنجی (Error Response 422)

اگر هر بخش از گروه، کل یا معین وجود نداشته باشد:

{
  "error": {
    "code": 1000,
    "message": "گروه حسابداری با کد 11 در معین 110203 وجود ندارد"
  },
  "meta": {
    "timestamp": 1718453500
  }
}

اگر تفصیل وجود نداشته باشد:

{
  "error": {
    "code": 1000,
    "message": "تفصیل با کد 120000999 وجود ندارد"
  },
  "meta": {
    "timestamp": 1718453500
  }
}

ساختار استخراج کد معین (Moeen Code Structure)

برای هر کد ۶ رقمی مثلاً 110203:

این ۳ بخش به‌ترتیب روی جداول زیر اعتبارسنجی می‌شوند:

تشخیص نوع تفصیل بر اساس ۲ رقم اول کد

نمونه خروجی تفصیل برای انواع مختلف

1 — Bank Account (prefix 10)

{
  "id": "account-12",
  "code": 100000532,
  "text": "بانک ملت شعبه مرکزی (1234567890)"
}

2 — Personnel (prefix 13)

{
  "id": "personnel-88",
  "code": 130001234,
  "text": "مهدی احمدی"
}

3 — Office (prefix 30)

{
  "id": "office-7",
  "code": 300000215,
  "text": "مرکز هزینه اداره مرکزی"
}

Meta

تمام پاسخ‌ها شامل: