PolyDoc（獨立Publisher）（預覽）

將 HTML 或 URL 轉換為像素級的 PDF 與截圖，並產生符合歐盟標準的混合電子發票（ZUGFeRD / Factur-X）。 PolyDoc 是用真正的瀏覽器引擎渲染的，所以你在頁面上看到的，就是文件裡看到的。

此連接器適用於以下產品和區域：

Service Class 地區
Copilot Studio 進階 除下列區域外的所有 Power Automate 區域 ：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
邏輯應用程式 標準 所有 Logic Apps 區域， 但下列區域除外：
     - Azure Government 區域
     - Azure 中國區域
     - 美國國防部 （DoD）
Power Apps 進階 除下列區域外的所有 Power Apps 區域 ：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
Power Automate（自動化服務） 進階 除下列區域外的所有 Power Automate 區域 ：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
聯絡方式
名字 PolyDoc
URL https://polydoc.tech
Email hello@polydoc.tech
連接器中繼資料
發行者 Blue-D3V
網站 https://polydoc.tech
隱私權原則 https://polydoc.tech/legal/privacy-policy/
類別 內容和文件

PolyDoc

PolyDoc 將 HTML 或網址轉換為像素級的 PDF 與截圖，並產生符合歐盟規範的混合電子發票（ZUGFeRD / Factur-X）。 轉換是在真實的瀏覽器引擎中渲染的，所以你在頁面上看到的，就是文件中得到的。

發行者

PolyDoc

Prerequisites

你需要一個 PolyDoc 帳號和 API 金鑰。 免費方案足以評估接頭。 自訂連接器是 Power Automate 的高級功能，因此使用此連接器的流程需要 Power Automate Premium 方案（按使用者或按流程計算），與內建的 HTTP 動作相同。

取得認證

  1. 請於 dashboard.polydoc.tech 登入。
  2. 打開 API 金鑰 並建立一個金鑰。
  3. 建立連線後，將金鑰貼到 PolyDoc API 金鑰中。 只貼上鑰匙;連接器會 Bearer 幫你加上前綴。

支援的作業

Operation 其功能是什麼
轉換為 PDF 將 HTML、URL 或儲存的範本渲染成 PDF。 包含頁面格式、邊距、縮放比例、頁首/頁腳、書籤、可存取（標籤）PDF、元資料、加密、浮水印及 PDF/A 控制。
截圖截圖 擷取 PNG、JPEG 或 WebP（HTML）、URL 或範本。 全頁或裁剪版，並可控制視窗與裝置像素比例。

電子發票是透過「轉換成 PDF」製作：填寫電子發票欄位（標準發票、個人資料及結構invoice化物件），PolyDoc 會在回傳的 PDF 中嵌入 ZUGFeRD / Factur-X 發票。 請參閱連接器儲存庫中的 example-flows/ 資料夾，裡面有一個現成可用的主體。

Source

每個操作都使用單一來源，該 來源 為以下之一：

  • 一個網址，例如 https://example.com
  • 一個內嵌 HTML 字串
  • 一個儲存的範本參考，[template:TEMPLATE_ID]可選擇性地包含 Liquid 渲染器的範本資料

配送

預設情況下，檔案會以二進位內容回傳，隨時可直接放入 Create 檔案（OneDrive、SharePoint、Blob）或電子郵件附件中。 進階選項中有兩種替代的傳遞方式：

  • 雲端儲存：提供預簽的 PUT URL;PolyDoc 上傳檔案後，動作回傳包含儲存 URL 的 JSON。
  • Webhook：PolyDoc 會將檔案傳送到你的 webhook，動作會回傳 JSON 確認（非同步時為 HTTP 202）。

無論使用哪一種傳遞方式，回應都是 JSON 而非二進位檔案。

沙盒模式

每個操作都有進階的 沙盒模式 輸入。 設定為 true 從一個較低速率限制的獨立配額產生浮水印輸出，這在建立和測試流程時很有用。 留 false 給製作文件用。

已知問題和限制

  • 每個動作的回應會以二進位檔案形式宣告。 當雲端 儲存 或 Webhook 交付被設定時，動作會回傳 JSON 而非檔案。
  • 從外部 CDN 載入 JavaScript 的頁面會大幅降低轉換器速度。 對於內嵌 HTML，建議使用自包含的標記（內嵌 CSS、data-URI 影像）。
  • 電子發票遵循EN 16931標準。 至少要提供到期日或付款條件（規則 BR-CO-25）、使用增值稅類別 S的賣方稅號，以及一致的總額（淨 + 稅 = 毛額）。 啟用 Verify 後，驗證失敗的發票會回傳錯誤。

部署指令

此連接器被定義為標準的 Power Platform 客製化連接器（apiDefinition.swagger.jsonicon.png + apiProperties.json + ）。 請使用Power Platform Connectors CLI來部署：

# 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>

你也可以直接從 Power Automate maker 入口網站匯入apiDefinition.swagger.json（資料>自訂連接器，>新自訂連接器>，匯入 OpenAPI 檔案）。

