Certyneo (Preview)

Odesílat dokumenty pro elektronický podpis kompatibilní s eIDAS, vytvářet obálky ze šablon a aktivovat toky u událostí podpisu, jako jsou odeslané, podepsané, dokončené a odmítnuté.

Tento konektor je dostupný v následujících produktech a oblastech:

Služba Class Regions
Copilot Studio Premium Všechny oblasti Power Automate kromě následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Logické aplikace Standard Všechny oblasti Logic Apps s výjimkou následujících:
     – Azure Government oblastí
     – Oblasti Azure China
     - Ministerstvo obrany USA (DoD)
Power Apps Premium Všechny oblasti Power Apps s výjimkou následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Automatizace napájení Premium Všechny oblasti Power Automate kromě následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Kontakt
Name Podpora Certyneo
URL https://certyneo.com/fr/contact
Email support@certyneo.com
Metadata konektoru
Vydavatel Certyneo
Internetová stránka https://certyneo.com
Zásady ochrany osobních údajů https://certyneo.com/fr/legal/privacy
Kategorie IT provoz; Produktivita

Certyneo

Certyneo je služba elektronického podpisu kompatibilní s eIDAS. Tento konektor umožňuje toku odesílat dokumenty k podpisu, reagovat v reálném čase, když podepisující osoba jedná, a založit podepsaný SOUBOR PDF a jeho soubor důkazů všude, kde zbytek firmy uchovává své záznamy.

Typický tok je tři kroky: dokument se někam přistane (knihovna dokumentů, poštovní schránka, odeslání formuláře), tok vytvoří a odešle obálku a druhý tok aktivovaný stažením envelope.completed podepsaného SOUBORU PDF a uloží ho.

Vydavatel

Certyneo

Prerequisites

Potřebujete účet Certyneo v plánu, který zahrnuje přístup k rozhraní API. Plány Free a Personal můžou vytvářet klíče rozhraní API a odebírat události, ale pouze události pro obálky sandboxu – viz známé problémy a omezení níže.

Jak získat přihlašovací údaje

Konektor se ověřuje pomocí klíče rozhraní API Certyneo.

  1. Přihlaste se ke službě Certyneo a otevřete nastavení → klíče rozhraní API.
  2. Vytvořte klíč. Živé klíče začínají na sk_live_, klíče sandboxu s sk_test_.
  3. Když konektor požádá o klíč rozhraní API, vložte slovo Bearer, mezeru a pak klíč , například Bearer sk_live_abc123. Certyneo očekává slovo Bearer před klíčem a klíč vložený samostatně se odmítne se 401.

Klíč má obory. Klíč, který envelopes:write nemůže vytvořit ani odeslat, a klíč bez webhooks:write použití aktivační události nemůže vrátit zpět. Udělte rozsahům, které tok skutečně potřebuje.

Testování bez odeslání e-mailu komukoli

Klíč sandboxu (sk_test_) provádí cvičení celého kanálu bez odeslání jediného e-mailu s pozvánkou. Nic nedosáhne skutečné doručené pošty, což také znamená, že se nikdo nemůže spojit s podpisovou stránkou z e-mailu, takže místo toho vytvořte obálku a pošlete obálku , která vrátí přístupový token pro každého příjemce. Otevřete https://certyneo.com/sign/<access token> a podepište si obálku testu sami.

Považovat tento token za přihlašovací údaje: každý, kdo ho drží, může podepsat jako příjemce. Nepřihlašujte ho a nepřetáhněte ho do tabulky.

Podporované operace

Trigger

Když dojde k události obálky – aktivuje události, které vyberete, a místo dotazování se aktivuje skutečný webhook. Dostupné události:

envelope.created, envelope.sent, , envelope.completed, envelope.voidedenvelope.declined, envelope.expiredrecipient.signedrecipient.viewedenvelope.returned_to_senderenvelope.resubmitted, . recipient.approved

Každá datová část nese ID obálky na událostech obálky i příjemce. To je hodnota, která se má vložit do níže uvedených akcí.

