> For the complete documentation index, see [llms.txt](https://2sign-co-il.gitbook.io/2sign.co.il-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://2sign-co-il.gitbook.io/2sign.co.il-docs/getting-started/undefined.md).

# טיפים וחידודים - עברית

### משימה בודדת לעומת סבב חתימות

#### משימה בודדת

השתמשו במשימה בודדת כאשר נמען אחד חותם על המסמך.

אפשר לשלוח אל:

* לקוח קיים באמצעות `ClientId`
* נמען חד-פעמי באמצעות `ClientPhones` או `ClientEmails`

ראו [Create a single Task](/2sign.co.il-docs/tasks/create-a-single-task.md).

#### סבב חתימות

השתמשו בסבב חתימות כאשר כמה נמענים חותמים על אותו מסמך.

המערכת תומכת בשני מצבים:

* `SignatureRoutineAsync: false` — חתימה טורית
* `SignatureRoutineAsync: true` — חתימה במקביל

אפשר ליצור סבב:

* עם קבוצה מוגדרת מראש וערכי `ClientId` של החותמים
* בלי קבוצה, על ידי שליחת ClientId של החותמים ישירות בבקשה

ראו [Create a Signature Routine](/2sign.co.il-docs/signature-routine-tasks/create-a-signature-routine.md) ו-[Create a Signature Routine Without a Group](/2sign.co.il-docs/signature-routine-tasks/create-a-signature-routine-without-a-group.md).

{% hint style="info" %}
השתמשו במצב טורי כשהסדר חשוב. השתמשו במצב מקבילי כשכל החותמים יכולים לקבל את המסמך באותו זמן.
{% endhint %}

***

### עבודה עם תבניות

השתמשו בתבנית כשהמבנה של המסמך נשאר קבוע בין משימות.

תבניות מתאימות כאשר:

* אותו מסמך נשלח לעיתים קרובות
* השדות כבר צריכים להופיע על המסמך
* ערכים מצד השולח צריכים להיות ממולאים מראש לפני השליחה

כדי לעשות שימוש חוזר במיקומי שדות מתבנית:

1. קראו ל-endpoint מתאים מתוך [Single task tamplates](/2sign.co.il-docs/templates/get-tamplates-info.md)
2. העתיקו את מערך `SignaturePositions`
3. עדכנו את `PositionTextContent` לפי הצורך
4. שלחו את המערך בבקשת יצירת המשימה

{% hint style="info" %}
זו הדרך המהירה ביותר לקבל מיקומי שדות מדויקים. כך נמנעים מחישוב ידני של ערכי X/Y.
{% endhint %}

#### מילוי שדות מצד השולח

כדי להציג ערך על המסמך לפני שהחותם פותח אותו:

* הגדירו `SignaturePositionStageTypeId` ל-`1`
* הגדירו את ערך השדה בתוך `PositionTextContent`

למודל השדות המלא, ראו [Defining Signature Fields](/2sign.co.il-docs/tasks/defining-signature-fields.md).

***

### מיקום שדות באמצעות תווים נסתרים

השתמשו בתווים נסתרים כשאתם רוצים שהמערכת תמקם שדות לפי סימנים שמוטמעים ב-PDF.

#### תו יחיד לשדות חתימה

`SearchWordForMarkingSignature` מוסיף שדה חתימה בכל מקום שבו התו מופיע.

```json
{
  "SearchWordForMarkingSignature": "§"
}
```

השיטה הזו תומכת בשדות חתימה בלבד.

#### כמה תווים לכמה סוגי שדות

`SearchWordForMarkingFieldsJson` ממפה כל תו לסוג שדה אחר.

```json
{
  "SearchWordForMarkingFieldsJson": "[{ \"fieldSignaturePositionType\": \"1\", \"fieldSearchChar\": \"&\" }, { \"fieldSignaturePositionType\": \"6\", \"fieldSearchChar\": \"$\" }]"
}
```

בדוגמה הזו:

* `&` יוצר שדה חתימה
* `$` יוצר שדה שם מלא

| שדה                          | תיאור            |
| ---------------------------- | ---------------- |
| `fieldSignaturePositionType` | מזהה סוג השדה    |
| `fieldSearchChar`            | התו שמוטמע במסמך |

{% hint style="warning" %}
השתמשו בתווים נדירים כמו `§`, `¤` או `¬`. הימנעו מתווים נפוצים כמו `@`, `!` ו-`%`.
{% endhint %}

לאפשרויות נוספות למיקום שדות, ראו [Defining Signature Fields](/2sign.co.il-docs/tasks/defining-signature-fields.md).

***

### התראות וקישור חתימה

השתמשו בפרמטרים הבאים כדי לשלוט בערוץ השליחה:

* `IsSendOnCreation`
* `IsSendEmailOnCreation`
* `IsSendSmsOnCreation`
* `IsSendWhatsappOnCreation`

השתמשו ב-`EmailText` כדי להתאים אישית את גוף המייל.

SMS נשלח לערך `ClientPhones` של הנמען או למספר הנייד השמור שלו.

אפשר גם לבנות קישור חתימה ישיר מתוך ה-`taskGuid` שמוחזר בתשובה:

```
https://app.2sign.co.il/he/Clients/DocSignature?guid=<taskGuid>
```

אפשר לשלוח את הקישור הזה במייל, ב-WhatsApp או בכל ערוץ אחר.

***

### Callbacks

הגדירו כתובת callback קבועה כדי לקבל עדכוני סטטוס על משימות.

הגדירו אותה ב-**Subscription → Settings → Account Settings → Advanced Settings → Additional API Settings**.

הזינו כתובת מלאה עם `https://` ושמרו.

המערכת שולחת בקשת `POST` בכל פעם שסטטוס המשימה משתנה.

***

### קבלת קישור לחתימה על המסמך

במקרים בהם תרצו לשלוח בעצמם את הלינק לחתימה ולא דרך המערכת שלנו תוכלו לבצע זאת כך:

לאחר יצירת מסמך באמצעות ה-API, יוחזר בשדה `TaskGuid` מזהה ייחודי של המשימה.

כדי ליצור קישור לחתימה על המסמך, יש לשרשר את ערך ה-`TaskGuid` לכתובת הבאה:

```
https://app.2sign.co.il/he/Clients/DocSignature?guid={TaskGuid}
```

**דוגמה:**

```
https://app.2sign.co.il/he/Clients/DocSignature?guid=c788c46d-7f64-48d9-94a0-7d0c3ee56301
```