--- title: إنشاء عملية مستند description: التقاط مستند جديد أو إعادة استخدام مستند ملتقط مسبقاً مرتبط بعملية بيومترية. canonical: https://developer.unico.io/ar/dual-api/developers/api-reference/api/post-processes-document locale: ar generated_by: markdown-export --- - [/ar/](/ar/) - [مرجع API](/ar/dual-api/developers/api-reference/) - [API](/ar/dual-api/developers/api-reference/api/) - إنشاء عملية مستند **في هذه الصفحة# إنشاء عملية مستند تتعامل هذه النقطة النهائية مع تدفقَين للمستند يشتركان في نفس المسار لكنهما يختلفان في معاملات الجسم: **التقاط جديد** — يُرسل صور المستند بصيغة base64 للمعالجة (يُشترط وجود `document.files`). **إعادة الاستخدام** — يتخطى الالتقاط بالإشارة إلى مستند ملتقط مسبقاً (يُشترط وجود `document.documentId`). يتحدد التدفق النشط بناءً على ما إذا كان `document.documentId` موجوداً في جسم الطلب. قبل إنشاء عملية مستند، استخدم [الحصول على المستندات القابلة لإعادة الاستخدام](/ar/dual-api/developers/api-reference/api/get-document) للتحقق مما إذا كان المستخدم لديه بالفعل مستند متاح لإعادة الاستخدام. للاطلاع على تدفق التكامل الكامل، راجع [نظرة عامة على API](/ar/dual-api/developers/api-reference/api/). ### نقطة النهاية​ البيئةالرابط**الإنتاج**`POST https://api.id.unico.app/processes/v1`**بيئة الاختبار**`POST https://api.id.uat.unico.app/processes/v1` ### الطلب​ الترويسات الترويسةالقيمة`Authorization``Bearer ` (انظر [المصادقة](/ar/dual-api/developers/api-reference/authentication))`APIKEY`مفتاح API المُزوَّد مع تفعيل ميزتي التقاط المستند وإعادة استخدامه.`Content-Type``application/json` معاملات الجسم التقاط جديدإعادة الاستخدامالحقلالنوعمطلوبالوصف`subject.duiType`integerنعممعرّف نوع الوثيقة. انظر [قيم `duiType`](#duitype-values) أدناه.`subject.code`stringنعمقيمة معرّف المستخدم كما هو محدد في `subject.duiType`. بدون نقاط أو شرطات.`subject.name`stringلاالاسم الكامل.`subject.gender`stringلا`M` أو `F`.`subject.birthDate`string (ISO 8601)لاتاريخ الميلاد (`YYYY-MM-DD`).`subject.email`stringلاعنوان البريد الإلكتروني.`subject.phone`stringلارقم هاتف بتنسيق E.164.`document.purpose`stringنعمالغرض التجاري. القيم: `creditprocess`، `carpurchase`، `paybypaycheck`، `onboarding`، `fgts`.`document.authProcessId`stringنعممعرّف العملية البيومترية المرتبطة بالتقاط هذا المستند.`document.files`arrayنعمصور المستند بصيغة base64 (وجه أمامي و/أو خلفي).`document.files[].data`stringنعمصورة المستند بصيغة base64 (PNG أو JPEG أو WebP، بحد أقصى 800 كيلوبايت).`subsidiaryId`stringلامعرّف الفرع — مطلوب فقط إذا كانت هناك فروع متعددة.الحقلالنوعمطلوبالوصف`subject.duiType`integerنعممعرّف نوع الوثيقة. انظر [قيم `duiType`](#duitype-values) أدناه.`subject.code`stringنعمقيمة معرّف المستخدم كما هو محدد في `subject.duiType`. بدون نقاط أو شرطات.`subject.name`stringلاالاسم الكامل.`subject.gender`stringلا`M` أو `F`.`subject.birthDate`string (ISO 8601)لاتاريخ الميلاد (`YYYY-MM-DD`).`subject.email`stringلاعنوان البريد الإلكتروني.`subject.phone`stringلارقم هاتف بتنسيق E.164.`document.purpose`stringنعمالغرض التجاري. القيم: `creditprocess`، `carpurchase`، `paybypaycheck`، `onboarding`، `fgts`.`document.authProcessId`stringنعممعرّف العملية البيومترية المرتبطة بهذا المستند.`document.documentId`stringنعممعرّف مستند ملتقط مسبقاً (يُحصل عليه من [الحصول على المستندات القابلة لإعادة الاستخدام](/ar/dual-api/developers/api-reference/api/get-document)). عند توفره يمكن حذف `document.files`.`subsidiaryId`stringلامعرّف الفرع — مطلوب فقط إذا كانت هناك فروع متعددة. **قيم `duiType`**الدولةالرمزالوصفAR6جواز سفر أرجنتينيAR7DNI الأرجنتينيAR49رخصة القيادة الأرجنتينية (Licencia Nacional de Conducir)AT34الرقم الضريبي النمساوي (STNR)BE36الرقم الوطني البلجيكي (NN)BR1CPF البرازيليBR5جواز سفر برازيليBR14CNPJ البرازيليCA28SIN الكنديCH33رقم AHV/AVS السويسريCL9RUN التشيليCL52جواز سفر تشيليCL57رخصة القيادة التشيلية (Licencia de Conducir)CO26NIT الكولومبيCO53جواز سفر كولومبيCO55رخصة القيادة الكولومبية (Licencia de Conducción)CO56بطاقة المواطنة الكولومبية (Cédula de Ciudadanía)DE41رقم التعريف الضريبي الألماني (IdNr)DK29CPR الدنماركيEC10NI الإكوادوريES50رقم هوية الأجانب الإسباني (NIE)ES51وثيقة الهوية الوطنية الإسبانية (DNI)FI35رمز الهوية الشخصية الفنلندي (HETU)FR46الرقم الضريبي المرجعي الفرنسي (SPI)GB30رقم التأمين الوطني البريطاني (NINO)GT12CUI الغواتيماليID16NIK الإندونيسيIE47رقم الخدمة العامة الشخصي الأيرلندي (PPSN)IT37Codice Fiscale الإيطالي (CF)LU48رقم الهوية الوطني اللوكسمبورغي (Matricule)MX2CURP المكسيكيMX25RFC المكسيكي (شخص طبيعي)MX58رخصة القيادة المكسيكية (Licencia de Conducir)NG8NIN النيجيريNG20رقم التحقق المصرفي النيجيري (BVN)NG43رمز BVN النيجيري (مُجزّأ)NG44رمز NIN النيجيري (مُجزّأ)NL42رقم خدمة المواطن الهولندي (BSN)NO39رقم الهوية الوطني النرويجي (Fødselsnummer)PE27RUC البيروفيPE40DNI البيروفيPE54جواز سفر بيروفيPL31PESEL البولنديPT45رقم التعريف الضريبي البرتغالي (NIF)SE32الرقم الشخصي السويدي (PNR)SE38الرقم التنسيقي السويدي (Samordningsnummer)TR24رقم الهوية التركي (TCKN)US4SSN الأمريكيUS11جواز سفر أمريكيUS18رخصة قيادة أمريكيةUS21بطاقة جواز سفر أمريكيةUS22جواز سفر أمريكي مصنوع من البولي كاربوناتUS23بطاقة هوية أمريكيةUY13CI الأوروغويانيZZ15عنوان البريد الإلكترونيZZ17رقم الهاتف—0غير محدد—3معرّف Unico الداخلي ### مثال​ التقاط جديد — cURLالتقاط جديد — Node.jsإعادة الاستخدام — cURLإعادة الاستخدام — Node.js``` curl -X POST https://api.id.unico.app/processes/v1 \ -H "Authorization: Bearer $TOKEN" \ -H "APIKEY: $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "subject": { "duiType": 1, "code": "12345678909", "name": "Luke Skywalker" }, "document": { "purpose": "onboarding", "authProcessId": "80371b2a-3ac7-432e-866d-57fe37896ac6", "files": [ { "data": "/9j/4AAQSkZJR..." } ] } }' ``` ``` import fetch from 'node-fetch';const res = await fetch('https://api.id.unico.app/processes/v1', { method: 'POST', headers: { 'Authorization': `Bearer ${process.env.UNICO_ACCESS_TOKEN}`, 'APIKEY': process.env.UNICO_API_KEY, 'Content-Type': 'application/json' }, body: JSON.stringify({ subject: { duiType: 1, code: '12345678909', name: 'Luke Skywalker' }, document: { purpose: 'onboarding', authProcessId: '80371b2a-3ac7-432e-866d-57fe37896ac6', files: [{ data: documentImageBase64 }] } })});const result = await res.json(); ``` ``` curl -X POST https://api.id.unico.app/processes/v1 \ -H "Authorization: Bearer $TOKEN" \ -H "APIKEY: $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "subject": { "duiType": 1, "code": "12345678909" }, "document": { "purpose": "onboarding", "authProcessId": "80371b2a-3ac7-432e-866d-57fe37896ac6", "documentId": "doc-abc-123" } }' ``` ``` import fetch from 'node-fetch';const res = await fetch('https://api.id.unico.app/processes/v1', { method: 'POST', headers: { 'Authorization': `Bearer ${process.env.UNICO_ACCESS_TOKEN}`, 'APIKEY': process.env.UNICO_API_KEY, 'Content-Type': 'application/json' }, body: JSON.stringify({ subject: { duiType: 1, code: '12345678909' }, document: { purpose: 'onboarding', authProcessId: '80371b2a-3ac7-432e-866d-57fe37896ac6', documentId: 'doc-abc-123' } })});const result = await res.json(); ``` ### الاستجابات​ 200 OK ``` { "id": "80371b2a-3ac7-432e-866d-57fe37896ac6", "status": 3, "document": { "id": "doc-abc-123", "type": "unico.moja.dictionary.br.cnh.v2.Cnh", "cpfMatch": true, "faceMatch": true, "content": { "numero": "12345678", "nomeCivil": "Luke Skywalker", "dataNascimento": "2000-05-20T00:00:00Z", "categoria": "B", "dataExpiracao": "2030-05-20T00:00:00Z" }, "fileUrls": [ "https://storage.unico.app/documents/doc-abc-123/front.jpg" ] }} ``` الحقلالنوعالوصف`id`string (UUID)معرّف العملية.`status`integer`3` (اكتمل بنجاح)، `5` (اكتمل بفشل).`document.id`stringمعرّف المستند الملتقط. استخدم هذه القيمة في طلبات `document.documentId` المستقبلية لإعادة الاستخدام.`document.type`stringنوع المستند المُعرَّف، كاسم قاموس مؤهَّل بالكامل. انظر [قيم `document.type`](#document-type-values) أدناه.`document.cpfMatch`boolean`true` إذا تطابق المعرّف المستخرج من المستند مع `subject.code`.`document.faceMatch`boolean`true` إذا تطابق وجه المستند مع السيلفي البيومتري من `document.authProcessId`.`document.content`objectالحقول المستخرجة عبر OCR. يختلف الهيكل باختلاف نوع المستند — [انقر هنا لتفاصيل الحقول](/ar/assets/files/document-content-fields-0e4663f2ade946e901bbc7523c21f032.json).`document.fileUrls`arrayروابط مؤقتة (صالحة لمدة 10 دقائق) لتنزيل صور المستند. لا تظهر في `document.content` إلا الحقول المستخرجة بنجاح؛ وأي حقل لم يتمكن OCR من قراءته يُحذف بدلاً من إعادته فارغاً. **قيم `document.type`**المخطط الموحّدجميع أنواع المستندات التي تستخدم المخطط الموحّد — `unified_schema` في [مرجع الحقول](/ar/assets/files/document-content-fields-0e4663f2ade946e901bbc7523c21f032.json) — تُعاد في `document.type` بالشكل `unico.moja.dictionary..generic.v1.`، حيث `` هو رمز ISO 3166-1 alpha-2 بأحرف صغيرة و`` هو النوع المُعرَّف. على سبيل المثال: `unico.moja.dictionary.ar.generic.v1.IdCard`: بطاقة الهوية الأرجنتينية `unico.moja.dictionary.us.generic.v1.PolycarbonatePassport`: جواز سفر أمريكي من البولي كربونات المخططات الخاصةأنواع المستندات التي تستخدم مخطط حقول خاصًا بها — المدرجة ضمن `specific_document_schemas` في [مرجع الحقول](/ar/assets/files/document-content-fields-0e4663f2ade946e901bbc7523c21f032.json) — مبيّنة في الجدول أدناه:الدولةالقيمةالمستندBR`unico.moja.dictionary.br.rg.v2.Rg`RGBR`unico.moja.dictionary.br.cnh.v2.Cnh`CNH (رخصة القيادة)BR`unico.moja.dictionary.br.cin.v1.Cin`CINBR`unico.moja.dictionary.br.passaporte.v1.Passaporte`جواز السفرMX`unico.moja.dictionary.mx.ine.v1.Ine`بطاقة الناخب INEMX`unico.moja.dictionary.mx.lpc.v1.Lpc`Licencia para conducir (رخصة القيادة)MX`unico.moja.dictionary.mx.pasaporte.v1.Pasaporte`جواز السفر—`unico.moja.dictionary.other.unknown.v1.Unknown`تعذّر تحديد النوع — `document.content` فارغلا يتم إجراء أي استخراج OCR ولا يتم الإبلاغ عن أي حقل عندما يكون `document.type` هو `unico.moja.dictionary.other.unknown.v1.Unknown`. ### رموز الخطأ​ 400 Bad Request403 Forbidden409 Conflict500 Internal Server Errorالرمزالرسالةالوصف`99989`The document is invalid.كائن `document` يحتوي على هيكل غير صالح.`99988`The document is empty.كائن `document` مفقود من جسم الطلب.`20900`O base64 informado não é válido.معامل base64 غير صالح. الأسباب المحتملة: ليست صورة أو محاولة حقن.`20807`A imagem precisa estar no padrão HD ou possuir uma resolução superior a 640 x 480.دقة الصورة المرفوعة منخفضة جداً.`20509`The subject.name field is invalid.`subject.name` يحتوي على أحرف غير صالحة.`20508`The subject.gender field is invalid.يجب أن يكون `subject.gender` إما `M` أو `F`.`20507`O parâmetro subject.code é inválido.قيمة المعرّف غير قياسية أو غير موجودة.`20506`O base64 informado é muito grande. O tamanho máximo suportado é até 800kb.حجم الصورة يتجاوز 800 كيلوبايت؛ اضغط بصيغة JPEG92.`20505`O base64 informado não é suportado. Os formatos aceitos são png, jpeg e webp.تنسيق base64 غير صالح أو غير مدعوم.`20068`The document.documentId or document.files parameter must be present.لم يتم توفير `document.documentId` ولا `document.files`.`20067`The document.purpose parameter is invalid.قيمة غير معروفة في `document.purpose`.`20066`The document.authProcessId parameter is invalid.قيمة غير صالحة في `document.authProcessId`.`20062`The useCase field is invalid.قيمة غير معروفة في حقل `useCase`.`20021`The subject.phone field is invalid.تنسيق `subject.phone` غير صالح (رمز الاتصال الدولي + رمز المنطقة + الرقم، 13 رقماً).`20019`The subject.birthDate field is invalid.`subject.birthDate` خارج تنسيق ISO 8601 (`YYYY-MM-DD`).`20009`O parâmetro imagebase64 não foi informado.معامل صورة المستند مفقود.`20008`The subject.email field is invalid.تنسيق البريد الإلكتروني غير صالح في `subject.email`.`20005`O parâmetro subject.code não foi informado.معامل subject.code مفقود.`20004`O parâmetro subject não foi informado.معامل subject مفقود.`20003`The request body is missing or invalid.حمولة فارغة أو غير صالحة.`20002`O parâmetro APIKey não foi informado.معامل APIKEY مفقود من ترويسة الطلب.`20001`O parâmetro authtoken não foi informado.معامل رمز التكامل مفقود من ترويسة الطلب.`10508`The JWT with the captured face has already been used.لا يمكن استخدام JWT إلا مرة واحدة.`10507`The JWT with the captured face is expired.JWT منتهي الصلاحية؛ يجب إرساله خلال 10 دقائق.`10506`The imageBase64 field is not a valid JWT from SDK.`imageBase64` ليس JWT صالحاً صادراً عن SDK.رمز Bearer أو `APIKEY` مفقود أو منتهي الصلاحية أو غير صالح. انظر [المصادقة](/ar/dual-api/developers/api-reference/authentication).الرمزالرسالةالوصف`30017`User does not have permission to perform this action.JWT مشوه أو مستخدم لا يملك صلاحية تنفيذ هذه العملية.`10502`O token informado está expirado.رمز الوصول منتهي الصلاحية.`10501`O token informado é inválido.رمز المصادقة غير صالح.`10201`O AppKey informado é inválido.APIKEY غير صالح أو غير موجود.الرمزالرسالةالوصف`20073`The processID already exists.`processId` المُقدَّم موجود مسبقاً لهذا المستأجر.الرمزالرسالةالوصف`99999`Internal failure! Try again laterعند حدوث خطأ داخلي. ### الخطوات التالية​ للتحقق مما إذا كان المستند متاحاً قبل هذا الاستدعاء، انظر [الحصول على المستندات القابلة لإعادة الاستخدام](/ar/dual-api/developers/api-reference/api/get-document). لإنشاء عملية بيومترية (مطلوبة لـ `document.authProcessId`)، انظر [إنشاء عملية](/ar/dual-api/developers/api-reference/api/post-processes). آخر تحديث في 8 أكتوبر 2026**