Dodávky jsou podepsané HMAC-SHA256 v X-Certyneo-Signature hlavičce – šestnáctkový přehled nezpracovaného textu JSON s tajným kódem předplatného. Před tím, než tok funguje na datové části, ověřte ho.

Actions

Činnost Jak funguje
Seznam šablon Uložené šablony obálek. Umožňuje výběr šablony.
Vytvoření obálky Vytvoří obálku DRAFT ze šablony nebo z nahraných dokumentů.
Odeslat obálku Odešle obálku DRAFT příjemcům.
Získat obálku Aktuální stav a podrobnosti o příjemci
Výpis obálek Stránkovaný seznam, filtrovatelný podle stavu.
Nahrání dokumentu Nahraje SOUBOR PDF nebo obrázek a vrátí ID dokumentu.
Stažení podepsaného dokumentu Stránka certifikátu podepsaná ve formátu PDF, která je součástí.
Stažení záznamu pro audit Soubor důkazů: kdo podepsal, kdy, z jaké IP adresy, s jakými faktory.
Odstranit obálku konceptu Odstraní obálku, která nebyla nikdy odeslána.

Známé problémy a omezení

Odeslanou obálku nelze odvolat z toku.Odstranit obálku konceptu přijímá pouze obálky v konceptu – tok, který selhal v polovině, nesprávný dokument. Jakmile obálka zmizí, vrátí hodnotu 409 a v rozhraní API dnes není žádná operace zrušení.

recipient.signed aktivuje se před tím, než podepsaný SOUBOR PDF existuje, včetně posledního podepisujícího. Sestavení a zapečetění konečného dokumentu se stane po této události, takže tok, který se aktivuje recipient.signed a okamžitě volá Stažení podepsaného dokumentu , získá pokaždé 409. Toto není závod, který můžete vyhrát se zpožděním – trigger místo envelope.completed toho, který se aktivuje, jakmile je SOUBOR PDF na disku.

Bezplatné a osobní plány přijímají pouze události sandboxu. Oba můžou vytvořit předplatné a trigger se zobrazí jako v pořádku, ale živé obálky se k němu nikdy nedostanou. Pokud se trigger zdá, že s reálným provozem nic neprovádí, zkontrolujte plán před něčím jiným.

Používejte šablonu nebo dokumenty, nikdy obojí. Šablona přináší vlastní dokumenty a vlastní pole podpisu. Při sestavování z nahraných dokumentů je nutné zadat také pole – obálku, jejíž podepisující uživatel nemá nikoho podepsat, je odmítnut při odeslání s hodnotou 409 signer_without_field, nikoli v době vytvoření.

Upřednostněte ukotvení textu před souřadnicemi. Umístění pole pomocí uvozování fráze z dokumentu ("Signature du client") přežije změnu rozložení a nevyžaduje měření. X a Y zůstávají jako záložní pole, takže pole, jehož kotva nebyla nalezena, zachová pozici literálu místo toho, aby zmizela.

Nahrávání je omezené na 50 MB na dokument.

Vyprázdněný dokument vrátí hodnotu 410, nikoli 409. 409 znamená , že ještě není připraveno, vrať se po envelope.completed". 410 znamená, že podepsaný dokument byl záměrně odstraněn v rámci zásad uchovávání informací a nikdy se nevrátí zpět. Smyčka opakování by se měla vzdát 410.

Běžné chyby a nápravné prostředky

Response Cause Lék
401 Chybějící klíč nebo vložený bez Bearer předního Znovu zadejte připojení jako Bearer sk_live_...
403 Klíč nemá obor pro tuto operaci. Opětovné vystavení klíče s rozsahy, které tok potřebuje
409 ke stažení Obálka ještě není dokončena. envelope.completed Aktivace místo dotazování
409 při odeslání signer_without_field — podepisující osoby nemá žádné pole podpisu. Přidání polí nebo sestavení ze šablony
409 při odstranění Obálka již byla odeslána. Odeslané obálky nelze odstranit ani odvolat.
410 ke stažení Dokument byl vyprázdněný v rámci zásad uchovávání informací. Přestat opakovat; soubor je pryč.

