PolyDoc (niezależny Publisher) (wersja zapoznawcza)

Przekonwertuj kod HTML lub adres URL na doskonałe pliki PDF i zrzuty ekranu oraz wygeneruj hybrydowe faktury hybrydowe (ZUGFeRD / Factur-X). Narzędzie PolyDoc renderuje się za pomocą rzeczywistego aparatu przeglądarki, więc to, co widzisz na stronie, jest tym, co otrzymujesz w dokumencie.

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)
Kontakt biznesowy
Nazwa PolyDoc
adres URL https://polydoc.tech
Email hello@polydoc.tech
Metadane łącznika
Publisher niebieski-d3v
Witryna internetowa https://polydoc.tech
Zasady ochrony prywatności https://polydoc.tech/legal/privacy-policy/
Kategorie Zawartość i pliki

PolyDoc

Narzędzie PolyDoc zamienia kod HTML lub adres URL na doskonałe pliki PDF i zrzuty ekranu oraz generuje hybrydowe faktury hybrydowe zgodne z UE (ZUGFeRD / Factur-X). Konwersje są renderowane w rzeczywistym aucie przeglądarki, więc to, co widzisz na stronie, jest tym, co otrzymujesz w dokumencie.

Publisher

PolyDoc

Wymagania wstępne

Potrzebujesz konta PolyDoc i klucza interfejsu API. Warstwa Bezpłatna wystarczy, aby ocenić łącznik. Łączniki niestandardowe są funkcją premium Power Automate, dlatego przepływy korzystające z tego łącznika wymagają planu Power Automate Premium (dla użytkownika lub przepływu), tak samo jak wbudowana akcja HTTP.

Uzyskiwanie poświadczeń

  1. Zaloguj się pod adresem dashboard.polydoc.tech.
  2. Otwórz klucze interfejsu API i utwórz klucz.
  3. Podczas tworzenia połączenia wklej klucz do klucza interfejsu API PolyDoc. Wklej tylko klucz; łącznik dodaje Bearer prefiks.

Obsługiwane operacje

Operation Do czego służy
Konwertowanie na format PDF Renderowanie kodu HTML, adresu URL lub zapisanego szablonu w pliku PDF. Kontrolki dotyczące formatu strony, marginesów, skalowania, nagłówków/stopek, zakładek, dostępnych (oznakowanych) plików PDF, metadanych, szyfrowania, znaków wodnych i plików PDF/A.
Zrzut ekranu przechwytywania Przechwyć plik PNG, JPEG lub WebP kodu HTML, adres URL lub szablon. Pełna strona lub obcięta z kontrolką viewport i device-pixel-ratio.

Faktury e-są generowane przy użyciu opcji Konwertuj na format PDF: wypełnij pola faktury E( standardowa, profil i obiekt ustrukturyzowany invoice ), a narzędzie PolyDoc osadza fakturę ZUGFeRD / Factur-X w zwróconym pliku PDF. example-flows/ Zobacz folder w repozytorium łączników, aby zapoznać się z treścią gotową do użycia.

Źródło

Każda operacja przyjmuje jedno źródło , które jest jednym z:

  • adres URL, np. https://example.com
  • wbudowany ciąg HTML
  • zapisane odwołanie do szablonu, [template:TEMPLATE_ID], opcjonalnie z danymi szablonu dla modułu renderowania Liquid

Dostawa

Domyślnie plik jest zwracany jako zawartość binarna, gotowy do upuszczania do pozycji Utwórz plik (OneDrive, SharePoint, Obiekt blob) lub załącznik wiadomości e-mail. Dwa alternatywne tryby dostarczania są dostępne w obszarze opcji zaawansowanych:

  • Magazyn w chmurze: podaj wstępnie podpisany adres URL PUT; Narzędzie PolyDoc przekazuje plik, a akcja zwraca kod JSON zawierający przechowywany adres URL.
  • Element webhook: narzędzie PolyDoc dostarcza plik do elementu webhook, a akcja zwraca potwierdzenie JSON (HTTP 202, gdy async).

Gdy używany jest dowolny tryb dostarczania, odpowiedź to JSON, a nie plik binarny.

Tryb piaskownicy

Każda operacja ma zaawansowane dane wejściowe trybu piaskownicy . Ustaw go na wartość , aby true wygenerować dane wyjściowe z oddzielnego limitu przydziału z niższym limitem szybkości, co jest przydatne podczas kompilowania i testowania przepływu. Pozostaw je false w dokumentach produkcyjnych.

