Oznacz znak (wersja zapoznawcza)
Mark Sign to kwalifikowana usługa podpisu elektronicznego zgodna z regulacją eIDAS. Wyślij dokumenty do podpisania, poczekaj na podpisy, pobierz i zweryfikuj podpisane pliki.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure Government — Regiony platformy Azure (Chiny) - Departament Obrony USA (DoD) |
| Power Apps | Premium | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Power Automate - narzędzie do automatyzacji procesów | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Contact | |
|---|---|
| Name | Mark ID, UAB |
| adres URL | https://marksign.eu |
| pagalba@marksign.lt |
| Metadane łącznika | |
|---|---|
| Publisher | Mark ID, UAB |
| Website | https://marksign.eu |
| Zasady ochrony prywatności | https://marksign.eu/privacy-policy |
| Categories | Produktywność; Zawartość i pliki |
Oznacz znak
Mark Sign to kwalifikowana usługa podpisu elektronicznego zgodna z rozporządzeniem eIDAS. Przepływ może wysłać dokument do podpisania, poczekać na jego podpisanie, a następnie pobrać podpisany plik i zweryfikować go.
Publisher: Oznacz identyfikator, UAB
Prerequisites
Potrzebujesz tokenu dostępu do interfejsu API podpisywania mark. Zobacz Uzyskiwanie poświadczeń poniżej.
Obsługiwane operacje
Dokument: przekazywanie
Przekazuje dokument (PDF, ADoc, BDoc lub ASiC-E) i przygotowuje go do podpisywania. Nazwa pliku staje się tytułem dokumentu.
Podpisywanie: Zaproś pocztą e-mail
Zaprasza osobę do podpisania; Znak Mark wysyła wiadomość e-mail z zaproszeniem. Wywołanie go ponownie dla tej samej osoby wysyła przypomnienie.
Podpisywanie: zapraszanie według adresu URL
Dodaje sygnatariusza bez wysyłania wiadomości e-mail i zwraca osobisty adres URL zaproszenia do dostarczenia.
Podpisywanie: Czekaj na wszystkich sygnatariuszy
Przechowuje przepływ, dopóki dokument nie zostanie podpisany lub odrzucony albo zakończy się stanem, gdy domyślnie kończy się timed_out czas oczekiwania (domyślnie 29 dni).
Podpisywanie: Poczekaj na jednego sygnatariusza
Przechowuje przepływ do momentu, aż jeden konkretny podpis, wybrany pocztą e-mail, podpisuje. Każde odrzucenie kończy również oczekiwanie.
Podpisywanie: Zaczekaj na następny sygnatariusz
Wznawia przepływ, gdy następny podpisujący podpisuje lub odrzuca bez sondowania.
Dokument: Uzyskiwanie stanu
Sprawdza ogólny stan podpisywania dokumentu.
Dokument: Pobieranie osób podpisujących
Wyświetla listę stanu każdego osoby podpisającego, w tym przyczynę odrzucenia, jeśli sygnatariusz odrzucił.
Dokument: Pobieranie
Pobiera dokument ze wszystkimi sygnaturami zebranymi do tej pory.
Dokument: Lista
Wyświetla listę dokumentów w obszarze roboczym z wyszukiwaniem tekstu i stronicowaniem.
Dokument: Usuń
Usuwa dokument z obszaru roboczego.
Dokument: Przekazywanie jako kontener
Łączy kilka plików w jeden dokument kontenera z możliwością podpisywania (ADoc, BDoc lub ASiC-E). Rozliczenia są zgodne z wartością domyślną Oznacz znak, w której każdy użytkownik płaci.
Podpisywanie: tworzenie linków do podpisywania
Tworzy osobisty link podpisywania dla każdego użytkownika podpisującego, aby dostarczyć sobie. Linki wygasają, mogą wymagać weryfikacji tożsamości i są jedynymi stronami podpisywania z opcją odrzucenia.
Podpisywanie: tworzenie linku udostępnionego
Tworzy jeden link, który każdy może otworzyć, aby podpisać dokumenty, z których każda ma własną zweryfikowaną tożsamość.
Podpisywanie: usuwanie linku
Usuwa link użytkownika lub link udostępniony przed jego wygaśnięciem.
Dokument: rozszerzanie ważności podpisu
Uaktualnia podpisy dokumentów pod kątem długoterminowej ważności (LT) lub długoterminowego archiwizowania (LTA).
Dokument: Weryfikowanie
Sprawdza podpisy dokumentu i zwraca pełny raport weryfikacji.
Uzyskiwanie poświadczeń
Skontaktuj się z działem pomocy technicznej aplikacji Mark Sign pod adresem pagalba@marksign.lt , aby zażądać tokenu dostępu interfejsu API dla obszaru roboczego. Podczas tworzenia połączenia w Power Automate wklej token w polu "Klucz interfejsu API".
Token jest powiązany z jednym obszarem roboczym, więc każdy dokument utworzony lub wymieniony za pośrednictwem połączenia należy do tego obszaru roboczego.
Wprowadzenie
Najprostszy przepływ podpisywania:
- Dokument: przekaż (na przykład tokeny zawartości i nazwy pliku z SharePoint lub OneDrive).
- Podpisywanie: Zaproś pocztą e-mail. Oznacz znak Podpisywanie wiadomości e-mail na zaproszenie.
- Podpisywanie: Zaczekaj na następnego sygnatariusza. Przepływ jest w tym miejscu wstrzymywane do momentu podpisania.
- Dokument: pobierz go i zapisz tam, gdzie jest potrzebny.
W przypadku kilku osób podpisujących użyj opcji Podpisywanie: zaproś pocztą e-mail dla każdej osoby, a następnie jeden krok Podpisywanie: Poczekaj na krok wszystkich osób podpisujących przed pobraniem. Aby samodzielnie dostarczyć linki zamiast oznaczyć wiadomości e-mail, użyj opcji Podpisywanie: zaproś według adresu URL lub podpisywania: utwórz linki osoby podpisującego i wyślij każdą osobę z własną akcją Outlook lub teams.
Znane problemy i ograniczenia
- Łącznik nie udostępnia wyzwalaczy przepływu; Zamiast tego należy używać operacji oczekiwania wewnątrz przepływu.
- Dokument ma jedną rejestrację powiadomień. Nie uruchamiaj dwóch podpisów: zaczekaj na kolejne kroki logowania w tym samym dokumencie w tym samym czasie. Drugi zastępuje pierwszy, a pierwszy krok czeka, aż upłynął limit czasu. Wypełnienie pola Adres URL wywołania zwrotnego w dowolnym bloku zastępuje również rejestrację.
- Osoby podpisującego mogą odrzucać dokument tylko na stronie linków podpisywania: Tworzenie osoby podpisującego (przy użyciu przycisku Pokaż odrzuć ). Zaproszenia e-mail, adresy URL zaproszeń i linki udostępnione nie oferują opcji odrzucenia.
- Oznaczanie znaku powiadamia tylko o podpisach. Gdy blok zaproszenia używa akcji Cel
reviewlubconfirmation, ta osoba nigdy nie wznawia akcji Podpisywanie: Czekaj na następnego osoby podpisującego; sprawdź ich stan za pomocą pozycji Dokument: Pobierz osoby podpisujące . - Dokument: Pobieranie zwraca tylko zawartość pliku; utwórz nazwę pliku z pola Document: List lub from your upload step (Dokument: lista lub z kroku przekazywania).
- Przebieg przepływu może trwać co najwyżej 30 dni (limit Power Automate), więc nie można tego przeżyć.
Podpisywanie: Poczekaj na wszystkich sygnatariuszy i podpisanie: poczekaj na zakończenie jednego osoby podpisującego ze stanem
timed_outpo 29 dniach domyślnie. W przypadku podpisywania: poczekaj na następny znak, ustaw limit czasu (na przykładP29D) w ustawieniach akcji i dodaj gałąź skonfigurowaną do uruchomienia po upłynął limit czasu akcji. Jeśli limit przebiegu 30 dni zostanie osiągnięty jako pierwszy, Power Automate anuluje cały przebieg i żadna gałąź nie obsługuje go. - Dokument: lista nie obsługuje filtrowania według stanu.
- Dokument: Przekazywanie akceptuje jeden plik na wywołanie; pętla na załącznikach, aby przekazać kilka. Dokument: przekazywanie jako kontener jest przeznaczone dla kilku plików; połączenie wielu dużych plików w jednym wywołaniu może przekroczyć limit czasu przetwarzania.
Instrukcje dotyczące wdrażania
Uruchom polecenie paconn create --api-prop apiProperties.json --api-def apiDefinition.swagger.json --script script.csx --icon icon.png , aby wdrożyć ten łącznik jako łącznik niestandardowy w środowisku platformy Power Platform. Aby uzyskać szczegółowe informacje, zobacz dokumentację rozwiązania paconn .
Support
W przypadku problemów z łącznikiem lub interfejsem API oznaczania znaku skontaktuj się z .pagalba@marksign.lt
Tworzenie połączenia
Łącznik obsługuje następujące typy uwierzytelniania:
| Wartość domyślna | Parametry tworzenia połączenia. | Wszystkie regiony | Nie można udostępniać |
Domyślny
Dotyczy: wszystkie regiony
Parametry tworzenia połączenia.
Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.
| Name | Typ | Description | Required |
|---|---|---|---|
| Klucz API | securestring | Token dostępu do interfejsu API oznaczania znaku obszaru roboczego. Poproś o pomoc techniczną mark sign pod adresem pagalba@marksign.lt. | True |
Akcje
| Dokument: Lista |
Wyświetla listę dokumentów w obszarze roboczym, najpierw najnowsze. |
| Dokument: Pobieranie |
Pobiera dokument ze wszystkimi sygnaturami zebranymi do tej pory. |
| Dokument: Pobieranie osób podpisujących |
Wyświetla listę osób podpisujących dokument ze stanem podpisywania. |
| Dokument: przekazywanie |
Przekazuje dokument i przygotowuje go do podpisania. |
| Dokument: Przekazywanie jako kontener |
Łączy kilka plików w jeden dokument kontenera z możliwością podpisywania, taki jak ADoc lub ASiC-E. Pliki są przekazywane i łączone w jednym kroku. |
| Dokument: rozszerzanie ważności podpisu |
Uaktualnia podpisy dokumentów pod kątem długoterminowej ważności lub archiwizacji. |
| Dokument: Usuń |
Usuwa dokument z obszaru roboczego. |
| Dokument: Uzyskiwanie stanu |
Pobiera stan podpisywania dokumentu. |
| Dokument: Weryfikowanie |
Sprawdza podpisy dokumentu i zwraca raport weryfikacji. Przepływ czeka na zakończenie sprawdzania. |
| Podpisywanie: Czekaj na wszystkich sygnatariuszy |
Czeka, aż każdy podpisuje lub ktoś odrzucił dokument, a następnie umożliwi kontynuowanie przepływu. Kończy się stanem timed_out po upływie czasu. |
| Podpisywanie: Poczekaj na jednego sygnatariusza |
Czeka, aż jeden konkretny podpisuje dokument, a następnie umożliwi kontynuowanie przepływu. Kończy się stanem timed_out po upływie czasu. |
| Podpisywanie: tworzenie linku udostępnionego |
Tworzy jeden link podpisywania, który każdy może otworzyć, aby podpisać dokumenty. Dostarczasz go samodzielnie. |
| Podpisywanie: tworzenie linków do podpisywania |
Tworzy osobisty link podpisywania dla każdego użytkownika podpisującego. Linki są dostarczane samodzielnie, na przykład pocztą e-mail lub wiadomością usługi Teams. |
| Podpisywanie: usuwanie linku |
Usuwa link użytkownika lub link udostępniony przed jego wygaśnięciem. Nie można usunąć łączy zaproszeń. |
| Podpisywanie: Zaczekaj na następny sygnatariusz |
Czeka na kolejne podpisywanie lub odrzuca dokument bez wysyłania zaproszeń. Użyj go w pętli, aby poczekać na kilku sygnatariuszy bez sondowania. |
| Podpisywanie: zapraszanie według adresu URL |
Dodaje użytkownika podpisjącego do dokumentu bez wysyłania wiadomości e-mail i zwraca osobisty link zaproszenia do dostarczenia. Link nie wygasa i nie można go usunąć; Użyj opcji "Podpisywanie: utwórz linki do osób podpisujących", jeśli potrzebujesz linków, które można odwołać. |
| Podpisywanie: Zaproś pocztą e-mail |
Zaprasza osobę do podpisania dokumentu. Znak Sign wysyła zaproszenie pocztą e-mail. |
Dokument: Lista
Wyświetla listę dokumentów w obszarze roboczym, najpierw najnowsze.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Search
|
query | string |
Fraza do wyszukania w tytułach dokumentów i nazwach plików. |
|
|
Offset
|
offset | integer |
Ile dokumentów należy pominąć. |
|
|
Limit
|
limit | integer |
Ile dokumentów ma być zwracanych. Wartość domyślna to 10. |
Zwraca
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Stan żądania. |
|
Dokumenty:
|
data | array of object |
Dokumenty. |
|
Identyfikator dokumentu
|
data.uuid | string |
Identyfikator dokumentu. |
|
Nazwa pliku
|
data.filename | string |
Nazwa pliku. |
|
Stan dokumentu
|
data.status | string |
Stan podpisywania dokumentu, na przykład zapisany (oczekiwanie na podpisy), signed_partially lub podpisany. |
|
Przekazano o
|
data.uploaded_at | date-time |
Po przekazaniu dokumentu. |
|
Total
|
total | integer |
Całkowita liczba pasujących dokumentów. |
Dokument: Pobieranie
Pobiera dokument ze wszystkimi sygnaturami zebranymi do tej pory.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator dokumentu
|
documentId | True | string |
Identyfikator dokumentu z danych wyjściowych polecenia "Document: Upload", "Document: Upload as container" lub "Document: List". |
Zwraca
Zawartość pliku dokumentu.
- Zawartość pliku
- file
Dokument: Pobieranie osób podpisujących
Wyświetla listę osób podpisujących dokument ze stanem podpisywania.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator dokumentu
|
documentId | True | string |
Identyfikator dokumentu z danych wyjściowych polecenia "Document: Upload", "Document: Upload as container" lub "Document: List". |
Zwraca
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Stan żądania. |
|
Osoby podpisujących:
|
data | array of object |
Osoby podpisające dokument. |
|
Identyfikator logowania
|
data.id | string |
Identyfikator sygnatariusza. |
|
Imię
|
data.name | string |
Imię osoby podpisającego. |
|
Nazwisko
|
data.surname | string |
Nazwisko osoby podpisającego. |
|
Email
|
data.email | string |
Adres e-mail użytkownika podpisjącego. |
|
Stan podpisywania
|
data.status | string |
Niezależnie od tego, czy podpisujący podpisał: oczekujący, podpisany, odrzucony, przeglądający, potwierdzony, odrzucony lub przejrzyszony. |
|
Przyczyna odrzucenia
|
data.rejection_reason | string |
Powodem, dla którego podpisujący podał podczas odrzucania dokumentu. |
Dokument: przekazywanie
Przekazuje dokument i przygotowuje go do podpisania.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa pliku
|
file_name | True | string |
Nazwa pliku z rozszerzeniem, na przykład contract.pdf. Staje się on tytułem dokumentu. |
|
body
|
body | True | binary | |
|
Access
|
access | string |
Kto może wyświetlić dokument. Wartość domyślna to prywatny. |
|
|
Typ rozliczeń
|
billing_type | True | string |
Kto płaci za podpisy. |
Zwraca
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Stan żądania. |
|
Identyfikator dokumentu
|
data.uuid | string |
Identyfikator dokumentu. |
|
Nazwa pliku
|
data.filename | string |
Nazwa pliku. |
Dokument: Przekazywanie jako kontener
Łączy kilka plików w jeden dokument kontenera z możliwością podpisywania, taki jak ADoc lub ASiC-E. Pliki są przekazywane i łączone w jednym kroku.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Typ dokumentu
|
document_type | True | string |
Typ dokumentu do utworzenia. |
|
Nazwa pliku
|
file_name | True | string |
Nazwa pliku z rozszerzeniem, na przykład contract.pdf. |
|
Zawartość pliku
|
file_content | True | byte |
Zawartość pliku. |
|
Typ pliku (tylko dokument ADoc)
|
adoc_file_type | string |
Rola pliku w kontenerze. Używany tylko wtedy, gdy typ dokumentu jest dokumentem ADoc. |
Zwraca
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Stan żądania. |
|
Identyfikator dokumentu
|
data.uuid | string |
Identyfikator dokumentu. |
|
Nazwa pliku
|
data.filename | string |
Nazwa pliku dokumentu. |
Dokument: rozszerzanie ważności podpisu
Uaktualnia podpisy dokumentów pod kątem długoterminowej ważności lub archiwizacji.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator dokumentu
|
documentId | True | string |
Identyfikator dokumentu z danych wyjściowych polecenia "Document: Upload", "Document: Upload as container" lub "Document: List". |
|
Level
|
level | True | string |
LT dla długoterminowej ważności LTA na potrzeby długoterminowego archiwizowania. |
Zwraca
- Body
- AcknowledgedResponse
Dokument: Usuń
Usuwa dokument z obszaru roboczego.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator dokumentu
|
documentId | True | string |
Identyfikator dokumentu z danych wyjściowych polecenia "Document: Upload", "Document: Upload as container" lub "Document: List". |
Zwraca
- Body
- AcknowledgedResponse
Dokument: Uzyskiwanie stanu
Pobiera stan podpisywania dokumentu.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator dokumentu
|
documentId | True | string |
Identyfikator dokumentu z danych wyjściowych polecenia "Document: Upload", "Document: Upload as container" lub "Document: List". |
Zwraca
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Stan żądania. |
|
Stan dokumentu
|
data.document_status | string |
Stan podpisywania: zapisany (oczekiwanie na podpisy), signed_partially (niektóre z nich podpisały) lub podpisany (wszyscy podpisali). |
Dokument: Weryfikowanie
Sprawdza podpisy dokumentu i zwraca raport weryfikacji. Przepływ czeka na zakończenie sprawdzania.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator dokumentu
|
documentId | True | string |
Identyfikator dokumentu z danych wyjściowych polecenia "Document: Upload", "Document: Upload as container" lub "Document: List". |
Zwraca
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Stan żądania. |
|
Jest prawidłowy
|
data.document.is_valid | boolean |
Czy podpisy dokumentu są prawidłowe. |
|
Koniec ważności
|
data.document.valid_to | string |
Jak długo dokument pozostanie prawidłowy. |
|
Nazwa dokumentu
|
data.document.name | string |
Tytuł dokumentu. |
|
Typ MIME
|
data.document.mimetype | string |
Typ pliku dokumentu. |
|
Podpisy:
|
data.signatures | array of object |
Wynik dla każdego podpisu. |
|
Identyfikator podpisu
|
data.signatures.id | string |
Identyfikator podpisu. |
|
Czas podpisywania
|
data.signatures.signing_time | string |
Kiedy został złożony podpis. |
|
Format podpisu
|
data.signatures.signature_format | string |
Format podpisu. |
|
Jest prawidłowy
|
data.signatures.is_valid | boolean |
Czy podpis jest prawidłowy. |
|
Koniec ważności
|
data.signatures.valid_to | string |
Jak długo podpis pozostaje prawidłowy. |
|
Certyfikaty
|
data.certificates | array of object |
Certyfikaty używane przez podpisy. |
|
items
|
data.certificates | object | |
|
Znaczniki czasu
|
data.timestamps | array of object |
Znaczniki czasu zastosowane do dokumentu. |
|
items
|
data.timestamps | object | |
|
Czas weryfikacji
|
metadata.validation_time | string |
Po wykonaniu walidacji. |
Podpisywanie: Czekaj na wszystkich sygnatariuszy
Czeka, aż każdy podpisuje lub ktoś odrzucił dokument, a następnie umożliwi kontynuowanie przepływu. Kończy się stanem timed_out po upływie czasu.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator dokumentu
|
documentId | True | string |
Identyfikator dokumentu z danych wyjściowych polecenia "Document: Upload", "Document: Upload as container" lub "Document: List". |
|
Limit czasu (minuty)
|
timeout_minutes | integer |
Czas oczekiwania (w minutach) przed zakończeniem ze stanem timed_out. Wartość domyślna to 41760 (29 dni), wartość maksymalna to 43200 (30 dni). |
Zwraca
- Body
- SigningWaitResponse
Podpisywanie: Poczekaj na jednego sygnatariusza
Czeka, aż jeden konkretny podpisuje dokument, a następnie umożliwi kontynuowanie przepływu. Kończy się stanem timed_out po upływie czasu.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator dokumentu
|
documentId | True | string |
Identyfikator dokumentu z danych wyjściowych polecenia "Document: Upload", "Document: Upload as container" lub "Document: List". |
|
Adres e-mail sygnatariusza
|
signer_email | True | string |
Wiadomość e-mail użytkownika, która ma czekać, ta sama wiadomość e-mail użyta podczas zapraszania ich. |
|
Limit czasu (minuty)
|
timeout_minutes | integer |
Czas oczekiwania (w minutach) przed zakończeniem ze stanem timed_out. Wartość domyślna to 41760 (29 dni), wartość maksymalna to 43200 (30 dni). |
Zwraca
- Body
- SigningWaitResponse
Podpisywanie: tworzenie linku udostępnionego
Tworzy jeden link podpisywania, który każdy może otworzyć, aby podpisać dokumenty. Dostarczasz go samodzielnie.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikatory dokumentów
|
documents | True | array of string |
Dokumenty podpisy linku. Użyj wartości identyfikatora dokumentu z kroków przekazywania lub listy. |
|
Adres URL wywołania zwrotnego
|
callback_url | string |
Adres URL do powiadamiania o podpisaniu dokumentu. |
|
|
Wygaśnięcie po (minuty)
|
expire_after | integer |
Minuty do wygaśnięcia linku. Wartość domyślna to 2880 (dwa dni). |
|
|
Usuń dokument po (w minutach)
|
delete_document_after | integer |
Minuty do usunięcia dokumentu z obszaru roboczego. Domyślnie jest ona przechowywana. |
Zwraca
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Stan żądania. |
|
Łącze podpisywania
|
data.signing_link | string |
Link, który może otworzyć każdy, aby podpisać. |
|
Identyfikator linku podpisywania
|
data.signing_link_id | string |
Identyfikator linku w polu "Podpisywanie: usuwanie linku". |
|
Prawidłowe do
|
data.valid_until | integer |
Po wygaśnięciu linku jako sygnatura czasowa systemu Unix. |
Podpisywanie: tworzenie linków do podpisywania
Tworzy osobisty link podpisywania dla każdego użytkownika podpisującego. Linki są dostarczane samodzielnie, na przykład pocztą e-mail lub wiadomością usługi Teams.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikatory dokumentów
|
documents | True | array of string |
Dokumenty służące do tworzenia linków podpisywania. Użyj wartości identyfikatora dokumentu z kroków przekazywania lub listy. |
|
Identyfikator logowania
|
id | string |
Twój własny identyfikator dla sygnatariusza, unikatowy w żądaniu. Wymagane, gdy wiadomość e-mail jest pusta. |
|
|
Imię
|
name | string |
Imię osoby podpisającego. |
|
|
Nazwisko
|
surname | string |
Nazwisko osoby podpisającego. |
|
|
Email
|
Adres e-mail użytkownika podpisjącego. Wymagane, gdy identyfikator logowania jest pusty. |
|||
|
Kod osobisty
|
personal_code | string |
Osobisty kod sygnatariusza. Wymagane, gdy wymagane jest uwierzytelnianie. |
|
|
Wymagaj uwierzytelniania
|
authentication_required | boolean |
Jeśli tak, przed otwarciem linku użytkownik musi zweryfikować swoją tożsamość. |
|
|
Pozycja (tylko dokument ADoc)
|
position | string |
Stanowisko użytkownika podpisów pokazane w podpisach ADoc. |
|
|
Dział (tylko dokument ADoc)
|
structural_subdivision | string |
Dział sygnatariusza, pokazany w podpisach ADoc. |
|
|
Cel podpisywania (tylko dokument ADoc)
|
signing_purpose | string |
Dlaczego osoba podpisuje się, pokazana w podpisach ADoc. |
|
|
Adres URL wywołania zwrotnego
|
callback_url | string |
Adres URL do powiadamiania o podpisaniu dokumentu. |
|
|
Adres URL wywołania zwrotnego odrzucenia
|
reject_callback_url | string |
Adres URL powiadamiania o odrzuceniu dokumentu przez użytkownika podpisjącego. |
|
|
Wygaśnięcie po (minuty)
|
expire_after | integer |
Minuty do wygaśnięcia linku. Wartość domyślna to 2880 (dwa dni). |
|
|
Pokaż przycisk Odrzuć
|
show_reject_button | boolean |
Czy osoby podpisające mogą odrzucać dokument na stronie podpisywania. Wartość domyślna to Tak. |
|
|
Usuń dokument po (w minutach)
|
delete_document_after | integer |
Minuty do usunięcia dokumentu z obszaru roboczego. Domyślnie jest ona przechowywana. |
Zwraca
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Stan żądania. |
|
Linki podpisywania:
|
temporary_signing_links | array of object |
Jeden link podpisywania na osobę podpisaną. |
|
Identyfikator logowania
|
temporary_signing_links.id | string |
Twój własny identyfikator dla sygnatariusza. |
|
Imię
|
temporary_signing_links.member_name | string |
Imię osoby podpisającego. |
|
Nazwisko
|
temporary_signing_links.member_surname | string |
Nazwisko osoby podpisającego. |
|
Email
|
temporary_signing_links.member_email | string |
Adres e-mail użytkownika podpisjącego. |
|
Łącze podpisywania
|
temporary_signing_links.temporary_signing_link | string |
Link, który podpisuje, otwiera się w celu podpisania dokumentu. |
|
Identyfikator linku podpisywania
|
temporary_signing_links.temporary_signing_link_id | string |
Identyfikator linku podpisywania. |
|
Prawidłowe do
|
temporary_signing_links.valid_until | integer |
Po wygaśnięciu linku jako sygnatura czasowa systemu Unix. |
|
Dokumenty:
|
documents | array of object |
Dokumenty, dla których utworzono linki. |
|
Identyfikator dokumentu
|
documents.uuid | string |
Identyfikator dokumentu. |
|
Nazwa pliku
|
documents.filename | string |
Nazwa pliku dokumentu. |
Podpisywanie: usuwanie linku
Usuwa link użytkownika lub link udostępniony przed jego wygaśnięciem. Nie można usunąć łączy zaproszeń.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator linku podpisywania
|
temporarySigningLinkId | True | string |
Identyfikator linku podpisywania z danych wyjściowych polecenia "Podpisywanie: tworzenie linków podpisywania" lub "Podpisywanie: tworzenie linku udostępnionego". |
Zwraca
- Body
- AcknowledgedResponse
Podpisywanie: Zaczekaj na następny sygnatariusz
Czeka na kolejne podpisywanie lub odrzuca dokument bez wysyłania zaproszeń. Użyj go w pętli, aby poczekać na kilku sygnatariuszy bez sondowania.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator dokumentu
|
documentId | True | string |
Identyfikator dokumentu z danych wyjściowych polecenia "Document: Upload", "Document: Upload as container" lub "Document: List". |
Zwraca
- Body
- SigningEvent
Podpisywanie: zapraszanie według adresu URL
Dodaje użytkownika podpisjącego do dokumentu bez wysyłania wiadomości e-mail i zwraca osobisty link zaproszenia do dostarczenia. Link nie wygasa i nie można go usunąć; Użyj opcji "Podpisywanie: utwórz linki do osób podpisujących", jeśli potrzebujesz linków, które można odwołać.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator dokumentu
|
documentId | True | string |
Identyfikator dokumentu z danych wyjściowych polecenia "Document: Upload", "Document: Upload as container" lub "Document: List". |
|
Imię
|
name | True | string |
Imię osoby podpisającego. |
|
Nazwisko
|
surname | True | string |
Nazwisko osoby podpisającego. |
|
Email
|
True |
Adres e-mail użytkownika podpisjącego. |
||
|
Adres URL powodzenia
|
success_url | string |
Gdzie wysłać podpisującego po zakończeniu podpisywania. |
|
|
Purpose
|
purpose | string |
Dlaczego dana osoba jest zapraszana. Wybierz recenzję, aby zaprosić tylko do wyświetlania. |
|
|
Adres URL wywołania zwrotnego
|
callback_url | string |
Adres URL do powiadamiania o podpisaniu dokumentu. |
Zwraca
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Stan żądania. |
|
Adres URL zaproszenia
|
data.invitation_url | string |
Link strony podpisywania osobistego w celu dostarczenia go do użytkownika podpisującego. |
Podpisywanie: Zaproś pocztą e-mail
Zaprasza osobę do podpisania dokumentu. Znak Sign wysyła zaproszenie pocztą e-mail.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator dokumentu
|
documentId | True | string |
Identyfikator dokumentu z danych wyjściowych polecenia "Document: Upload", "Document: Upload as container" lub "Document: List". |
|
Imię
|
name | True | string |
Imię osoby podpisającego. |
|
Nazwisko
|
surname | True | string |
Nazwisko osoby podpisającego. |
|
Email
|
True |
Adres e-mail użytkownika podpisjącego. |
||
|
Język
|
language | string |
Język zaproszenia. Wartość domyślna to Litewski. |
|
|
Adres URL powodzenia
|
success_url | string |
Gdzie wysłać podpisującego po zakończeniu podpisywania. |
|
|
Purpose
|
purpose | string |
Dlaczego dana osoba jest zapraszana. Wybierz recenzję, aby zaprosić tylko do wyświetlania. |
|
|
Adres URL wywołania zwrotnego
|
callback_url | string |
Adres URL do powiadamiania o podpisaniu dokumentu. |
Zwraca
- Body
- AcknowledgedResponse
Definicje
SigningEvent
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator dokumentu
|
uuid | string |
Identyfikator dokumentu. |
|
Stan dokumentu
|
status | string |
Stan podpisywania dokumentu, taki jak podpisany lub signed_partially. Odrzucenie jest wyświetlane w stanach osób podpisanych. |
|
Liczba podpisów
|
members_count | integer |
Ilu osób zostało zaproszonych do podpisania. |
|
Liczba podpisanych
|
signed_members_count | integer |
Ile osób podpisało. |
|
Osoby podpisujących:
|
members | array of object |
Wszyscy zaproszeni do podpisania. |
|
Identyfikator logowania
|
members.id | string |
Identyfikator sygnatariusza. |
|
Imię
|
members.member_name | string |
Imię osoby podpisającego. |
|
Nazwisko
|
members.member_surname | string |
Nazwisko osoby podpisającego. |
|
Email
|
members.member_email | string |
Adres e-mail użytkownika podpisjącego. |
|
Stan podpisywania
|
members.status | string |
Stan użytkownika, taki jak oczekujący, podpisany lub odrzucony. |
AcknowledgedResponse
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Status
|
status | RequestStatus |
Stan żądania. |
SigningWaitResponse
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Stan dokumentu
|
document_status | string |
Jak zakończyło się oczekiwanie: podpisane, odrzucone lub timed_out. |
|
Odrzucone przez
|
rejected_by | string |
Kto odrzucił dokument, jeśli został odrzucony. |
|
Przyczyna odrzucenia
|
rejection_reason | string |
Przyczyna, jaką podał sygnatariusz, jeśli dokument został odrzucony. |
Status Żądania
plik
Jest to podstawowy typ danych "file".