Kılavuzlar

Aktarım tipleri

Lydira'ya neleri gönderebilirsiniz, her tip neyi taşır ve olduğu gibi gönderebileceğiniz bir gövde.

Bu sayfa GET /api/v1/imports/entities çıktısının görünümüdür. Asıl kaynak o uçtur ve ürünle birlikte değişir. Alan listesini koda gömmek yerine çalışma anında okuyun, gerçek yazmadan önce de /validate ikizini kullanın.

Her satırda external_id zorunludur. Kendi sisteminizdeki kendi kimliğinizdir ve tekrar denemeyi güvenli kılan şey odur.
Deneme aynı kodu koşar. POST …/validate hiçbir şey yazmadan aynı yolu izler; orada yeşilse gerçekte de yeşildir.
Bozuk satır tek başına düşer. Partinin geri kalanı içeri girer, düşen satır ise alan bazında gerekçesiyle geri döner.

Yazılabilir

customersMüşteriler

İdempotency: upsert: tekrar gönderim mevcut satırı günceller

Uç noktalar

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

Alanlar(16)

external_idstring
source primary key → ExternalReference
namestringzorunluPII
customer_typeenum
individualcorporate
emailemailPII
phonephonePII
legal_namestring
tax_numbertax_number
tax_officestring
address_linestringPII
address_districtstringPII
address_citystringPII
address_statestringPII
address_zipstringPII
preferred_currencycurrency
codestring
notesstringPII
free text; imported as a customer note

Örnek gövde

{
  "rows": [
    {
      "external_id": "CUSTOMER-1001",
      "name": "Ada Lovelace",
      "customer_type": "individual",
      "email": "ada@example.com",
      "phone": "+905551112233",
      "legal_name": "Lovelace Seyahat A.Ş.",
      "tax_office": "Beşiktaş",
      "address_line": "Nispetiye Cad. No:12",
      "address_district": "Beşiktaş",
      "address_city": "İstanbul",
      "address_state": "",
      "address_zip": "34340",
      "preferred_currency": "EUR",
      "code": "AC-1001",
      "notes": "Imported from the source system."
    }
  ]
}

suppliersTedarikçiler

İdempotency: upsert: tekrar gönderim mevcut satırı günceller

Uç noktalar

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

Alanlar(16)

external_idstring
namestringzorunlu
supplier_typeenum
integer-backed enum — resolved against TravelSupplier.supplier_types
otherairlinehoteldmccruisetour_operatorinsuranceactivitytransferrailcar_rentalconsolidatorgdsvisacharteragencycateringtechnicalproductiondecorationvenuephoto_videoentertainmentsecuritystaffing
codestring
iata_codestring
emailemail
phonephone
country_codestring
tax_numbertax_number
tax_officestring
address_linestringPII
address_districtstringPII
address_citystringPII
address_statestringPII
address_zipstringPII
websitestring

Örnek gövde

{
  "rows": [
    {
      "external_id": "SUPPLIER-1001",
      "name": "Ada Lovelace",
      "supplier_type": "hotel",
      "code": "AC-1001",
      "iata_code": "TK",
      "email": "ada@example.com",
      "phone": "+905551112233",
      "country_code": "TR",
      "tax_office": "Beşiktaş",
      "address_line": "Nispetiye Cad. No:12",
      "address_district": "Beşiktaş",
      "address_city": "İstanbul",
      "address_state": "",
      "address_zip": "34340",
      "website": "https://example.com"
    }
  ]
}

leadsMüşteri adayları

İdempotency: upsert: tekrar gönderim mevcut satırı günceller

Uç noktalar

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

Alanlar(12)

external_idstring
namestringzorunluPII
emailemailPII
phonephonePII
stageenum
inboxqualifiednurturingproposalwonlost
sourcetaxonomy
taxonomy: lead_source
estimated_valuemoney
currencycurrency
party_sizeinteger
destinationsstring
customer_external_idreference
links to an imported customer
notesstringPII

Referanslar

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

Örnek gövde

