Aktarım yolları

Otobüs ve tren biletleri

Taşımacı adına satılan biletler: bacaklar, yolcular, koltuklar ve taşımacının ücreti.

Otobüs ve tren biletleri taşımacı adına satılır. Seferin bacaklarını, sonra her yolcuyu taşımacının fare'i ve koltuklarıyla gönderin; koltuk bacağını 0'dan başlayan sırasıyla anar. Ücret taşımacının parası olarak yazılır, acentenin geliri hizmet bedelidir. Cari yoksa satış peşindir ve ilk yolcuya faturalanır. Satılmış bir koltuk ya da e-bilet numarası satırı reddeder.

Şu kapsamlardan birini taşıyan anahtar erişir:importimport_issue

Otobüs biletleri`bus_bookings`

POST/api/v1/imports/bus_bookings

Bir kez oluşturulur: aynı external_id ile tekrar gönderim kopya açmaz, atlanır.

Uç noktalar

validatePOST /api/v1/imports/bus_bookings/validate
importPOST /api/v1/imports/bus_bookings
feedGET /api/v1/imports/bus_bookings/records
read_backGET /api/v1/imports/bus_bookings/records/{external_id}

Fatura kime kesilir

Cariyi biliyorsanız customer_external_id gönderin; her zaman o kazanır. Aksi hâlde Lydira cariyi fatura bilgisinden bulur ya da açar. E-posta, telefon ve isimle eşleştirme yapılmaz; bulunan carinin yalnız boş alanları doldurulur.

Kurumsal (ünvan ya da 10 haneli vergi numarası): tax_number → legal_name

Bireysel: tax_number → passport_number

Fatura bilgisi yoksa bireysel ödeyen şu listedeki ilk yolcudur: travelers[0]

Fatura bilgisi alanları:bill_to_typebill_to_legal_namebill_to_tax_numberbill_to_tax_officebill_to_passport_numberbill_to_first_namebill_to_last_namebill_to_emailbill_to_phonebill_to_address_linebill_to_districtbill_to_citybill_to_zipbill_to_country

Her satırın sonucu payer taşır: hangi cariye bağlandığı, hangi kimlikle (by), yeni cari açılıp açılmadığı (/validate'te açılacak olup olmadığı) ve bağlanamadıysa nedeni (warning). outcome şu değerlerden biridir:

external_idmatchedcreatedwould_createnone

Fatura bilgisiyle örnek istek (cari anahtarı olmadan)

curl -X POST 'https://YOUR-CELL.lydira.com/api/v1/imports/bus_bookings/validate' \
  -H 'Authorization: Bearer sek_YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: 8f14e45f-ea2c-4f33-9a3b-6d0c1b7e5a90' \
  -d '{
  "source_system": "crm",
  "rows": [
    {
      "external_id": "BUS-BOOKING-1001-B",
      "currency": "EUR",
      "supplier_external_id": "SUPPLIER-1001",
      "billing_basis": "agent",
      "fare_collected_by": "agency",
      "status": "draft",
      "reference": "Reference",
      "supplier_confirmation_no": "Supplier confirmation no",
      "notes": "Imported from the source system.",
      "option_date": "2026-03-20T18:00",
      "transaction_date": "2026-03-14",
      "invoice_date": "2026-03-18",
      "legs": [
        {
          "origin_name": "İstanbul",
          "origin_code": "IST",
          "destination_name": "Ankara",
          "destination_code": "ANK",
          "departs_at": "2026-03-14T09:30:00+03:00",
          "arrives_at": "2026-03-14T12:45:00+03:00",
          "service_number": "S-101",
          "operator_name": "Express Lines",
          "fare_name": "Standard"
        }
      ],
      "travelers": [
        {
          "first_name": "Ada",
          "last_name": "Lovelace",
          "nationality": "TR",
          "national_id": "10000000146",
          "passport_number": "U01234567",
          "passport_country": "TR",
          "passport_expiry": "2031-06-30",
          "date_of_birth": "1988-04-21",
          "gender": "MRS",
          "frequent_flyer_number": "TK123456789",
          "passenger_type": "adult",
          "phone": "+905551112233",
          "fare": "850.00",
          "seats": [
            {
              "leg": 0,
              "seat_number": "12",
              "coach_number": "3",
              "ticket_number": "BUS-2026-000101",
              "fare_amount": "850.00"
            }
          ]
        }
      ],
      "cost_lines": [
        {
          "kind": "ticket_fare",
          "amount": "1250.00",
          "label": "Imported line",
          "currency": "EUR",
          "vat_rate": "20",
          "tax_inclusive": true,
          "quantity": 1
        }
      ],
      "sell_lines": [
        {
          "kind": "package_price",
          "amount": "1250.00",
          "label": "Imported line",
          "currency": "EUR",
          "vat_rate": "20",
          "tax_inclusive": true,
          "quantity": 1
        }
      ],
      "bill_to_legal_name": "Lovelace Seyahat A.Ş.",
      "bill_to_tax_number": "1234567890",
      "bill_to_tax_office": "Beşiktaş",
      "bill_to_address_line": "Nispetiye Cad. No:12",
      "bill_to_city": "İstanbul",
      "bill_to_country": "TR"
    }
  ]
}'

const response = await fetch(
  "https://YOUR-CELL.lydira.com/api/v1/imports/bus_bookings/validate",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer sek_YOUR_API_KEY",
      "Content-Type": "application/json",
      "Idempotency-Key": "8f14e45f-ea2c-4f33-9a3b-6d0c1b7e5a90",
    },
    body: JSON.stringify({
      "source_system": "crm",
      "rows": [
        {
          "external_id": "BUS-BOOKING-1001-B",
          "currency": "EUR",
          "supplier_external_id": "SUPPLIER-1001",
          "billing_basis": "agent",
          "fare_collected_by": "agency",
          "status": "draft",
          "reference": "Reference",
          "supplier_confirmation_no": "Supplier confirmation no",
          "notes": "Imported from the source system.",
          "option_date": "2026-03-20T18:00",
          "transaction_date": "2026-03-14",
          "invoice_date": "2026-03-18",
          "legs": [
            {
              "origin_name": "İstanbul",
              "origin_code": "IST",
              "destination_name": "Ankara",
              "destination_code": "ANK",
              "departs_at": "2026-03-14T09:30:00+03:00",
              "arrives_at": "2026-03-14T12:45:00+03:00",
              "service_number": "S-101",
              "operator_name": "Express Lines",
              "fare_name": "Standard"
            }
          ],
          "travelers": [
            {
              "first_name": "Ada",
              "last_name": "Lovelace",
              "nationality": "TR",
              "national_id": "10000000146",
              "passport_number": "U01234567",
              "passport_country": "TR",
              "passport_expiry": "2031-06-30",
              "date_of_birth": "1988-04-21",
              "gender": "MRS",
              "frequent_flyer_number": "TK123456789",
              "passenger_type": "adult",
              "phone": "+905551112233",
              "fare": "850.00",
              "seats": [
                {
                  "leg": 0,
                  "seat_number": "12",
                  "coach_number": "3",
                  "ticket_number": "BUS-2026-000101",
                  "fare_amount": "850.00"
                }
              ]
            }
          ],
          "cost_lines": [
            {
              "kind": "ticket_fare",
              "amount": "1250.00",
              "label": "Imported line",
              "currency": "EUR",
              "vat_rate": "20",
              "tax_inclusive": true,
              "quantity": 1
            }
          ],
          "sell_lines": [
            {
              "kind": "package_price",
              "amount": "1250.00",
              "label": "Imported line",
              "currency": "EUR",
              "vat_rate": "20",
              "tax_inclusive": true,
              "quantity": 1
            }
          ],
          "bill_to_legal_name": "Lovelace Seyahat A.Ş.",
          "bill_to_tax_number": "1234567890",
          "bill_to_tax_office": "Beşiktaş",
          "bill_to_address_line": "Nispetiye Cad. No:12",
          "bill_to_city": "İstanbul",
          "bill_to_country": "TR"
        }
      ]
    }),
  },
);

if (!response.ok) throw new Error(`${response.status} ${await response.text()}`);
const data = await response.json();

import requests

response = requests.post(
    "https://YOUR-CELL.lydira.com/api/v1/imports/bus_bookings/validate",
    headers={
        "Authorization": "Bearer sek_YOUR_API_KEY",
        "Content-Type": "application/json",
        "Idempotency-Key": "8f14e45f-ea2c-4f33-9a3b-6d0c1b7e5a90",
    },
    json={
      "source_system": "crm",
      "rows": [
        {
          "external_id": "BUS-BOOKING-1001-B",
          "currency": "EUR",
          "supplier_external_id": "SUPPLIER-1001",
          "billing_basis": "agent",
          "fare_collected_by": "agency",
          "status": "draft",
          "reference": "Reference",
          "supplier_confirmation_no": "Supplier confirmation no",
          "notes": "Imported from the source system.",
          "option_date": "2026-03-20T18:00",
          "transaction_date": "2026-03-14",
          "invoice_date": "2026-03-18",
          "legs": [
            {
              "origin_name": "İstanbul",
              "origin_code": "IST",
              "destination_name": "Ankara",
              "destination_code": "ANK",
              "departs_at": "2026-03-14T09:30:00+03:00",
              "arrives_at": "2026-03-14T12:45:00+03:00",
              "service_number": "S-101",
              "operator_name": "Express Lines",
              "fare_name": "Standard"
            }
          ],
          "travelers": [
            {
              "first_name": "Ada",
              "last_name": "Lovelace",
              "nationality": "TR",
              "national_id": "10000000146",
              "passport_number": "U01234567",
              "passport_country": "TR",
              "passport_expiry": "2031-06-30",
              "date_of_birth": "1988-04-21",
              "gender": "MRS",
              "frequent_flyer_number": "TK123456789",
              "passenger_type": "adult",
              "phone": "+905551112233",
              "fare": "850.00",
              "seats": [
                {
                  "leg": 0,
                  "seat_number": "12",
                  "coach_number": "3",
                  "ticket_number": "BUS-2026-000101",
                  "fare_amount": "850.00"
                }
              ]
            }
          ],
          "cost_lines": [
            {
              "kind": "ticket_fare",
              "amount": "1250.00",
              "label": "Imported line",
              "currency": "EUR",
              "vat_rate": "20",
              "tax_inclusive": True,
              "quantity": 1
            }
          ],
          "sell_lines": [
            {
              "kind": "package_price",
              "amount": "1250.00",
              "label": "Imported line",
              "currency": "EUR",
              "vat_rate": "20",
              "tax_inclusive": True,
              "quantity": 1
            }
          ],
          "bill_to_legal_name": "Lovelace Seyahat A.Ş.",
          "bill_to_tax_number": "1234567890",
          "bill_to_tax_office": "Beşiktaş",
          "bill_to_address_line": "Nispetiye Cad. No:12",
          "bill_to_city": "İstanbul",
          "bill_to_country": "TR"
        }
      ]
    },
)
response.raise_for_status()
data = response.json()

require "net/http"
require "json"

