uae-einvoice-mcp 0.2.0

package/dist/lib/invoice-types.d.ts

@@ -0,0 +1,63 @@
+export type InvoiceDocumentType = "tax_invoice" | "commercial_invoice" | "credit_note";
+export interface PartyInput {
+    legalName?: string;
+    tradeName?: string;
+    trn?: string;
+    tin?: string;
+    countryCode?: string;
+    addressLine?: string;
+    cityOrEmirate?: string;
+    postalZone?: string;
+    contactName?: string;
+    email?: string;
+    phone?: string;
+    peppolId?: string;
+}
+export interface InvoiceLineInput {
+    id?: string;
+    name?: string;
+    quantity?: number;
+    unitCode?: string;
+    netAmount?: number;
+    unitPrice?: number;
+    taxCategoryCode?: string;
+    taxPercent?: number;
+}
+export interface TaxBreakdownInput {
+    taxableAmount?: number;
+    taxAmount?: number;
+    taxCategoryCode?: string;
+    taxPercent?: number;
+    exemptionReason?: string;
+    exemptionReasonCode?: string;
+}
+export interface InvoiceDataInput {
+    documentType?: InvoiceDocumentType;
+    invoiceNumber?: string;
+    issueDate?: string;
+    dueDate?: string;
+    currencyCode?: string;
+    taxCurrencyCode?: string;
+    customizationId?: string;
+    profileId?: string;
+    typeCode?: string;
+    buyerReference?: string;
+    periodStart?: string;
+    periodEnd?: string;
+    taxPointDate?: string;
+    /** Original invoice number — important for credit notes */
+    billingReference?: string;
+    seller?: PartyInput;
+    buyer?: PartyInput;
+    lineNetTotal?: number;
+    taxExclusiveTotal?: number;
+    taxTotal?: number;
+    taxTotalAed?: number;
+    taxInclusiveTotal?: number;
+    allowanceTotal?: number;
+    chargeTotal?: number;
+    prepaidAmount?: number;
+    payableAmount?: number;
+    taxBreakdown?: TaxBreakdownInput[];
+    lines?: InvoiceLineInput[];
+}

package/dist/lib/invoice-types.js

@@ -0,0 +1 @@
+export {};

package/dist/lib/requirements.d.ts

@@ -0,0 +1,26 @@
+/**
+ * UAE e-invoicing mandate timeline and high-level requirements.
+ * Based on Cabinet Decision / Ministerial Decisions (MD 243 & 244 of 2025)
+ * and MoF Electronic Invoicing Guidelines (v1.0, Feb 2026).
+ *
+ * Dates can shift — treat this as guidance and verify against official MoF/FTA notices.
+ */
+export type BusinessSegment = "large" | "sme" | "government" | "all";
+export interface MandatePhase {
+    segment: Exclude<BusinessSegment, "all">;
+    label: string;
+    revenueThresholdAed: number | null;
+    aspAppointmentDeadline: string;
+    goLiveDate: string;
+    notes: string[];
+}
+export interface RequirementsResult {
+    asOf: string;
+    disclaimer: string;
+    segment: BusinessSegment;
+    phases: MandatePhase[];
+    technicalBaseline: string[];
+    keyIdentifiers: Record<string, string>;
+    nextActions: string[];
+}
+export declare function getEinvoicingRequirements(segment?: BusinessSegment, annualRevenueAed?: number): RequirementsResult;

package/dist/lib/requirements.js

