e-İrsaliye Listeleme

Gönderilen şirket idsi ve irsaliye yönüne bağlı olarak ilgili şirkete ait e-irsaliyeleri görüntülemek için kullanılır.

Endpoint

GET /kolaybi/v1/e_document/waybills

Parametreler

Parametre	Tip	Zorunlu	Açıklama
company_id	integer	Evet	Şirkete ait ID değeri
direction	string	Evet	Gönderim şekli
document_id	integer	Hayır	İrsaliye numarası
document_type	DocumentType	Hayır	İrsaliye tipi
document_scenario	DocumentScenario	Hayır	İrsaliye senaryosu
min_issue_date	string	Hayır	Minimum irsaliye tarihi (YYYY-MM-DD)
max_issue_date	string	Hayır	Maksimum irsaliye tarihi (YYYY-MM-DD)
min_total_amount	number	Hayır	Minimum toplam tutar
max_total_amount	number	Hayır	Maksimum toplam tutar
party_name	string	Hayır	Alıcı/Satıcı ünvanı

Örnekler

cURL

# Temel kullanım
curl -X GET "https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/e_document/waybills?company_id=5&direction=outbound" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Channel: YOUR_CHANNEL"

# Filtreleme ile kullanım
curl -X GET "https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/e_document/waybills?company_id=5&direction=outbound&min_issue_date=2024-01-01&max_issue_date=2024-12-31&party_name=KolayBi" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Channel: YOUR_CHANNEL"

JavaScript

async function listEDocumentWaybills(companyId, direction, filters = {}) {
  const params = new URLSearchParams({
    company_id: companyId,
    direction: direction,
  });

  // Opsiyonel filtreler
  if (filters.document_id) params.append('document_id', filters.document_id);
  if (filters.min_issue_date) params.append('min_issue_date', filters.min_issue_date);
  if (filters.max_issue_date) params.append('max_issue_date', filters.max_issue_date);
  if (filters.min_total_amount) params.append('min_total_amount', filters.min_total_amount);
  if (filters.max_total_amount) params.append('max_total_amount', filters.max_total_amount);
  if (filters.party_name) params.append('party_name', filters.party_name);

  const response = await fetch(
    `https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/e_document/waybills?${params}`,
    {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        Channel: channel,
      },
    }
  );
  return await response.json();
}

// Temel kullanım
const waybills = await listEDocumentWaybills(5, "outbound");

// Filtreleme ile kullanım
const filteredWaybills = await listEDocumentWaybills(5, "outbound", {
  min_issue_date: "2024-01-01",
  max_issue_date: "2024-12-31",
  party_name: "KolayBi"
});

PHP

function listEDocumentWaybills($companyId, $direction, $filters = []) {
    $params = [
        'company_id' => $companyId,
        'direction' => $direction
    ];

    // Opsiyonel filtreler
    if (isset($filters['document_id'])) $params['document_id'] = $filters['document_id'];
    if (isset($filters['min_issue_date'])) $params['min_issue_date'] = $filters['min_issue_date'];
    if (isset($filters['max_issue_date'])) $params['max_issue_date'] = $filters['max_issue_date'];
    if (isset($filters['min_total_amount'])) $params['min_total_amount'] = $filters['min_total_amount'];
    if (isset($filters['max_total_amount'])) $params['max_total_amount'] = $filters['max_total_amount'];
    if (isset($filters['party_name'])) $params['party_name'] = $filters['party_name'];

    $url = 'https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/e_document/waybills?' .
            http_build_query($params);

    $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);
}

// Temel kullanım
$waybills = listEDocumentWaybills(5, 'outbound');

// Filtreleme ile kullanım
$filteredWaybills = listEDocumentWaybills(5, 'outbound', [
    'min_issue_date' => '2024-01-01',
    'max_issue_date' => '2024-12-31',
    'party_name' => 'KolayBi'
]);

Python

import requests