uri = URI("https://YOUR-CELL.lydira.com/api/v1/imports/bus_bookings/validate")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer sek_YOUR_API_KEY"
request["Content-Type"] = "application/json"
request["Idempotency-Key"] = "8f14e45f-ea2c-4f33-9a3b-6d0c1b7e5a90"
request.body = JSON.generate({
  source_system: "crm",
  rows: [
    {
      external_id: "BUS-BOOKING-1001-B",
      currency: "EUR",
      supplier_external_id: "SUPPLIER-1001",
      billing_basis: "agent",
      fare_collected_by: "agency",
      status: "draft",
      reference: "Reference",
      supplier_confirmation_no: "Supplier confirmation no",
      notes: "Imported from the source system.",
      option_date: "2026-03-20T18:00",
      transaction_date: "2026-03-14",
      invoice_date: "2026-03-18",
      legs: [
        {
          origin_name: "İstanbul",
          origin_code: "IST",
          destination_name: "Ankara",
          destination_code: "ANK",
          departs_at: "2026-03-14T09:30:00+03:00",
          arrives_at: "2026-03-14T12:45:00+03:00",
          service_number: "S-101",
          operator_name: "Express Lines",
          fare_name: "Standard"
        }
      ],
      travelers: [
        {
          first_name: "Ada",
          last_name: "Lovelace",
          nationality: "TR",
          national_id: "10000000146",
          passport_number: "U01234567",
          passport_country: "TR",
          passport_expiry: "2031-06-30",
          date_of_birth: "1988-04-21",
          gender: "MRS",
          frequent_flyer_number: "TK123456789",
          passenger_type: "adult",
          phone: "+905551112233",
          fare: "850.00",
          seats: [
            {
              leg: 0,
              seat_number: "12",
              coach_number: "3",
              ticket_number: "BUS-2026-000101",
              fare_amount: "850.00"
            }
          ]
        }
      ],
      cost_lines: [
        {
          kind: "ticket_fare",
          amount: "1250.00",
          label: "Imported line",
          currency: "EUR",
          vat_rate: "20",
          tax_inclusive: true,
          quantity: 1
        }
      ],
      sell_lines: [
        {
          kind: "package_price",
          amount: "1250.00",
          label: "Imported line",
          currency: "EUR",
          vat_rate: "20",
          tax_inclusive: true,
          quantity: 1
        }
      ],
      bill_to_legal_name: "Lovelace Seyahat A.Ş.",
      bill_to_tax_number: "1234567890",
      bill_to_tax_office: "Beşiktaş",
      bill_to_address_line: "Nispetiye Cad. No:12",
      bill_to_city: "İstanbul",
      bill_to_country: "TR"
    }
  ]
})

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { it.request(request) }
raise response.body unless response.is_a?(Net::HTTPSuccess)
data = JSON.parse(response.body)

<?php
$ch = curl_init("https://YOUR-CELL.lydira.com/api/v1/imports/bus_bookings/validate");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => "POST",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        "Authorization: Bearer sek_YOUR_API_KEY",
        "Content-Type: application/json",
        "Idempotency-Key: 8f14e45f-ea2c-4f33-9a3b-6d0c1b7e5a90",
    ],
    CURLOPT_POSTFIELDS     => json_encode([
        "source_system" => "crm",
        "rows" => [
            [
                "external_id" => "BUS-BOOKING-1001-B",
                "currency" => "EUR",
                "supplier_external_id" => "SUPPLIER-1001",
                "billing_basis" => "agent",
                "fare_collected_by" => "agency",
                "status" => "draft",
                "reference" => "Reference",
                "supplier_confirmation_no" => "Supplier confirmation no",
                "notes" => "Imported from the source system.",
                "option_date" => "2026-03-20T18:00",
                "transaction_date" => "2026-03-14",
                "invoice_date" => "2026-03-18",
                "legs" => [
                    [
                        "origin_name" => "İstanbul",
                        "origin_code" => "IST",
                        "destination_name" => "Ankara",
                        "destination_code" => "ANK",
                        "departs_at" => "2026-03-14T09:30:00+03:00",
                        "arrives_at" => "2026-03-14T12:45:00+03:00",
                        "service_number" => "S-101",
                        "operator_name" => "Express Lines",
                        "fare_name" => "Standard",
                    ],
                ],
                "travelers" => [
                    [
                        "first_name" => "Ada",
                        "last_name" => "Lovelace",
                        "nationality" => "TR",
                        "national_id" => "10000000146",
                        "passport_number" => "U01234567",
                        "passport_country" => "TR",
                        "passport_expiry" => "2031-06-30",
                        "date_of_birth" => "1988-04-21",
                        "gender" => "MRS",
                        "frequent_flyer_number" => "TK123456789",
                        "passenger_type" => "adult",
                        "phone" => "+905551112233",
                        "fare" => "850.00",
                        "seats" => [
                            [
                                "leg" => 0,
                                "seat_number" => "12",
                                "coach_number" => "3",
                                "ticket_number" => "BUS-2026-000101",
                                "fare_amount" => "850.00",
                            ],
                        ],
                    ],
                ],
                "cost_lines" => [
                    [
                        "kind" => "ticket_fare",
                        "amount" => "1250.00",
                        "label" => "Imported line",
                        "currency" => "EUR",
                        "vat_rate" => "20",
                        "tax_inclusive" => true,
                        "quantity" => 1,
                    ],
                ],
                "sell_lines" => [
                    [
                        "kind" => "package_price",
                        "amount" => "1250.00",
                        "label" => "Imported line",
                        "currency" => "EUR",
                        "vat_rate" => "20",
                        "tax_inclusive" => true,
                        "quantity" => 1,
                    ],
                ],
                "bill_to_legal_name" => "Lovelace Seyahat A.Ş.",
                "bill_to_tax_number" => "1234567890",
                "bill_to_tax_office" => "Beşiktaş",
                "bill_to_address_line" => "Nispetiye Cad. No:12",
                "bill_to_city" => "İstanbul",
                "bill_to_country" => "TR",
            ],
        ],
    ]),
]);

$data = json_decode(curl_exec($ch), true);
curl_close($ch);

Hizmet bedeli

service_fee taşımayan satıra acentenin hizmet bedeli kuralları bedel yazar. Taşıyan satır acentenin bütün rezervasyon için bedelini rezervasyonun parasıyla söyler ve kurallar bir şey yazmaz. Bunun yerine service_fee_percent gönderebilirsiniz: bedel, acentenin rezervasyon formundaki gibi rezervasyonun bedel ve indirim öncesi satışının yüzdesi olur, 0 ile 100 arasında (1.200,00 satışta 10, 120,00 eder). İkisinden yalnız birini gönderin; ikisini birden ya da 0–100 dışında bir yüzde taşıyan satır reddedilir. İkisinde de 0 sizin bir bedeliniz olmadığını söyler, kurallar kendi bedelini yazar. service_fee_vat_rate bedelin KDV'sidir (0 istisna demektir); göndermezseniz yasa, o da belirlemiyorsa acentenin standart oranı uygulanır. service_fee_waived: true bu rezervasyonda kuralları durdurur, gönderdiğiniz bedel yine yazılır. İşareti düzeltmeyle açıp kapatabilirsiniz; rezervasyon faturalanınca donar. Bedelin kendisi düzeltilemez.

Bu rezervasyon misafir başına faturalanır, bu yüzden bedel acentenin rezervasyon formundaki gibi misafirlere satışlarına göre bölünür. Bedeli sell_lines içinde service_fee kalemi olarak göndermeyin. Her satış satırı ilk misafire yazıldığı için o satır reddedilir.

Bedeli bölecek satışı henüz olmayan rezervasyon hizmet bedeli yazılmadan kaydolur ve satır şu uyarıyı taşır: service_fee_dropped

Alanlar:service_feeservice_fee_percentservice_fee_vat_rateservice_fee_waived

Alanlar(36)

external_idstring
currencycurrency
omit for the company's own
customer_external_idreference
the cari; omit it for a walk-in sale billed to the first passenger
supplier_external_idreference
the carrier
billing_basisenum
agent ⇒ the fare is the carrier's money and the agency bills its own fee; gross ⇒ the agency resells the fare. Omit for the company's default (agent in Türkiye)
Şunlardan biri:agentgross
fare_collected_byenum
who took the fare from the passenger; a gross sale is always the agency's
Şunlardan biri:agencycarrier
statusenum
default issued; cancelled on an amendment cancels the booking
Şunlardan biri:draftoptionissuedcancelled
referencestring
the carrier's booking reference (PNR)
supplier_confirmation_nostring
notesstring
option_datedate
transaction_datedate
işlem tarihi — the FX anchor for every line
invoice_datedate
custom_fieldsobject
the account's own fields on the booking, by key
legsobject[]
the journey in order; a seat names its leg by position
Her öğe
- origin_namestring
- origin_codestring
- destination_namestring
- destination_codestring
- departs_atdatetime
- arrives_atdatetime
- service_numberstring
  the trip or train number
- operator_namestring
- fare_namestring
travelersobject[]PII
passengers; auto-saved to the cari's traveller directory. The first is the walk-in payer
Her öğe
- first_namestringPII
- last_namestringPII
- nationalitystring
- national_idstringPII
- passport_numberstringPII
- passport_countrystring
- passport_expirydate
- date_of_birthdatePII
- genderstring
  Uygulamanın kullandığı değerler:MRMRSMISSMSTR
- frequent_flyer_numberstring
- passenger_typeenum
  Şunlardan biri:adultchildinfant
- phonephonePII
- faremoney
  the carrier's fare for this passenger, written as its ticket_fare sell and cost line
- custom_fieldsobject
  the account's own fields on the passenger, by key
- seatsobject[]
  one per leg the passenger rides
  Her öğe
  - leginteger
    the leg's position in legs, from 0
  - seat_numberstring
  - coach_numberstring
  - ticket_numberstring
    the e-ticket number
  - fare_amountmoney
    this leg's share of the fare
cost_linesobject[]
cost-side pricing lines for the "bus" pricing context
Her öğe
- kindstringzorunlu
  Uygulamanın kullandığı değerler:ticket_farecarrier_commissionapplied_fareservice_feesupplier_refundinsurance_premium
- amountmoneyzorunlu
- labelstring
- currencycurrency
- vat_ratedecimal
  percent (20 ⇒ 20% KDV); omit to take the kind's default
- tax_inclusiveboolean
  true ⇒ the amount includes VAT. A hotel stay or a charter takes one VAT mode: the lines' flags decide it, lines stating both are refused, and every line follows the booking's mode afterwards
- quantityinteger
sell_linesobject[]
sell-side pricing lines for the "bus" pricing context
Her öğe
- kindstringzorunlu
  Uygulamanın kullandığı değerler:package_pricemarkupservice_feesupplier_commissioncancellation_feeinsurance_premiumdiscountrefund_allowanceticket_farecarrier_commissionapplied_faresupplier_refund
- amountmoneyzorunlu
- labelstring
- currencycurrency
- vat_ratedecimal
  percent (20 ⇒ 20% KDV); omit to take the kind's default
- tax_inclusiveboolean
  true ⇒ the amount includes VAT. A hotel stay or a charter takes one VAT mode: the lines' flags decide it, lines stating both are refused, and every line follows the booking's mode afterwards
