README

NolaConsulting_Universign 是一个 Magento 模块，允许您和您的客户使用 Universign，一个经 eIDAS 认证的信任服务提供商，签署文档。使用此模块需要 Universign 账户。

安装

composer require nola-consulting/module-universign
bin/magento module:enable NolaConsulting_Universign
bin/magento setup:upgrade

配置

前往 STORES > 配置 > 服务 > Universign

您可以在 Universign 网站上找到您的 API 密钥，在您的账户下 开发者 > API 密钥。

您可以为您的网站设置一个默认的 国家 ID，它用于使用正确的国家代码格式化电话号码。如果您的网站有来自不同国家的客户，您可以在 setSigner() 方法中指定 $countryId。

您还可以在那里设置默认的 交易名称 和默认的 文档名称。如果您有多个要签署的文档类型，您可以在初始化交易时指定它们。

$this->transaction->initialize($documentId)
    ->setDocumentFullPath($documentFullPath)
    ->setTransactionName('Contract N°%ID')
    ->setDocumentName('contract-%ID.pdf')
    ->setSigner($email, $fullName, $phone)
    ->create();

%ID 占位符将被传递给 initialize() 方法时传入的引用所替换。

演示

您可以在 /universign/demo 的 URL 上测试此模块，您可以

• 创建一个 "联系人" 并在提供姓名、电子邮件和电话后进行签署。
• 通过提供交易 ID 来检索交易数据。

基本用法

use NolaConsulting\Universign\Model\TransactionFactory;

/** ... */

/** @var Transaction $transaction */
$this->transaction = $this->transactionFactory->create();

$this->transaction->initialize($documentId)
    ->setDocumentFullPath($documentFullPath)
    ->setSigner($email, $fullName, $phone)
    ->create();

$redirectUrl = $this->transaction->getTransactionUrl();

依赖项

• Dompdf：帮助您从 HTML 生成 PDF。
• libphonenumber：用于格式化 Universign 所需的任何国家的 E.164 格式的电话号码。

故障排除

Exception #0 (ReflectionException): Class "NolaConsulting\Universign\Model\PdfCreator\Interceptor" does not exist

原因：Dompdf 可能没有被正确安装。

待办事项

• 使用 schedule 数组管理自动提醒
• 允许客户仅使用电话号码而不是电子邮件签署文档