# RESOURCE /v2/cartable/recipients

<div class="api-docs" id="bkmrk-">  <div class="endpoint-section">  
</div></div>## Department Recipients Management Logic

این کنترلر وظیفه مدیریت لیست "گیرندگان" (`recipients`) را در سطح دپارتمان‌ها بر عهده دارد.   
این جدول (`cartable\_department\_recipients`) عناوین شغلی یا واحدهایی را نگهداری می‌کند که در یک شعبه و دپارتمان خاص مجاز به دریافت نامه هستند (مانند: "دبیرخانه"، "مدیریت مالی" و ...).

<div class="api-docs" id="bkmrk-define-recipient-tit"><div class="endpoint-section"><div class="flowchart"><div class="flow-item">Define Recipient Title</div><div class="flow-arrow">↓</div><div class="flow-item-process" style="background-color: #e8f5e9;">**Link to Branch &amp; Department**  
(e.g. Branch: 100, Dept: 5, Title: "Secretariat")</div><div class="flow-arrow">↓</div><div class="flow-item-success">Saved in `cartable_department_recipients`</div></div></div>  
---

  </div># List Recipients

دریافت لیست تمام گیرندگان تعریف شده. این لیست بر اساس تاریخ ایجاد (نزولی) مرتب شده است.

<div class="api-docs" id="bkmrk-url%3A-%2Fv2%2Fcartable%2Fre"><div class="endpoint-info"><div>**URL:** `/v2/cartable/recipients`</div><div>**Method:** <span class="method-get">GET</span></div><div>**Controller:** RecipientController@index</div></div></div>### Query Parameters

<div class="api-docs" id="bkmrk-parameter-type-descr"><table class="schema-table" dir="rtl"><thead><tr><th>Parameter</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td dir="ltr">department</td><td>Integer</td><td>(اختیاری) فیلتر بر اساس شناسه دپارتمان.</td></tr><tr><td dir="ltr">status</td><td>Integer</td><td>(اختیاری) فیلتر بر اساس وضعیت فعال/غیرفعال بودن (در صورتی که در دیتابیس این فیلد پر شده باشد).</td></tr></tbody></table>

</div>### Response Structure

```json
{
    "items": [
        {
            "id": 10,
            "department": 5,
            "branch": 101,
            "title": "دبیرخانه مرکزی",
            "created_at": "...",
            "updated_at": "..."
        }
    ],
    "meta": { "timestamp": 1733762000 }
}
```

<div class="api-docs" id="bkmrk--1">---

  </div># Create Recipient

تعریف یک گیرنده جدید برای یک شعبه و دپارتمان خاص.

<div class="api-docs" id="bkmrk-url%3A-%2Fv2%2Fcartable%2Fre-1"><div class="endpoint-info"><div>**URL:** `/v2/cartable/recipients`</div><div>**Method:** <span class="method-post">POST</span></div><div>**Controller:** RecipientController@store</div></div></div>### Body Parameters

<div class="api-docs" id="bkmrk-parameter-type-descr-1"><table class="schema-table" dir="rtl"><thead><tr><th>Parameter</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td dir="ltr">department</td><td>Integer</td><td>(الزامی) شناسه دپارتمان مربوطه.</td></tr><tr><td dir="ltr">branch</td><td>Integer</td><td>(الزامی) شناسه شعبه.</td></tr><tr><td dir="ltr">title</td><td>String</td><td>(الزامی) عنوان گیرنده (مثلاً: "حسابداری").</td></tr></tbody></table>

</div>### Success Response

```json
{
    "payload": {
        "id": 12,
        "department": 5,
        "branch": 101,
        "title": "حسابداری",
        "created_at": "...",
        "updated_at": "..."
    },
    "meta": { "timestamp": 1733762000 }
}
```

<div class="api-docs" id="bkmrk--2">---

  </div># Show Recipient Details

مشاهده جزئیات یک گیرنده خاص.

<div class="api-docs" id="bkmrk-url%3A-%2Fv2%2Fcartable%2Fre-2"><div class="endpoint-info"><div>**URL:** `/v2/cartable/recipients/{id}`</div><div>**Method:** <span class="method-get">GET</span></div><div>**Controller:** RecipientController@show</div></div></div>### Response Structure

```json
{
    "payload": {
        "id": 12,
        "department": 5,
        "branch": 101,
        "title": "حسابداری",
        "created_at": "...",
        "updated_at": "..."
    },
    "meta": { "timestamp": 1733762000 }
}
```

<div class="api-docs" id="bkmrk--3">---

  </div># Update Recipient

ویرایش اطلاعات گیرنده.   
**نکته مهم:** طبق منطق کد، فیلد `branch` در متد Update قابل تغییر نیست و فقط `department` و `title` بروزرسانی می‌شوند.

<div class="api-docs" id="bkmrk-url%3A-%2Fv2%2Fcartable%2Fre-3"><div class="endpoint-info"><div>**URL:** `/v2/cartable/recipients/{id}`</div><div>**Method:** <span class="method-put">PUT</span> / <span class="method-patch">PATCH</span></div><div>**Controller:** RecipientController@update</div></div></div>### Body Parameters

<div class="api-docs" id="bkmrk-parameter-type-descr-2"><table class="schema-table" dir="rtl"><thead><tr><th>Parameter</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td dir="ltr">department</td><td>Integer</td><td>شناسه دپارتمان جدید.</td></tr><tr><td dir="ltr">title</td><td>String</td><td>عنوان جدید.</td></tr></tbody></table>

</div>### Success Response

```json
{
    "payload": {
        "id": 12,
        "department": 6, // Changed
        "branch": 101,
        "title": "حسابداری ارشد", // Changed
        "created_at": "...",
        "updated_at": "..."
    },
    "meta": { "timestamp": 1733762000 }
}
```

<div class="api-docs" id="bkmrk--4">---

  </div># Delete Recipient

حذف فیزیکی (Hard Delete) یک گیرنده از سیستم.

<div class="api-docs" id="bkmrk-url%3A-%2Fv2%2Fcartable%2Fre-4"><div class="endpoint-info"><div>**URL:** `/v2/cartable/recipients/{id}`</div><div>**Method:** <span class="method-delete">DELETE</span></div><div>**Controller:** RecipientController@destroy</div></div></div>### Success Response

```json
{
    "payload": 1, // تعداد رکوردهای حذف شده
    "meta": { "timestamp": 1733762000 }
}
```