- quantityinteger
service_feemoney
the agency's fee for the whole booking, in its currency; split across the guests like the booking form's. Sent, the account's service-fee rules write nothing
service_fee_percentdecimal
the fee as a percentage (0-100) of the booking's sale before fee and discount, instead of service_fee; split like it
service_fee_vat_ratedecimal
the fee's VAT, percent (0 ⇒ exempt); omit it and the law decides, else the seller's standard rate
service_fee_waivedboolean
true: the account's service-fee rules write no fee on this booking
bill_to_typeenum
omit to infer: a legal name or a 10-digit tax number ⇒ corporate
Şunlardan biri:corporateindividual
bill_to_legal_namestring
bill_to_tax_numbertax_numberPII
VKN for a corporate payer, TCKN for an individual; matched digits-only
bill_to_tax_officestring
bill_to_passport_numberstringPII
individual only; used when there is no TCKN
bill_to_first_namestringPII
bill_to_last_namestringPII
bill_to_emailemailPII
stored on a NEW cari; never used to match
bill_to_phonephonePII
stored on a NEW cari; never used to match
bill_to_address_linestringPII
bill_to_districtstringPII
bill_to_citystringPII
bill_to_zipstringPII
bill_to_countrystring
ISO-2 code, e.g. TR

Referanslar

customer_external_id → customers · eşleşme external_id, email · bulunamazsa skip
supplier_external_id → suppliers · eşleşme external_id, code · bulunamazsa skip

Hesabınızın ek alanları (custom_fields)

Her acente Ayarlar → Ek alanlar'dan kendi alanlarını ekler: proje kodu, seyahat nedeni, sicil numarası gibi. Alanlar hesaptan hesaba değiştiği için bu sayfa onları listeleyemez. Entegrasyonunuz bunları API'den öğrenir.

GET /api/v1/imports/entities/{key} yanıtındaki custom_fields, anahtarınızın bağlı olduğu hesabın bu kayıt türündeki alanlarını verir: kaydın kendisi için record, her yolcu ya da misafir için traveler. Her alan satırda gönderilecek key'i, type'ını, zorunlu olup olmadığını (required), hangi carilere uygulandığını (applies_to) ve seçmeli bir alansa options listesini taşır. Eşlemeyi kurarken okuyun; acente bir alanı değiştirdiğini söylediğinde yeniden okuyun. Bu, hesabın canlı listesidir.

İstek · hesabın alanları

curl -X GET 'https://YOUR-CELL.lydira.com/api/v1/imports/entities/bus_bookings' \
  -H 'Authorization: Bearer sek_YOUR_API_KEY'

const response = await fetch(
  "https://YOUR-CELL.lydira.com/api/v1/imports/entities/bus_bookings",
  {
    method: "GET",
    headers: {
      "Authorization": "Bearer sek_YOUR_API_KEY",
    },
  },
);

if (!response.ok) throw new Error(`${response.status} ${await response.text()}`);
const data = await response.json();

import requests

response = requests.get(
    "https://YOUR-CELL.lydira.com/api/v1/imports/entities/bus_bookings",
    headers={
        "Authorization": "Bearer sek_YOUR_API_KEY",
    },
)
response.raise_for_status()
data = response.json()

require "net/http"
require "json"

uri = URI("https://YOUR-CELL.lydira.com/api/v1/imports/entities/bus_bookings")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer sek_YOUR_API_KEY"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { it.request(request) }
raise response.body unless response.is_a?(Net::HTTPSuccess)
data = JSON.parse(response.body)

<?php
$ch = curl_init("https://YOUR-CELL.lydira.com/api/v1/imports/entities/bus_bookings");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => "GET",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        "Authorization: Bearer sek_YOUR_API_KEY",
    ],
]);

$data = json_decode(curl_exec($ch), true);
curl_close($ch);

Yanıt · custom_fields (kesit)

200

{
  "key": "bus_bookings",
  "custom_fields": {
    "record": [
      {
        "key": "project_code",
        "label": "Project code",
        "type": "text",
        "required": "always",
        "applies_to": "all"
      },
      {
        "key": "trip_reason",
        "label": "Trip reason",
        "type": "select",
        "required": "listed_customers",
        "applies_to": "listed_customers",
        "options": [
          {
            "value": "meeting",
            "label": "Meeting"
          },
          {
            "value": "fair",
            "label": "Trade fair"
          }
        ],
        "customers": [
          {
            "id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
            "external_id": "CUST-17",
            "required": true
          }
        ]
      }
    ],
    "traveler": [
      {
        "key": "employee_no",
        "label": "Employee no",
        "type": "text",
        "required": "never",
        "applies_to": "all",
        "pii": true
      }
    ]
  }
}

Her tip ne alır

tip	satırdaki değer
`text`	`"PRJ-2026-001"`
`long_text`	`"Fair delegation, second group"`
`number`	`12.5`
`date`	`"2026-03-14"`
`boolean`	`true`
`select`	`"meeting"`
`multi_select`	`["meeting", "fair"]`

number takes a number or a numeric string; date an ISO date; select one option value (or its label); multi_select a list of them.

required ve applies_to

requiredneveralwayslisted_customers
listed_customers: required only for the customers marked required in customers.
applies_toalllisted_customers
listed_customers: the field is accepted only on those customers' records.

Değerleri key'e göre tek bir JSON nesnesi olarak gönderin. Bilinmeyen bir anahtar, yanlış tipte bir değer ya da eksik bir zorunlu alan satırı düşürür ve hatada anahtarın adı geçer. Güncellemede (on_conflict: update) nesne anahtar anahtar birleşir: göndermediğiniz anahtar korunur, null gönderdiğiniz silinir. Acentenin müşteri belgelerine bastığı bir alan, kayıt faturalandıktan sonra değişmez.

Yolcu alanları her yolcunun kendi custom_fields nesnesine yazılır.

Aynı biçimde geri gelirler: geri okumada ve webhook gövdesinde detail.custom_fields altında (biletin her yolcusunda da). Kişisel veri olarak işaretli alan yalnızca rolü kişisel veriyi okuyabilen bir anahtara döner; webhook'ta hiç yer almaz.

Geri okuma

Acente kaydı işledikten sonra (onaylar, biletleri numaralar, faturalar) GET /api/v1/imports/{entity}/records/{external_id} bunu döner; her webhook da aynı gövdeyi taşır. detail, gönderiminizden sonra yalnız acentenin ekleyebildiği bilgileri taşır.

GET /api/v1/imports/bus_bookings/records/BUS-BOOKING-1001

200

{
  "entity": "bus_bookings",
  "external_id": "BUS-BOOKING-1001",
  "source_system": "crm",
  "type": "BusBooking",
  "id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
  "created_at": "2026-03-14T09:30:00Z",
  "updated_at": "2026-03-15T11:05:00Z",
  "status": "issued",
  "locked": true,
  "lock_reason": "invoiced",
  "currency": "EUR",
  "totals": {
    "cost": "1100.0",
    "sell": "1250.0"
  },
  "invoices": [
    {
      "id": "4b8e1f60-7c2d-4e9a-b3f5-0a6d2c9e8b71",
      "number": "LYD2026000000117",
      "status": "issued",
      "currency": "EUR",
      "total": "1250.0",
      "balance": "1250.0"
    }
  ],
  "detail": {
    "voucher_number": "VCH-2026-000412",
    "supplier_confirmation_no": "CNF-77821",
    "supplier": "Lovelace Travel Partners",
    "custom_fields": {
      "project_code": "PRJ-2026-001",
      "trip_reason": "meeting"
    },
    "route": "İstanbul → Ankara",
    "departs_at": "2026-03-14T06:30:00Z",
    "billing_basis": "agent",
    "option_date": "2026-03-10"
  }
}

İstek · deneme, tüm alanlar

curl -X POST 'https://YOUR-CELL.lydira.com/api/v1/imports/bus_bookings/validate' \
  -H 'Authorization: Bearer sek_YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: 8f14e45f-ea2c-4f33-9a3b-6d0c1b7e5a90' \
  -d '{
  "source_system": "crm",
  "rows": [
    {
      "external_id": "BUS-BOOKING-1001",
      "currency": "EUR",
      "customer_external_id": "CUSTOMER-1001",
      "supplier_external_id": "SUPPLIER-1001",
      "billing_basis": "agent",
      "fare_collected_by": "agency",
      "status": "draft",
      "reference": "Reference",
      "supplier_confirmation_no": "Supplier confirmation no",
      "notes": "Imported from the source system.",
      "option_date": "2026-03-20T18:00",
      "transaction_date": "2026-03-14",
      "invoice_date": "2026-03-18",
      "custom_fields": {
        "project_code": "PRJ-2026-001",
        "trip_reason": "meeting"
      },
      "legs": [
        {
          "origin_name": "İstanbul",
          "origin_code": "IST",
          "destination_name": "Ankara",
          "destination_code": "ANK",
          "departs_at": "2026-03-14T09:30:00+03:00",
          "arrives_at": "2026-03-14T12:45:00+03:00",
          "service_number": "S-101",
          "operator_name": "Express Lines",
          "fare_name": "Standard"
        }
      ],
      "travelers": [
        {
          "first_name": "Ada",
          "last_name": "Lovelace",
          "nationality": "TR",
          "national_id": "10000000146",
          "passport_number": "U01234567",
          "passport_country": "TR",
          "passport_expiry": "2031-06-30",
          "date_of_birth": "1988-04-21",
          "gender": "MRS",
          "frequent_flyer_number": "TK123456789",
          "passenger_type": "adult",
          "phone": "+905551112233",
          "fare": "850.00",
          "custom_fields": {
            "employee_no": "E-10442"
          },
          "seats": [
            {
              "leg": 0,
              "seat_number": "12",
              "coach_number": "3",
              "ticket_number": "BUS-2026-000101",
              "fare_amount": "850.00"
            }
          ]
        }
      ],
      "cost_lines": [
        {
          "kind": "ticket_fare",
          "amount": "1250.00",
          "label": "Imported line",
          "currency": "EUR",
          "vat_rate": "20",
          "tax_inclusive": true,
          "quantity": 1
        }
      ],
      "sell_lines": [
        {
          "kind": "package_price",
          "amount": "1250.00",
          "label": "Imported line",
          "currency": "EUR",
          "vat_rate": "20",
          "tax_inclusive": true,
          "quantity": 1
        }
      ],
      "service_fee": "1250.00",
      "service_fee_vat_rate": "20",
      "service_fee_waived": true
    }
  ]
}'