@@ -0,0 +1,88 @@
+/**
+ * UAE e-invoicing mandate timeline and high-level requirements.
+ * Based on Cabinet Decision / Ministerial Decisions (MD 243 & 244 of 2025)
+ * and MoF Electronic Invoicing Guidelines (v1.0, Feb 2026).
+ *
+ * Dates can shift — treat this as guidance and verify against official MoF/FTA notices.
+ */
+const PHASES = [
+    {
+        segment: "large",
+        label: "Large businesses (revenue ≥ AED 50 million)",
+        revenueThresholdAed: 50_000_000,
+        aspAppointmentDeadline: "2026-10-30",
+        goLiveDate: "2027-01-01",
+        notes: [
+            "Appoint a Ministry of Finance Accredited Service Provider (ASP) by the appointment deadline.",
+            "Mandatory electronic invoicing via Peppol / PINT AE from go-live.",
+            "Pilot / early adoption window opened in 2026 via EmaraTax.",
+        ],
+    },
+    {
+        segment: "sme",
+        label: "Other in-scope persons (revenue < AED 50 million)",
+        revenueThresholdAed: null,
+        aspAppointmentDeadline: "2027-03-31",
+        goLiveDate: "2027-07-01",
+        notes: [
+            "Includes many B2B traders even below the VAT registration threshold if they fall in scope.",
+            "Entities without any FTA tax registration must still obtain a TIN for Peppol participation.",
+        ],
+    },
+    {
+        segment: "government",
+        label: "Government entities",
+        revenueThresholdAed: null,
+        aspAppointmentDeadline: "2027-10-01",
+        goLiveDate: "2027-10-01",
+        notes: [
+            "Government entities follow a later mandatory wave (verify current MD / circulars).",
+        ],
+    },
+];
+const TECHNICAL_BASELINE = [
+    "Document format: UBL 2.1 XML conforming to PINT AE (Peppol International Invoice — UAE).",
+    "Typical specification identifier: urn:peppol:pint:billing-1@ae-1 (confirm against current PINT AE release).",
+    "Transport: Peppol AS4 via an Accredited Service Provider (ASP) — not direct FTA file upload from ERP.",
+    "Tax invoice mandatory fields: 51 data elements (MoF mandatory-fields document); commercial e-invoice: 49.",
+    "Seller electronic address / participant ID uses scheme 0235 + 10-digit TIN (first 10 digits of TRN).",
+    "Currency and amounts must be consistent; DocumentCurrencyCode is typically AED for domestic supplies.",
+    "Invoice type codes commonly include 380 (invoice) and 381 (credit note).",
+    "Validate against UBL 2.1 XSD and PINT AE Schematron rules before transmission.",
+];
+export function getEinvoicingRequirements(segment = "all", annualRevenueAed) {
+    let phases = PHASES;
+    let resolved = segment;
+    if (segment === "all" && typeof annualRevenueAed === "number") {
+        resolved = annualRevenueAed >= 50_000_000 ? "large" : "sme";
+        phases = PHASES.filter((p) => p.segment === resolved);
+    }
+    else if (segment !== "all") {
+        phases = PHASES.filter((p) => p.segment === segment);
+    }
+    const primary = phases[0];
+    const nextActions = [
+        "Confirm whether your entity is in scope under MD 243/244 of 2025.",
+        "Obtain or verify your TIN (first 10 digits of your TRN) in EmaraTax.",
+        "Shortlist and appoint an MoF Accredited Service Provider before your appointment deadline.",
+        "Map ERP invoice fields to the PINT AE data dictionary (51 tax-invoice fields).",
+        "Run sample invoices through ASP validation (XSD + Schematron) in the pilot window.",
+    ];
+    if (primary) {
+        nextActions.unshift(`Target ASP appointment by ${primary.aspAppointmentDeadline} and go-live by ${primary.goLiveDate} for: ${primary.label}.`);
+    }
+    return {
+        asOf: "2026-09-08",
+        disclaimer: "Informational summary only — not legal or tax advice. Verify dates and obligations against official UAE MoF / FTA publications.",
+        segment: resolved,
+        phases,
+        technicalBaseline: TECHNICAL_BASELINE,
+        keyIdentifiers: {
+            TRN: "15-digit Tax Registration Number (VAT)",
+            TIN: "First 10 digits of TRN — Peppol endpoint identifier body",
+            PeppolParticipantId: "0235:<TIN>",
+            Specification: "PINT AE on UBL 2.1",
+        },
+        nextActions,
+    };
+}

