CCrmDocumentContact::CreateDocument

static function CreateDocument($parentDocumentId, $arFields)
{
	if(!is_array($arFields))
	{
		throw new Exception("Entity fields must be array");
	}

	global $DB;
	$arDocumentID = self::GetDocumentInfo($parentDocumentId);
	if ($arDocumentID == false)
		$arDocumentID['TYPE'] = $parentDocumentId;

	$arDocumentFields = self::GetDocumentFields($arDocumentID['TYPE']);

	$arKeys = array_keys($arFields);
	foreach ($arKeys as $key)
	{
		if (!array_key_exists($key, $arDocumentFields))
		{
			//Fix for issue #40374
			unset($arFields[$key]);
			continue;
		}

		$fieldType = $arDocumentFields[$key]["Type"];
		if (in_array($fieldType, array("phone", "email", "im", "web"), true))
		{
			CCrmDocument::PrepareEntityMultiFields($arFields, mb_strtoupper($fieldType));
			continue;
		}

		$arFields[$key] = (is_array($arFields[$key]) && !CBPHelper::IsAssociativeArray($arFields[$key])) ? $arFields[$key] : array($arFields[$key]);
		if ($arDocumentFields[$key]["Type"] == "user")
		{
			$arFields[$key] = \CBPHelper::extractUsers($arFields[$key], $arDocumentID['DOCUMENT_TYPE']);
		}
		elseif ($fieldType == "select" && mb_substr($key, 0, 3) == "UF_")
		{
			self::InternalizeEnumerationField('CRM_CONTACT', $arFields, $key);
		}
		elseif ($fieldType == "file")
		{
			$arFileOptions = array('ENABLE_ID' => true);
			foreach ($arFields[$key] as &$value)
			{
				//Issue #40380. Secure URLs and file IDs are allowed.
				$file = false;
				CCrmFileProxy::TryResolveFile($value, $file, $arFileOptions);
				$value = $file;
			}
			unset($value);
		}
		elseif ($fieldType == "S:HTML")
		{
			foreach ($arFields[$key] as &$value)
			{
				$value = array("VALUE" => $value);
			}
			unset($value);
		}

		if (!$arDocumentFields[$key]["Multiple"] && is_array($arFields[$key]))
		{
			if (count($arFields[$key]) > 0)
			{
				$a = array_values($arFields[$key]);
				$arFields[$key] = $a[0];
			}
			else
			{
				$arFields[$key] = null;
			}
		}
	}

	if(isset($arFields['COMMENTS']))
	{
		$arFields['COMMENTS'] = static::sanitizeCommentsValue($arFields['COMMENTS']);
	}

	$useTransaction = static::shouldUseTransaction();

	if ($useTransaction)
	{
		$DB->StartTransaction();
	}

	$CCrmEntity = new CCrmContact(false);
	$ID = $CCrmEntity->Add(
		$arFields,
		true,
		[
			'DISABLE_USER_FIELD_CHECK' => true,
			'REGISTER_SONET_EVENT' => true,
			'CURRENT_USER' => static::getSystemUserId(),
		]
	);

	if ($ID <= 0)
	{
		if ($useTransaction)
		{
			$DB->Rollback();
		}
		throw new Exception($CCrmEntity->LAST_ERROR);
	}

	//region Try to create requisite
	if((isset($arFields['ADDRESS']) && $arFields['ADDRESS'] !== '') ||
		(isset($arFields['ADDRESS_2']) && $arFields['ADDRESS_2'] !== '') ||
		(isset($arFields['ADDRESS_CITY']) && $arFields['ADDRESS_CITY'] !== ''))
	{
		$presetID = \Bitrix\Crm\EntityRequisite::getDefaultPresetId(CCrmOwnerType::Contact);
		if($presetID > 0)
		{
			$converter = new \Bitrix\Crm\Requisite\AddressRequisiteConverter(CCrmOwnerType::Contact, $presetID, false);
			$converter->processEntity($ID);
		}
	}
	//endregion

	if (COption::GetOptionString("crm", "start_bp_within_bp", "N") == "Y")
	{
		$CCrmBizProc = new CCrmBizProc(CCrmOwnerType::ContactName);
		if (false === $CCrmBizProc->CheckFields(false, true))
			throw new Exception($CCrmBizProc->LAST_ERROR);

		if (!$CCrmBizProc->StartWorkflow($ID))
		{
			if ($useTransaction)
			{
				$DB->Rollback();
			}
			throw new Exception($CCrmBizProc->LAST_ERROR);
		}
	}

	if (isset($arFields['TRACKING_SOURCE_ID']))
	{
		Crm\Tracking\UI\Details::saveEntityData(\CCrmOwnerType::Contact, $ID, $arFields);
	}

	if ($useTransaction)
	{
		$DB->Commit();
	}

	return $ID;
}