PolyDoc (Bağımsız Publisher) (Önizleme)

HTML veya URL'yi mükemmel PDF'lere ve ekran görüntülerine dönüştürün ve AB uyumlu karma e-faturalar oluşturun (ZUGFeRD / Factur-X). PolyDoc gerçek bir tarayıcı altyapısıyla işlenir, bu nedenle sayfada gördükleriniz belgede gördüklerinizdir.

Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:

Service Class Bölgeler
Copilot Studio Premium Aşağıdakiler dışında tüm Power Automate bölgeleri :
     - ABD Kamu (GCC)
     - US Government (GCC High)
     - 21Vianet tarafından işletilen Çin Bulutu
     - ABD Savunma Bakanlığı (DoD)
Logic Apps Standard Aşağıdakiler dışında tüm Logic Apps bölgeleri :
     - Azure Kamu bölgeleri
     - Azure Çin bölgeleri
     - ABD Savunma Bakanlığı (DoD)
Power Apps Premium Aşağıdakiler dışında tüm Power Apps bölgeleri :
     - ABD Kamu (GCC)
     - US Government (GCC High)
     - 21Vianet tarafından işletilen Çin Bulutu
     - ABD Savunma Bakanlığı (DoD)
Power Automate Premium Aşağıdakiler dışında tüm Power Automate bölgeleri :
     - ABD Kamu (GCC)
     - US Government (GCC High)
     - 21Vianet tarafından işletilen Çin Bulutu
     - ABD Savunma Bakanlığı (DoD)
Contact
Ad PolyDoc
URL https://polydoc.tech
E-posta hello@polydoc.tech
Bağlayıcı Meta Verileri
Publisher mavi-d3v
Web Sitesi https://polydoc.tech
Gizlilik ilkesi https://polydoc.tech/legal/privacy-policy/
Kategoriler İçerik ve Dosyalar

PolyDoc

PolyDoc , HTML'yi veya URL'yi mükemmel PDF'lere ve ekran görüntülerine dönüştürür ve AB uyumlu karma e-faturalar (ZUGFeRD / Factur-X) oluşturur. Dönüştürmeler gerçek bir tarayıcı altyapısında işlendiğinden, sayfada gördükleriniz belgede gördüklerinizdir.

Publisher

PolyDoc

Prerequisites

PolyDoc hesabına ve API anahtarına ihtiyacınız vardır. Ücretsiz katman bağlayıcıyı değerlendirmek için yeterlidir. Özel bağlayıcılar premium Power Automate bir özellik olduğundan, bu bağlayıcıyı kullanan akışların yerleşik HTTP eylemiyle aynı Power Automate Premium planına (kullanıcı başına veya akış başına) ihtiyacı vardır.

Kimlik bilgilerini alma

  1. dashboard.polydoc.tech'da oturum açın.
  2. API Anahtarları'nı açın ve bir anahtar oluşturun.
  3. Bağlantıyı oluşturduğunuzda anahtarı PolyDoc API anahtarına yapıştırın. Yalnızca anahtarı yapıştırın; bağlayıcısı sizin için ön eki ekler Bearer .

Desteklenen işlemler

Operation Ne işe yarıyor?
PDF'ye dönüştür HTML, URL veya kaydedilmiş bir şablonu PDF'de işleyebilirsiniz. Sayfa biçimi, kenar boşlukları, ölçek, üst bilgi/alt bilgiler, yer işaretleri, erişilebilir (etiketli) PDF'ler, meta veriler, şifreleme, filigranlar ve PDF/A için denetimler.
Ekran görüntüsü yakalama HTML, URL veya şablon içeren PNG, JPEG veya WebP yakalayın. Görünüm penceresi ve cihaz piksel oranı denetimi ile tam sayfa veya kırpılmış.

