Billing details

The buyer's party for a Turkish e-Fatura / e-Arşiv invoice: an individual / company toggle, first and last name with a TCKN, or a company title with tax office and a VKN (or the owner's TCKN for a sole proprietorship), e-mail, phone and a structured address. Fields only — the same validateBillingDetails runs in the browser and on the server and returns a normalised party with its UBL-TR scheme (TCKN / VKN). No e-invoice integration.

Installation

Usage

import { BillingDetailsFields, billingDetailsFromFormData, billingErrorMessages, validateBillingDetails } from "@vamos-ui/react/business";

// page
<form action={saveBilling}>
  <BillingDetailsFields name="billing" defaultValue={{ type: "individual", address: { country: "TR" } }} />
</form>

// server action
async function saveBilling(data: FormData) {
  "use server";
  const v = validateBillingDetails(billingDetailsFromFormData(data, "billing"));
  if (!v.ok) return { errors: billingErrorMessages(v.errors) }; // pass back as errors={…}
  await customers.saveBillingParty(v.party!); // { type, name, taxId, taxScheme: "TCKN" | "VKN", taxOffice?, email, phone?, address }
}

A sole proprietorship (şahıs şirketi) invoices with the owner's TCKN, so the company tax number accepts 10-digit VKNs and 11-digit TCKNs; taxScheme tells which one it is.

The tax office is free text: there is no bundled list of tax offices.

Whether the buyer is registered for e-Fatura (and so gets an e-Fatura instead of an e-Arşiv invoice) is answered by your e-invoice provider, not by this form.

Examples

API