Supplier Payments API

Manage payments to suppliers, carriers, and hotels. Supports reconciliation and segment-level payment tracking.

---

List Supplier Payments

GET /api/v1/supplier-payments

Query Parameters:

Parameter	Type	Description
supplier_id	uuid	Filter by supplier
carrier_id	uuid	Filter by carrier
hotel_id	uuid	Filter by hotel
bank_account_id	uuid	Filter by bank account
from_date	string	YYYY-MM-DD
to_date	string	YYYY-MM-DD
is_reconciled	boolean	Filter by reconciled status

---

Get Supplier Payment

GET /api/v1/supplier-payments/{id}

---

Create Supplier Payment

POST /api/v1/supplier-payments

Request Body:

Field	Type	Required	Description
supplier_id	uuid	No	Supplier UUID
carrier_id	uuid	No	Carrier UUID
hotel_id	uuid	No	Hotel UUID
bank_account_id	uuid	No	Bank account UUID
account_bank_type_id	uuid	No	Account bank type UUID
amount	string	✅ Yes	Decimal string (e.g. "379.60")
currency	string	✅ Yes	EUR, USD, TRY
payment_date	string	✅ Yes	YYYY-MM-DD
payment_method	string	No	BANK_TRANSFER, CASH, CREDIT_CARD, CHECK
reference	string	No	Invoice or reference number
notes	string	No	Additional notes

---

Update Supplier Payment

PUT /api/v1/supplier-payments/{id}

---

Delete Supplier Payment

DELETE /api/v1/supplier-payments/{id}

---

Reconcile Supplier Payment

Marks a payment as reconciled.

PUT /api/v1/supplier-payments/{id}/reconcile

---

List Unpaid Segments

Returns segments that have not yet been paid to the supplier.

GET /api/v1/supplier-payments/unpaid-segments

Query Parameters:

Parameter	Type	Description
carrier_id	uuid	Filter by carrier
supplier_id	uuid	Filter by supplier
hotel_id	uuid	Filter by hotel
from_date	string	YYYY-MM-DD
to_date	string	YYYY-MM-DD
payment_status	string	full, PAID, pending, UNPAID

---

Mark Segments as Paid

Bulk-mark segments as paid and create a linked supplier payment.

POST /api/v1/supplier-payments/mark-paid

Request Body:

{
  "segment_ids": ["uuid"],
  "invoice_number": "INV-2026-001",
  "payment_date": "YYYY-MM-DD",
  "payment_method": "CASH",
  "amount": "379.60",
  "currency": "EUR",
  "carrier_id": "uuid",
  "supplier_id": "uuid",
  "hotel_id": "uuid",
  "bank_account_id": "uuid",
  "account_code_id": "uuid",
  "reference": "REF",
  "notes": "Optional notes"
}