def list_e_document_waybills(company_id, direction, filters=None):
    url = 'https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/e_document/waybills'
    params = {
        'company_id': company_id,
        'direction': direction
    }

    # Opsiyonel filtreler
    if filters:
        if 'document_id' in filters:
            params['document_id'] = filters['document_id']
        if 'min_issue_date' in filters:
            params['min_issue_date'] = filters['min_issue_date']
        if 'max_issue_date' in filters:
            params['max_issue_date'] = filters['max_issue_date']
        if 'min_total_amount' in filters:
            params['min_total_amount'] = filters['min_total_amount']
        if 'max_total_amount' in filters:
            params['max_total_amount'] = filters['max_total_amount']
        if 'party_name' in filters:
            params['party_name'] = filters['party_name']

    headers = {
        'Authorization': f'Bearer {access_token}',
        'Channel': channel
    }

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

# Temel kullanım
waybills = list_e_document_waybills(5, 'outbound')

# Filtreleme ile kullanım
filtered_waybills = list_e_document_waybills(5, 'outbound', {
    'min_issue_date': '2024-01-01',
    'max_issue_date': '2024-12-31',
    'party_name': 'KolayBi'
})

C#

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

async Task<dynamic> ListEDocumentWaybillsAsync(int companyId, string direction, Dictionary<string, object> filters = null)
{
    using var client = new HttpClient();

    var queryParams = new List<string>
    {
        $"company_id={companyId}",
        $"direction={Uri.EscapeDataString(direction)}"
    };

    // Opsiyonel filtreler
    if (filters != null)
    {
        if (filters.ContainsKey("document_id"))
            queryParams.Add($"document_id={filters["document_id"]}");
        if (filters.ContainsKey("min_issue_date"))
            queryParams.Add($"min_issue_date={Uri.EscapeDataString(filters["min_issue_date"].ToString())}");
        if (filters.ContainsKey("max_issue_date"))
            queryParams.Add($"max_issue_date={Uri.EscapeDataString(filters["max_issue_date"].ToString())}");
        if (filters.ContainsKey("min_total_amount"))
            queryParams.Add($"min_total_amount={filters["min_total_amount"]}");
        if (filters.ContainsKey("max_total_amount"))
            queryParams.Add($"max_total_amount={filters["max_total_amount"]}");
        if (filters.ContainsKey("party_name"))
            queryParams.Add($"party_name={Uri.EscapeDataString(filters["party_name"].ToString())}");
    }

    var url = $"https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/e_document/waybills?{string.Join("&", queryParams)}";

    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);
}

// Temel kullanım
var waybills = await ListEDocumentWaybillsAsync(5, "outbound");

// Filtreleme ile kullanım
var filteredWaybills = await ListEDocumentWaybillsAsync(5, "outbound", new Dictionary<string, object>
{
    { "min_issue_date", "2024-01-01" },
    { "max_issue_date", "2024-12-31" },
    { "party_name", "KolayBi" }
});

Yanıt

{
  "data": [
    {
      "commercial_doc_id": 18,
      "document_uuid": "f46d5a8d-7726-4b37-bba4-973c7ab50a5b",
      "document_no": "EBR2024000000123",
      "document_status": "sent_to_receiver",
      "document_scenario": "TEMELIRSALIYE",
      "document_type": "SEVK",
      "direction": "outbound",
      "grand_total": 20,
      "currency": "try",
      "issue_date": "2024-06-10 00:00:00",
      "cancelled_at": null
    }
  ]
}

Yanıt Alanları

Alan	Tip	Açıklama
commercial_doc_id	integer	İrsaliye ID değeri
document_uuid	string	İrsaliye UUID (ETTN)
document_no	string	Seri numarası
document_status	string	E-İrsaliye durumu
document_scenario	DocumentScenario	İrsaliye senaryosu
document_type	DocumentType	İrsaliye tipi
direction	string	Gönderim şekli
grand_total	number	Toplam tutar
currency	string	İrsaliye para birimi
issue_date	string	İrsaliye tarihi
cancelled_at	string	İptal tarihi