Znane problemy i ograniczenia

  • Odpowiedź każdej akcji jest zadeklarowana jako plik binarny. Po skonfigurowaniu magazynu w chmurze lub dostarczania elementu webhook akcja zwraca kod JSON zamiast pliku.
  • Strony ładujące kod JavaScript z zewnętrznej sieci CDN mogą znacznie spowalniać konwerter. W przypadku wbudowanego kodu HTML preferuj własne znaczniki (wbudowane obrazy CSS, data-URI).
  • Faktury elektroniczne są zgodne z EN 16931. Podaj co najmniej datę ukończenia lub warunki płatności (reguła BR-CO-25), identyfikator podatkowy sprzedawcy, gdy wiersz używa kategorii SVAT i spójne sumy (netto + podatek = brutto). Po włączeniu opcji Weryfikuj włączono fakturę, która kończy się niepowodzeniem, zwraca błąd.

Instrukcje dotyczące wdrażania

Ten łącznik jest definiowany jako standardowy łącznik niestandardowy platformy Power Platform (apiDefinition.swagger.jsonicon.png + apiProperties.json + ). Wdróż go za pomocą interfejsu wiersza polecenia łączników platformy Power Platform:

# one-time login
paconn login

# validate the definition
paconn validate --api-def apiDefinition.swagger.json

# create the connector in the selected environment
paconn create --api-def apiDefinition.swagger.json \
  --api-prop apiProperties.json --icon icon.png --secret <none>

Możesz również zaimportować apiDefinition.swagger.json bezpośrednio z portalu usługi Power Automate maker (Łączniki > niestandardowe danych > Nowy łącznik > niestandardowy Import pliku OpenAPI).

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.

Nazwa Typ Opis Wymagane
Klucz interfejsu API polyDoc securestring Klucz interfejsu API PolyDoc. Utwórz je na dashboard.polydoc.tech w obszarze Klucze interfejsu API. Wklej tylko klucz; łącznik dodaje prefiks "Bearer". True

Akcje

Konwertuj na plik PDF

Renderowanie kodu HTML, adresu URL lub zapisanego szablonu w pliku PDF. Wypełnij pola E-invoice, aby osadzić fakturę hybrydową ZUGFeRD/Factur-X zamiast zwykłego pliku PDF. Zwraca plik jako zawartość binarną.
Zrzut ekranu przechwytywania

Renderowanie kodu HTML, adresu URL lub zapisanego szablonu i przechwytywanie zrzutu ekranu PNG, JPEG lub WebP. Zwraca obraz jako zawartość binarną.

Konwertuj na plik PDF

Identyfikator operacji:
ConvertToPdf

Renderowanie kodu HTML, adresu URL lub zapisanego szablonu w pliku PDF. Wypełnij pola E-invoice, aby osadzić fakturę hybrydową ZUGFeRD/Factur-X zamiast zwykłego pliku PDF. Zwraca plik jako zawartość binarną.

Parametry

Nazwa Klucz Wymagane Typ Opis
Tryb piaskownicy
 X-Sandbox string

Uruchom konwersję w trybie piaskownicy. Dane wyjściowe piaskownicy są oznaczone znakiem wodnym i pobierane z oddzielnego limitu przydziału z niższym limitem szybkości. Użyj wartości false dla dokumentów produkcyjnych.
Źródło
 source True string

