e-Belge Görüntüleme

Fatura ve irsaliye gibi e-belgelerin PDF görüntüsünü ya da UBL-XML dosyasını almak için kullanılır. İrsaliyeler için ayrı bir uç bulunmamaktadır; gelen ve giden bütün e-belgeler bu uç üzerinden alınır.

Endpoint

GET /kolaybi/v1/invoices/e-document/view

Parametreler

Parametre	Tip	Zorunlu	Açıklama
uuid	string	Evet	e-Belge UUID (ETTN)
direction	string	Hayır	Belge yönü (varsayılan: outbound)
output_type	OutputType	Hayır	Çıktı türü (varsayılan: pdf)

Örnekler

cURL

# PDF görüntüsü
curl -X GET "https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/invoices/e-document/view?uuid=f46d5a8d-7726-4b37-bba4-973c7ab50a5b" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Channel: YOUR_CHANNEL"

# Gelen bir belgenin UBL-XML dosyası
curl -X GET "https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/invoices/e-document/view?uuid=f46d5a8d-7726-4b37-bba4-973c7ab50a5b&direction=inbound&output_type=xml" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Channel: YOUR_CHANNEL"

JavaScript

async function getEDocumentView(uuid) {
  const response = await fetch(
    `https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/invoices/e-document/view?uuid=${uuid}`,
    {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        Channel: channel,
      },
    }
  );
  return await response.json();
}

// Kullanım
const pdfData = await getEDocumentView("f46d5a8d-7726-4b37-bba4-973c7ab50a5b");

PHP

function getEDocumentView($uuid) {
    $url = "https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/invoices/e-document/view?uuid={$uuid}";

    $ch = curl_init();
    curl_setopt_array($ch, [
        CURLOPT_URL => $url,
        CURLOPT_HTTPHEADER => [
            'Authorization: Bearer ' . $accessToken,
            'Channel: ' . $channel
        ],
        CURLOPT_RETURNTRANSFER => true
    ]);

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

// Kullanım
$pdfData = getEDocumentView('f46d5a8d-7726-4b37-bba4-973c7ab50a5b');

Python

import requests

def get_e_document_view(uuid):
    url = f'https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/invoices/e-document/view?uuid={uuid}'
    headers = {
        'Authorization': f'Bearer {access_token}',
        'Channel': channel
    }

    response = requests.get(url, headers=headers)
    return response.json()

# Kullanım
pdf_data = get_e_document_view('f46d5a8d-7726-4b37-bba4-973c7ab50a5b')

C#

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

async Task<dynamic> GetEDocumentViewAsync(string uuid)
{
    using var client = new HttpClient();

    var url = $"https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/invoices/e-document/view?uuid={Uri.EscapeDataString(uuid)}";

    var request = new HttpRequestMessage(HttpMethod.Get, url);
    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 pdfData = await GetEDocumentViewAsync("f46d5a8d-7726-4b37-bba4-973c7ab50a5b");

Yanıt

{
  "data": {
    "src": "JVBERi0xLjQKJcOkw7zDtsO...",
    "output_type": "pdf"
  }
}

Yanıt Alanları

Alan	Tip	Açıklama
src	string	Base64 kodlu çıktı
output_type	OutputType	Çıktı türü