正在建立連線

連接器支援下列驗證類型：
預設值 建立連線的參數。 所有地區 不可共享

預設

適用：所有地區

建立連線的參數。

這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

名字 類型 描述 Required
PolyDoc API 金鑰 安全字串 你的 PolyDoc API 金鑰。 在 dashboard.polydoc.tech 的 API 金鑰下建立一個。 只貼上鑰匙;連接器會為你加上「承載者」前綴。 沒錯

動作

截圖截圖

渲染 HTML、URL 或儲存的範本，並擷取 PNG、JPEG 或 WebP 截圖。 會將圖片以二進位內容回傳。
轉換為 PDF

將 HTML、URL 或儲存的範本渲染成 PDF。 填入電子發票欄位，嵌入 ZUGFeRD / Factur-X 混合發票，取代一般 PDF。 會以二進位內容回傳檔案。

截圖截圖

作業識別碼：
CaptureScreenshot

渲染 HTML、URL 或儲存的範本，並擷取 PNG、JPEG 或 WebP 截圖。 會將圖片以二進位內容回傳。

參數

名稱 機碼 必要 類型 Description
沙盒模式
 X-Sandbox string

在沙盒模式下執行轉換。 沙盒輸出會有浮水印，並從一個較低速率限制的獨立配額抽取。 製作文件使用假。
Source
 source True string

網址（https://...）、內嵌 HTML 字串，或以 [template：TEMPLATE_ID] 格式儲存的模板參考。
檔案名稱
 filename string

輸出檔名，例如 screenshot.png。
範本資料
 templateData object

當 Source 是 [template：ID] 參考時，鍵值資料會傳入 Liquid 模板渲染器。
影像類型
 type string

圖片格式。 預設是 png。
整頁
 fullPage boolean

擷取整個可捲動頁面。
Quality
 quality integer

JPEG/WebP 的壓縮品質為 0-100。
省略背景
 omitBackground boolean

使用透明背景（PNG/WebP）拍攝。
寬度（px）
 width integer
高度（px）
 height integer
裝置像素比
 devicePixelRatio number
X
 x number
是
 y number
寬度
 width number
高度
 height number
Scale
 scale number
標記
 tag string

標籤用於日誌與分析（最多 30 字元）。
暫停（MS）
 timeout integer

轉換逾時時間以毫秒計（最大 600000）。
停用 JavaScript
 disableJavascript boolean
注入 CSS
 css string

額外的 CSS 注入頁面。
插入 JavaScript
 javascript string

JavaScript 在擷取前已在頁面中執行。
等待選取器
 waitForSelector string

等這個 CSS 選擇器出現。
等待函數
 waitForFunction string

等這個 JS 表達式返回為真。
媒體類型
 mediaType string
封鎖廣告
 blockAds boolean
使用者代理程式
 userAgent string
HTTP 標頭
 httpHeaders object

額外的 HTTP 標頭作為鍵值對。
名字
 name True string
價值
 value True string
URL
 url string
網域
 domain string
路徑
 path string
過期（紀元）
 expires number
僅限 HTTP
 httpOnly boolean
Secure
 secure boolean
相同網站
 sameSite string
類型
 type string
使用者名稱
 username True string
Password
 password True string
Webhook 網址
 url True string
非同步
 async boolean

在背景下送達，並立即返回202。
方法
 method string
Headers
 headers object

為 webhook 請求提供額外的標頭。
暫停（MS）
 timeout number
重試
 retries integer
重試延遲（毫秒）
 retryDelay number
預簽名的 URL
 presignedUrl True string

HTTP PUT 預簽名的 URL，來自你的儲存服務提供商。

傳回

response
binary

轉換為 PDF

作業識別碼：
ConvertToPdf

將 HTML、URL 或儲存的範本渲染成 PDF。 填入電子發票欄位，嵌入 ZUGFeRD / Factur-X 混合發票，取代一般 PDF。 會以二進位內容回傳檔案。

參數

名稱 機碼 必要 類型 Description
沙盒模式
 X-Sandbox string

在沙盒模式下執行轉換。 沙盒輸出會有浮水印，並從一個較低速率限制的獨立配額抽取。 製作文件使用假。
Source
 source True string

網址（https://...）、內嵌 HTML 字串，或以 [template：TEMPLATE_ID] 格式儲存的模板參考。
檔案名稱
 filename string

輸出檔名，例如 invoice.pdf。
範本資料
 templateData object

當 Source 是 [template：ID] 參考時，鍵值資料會傳入 Liquid 模板渲染器。
標記
 tag string

標籤用於日誌與分析（最多 30 字元）。
暫停（MS）
 timeout integer

轉換逾時時間以毫秒計（最大 600000）。
紙本格式
 format string

紙本格式。 預設為 A4。
景觀
 landscape boolean

使用景觀導向。
印刷背景
 printBackground boolean

列印背景圖像和顏色。
Scale
 scale number