E-faturalarPDF'ye Dönüştür ile oluşturulur: E-fatura alanlarını (standart, profil ve yapılandırılmış invoice nesne) doldurun ve PolyDoc, döndürülen PDF'ye bir ZUGFeRD / Factur-X fatura ekler. example-flows/ Kullanıma hazır bir gövde için bağlayıcı deposundaki klasöre bakın.

Kaynak

Her işlem aşağıdakilerden biri olan tek bir Kaynak alır:

  • bir URL, örneğin https://example.com
  • satır içi HTML dizesi
  • kaydedilmiş bir şablon başvurusu, [template:TEMPLATE_ID]isteğe bağlı olarak Liquid işleyicisi için Şablon verileri ile

Teslim

Varsayılan olarak dosya ikili içerik olarak döndürülür, Dosya oluştur (OneDrive, SharePoint, Blob) veya e-posta eki içine bırakılmaya hazırdır. Gelişmiş seçenekler altında iki alternatif teslim modu vardır:

  • Bulut depolama: önceden imzalı bir PUT URL'si sağlayın; PolyDoc dosyayı karşıya yükler ve eylem depolanmış URL'yi içeren JSON döndürür.
  • Web kancası: PolyDoc dosyayı web kancanıza teslim eder ve eylem bir JSON onayı döndürür (zaman uyumsuz olduğunda HTTP 202).

Teslim modlarından biri kullanıldığında, yanıt ikili dosya yerine JSON'dır.

Korumalı alan modu

Her işlemin gelişmiş korumalı alan modu girişi vardır. Akışı true oluştururken ve test ederken yararlı olan daha düşük hız sınırına sahip ayrı bir kotadan filigranlı çıkış oluşturmak için bunu olarak ayarlayın. false Üretim belgeleri için bırakın.

Bilinen sorunlar ve sınırlamalar

  • Her eylemin yanıtı ikili dosya olarak bildirilir. Bulut depolama veya Web kancası teslimi yapılandırıldığında, eylem dosya yerine JSON döndürür.
  • Dış CDN'den JavaScript yükleyen sayfalar dönüştürücüde önemli ölçüde yavaşlayabilir. Satır içi HTML için, bağımsız işaretlemeyi (satır içi CSS, veri URI görüntüleri) tercih edin.
  • E-faturalar EN 16931'i izler. En azından bir son tarih veya ödeme koşulları (kural BR-CO-25), satırDA KDV kategorisi Skullanıldığında satıcı vergi kimliği ve tutarlı toplamlar (net + vergi = brüt) belirtin. Doğrula etkinleştirildiğinde doğrulama başarısız olan bir fatura bir hata döndürür.

Dağıtım yönergeleri

Bu bağlayıcı standart bir Power Platform özel bağlayıcısı (apiDefinition.swagger.json + + apiProperties.jsonicon.png) olarak tanımlanır. Power Platform Bağlayıcıları CLI ile dağıtın:

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

Ayrıca doğrudan Power Automate oluşturucu portalından da içeri aktarabilirsiniz apiDefinition.swagger.json (Veri > Özel bağlayıcıları > Yeni özel bağlayıcı > OpenAPI dosyasını içeri aktarma).

Bağlantı oluşturma

Bağlayıcı aşağıdaki kimlik doğrulama türlerini destekler:
Varsayılan Bağlantı oluşturmak için parametreler. Tüm bölgeler Paylaşılamaz

Varsayılan

Geçerli: Tüm bölgeler

Bağlantı oluşturmak için parametreler.

Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.

Ad Type Açıklama Zorunlu
PolyDoc API anahtarı securestring PolyDoc API anahtarınız. API Anahtarları altında dashboard.polydoc.tech bir tane oluşturun. Yalnızca anahtarı yapıştırın; bağlayıcısı sizin için 'Taşıyıcı' ön ekini ekler. True

Eylemler

Ekran görüntüsü yakalama

HTML, URL veya kaydedilmiş bir şablonu işleyip PNG, JPEG veya WebP ekran görüntüsü yakalayın. Görüntüyü ikili içerik olarak döndürür.
PDF'ye Dönüştür