package/dist/lib/trn.d.ts

@@ -0,0 +1,39 @@
+/**
+ * UAE Tax Registration Number (TRN) and Tax Identification Number (TIN) helpers.
+ *
+ * - TRN: 15 digits issued by the FTA for VAT-registered entities
+ * - TIN: first 10 digits of the TRN; used as the Peppol participant identifier
+ *   under scheme 0235 (format: 0235:TIN)
+ *
+ * TIN structure (Peppol AE:TIN / ISO 6523 scheme 0235):
+ * - digit 1: UAE country identifier — must be "1"
+ * - digits 2–9: FTA business identifier
+ * - digit 10: Luhn check digit (odd-placed digits from the left ×2)
+ */
+export type IdentifierKind = "trn" | "tin" | "unknown";
+export interface TrnValidationResult {
+    input: string;
+    normalized: string;
+    kind: IdentifierKind;
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+    tin: string | null;
+    trn: string | null;
+    peppolParticipantId: string | null;
+    details: {
+        startsWithUaeCountryCode: boolean;
+        formatOk: boolean;
+        checksumOk: boolean | null;
+    };
+}
+/**
+ * Peppol AE:TIN Luhn variant: odd-placed digits (1-indexed from the left) ×2;
+ * if product ≥ 10, sum its digits; even-placed ×1. Check digit is sum % 10.
+ */
+export declare function computeTinCheckDigit(nineDigits: string): number;
+export declare function isValidTinChecksum(tin: string): boolean;
+export declare function tinToPeppolId(tin: string): string;
+export declare function validateTaxId(raw: string): TrnValidationResult;
+/** Generate a structurally valid sample TIN for demos/tests (not a real FTA number). */
+export declare function makeSampleTin(bodyEightDigits?: string): string;

package/dist/lib/trn.js

