> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # إنشاء تقرير FIU من الحالة عبر API > إنشاء مسودة تقرير SAR أو STR أو CTR أو تقرير FIU آخر من حالة في Didit، تُملأ تلقائياً من القالب والمعاملات وبيانات الموضوع. موجّه API لإنشاء تقرير من حالة نسخ الموجّه إلى الحافظة \

\`Create a draft FIU report from a case through the Management API.

Endpoint:
POST https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/regulatory-reports/

Authentication:
Use the x-api-key header with my Didit API key.

Request body (all optional if a template is given):
\{
"template": "",   // seeds rentity_id, submission_code, currency_code_local, etc.
"report_type": "SAR",                     // required if no template
"jurisdiction": "US",                     // required if no template
"transactions": [""]    // optional - defaults to the case's linked transactions
}

Behavior:
\- Draft is auto-populated from the template (if given) plus the case's subject, linked transactions, and a narrative structured around the five Ws (who/what/when/where/why/how) for SAR/STR/TFR.
\- Status starts as DRAFT. Call validate then finalize next.

Example call:
curl -X POST "https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/regulatory-reports/" \
-H "x-api-key: YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"template": ""}'

Response 201: RegulatoryReportDetail with status "DRAFT".

Failure modes:
\- 400 - the referenced template was not found.
\- 401/403 - auth/permission errors (requires write:cases).

For the full integration shape, see /integration/integration-prompt.`