渲染比例介於 0.1 到 2 之間。
頁數範圍
 pageRanges string

需要包含的頁面，例如「1-5、8」。 空白表示所有頁面。
大綱（書籤）
 outline boolean

從 HTML 標題產生 PDF 書籤。
標籤（可取得）
 tagged boolean

製作一份帶有標籤（可存取）的 PDF。
偏好 CSS 頁面大小
 preferCSSPageSize boolean

尊重 @page CSS 中宣告的尺寸，而非紙本格式。
省略背景
 omitBackground boolean

渲染時使用透明背景。
顯示頁首/頁尾
 displayHeaderFooter boolean

渲染標題和頁尾模板。
標頭範本
 headerTemplate string

頁面標題用 HTML 來做。 需要顯示頁首/頁尾。
頁腳範本
 footerTemplate string

頁面頁尾的 HTML 格式。 需要顯示頁首/頁尾。
頁首
 top string
正確
 right string
底部
 bottom string
左側
 left string
Title
 title string
Author
 author string
主旨
 subject string
關鍵字
 keywords array of string
Producer
 producer string
Creator
 creator string
使用者密碼
 userPassword string
擁有者密碼
 ownerPassword string
Source
 source True string

浮水印文字，或圖片 URL / 資料 URI。
類型
 type True string
選項
 options object

字型、透明度、旋轉、縮放、重複和偏移等選項。
Level
 level True string
驗證合規
 verify boolean
驗證合規
 verify boolean

驗證 veraPDF PDF/UA-1;若驗證失敗，則回傳錯誤。
標準
 standard True string

混合發票標準。
Profile
 profile True string

資料的粒度剖面以進行驗證。
驗證合規
 verify boolean

核實PDF/A及電子發票的合規性;若驗證失敗，則回傳錯誤。
發票號碼
 number True string
發行日期
 issueDate True string

發行日期，YYYY-MM-DD。
到期日
 dueDate string

預產期，YYYY-MM-DD。 提供此或付款條款（EN 16931 規則 BR-CO-25）。
貨幣
 currencyCode True string

ISO 4217 貨幣代碼，例如 EUR。
名字
 name True string
地址欄位 1
 line1 True string
地址行 2
 line2 string
城市
 city True string
郵遞區號
 postalCode True string
國家代碼
 countryCode True string

ISO 3166-1 alpha-2 國家代碼，例如德意志。
稅務標識碼
 taxId string

增值稅識別碼。 當某條線使用增值稅類別S時，賣方必須使用此項。
Email
 email string
電話
 phone string
描述
 description True string
數量
 quantity True number
單元代碼
 unitCode string

UN/ECE 單位代碼，例如 C62（棋子）。
單價
 unitPrice True number
線路總數
 lineTotal True number
增值稅率（%）
 vatRate number
增值稅類別
 vatCategoryCode string

增值稅類別代碼，例如 S（標準）、Z（零）、E（免稅）。
類別代碼
 categoryCode True string
利率（%）
 rate True number
應稅金額
 taxableAmount True number
稅額
 taxAmount True number
付款條件
 paymentTerms string

免費文字付款條款。 請提供此資訊或截止日期。
類型代碼
 typeCode True string

UN/ECE 4461 付款指代碼，例如 30（信用轉移）。
IBAN
 iban string
BIC的
 bic string
帳戶名稱
 accountName string
付款參考
 paymentReference string
總淨分
 totalNetAmount True number
總稅
 totalTaxAmount True number
總總收入
 totalGrossAmount True number

必須等於淨額+稅。
Note
 note string
買方參考
 buyerReference string

公共部門發票的買家參考/Leitweg-ID。
停用 JavaScript
 disableJavascript boolean
注入 CSS
 css string

額外的 CSS 注入頁面。
插入 JavaScript
 javascript string

JavaScript 在擷取前已在頁面中執行。
等待選取器
 waitForSelector string

等這個 CSS 選擇器出現。
等待函數
 waitForFunction string

等這個 JS 表達式返回為真。
媒體類型
 mediaType string
封鎖廣告
 blockAds boolean
使用者代理程式
 userAgent string
HTTP 標頭
 httpHeaders object

額外的 HTTP 標頭作為鍵值對。
名字
 name True string
價值
 value True string
URL
 url string
網域
 domain string
路徑
 path string
過期（紀元）
 expires number
僅限 HTTP
 httpOnly boolean
Secure
 secure boolean
相同網站
 sameSite string
類型
 type string
使用者名稱
 username True string
Password
 password True string
Webhook 網址
 url True string
非同步
 async boolean

在背景下送達，並立即返回202。
方法
 method string
Headers
 headers object

為 webhook 請求提供額外的標頭。
暫停（MS）
 timeout number
重試
 retries integer
重試延遲（毫秒）
 retryDelay number
預簽名的 URL
 presignedUrl True string

HTTP PUT 預簽名的 URL，來自你的儲存服務提供商。

傳回

response
binary

定義

二進位

這是基本數據類型 『binary』。