Adres URL (https://...), wbudowany ciąg HTML lub zapisane odwołanie do szablonu w formularzu [template:TEMPLATE_ID].
Filename
 filename string

Nazwa pliku wyjściowego, np. invoice.pdf.
Dane szablonu
 templateData object

Dane klucza/wartości przekazane do modułu renderowania szablonu Liquid, gdy źródło jest odwołaniem [template:ID].
Tag
 tag string

Etykieta rejestrowania i analizy (maksymalnie 30 znaków).
Limit czasu (ms)
 timeout integer

Limit czasu konwersji w milisekundach (maks. 600000).
Format papieru
 format string

Format papieru. Wartość domyślna to A4.
Krajobraz
 landscape boolean

Użyj orientacji poziomej.
Drukuj tło
 printBackground boolean

Drukuj grafikę tła i kolory.
Scale
 scale number

Skalowanie renderowania z zakresu od 0,1 do 2.
Zakresy stron
 pageRanges string

Strony do uwzględnienia, np. "1–5, 8". Puste oznacza wszystkie strony.
Konspekt (zakładki)
 outline boolean

Wygeneruj zakładki PDF z nagłówków HTML.
Oznakowane (dostępne)
 tagged boolean

Utwórz oznakowany (dostępny) plik PDF.
Preferuj rozmiar strony CSS
 preferCSSPageSize boolean

Uhonoruj @page rozmiar zadeklarowany w arkuszu CSS w formacie Paper.
Pomiń tło
 omitBackground boolean

Renderuj z przezroczystym tłem.
Wyświetlanie nagłówka/stopki
 displayHeaderFooter boolean

Renderuj szablony nagłówka i stopki.
Szablon nagłówka
 headerTemplate string

Kod HTML dla nagłówka strony. Wymaga wyświetlania nagłówka/stopki.
Szablon stopki
 footerTemplate string

Kod HTML stopki strony. Wymaga wyświetlania nagłówka/stopki.
Do góry
 top string
Prawo
 right string
Dół
 bottom string
Lewo
 left string
Title
 title string
Author
 author string
Temat
 subject string
Słowa kluczowe
 keywords array of string
Producer
 producer string
Kreator
 creator string
Hasło użytkownika
 userPassword string
Hasło właściciela
 ownerPassword string
Źródło
 source True string

Tekst znaku wodnego lub adres URL obrazu/identyfikator URI danych.
Typ
 type True string
Opcje
 options object

Czcionka, nieprzezroczystość, rotacja, skalowanie, powtórzenie i opcje przesunięcia.
Level
 level True string
Weryfikowanie zgodności
 verify boolean
Weryfikowanie zgodności
 verify boolean

Sprawdź poprawność względem formatu PDF/UA-1 veraPDF; Zwraca błąd, jeśli walidacja zakończy się niepowodzeniem.
Standard
 standard True string

Standardowa faktury hybrydowej.
Profile
 profile True string

Profil szczegółowości danych do weryfikacji.
Weryfikowanie zgodności
 verify boolean

Zweryfikuj zgodność plików PDF/A i faktur e-faktur; Zwraca błąd, jeśli walidacja zakończy się niepowodzeniem.
Numer faktury
 number True string
Data wydania
 issueDate True string

Data wydania, RRRR-MM-DD.
Data wymagalności
 dueDate string

Data ukończenia, RRRR-MM-DD. Podaj to lub Warunki płatności (EN 16931 reguła BR-CO-25).
Waluta
 currencyCode True string

Kod waluty ISO 4217, np. EUR.
Nazwa
 name True string
Linia adresowa 1
 line1 True string
Wiersz adresu 2
 line2 string
City
 city True string
Kod pocztowy
 postalCode True string
Kod kraju
 countryCode True string

Kod kraju ISO 3166-1 alfa-2, np. DE.
Identyfikator podatkowy
 taxId string

Identyfikator VAT. Wymagane dla sprzedawcy, gdy wiersz używa kategorii VAT S.
Email
 email string
Phone
 phone string
Opis
 description True string
Ilość
 quantity True number
Kod jednostkowy
 unitCode string

Kod jednostki UN/ECE, np. C62 (kawałek).
Cena jednostkowa
 unitPrice True number
Suma wierszy
 lineTotal True number
Stawka VAT (%)
 vatRate number
Kategoria VAT
 vatCategoryCode string

Kod kategorii VAT, np. S (standardowy), Z (zero), E (zwolniony).
Kod kategorii
 categoryCode True string
Rate (%)
 rate True number
Kwota podlegających opodatkowaniu
 taxableAmount True number
Kwota podatku
 taxAmount True number
Warunki płatności
 paymentTerms string

Warunki płatności w postaci tekstu. Podaj tę lub Termin ukończenia.
Wpisz kod
 typeCode True string

Kod środków płatności UN/ECE 4461, np. 30 (przelew kredytowy).
IBAN
 iban string
BIC
 bic string
Nazwa konta
 accountName string
Odwołanie do płatności
 paymentReference string
Łączna liczba netto
 totalNetAmount True number
Podatek ogółem
 totalTaxAmount True number
Łączna wartość brutto
 totalGrossAmount True number

Musi być równe netto i podatek.
Note
 note string
Dokumentacja nabywcy
 buyerReference string

Dokumentacja nabywcy / Leitweg-ID dla faktur sektora publicznego.
Wyłączanie języka JavaScript
 disableJavascript boolean
Wstrzykiwanie css
 css string

Dodatkowy kod CSS wstrzyknięty do strony.
Wstrzykiwanie kodu JavaScript
 javascript string

Skrypt JavaScript wykonany na stronie przed przechwyceniem.
Czekaj na selektor
 waitForSelector string

Poczekaj na wyświetlenie tego selektora CSS.
Czekaj na funkcję
 waitForFunction string

Poczekaj, aż to wyrażenie JS zwróci wartość true.
Typ nośnika
 mediaType string
Blokuj reklamy
 blockAds boolean
Agent użytkownika
 userAgent string
Nagłówki HTTP
 httpHeaders object

Dodatkowe nagłówki HTTP jako pary klucz/wartość.
Nazwa
 name True string
Wartość
 value True string
adres URL
 url string
Domena
 domain string
Ścieżka
 path string
Wygasa (epoka)
 expires number
Tylko protokół HTTP
 httpOnly boolean
Secure
 secure boolean
SameSite (Taka sama strona)
 sameSite string
Typ
 type string
Nazwa użytkownika
 username True string
Hasło
 password True string
Webhook URL
 url True string
Async
 async boolean

Dostarczaj w tle i natychmiast zwracaj 202.
Metoda
 method string
Nagłówki
 headers object

Dodatkowe nagłówki dla żądania elementu webhook.
Limit czasu (ms)
 timeout number
Ponowne próby
 retries integer
Opóźnienie ponawiania prób (ms)
 retryDelay number
Wstępnie podpisany adres URL
 presignedUrl True string

Adres URL presigned HTTP PUT od dostawcy magazynu.

Zwraca

response
binary

Zrzut ekranu przechwytywania

Identyfikator operacji:
CaptureScreenshot

Renderowanie kodu HTML, adresu URL lub zapisanego szablonu i przechwytywanie zrzutu ekranu PNG, JPEG lub WebP. Zwraca obraz jako zawartość binarną.

Parametry

Nazwa Klucz Wymagane Typ Opis
Tryb piaskownicy
 X-Sandbox string

Uruchom konwersję w trybie piaskownicy. Dane wyjściowe piaskownicy są oznaczone znakiem wodnym i pobierane z oddzielnego limitu przydziału z niższym limitem szybkości. Użyj wartości false dla dokumentów produkcyjnych.
Źródło
 source True string

Adres URL (https://...), wbudowany ciąg HTML lub zapisane odwołanie do szablonu w formularzu [template:TEMPLATE_ID].
Filename
 filename string

Nazwa pliku wyjściowego, np. screenshot.png.
Dane szablonu
 templateData object

Dane klucza/wartości przekazane do modułu renderowania szablonu Liquid, gdy źródło jest odwołaniem [template:ID].
Typ obrazu
 type string

Format obrazu. Domyślnie jest to png.
Pełna strona
 fullPage boolean

Przechwyć całą stronę przewijaną.
Jakość
 quality integer

Jakość kompresji 0-100 dla JPEG/WebP.
Pomiń tło
 omitBackground boolean

Przechwytywanie z przezroczystym tłem (PNG/WebP).
Szerokość (px)
 width integer
Wysokość (px)
 height integer
Współczynnik pikseli urządzenia
 devicePixelRatio number
X
 x number
Y
 y number
Szerokość
 width number
Wysokość
 height number
Scale
 scale number
Tag
 tag string

Etykieta rejestrowania i analizy (maksymalnie 30 znaków).
Limit czasu (ms)
 timeout integer

Limit czasu konwersji w milisekundach (maks. 600000).
Wyłączanie języka JavaScript
 disableJavascript boolean
Wstrzykiwanie css
 css string

Dodatkowy kod CSS wstrzyknięty do strony.
Wstrzykiwanie kodu JavaScript
 javascript string

Skrypt JavaScript wykonany na stronie przed przechwyceniem.
Czekaj na selektor
 waitForSelector string

Poczekaj na wyświetlenie tego selektora CSS.
Czekaj na funkcję
 waitForFunction string

Poczekaj, aż to wyrażenie JS zwróci wartość true.
Typ nośnika
 mediaType string
Blokuj reklamy
 blockAds boolean
Agent użytkownika
 userAgent string
Nagłówki HTTP
 httpHeaders object

Dodatkowe nagłówki HTTP jako pary klucz/wartość.
Nazwa
 name True string
Wartość
 value True string
adres URL
 url string
Domena
 domain string
Ścieżka
 path string
Wygasa (epoka)
 expires number
Tylko protokół HTTP
 httpOnly boolean
Secure
 secure boolean
SameSite (Taka sama strona)
 sameSite string
Typ
 type string
Nazwa użytkownika
 username True string
Hasło
 password True string
Webhook URL
 url True string
Async
 async boolean

Dostarczaj w tle i natychmiast zwracaj 202.
Metoda
 method string
Nagłówki
 headers object

Dodatkowe nagłówki dla żądania elementu webhook.
Limit czasu (ms)
 timeout number
Ponowne próby
 retries integer
Opóźnienie ponawiania prób (ms)
 retryDelay number
Wstępnie podpisany adres URL
 presignedUrl True string

Adres URL presigned HTTP PUT od dostawcy magazynu.

Zwraca

response
binary

Definicje

binarny

Jest to podstawowy typ danych "binary".