docs

docs/fanavaran/01-write-apis.md

@@ -1,6 +1,6 @@
 ---
 last_updated: 2026-08-08
-tags: [fanavaran, api, write, gen03, gen07, gen08, gen12]
+tags: [fanavaran, api, write, gen03, gen07, gen08, gen12, gen44]
 source: fanavaran-module-docs
 ---
 
@@ -115,7 +115,8 @@ Full shape: see skill reference sample and `buildFanavaranSubmitPayload` / `appl
 
 ### Validation (YARA)
 
-- Only `THIRD_PARTY` claims (not `CAR_BODY`)
+- `THIRD_PARTY` → `third-party-car-financial-claims`; `CAR_BODY` → `vehicle-hull-claims`
+- Hull skips `dmg-cases` (resource does not exist)
 - `PolicyId` required on submit (`requirePolicyId: true`)
 - Skip if local `claimId` / `claimNo` already set
 - `EstimateAmount` normalized to positive
@@ -215,6 +216,26 @@ After local `SELECT_OUTER_PARTS` — before image upload.
 
 Manual: `POST /v2/fanavaran/{client}/claim-cases/{id}/damage-case/submit`.
 
+If `DriverId` is still missing, submit registers the damaged party with GEN.44 first (see below). Preview only warns.
+
+---
+
+## 4.1 GEN.44 — Other people (unknown person)
+
+Doc: `CMN.GENR.APIH.GEN.44`
+
+| Item | Value |
+|------|-------|
+| نام عملیات | ثبت سایر اشخاص |
+| Endpoint | `POST /Api/BimeApi/v2.0/common/other-people` |
+| Method | `POST` |
+
+Also: `GET/PUT .../common/other-people/{Id}`. Local GET: `GET /lookups/other-people/:personId`.
+
+Used when parties inquiry has no row for the damaged party. Iranian create needs national code + Jalali birth date; Fanavaran fills name/gender from ثبت احوال. Lookup ids: `CityId`, `GenderId`, `IsIranian` (`ans`), `PersonKindId`, `NationalityId`, `MaritalStatus`.
+
+YARA: `registerFanavaranOtherPerson` during damage-case submit. Store `Id` as `driverId` / `otherPersonId`. Best-effort; do not create on preview; do not block the local claim flow.
+
 ---
 
 ## 5. GEN.07 — Attachments