POST /v2/accounting/preference

Route Info

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

این API برای ثبت نگاشت‌های حسابداری در جدول mapping_accounting_preferences استفاده می‌شود. ورودی به‌صورت مجموعه‌ای از آیتم‌ها در فیلد items ارسال می‌شود. برای هر آیتم:

در انتها، اگر هیچ خطایی وجود نداشته باشد، همه رکوردهای جدید به صورت Batch درج می‌شوند.

ورودی مورد نیاز (JSON Body)

ساختار کلی:

{
  "branch": 1,
  "items": [
    {
      "id": "customer-24",
      "text": "24 - مشتری عمده",
      "code": "110201"
    },
    {
      "id": "office-3",
      "text": "301 - دفتر مرکزی",
      "code": "880030"
    }
  ]
}

جزئیات فیلدها:

ساختاردهی رکورد درج‌شونده

برای هر آیتم غیرتکراری:

پاسخ موفق (Success Response)

در صورت عدم وجود خطا و انجام موفق درج:

{
  "payload": true,
  "error": false,
  "meta": {
    "timestamp": 1733056000
  }
}

پاسخ در صورت وجود خطا برای برخی آیتم‌ها

اگر بخشی از آیتم‌ها Duplicate باشند:

{
  "payload": true,
  "error": [
    {
      "message": "این کد قبلا ثبت شده است.",
      "code": "110201"
    }
  ],
  "meta": {
    "timestamp": 1733056000
  }
}

خطای عدم ارسال فیلد items

{
  "error": {
    "message": "The items field is required."
  },
  "meta": {
    "timestamp": 1733056000
  }
}

وابستگی دیتابیس

Meta