const response = await fetch(
  "https://YOUR-CELL.lydira.com/api/v1/imports/bus_bookings/validate",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer sek_YOUR_API_KEY",
      "Content-Type": "application/json",
      "Idempotency-Key": "8f14e45f-ea2c-4f33-9a3b-6d0c1b7e5a90",
    },
    body: JSON.stringify({
      "source_system": "crm",
      "rows": [
        {
          "external_id": "BUS-BOOKING-1001",
          "currency": "EUR",
          "customer_external_id": "CUSTOMER-1001",
          "supplier_external_id": "SUPPLIER-1001",
          "billing_basis": "agent",
          "fare_collected_by": "agency",
          "status": "draft",
          "reference": "Reference",
          "supplier_confirmation_no": "Supplier confirmation no",
          "notes": "Imported from the source system.",
          "option_date": "2026-03-20T18:00",
          "transaction_date": "2026-03-14",
          "invoice_date": "2026-03-18",
          "custom_fields": {
            "project_code": "PRJ-2026-001",
            "trip_reason": "meeting"
          },
          "legs": [
            {
              "origin_name": "İstanbul",
              "origin_code": "IST",
              "destination_name": "Ankara",
              "destination_code": "ANK",
              "departs_at": "2026-03-14T09:30:00+03:00",
              "arrives_at": "2026-03-14T12:45:00+03:00",
              "service_number": "S-101",
              "operator_name": "Express Lines",
              "fare_name": "Standard"
            }
          ],
          "travelers": [
            {
              "first_name": "Ada",
              "last_name": "Lovelace",
              "nationality": "TR",
              "national_id": "10000000146",
              "passport_number": "U01234567",
              "passport_country": "TR",
              "passport_expiry": "2031-06-30",
              "date_of_birth": "1988-04-21",
              "gender": "MRS",
              "frequent_flyer_number": "TK123456789",
              "passenger_type": "adult",
              "phone": "+905551112233",
              "fare": "850.00",
              "custom_fields": {
                "employee_no": "E-10442"
              },
              "seats": [
                {
                  "leg": 0,
                  "seat_number": "12",
                  "coach_number": "3",
                  "ticket_number": "BUS-2026-000101",
                  "fare_amount": "850.00"
                }
              ]
            }
          ],
          "cost_lines": [
            {
              "kind": "ticket_fare",
              "amount": "1250.00",
              "label": "Imported line",
              "currency": "EUR",
              "vat_rate": "20",
              "tax_inclusive": true,
              "quantity": 1
            }
          ],
          "sell_lines": [
            {
              "kind": "package_price",
              "amount": "1250.00",
              "label": "Imported line",
              "currency": "EUR",
              "vat_rate": "20",
              "tax_inclusive": true,
              "quantity": 1
            }
          ],
          "service_fee": "1250.00",
          "service_fee_vat_rate": "20",
          "service_fee_waived": true
        }
      ]
    }),
  },
);

if (!response.ok) throw new Error(`${response.status} ${await response.text()}`);
const data = await response.json();

import requests

response = requests.post(
    "https://YOUR-CELL.lydira.com/api/v1/imports/bus_bookings/validate",
    headers={
        "Authorization": "Bearer sek_YOUR_API_KEY",
        "Content-Type": "application/json",
        "Idempotency-Key": "8f14e45f-ea2c-4f33-9a3b-6d0c1b7e5a90",
    },
    json={
      "source_system": "crm",
      "rows": [
        {
          "external_id": "BUS-BOOKING-1001",
          "currency": "EUR",
          "customer_external_id": "CUSTOMER-1001",
          "supplier_external_id": "SUPPLIER-1001",
          "billing_basis": "agent",
          "fare_collected_by": "agency",
          "status": "draft",
          "reference": "Reference",
          "supplier_confirmation_no": "Supplier confirmation no",
          "notes": "Imported from the source system.",
          "option_date": "2026-03-20T18:00",
          "transaction_date": "2026-03-14",
          "invoice_date": "2026-03-18",
          "custom_fields": {
            "project_code": "PRJ-2026-001",
            "trip_reason": "meeting"
          },
          "legs": [
            {
              "origin_name": "İstanbul",
              "origin_code": "IST",
              "destination_name": "Ankara",
              "destination_code": "ANK",
              "departs_at": "2026-03-14T09:30:00+03:00",
              "arrives_at": "2026-03-14T12:45:00+03:00",
              "service_number": "S-101",
              "operator_name": "Express Lines",
              "fare_name": "Standard"
            }
          ],
          "travelers": [
            {
              "first_name": "Ada",
              "last_name": "Lovelace",
              "nationality": "TR",
              "national_id": "10000000146",
              "passport_number": "U01234567",
              "passport_country": "TR",
              "passport_expiry": "2031-06-30",
              "date_of_birth": "1988-04-21",
              "gender": "MRS",
              "frequent_flyer_number": "TK123456789",
              "passenger_type": "adult",
              "phone": "+905551112233",
              "fare": "850.00",
              "custom_fields": {
                "employee_no": "E-10442"
              },
              "seats": [
                {
                  "leg": 0,
                  "seat_number": "12",
                  "coach_number": "3",
                  "ticket_number": "BUS-2026-000101",
                  "fare_amount": "850.00"
                }
              ]
            }
          ],
          "cost_lines": [
            {
              "kind": "ticket_fare",
              "amount": "1250.00",
              "label": "Imported line",
              "currency": "EUR",
              "vat_rate": "20",
              "tax_inclusive": True,
              "quantity": 1
            }
          ],
          "sell_lines": [
            {
              "kind": "package_price",
              "amount": "1250.00",
              "label": "Imported line",
              "currency": "EUR",
              "vat_rate": "20",
              "tax_inclusive": True,
              "quantity": 1
            }
          ],
          "service_fee": "1250.00",
          "service_fee_vat_rate": "20",
          "service_fee_waived": True
        }
      ]
    },
)
response.raise_for_status()
data = response.json()

require "net/http"
require "json"

uri = URI("https://YOUR-CELL.lydira.com/api/v1/imports/bus_bookings/validate")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer sek_YOUR_API_KEY"
request["Content-Type"] = "application/json"
request["Idempotency-Key"] = "8f14e45f-ea2c-4f33-9a3b-6d0c1b7e5a90"
request.body = JSON.generate({
  source_system: "crm",
  rows: [
    {
      external_id: "BUS-BOOKING-1001",
      currency: "EUR",
      customer_external_id: "CUSTOMER-1001",
      supplier_external_id: "SUPPLIER-1001",
      billing_basis: "agent",
      fare_collected_by: "agency",
      status: "draft",
      reference: "Reference",
      supplier_confirmation_no: "Supplier confirmation no",
      notes: "Imported from the source system.",
      option_date: "2026-03-20T18:00",
      transaction_date: "2026-03-14",
      invoice_date: "2026-03-18",
      custom_fields: {
        project_code: "PRJ-2026-001",
        trip_reason: "meeting"
      },
      legs: [
        {
          origin_name: "İstanbul",
          origin_code: "IST",
          destination_name: "Ankara",
          destination_code: "ANK",
          departs_at: "2026-03-14T09:30:00+03:00",
          arrives_at: "2026-03-14T12:45:00+03:00",
          service_number: "S-101",
          operator_name: "Express Lines",
          fare_name: "Standard"
        }
      ],
      travelers: [
        {
          first_name: "Ada",
          last_name: "Lovelace",
          nationality: "TR",
          national_id: "10000000146",
          passport_number: "U01234567",
          passport_country: "TR",
          passport_expiry: "2031-06-30",
          date_of_birth: "1988-04-21",
          gender: "MRS",
          frequent_flyer_number: "TK123456789",
          passenger_type: "adult",
          phone: "+905551112233",
          fare: "850.00",
          custom_fields: {
            employee_no: "E-10442"
          },
          seats: [
            {
              leg: 0,
              seat_number: "12",
              coach_number: "3",
              ticket_number: "BUS-2026-000101",
              fare_amount: "850.00"
            }
          ]
        }
      ],
      cost_lines: [
        {
          kind: "ticket_fare",
          amount: "1250.00",
          label: "Imported line",
          currency: "EUR",
          vat_rate: "20",
          tax_inclusive: true,
          quantity: 1
        }
      ],
      sell_lines: [
        {
          kind: "package_price",
          amount: "1250.00",
          label: "Imported line",
          currency: "EUR",
          vat_rate: "20",
          tax_inclusive: true,
          quantity: 1
        }
      ],
      service_fee: "1250.00",
      service_fee_vat_rate: "20",
      service_fee_waived: true
    }
  ]
})

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { it.request(request) }
raise response.body unless response.is_a?(Net::HTTPSuccess)
data = JSON.parse(response.body)

<?php
$ch = curl_init("https://YOUR-CELL.lydira.com/api/v1/imports/bus_bookings/validate");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => "POST",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        "Authorization: Bearer sek_YOUR_API_KEY",
        "Content-Type: application/json",
        "Idempotency-Key: 8f14e45f-ea2c-4f33-9a3b-6d0c1b7e5a90",
    ],
    CURLOPT_POSTFIELDS     => json_encode([
        "source_system" => "crm",
        "rows" => [
            [
                "external_id" => "BUS-BOOKING-1001",
                "currency" => "EUR",
                "customer_external_id" => "CUSTOMER-1001",
                "supplier_external_id" => "SUPPLIER-1001",
                "billing_basis" => "agent",
                "fare_collected_by" => "agency",
                "status" => "draft",
                "reference" => "Reference",
                "supplier_confirmation_no" => "Supplier confirmation no",
                "notes" => "Imported from the source system.",
                "option_date" => "2026-03-20T18:00",
                "transaction_date" => "2026-03-14",
                "invoice_date" => "2026-03-18",
                "custom_fields" => [
                    "project_code" => "PRJ-2026-001",
                    "trip_reason" => "meeting",
                ],
                "legs" => [
                    [
                        "origin_name" => "İstanbul",
                        "origin_code" => "IST",
                        "destination_name" => "Ankara",
                        "destination_code" => "ANK",
                        "departs_at" => "2026-03-14T09:30:00+03:00",
                        "arrives_at" => "2026-03-14T12:45:00+03:00",
                        "service_number" => "S-101",
                        "operator_name" => "Express Lines",
                        "fare_name" => "Standard",
                    ],
                ],
                "travelers" => [
                    [
                        "first_name" => "Ada",
                        "last_name" => "Lovelace",
                        "nationality" => "TR",
                        "national_id" => "10000000146",
                        "passport_number" => "U01234567",
                        "passport_country" => "TR",
                        "passport_expiry" => "2031-06-30",
                        "date_of_birth" => "1988-04-21",
                        "gender" => "MRS",
                        "frequent_flyer_number" => "TK123456789",
                        "passenger_type" => "adult",
                        "phone" => "+905551112233",
                        "fare" => "850.00",
                        "custom_fields" => [
                            "employee_no" => "E-10442",
                        ],
                        "seats" => [
                            [
                                "leg" => 0,
                                "seat_number" => "12",
                                "coach_number" => "3",
                                "ticket_number" => "BUS-2026-000101",
                                "fare_amount" => "850.00",
                            ],
                        ],
                    ],
                ],
                "cost_lines" => [
                    [
                        "kind" => "ticket_fare",
                        "amount" => "1250.00",
                        "label" => "Imported line",
                        "currency" => "EUR",
                        "vat_rate" => "20",
                        "tax_inclusive" => true,
                        "quantity" => 1,
                    ],
                ],
                "sell_lines" => [
                    [
                        "kind" => "package_price",
                        "amount" => "1250.00",
                        "label" => "Imported line",
                        "currency" => "EUR",
                        "vat_rate" => "20",
                        "tax_inclusive" => true,
                        "quantity" => 1,
                    ],
                ],
                "service_fee" => "1250.00",
                "service_fee_vat_rate" => "20",
                "service_fee_waived" => true,
            ],
        ],
    ]),
]);