Chyby mají jak zprávu čitelný error člověkem, tak stabilní code. code Rozvětvení – zprávu lze přepsat.

Support

Vytvoření připojení

Konektor podporuje následující typy ověřování:

Default Parametry pro vytvoření připojení Všechny oblasti Nesdílitelné

Výchozí

Použitelné: Všechny oblasti

Parametry pro vytvoření připojení

Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.

Name Typ Description Required
Klíč API securestring Klíč rozhraní API pro toto rozhraní API Pravdivé

Akce

Nahrání dokumentu

Nahrajte SOUBOR PDF nebo obrázek (maximálně 50 MB). Vrátí ID dokumentu – předejte ho do pole Vytvořit obálku v části Dokumenty.

Odeslat obálku

Odešle obálku DRAFT příjemcům k podpisu – jedná se o krok, který skutečně odešle e-mail. "Vytvořit obálku" uloží pouze jako koncept; neposílá nic sama. Tuto akci vždy zřetězte hned po vytvoření obálky ve vašem toku pomocí ID obálky, které vrátil.

Odstranit obálku konceptu

Odstraňte obálku, která se nikdy neodeslala – tok, který selhal v polovině cesty, nesprávný dokument. Koncept pouze: Jakmile se obálka vysadí, vrátí se chyba a nemůžete ji odvolat z toku.

Seznam šablon

Vrátí uložené šablony obálek. Slouží k zapnutí výběru šablony na "Vytvořit obálku".

Stažení podepsaného dokumentu

Získejte podepsanou stránku PDF, která je součástí certifikátu. Pouze po dokončení obálky – před tím, než vrátí hodnotu 409, takže se místo dotazování aktivujte při dokončení obálky.

Stažení záznamu pro audit

Získejte soubor důkazů pro dokončenou obálku – kdo podepsal, kdy, z jaké IP adresy, pomocí kterých ověřovacích faktorů. Archivujte ho vedle podepsaného PDF: je to, co se zapíná spor eIDAS.

Vytvoření obálky

Vytvořte novou obálku ve stavu KONCEPT, a to buď z uložené šablony, nebo přímo z dokumentů, které jste nahráli pomocí příkazu Nahrát dokument. Vyplňte přesně jednu ze šablon nebo dokumentů. V dokumentech přidejte také "Pole", aby každý podepisující uživatel někam podepisoval – nejjednodušší způsob je citovat frázi z dokumentu v "Ukotvení textu" místo toho, aby nevypracovává souřadnice. DŮLEŽITÉ: Tato akce vytvoří jenom obálku – zatím se neposílají žádné e-maily. Přidejte akci Poslat obálku hned za touto akcí ve vašem toku, abyste ji skutečně odeslali příjemcům.

Výpis obálek

Načtěte stránkovaný seznam obálek.

Získat obálku

Získejte aktuální stav a podrobnosti obálky.

Nahrání dokumentu

Nahrajte SOUBOR PDF nebo obrázek (maximálně 50 MB). Vrátí ID dokumentu – předejte ho do pole Vytvořit obálku v části Dokumenty.

Parametry

Název Klíč Vyžadováno Typ Description
Soubor
file True file

Soubor PDF nebo obrázek, který chcete nahrát, maximálně 50 MB.

Název dokumentu
name string

Název pro vytvoření dokumentu pod. Výchozí hodnota je vlastní název nahraného souboru.

Návraty

Body
Document

Odeslat obálku

Odešle obálku DRAFT příjemcům k podpisu – jedná se o krok, který skutečně odešle e-mail. "Vytvořit obálku" uloží pouze jako koncept; neposílá nic sama. Tuto akci vždy zřetězte hned po vytvoření obálky ve vašem toku pomocí ID obálky, které vrátil.

Parametry

Název Klíč Vyžadováno Typ Description
ID obálky
id True string

Identifikátor konceptu obálky pro odeslání příjemcům.

Návraty

Body
Envelope

Odstranit obálku konceptu

Odstraňte obálku, která se nikdy neodeslala – tok, který selhal v polovině cesty, nesprávný dokument. Koncept pouze: Jakmile se obálka vysadí, vrátí se chyba a nemůžete ji odvolat z toku.