HTML, URL veya kaydedilmiş bir şablonu PDF'de işleyebilirsiniz. Düz PDF yerine bir ZUGFeRD / Factur-X karma fatura eklemek için E-fatura alanlarını doldurun. Dosyayı ikili içerik olarak döndürür.

Ekran görüntüsü yakalama

İşlem Kimliği:
CaptureScreenshot

HTML, URL veya kaydedilmiş bir şablonu işleyip PNG, JPEG veya WebP ekran görüntüsü yakalayın. Görüntüyü ikili içerik olarak döndürür.

Parametreler

Name Anahtar Gerekli Tür Description
Korumalı alan modu
 X-Sandbox string

Dönüştürmeyi korumalı alan modunda çalıştırın. Korumalı alan çıkışı filigranlanır ve daha düşük hız sınırına sahip ayrı bir kotadan çizilir. Üretim belgeleri için false kullanın.
Kaynak
 source True string

[template:TEMPLATE_ID] biçiminde bir URL (https://...), satır içi HTML dizesi veya kaydedilmiş şablon başvurusu.
Filename
 filename string

Çıktı dosya adı, örneğin screenshot.png.
Şablon verileri
 templateData object

Kaynak bir [template:ID] başvurusu olduğunda Liquid şablonu işleyicisine geçirilen anahtar/değer verileri.
Görüntü türü
 type string

Görüntü biçimi. Varsayılan olarak png'yi kullanır.
Tam sayfa
 fullPage boolean

Kaydırılabilir sayfanın tamamını yakalayın.
Quality
 quality integer

JPEG/WebP için sıkıştırma kalitesi 0-100.
Arka planı atla
 omitBackground boolean

Saydam arka plan (PNG/WebP) ile yakalama.
Genişlik (piksel)
 width integer
Yükseklik (piksel)
 height integer
Cihaz piksel oranı
 devicePixelRatio number
X
 x number
Y
 y number
Genişlik
 width number
Yükseklik
 height number
Scale
 scale number
Etiket
 tag string

Günlüğe kaydetme ve analiz etiketi (en fazla 30 karakter).
Zaman aşımı (ms)
 timeout integer

Milisaniye cinsinden dönüştürme zaman aşımı (maksimum 600000).
JavaScript'i devre dışı bırakma
 disableJavascript boolean
CSS Ekleme
 css string

Sayfaya eklenen fazladan CSS.
JavaScript ekleme
 javascript string

JavaScript, yakalamadan önce sayfada yürütüldü.
Seçiciyi bekleme
 waitForSelector string

Bu CSS seçici görünene kadar bekleyin.
İşlevi bekleme
 waitForFunction string

Bu JS ifadesi true döndürene kadar bekleyin.
Medya türü
 mediaType string
Reklamları engelleme
 blockAds boolean
Tarayıcı belirteci
 userAgent string
HTTP başlıkları
 httpHeaders object

Anahtar/değer çiftleri olarak ek HTTP üst bilgileri.
Ad
 name True string
Değer
 value True string
URL
 url string
Domain
 domain string
Yol
 path string
Süre sonu (dönem)
 expires number
Yalnızca HTTP
 httpOnly boolean
Secure
 secure boolean
Aynı Site
 sameSite string
Type
 type string
Kullanıcı adı
 username True string
Şifre
 password True string
Web Kancası URL'si
 url True string
Async
 async boolean

Arka planda teslim edin ve 202'yi hemen geri gönderin.
Method
 method string
Headers
 headers object

Web kancası isteği için ek üst bilgiler.
Zaman aşımı (ms)
 timeout number
Tekrar Denemeler
 retries integer
Yeniden deneme gecikmesi (ms)
 retryDelay number
Ön İmzalı URL
 presignedUrl True string

Depolama sağlayıcınızdan HTTP PUT ön imzalı URL.

Döndürülenler

response
binary

PDF'ye Dönüştür

İşlem Kimliği:
ConvertToPdf

HTML, URL veya kaydedilmiş bir şablonu PDF'de işleyebilirsiniz. Düz PDF yerine bir ZUGFeRD / Factur-X karma fatura eklemek için E-fatura alanlarını doldurun. Dosyayı ikili içerik olarak döndürür.

Parametreler

Name Anahtar Gerekli Tür Description
Korumalı alan modu
 X-Sandbox string

Dönüştürmeyi korumalı alan modunda çalıştırın. Korumalı alan çıkışı filigranlanır ve daha düşük hız sınırına sahip ayrı bir kotadan çizilir. Üretim belgeleri için false kullanın.
Kaynak
 source True string

[template:TEMPLATE_ID] biçiminde bir URL (https://...), satır içi HTML dizesi veya kaydedilmiş şablon başvurusu.
Filename
 filename string

Çıktı dosya adı, örneğin invoice.pdf.
Şablon verileri
 templateData object

Kaynak bir [template:ID] başvurusu olduğunda Liquid şablonu işleyicisine geçirilen anahtar/değer verileri.
Etiket
 tag string

Günlüğe kaydetme ve analiz etiketi (en fazla 30 karakter).
Zaman aşımı (ms)
 timeout integer

Milisaniye cinsinden dönüştürme zaman aşımı (maksimum 600000).
Kağıt biçimi
 format string

Kağıt biçimi. Varsayılan değer A4'tir.
Manzara
 landscape boolean

Yatay yönlendirmeyi kullanın.
Arka planı yazdır
 printBackground boolean

Arka plan grafiklerini ve renklerini yazdırın.
Scale
 scale number

0,1 ile 2 arasında işleme ölçeği.
Sayfa aralıkları
 pageRanges string

Eklenecek sayfalar, örneğin "1-5, 8". Boş, tüm sayfalar anlamına gelir.
Ana hat (yer işaretleri)
 outline boolean

HTML başlıklarından PDF yer işaretleri oluşturun.
Etiketli (erişilebilir)
 tagged boolean

Etiketli (erişilebilir) bir PDF oluşturun.
CSS sayfa boyutunu tercih et
 preferCSSPageSize boolean

@page KAĞıT biçimi üzerinden CSS'de bildirilen boyutu kabul edin.
Arka planı atla
 omitBackground boolean

Saydam arka plan ile işleme.
Üst bilgi/alt bilgiyi görüntüleme
 displayHeaderFooter boolean

Üst bilgi ve alt bilgi şablonlarını işleme.
Üst bilgi şablonu
 headerTemplate string

Sayfa üst bilgisi için HTML. Üst bilgiyi/alt bilgiyi görüntülemeyi gerektirir.
Alt bilgi şablonu
 footerTemplate string

Sayfa alt bilgisi için HTML. Üst bilgiyi/alt bilgiyi görüntülemeyi gerektirir.
Yukarı
 top string
Doğru
 right string
Alt
 bottom string
Sol
 left string
Başlık
 title string
Author
 author string
Subject
 subject string
Anahtar sözcükler
 keywords array of string
Producer
 producer string
Oluşturucu
 creator string
Kullanıcı parolası
 userPassword string
Sahip parolası
 ownerPassword string
Kaynak
 source True string

Filigran metni veya resim URL'si / veri URI'si.
Type
 type True string
Options
 options object

Yazı tipi, opaklık, döndürme, ölçeklendirme, yineleme ve uzaklık seçenekleri.
Level
 level True string
Uyumluluğu doğrulama
 verify boolean
Uyumluluğu doğrulama
 verify boolean

veraPDF PDF/UA-1'e karşı doğrulama; doğrulama başarısız olursa bir hata döndürür.
Standard
 standard True string

Karma fatura standardı.
Profile
 profile True string

Doğrulanması gereken veri ayrıntı düzeyi profili.
Uyumluluğu doğrulama
 verify boolean

PDF/A ve e-fatura uyumluluğunu doğrulama; doğrulama başarısız olursa bir hata döndürür.
Fatura numarası
 number True string
Çıkış tarihi
 issueDate True string

Çıkış tarihi, YYYY-AA-GG.
Vade tarihi
 dueDate string

Son tarih, YYYY-AA-GG. Bu veya Ödeme koşullarını belirtin (EN 16931 kuralı BR-CO-25).
Para birimi
 currencyCode True string

ISO 4217 para birimi kodu, örneğin EUR.
Ad
 name True string
Adres satırı 1
 line1 True string
Adres satırı 2
 line2 string
Şehir
 city True string
Posta kodu
 postalCode True string
Ülke kodu
 countryCode True string

ISO 3166-1 alfa-2 ülke kodu, örneğin DE.
Vergi Kimliği
 taxId string

KDV tanımlayıcısı. Satırda KDV kategorisi S kullanıldığında satıcı için gereklidir.
E-posta
 email string
Phone
 phone string
Açıklama
 description True string
Miktar
 quantity True number
Birim kodu
 unitCode string

UN/ECE birim kodu, örneğin C62 (parça).
Birim fiyat
 unitPrice True number
Satır toplamı
 lineTotal True number
KDV oranı (%)
 vatRate number
KDV kategorisi
 vatCategoryCode string

KDV kategorisi kodu, örneğin S (standart), Z (sıfır), E (muaf).
Kategori kodu
 categoryCode True string
Oran (%)
 rate True number
Vergiye dönüştürülebilir tutar
 taxableAmount True number
Vergi tutarı
 taxAmount True number
Ödeme koşulları
 paymentTerms string

Serbest metin ödeme koşulları. Bunu veya Son tarihi belirtin.
Tür kodu
 typeCode True string

UN/ECE 4461 ödemesi kod anlamına gelir, örneğin 30 (kredi transferi).
IBAN
 iban string
BIC
 bic string
Hesap adı
 accountName string
Ödeme referansı
 paymentReference string
Toplam net
 totalNetAmount True number
Toplam vergi
 totalTaxAmount True number
Toplam brüt
 totalGrossAmount True number

Net + vergiye eşit olmalıdır.
Note
 note string
Alıcı başvurusu
 buyerReference string

Kamu sektörü faturaları için alıcı başvurusu / Leitweg-ID.
JavaScript'i devre dışı bırakma
 disableJavascript boolean
CSS Ekleme
 css string

Sayfaya eklenen fazladan CSS.
JavaScript ekleme
 javascript string

JavaScript, yakalamadan önce sayfada yürütüldü.
Seçiciyi bekleme
 waitForSelector string

Bu CSS seçici görünene kadar bekleyin.
İşlevi bekleme
 waitForFunction string

Bu JS ifadesi true döndürene kadar bekleyin.
Medya türü
 mediaType string
Reklamları engelleme
 blockAds boolean
Tarayıcı belirteci
 userAgent string
HTTP başlıkları
 httpHeaders object

Anahtar/değer çiftleri olarak ek HTTP üst bilgileri.
Ad
 name True string
Değer
 value True string
URL
 url string
Domain
 domain string
Yol
 path string
Süre sonu (dönem)
 expires number
Yalnızca HTTP
 httpOnly boolean
Secure
 secure boolean
Aynı Site
 sameSite string
Type
 type string
Kullanıcı adı
 username True string
Şifre
 password True string
Web Kancası URL'si
 url True string
Async
 async boolean

Arka planda teslim edin ve 202'yi hemen geri gönderin.
Method
 method string
Headers
 headers object

Web kancası isteği için ek üst bilgiler.
Zaman aşımı (ms)
 timeout number
Tekrar Denemeler
 retries integer
Yeniden deneme gecikmesi (ms)
 retryDelay number
Ön İmzalı URL
 presignedUrl True string

Depolama sağlayıcınızdan HTTP PUT ön imzalı URL.

Döndürülenler

response
binary

Tanımlar

binary

Bu, 'ikili' temel veri türüdür.