\
الصق في أنشئ مسودة تقرير مرتبطة بحالة. فضّل استخدام هذا بدلاً من endpoint الإنشاء المستقل عندما تكون قد فتحت الحالة بالفعل، إذ يمكنه الاستغناء عن `template` واشتقاق `report_type` و`jurisdiction` مباشرة.## ذات صلة- [قائمة التقارير](https://docs.didit.me/ar/management-api/regulatory-reports/list.md) - [التحقق من التقرير](https://docs.didit.me/ar/management-api/regulatory-reports/validate.md) - [إتمام التقرير](https://docs.didit.me/ar/management-api/regulatory-reports/finalize.md) - [حذف التقرير](https://docs.didit.me/ar/management-api/regulatory-reports/delete.md) ## OpenAPI ````yaml ar/openapi-25.json POST /v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/regulatory-reports/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API التحقق من الهوية. قم بالمصادقة باستخدام الرأس x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/regulatory-reports/: post: tags: - Regulatory Reports summary: إنشاء تقرير من حالة description: >- أنشئ مسودة تقرير وحدة الاستخبارات المالية (FIU) للحالة: بحالة DRAFT، ومملوءة تلقائياً من القالب الاختياري بالإضافة إلى موضوع الحالة والمعاملات المرتبطة والسرد. تحقق من صحة التقرير ثم أنهِ التقرير لإنشاء ملفي goAML XML وPDF. operationId: create_case_regulatory_report parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: UUID الخاص بالمؤسسة. - name: application_id in: path required: true schema: type: string format: uuid description: معرّف UUID للتطبيق. - name: case_uuid in: path required: true schema: type: string format: uuid example: c1a5e000-0000-4000-8000-000000000001 description: معرّف الحالة UUID. requestBody: required: false content: application/json: schema: type: object properties: report_type: type: string enum: - SAR - STR - CTR - TTR - UTR - IFT - CBR - TFR description: >- مطلوب ما لم يتم تحديد قالب؛ يُستخدم report_type الخاص بالقالب في حال عدم تحديده. jurisdiction: type: string minLength: 2 maxLength: 2 description: مطلوب ما لم يتم تحديد قالب. template: type: string format: uuid nullable: true description: >- معرّف UUID لقالب التقرير؛ يقوم field_config الخاص به بتهيئة المسودة قبل دمج البيانات المستمدة من الحالة. transactions: type: array items: type: string format: uuid nullable: true description: >- المعاملات المراد إرفاقها؛ القيمة الافتراضية هي المعاملات المرتبطة بالحالة. rentity_id: type: string nullable: true rentity_branch: type: string nullable: true submission_code: type: string enum: - E - M default: E entity_reference: type: string nullable: true fiu_ref_number: type: string nullable: true currency_code_local: type: string minLength: 3 maxLength: 3 nullable: true submission_date: type: string format: date-time nullable: true reporting_person: type: object location: type: object reason: type: string nullable: true action: type: string nullable: true activity: type: string nullable: true narrative: type: object properties: who: type: string what: type: string when: type: string where: type: string why: type: string how: type: string report_indicators: type: array items: type: string included_fields: type: array items: type: string example: template: 7ec00000-0000-4000-8000-000000000006 responses: '201': description: تم إنشاء مسودة التقرير. content: application/json: schema: $ref: '#/components/schemas/RegulatoryReportDetail' '400': description: لم يتم العثور على القالب المشار إليه. content: application/json: schema: type: object properties: detail: type: string security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X POST 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/cases/c1a5e000-0000-4000-8000-000000000001/regulatory-reports/' \ -H 'x-api-key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"template": "7ec00000-0000-4000-8000-000000000006"}' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID # and DIDIT_APPLICATION_ID. client = Didit() result = client.cases.regulatory_reports.create( "c1a5e000-0000-4000-8000-000000000001", template="7ec00000-0000-4000-8000-000000000006", ) print(result) - lang: javascript label: Node.js source: >- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. const didit = new Didit(); const result = await didit.cases.regulatoryReports.create("c1a5e000-0000-4000-8000-000000000001", { template: "7ec00000-0000-4000-8000-000000000006", }); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID\n// and DIDIT_APPLICATION_ID.\nclient := didit.NewClient()\n\nresult, err := client.Cases.RegulatoryReports.Create(ctx, \"c1a5e000-0000-4000-8000-000000000001\", didit.CasesRegulatoryReportsCreateParams{\n\tTemplate: didit.String(\"7ec00000-0000-4000-8000-000000000006\"),\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import me.didit.Didit; import me.didit.types.CasesRegulatoryReportsCreateParams; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. Didit client = new Didit(); var result = client.cases().regulatoryReports().create("c1a5e000-0000-4000-8000-000000000001", CasesRegulatoryReportsCreateParams.builder() .template("7ec00000-0000-4000-8000-000000000006") .build()); System.out.println(result); - lang: php label: PHP source: >- cases->regulatoryReports->create('c1a5e000-0000-4000-8000-000000000001', [ 'template' => '7ec00000-0000-4000-8000-000000000006', ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID # and DIDIT_APPLICATION_ID. didit = Didit::Client.new result = didit.cases.regulatory_reports.create( "c1a5e000-0000-4000-8000-000000000001", template: "7ec00000-0000-4000-8000-000000000006" ) puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. using var client = new DiditClient(); var result = await client.Cases.RegulatoryReports.CreateAsync("c1a5e000-0000-4000-8000-000000000001", new CasesRegulatoryReportsCreateParams { Template = "7ec00000-0000-4000-8000-000000000006", }); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: RegulatoryReportDetail: type: object properties: uuid: type: string format: uuid case_uuid: type: string format: uuid case_number: type: string nullable: true report_type: type: string enum: - SAR - STR - CTR - TTR - UTR - IFT - CBR - TFR report_type_display: type: string report_code: type: string description: رمز تقرير goAML المشتق من report_type، مثل STR، وCTR، وBCR. report_number: type: string nullable: true status: type: string enum: - DRAFT - VALIDATED - FINALIZED status_display: type: string jurisdiction: type: string minLength: 2 maxLength: 2 rentity_id: type: string nullable: true description: معرّف الجهة المُبلِغة الصادر عن وحدة الاستخبارات المالية (FIU). rentity_branch: type: string nullable: true submission_code: type: string enum: - E - M entity_reference: type: string nullable: true fiu_ref_number: type: string nullable: true currency_code_local: type: string minLength: 3 maxLength: 3 nullable: true submission_date: type: string format: date-time nullable: true reporting_person: type: object location: type: object reason: type: string nullable: true action: type: string nullable: true activity: type: string nullable: true narrative: type: object description: أقسام السرد للأسئلة الخمسة (Five Ws). properties: who: type: string what: type: string when: type: string where: type: string why: type: string how: type: string report_indicators: type: array items: type: string included_fields: type: array items: type: string transactions: type: array items: type: string format: uuid validation_errors: type: array description: نتيجة آخر عملية تحقق من الصحة؛ كل إدخال هو كائن {field, message}. items: type: object properties: field: type: string message: type: string validated_at: type: string format: date-time nullable: true finalized_at: type: string format: date-time nullable: true created_by_email: type: string nullable: true created_by_name: type: string nullable: true created_at: type: string format: date-time updated_at: type: string format: date-time securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- مفتاح API الخاص بتطبيقك، من Developers -> API keys في Business Console. يمتلك المفتاح الأساسي وصولاً كاملاً. يمكن تحديد نطاق المفتاح المسمى: لا شيء، أو قراءة، أو كتابة لكل مورد، ومحدوداً ببعض مسارات العمل أو بالجلسات المقبولة، وبقائمة من عناوين IP، وبتاريخ انتهاء الصلاحية. يشير 401 إلى أن المفتاح غير صحيح أو ملغى أو منتهي الصلاحية؛ ويشير 403 إلى أنه لم يتم إرسال أي مفتاح، أو أن المفتاح ليس لديه حق الوصول إلى هذا المورد أو الإجراء، أو أن الطلب جاء من عنوان خارج قائمة عناوين IP الخاصة به؛ ويشير 404 في مسار جلسة إلى أن الجلسة خارج مسارات العمل أو الحالات الخاصة بالمفتاح. يتلقى المفتاح الذي لا يمتلك حق الوصول إلى الوسائط عناوين URL للصور ومقاطع الفيديو وملفات PDF كـ null، ويتلقى المفتاح الذي لا يمتلك إذن كتابة للجلسات روابط الجلسة وtoken كـ null. راجع https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.