Parametry

Název Klíč Vyžadováno Typ Description
ID obálky
id True string

Identifikátor obálky konceptu, která se má odstranit.

Návraty

Seznam šablon

Vrátí uložené šablony obálek. Slouží k zapnutí výběru šablony na "Vytvořit obálku".

Návraty

Stažení podepsaného dokumentu

Získejte podepsanou stránku PDF, která je součástí certifikátu. Pouze po dokončení obálky – před tím, než vrátí hodnotu 409, takže se místo dotazování aktivujte při dokončení obálky.

Parametry

Název Klíč Vyžadováno Typ Description
ID obálky
id True string

Identifikátor obálky, jejíž podepsaný dokument chcete stáhnout.

Návraty

response
binary

Stažení záznamu pro audit

Získejte soubor důkazů pro dokončenou obálku – kdo podepsal, kdy, z jaké IP adresy, pomocí kterých ověřovacích faktorů. Archivujte ho vedle podepsaného PDF: je to, co se zapíná spor eIDAS.

Parametry

Název Klíč Vyžadováno Typ Description
ID obálky
id True string

Identifikátor obálky, jejíž záznam auditu chcete stáhnout.

Návraty

response
binary

Vytvoření obálky

Vytvořte novou obálku ve stavu KONCEPT, a to buď z uložené šablony, nebo přímo z dokumentů, které jste nahráli pomocí příkazu Nahrát dokument. Vyplňte přesně jednu ze šablon nebo dokumentů. V dokumentech přidejte také "Pole", aby každý podepisující uživatel někam podepisoval – nejjednodušší způsob je citovat frázi z dokumentu v "Ukotvení textu" místo toho, aby nevypracovává souřadnice. DŮLEŽITÉ: Tato akce vytvoří jenom obálku – zatím se neposílají žádné e-maily. Přidejte akci Poslat obálku hned za touto akcí ve vašem toku, abyste ji skutečně odeslali příjemcům.

Parametry

Název Klíč Vyžadováno Typ Description
Subject
subject True string

Předmět obálky / název.

Message
message string

Zpráva zobrazená příjemcům

Template
templateId string

Vyberte uloženou šablonu. Použijte tuto možnost NEBO "Dokumenty", ne obojí – šablona přináší vlastní dokumenty a pole podpisu.

Documents
documentIds array of string

ID dokumentů z možnosti Nahrát dokument Použijte tuto možnost NEBO šablonu, ne obě. Pokud používáte dokumenty, přidejte také pole – obálku, jejíž podepisující uživatel nemá v době odeslání žádné pole podpisu.

E-mail podepisující osoby
recipientEmail True string

Musí přesně odpovídat jednomu z výše uvedených příjemců.

Číslo dokumentu
documentIndex integer

Který dokument nese toto pole, počítá se od 0 v pořadí uvedeném výše. Pokud existuje jenom jeden dokument, nechte prázdný.

Stránka
pageNumber True integer
Typ pole
fieldType True string
Ukotvení textu (doporučeno)
anchorText string

Text, který se má v dokumentu hledat – pole je vedle něj umístěné, takže nepotřebujete souřadnice. Nerozlišují se malá a velká písmena a našli se i v případě, že PDF rozdělí frázi napříč běhy. Místo toho nechejte prázdné, abyste místo toho použili X/Y.

Umístění ukotvení
anchorPlacement string

Kam umístit pole vzhledem k textu ukotvení

Ukotvení výskytu
anchorIndex integer

Který výskyt se má použít, počítá se od 0, když se text ukotvení zobrazí několikrát.

X
x True number

Body od levého okraje. Ignorováno při nalezení ukotvení – zachováno jako záložní, aby pole nikdy zmizelo.

Й
y True number

Body od horního okraje. Ignorováno při nalezení ukotvení – uchovávané jako záložní.

Šířka
width True number
Výška
height True number
E-mail příjemce
email True string
Jméno příjemce
name string
Úloha
role string
stav
status string
SignedAt
signedAt string
Token přístupu
accessToken string