@@ -0,0 +1,110 @@
+/**
+ * UAE Tax Registration Number (TRN) and Tax Identification Number (TIN) helpers.
+ *
+ * - TRN: 15 digits issued by the FTA for VAT-registered entities
+ * - TIN: first 10 digits of the TRN; used as the Peppol participant identifier
+ *   under scheme 0235 (format: 0235:TIN)
+ *
+ * TIN structure (Peppol AE:TIN / ISO 6523 scheme 0235):
+ * - digit 1: UAE country identifier — must be "1"
+ * - digits 2–9: FTA business identifier
+ * - digit 10: Luhn check digit (odd-placed digits from the left ×2)
+ */
+function digitsOnly(value) {
+    return value.replace(/\D/g, "");
+}
+/**
+ * Peppol AE:TIN Luhn variant: odd-placed digits (1-indexed from the left) ×2;
+ * if product ≥ 10, sum its digits; even-placed ×1. Check digit is sum % 10.
+ */
+export function computeTinCheckDigit(nineDigits) {
+    if (!/^\d{9}$/.test(nineDigits)) {
+        throw new Error("TIN body must be exactly 9 digits");
+    }
+    let sum = 0;
+    for (let i = 0; i < nineDigits.length; i++) {
+        const digit = Number(nineDigits[i]);
+        const position = i + 1; // 1-indexed from the left
+        let value = position % 2 === 1 ? digit * 2 : digit;
+        if (value >= 10) {
+            value = Math.floor(value / 10) + (value % 10);
+        }
+        sum += value;
+    }
+    return sum % 10;
+}
+export function isValidTinChecksum(tin) {
+    if (!/^\d{10}$/.test(tin))
+        return false;
+    const expected = computeTinCheckDigit(tin.slice(0, 9));
+    return Number(tin[9]) === expected;
+}
+export function tinToPeppolId(tin) {
+    return `0235:${tin}`;
+}
+export function validateTaxId(raw) {
+    const normalized = digitsOnly(raw.trim());
+    const errors = [];
+    const warnings = [];
+    let kind = "unknown";
+    if (normalized.length === 15)
+        kind = "trn";
+    else if (normalized.length === 10)
+        kind = "tin";
+    const formatOk = (kind === "trn" && /^\d{15}$/.test(normalized)) ||
+        (kind === "tin" && /^\d{10}$/.test(normalized));
+    if (!normalized) {
+        errors.push("Value is empty after removing non-digit characters.");
+    }
+    else if (kind === "unknown") {
+        errors.push(`Expected a 10-digit TIN or 15-digit TRN; got ${normalized.length} digit(s).`);
+    }
+    const tinCandidate = kind === "trn"
+        ? normalized.slice(0, 10)
+        : kind === "tin"
+            ? normalized
+            : null;
+    const startsWithUaeCountryCode = tinCandidate?.startsWith("1") ?? false;
+    if (tinCandidate && !startsWithUaeCountryCode) {
+        errors.push("TIN/TRN must start with 1 (UAE country identifier per GCC / Peppol AE:TIN).");
+    }
+    let checksumOk = null;
+    if (tinCandidate && /^\d{10}$/.test(tinCandidate)) {
+        checksumOk = isValidTinChecksum(tinCandidate);
+        if (!checksumOk) {
+            errors.push(`TIN check digit is invalid (expected ${computeTinCheckDigit(tinCandidate.slice(0, 9))}, got ${tinCandidate[9]}).`);
+        }
+    }
+    if (kind === "trn" && formatOk) {
+        warnings.push("Full 15-digit TRN format checked locally only — live FTA register lookup is not performed.");
+    }
+    const valid = errors.length === 0 && formatOk;
+    const tin = valid && tinCandidate ? tinCandidate : tinCandidate;
+    const trn = kind === "trn" && formatOk ? normalized : null;
+    return {
+        input: raw,
+        normalized,
+        kind,
+        valid,
+        errors,
+        warnings,
+        tin: tinCandidate,
+        trn,
+        peppolParticipantId: tinCandidate && /^\d{10}$/.test(tinCandidate)
+            ? tinToPeppolId(tinCandidate)
+            : null,
+        details: {
+            startsWithUaeCountryCode,
+            formatOk,
+            checksumOk,
+        },
+    };
+}
+/** Generate a structurally valid sample TIN for demos/tests (not a real FTA number). */
+export function makeSampleTin(bodyEightDigits = "23456789") {
+    if (!/^\d{8}$/.test(bodyEightDigits)) {
+        throw new Error("bodyEightDigits must be 8 digits");
+    }
+    const nine = `1${bodyEightDigits}`;
+    return `${nine}${computeTinCheckDigit(nine)}`;
+}

package/dist/lib/xml.d.ts

@@ -0,0 +1,21 @@
+import type { InvoiceDataInput } from "./invoice-types.js";
+export interface GenerateXmlOptions {
+    /** If true, refuse XML when applicable mandatory fields have gaps */
+    strict?: boolean;
+}
+export interface GenerateXmlResult {
+    generated: boolean;
+    rootElement: "Invoice" | "CreditNote";
+    xml: string | null;
+    checklistComplete: boolean;
+    gaps: Array<{
+        id: number;
+        key: string;
+        name: string;
+        status: string;
+        note?: string;
+    }>;
+    warnings: string[];
+    note: string;
+}
+export declare function generatePintAeXml(invoice: InvoiceDataInput, options?: GenerateXmlOptions): GenerateXmlResult;

package/dist/lib/xml.js