$data = json_decode(curl_exec($ch), true);
curl_close($ch);

Yanıt

200

{
  "import": {
    "id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
    "entity": "bus_bookings",
    "source_system": "crm",
    "status": "ready",
    "company_id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
    "stats": {
      "total": 1,
      "will_create": 1,
      "will_update": 0,
      "created": 0,
      "updated": 0,
      "skipped": 0,
      "invalid": 0,
      "failed": 0,
      "not_selected": 0
    },
    "error": null,
    "created_at": "2026-03-14T09:30:00Z",
    "links": {
      "self": "/api/v1/imports/9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
      "rows": "/api/v1/imports/9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18/rows"
    },
    "mode": "validate",
    "async": false,
    "on_conflict": "skip",
    "pricing": "apply_rules"
  },
  "ignored_fields": [],
  "results": [
    {
      "row": 1,
      "external_id": "BUS-BOOKING-1001",
      "status": "will_create",
      "payer": {
        "outcome": "external_id",
        "customer_id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18"
      }
    }
  ]
}

Tren biletleri`rail_bookings`

POST/api/v1/imports/rail_bookings

Bir kez oluşturulur: aynı external_id ile tekrar gönderim kopya açmaz, atlanır.

Uç noktalar

validatePOST /api/v1/imports/rail_bookings/validate
importPOST /api/v1/imports/rail_bookings
feedGET /api/v1/imports/rail_bookings/records
read_backGET /api/v1/imports/rail_bookings/records/{external_id}

Fatura kime kesilir

Kurumsal (ünvan ya da 10 haneli vergi numarası): tax_number → legal_name

Bireysel: tax_number → passport_number

Fatura bilgisi yoksa bireysel ödeyen şu listedeki ilk yolcudur: travelers[0]

external_idmatchedcreatedwould_createnone

Fatura bilgisiyle örnek istek (cari anahtarı olmadan)

curl -X POST 'https://YOUR-CELL.lydira.com/api/v1/imports/rail_bookings/validate' \
  -H 'Authorization: Bearer sek_YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: 8f14e45f-ea2c-4f33-9a3b-6d0c1b7e5a90' \
  -d '{
  "source_system": "crm",
  "rows": [
    {
      "external_id": "RAIL-BOOKING-1001-B",
      "currency": "EUR",
      "supplier_external_id": "SUPPLIER-1001",
      "billing_basis": "agent",
      "fare_collected_by": "agency",
      "status": "draft",
      "reference": "Reference",
      "supplier_confirmation_no": "Supplier confirmation no",
      "notes": "Imported from the source system.",
      "option_date": "2026-03-20T18:00",
      "transaction_date": "2026-03-14",
      "invoice_date": "2026-03-18",
      "legs": [
        {
          "origin_name": "Ankara",
          "origin_code": "ANK",
          "destination_name": "Konya",
          "destination_code": "KNY",
          "departs_at": "2026-03-14T09:30:00+03:00",
          "arrives_at": "2026-03-14T12:45:00+03:00",
          "service_number": "YHT-81002",
          "operator_name": "Express Lines",
          "travel_class": "economy",
          "fare_name": "Standard"
        }
      ],
      "travelers": [
        {
          "first_name": "Ada",
          "last_name": "Lovelace",
          "nationality": "TR",
          "national_id": "10000000146",
          "passport_number": "U01234567",
          "passport_country": "TR",
          "passport_expiry": "2031-06-30",
          "date_of_birth": "1988-04-21",
          "gender": "MRS",
          "frequent_flyer_number": "TK123456789",
          "passenger_type": "adult",
          "phone": "+905551112233",
          "fare": "850.00",
          "fare_type": "full",
          "discount_document_no": "Discount document no",
          "seats": [
            {
              "leg": 0,
              "seat_number": "12",
              "coach_number": "3",
              "ticket_number": "RAIL-2026-000101",
              "fare_amount": "850.00"
            }
          ]
        }
      ],
      "cost_lines": [
        {
          "kind": "ticket_fare",
          "amount": "1250.00",
          "label": "Imported line",
          "currency": "EUR",
          "vat_rate": "20",
          "tax_inclusive": true,
          "quantity": 1
        }
      ],
      "sell_lines": [
        {
          "kind": "package_price",
          "amount": "1250.00",
          "label": "Imported line",
          "currency": "EUR",
          "vat_rate": "20",
          "tax_inclusive": true,
          "quantity": 1
        }
      ],
      "bill_to_legal_name": "Lovelace Seyahat A.Ş.",
      "bill_to_tax_number": "1234567890",
      "bill_to_tax_office": "Beşiktaş",
      "bill_to_address_line": "Nispetiye Cad. No:12",
      "bill_to_city": "İstanbul",
      "bill_to_country": "TR"
    }
  ]
}'

const response = await fetch(
  "https://YOUR-CELL.lydira.com/api/v1/imports/rail_bookings/validate",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer sek_YOUR_API_KEY",
      "Content-Type": "application/json",
      "Idempotency-Key": "8f14e45f-ea2c-4f33-9a3b-6d0c1b7e5a90",
    },
    body: JSON.stringify({
      "source_system": "crm",
      "rows": [
        {
          "external_id": "RAIL-BOOKING-1001-B",
          "currency": "EUR",
          "supplier_external_id": "SUPPLIER-1001",
          "billing_basis": "agent",
          "fare_collected_by": "agency",
          "status": "draft",
          "reference": "Reference",
          "supplier_confirmation_no": "Supplier confirmation no",
          "notes": "Imported from the source system.",
          "option_date": "2026-03-20T18:00",
          "transaction_date": "2026-03-14",
          "invoice_date": "2026-03-18",
          "legs": [
            {
              "origin_name": "Ankara",
              "origin_code": "ANK",
              "destination_name": "Konya",
              "destination_code": "KNY",
              "departs_at": "2026-03-14T09:30:00+03:00",
              "arrives_at": "2026-03-14T12:45:00+03:00",
              "service_number": "YHT-81002",
              "operator_name": "Express Lines",
              "travel_class": "economy",
              "fare_name": "Standard"
            }
          ],
          "travelers": [
            {
              "first_name": "Ada",
              "last_name": "Lovelace",
              "nationality": "TR",
              "national_id": "10000000146",
              "passport_number": "U01234567",
              "passport_country": "TR",
              "passport_expiry": "2031-06-30",
              "date_of_birth": "1988-04-21",
              "gender": "MRS",
              "frequent_flyer_number": "TK123456789",
              "passenger_type": "adult",
              "phone": "+905551112233",
              "fare": "850.00",
              "fare_type": "full",
              "discount_document_no": "Discount document no",
              "seats": [
                {
                  "leg": 0,
                  "seat_number": "12",
                  "coach_number": "3",
                  "ticket_number": "RAIL-2026-000101",
                  "fare_amount": "850.00"
                }
              ]
            }
          ],
          "cost_lines": [
            {
              "kind": "ticket_fare",
              "amount": "1250.00",
              "label": "Imported line",
              "currency": "EUR",
              "vat_rate": "20",
              "tax_inclusive": true,
              "quantity": 1
            }
          ],
          "sell_lines": [
            {
              "kind": "package_price",
              "amount": "1250.00",
              "label": "Imported line",
              "currency": "EUR",
              "vat_rate": "20",
              "tax_inclusive": true,
              "quantity": 1
            }
          ],
          "bill_to_legal_name": "Lovelace Seyahat A.Ş.",
          "bill_to_tax_number": "1234567890",
          "bill_to_tax_office": "Beşiktaş",
          "bill_to_address_line": "Nispetiye Cad. No:12",
          "bill_to_city": "İstanbul",
          "bill_to_country": "TR"
        }
      ]
    }),
  },
);

if (!response.ok) throw new Error(`${response.status} ${await response.text()}`);
const data = await response.json();

import requests

response = requests.post(
    "https://YOUR-CELL.lydira.com/api/v1/imports/rail_bookings/validate",
    headers={
        "Authorization": "Bearer sek_YOUR_API_KEY",
        "Content-Type": "application/json",
        "Idempotency-Key": "8f14e45f-ea2c-4f33-9a3b-6d0c1b7e5a90",
    },
    json={
      "source_system": "crm",
      "rows": [
        {
          "external_id": "RAIL-BOOKING-1001-B",
          "currency": "EUR",
          "supplier_external_id": "SUPPLIER-1001",
          "billing_basis": "agent",
          "fare_collected_by": "agency",
          "status": "draft",
          "reference": "Reference",
          "supplier_confirmation_no": "Supplier confirmation no",
          "notes": "Imported from the source system.",
          "option_date": "2026-03-20T18:00",
          "transaction_date": "2026-03-14",
          "invoice_date": "2026-03-18",
          "legs": [
            {
              "origin_name": "Ankara",
              "origin_code": "ANK",
              "destination_name": "Konya",
              "destination_code": "KNY",
              "departs_at": "2026-03-14T09:30:00+03:00",
              "arrives_at": "2026-03-14T12:45:00+03:00",
              "service_number": "YHT-81002",
              "operator_name": "Express Lines",
              "travel_class": "economy",
              "fare_name": "Standard"
            }
          ],
          "travelers": [
            {
              "first_name": "Ada",
              "last_name": "Lovelace",
              "nationality": "TR",
              "national_id": "10000000146",
              "passport_number": "U01234567",
              "passport_country": "TR",
              "passport_expiry": "2031-06-30",
              "date_of_birth": "1988-04-21",
              "gender": "MRS",
              "frequent_flyer_number": "TK123456789",
              "passenger_type": "adult",
              "phone": "+905551112233",
              "fare": "850.00",
              "fare_type": "full",
              "discount_document_no": "Discount document no",
              "seats": [
                {
                  "leg": 0,
                  "seat_number": "12",
                  "coach_number": "3",
                  "ticket_number": "RAIL-2026-000101",
                  "fare_amount": "850.00"
                }
              ]
            }
          ],
          "cost_lines": [
            {
              "kind": "ticket_fare",
              "amount": "1250.00",
              "label": "Imported line",
              "currency": "EUR",
              "vat_rate": "20",
              "tax_inclusive": True,
              "quantity": 1
            }
          ],
          "sell_lines": [
            {
              "kind": "package_price",
              "amount": "1250.00",
              "label": "Imported line",
              "currency": "EUR",
              "vat_rate": "20",
              "tax_inclusive": True,
              "quantity": 1
            }
          ],
          "bill_to_legal_name": "Lovelace Seyahat A.Ş.",
          "bill_to_tax_number": "1234567890",
          "bill_to_tax_office": "Beşiktaş",
          "bill_to_address_line": "Nispetiye Cad. No:12",
          "bill_to_city": "İstanbul",
          "bill_to_country": "TR"
        }
      ]
    },
)
response.raise_for_status()
data = response.json()

require "net/http"
require "json"