Otevře podpisovou stránku tohoto příjemce na https://certyneo.com/sign/<tokenu>. V sandboxu nevyjde žádný e-mail s pozvánkou, takže tímto způsobem sami podepíšete testovací obálku. Vrátí text "Vytvořit obálku" a "Poslat obálku" – ne "Získat obálku", kde zůstane prázdný. Považovat ho za přihlašovací údaje: každý, kdo ho drží, může podepsat jako tento příjemce, takže ho nezaznamujte ani nezahazujte do tabulky.

Úroveň podpisu
signatureLevel string
Platnost končí
expiresAt date-time
Kategorie
category string

Obchodní klasifikace zobrazená v seznamu obálek Nechte prázdné a Certyneo odvozuje jeden z předmětu.

Značky
tags array of string

Popisky volného formuláře – kód projektu, referenční informace o zákaznících, interní stav Až 10 znaků, každý až 40 znaků. Dolní a duplicitní serverová strana.

Jazyk
locale string

Jazyk všeho, co uvidí podepisující člen: podpisová stránka, pozvánka, připomenutí, e-mail o dokončení. Kód BCP-47, např. nl, nl-BE, en-GB, de, fr. Ponechte prázdný jazyk účtu Certyneo, který obálku odesílá. Nepodporovaný kód je odmítnut se 400.

Adresa URL pro přesměrování
redirectUrl string

Kde se podepisující osoby po podepsání odešlou. Nahradí výchozí tlačítko Certyneo call-to-action jediným tlačítkem Continue odkazující sem. Musí začínat https:// – cokoli jiného je odmítnuto se 400.

Iniciály na každé stránce
initialsOnEveryPage boolean

Automaticky označí iniciály podepisující osoby v dolní části každé stránky každého dokumentu a kromě libovolného pole, které umístíte sami. Není potřeba nastavit jednotlivé stránky – podepisující uživatel vyplní své iniciály jednou a platí všude. Přeskočí stránku, na které už podepisující strana obsahuje pole (např. podpis na poslední stránce).

Workspace
workspaceId string

Vytvořte obálku ve sdíleném pracovním prostoru, aby ho každý člen tohoto pracovního prostoru mohl zobrazit a zpracovat. Nechte ho prázdné, abyste ho měli ve svém vlastním účtu. Pracovní prostor musíte vlastnit nebo být jeho členem.

Návraty

Body
Envelope

Výpis obálek

Načtěte stránkovaný seznam obálek.

Parametry

Název Klíč Vyžadováno Typ Description
Stránka
page integer

Která stránka výsledků se má vrátit. Začíná na 1.

Velikost stránky
limit integer

Kolik obálek se má vrátit na stránku

Status
status string

Vrátí pouze obálky v tomto stavu. Pokud chcete vrátit všechny stavy, nechejte prázdné.

Návraty

Získat obálku

Získejte aktuální stav a podrobnosti obálky.

Parametry

Název Klíč Vyžadováno Typ Description
ID obálky
id True string

Identifikátor obálky, která se má načíst.

Návraty

Body
Envelope

Aktivační události

Když dojde k události obálky

Aktivuje tok při každém výskytu jedné z vybraných událostí na libovolné obálce (např. podepsané, dokončené, odmítnuté). Podporuje webhook v reálném čase – bez dotazování.

Když dojde k události obálky

Aktivuje tok při každém výskytu jedné z vybraných událostí na libovolné obálce (např. podepsané, dokončené, odmítnuté). Podporuje webhook v reálném čase – bez dotazování.

Parametry

Název Klíč Vyžadováno Typ Description
Events
events True array of string

Které události obálky a příjemce by měly tento tok aktivovat.

Návraty

Doručeno se sadou HMAC-SHA256 v hlavičce X-Certyneo-Signature (šestnáctkový přehled nezpracovaného textu JSON s klíčem předplatného). Před vztahem důvěryhodnosti datové části v toku, který na ní funguje (viz /developers/webhooks), ověřte ji.

Definice

DeleteResult

