Gelen fatura PDF'i

Gelen faturanın PDF adresini almak için bu endpoint kullanılır. PDF daha önce hazırlanmışsa kayıtlı adres hemen döner; hazırlanmamışsa sağlayıcıdan çekilip kaydedilir ve adresi döner.

İstek

GET /api/incoming-invoices/{id}/pdf
Accept: application/json
Authorization: Bearer YOUR_API_KEY

Örnek istekler.

💻 cURL

curl -X GET "https://app.faturaentegrator.com/api/incoming-invoices/57/pdf" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

🐘 PHP

<?php
$ch = curl_init('https://app.faturaentegrator.com/api/incoming-invoices/57/pdf');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ['Accept: application/json', 'Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_RETURNTRANSFER => true,
]);
$url = json_decode(curl_exec($ch), true)['url'];
curl_close($ch);

🟢 Node.js

const res = await fetch('https://app.faturaentegrator.com/api/incoming-invoices/57/pdf', {
  headers: { Accept: 'application/json', Authorization: 'Bearer YOUR_API_KEY' },
});
const { url } = await res.json();

🐍 Python

import requests
r = requests.get(
    'https://app.faturaentegrator.com/api/incoming-invoices/57/pdf',
    headers={'Accept': 'application/json', 'Authorization': 'Bearer YOUR_API_KEY'},
)
url = r.json()['url']

Örnek yanıt

{
  "url": "https://app.faturaentegrator.com/storage/incoming-invoices/45/57.pdf?v=1790596800"
}

Reddedilen faturada PDF yenilenir

Fatura reddedildikten sonra sağlayıcıdaki durumu RED olduğunda PDF, "reddedildi" damgalı haliyle yeniden hazırlanır. Adresin sonundaki ?v= sürüm değeri değişir. PDF'i kendi tarafınızda önbelleğe alıyorsanız, red sonrasında adresi yeniden alın.

Sağlayıcı PDF'i veremezse 422 döner ve hata errors.api_error anahtarında yer alır (bkz. Hata yanıtları).