uri = URI("https://YOUR-CELL.lydira.com/api/v1/imports/rail_bookings/validate")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer sek_YOUR_API_KEY"
request["Content-Type"] = "application/json"
request["Idempotency-Key"] = "8f14e45f-ea2c-4f33-9a3b-6d0c1b7e5a90"
request.body = JSON.generate({
  source_system: "crm",
  rows: [
    {
      external_id: "RAIL-BOOKING-1001-B",
      currency: "EUR",
      supplier_external_id: "SUPPLIER-1001",
      billing_basis: "agent",
      fare_collected_by: "agency",
      status: "draft",
      reference: "Reference",
      supplier_confirmation_no: "Supplier confirmation no",
      notes: "Imported from the source system.",
      option_date: "2026-03-20T18:00",
      transaction_date: "2026-03-14",
      invoice_date: "2026-03-18",
      legs: [
        {
          origin_name: "Ankara",
          origin_code: "ANK",
          destination_name: "Konya",
          destination_code: "KNY",
          departs_at: "2026-03-14T09:30:00+03:00",
          arrives_at: "2026-03-14T12:45:00+03:00",
          service_number: "YHT-81002",
          operator_name: "Express Lines",
          travel_class: "economy",
          fare_name: "Standard"
        }
      ],
      travelers: [
        {
          first_name: "Ada",
          last_name: "Lovelace",
          nationality: "TR",
          national_id: "10000000146",
          passport_number: "U01234567",
          passport_country: "TR",
          passport_expiry: "2031-06-30",
          date_of_birth: "1988-04-21",
          gender: "MRS",
          frequent_flyer_number: "TK123456789",
          passenger_type: "adult",
          phone: "+905551112233",
          fare: "850.00",
          fare_type: "full",
          discount_document_no: "Discount document no",
          seats: [
            {
              leg: 0,
              seat_number: "12",
              coach_number: "3",
              ticket_number: "RAIL-2026-000101",
              fare_amount: "850.00"
            }
          ]
        }
      ],
      cost_lines: [
        {
          kind: "ticket_fare",
          amount: "1250.00",
          label: "Imported line",
          currency: "EUR",
          vat_rate: "20",
          tax_inclusive: true,
          quantity: 1
        }
      ],
      sell_lines: [
        {
          kind: "package_price",
          amount: "1250.00",
          label: "Imported line",
          currency: "EUR",
          vat_rate: "20",
          tax_inclusive: true,
          quantity: 1
        }
      ],
      bill_to_legal_name: "Lovelace Seyahat A.Ş.",
      bill_to_tax_number: "1234567890",
      bill_to_tax_office: "Beşiktaş",
      bill_to_address_line: "Nispetiye Cad. No:12",
      bill_to_city: "İstanbul",
      bill_to_country: "TR"
    }
  ]
})

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { it.request(request) }
raise response.body unless response.is_a?(Net::HTTPSuccess)
data = JSON.parse(response.body)

<?php
$ch = curl_init("https://YOUR-CELL.lydira.com/api/v1/imports/rail_bookings/validate");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => "POST",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        "Authorization: Bearer sek_YOUR_API_KEY",
        "Content-Type: application/json",
        "Idempotency-Key: 8f14e45f-ea2c-4f33-9a3b-6d0c1b7e5a90",
    ],
    CURLOPT_POSTFIELDS     => json_encode([
        "source_system" => "crm",
        "rows" => [
            [
                "external_id" => "RAIL-BOOKING-1001-B",
                "currency" => "EUR",
                "supplier_external_id" => "SUPPLIER-1001",
                "billing_basis" => "agent",
                "fare_collected_by" => "agency",
                "status" => "draft",
                "reference" => "Reference",
                "supplier_confirmation_no" => "Supplier confirmation no",
                "notes" => "Imported from the source system.",
                "option_date" => "2026-03-20T18:00",
                "transaction_date" => "2026-03-14",
                "invoice_date" => "2026-03-18",
                "legs" => [
                    [
                        "origin_name" => "Ankara",
                        "origin_code" => "ANK",
                        "destination_name" => "Konya",
                        "destination_code" => "KNY",
                        "departs_at" => "2026-03-14T09:30:00+03:00",
                        "arrives_at" => "2026-03-14T12:45:00+03:00",
                        "service_number" => "YHT-81002",
                        "operator_name" => "Express Lines",
                        "travel_class" => "economy",
                        "fare_name" => "Standard",
                    ],
                ],
                "travelers" => [
                    [
                        "first_name" => "Ada",
                        "last_name" => "Lovelace",
                        "nationality" => "TR",
                        "national_id" => "10000000146",
                        "passport_number" => "U01234567",
                        "passport_country" => "TR",
                        "passport_expiry" => "2031-06-30",
                        "date_of_birth" => "1988-04-21",
                        "gender" => "MRS",
                        "frequent_flyer_number" => "TK123456789",
                        "passenger_type" => "adult",
                        "phone" => "+905551112233",
                        "fare" => "850.00",
                        "fare_type" => "full",
                        "discount_document_no" => "Discount document no",
                        "seats" => [
                            [
                                "leg" => 0,
                                "seat_number" => "12",
                                "coach_number" => "3",
                                "ticket_number" => "RAIL-2026-000101",
                                "fare_amount" => "850.00",
                            ],
                        ],
                    ],
                ],
                "cost_lines" => [
                    [
                        "kind" => "ticket_fare",
                        "amount" => "1250.00",
                        "label" => "Imported line",
                        "currency" => "EUR",
                        "vat_rate" => "20",
                        "tax_inclusive" => true,
                        "quantity" => 1,
                    ],
                ],
                "sell_lines" => [
                    [
                        "kind" => "package_price",
                        "amount" => "1250.00",
                        "label" => "Imported line",
                        "currency" => "EUR",
                        "vat_rate" => "20",
                        "tax_inclusive" => true,
                        "quantity" => 1,
                    ],
                ],
                "bill_to_legal_name" => "Lovelace Seyahat A.Ş.",
                "bill_to_tax_number" => "1234567890",
                "bill_to_tax_office" => "Beşiktaş",
                "bill_to_address_line" => "Nispetiye Cad. No:12",
                "bill_to_city" => "İstanbul",
                "bill_to_country" => "TR",
            ],
        ],
    ]),
]);

$data = json_decode(curl_exec($ch), true);
curl_close($ch);

Hizmet bedeli

Bedeli bölecek satışı henüz olmayan rezervasyon hizmet bedeli yazılmadan kaydolur ve satır şu uyarıyı taşır: service_fee_dropped

Alanlar:service_feeservice_fee_percentservice_fee_vat_rateservice_fee_waived

Alanlar(36)

external_idstring
currencycurrency
omit for the company's own
customer_external_idreference
the cari; omit it for a walk-in sale billed to the first passenger
supplier_external_idreference
the carrier
billing_basisenum
agent ⇒ the fare is the carrier's money and the agency bills its own fee; gross ⇒ the agency resells the fare. Omit for the company's default (agent in Türkiye)
Şunlardan biri:agentgross
fare_collected_byenum
who took the fare from the passenger; a gross sale is always the agency's
Şunlardan biri:agencycarrier
statusenum
default issued; cancelled on an amendment cancels the booking
Şunlardan biri:draftoptionissuedcancelled
referencestring
the carrier's booking reference (PNR)
supplier_confirmation_nostring
notesstring
option_datedate
transaction_datedate
işlem tarihi — the FX anchor for every line
invoice_datedate
custom_fieldsobject
the account's own fields on the booking, by key
legsobject[]
the journey in order; a seat names its leg by position
Her öğe
- origin_namestring
- origin_codestring
- destination_namestring
- destination_codestring
- departs_atdatetime
- arrives_atdatetime
- service_numberstring
  the trip or train number
- operator_namestring
- travel_classstring
  Uygulamanın kullandığı değerler:economybusinesssleepercouchette
- fare_namestring
travelersobject[]PII
passengers; auto-saved to the cari's traveller directory. The first is the walk-in payer
Her öğe
- first_namestringPII
- last_namestringPII
- nationalitystring
- national_idstringPII
- passport_numberstringPII
- passport_countrystring
- passport_expirydate
- date_of_birthdatePII
- genderstring
  Uygulamanın kullandığı değerler:MRMRSMISSMSTR
- frequent_flyer_numberstring
- passenger_typeenum
  Şunlardan biri:adultchildinfant
- phonephonePII
- faremoney
  the carrier's fare for this passenger, written as its ticket_fare sell and cost line
- fare_typetaxonomy
  Hesabınızın rail_fare_type listesi; başlangıç değerleri:fullchildyouthsenior_60senior_65teachermilitarypressdisableddisabled_companion
- discount_document_nostring
  the card or document behind a discounted fare
- custom_fieldsobject
  the account's own fields on the passenger, by key
- seatsobject[]
  one per leg the passenger rides
  Her öğe
  - leginteger
    the leg's position in legs, from 0
  - seat_numberstring
  - coach_numberstring
    required on a train
  - ticket_numberstring
    the e-ticket number
  - fare_amountmoney
    this leg's share of the fare
cost_linesobject[]
cost-side pricing lines for the "rail" pricing context
Her öğe
- kindstringzorunlu
  Uygulamanın kullandığı değerler:ticket_farereservation_feeseat_upgradecarrier_commissionapplied_fareservice_feesupplier_refundinsurance_premium
- amountmoneyzorunlu
- labelstring
- currencycurrency
- vat_ratedecimal
  percent (20 ⇒ 20% KDV); omit to take the kind's default
- tax_inclusiveboolean
  true ⇒ the amount includes VAT. A hotel stay or a charter takes one VAT mode: the lines' flags decide it, lines stating both are refused, and every line follows the booking's mode afterwards
- quantityinteger
sell_linesobject[]
sell-side pricing lines for the "rail" pricing context
Her öğe
- kindstringzorunlu
  Uygulamanın kullandığı değerler:package_pricemarkupservice_feesupplier_commissioncancellation_feeinsurance_premiumdiscountrefund_allowanceticket_farereservation_feeseat_upgradecarrier_commissionapplied_faresupplier_refund
- amountmoneyzorunlu
- labelstring
- currencycurrency
- vat_ratedecimal
  percent (20 ⇒ 20% KDV); omit to take the kind's default
- tax_inclusiveboolean
  true ⇒ the amount includes VAT. A hotel stay or a charter takes one VAT mode: the lines' flags decide it, lines stating both are refused, and every line follows the booking's mode afterwards
- quantityinteger
service_feemoney
the agency's fee for the whole booking, in its currency; split across the guests like the booking form's. Sent, the account's service-fee rules write nothing
service_fee_percentdecimal
the fee as a percentage (0-100) of the booking's sale before fee and discount, instead of service_fee; split like it
service_fee_vat_ratedecimal
the fee's VAT, percent (0 ⇒ exempt); omit it and the law decides, else the seller's standard rate
service_fee_waivedboolean
true: the account's service-fee rules write no fee on this booking
bill_to_typeenum
omit to infer: a legal name or a 10-digit tax number ⇒ corporate
Şunlardan biri:corporateindividual
bill_to_legal_namestring
bill_to_tax_numbertax_numberPII
VKN for a corporate payer, TCKN for an individual; matched digits-only
bill_to_tax_officestring
bill_to_passport_numberstringPII
individual only; used when there is no TCKN
bill_to_first_namestringPII
bill_to_last_namestringPII
bill_to_emailemailPII
stored on a NEW cari; never used to match
bill_to_phonephonePII
stored on a NEW cari; never used to match
bill_to_address_linestringPII
bill_to_districtstringPII
bill_to_citystringPII
bill_to_zipstringPII
bill_to_countrystring
ISO-2 code, e.g. TR