@@ -0,0 +1,222 @@
+import { EXPECTED_CUSTOMIZATION, EXPECTED_PROFILE, buyerEndpoint, partyTaxId, sellerEndpoint, } from "./fields.js";
+import { checkPintAeFields } from "./checklist.js";
+function esc(value) {
+    if (value === undefined || value === null)
+        return "";
+    return String(value)
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+}
+function amountTag(tag, amount, currency) {
+    return `<${tag} currencyID="${esc(currency)}">${amount.toFixed(2)}</${tag}>`;
+}
+function partyXml(wrapper, party, role, invoice) {
+    const ep = role === "seller" ? sellerEndpoint(invoice) : buyerEndpoint(invoice);
+    const tax = partyTaxId(party);
+    const name = party?.tradeName ?? party?.legalName ?? "";
+    const currency = invoice.currencyCode ?? "AED";
+    const contactParts = [];
+    if (party?.contactName)
+        contactParts.push(`      <cbc:Name>${esc(party.contactName)}</cbc:Name>`);
+    if (party?.phone)
+        contactParts.push(`      <cbc:Telephone>${esc(party.phone)}</cbc:Telephone>`);
+    if (party?.email) {
+        contactParts.push(`      <cbc:ElectronicMail>${esc(party.email)}</cbc:ElectronicMail>`);
+    }
+    return `
+  <cac:${wrapper}>
+    <cac:Party>
+${ep ? `      <cbc:EndpointID schemeID="${esc(ep.scheme)}">${esc(ep.value)}</cbc:EndpointID>` : ""}
+${name ? `      <cac:PartyName>
+        <cbc:Name>${esc(name)}</cbc:Name>
+      </cac:PartyName>` : ""}
+      <cac:PostalAddress>
+${party?.addressLine ? `        <cbc:StreetName>${esc(party.addressLine)}</cbc:StreetName>` : ""}
+${party?.cityOrEmirate ? `        <cbc:CityName>${esc(party.cityOrEmirate)}</cbc:CityName>` : ""}
+${party?.postalZone ? `        <cbc:PostalZone>${esc(party.postalZone)}</cbc:PostalZone>` : ""}
+        <cac:Country>
+          <cbc:IdentificationCode>${esc(party?.countryCode ?? "AE")}</cbc:IdentificationCode>
+        </cac:Country>
+      </cac:PostalAddress>
+${tax.trn || tax.tin
+        ? `      <cac:PartyTaxScheme>
+        <cbc:CompanyID>${esc(tax.trn ?? tax.tin)}</cbc:CompanyID>
+        <cac:TaxScheme>
+          <cbc:ID>VAT</cbc:ID>
+        </cac:TaxScheme>
+      </cac:PartyTaxScheme>`
+        : ""}
+      <cac:PartyLegalEntity>
+        <cbc:RegistrationName>${esc(party?.legalName ?? "")}</cbc:RegistrationName>
+      </cac:PartyLegalEntity>
+${contactParts.length
+        ? `      <cac:Contact>
+${contactParts.join("\n")}
+      </cac:Contact>`
+        : ""}
+    </cac:Party>
+  </cac:${wrapper}>`.replaceAll(`\n\n`, "\n");
+}
+export function generatePintAeXml(invoice, options = {}) {
+    const checklist = checkPintAeFields(invoice);
+    const gaps = checklist.gaps.map((g) => ({
+        id: g.id,
+        key: g.key,
+        name: g.name,
+        status: g.status,
+        note: g.note,
+    }));
+    const warnings = [];
+    const strict = options.strict ?? false;
+    if (strict && gaps.length > 0) {
+        return {
+            generated: false,
+            rootElement: invoice.documentType === "credit_note" ? "CreditNote" : "Invoice",
+            xml: null,
+            checklistComplete: false,
+            gaps,
+            warnings: [
+                "strict=true: XML not generated because applicable mandatory fields are incomplete.",
+            ],
+            note: "Fix checklist gaps or call again with strict=false to emit a best-effort stub.",
+        };
+    }
+    if (gaps.length > 0) {
+        warnings.push(`Emitting best-effort XML with ${gaps.length} checklist gap(s). Not ASP-ready.`);
+    }
+    const isCredit = invoice.documentType === "credit_note";
+    const root = isCredit ? "CreditNote" : "Invoice";
+    const typeTag = isCredit ? "CreditNoteTypeCode" : "InvoiceTypeCode";
+    const lineWrapper = isCredit ? "CreditNoteLine" : "InvoiceLine";
+    const qtyTag = isCredit ? "CreditedQuantity" : "InvoicedQuantity";
+    const currency = invoice.currencyCode ?? "AED";
+    const customization = invoice.customizationId ?? EXPECTED_CUSTOMIZATION;
+    const profile = invoice.profileId ?? EXPECTED_PROFILE;
+    const typeCode = invoice.typeCode ?? (isCredit ? "381" : "380");
+    if (!invoice.profileId) {
+        warnings.push(`Defaulted ProfileID to ${EXPECTED_PROFILE}`);
+    }
+    if (!invoice.customizationId) {
+        warnings.push(`Defaulted CustomizationID to ${EXPECTED_CUSTOMIZATION}`);
+    }
+    const taxBlocks = (invoice.taxBreakdown ?? [])
+        .map((row) => {
+        const exemption = row.exemptionReasonCode || row.exemptionReason
+            ? `${row.exemptionReasonCode
+                ? `
+          <cbc:TaxExemptionReasonCode>${esc(row.exemptionReasonCode)}</cbc:TaxExemptionReasonCode>`
+                : ""}${row.exemptionReason
+                ? `
+          <cbc:TaxExemptionReason>${esc(row.exemptionReason)}</cbc:TaxExemptionReason>`
+                : ""}`
+            : "";
+        return `
+    <cac:TaxSubtotal>
+      ${amountTag("cbc:TaxableAmount", row.taxableAmount ?? 0, currency)}
+      ${amountTag("cbc:TaxAmount", row.taxAmount ?? 0, currency)}
+      <cac:TaxCategory>
+        <cbc:ID>${esc(row.taxCategoryCode ?? "S")}</cbc:ID>
+        <cbc:Percent>${(row.taxPercent ?? 0).toFixed(2)}</cbc:Percent>${exemption}
+        <cac:TaxScheme>
+          <cbc:ID>VAT</cbc:ID>
+        </cac:TaxScheme>
+      </cac:TaxCategory>
+    </cac:TaxSubtotal>`;
+    })
+        .join("");
+    const lines = (invoice.lines ?? [])
+        .map((line, idx) => {
+        return `
+  <cac:${lineWrapper}>
+    <cbc:ID>${esc(line.id ?? String(idx + 1))}</cbc:ID>
+    <cbc:${qtyTag} unitCode="${esc(line.unitCode ?? "EA")}">${line.quantity ?? 0}</cbc:${qtyTag}>
+    ${amountTag("cbc:LineExtensionAmount", line.netAmount ?? 0, currency)}
+    <cac:Item>
+      <cbc:Name>${esc(line.name ?? "Item")}</cbc:Name>
+      <cac:ClassifiedTaxCategory>
+        <cbc:ID>${esc(line.taxCategoryCode ?? "S")}</cbc:ID>
+        <cbc:Percent>${(line.taxPercent ?? 0).toFixed(2)}</cbc:Percent>
+        <cac:TaxScheme>
+          <cbc:ID>VAT</cbc:ID>
+        </cac:TaxScheme>
+      </cac:ClassifiedTaxCategory>
+    </cac:Item>
+    <cac:Price>
+      ${amountTag("cbc:PriceAmount", line.unitPrice ?? 0, currency)}
+    </cac:Price>
+  </cac:${lineWrapper}>`;
+    })
+        .join("");
+    const period = invoice.periodStart || invoice.periodEnd
+        ? `
+  <cac:InvoicePeriod>
+${invoice.periodStart ? `    <cbc:StartDate>${esc(invoice.periodStart)}</cbc:StartDate>` : ""}
+${invoice.periodEnd ? `    <cbc:EndDate>${esc(invoice.periodEnd)}</cbc:EndDate>` : ""}
+  </cac:InvoicePeriod>`
+        : "";
+    const billingRef = invoice.billingReference
+        ? `
+  <cac:BillingReference>
+    <cac:InvoiceDocumentReference>
+      <cbc:ID>${esc(invoice.billingReference)}</cbc:ID>
+    </cac:InvoiceDocumentReference>
+  </cac:BillingReference>`
+        : "";
+    const xml = `<?xml version="1.0" encoding="UTF-8"?>
+<${root} xmlns="urn:oasis:names:specification:ubl:schema:xsd:${root}-2"
+  xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2"
+  xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2">
+  <cbc:CustomizationID>${esc(customization)}</cbc:CustomizationID>
+  <cbc:ProfileID>${esc(profile)}</cbc:ProfileID>
+  <cbc:ID>${esc(invoice.invoiceNumber ?? "UNKNOWN")}</cbc:ID>
+  <cbc:IssueDate>${esc(invoice.issueDate ?? "1970-01-01")}</cbc:IssueDate>
+${invoice.dueDate ? `  <cbc:DueDate>${esc(invoice.dueDate)}</cbc:DueDate>` : ""}
+${invoice.taxPointDate ? `  <cbc:TaxPointDate>${esc(invoice.taxPointDate)}</cbc:TaxPointDate>` : ""}
+  <cbc:${typeTag}>${esc(typeCode)}</cbc:${typeTag}>
+  <cbc:DocumentCurrencyCode>${esc(currency)}</cbc:DocumentCurrencyCode>
+${invoice.taxCurrencyCode
+        ? `  <cbc:TaxCurrencyCode>${esc(invoice.taxCurrencyCode)}</cbc:TaxCurrencyCode>`
+        : ""}
+${invoice.buyerReference ? `  <cbc:BuyerReference>${esc(invoice.buyerReference)}</cbc:BuyerReference>` : ""}
+${period}${billingRef}
+${partyXml("AccountingSupplierParty", invoice.seller, "seller", invoice)}
+${partyXml("AccountingCustomerParty", invoice.buyer, "buyer", invoice)}
+  <cac:TaxTotal>
+    ${amountTag("cbc:TaxAmount", invoice.taxTotal ?? 0, currency)}
+${taxBlocks}
+  </cac:TaxTotal>
+${typeof invoice.taxTotalAed === "number" && currency !== "AED"
+        ? `  <cac:TaxTotal>
+    ${amountTag("cbc:TaxAmount", invoice.taxTotalAed, "AED")}
+  </cac:TaxTotal>`
+        : ""}
+  <cac:LegalMonetaryTotal>
+    ${amountTag("cbc:LineExtensionAmount", invoice.lineNetTotal ?? 0, currency)}
+    ${amountTag("cbc:TaxExclusiveAmount", invoice.taxExclusiveTotal ?? 0, currency)}
+    ${amountTag("cbc:TaxInclusiveAmount", invoice.taxInclusiveTotal ?? 0, currency)}
+${typeof invoice.allowanceTotal === "number"
+        ? `    ${amountTag("cbc:AllowanceTotalAmount", invoice.allowanceTotal, currency)}`
+        : ""}
+${typeof invoice.chargeTotal === "number"
+        ? `    ${amountTag("cbc:ChargeTotalAmount", invoice.chargeTotal, currency)}`
+        : ""}
+${typeof invoice.prepaidAmount === "number"
+        ? `    ${amountTag("cbc:PrepaidAmount", invoice.prepaidAmount, currency)}`
+        : ""}
+    ${amountTag("cbc:PayableAmount", invoice.payableAmount ?? 0, currency)}
+  </cac:LegalMonetaryTotal>
+${lines}
+</${root}>
+`;
+    return {
+        generated: true,
+        rootElement: root,
+        xml: xml.replace(/\n{3,}/g, "\n\n").trim() + "\n",
+        checklistComplete: checklist.complete,
+        gaps,
+        warnings,
+        note: "UBL 2.1 stub shaped for PINT AE demos. Validate with your ASP XSD/Schematron before transmission.",
+    };
+}