{
  "rows": [
    {
      "external_id": "LEAD-1001",
      "name": "Ada Lovelace",
      "email": "ada@example.com",
      "phone": "+905551112233",
      "stage": "inbox",
      "source": "website_form",
      "estimated_value": "1250.00",
      "currency": "EUR",
      "party_size": 2,
      "destinations": "Roma, Floransa",
      "customer_external_id": "CUSTOMER-1001",
      "notes": "Imported from the source system."
    }
  ]
}

tour_departuresTur kalkışları

İdempotency: upsert: tekrar gönderim mevcut satırı günceller

Uç noktalar

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

Alanlar(9)

external_idstring
source primary key → ExternalReference
titlestringzorunlu
starts_ondate
ends_ondate
currencycurrency
max_capacityinteger
inventory_stateenum
openclosed_directon_requestmin_not_metsold_outcancelleddepartedcompleted
notesstring
supplier_external_idreference
the operator we bought the seat from

Referanslar

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

Örnek gövde

{
  "rows": [
    {
      "external_id": "TOUR-DEPARTURE-1001",
      "title": "Title",
      "starts_on": "2026-03-14",
      "ends_on": "2026-03-18",
      "currency": "EUR",
      "max_capacity": 2,
      "inventory_state": "open",
      "notes": "Imported from the source system.",
      "supplier_external_id": "SUPPLIER-1001"
    }
  ]
}

car_rentalsAraç kiralamaları

İdempotency: bir kez oluşturulur: tekrar gönderim kopyalamaz, atlar

Uç noktalar

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

Alanlar(20)

external_idstring
vehicle_classstring
pickup_locationstring
dropoff_locationstring
pickup_atdatetime
return_atdatetime
pax_countinteger
currencycurrency
customer_external_idreference
supplier_external_idreference
statusenum
draftoptionconfirmedoutreturnedcancelledno_show
notesstring
rate_basisenum
net ⇒ cost typed / sell derived; commissionable ⇒ the reverse
netcommissionable
margin_modeenum
percent ⇒ the margin was typed as a %; amount ⇒ as a flat figure
percentamount
option_datedate
transaction_datedate
işlem tarihi — the FX anchor for every cost line
invoice_datedate
cost_lineslist
cost-side pricing lines for the "car_rental" pricing context
sell_lineslist
sell-side pricing lines for the "car_rental" pricing context
travelerslistPII
guests; auto-saved to the customer's traveller directory

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

Örnek gövde

{
  "rows": [
    {
      "external_id": "CAR-RENTAL-1001",
      "vehicle_class": "compact",
      "pickup_location": "IST Airport",
      "dropoff_location": "Beyoğlu, İstanbul",
      "pickup_at": "2026-03-14T09:30:00+03:00",
      "return_at": "2026-03-14T12:45:00+03:00",
      "pax_count": 2,
      "currency": "EUR",
      "customer_external_id": "CUSTOMER-1001",
      "supplier_external_id": "SUPPLIER-1001",
      "status": "draft",
      "notes": "Imported from the source system.",
      "rate_basis": "net",
      "margin_mode": "percent",
      "option_date": "2026-03-14",
      "transaction_date": "2026-03-14",
      "invoice_date": "2026-03-18",
      "cost_lines": [
        {
          "kind": "daily_rate",
          "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
        }
      ],
      "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": "female",
          "frequent_flyer_number": "TK123456789"
        }
      ]
    }
  ]
}

cruisesCruise rezervasyonları

İdempotency: bir kez oluşturulur: tekrar gönderim kopyalamaz, atlar

Uç noktalar

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

Alanlar(20)

external_idstring
ship_namestring
embark_ondate
disembark_ondate
cabin_countinteger
guest_countinteger
currencycurrency
customer_external_idreference
supplier_external_idreference
statusenum
draftoptionconfirmedsailingcompletedcancelled
notesstring
rate_basisenum
net ⇒ cost typed / sell derived; commissionable ⇒ the reverse
netcommissionable
margin_modeenum
percent ⇒ the margin was typed as a %; amount ⇒ as a flat figure
percentamount
option_datedate
transaction_datedate
işlem tarihi — the FX anchor for every cost line
invoice_datedate
cost_lineslist
cost-side pricing lines for the "cruise" pricing context
sell_lineslist
sell-side pricing lines for the "cruise" pricing context
travelerslistPII
guests; auto-saved to the customer's traveller directory
cabin_categorystring

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