Referanslar

customer_external_id → customers · eşleşme external_id, email · bulunamazsa skip
supplier_external_id → suppliers · eşleşme external_id, code · bulunamazsa skip

Hesabınızın ek alanları (custom_fields)

İstek · hesabın alanları

curl -X GET 'https://YOUR-CELL.lydira.com/api/v1/imports/entities/rail_bookings' \
  -H 'Authorization: Bearer sek_YOUR_API_KEY'

const response = await fetch(
  "https://YOUR-CELL.lydira.com/api/v1/imports/entities/rail_bookings",
  {
    method: "GET",
    headers: {
      "Authorization": "Bearer sek_YOUR_API_KEY",
    },
  },
);

if (!response.ok) throw new Error(`${response.status} ${await response.text()}`);
const data = await response.json();

import requests

response = requests.get(
    "https://YOUR-CELL.lydira.com/api/v1/imports/entities/rail_bookings",
    headers={
        "Authorization": "Bearer sek_YOUR_API_KEY",
    },
)
response.raise_for_status()
data = response.json()

require "net/http"
require "json"

uri = URI("https://YOUR-CELL.lydira.com/api/v1/imports/entities/rail_bookings")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer sek_YOUR_API_KEY"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { it.request(request) }
raise response.body unless response.is_a?(Net::HTTPSuccess)
data = JSON.parse(response.body)

<?php
$ch = curl_init("https://YOUR-CELL.lydira.com/api/v1/imports/entities/rail_bookings");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => "GET",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        "Authorization: Bearer sek_YOUR_API_KEY",
    ],
]);

$data = json_decode(curl_exec($ch), true);
curl_close($ch);

Yanıt · custom_fields (kesit)

200

{
  "key": "rail_bookings",
  "custom_fields": {
    "record": [
      {
        "key": "project_code",
        "label": "Project code",
        "type": "text",
        "required": "always",
        "applies_to": "all"
      },
      {
        "key": "trip_reason",
        "label": "Trip reason",
        "type": "select",
        "required": "listed_customers",
        "applies_to": "listed_customers",
        "options": [
          {
            "value": "meeting",
            "label": "Meeting"
          },
          {
            "value": "fair",
            "label": "Trade fair"
          }
        ],
        "customers": [
          {
            "id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
            "external_id": "CUST-17",
            "required": true
          }
        ]
      }
    ],
    "traveler": [
      {
        "key": "employee_no",
        "label": "Employee no",
        "type": "text",
        "required": "never",
        "applies_to": "all",
        "pii": true
      }
    ]
  }
}

Her tip ne alır

tip	satırdaki değer
`text`	`"PRJ-2026-001"`
`long_text`	`"Fair delegation, second group"`
`number`	`12.5`
`date`	`"2026-03-14"`
`boolean`	`true`
`select`	`"meeting"`
`multi_select`	`["meeting", "fair"]`

number takes a number or a numeric string; date an ISO date; select one option value (or its label); multi_select a list of them.

required ve applies_to

requiredneveralwayslisted_customers
listed_customers: required only for the customers marked required in customers.
applies_toalllisted_customers
listed_customers: the field is accepted only on those customers' records.

Yolcu alanları her yolcunun kendi custom_fields nesnesine yazılır.

Geri okuma

GET /api/v1/imports/rail_bookings/records/RAIL-BOOKING-1001

200

{
  "entity": "rail_bookings",
  "external_id": "RAIL-BOOKING-1001",
  "source_system": "crm",
  "type": "RailBooking",
  "id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
  "created_at": "2026-03-14T09:30:00Z",
  "updated_at": "2026-03-15T11:05:00Z",
  "status": "issued",
  "locked": true,
  "lock_reason": "invoiced",
  "currency": "EUR",
  "totals": {
    "cost": "1100.0",
    "sell": "1250.0"
  },
  "invoices": [
    {
      "id": "4b8e1f60-7c2d-4e9a-b3f5-0a6d2c9e8b71",
      "number": "LYD2026000000117",
      "status": "issued",
      "currency": "EUR",
      "total": "1250.0",
      "balance": "1250.0"
    }
  ],
  "detail": {
    "voucher_number": "VCH-2026-000412",
    "supplier_confirmation_no": "CNF-77821",
    "supplier": "Lovelace Travel Partners",
    "custom_fields": {
      "project_code": "PRJ-2026-001",
      "trip_reason": "meeting"
    },
    "route": "Ankara → Konya",
    "departs_at": "2026-03-14T06:30:00Z",
    "billing_basis": "agent",
    "option_date": "2026-03-10"
  }
}

İstek · deneme, tüm alanlar

curl -X POST 'https://YOUR-CELL.lydira.com/api/v1/imports/rail_bookings/validate' \
  -H 'Authorization: Bearer sek_YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: 8f14e45f-ea2c-4f33-9a3b-6d0c1b7e5a90' \
  -d '{
  "source_system": "crm",
  "rows": [
    {
      "external_id": "RAIL-BOOKING-1001",
      "currency": "EUR",
      "customer_external_id": "CUSTOMER-1001",
      "supplier_external_id": "SUPPLIER-1001",
      "billing_basis": "agent",
      "fare_collected_by": "agency",
      "status": "draft",
      "reference": "Reference",
      "supplier_confirmation_no": "Supplier confirmation no",
      "notes": "Imported from the source system.",
      "option_date": "2026-03-20T18:00",
      "transaction_date": "2026-03-14",
      "invoice_date": "2026-03-18",
      "custom_fields": {
        "project_code": "PRJ-2026-001",
        "trip_reason": "meeting"
      },
      "legs": [
        {
          "origin_name": "Ankara",
          "origin_code": "ANK",
          "destination_name": "Konya",
          "destination_code": "KNY",
          "departs_at": "2026-03-14T09:30:00+03:00",
          "arrives_at": "2026-03-14T12:45:00+03:00",
          "service_number": "YHT-81002",
          "operator_name": "Express Lines",
          "travel_class": "economy",
          "fare_name": "Standard"
        }
      ],
      "travelers": [
        {
          "first_name": "Ada",
          "last_name": "Lovelace",
          "nationality": "TR",
          "national_id": "10000000146",
          "passport_number": "U01234567",
          "passport_country": "TR",
          "passport_expiry": "2031-06-30",
          "date_of_birth": "1988-04-21",
          "gender": "MRS",
          "frequent_flyer_number": "TK123456789",
          "passenger_type": "adult",
          "phone": "+905551112233",
          "fare": "850.00",
          "fare_type": "full",
          "discount_document_no": "Discount document no",
          "custom_fields": {
            "employee_no": "E-10442"
          },
          "seats": [
            {
              "leg": 0,
              "seat_number": "12",
              "coach_number": "3",
              "ticket_number": "RAIL-2026-000101",
              "fare_amount": "850.00"
            }
          ]
        }
      ],
      "cost_lines": [
        {
          "kind": "ticket_fare",
          "amount": "1250.00",
          "label": "Imported line",
          "currency": "EUR",
          "vat_rate": "20",
          "tax_inclusive": true,
          "quantity": 1
        }
      ],
      "sell_lines": [
        {
          "kind": "package_price",
          "amount": "1250.00",
          "label": "Imported line",
          "currency": "EUR",
          "vat_rate": "20",
          "tax_inclusive": true,
          "quantity": 1
        }
      ],
      "service_fee": "1250.00",
      "service_fee_vat_rate": "20",
      "service_fee_waived": true
    }
  ]
}'

const response = await fetch(
  "https://YOUR-CELL.lydira.com/api/v1/imports/rail_bookings/validate",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer sek_YOUR_API_KEY",
      "Content-Type": "application/json",
      "Idempotency-Key": "8f14e45f-ea2c-4f33-9a3b-6d0c1b7e5a90",
    },
    body: JSON.stringify({
      "source_system": "crm",
      "rows": [
        {
          "external_id": "RAIL-BOOKING-1001",
          "currency": "EUR",
          "customer_external_id": "CUSTOMER-1001",
          "supplier_external_id": "SUPPLIER-1001",
          "billing_basis": "agent",
          "fare_collected_by": "agency",
          "status": "draft",
          "reference": "Reference",
          "supplier_confirmation_no": "Supplier confirmation no",
          "notes": "Imported from the source system.",
          "option_date": "2026-03-20T18:00",
          "transaction_date": "2026-03-14",
          "invoice_date": "2026-03-18",
          "custom_fields": {
            "project_code": "PRJ-2026-001",
            "trip_reason": "meeting"
          },
          "legs": [
            {
              "origin_name": "Ankara",
              "origin_code": "ANK",
              "destination_name": "Konya",
              "destination_code": "KNY",
              "departs_at": "2026-03-14T09:30:00+03:00",
              "arrives_at": "2026-03-14T12:45:00+03:00",
              "service_number": "YHT-81002",
              "operator_name": "Express Lines",
              "travel_class": "economy",
              "fare_name": "Standard"
            }
          ],
          "travelers": [
            {
              "first_name": "Ada",
              "last_name": "Lovelace",
              "nationality": "TR",
              "national_id": "10000000146",
              "passport_number": "U01234567",
              "passport_country": "TR",
              "passport_expiry": "2031-06-30",
              "date_of_birth": "1988-04-21",
              "gender": "MRS",
              "frequent_flyer_number": "TK123456789",
              "passenger_type": "adult",
              "phone": "+905551112233",
              "fare": "850.00",
              "fare_type": "full",
              "discount_document_no": "Discount document no",
              "custom_fields": {
                "employee_no": "E-10442"
              },
              "seats": [
                {
                  "leg": 0,
                  "seat_number": "12",
                  "coach_number": "3",
                  "ticket_number": "RAIL-2026-000101",
                  "fare_amount": "850.00"
                }
              ]
            }
          ],
          "cost_lines": [
            {
              "kind": "ticket_fare",
              "amount": "1250.00",
              "label": "Imported line",
              "currency": "EUR",
              "vat_rate": "20",
              "tax_inclusive": true,
              "quantity": 1
            }
          ],
          "sell_lines": [
            {
              "kind": "package_price",
              "amount": "1250.00",
              "label": "Imported line",
              "currency": "EUR",
              "vat_rate": "20",
              "tax_inclusive": true,
              "quantity": 1
            }
          ],
          "service_fee": "1250.00",
          "service_fee_vat_rate": "20",
          "service_fee_waived": true
        }
      ]
    }),
  },
);

if (!response.ok) throw new Error(`${response.status} ${await response.text()}`);
const data = await response.json();

import requests

