Jak wysłać dokument z istniejącego szablonu?

Ten artykuł przeprowadzi Cię przez proces wysyłania dokumentu do podpisu przy użyciu szablonu za pomocą Sign.Plus eSignature API.

Wykonując poniższe kroki, utworzysz kopertę z szablonu, ustawisz dane odbiorców i wyślesz kopertę do podpisu.

Wymagania wstępne

• Konto Sign.Plus z planem API
• Twój Personal Access Token
• Istniejący szablon na Twoim koncie Sign.Plus 

Krok 1: Utwórz kopertę z szablonu

1. Użyj punktu końcowego POST /v2/envelope/from_template/{template_id}, aby utworzyć nową kopertę na podstawie szablonu.
2. Zamień {template_id} na identyfikator swojego istniejącego szablonu.
   Gdzie znaleźć identyfikator szablonu?
   • Przejdź do https://app.sign.plus/templates .
     
   • Kliknij nazwę wybranego szablonu.
     
   • Skopiuj identyfikator z panelu bocznego po prawej stronie.
3. Wyślij żądanie POST do POST /v2/envelope/from_template/{template_id} z następującą treścią JSON:
   {
"name": "My wonderful envelope from template"
}
4. Umieść swój klucz API w nagłówku Authorization.
5. W przypadku sukcesu otrzymasz obiekt an Envelope. {
"id": "66eb7d0467d2d549b89fcb6d",
// ...
"signing_steps": [
{
"recipients": [
{
"id": "66eb7d0467d2d549b89fcb70",
"uid": null,
"name": "",
"email": "",
"role": "SIGNER",
"verification": null
}
]
},
{
"recipients": [
{
"id": "66eb7d0467d2d549b89fcb71",
"uid": null,
"name": "",
"email": "",
"role": "RECEIVES_COPY",
"verification": null
},
{
"id": "66eb7d0467d2d549b89fcb72",
"uid": null,
"name": "",
"email": "",
"role": "SIGNER",
"verification": null
}
]
}
],
"documents": [
// ...
],
"notification": {
// ...
}
}
6. Zapisz zwrócony id jako envelope_id na potrzeby przyszłych wywołań API.
7. Zapisz idkażdego odbiorcy do wykorzystania w dalszym procesie podpisywania.
   Przykłady:
   • 66eb7d0467d2d549b89fcb71: pierwszy SIGNER (krok 1)
   • 66eb7d0467d2d549b89fcb71: RECEIVES_A_COPY (krok 1)
   • 66eb7d0467d2d549b89fcb72: drugi SIGNER (krok 2)

Krok 2: Ustaw dane odbiorców

Jeśli Twój szablon nie ma ustalonych odbiorców i musisz ustawić lub zaktualizować ich dane:

1. Użyj punktu końcowego POST /v2/envelope/{envelope_id}/signing_steps, aby zaktualizować informacje o odbiorcach.
2. Zamień {envelope_id} na identyfikator otrzymany w kroku 1.
3. Wyślij żądanie POST z następującą treścią JSON:
   {
"signing_steps": [
{
"recipients": [
{
"id": "66eb7d0467d2d549b89fcb70",
"name": "John Doe",
"email": "john.doe@example.com",
"role": "SIGNER"
}
]
},
{
"recipients": [
{
"id": "66eb7d0467d2d549b89fcb71",
"name": "Mark Twain",
"email": "m.twain@example.com",
"role": "RECEIVES_COPY"
},
{
"id": "66eb7d0467d2d549b89fcb72",
"name": "Jane Smith",
"email": "j.smith@example.com",
"role": "SIGNER"
}
]
}
]
}
4. W przypadku sukcesu otrzymasz tablicę obiektów SigningStep.

Krok 3: Wyślij swoją kopertę do podpisu

1. Użyj punktu końcowego POST /v2/envelope/{envelope_id}/send, aby wysłać kopertę.
2. Zamień {envelope_id} na identyfikator swojej koperty z kroku 1.
3. Wyślij żądanie POST do tego punktu końcowego.
4. W przypadku sukcesu koperta zostanie wysłana do odbiorcy (odbiorców) w celu podpisania.

Podsumowanie

Właśnie udało się wysłać dokument do podpisu przy użyciu szablonu za pomocą Sign.Plus eSignature API. Odbiorca (odbiorcy) otrzyma powiadomienie e-mail z linkiem do podpisania dokumentu.

Korzystanie z szablonów może znacznie usprawnić proces podpisywania dokumentów, szczególnie w przypadku często używanych dokumentów o stałym układzie i takich samych wymaganiach dotyczących podpisu.