Örnek gövde

{
  "rows": [
    {
      "external_id": "CRUISE-1001",
      "ship_name": "MSC Fantasia",
      "embark_on": "2026-03-14",
      "disembark_on": "2026-03-18",
      "cabin_count": 2,
      "guest_count": 2,
      "currency": "EUR",
      "customer_external_id": "CUSTOMER-1001",
      "supplier_external_id": "SUPPLIER-1001",
      "status": "draft",
      "notes": "Imported from the source system.",
      "rate_basis": "net",
      "margin_mode": "percent",
      "option_date": "2026-03-14",
      "transaction_date": "2026-03-14",
      "invoice_date": "2026-03-18",
      "cost_lines": [
        {
          "kind": "cabin_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
        }
      ],
      "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": "female",
          "frequent_flyer_number": "TK123456789"
        }
      ],
      "cabin_category": "balcony"
    }
  ]
}

hotel_staysOtel konaklamaları

İdempotency: bir kez oluşturulur: tekrar gönderim kopyalamaz, atlar

Uç noktalar

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

Alanlar(18)

external_idstring
check_in_ondatezorunlu
check_out_ondatezorunlu
currencycurrency
guest_countinteger
customer_external_idreference
supplier_external_idreference
statusenum
draftoptionconfirmedin_housechecked_outcancelledno_show
notesstring
rate_basisenum
net ⇒ cost typed / sell derived; commissionable ⇒ the reverse
netcommissionable
margin_modeenum
percent ⇒ the margin was typed as a %; amount ⇒ as a flat figure
percentamount
option_datedate
transaction_datedate
işlem tarihi — the FX anchor for every cost line
invoice_datedate
cost_lineslist
cost-side pricing lines for the "hotel" pricing context
sell_lineslist
sell-side pricing lines for the "hotel" pricing context
travelerslistPII
guests; auto-saved to the customer's traveller directory
roomslist
a room with a `nightly_rate` contributes a room_rate SELL line × nights

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

Örnek gövde

{
  "rows": [
    {
      "external_id": "HOTEL-STAY-1001",
      "check_in_on": "2026-03-14",
      "check_out_on": "2026-03-18",
      "currency": "EUR",
      "guest_count": 2,
      "customer_external_id": "CUSTOMER-1001",
      "supplier_external_id": "SUPPLIER-1001",
      "status": "draft",
      "notes": "Imported from the source system.",
      "rate_basis": "net",
      "margin_mode": "percent",
      "option_date": "2026-03-14",
      "transaction_date": "2026-03-14",
      "invoice_date": "2026-03-18",
      "cost_lines": [
        {
          "kind": "room_rate",
          "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
        }
      ],
      "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": "female",
          "frequent_flyer_number": "TK123456789"
        }
      ],
      "rooms": [
        {
          "name": "Deluxe Sea View",
          "room_type": "double",
          "capacity": 2,
          "occupancy": 2,
          "nightly_rate": "180.00",
          "single_supplement_amount": "60.00",
          "single_supplement_currency": "EUR"
        }
      ]
    }
  ]
}

ticketsBiletler

İdempotency: bir kez oluşturulur: tekrar gönderim kopyalamaz, atlar

Uç noktalar

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

Alanlar(17)

