send_esign_request

Tool of clawshow

Send an electronic signature request. Supports two modes: 1. ClawShow native: generate PDF from template with pre-filled fields. 2. FocusingPro / external: pass a file_url (S3 PDF) + signers array. After signing, the signed PDF is stored and webhook callback updates the source system. AES-level (eIDAS Art.26): OTP email verification + SHA-256 digital signature. Args: namespace: Client namespace (e.g. "ilci", "florent") template: Document template -- "enrollment_contract", "rental_agreement", "service_agreement", or "custom". Required if no file_url. signer_name: Full name of the primary signer. Required if no signers array. signer_email: Email of the primary signer. Required if no signers array. fields: Template variables dict, e.g. {"school_name": "ILCI", "tuition": "8500"}. Use for native template mode. reference_id: Optional external ID, e.g. FocusingPro inscription_id. callback_url: Optional webhook URL called when signing is complete. send_email: Whether to email the signing link (default True). language: Signing page language -- "fr", "en", or "zh" (default "fr"). file_url: URL of an existing PDF to sign (e.g. S3 pre-signed URL). When provided, template/fields are ignored. signers: JSON array string of signers for multi-party workflows. Each item: {"role":"student","name":"...","email":"...","order":1}. Order 1 signs first. If omitted, uses signer_name/signer_email. signature_fields: JSON object string defining custom signature positions per role. E.g. {"paraphe":{"x":390,"y":22,"w":160,"h":48}}. expiration_days: Days until signing link expires (default 30). reminder_frequency: Reminder schedule -- "EVERY_THIRD_DAY", "WEEKLY", or "NONE". Returns: JSON with signing_url, document_id, pdf_preview_url, signers list, status.