Hesap ve faturalama dışa aktarımları için hesap ekstresi PDF API'si
Çok sayfalı satırlar, toplamlar, metadata ve optional PDF/A arşiv ayarları ile hesap, faturalama ve aktivite ekstresi PDF'leri oluşturun.
/api/v1/pdf/render Müşterilerin inceleme veya saklama için tutarlı kayıt indirebilmesi amacıyla müşteri, hesap veya billing ekstre PDF'lerini dönem verisi, açılış bakiyeleri, satır kalemleri, adjustments ve toplamlar üzerinden render etmek.
Bu API ne zaman kullanılır
- Sisteminiz balances, ekstre dönemleri, işlem satırları ve toplamlara zaten sahip.
- Hesap history, billing summaries veya finance iş akışları için PDF export gerekiyor.
- Üst bilgi, alt bilgi ve özet bölümleri içeren tekrarlanabilir çok sayfalı çıktı gerekiyor.
- Arşiv iş akışları için PDF/A çıktısı gerekebilir.
Neyin yerine geçmez
- Banka bağlantısı, muhasebe defteri reconciliation veya finansal danışmanlık gerekiyor.
- Aynı render isteği içinde şifreli ekstreler ve PDF/A gerekiyor. Public Render API güvenlik ayarları ve PDF/A profil ayarlarını birbirini dışlayan ele alır.
- E-fatura XML'i paketleme gerekiyor. Bunun için E-Invoice Render endpoint kullanın.
Hangi endpoint çağrılır
/api/v1/pdf/render
JSON Render bu iş akışı için varsayılan yoldur.
/api/v1/template-render
İş akışı ilgili API yoluna, template sözleşmesine veya capability sorgusuna ihtiyaç duyduğunda kullanın.
Minimum request
POST /api/v1/pdf/render - period toplamlar içeren ekstre kapak sayfası.
{
"settings": {
"profile": "pdfa-2b"
},
"pages": [
{
"size": "letter",
"elements": [
{
"type": "text",
"x": 18,
"y": 20,
"content": "Account Statement",
"style": { "font_size": 18, "font_family": "NotoSans-Regular" }
},
{
"type": "text",
"x": 18,
"y": 38,
"content": "Period: 2026-05-01 to 2026-05-31\nOpening balance: $1,240.00\nClosing balance: $1,890.25",
"style": { "font_size": 11, "font_family": "NotoSans-Regular" }
}
]
}
]
}
gPdf neyi üstlenir
- Ekstre sayfas için DocumentRequest render işlemi.
- Metin blokları, tablolar, toplam bölümleri, sayfa numaralandırmayı, metadata ve PDF/A profil ayarları.
- Kararlı ekstre yerleşimi ve alan sözleşmesi için Template Render.
- Sisteminiz tarafından indirme veya depolama için uygun binary PDF çıktısı.
Sisteminiz neyi yönetir
- Ekstre period mantık, hesap bakiyeleri, transaction data, para birimi rules ve özeler identity.
- Arşiv politika, erişim kontrolü, dosya adlandırma ve güvenli teslim.
- Reconciliation, denetim approval veya regulated financial representation.
Production kontrol listesi
- Uzun işlem açıklamaları, yüksek satır sayıları, boş dönemleri ve negatif bakiyeleri test edin.
- Her ekstre render için request ID üretin.
- On demand render mı yoksa period close sonrası depolama mı kullanacağınıza karar verin.
- PDF/A'yı yalnızca ekstrenin arşiv politikası gerektiriyorsa kullanın.
- Erişim kontrolü ve müşteri kimlik doğrulamasını render API dışında tutun.
İddia sınırları
- gPdf hesap bakiyeleri hesaplamaz veya muhasebe defteris reconcile etmez.
- API ekstre PDF'leri render eder; finansal doğruluk sizin sisteminizdedir.
- PDF/A çıktısı saklama politikası yerine geçmez.
Ekstreler dönem belgeleridir
Ekstre kapatılmış iş gerçekleri setinden başlamalıdır: hesap, period, opening balance, hareket satırları, adjustments ve kapanış bakiyesi. gPdf bu gerçekleri belirlemez. Kullanıcılarınızın indirebileceği veya sisteminizin saklayabileceği PDF yerleşimina render eder.
Büyük satır setlerini yönetme
Yüksek satır sayıları için ekstreyi tablo bölgeleri, özet bölümleri ve sayfa numaraları içeren tekrarlanabilir yerleşim olarak tasarlayın. Yerleşimi ayarlarken JSON Render kullanın. Alan sözleşmesi kararlı olduğunda Template Render’a geçin.
SSS
- gPdf ekstre balances hesaplayabilir mi?
- Hayır. Period, balances, rows ve toplamlar sisteminiz tarafından gönderilir. gPdf PDF'i render eder.
- Ekstre PDF'leri PDF/A kullanabilir mi?
- Evet, JSON Render PDF/A profil ayarları destekler. PDF/A gerekip gerekmediğine arşiv politika karar verir.
- Ekstreler Template Render kullanmalı mı?
- Yerleşim kararlı olduktan sonra genellikle evet. Template Render çağıran sistemlerin sayfa koordinatları tekrar etmeden dönem verisi göndermesini sağlar.
- gPdf ekstreleri saklar mı?
- Hayır. Standard render isteğis PDF yanıtı döndürür. Depolama ve erişim kontrolü sizin sisteminizdedir.