external_idstring
source primary key → ExternalReference
pnrstring
gds_pnrstring
currencycurrency
settlement_channelenum
who we pay — drives the airline payable + BSP recon
bspdirectwebcardconsolidatorprepaid
fare_typestring
taxonomy `fare_type` (normal, award, …)
miles_usedinteger
reservation_giver_namestring
issuing_systemstring
option_datedate
ticketing deadline; set ⇒ the sale opens as `option` rather than `draft`
transaction_datedate
işlem tarihi — the FX anchor for every cost line
invoice_datedate
notesstring
legslist
shared itinerary; int/dom + one-way/round-trip are derived from the airports
passengerslistzorunluPII
one Ticket each; identities are auto-saved to the customer's traveller directory
customer_external_idreference
supplier_external_idreference
the settlement supplier (airline / consolidator) we pay

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

Örnek gövde

{
  "rows": [
    {
      "external_id": "TICKET-1001",
      "pnr": "ABC123",
      "gds_pnr": "ABC123",
      "currency": "EUR",
      "settlement_channel": "bsp",
      "fare_type": "normal",
      "miles_used": 2,
      "reservation_giver_name": "Ada Lovelace",
      "issuing_system": "amadeus",
      "option_date": "2026-03-14",
      "transaction_date": "2026-03-14",
      "invoice_date": "2026-03-18",
      "notes": "Imported from the source system.",
      "legs": [
        {
          "airline_code": "TK",
          "flight_number": "1985",
          "departure_airport": "IST",
          "arrival_airport": "FCO",
          "departure_at": "2026-03-14T09:30:00+03:00",
          "arrival_at": "2026-03-14T12:45:00+03:00",
          "cabin_class": "economy",
          "booking_class": "L",
          "fare_basis": "LLXOW",
          "baggage_allowance": "1PC",
          "status": "confirmed"
        }
      ],
      "passengers": [
        {
          "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": "female",
          "frequent_flyer_number": "TK123456789",
          "name": "Ada Lovelace",
          "type": "adult",
          "ticket_number": "235-1234567890",
          "cost_lines": [
            {
              "kind": "base_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
            }
          ]
        }
      ],
      "customer_external_id": "CUSTOMER-1001",
      "supplier_external_id": "SUPPLIER-1001"
    }
  ]
}

tour_bookingsTur rezervasyonları

İdempotency: bir kez oluşturulur: tekrar gönderim kopyalamaz, atlar

Uç noktalar

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

Alanlar(13)

external_idstring
source primary key → ExternalReference
namestringzorunluPII
lead passenger / party name
party_sizeintegerzorunlu
currencycurrency
phonephonePII
statusenum
pendingconfirmedcancelled
notesstring
transaction_datedate
işlem tarihi — the FX anchor for every line
invoice_datedate
cost_lineslist
cost-side pricing lines for the "tour" pricing context
sell_lineslist
sell-side pricing lines for the "tour" pricing context
customer_external_idreference
departure_external_idreferencezorunlu
the departure this seat is on — import it first

Referanslar

customer_external_id → customers · eşleşme external_id, email · bulunamazsa skip
departure_external_id → tour_departures · eşleşme external_id · bulunamazsa error

Örnek gövde

{
  "rows": [
    {
      "external_id": "TOUR-BOOKING-1001",
      "name": "Ada Lovelace",
      "party_size": 2,
      "currency": "EUR",
      "phone": "+905551112233",
      "status": "pending",
      "notes": "Imported from the source system.",
      "transaction_date": "2026-03-14",
      "invoice_date": "2026-03-18",
      "cost_lines": [
        {
          "kind": "ticket_price",
          "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
        }
      ],
      "customer_external_id": "CUSTOMER-1001",
      "departure_external_id": "TOUR-DEPARTURE-1001"
    }
  ]
}

transfersTransferler

İdempotency: bir kez oluşturulur: tekrar gönderim kopyalamaz, atlar

Uç noktalar

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

Alanlar(21)

