Gelen faturayı kabul etme

Ticari gelen faturayı sağlayıcı üzerinden kabul etmek 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}/accept
Accept: application/json
Authorization: Bearer YOUR_API_KEY

İstek gövdesi gerekmez.

Hangi faturalar kabul edilebilir?

Yalnızca kaydında can_respond: true olan faturalar yanıtlanabilir. Bunun için üç koşulun hepsi sağlanmalıdır:

• source değeri einvoice olmalıdır (e-Arşiv faturalar yanıtlanamaz).
• profile değeri TICARIFATURA olmalıdır.
• Faturaya daha önce yanıt verilmemiş olmalıdır (response: null). Panelden veya sağlayıcı portalından verilen yanıtlar da bu alana işlenir.

Koşullar sağlanmazsa istek 422 ile reddedilir ve errors.api_error içinde Yalnızca ticari e-faturalara kabul/red yanıtı verilebilir. ya da Bu faturaya daha önce yanıt verilmiş. mesajı döner.

Örnek istekler

💻 cURL

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

🐘 PHP

<?php
$ch = curl_init('https://app.faturaentegrator.com/api/incoming-invoices/57/accept');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Accept: application/json', 'Authorization: Bearer YOUR_API_KEY'],
    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/accept', {
  method: 'POST',
  headers: { Accept: 'application/json', Authorization: 'Bearer YOUR_API_KEY' },
});
const data = await res.json();

🐍 Python

import requests
r = requests.post(
    'https://app.faturaentegrator.com/api/incoming-invoices/57/accept',
    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. response alanı accepted olur ve responded_at alanı dolar.

{
  "data": {
    "id": 57,
    "profile": "TICARIFATURA",
    "provider_status": "...",
    "response": "accepted",
    "responded_at": "2026-09-30T09:12:44.000000Z",
    "can_respond": false,
    "lines": ["..."],
    "errors": [],
    "...": "..."
  }
}

Sağlayıcı yanıtı kabul etmezse 422 döner. Mesaj sağlayıcıdan gelir; mesaj yoksa Fatura kabul edilemedi. yazar.