package/dist/selfcheck.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/selfcheck.js

@@ -0,0 +1,44 @@
+import assert from "node:assert/strict";
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { checkPintAeFields } from "./lib/checklist.js";
+import { checkInvoiceCompliance } from "./lib/compliance.js";
+import { getEinvoicingRequirements } from "./lib/requirements.js";
+import { computeTinCheckDigit, makeSampleTin, validateTaxId } from "./lib/trn.js";
+import { generatePintAeXml } from "./lib/xml.js";
+import { PINT_AE_FIELDS } from "./lib/fields.js";
+const sampleTin = makeSampleTin("23456789");
+assert.equal(sampleTin.length, 10);
+assert.equal(sampleTin[0], "1");
+assert.equal(Number(sampleTin[9]), computeTinCheckDigit(sampleTin.slice(0, 9)));
+assert.equal(validateTaxId(sampleTin).valid, true);
+assert.equal(validateTaxId(`${sampleTin}12345`).valid, true);
+assert.equal(validateTaxId("1234567890").valid, false);
+assert.equal(PINT_AE_FIELDS.length, 51);
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const fixture = JSON.parse(readFileSync(join(__dirname, "../examples/compliant-invoice.json"), "utf8")).invoiceData;
+const good = checkInvoiceCompliance(fixture);
+assert.equal(good.compliant, true, JSON.stringify(good.findings, null, 2));
+const checklist = checkPintAeFields(fixture);
+assert.equal(checklist.totalFields, 51);
+assert.ok(checklist.completionPercent >= 90, JSON.stringify(checklist.gaps, null, 2));
+assert.equal(checklist.complete, true, JSON.stringify(checklist.gaps, null, 2));
+const xml = generatePintAeXml(fixture);
+assert.equal(xml.generated, true);
+assert.ok(xml.xml?.includes("CustomizationID"));
+assert.ok(xml.xml?.includes("AccountingSupplierParty"));
+assert.ok(xml.xml?.includes("<cbc:ID>INV-1001</cbc:ID>"));
+const strictFail = generatePintAeXml({ documentType: "tax_invoice" }, { strict: true });
+assert.equal(strictFail.generated, false);
+const bad = checkInvoiceCompliance({ documentType: "tax_invoice" });
+assert.equal(bad.compliant, false);
+assert.ok(bad.findings.some((f) => f.severity === "error"));
+const reqs = getEinvoicingRequirements("all", 60_000_000);
+assert.equal(reqs.segment, "large");
+assert.ok(reqs.phases.length === 1);
+console.log("All self-checks passed.");
+console.log("Sample TIN:", sampleTin);
+console.log("Compliance score:", good.score);
+console.log("Checklist completion %:", checklist.completionPercent);
+console.log("XML bytes:", xml.xml?.length);

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "uae-einvoice-mcp",
+  "version": "0.2.0",
+  "description": "MCP server for UAE e-invoicing / PINT AE: TRN validation, 51-field checklist, XML generation, mandate timeline",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "uae-einvoice-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "selfcheck": "tsx src/selfcheck.ts",
+    "inspector": "npm run build && npx @modelcontextprotocol/inspector node dist/index.js"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "uae",
+    "e-invoicing",
+    "pint-ae",
+    "peppol",
+    "trn",
+    "fta"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/server": "^2.0.0",
+    "zod": "^4.5.4"
+  },
+  "devDependencies": {
+    "@types/node": "^26.5.0",
+    "tsx": "^4.23.13",
+    "typescript": "^7.0.2"
+  }
+}