response = requests.post(
    "https://YOUR-CELL.lydira.com/api/v1/imports/rail_bookings/validate",
    headers={
        "Authorization": "Bearer sek_YOUR_API_KEY",
        "Content-Type": "application/json",
        "Idempotency-Key": "8f14e45f-ea2c-4f33-9a3b-6d0c1b7e5a90",
    },
    json={
      "source_system": "crm",
      "rows": [
        {
          "external_id": "RAIL-BOOKING-1001",
          "currency": "EUR",
          "customer_external_id": "CUSTOMER-1001",
          "supplier_external_id": "SUPPLIER-1001",
          "billing_basis": "agent",
          "fare_collected_by": "agency",
          "status": "draft",
          "reference": "Reference",
          "supplier_confirmation_no": "Supplier confirmation no",
          "notes": "Imported from the source system.",
          "option_date": "2026-03-20T18:00",
          "transaction_date": "2026-03-14",
          "invoice_date": "2026-03-18",
          "custom_fields": {
            "project_code": "PRJ-2026-001",
            "trip_reason": "meeting"
          },
          "legs": [
            {
              "origin_name": "Ankara",
              "origin_code": "ANK",
              "destination_name": "Konya",
              "destination_code": "KNY",
              "departs_at": "2026-03-14T09:30:00+03:00",
              "arrives_at": "2026-03-14T12:45:00+03:00",
              "service_number": "YHT-81002",
              "operator_name": "Express Lines",
              "travel_class": "economy",
              "fare_name": "Standard"
            }
          ],
          "travelers": [
            {
              "first_name": "Ada",
              "last_name": "Lovelace",
              "nationality": "TR",
              "national_id": "10000000146",
              "passport_number": "U01234567",
              "passport_country": "TR",
              "passport_expiry": "2031-06-30",
              "date_of_birth": "1988-04-21",
              "gender": "MRS",
              "frequent_flyer_number": "TK123456789",
              "passenger_type": "adult",
              "phone": "+905551112233",
              "fare": "850.00",
              "fare_type": "full",
              "discount_document_no": "Discount document no",
              "custom_fields": {
                "employee_no": "E-10442"
              },
              "seats": [
                {
                  "leg": 0,
                  "seat_number": "12",
                  "coach_number": "3",
                  "ticket_number": "RAIL-2026-000101",
                  "fare_amount": "850.00"
                }
              ]
            }
          ],
          "cost_lines": [
            {
              "kind": "ticket_fare",
              "amount": "1250.00",
              "label": "Imported line",
              "currency": "EUR",
              "vat_rate": "20",
              "tax_inclusive": True,
              "quantity": 1
            }
          ],
          "sell_lines": [
            {
              "kind": "package_price",
              "amount": "1250.00",
              "label": "Imported line",
              "currency": "EUR",
              "vat_rate": "20",
              "tax_inclusive": True,
              "quantity": 1
            }
          ],
          "service_fee": "1250.00",
          "service_fee_vat_rate": "20",
          "service_fee_waived": True
        }
      ]
    },
)
response.raise_for_status()
data = response.json()

require "net/http"
require "json"

uri = URI("https://YOUR-CELL.lydira.com/api/v1/imports/rail_bookings/validate")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer sek_YOUR_API_KEY"
request["Content-Type"] = "application/json"
request["Idempotency-Key"] = "8f14e45f-ea2c-4f33-9a3b-6d0c1b7e5a90"
request.body = JSON.generate({
  source_system: "crm",
  rows: [
    {
      external_id: "RAIL-BOOKING-1001",
      currency: "EUR",
      customer_external_id: "CUSTOMER-1001",
      supplier_external_id: "SUPPLIER-1001",
      billing_basis: "agent",
      fare_collected_by: "agency",
      status: "draft",
      reference: "Reference",
      supplier_confirmation_no: "Supplier confirmation no",
      notes: "Imported from the source system.",
      option_date: "2026-03-20T18:00",
      transaction_date: "2026-03-14",
      invoice_date: "2026-03-18",
      custom_fields: {
        project_code: "PRJ-2026-001",
        trip_reason: "meeting"
      },
      legs: [
        {
          origin_name: "Ankara",
          origin_code: "ANK",
          destination_name: "Konya",
          destination_code: "KNY",
          departs_at: "2026-03-14T09:30:00+03:00",
          arrives_at: "2026-03-14T12:45:00+03:00",
          service_number: "YHT-81002",
          operator_name: "Express Lines",
          travel_class: "economy",
          fare_name: "Standard"
        }
      ],
      travelers: [
        {
          first_name: "Ada",
          last_name: "Lovelace",
          nationality: "TR",
          national_id: "10000000146",
          passport_number: "U01234567",
          passport_country: "TR",
          passport_expiry: "2031-06-30",
          date_of_birth: "1988-04-21",
          gender: "MRS",
          frequent_flyer_number: "TK123456789",
          passenger_type: "adult",
          phone: "+905551112233",
          fare: "850.00",
          fare_type: "full",
          discount_document_no: "Discount document no",
          custom_fields: {
            employee_no: "E-10442"
          },
          seats: [
            {
              leg: 0,
              seat_number: "12",
              coach_number: "3",
              ticket_number: "RAIL-2026-000101",
              fare_amount: "850.00"
            }
          ]
        }
      ],
      cost_lines: [
        {
          kind: "ticket_fare",
          amount: "1250.00",
          label: "Imported line",
          currency: "EUR",
          vat_rate: "20",
          tax_inclusive: true,
          quantity: 1
        }
      ],
      sell_lines: [
        {
          kind: "package_price",
          amount: "1250.00",
          label: "Imported line",
          currency: "EUR",
          vat_rate: "20",
          tax_inclusive: true,
          quantity: 1
        }
      ],
      service_fee: "1250.00",
      service_fee_vat_rate: "20",
      service_fee_waived: true
    }
  ]
})

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { it.request(request) }
raise response.body unless response.is_a?(Net::HTTPSuccess)
data = JSON.parse(response.body)

<?php
$ch = curl_init("https://YOUR-CELL.lydira.com/api/v1/imports/rail_bookings/validate");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => "POST",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        "Authorization: Bearer sek_YOUR_API_KEY",
        "Content-Type: application/json",
        "Idempotency-Key: 8f14e45f-ea2c-4f33-9a3b-6d0c1b7e5a90",
    ],
    CURLOPT_POSTFIELDS     => json_encode([
        "source_system" => "crm",
        "rows" => [
            [
                "external_id" => "RAIL-BOOKING-1001",
                "currency" => "EUR",
                "customer_external_id" => "CUSTOMER-1001",
                "supplier_external_id" => "SUPPLIER-1001",
                "billing_basis" => "agent",
                "fare_collected_by" => "agency",
                "status" => "draft",
                "reference" => "Reference",
                "supplier_confirmation_no" => "Supplier confirmation no",
                "notes" => "Imported from the source system.",
                "option_date" => "2026-03-20T18:00",
                "transaction_date" => "2026-03-14",
                "invoice_date" => "2026-03-18",
                "custom_fields" => [
                    "project_code" => "PRJ-2026-001",
                    "trip_reason" => "meeting",
                ],
                "legs" => [
                    [
                        "origin_name" => "Ankara",
                        "origin_code" => "ANK",
                        "destination_name" => "Konya",
                        "destination_code" => "KNY",
                        "departs_at" => "2026-03-14T09:30:00+03:00",
                        "arrives_at" => "2026-03-14T12:45:00+03:00",
                        "service_number" => "YHT-81002",
                        "operator_name" => "Express Lines",
                        "travel_class" => "economy",
                        "fare_name" => "Standard",
                    ],
                ],
                "travelers" => [
                    [
                        "first_name" => "Ada",
                        "last_name" => "Lovelace",
                        "nationality" => "TR",
                        "national_id" => "10000000146",
                        "passport_number" => "U01234567",
                        "passport_country" => "TR",
                        "passport_expiry" => "2031-06-30",
                        "date_of_birth" => "1988-04-21",
                        "gender" => "MRS",
                        "frequent_flyer_number" => "TK123456789",
                        "passenger_type" => "adult",
                        "phone" => "+905551112233",
                        "fare" => "850.00",
                        "fare_type" => "full",
                        "discount_document_no" => "Discount document no",
                        "custom_fields" => [
                            "employee_no" => "E-10442",
                        ],
                        "seats" => [
                            [
                                "leg" => 0,
                                "seat_number" => "12",
                                "coach_number" => "3",
                                "ticket_number" => "RAIL-2026-000101",
                                "fare_amount" => "850.00",
                            ],
                        ],
                    ],
                ],
                "cost_lines" => [
                    [
                        "kind" => "ticket_fare",
                        "amount" => "1250.00",
                        "label" => "Imported line",
                        "currency" => "EUR",
                        "vat_rate" => "20",
                        "tax_inclusive" => true,
                        "quantity" => 1,
                    ],
                ],
                "sell_lines" => [
                    [
                        "kind" => "package_price",
                        "amount" => "1250.00",
                        "label" => "Imported line",
                        "currency" => "EUR",
                        "vat_rate" => "20",
                        "tax_inclusive" => true,
                        "quantity" => 1,
                    ],
                ],
                "service_fee" => "1250.00",
                "service_fee_vat_rate" => "20",
                "service_fee_waived" => true,
            ],
        ],
    ]),
]);

$data = json_decode(curl_exec($ch), true);
curl_close($ch);

Yanıt

200

{
  "import": {
    "id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
    "entity": "rail_bookings",
    "source_system": "crm",
    "status": "ready",
    "company_id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
    "stats": {
      "total": 1,
      "will_create": 1,
      "will_update": 0,
      "created": 0,
      "updated": 0,
      "skipped": 0,
      "invalid": 0,
      "failed": 0,
      "not_selected": 0
    },
    "error": null,
    "created_at": "2026-03-14T09:30:00Z",
    "links": {
      "self": "/api/v1/imports/9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
      "rows": "/api/v1/imports/9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18/rows"
    },
    "mode": "validate",
    "async": false,
    "on_conflict": "skip",
    "pricing": "apply_rules"
  },
  "ignored_fields": [],
  "results": [
    {
      "row": 1,
      "external_id": "RAIL-BOOKING-1001",
      "status": "will_create",
      "payer": {
        "outcome": "external_id",
        "customer_id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18"
      }
    }
  ]
}

Akış

Deneyin. POST …/validate aynı yolu koşar ve hiçbir şey yazmaz.
Gönderin. Aynı gövde, /validate olmadan. Bozuk satır tek başına düşer ve alanını söyler.
Geri okuyun. GET /api/v1/imports/{entity}/records/{external_id} kendi kimliğinizle cevap verir.
Dinleyin. Acente kaydı değiştirdiğinde webhook haber verir.

Kurallar →Webhook'lar →

Bu sayfada

Otobüs biletleribus_bookings

Uç noktalar

Hesabınızın ek alanları (custom_fields)

Geri okuma

Tren biletlerirail_bookings

Uç noktalar

Hesabınızın ek alanları (custom_fields)

Geri okuma

Akış

Otobüs biletleri`bus_bookings`

Tren biletleri`rail_bookings`