e-Fatura İptal

Resmileştirilmiş Earşiv faturaların GİB tarafında iptal edilmesi için kullanılır. İptal işlemi gerçekleştirildiğinde hem Satış faturalarından silinmiş olur hemde resmişleştirme işlemi iptal edilir. Efatura olan faturaların iptali için lütfen destek ekibimizle iletişime geçiniz.

Endpoint

POST /kolaybi/v1/invoices/e-document/cancel

Parametreler

Request Body

Alan	Tip	Zorunlu	Açıklama
document_id	integer	✅	İptal edilecek faturanın ID değeri

Örnekler

cURL

curl -X POST "https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/invoices/e-document/cancel" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Channel: YOUR_CHANNEL" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "document_id=18"

JavaScript

async function cancelEDocument(documentId) {
  const formData = new URLSearchParams();
  formData.append("document_id", documentId);

  const response = await fetch(
    "https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/invoices/e-document/cancel",
    {
      method: "POST",
      headers: {
        Authorization: `Bearer ${accessToken}`,
        Channel: channel,
        "Content-Type": "application/x-www-form-urlencoded",
      },
      body: formData,
    }
  );
  return await response.json();
}

// Kullanım
const result = await cancelEDocument(18);

PHP

function cancelEDocument($documentId) {
    $url = 'https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/invoices/e-document/cancel';

    $ch = curl_init();
    curl_setopt_array($ch, [
        CURLOPT_URL => $url,
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => http_build_query(['document_id' => $documentId]),
        CURLOPT_HTTPHEADER => [
            'Authorization: Bearer ' . $accessToken,
            'Channel: ' . $channel,
            'Content-Type: application/x-www-form-urlencoded'
        ],
        CURLOPT_RETURNTRANSFER => true
    ]);

    $response = curl_exec($ch);
    curl_close($ch);
    return json_decode($response, true);
}

// Kullanım
$result = cancelEDocument(18);

Python

import requests

def cancel_e_document(document_id):
    url = 'https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/invoices/e-document/cancel'
    headers = {
        'Authorization': f'Bearer {access_token}',
        'Channel': channel,
        'Content-Type': 'application/x-www-form-urlencoded'
    }
    data = {'document_id': document_id}

    response = requests.post(url, data=data, headers=headers)
    return response.json()

# Kullanım
result = cancel_e_document(18)

C#

using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Threading.Tasks;
using Newtonsoft.Json;

async Task<dynamic> CancelEDocumentAsync(int documentId)
{
    using var client = new HttpClient();

    var data = new Dictionary<string, string>
    {
        { "document_id", documentId.ToString() }
    };

    var request = new HttpRequestMessage(HttpMethod.Post,
        "https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/invoices/e-document/cancel")
    {
        Content = new FormUrlEncodedContent(data)
    };

    request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", accessToken);
    request.Headers.Add("Channel", channel);

    var response = await client.SendAsync(request);
    var content = await response.Content.ReadAsStringAsync();
    return JsonConvert.DeserializeObject<dynamic>(content);
}

// Kullanım
var result = await CancelEDocumentAsync(18);

Yanıt

{
  "success": true
}

Yanıt Alanları

Alan	Tip	Açıklama
success	boolean	İşlem başarı durumu