Název Cesta Typ Description
Success
success boolean

True when the resource was deleted.

Pagination

Název Cesta Typ Description
celkový
total integer
stránka
page integer
pageSize
pageSize integer
stránky
pages integer

Template

Název Cesta Typ Description
id
id string
název
name string
description
description string
signerCount
signerCount integer
documentCount
documentCount integer

TemplateList

Název Cesta Typ Description
data
data array of Template
stránkování
pagination Pagination

Recipient

Název Cesta Typ Description
E-mail příjemce
email string
Jméno příjemce
name string
Úloha
role string
stav
status string
SignedAt
signedAt string
Token přístupu
accessToken string

Otevře podpisovou stránku tohoto příjemce na https://certyneo.com/sign/<tokenu>. V sandboxu nevyjde žádný e-mail s pozvánkou, takže tímto způsobem sami podepíšete testovací obálku. Vrátí text "Vytvořit obálku" a "Poslat obálku" – ne "Získat obálku", kde zůstane prázdný. Považovat ho za přihlašovací údaje: každý, kdo ho drží, může podepsat jako tento příjemce, takže ho nezaznamujte ani nezahazujte do tabulky.

Doklad

Název Cesta Typ Description
id
id string
název
name string
Mimetype
mimeType string
size
size integer
stav
status string

Obálka

Název Cesta Typ Description
id
id string
subject
subject string
zpráva
message string
stav
status string
signatureLevel
signatureLevel string
recipients
recipients array of Recipient
expiresAt
expiresAt string
createdAt
createdAt string
completedAt
completedAt string

ObálkaList

Název Cesta Typ Description
data
data array of Envelope
stránkování
pagination Pagination

WebhookEventPayload

Doručeno se sadou HMAC-SHA256 v hlavičce X-Certyneo-Signature (šestnáctkový přehled nezpracovaného textu JSON s klíčem předplatného). Před vztahem důvěryhodnosti datové části v toku, který na ní funguje (viz /developers/webhooks), ověřte ji.

Název Cesta Typ Description
událost
event string
časové razítko
timestamp date-time
ID obálky
data.envelopeId string

Vždy přítomný. Můžete ho vložit do "Získat obálku" nebo "Stáhnout podepsaný dokument".

Subject
data.subject string

Prezentovat pouze u událostí obálky.

Status
data.status string
Úroveň podpisu
data.signatureLevel string

Prezentovat na obálce.completed a příjemce.signed.

Pokročilé podpisové podepisující osoby s osobním klíčem
data.aesSignerCount integer

envelope.completed on an ADVANCED envelope only.

Serial certifikátu s rozšířeným podpisem
data.aesCertificateSerial string

příjemce.signed, když podepisující uživatel podepsal pomocí osobního klíče rozšířeného podpisu.

Rozšířený podpisový certifikát SHA256
data.aesCertificateSha256 string

příjemce.signed, když podepisující uživatel podepsal pomocí osobního klíče rozšířeného podpisu.

Manifest pokročilého podpisu SHA256
data.aesManifestSha256 string

příjemce.signed, když podepisující uživatel podepsal pomocí osobního klíče rozšířeného podpisu.

Časové razítko rozšířeného podpisu
data.aesTimestamped boolean

příjemce.signed, když podepisující uživatel podepsal pomocí osobního klíče rozšířeného podpisu.

Počet příjemců
data.recipientCount integer

Prezentovat pouze u událostí obálky.

Počet podepsaných
data.signedCount integer

Prezentovat pouze u událostí obálky.

ID příjemce
data.recipientId string

Prezentovat pouze u událostí příjemců.

E-mail příjemce
data.email string

Prezentovat pouze u událostí příjemců.

Jméno příjemce
data.name string

Prezentovat pouze u událostí příjemců.

Role příjemce
data.role string

Prezentovat pouze u událostí příjemců.

Podepsáno na adrese
data.signedAt date-time

Prezentovat pouze u událostí příjemců.

Zobrazit na adrese
data.viewedAt date-time

Prezentovat pouze u událostí příjemců.

binární

Toto je základní datový typ Binary.