Gelen faturayı reddetme

Ticari gelen faturayı sağlayıcı üzerinden reddetmek için bu endpoint kullanılır. Başarılı yanıtta faturanın güncel detayı döner.

İstek

POST /api/incoming-invoices/{id}/reject
Accept: application/json
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Yalnızca can_respond: true olan faturalar reddedilebilir. Koşullar kabul etme ile aynıdır.

Gövde alanları

Alan	Tip	Zorunlu	Açıklama
reason	string	Evet	Red nedeni; en fazla 255 karakter. Sağlayıcıya iletilir ve kayıtta response_reason alanında saklanır.

{
  "reason": "Fatura tutarı hatalı."
}

Örnek istekler

💻 cURL

curl -X POST "https://app.faturaentegrator.com/api/incoming-invoices/57/reject" \
  -H "Accept: application/json" -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"reason":"Fatura tutarı hatalı."}'

🐘 PHP

<?php
$ch = curl_init('https://app.faturaentegrator.com/api/incoming-invoices/57/reject');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode(['reason' => 'Fatura tutarı hatalı.']),
    CURLOPT_HTTPHEADER => ['Accept: application/json', 'Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/json'],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

🟢 Node.js

const res = await fetch('https://app.faturaentegrator.com/api/incoming-invoices/57/reject', {
  method: 'POST',
  headers: {
    Accept: 'application/json',
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ reason: 'Fatura tutarı hatalı.' }),
});
const data = await res.json();

🐍 Python

import requests
r = requests.post(
    'https://app.faturaentegrator.com/api/incoming-invoices/57/reject',
    json={'reason': 'Fatura tutarı hatalı.'},
    headers={'Accept': 'application/json', 'Authorization': 'Bearer YOUR_API_KEY'},
)
data = r.json()

Örnek yanıt

Yanıt, gelen fatura detayı ile aynı yapıdadır.

{
  "data": {
    "id": 57,
    "profile": "TICARIFATURA",
    "provider_status": "...",
    "response": "rejected",
    "response_reason": "Fatura tutarı hatalı.",
    "responded_at": "2026-09-30T09:12:44.000000Z",
    "can_respond": false,
    "...": "..."
  }
}

Red, sağlayıcıda hemen kesinleşmeyebilir

response alanı istek anında rejected olur. provider_status ise sağlayıcı reddi işleyince RED olur ve platform bu durumu arka planda takip eder. RED durumuna geçince faturanın PDF'i "reddedildi" damgasıyla yenilenir (bkz. PDF).