external_idstring
pickup_atdatetimezorunlu
pickup_locationstringzorunlu
dropoff_locationstringzorunlu
currencycurrency
pax_countinteger
customer_external_idreference
supplier_external_idreference
statusenum
bookedassigneden_routecompletedcancelledno_show
notesstring
rate_basisenum
net ⇒ cost typed / sell derived; commissionable ⇒ the reverse
netcommissionable
margin_modeenum
percent ⇒ the margin was typed as a %; amount ⇒ as a flat figure
percentamount
transaction_datedate
işlem tarihi — the FX anchor for every cost line
invoice_datedate
cost_lineslist
cost-side pricing lines for the "transfer" pricing context
sell_lineslist
sell-side pricing lines for the "transfer" pricing context
travelerslistPII
guests; auto-saved to the customer's traveller directory
duration_minutesinteger
airline_codestring
inbound/outbound flight the transfer meets
flight_numberstring
flight_datedate

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

Örnek gövde

{
  "rows": [
    {
      "external_id": "TRANSFER-1001",
      "pickup_at": "2026-03-14T09:30:00+03:00",
      "pickup_location": "IST Airport",
      "dropoff_location": "Beyoğlu, İstanbul",
      "currency": "EUR",
      "pax_count": 2,
      "customer_external_id": "CUSTOMER-1001",
      "supplier_external_id": "SUPPLIER-1001",
      "status": "booked",
      "notes": "Imported from the source system.",
      "rate_basis": "net",
      "margin_mode": "percent",
      "transaction_date": "2026-03-14",
      "invoice_date": "2026-03-18",
      "cost_lines": [
        {
          "kind": "vehicle_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
        }
      ],
      "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": "female",
          "frequent_flyer_number": "TK123456789"
        }
      ],
      "duration_minutes": 2,
      "airline_code": "TK",
      "flight_number": "1985",
      "flight_date": "2026-03-14"
    }
  ]
}

operator_invoicesFaturalar (alacaklar)

İdempotency: upsert: tekrar gönderim mevcut satırı günceller

Uç noktalar

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

Alanlar(11)

external_idstring
legacy_numberstringzorunlu
issued_ondatezorunlu
due_ondate
total_amountmoneyzorunlu
amount_paidmoney
already collected before cutover; imported as a brought-forward receipt
paid_ondate
when `amount_paid` was collected; defaults to the invoice date
currencycurrency
bill_to_namestring
customer_external_idreference
notesstring

Referanslar

customer_external_id → customers · eşleşme external_id, email · bulunamazsa error

Örnek gövde

{
  "rows": [
    {
      "external_id": "OPERATOR-INVOICE-1001",
      "legacy_number": "2025-000431",
      "issued_on": "2026-03-14",
      "due_on": "2026-03-18",
      "total_amount": "1250.00",
      "amount_paid": "1250.00",
      "paid_on": "2026-03-14",
      "currency": "EUR",
      "bill_to_name": "Lovelace Seyahat A.Ş.",
      "customer_external_id": "CUSTOMER-1001",
      "notes": "Imported from the source system."
    }
  ]
}

supplier_billsTedarikçi faturaları (borçlar)

İdempotency: upsert: tekrar gönderim mevcut satırı günceller

Uç noktalar

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

Alanlar(10)

external_idstring
numberstringzorunlu
received_atdatezorunlu
due_ondate
total_amountmoneyzorunlu
amount_paidmoney
already paid before cutover; imported as a brought-forward payment
paid_ondate
when `amount_paid` was paid; defaults to the bill date
currencycurrency
supplier_external_idreference
notesstring

Referanslar

supplier_external_id → suppliers · eşleşme external_id, code · bulunamazsa error

Örnek gövde

{
  "rows": [
    {
      "external_id": "SUPPLIER-BILL-1001",
      "number": "TR-2025-000431",
      "received_at": "2026-03-14",
      "due_on": "2026-03-18",
      "total_amount": "1250.00",
      "amount_paid": "1250.00",
      "paid_on": "2026-03-14",
      "currency": "EUR",
      "supplier_external_id": "SUPPLIER-1001",
      "notes": "Imported from the source system."
    }
  ]
}

Yalnız okuma ve yayın

Bunlar değişiklik akışında sayfalanır ve webhook tetikler, ama birine POST atmak 422 entity_not_writable döner.

chartersCharter kiralamaları
eventsEtkinlikler
visa_casesVize dosyaları