@yoryoboy/bi-mcp 1.16.0 → 1.17.0

package/dist/src/tools/mercadolibre/get-payment-details.js

@@ -0,0 +1,322 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import { formatMercadoLibreError } from "../../services/mercadolibre/mercadolibre-api.js";
+import {
+  getMercadoLibrePaymentDetails,
+  getMercadoLibrePaymentDetailsBatch
+} from "../../services/mercadolibre/mercadolibre-payments.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+import {
+  asArray,
+  asRecord,
+  compactDateTime,
+  currencyBucket,
+  normalizeScalarString,
+  normalizeString,
+  roundMoney,
+  toNumber
+} from "./helpers.js";
+import { resolveMercadoLibreProfileOrSelection } from "./profile-resolution.js";
+import { mercadolibreProfileIdSchemaField } from "./write-helpers.js";
+const MAX_PAYMENT_IDS = 250;
+const paymentIdSchemaField = z.string().trim().min(1).describe("MercadoLibre payment id to inspect.");
+const meliGetPaymentDetailsSchema = z.object({
+  profileId: mercadolibreProfileIdSchemaField,
+  paymentId: paymentIdSchemaField.optional().describe("Single MercadoLibre payment id to inspect."),
+  paymentIds: z.array(paymentIdSchemaField).min(1).max(MAX_PAYMENT_IDS).describe("One or more MercadoLibre payment ids to inspect in parallel (up to 250, processed in chunks of 50).").optional()
+}).superRefine((value, ctx) => {
+  const hasPaymentId = Boolean(value.paymentId);
+  const hasPaymentIds = Boolean(value.paymentIds?.length);
+  if (hasPaymentId === hasPaymentIds) {
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      message: "Provide exactly one of paymentId or paymentIds.",
+      path: ["paymentId"]
+    });
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      message: "Provide exactly one of paymentId or paymentIds.",
+      path: ["paymentIds"]
+    });
+  }
+});
+const paymentsSchema = [
+  "payment_id",
+  "status",
+  "status_detail",
+  "currency_id",
+  "transaction_amount",
+  "total_paid_amount",
+  "net_received_amount",
+  "overpaid_amount",
+  "payment_method_id",
+  "payment_type_id",
+  "installments",
+  "date_created",
+  "date_last_updated",
+  "description",
+  "order_id",
+  "payer_id",
+  "payer_email",
+  "payer_type",
+  "payer_first_name",
+  "payer_last_name",
+  "fee_count",
+  "fee_total",
+  "external_reference"
+];
+const paymentFeeDetailsSchema = ["payment_id", "fee_type", "fee_amount"];
+function createCurrencyTotals() {
+  return {
+    count: 0,
+    transaction_amount: 0,
+    total_paid_amount: 0,
+    net_received_amount: 0,
+    overpaid_amount: 0,
+    fee_total: 0
+  };
+}
+function incrementCounter(store, key) {
+  const normalizedKey = key.trim() || "UNKNOWN";
+  store[normalizedKey] = (store[normalizedKey] ?? 0) + 1;
+}
+function projectPayment(payment) {
+  const paymentId = normalizeScalarString(payment.id) || "";
+  const transactionDetails = asRecord(payment.transaction_details);
+  const payer = asRecord(payment.payer);
+  const order = asRecord(payment.order);
+  const feeDetails = asArray(payment.fee_details);
+  const currencyId = normalizeString(payment.currency_id, "UNKNOWN") || "UNKNOWN";
+  const status = normalizeString(payment.status, "UNKNOWN") || "UNKNOWN";
+  const paymentMethodId = normalizeScalarString(payment.payment_method_id) || normalizeScalarString(asRecord(payment.payment_method).id) || "UNKNOWN";
+  const paymentTypeId = normalizeString(payment.payment_type_id) || "UNKNOWN";
+  const transactionAmount = toNumber(payment.transaction_amount);
+  const totalPaidAmount = toNumber(transactionDetails.total_paid_amount ?? payment.total_paid_amount);
+  const netReceivedAmount = toNumber(transactionDetails.net_received_amount);
+  const overpaidAmount = toNumber(transactionDetails.overpaid_amount);
+  const feeTotal = roundMoney(feeDetails.reduce((accumulator, fee) => accumulator + toNumber(fee.amount), 0));
+  const dateCreated = compactDateTime(payment.date_created);
+  const dateLastUpdated = compactDateTime(payment.date_last_updated ?? payment.last_updated);
+  const description = normalizeString(payment.description);
+  const orderId = normalizeScalarString(order.id) || null;
+  const payerId = normalizeScalarString(payer.id) || null;
+  const payerEmail = normalizeString(payer.email);
+  const payerType = normalizeString(payer.type);
+  const payerFirstName = normalizeString(payer.first_name);
+  const payerLastName = normalizeString(payer.last_name);
+  const externalReference = normalizeString(transactionDetails.external_reference);
+  return {
+    row: [
+      paymentId || null,
+      normalizeString(payment.status) || null,
+      normalizeString(payment.status_detail) || null,
+      currencyId,
+      transactionAmount,
+      totalPaidAmount,
+      netReceivedAmount,
+      overpaidAmount,
+      paymentMethodId,
+      paymentTypeId,
+      toNumber(payment.installments),
+      dateCreated,
+      dateLastUpdated,
+      description || null,
+      orderId,
+      payerId,
+      payerEmail || null,
+      payerType || null,
+      payerFirstName || null,
+      payerLastName || null,
+      feeDetails.length,
+      feeTotal,
+      externalReference || null
+    ],
+    feeRows: feeDetails.map((fee) => [
+      paymentId || null,
+      normalizeString(fee.type) || null,
+      toNumber(fee.amount)
+    ]),
+    paymentId,
+    currencyId,
+    status,
+    paymentMethodId,
+    paymentTypeId,
+    hasOrder: Boolean(orderId),
+    hasPayer: Boolean(payerId || payerEmail),
+    feeTotal
+  };
+}
+function buildBreakdownEntries(store) {
+  const total = Object.values(store).reduce((accumulator, value) => accumulator + value, 0);
+  return Object.entries(store).map(([key, count]) => ({
+    key,
+    count,
+    rate: total > 0 ? roundMoney(count / total) : 0
+  })).sort((left, right) => right.count - left.count || left.key.localeCompare(right.key));
+}
+function buildCurrencyBreakdowns(store) {
+  return Object.entries(store).map(([currencyId, totals]) => ({
+    currency_id: currencyId,
+    count: totals.count,
+    transaction_amount: roundMoney(totals.transaction_amount),
+    total_paid_amount: roundMoney(totals.total_paid_amount),
+    net_received_amount: roundMoney(totals.net_received_amount),
+    overpaid_amount: roundMoney(totals.overpaid_amount),
+    fee_total: roundMoney(totals.fee_total)
+  })).sort((left, right) => right.count - left.count || left.currency_id.localeCompare(right.currency_id));
+}
+function buildAlerts(params) {
+  const alerts = [];
+  if (params.failedCount > 0) {
+    alerts.push(`${params.failedCount} payment${params.failedCount === 1 ? "" : "s"} failed to fetch.`);
+  }
+  if (params.successfulCount === 0 && params.failedCount > 0) {
+    alerts.push("No payments were successfully retrieved.");
+  }
+  if (params.paymentsWithoutOrderCount > 0) {
+    alerts.push(
+      `${params.paymentsWithoutOrderCount} payment${params.paymentsWithoutOrderCount === 1 ? "" : "s"} do not include an order reference.`
+    );
+  }
+  if (params.paymentsWithoutPayerCount > 0) {
+    alerts.push(
+      `${params.paymentsWithoutPayerCount} payment${params.paymentsWithoutPayerCount === 1 ? "" : "s"} are missing payer data.`
+    );
+  }
+  if (params.currenciesObserved.length > 1) {
+    alerts.push(`Multiple currencies detected: ${params.currenciesObserved.join(", ")}.`);
+  }
+  return alerts;
+}
+function buildPaymentPayload(params) {
+  const currencyTotals = {};
+  const statusCounts = {};
+  const paymentMethodCounts = {};
+  const paymentTypeCounts = {};
+  const payments = [];
+  const feeDetailRows = [];
+  let paymentsWithOrderCount = 0;
+  let paymentsWithoutOrderCount = 0;
+  let paymentsWithoutPayerCount = 0;
+  for (const projection of params.successful) {
+    payments.push(projection.row);
+    feeDetailRows.push(...projection.feeRows);
+    const currencyBucketTotals = currencyBucket(currencyTotals, projection.currencyId, createCurrencyTotals);
+    currencyBucketTotals.count += 1;
+    currencyBucketTotals.transaction_amount += projection.row[4] ? Number(projection.row[4]) : 0;
+    currencyBucketTotals.total_paid_amount += projection.row[5] ? Number(projection.row[5]) : 0;
+    currencyBucketTotals.net_received_amount += projection.row[6] ? Number(projection.row[6]) : 0;
+    currencyBucketTotals.overpaid_amount += projection.row[7] ? Number(projection.row[7]) : 0;
+    currencyBucketTotals.fee_total += projection.feeTotal;
+    incrementCounter(statusCounts, projection.status);
+    incrementCounter(paymentMethodCounts, projection.paymentMethodId);
+    incrementCounter(paymentTypeCounts, projection.paymentTypeId);
+    if (projection.hasOrder) {
+      paymentsWithOrderCount += 1;
+    } else {
+      paymentsWithoutOrderCount += 1;
+    }
+    if (!projection.hasPayer) {
+      paymentsWithoutPayerCount += 1;
+    }
+  }
+  const currenciesObserved = Object.keys(currencyTotals).sort((left, right) => left.localeCompare(right));
+  const summary = {
+    requested_count: params.requestedPaymentIds.length,
+    successful_count: params.successful.length,
+    failed_count: params.failed.length,
+    payments_with_order_count: paymentsWithOrderCount,
+    payments_without_order_count: paymentsWithoutOrderCount,
+    payments_without_payer_count: paymentsWithoutPayerCount,
+    currency_totals: Object.fromEntries(
+      Object.entries(currencyTotals).map(([currencyId, totals]) => [currencyId, stripNulls({
+        count: totals.count,
+        transaction_amount: roundMoney(totals.transaction_amount),
+        total_paid_amount: roundMoney(totals.total_paid_amount),
+        net_received_amount: roundMoney(totals.net_received_amount),
+        overpaid_amount: roundMoney(totals.overpaid_amount),
+        fee_total: roundMoney(totals.fee_total)
+      })])
+    ),
+    status_counts: statusCounts,
+    payment_method_counts: paymentMethodCounts,
+    payment_type_counts: paymentTypeCounts
+  };
+  const breakdowns = stripNulls({
+    by_currency: buildCurrencyBreakdowns(currencyTotals),
+    by_status: buildBreakdownEntries(statusCounts),
+    by_payment_method: buildBreakdownEntries(paymentMethodCounts),
+    by_payment_type: buildBreakdownEntries(paymentTypeCounts)
+  });
+  const alerts = buildAlerts({
+    successfulCount: params.successful.length,
+    failedCount: params.failed.length,
+    paymentsWithoutOrderCount,
+    paymentsWithoutPayerCount,
+    currenciesObserved
+  });
+  const payload = stripNulls({
+    metadata: {
+      profile_id: params.profileId,
+      endpoint: "/v1/payments/{payment_id}",
+      mode: params.requestedPaymentIds.length === 1 ? "single" : "batch",
+      requested_count: params.requestedPaymentIds.length,
+      successful_count: params.successful.length,
+      failed_count: params.failed.length,
+      coverage_complete: params.failed.length === 0,
+      requested_payment_ids: params.requestedPaymentIds,
+      successful_payment_ids: params.successful.map((entry) => entry.paymentId),
+      failed_payment_ids: params.failed.map((entry) => entry.paymentId)
+    },
+    summary,
+    breakdowns,
+    alerts,
+    failures: params.failed
+  });
+  return {
+    ...payload,
+    payments_schema: paymentsSchema,
+    payments,
+    payment_fee_details_schema: paymentFeeDetailsSchema,
+    payment_fee_details: feeDetailRows
+  };
+}
+async function meliGetPaymentDetailsHandler(params) {
+  try {
+    const profileResolution = await resolveMercadoLibreProfileOrSelection(params.profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const profileId = profileResolution.value.profileId;
+    if (params.paymentId) {
+      const payment = await getMercadoLibrePaymentDetails(profileId, params.paymentId);
+      const projected = projectPayment(payment);
+      return object(
+        buildPaymentPayload({
+          profileId,
+          requestedPaymentIds: [params.paymentId],
+          successful: [projected],
+          failed: []
+        })
+      );
+    }
+    const batch = await getMercadoLibrePaymentDetailsBatch(profileId, params.paymentIds ?? []);
+    return object(
+      buildPaymentPayload({
+        profileId,
+        requestedPaymentIds: params.paymentIds ?? [],
+        successful: batch.successful.map((entry) => projectPayment(entry.payment)),
+        failed: batch.failed
+      })
+    );
+  } catch (err) {
+    return error(formatMercadoLibreError(err, "Failed to fetch MercadoLibre payment details"));
+  }
+}
+export {
+  meliGetPaymentDetailsHandler,
+  meliGetPaymentDetailsSchema,
+  paymentFeeDetailsSchema,
+  paymentsSchema
+};
+//# sourceMappingURL=get-payment-details.js.map

package/dist/src/tools/mercadolibre/get-payment-details.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/mercadolibre/get-payment-details.ts"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { formatMercadoLibreError } from \"../../services/mercadolibre/mercadolibre-api.js\";\nimport {\n  getMercadoLibrePaymentDetails,\n  getMercadoLibrePaymentDetailsBatch,\n} from \"../../services/mercadolibre/mercadolibre-payments.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\nimport {\n  asArray,\n  asRecord,\n  compactDateTime,\n  currencyBucket,\n  normalizeScalarString,\n  normalizeString,\n  roundMoney,\n  toNumber,\n} from \"./helpers.js\";\nimport { resolveMercadoLibreProfileOrSelection } from \"./profile-resolution.js\";\nimport { mercadolibreProfileIdSchemaField } from \"./write-helpers.js\";\n\nconst MAX_PAYMENT_IDS = 250;\n\nconst paymentIdSchemaField = z\n  .string()\n  .trim()\n  .min(1)\n  .describe(\"MercadoLibre payment id to inspect.\");\n\nexport const meliGetPaymentDetailsSchema = z\n  .object({\n    profileId: mercadolibreProfileIdSchemaField,\n    paymentId: paymentIdSchemaField.optional().describe(\"Single MercadoLibre payment id to inspect.\"),\n    paymentIds: z\n      .array(paymentIdSchemaField)\n      .min(1)\n      .max(MAX_PAYMENT_IDS)\n      .describe(\"One or more MercadoLibre payment ids to inspect in parallel (up to 250, processed in chunks of 50).\")\n      .optional(),\n  })\n  .superRefine((value, ctx) => {\n    const hasPaymentId = Boolean(value.paymentId);\n    const hasPaymentIds = Boolean(value.paymentIds?.length);\n\n    if (hasPaymentId === hasPaymentIds) {\n      ctx.addIssue({\n        code: z.ZodIssueCode.custom,\n        message: \"Provide exactly one of paymentId or paymentIds.\",\n        path: [\"paymentId\"],\n      });\n      ctx.addIssue({\n        code: z.ZodIssueCode.custom,\n        message: \"Provide exactly one of paymentId or paymentIds.\",\n        path: [\"paymentIds\"],\n      });\n    }\n  });\n\nexport const paymentsSchema = [\n  \"payment_id\",\n  \"status\",\n  \"status_detail\",\n  \"currency_id\",\n  \"transaction_amount\",\n  \"total_paid_amount\",\n  \"net_received_amount\",\n  \"overpaid_amount\",\n  \"payment_method_id\",\n  \"payment_type_id\",\n  \"installments\",\n  \"date_created\",\n  \"date_last_updated\",\n  \"description\",\n  \"order_id\",\n  \"payer_id\",\n  \"payer_email\",\n  \"payer_type\",\n  \"payer_first_name\",\n  \"payer_last_name\",\n  \"fee_count\",\n  \"fee_total\",\n  \"external_reference\",\n] as const;\n\nexport const paymentFeeDetailsSchema = [\"payment_id\", \"fee_type\", \"fee_amount\"] as const;\n\ntype PaymentRow = (string | number | null)[];\ntype FeeRow = (string | number | null)[];\n\ntype PaymentProjection = {\n  row: PaymentRow;\n  feeRows: FeeRow[];\n  paymentId: string;\n  currencyId: string;\n  status: string;\n  paymentMethodId: string;\n  paymentTypeId: string;\n  hasOrder: boolean;\n  hasPayer: boolean;\n  feeTotal: number;\n};\n\ntype CurrencyTotals = {\n  count: number;\n  transaction_amount: number;\n  total_paid_amount: number;\n  net_received_amount: number;\n  overpaid_amount: number;\n  fee_total: number;\n};\n\nfunction createCurrencyTotals(): CurrencyTotals {\n  return {\n    count: 0,\n    transaction_amount: 0,\n    total_paid_amount: 0,\n    net_received_amount: 0,\n    overpaid_amount: 0,\n    fee_total: 0,\n  };\n}\n\nfunction incrementCounter(store: Record<string, number>, key: string): void {\n  const normalizedKey = key.trim() || \"UNKNOWN\";\n  store[normalizedKey] = (store[normalizedKey] ?? 0) + 1;\n}\n\nfunction projectPayment(payment: Record<string, unknown>): PaymentProjection {\n  const paymentId = normalizeScalarString(payment.id) || \"\";\n  const transactionDetails = asRecord(payment.transaction_details);\n  const payer = asRecord(payment.payer);\n  const order = asRecord(payment.order);\n  const feeDetails = asArray<Record<string, unknown>>(payment.fee_details);\n  const currencyId = normalizeString(payment.currency_id, \"UNKNOWN\") || \"UNKNOWN\";\n  const status = normalizeString(payment.status, \"UNKNOWN\") || \"UNKNOWN\";\n  const paymentMethodId =\n    normalizeScalarString(payment.payment_method_id) || normalizeScalarString(asRecord(payment.payment_method).id) || \"UNKNOWN\";\n  const paymentTypeId = normalizeString(payment.payment_type_id) || \"UNKNOWN\";\n  const transactionAmount = toNumber(payment.transaction_amount);\n  const totalPaidAmount = toNumber(transactionDetails.total_paid_amount ?? payment.total_paid_amount);\n  const netReceivedAmount = toNumber(transactionDetails.net_received_amount);\n  const overpaidAmount = toNumber(transactionDetails.overpaid_amount);\n  const feeTotal = roundMoney(feeDetails.reduce((accumulator, fee) => accumulator + toNumber(fee.amount), 0));\n  const dateCreated = compactDateTime(payment.date_created);\n  const dateLastUpdated = compactDateTime(payment.date_last_updated ?? payment.last_updated);\n  const description = normalizeString(payment.description);\n  const orderId = normalizeScalarString(order.id) || null;\n  const payerId = normalizeScalarString(payer.id) || null;\n  const payerEmail = normalizeString(payer.email);\n  const payerType = normalizeString(payer.type);\n  const payerFirstName = normalizeString(payer.first_name);\n  const payerLastName = normalizeString(payer.last_name);\n  const externalReference = normalizeString(transactionDetails.external_reference);\n\n  return {\n    row: [\n      paymentId || null,\n      normalizeString(payment.status) || null,\n      normalizeString(payment.status_detail) || null,\n      currencyId,\n      transactionAmount,\n      totalPaidAmount,\n      netReceivedAmount,\n      overpaidAmount,\n      paymentMethodId,\n      paymentTypeId,\n      toNumber(payment.installments),\n      dateCreated,\n      dateLastUpdated,\n      description || null,\n      orderId,\n      payerId,\n      payerEmail || null,\n      payerType || null,\n      payerFirstName || null,\n      payerLastName || null,\n      feeDetails.length,\n      feeTotal,\n      externalReference || null,\n    ],\n    feeRows: feeDetails.map((fee) => [\n      paymentId || null,\n      normalizeString(fee.type) || null,\n      toNumber(fee.amount),\n    ]),\n    paymentId,\n    currencyId,\n    status,\n    paymentMethodId,\n    paymentTypeId,\n    hasOrder: Boolean(orderId),\n    hasPayer: Boolean(payerId || payerEmail),\n    feeTotal,\n  };\n}\n\nfunction buildBreakdownEntries(store: Record<string, number>) {\n  const total = Object.values(store).reduce((accumulator, value) => accumulator + value, 0);\n\n  return Object.entries(store)\n    .map(([key, count]) => ({\n      key,\n      count,\n      rate: total > 0 ? roundMoney(count / total) : 0,\n    }))\n    .sort((left, right) => right.count - left.count || left.key.localeCompare(right.key));\n}\n\nfunction buildCurrencyBreakdowns(store: Record<string, CurrencyTotals>) {\n  return Object.entries(store)\n    .map(([currencyId, totals]) => ({\n      currency_id: currencyId,\n      count: totals.count,\n      transaction_amount: roundMoney(totals.transaction_amount),\n      total_paid_amount: roundMoney(totals.total_paid_amount),\n      net_received_amount: roundMoney(totals.net_received_amount),\n      overpaid_amount: roundMoney(totals.overpaid_amount),\n      fee_total: roundMoney(totals.fee_total),\n    }))\n    .sort((left, right) => right.count - left.count || left.currency_id.localeCompare(right.currency_id));\n}\n\nfunction buildAlerts(params: {\n  successfulCount: number;\n  failedCount: number;\n  paymentsWithoutOrderCount: number;\n  paymentsWithoutPayerCount: number;\n  currenciesObserved: string[];\n}): string[] {\n  const alerts: string[] = [];\n\n  if (params.failedCount > 0) {\n    alerts.push(`${params.failedCount} payment${params.failedCount === 1 ? \"\" : \"s\"} failed to fetch.`);\n  }\n\n  if (params.successfulCount === 0 && params.failedCount > 0) {\n    alerts.push(\"No payments were successfully retrieved.\");\n  }\n\n  if (params.paymentsWithoutOrderCount > 0) {\n    alerts.push(\n      `${params.paymentsWithoutOrderCount} payment${params.paymentsWithoutOrderCount === 1 ? \"\" : \"s\"} do not include an order reference.`\n    );\n  }\n\n  if (params.paymentsWithoutPayerCount > 0) {\n    alerts.push(\n      `${params.paymentsWithoutPayerCount} payment${params.paymentsWithoutPayerCount === 1 ? \"\" : \"s\"} are missing payer data.`\n    );\n  }\n\n  if (params.currenciesObserved.length > 1) {\n    alerts.push(`Multiple currencies detected: ${params.currenciesObserved.join(\", \")}.`);\n  }\n\n  return alerts;\n}\n\nfunction buildPaymentPayload(params: {\n  profileId: string;\n  requestedPaymentIds: string[];\n  successful: PaymentProjection[];\n  failed: Array<{\n    paymentId: string;\n    message: string;\n    statusCode?: number;\n    attempts: number;\n    retryable: boolean;\n  }>;\n}) {\n  const currencyTotals: Record<string, CurrencyTotals> = {};\n  const statusCounts: Record<string, number> = {};\n  const paymentMethodCounts: Record<string, number> = {};\n  const paymentTypeCounts: Record<string, number> = {};\n  const payments: PaymentRow[] = [];\n  const feeDetailRows: FeeRow[] = [];\n  let paymentsWithOrderCount = 0;\n  let paymentsWithoutOrderCount = 0;\n  let paymentsWithoutPayerCount = 0;\n\n  for (const projection of params.successful) {\n    payments.push(projection.row);\n    feeDetailRows.push(...projection.feeRows);\n\n    const currencyBucketTotals = currencyBucket(currencyTotals, projection.currencyId, createCurrencyTotals);\n    currencyBucketTotals.count += 1;\n    currencyBucketTotals.transaction_amount += projection.row[4] ? Number(projection.row[4]) : 0;\n    currencyBucketTotals.total_paid_amount += projection.row[5] ? Number(projection.row[5]) : 0;\n    currencyBucketTotals.net_received_amount += projection.row[6] ? Number(projection.row[6]) : 0;\n    currencyBucketTotals.overpaid_amount += projection.row[7] ? Number(projection.row[7]) : 0;\n    currencyBucketTotals.fee_total += projection.feeTotal;\n\n    incrementCounter(statusCounts, projection.status);\n    incrementCounter(paymentMethodCounts, projection.paymentMethodId);\n    incrementCounter(paymentTypeCounts, projection.paymentTypeId);\n\n    if (projection.hasOrder) {\n      paymentsWithOrderCount += 1;\n    } else {\n      paymentsWithoutOrderCount += 1;\n    }\n\n    if (!projection.hasPayer) {\n      paymentsWithoutPayerCount += 1;\n    }\n  }\n\n  const currenciesObserved = Object.keys(currencyTotals).sort((left, right) => left.localeCompare(right));\n  const summary = {\n    requested_count: params.requestedPaymentIds.length,\n    successful_count: params.successful.length,\n    failed_count: params.failed.length,\n    payments_with_order_count: paymentsWithOrderCount,\n    payments_without_order_count: paymentsWithoutOrderCount,\n    payments_without_payer_count: paymentsWithoutPayerCount,\n    currency_totals: Object.fromEntries(\n      Object.entries(currencyTotals).map(([currencyId, totals]) => [currencyId, stripNulls({\n        count: totals.count,\n        transaction_amount: roundMoney(totals.transaction_amount),\n        total_paid_amount: roundMoney(totals.total_paid_amount),\n        net_received_amount: roundMoney(totals.net_received_amount),\n        overpaid_amount: roundMoney(totals.overpaid_amount),\n        fee_total: roundMoney(totals.fee_total),\n      })])\n    ),\n    status_counts: statusCounts,\n    payment_method_counts: paymentMethodCounts,\n    payment_type_counts: paymentTypeCounts,\n  };\n\n  const breakdowns = stripNulls({\n    by_currency: buildCurrencyBreakdowns(currencyTotals),\n    by_status: buildBreakdownEntries(statusCounts),\n    by_payment_method: buildBreakdownEntries(paymentMethodCounts),\n    by_payment_type: buildBreakdownEntries(paymentTypeCounts),\n  });\n\n  const alerts = buildAlerts({\n    successfulCount: params.successful.length,\n    failedCount: params.failed.length,\n    paymentsWithoutOrderCount,\n    paymentsWithoutPayerCount,\n    currenciesObserved,\n  });\n\n  const payload = stripNulls({\n    metadata: {\n      profile_id: params.profileId,\n      endpoint: \"/v1/payments/{payment_id}\",\n      mode: params.requestedPaymentIds.length === 1 ? \"single\" : \"batch\",\n      requested_count: params.requestedPaymentIds.length,\n      successful_count: params.successful.length,\n      failed_count: params.failed.length,\n      coverage_complete: params.failed.length === 0,\n      requested_payment_ids: params.requestedPaymentIds,\n      successful_payment_ids: params.successful.map((entry) => entry.paymentId),\n      failed_payment_ids: params.failed.map((entry) => entry.paymentId),\n    },\n    summary,\n    breakdowns,\n    alerts,\n    failures: params.failed,\n  });\n\n  // Attach compact positional blocks after stripping nullish metadata so row length stays aligned.\n  return {\n    ...payload,\n    payments_schema: paymentsSchema,\n    payments,\n    payment_fee_details_schema: paymentFeeDetailsSchema,\n    payment_fee_details: feeDetailRows,\n  };\n}\n\nexport async function meliGetPaymentDetailsHandler(\n  params: z.infer<typeof meliGetPaymentDetailsSchema>\n) {\n  try {\n    const profileResolution = await resolveMercadoLibreProfileOrSelection(params.profileId);\n    if (!profileResolution.ok) {\n      return profileResolution.response;\n    }\n\n    const profileId = profileResolution.value.profileId;\n\n    if (params.paymentId) {\n      const payment = await getMercadoLibrePaymentDetails(profileId, params.paymentId);\n      const projected = projectPayment(payment);\n\n      return object(\n        buildPaymentPayload({\n          profileId,\n          requestedPaymentIds: [params.paymentId],\n          successful: [projected],\n          failed: [],\n        })\n      );\n    }\n\n    const batch = await getMercadoLibrePaymentDetailsBatch(profileId, params.paymentIds ?? []);\n\n    return object(\n      buildPaymentPayload({\n        profileId,\n        requestedPaymentIds: params.paymentIds ?? [],\n        successful: batch.successful.map((entry) => projectPayment(entry.payment)),\n        failed: batch.failed,\n      })\n    );\n  } catch (err) {\n    return error(formatMercadoLibreError(err, \"Failed to fetch MercadoLibre payment details\"));\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/tools/mercadolibre/index.js

@@ -2,6 +2,7 @@ export * from "./get-account-context.js";
 export * from "./validate-connection.js";
 export * from "./get-orders-summary.js";
 export * from "./get-order-details.js";
+export * from "./get-payment-details.js";
 export * from "./get-sales-by-item.js";
 export * from "./get-sales-trend.js";
 export * from "./get-shipping-summary.js";
@@ -24,4 +25,23 @@ export * from "./answer-question.js";
 export * from "./profile-resolution.js";
 export * from "./get-site-categories-and-listing-types.js";
 export * from "./get-billing-provisions-summary.js";
+import {
+  meliGetBillingProvisionsByOrderHandler,
+  meliGetBillingProvisionsByOrderSchema,
+  ordersSchema,
+  paymentInfoSchema,
+  detailsSchema,
+  detailsSalesSchema,
+  detailsItemsSchema
+} from "./get-billing-provisions-by-order.js";
+export * from "./get-full-storage-charges.js";
+export {
+  detailsItemsSchema as billingProvisionsByOrderDetailsItemsSchema,
+  detailsSalesSchema as billingProvisionsByOrderDetailsSalesSchema,
+  detailsSchema as billingProvisionsByOrderDetailsSchema,
+  meliGetBillingProvisionsByOrderHandler,
+  meliGetBillingProvisionsByOrderSchema,
+  ordersSchema,
+  paymentInfoSchema
+};
 //# sourceMappingURL=index.js.map

package/dist/src/tools/mercadolibre/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/mercadolibre/index.ts"],
-  "sourcesContent": ["export * from \"./get-account-context.js\";\nexport * from \"./validate-connection.js\";\nexport * from \"./get-orders-summary.js\";\nexport * from \"./get-order-details.js\";\nexport * from \"./get-sales-by-item.js\";\nexport * from \"./get-sales-trend.js\";\nexport * from \"./get-shipping-summary.js\";\nexport * from \"./get-item-visits.js\";\nexport * from \"./get-store-performance.js\";\nexport * from \"./search-items.js\";\nexport * from \"./get-item-details.js\";\nexport * from \"./get-listing-quality.js\";\nexport * from \"./predict-category.js\";\nexport * from \"./get-category-requirements.js\";\nexport * from \"./estimate-listing-fee.js\";\nexport * from \"./estimate-product-profitability.js\";\nexport * from \"./create-item.js\";\nexport * from \"./update-item-basic-fields.js\";\nexport * from \"./update-item-description.js\";\nexport * from \"./update-item-pictures.js\";\nexport * from \"./pause-or-reactivate-item.js\";\nexport * from \"./search-questions.js\";\nexport * from \"./answer-question.js\";\nexport * from \"./profile-resolution.js\";\nexport * from \"./get-site-categories-and-listing-types.js\";\nexport * from \"./get-billing-provisions-summary.js\";\n"],
-  "mappings": "AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "sourcesContent": ["export * from \"./get-account-context.js\";\nexport * from \"./validate-connection.js\";\nexport * from \"./get-orders-summary.js\";\nexport * from \"./get-order-details.js\";\nexport * from \"./get-payment-details.js\";\nexport * from \"./get-sales-by-item.js\";\nexport * from \"./get-sales-trend.js\";\nexport * from \"./get-shipping-summary.js\";\nexport * from \"./get-item-visits.js\";\nexport * from \"./get-store-performance.js\";\nexport * from \"./search-items.js\";\nexport * from \"./get-item-details.js\";\nexport * from \"./get-listing-quality.js\";\nexport * from \"./predict-category.js\";\nexport * from \"./get-category-requirements.js\";\nexport * from \"./estimate-listing-fee.js\";\nexport * from \"./estimate-product-profitability.js\";\nexport * from \"./create-item.js\";\nexport * from \"./update-item-basic-fields.js\";\nexport * from \"./update-item-description.js\";\nexport * from \"./update-item-pictures.js\";\nexport * from \"./pause-or-reactivate-item.js\";\nexport * from \"./search-questions.js\";\nexport * from \"./answer-question.js\";\nexport * from \"./profile-resolution.js\";\nexport * from \"./get-site-categories-and-listing-types.js\";\nexport * from \"./get-billing-provisions-summary.js\";\nexport {\n  meliGetBillingProvisionsByOrderHandler,\n  meliGetBillingProvisionsByOrderSchema,\n  ordersSchema,\n  paymentInfoSchema,\n  detailsSchema as billingProvisionsByOrderDetailsSchema,\n  detailsSalesSchema as billingProvisionsByOrderDetailsSalesSchema,\n  detailsItemsSchema as billingProvisionsByOrderDetailsItemsSchema,\n} from \"./get-billing-provisions-by-order.js\";\nexport * from \"./get-full-storage-charges.js\";\n"],
+  "mappings": "AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACiB;AAAA,EACK;AAAA,EACA;AAAA,OACjB;AACP,cAAc;",
   "names": []
 }

package/dist/tests/meli/mercadolibre-billing-provisions.test.js

@@ -30,8 +30,18 @@ vi.mock("../../src/tools/mercadolibre/profile-resolution.js", () => ({
 import {
   getMercadoLibreBillingProvisionPage,
   getMercadoLibreBillingProvisions,
+  getMercadoLibreBillingProvisionsByOrder,
   scopeToGroupPath
 } from "../../src/services/mercadolibre/mercadolibre-billing.js";
+import {
+  meliGetBillingProvisionsByOrderHandler,
+  meliGetBillingProvisionsByOrderSchema,
+  ordersSchema,
+  paymentInfoSchema,
+  detailsSchema as byOrderDetailsSchema,
+  detailsSalesSchema as byOrderDetailsSalesSchema,
+  detailsItemsSchema as byOrderDetailsItemsSchema
+} from "../../src/tools/mercadolibre/get-billing-provisions-by-order.js";
 import {
   meliGetBillingProvisionsSummaryHandler,
   meliGetBillingProvisionsSummarySchema,
@@ -145,6 +155,7 @@ describe("getMercadoLibreBillingProvisionPage", () => {
     expect(p.marketplace_type).toBe("classic");
     expect(p.order_ids).toBe("O1");
     expect(p.item_ids).toBe("I1");
+    expect(p.site_id).toBeUndefined();
   });
   it("reads flat total/limit from real MELI envelope (no paging nesting)", async () => {
     axiosGetMock.mockResolvedValue({
@@ -235,6 +246,171 @@ describe("getMercadoLibreBillingProvisions", () => {
     expect(result.coverage_complete).toBe(true);
   });
 });
+describe("meliGetBillingProvisionsByOrderHandler", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    vi.mocked(resolveProfileMock).mockResolvedValue({
+      ok: true,
+      value: { profileId: "meli-profile-1" }
+    });
+  });
+  it("requires profileId and at least one orderId", () => {
+    expect(
+      () => meliGetBillingProvisionsByOrderSchema.parse({ orderIds: ["O1"] })
+    ).toThrow();
+    expect(
+      () => meliGetBillingProvisionsByOrderSchema.parse({ profileId: "profile-1", orderIds: ["O1"] })
+    ).not.toThrow();
+  });
+  function officialOrderRow(overrides = {}) {
+    const paymentInfo = overrides.payment_info ?? {};
+    const details = overrides.details;
+    return {
+      order_id: overrides.order_id ?? `ORD-${Math.random().toString(36).slice(2, 8)}`,
+      sale_fee: overrides.sale_fee ?? 12.34,
+      document_id: overrides.document_id ?? "DOC-1",
+      currency_id: overrides.currency_id ?? "ARS",
+      marketplace: overrides.marketplace ?? "MELI",
+      payment_info: {
+        payment_id: paymentInfo.payment_id ?? "PAY-1",
+        payment_type: paymentInfo.payment_type ?? "credit_card",
+        payment_method_id: paymentInfo.payment_method_id ?? "visa",
+        installments: paymentInfo.installments ?? 1,
+        transaction_amount: paymentInfo.transaction_amount ?? 100,
+        total_paid_amount: paymentInfo.total_paid_amount ?? 100,
+        shipping_cost: paymentInfo.shipping_cost ?? 0,
+        coupon_amount: paymentInfo.coupon_amount ?? 0,
+        status: paymentInfo.status ?? "approved",
+        status_detail: paymentInfo.status_detail ?? "accredited",
+        ...paymentInfo
+      },
+      details: details ?? [
+        {
+          detail_id: "detail-1",
+          detail_type: "sale",
+          detail_sub_type: "sale",
+          transaction_detail: "Cargo por vender",
+          detail_amount: 12.34,
+          currency_id: "ARS",
+          concept_type: "sale",
+          operation_id: "OP-1",
+          shipping_id: "SHIP-1",
+          pack_id: "PACK-1",
+          inventory_id: "INV-1",
+          sales_info: [
+            {
+              order_id: overrides.order_id ?? "ORD-1",
+              operation_id: "OP-1",
+              sale_date_time: "2026-06-01T10:00:00Z",
+              payer_nickname: "buyer-1",
+              transaction_amount: 100
+            }
+          ],
+          items_info: [
+            {
+              item_id: "ITEM-1",
+              item_title: "Producto 1",
+              item_amount: 1,
+              item_price: 100,
+              item_kit_id: null,
+              store_id: "STORE-1",
+              order_id: overrides.order_id ?? "ORD-1"
+            }
+          ]
+        }
+      ],
+      ...overrides
+    };
+  }
+  it("uses the official order details endpoint without site_id and chunks at 60 IDs", async () => {
+    axiosGetMock.mockResolvedValueOnce({ data: { results: [officialOrderRow({ order_id: "O1" })], total: 1, limit: 60 } }).mockResolvedValueOnce({ data: { results: [officialOrderRow({ order_id: "O61" })], total: 1, limit: 1 } });
+    const orderIds = Array.from({ length: 61 }, (_, index) => `O${index + 1}`);
+    const result = await getMercadoLibreBillingProvisionsByOrder("profile-1", {
+      orderIds
+    });
+    expect(axiosGetMock).toHaveBeenCalledTimes(2);
+    expect(axiosGetMock.mock.calls[0][0]).toBe("/billing/integration/group/ML/order/details");
+    expect(axiosGetMock.mock.calls[0][1]).toEqual({ params: { order_ids: orderIds.slice(0, 60).join(",") } });
+    expect(axiosGetMock.mock.calls[1][1]).toEqual({ params: { order_ids: ["O61"].join(",") } });
+    expect(result.chunks_total).toBe(2);
+    expect(result.chunks_succeeded).toBe(2);
+    expect(result.chunks_failed).toBe(0);
+    expect(result.order_ids_found).toEqual(["O1", "O61"]);
+    expect(result.order_ids_not_found).toEqual(orderIds.filter((id) => !["O1", "O61"].includes(id)));
+  });
+  it("deduplicates found order ids from the official per-order payload", async () => {
+    axiosGetMock.mockResolvedValue({
+      data: {
+        results: [
+          officialOrderRow({
+            order_id: "O1",
+            details: [
+              {
+                detail_id: "detail-1",
+                sales_info: [
+                  { order_id: "O1", operation_id: "OP-1", sale_date_time: "2026-06-01T10:00:00Z", payer_nickname: "buyer-1", transaction_amount: 100 }
+                ],
+                items_info: [
+                  { item_id: "ITEM-1", item_title: "Producto 1", item_amount: 1, item_price: 100, order_id: "O1" }
+                ]
+              }
+            ]
+          })
+        ],
+        total: 1,
+        limit: 60
+      }
+    });
+    const result = await getMercadoLibreBillingProvisionsByOrder("profile-1", {
+      orderIds: ["O1", "O2"]
+    });
+    expect(result.results).toHaveLength(1);
+    expect(result.order_ids_found).toEqual(["O1"]);
+    expect(result.order_ids_not_found).toEqual(["O2"]);
+    expect(result.coverage_complete).toBe(true);
+  });
+  it("returns the compact order, payment and detail blocks from the official payload", async () => {
+    axiosGetMock.mockResolvedValue({
+      data: {
+        results: [officialOrderRow({ order_id: "O1", sale_fee: null })],
+        total: 1,
+        limit: 60
+      }
+    });
+    const result = await meliGetBillingProvisionsByOrderHandler({
+      profileId: "profile-1",
+      orderIds: ["O1"]
+    });
+    expect(result).toHaveProperty("kind", "object");
+    const payload = result.payload;
+    expect(payload.profile_id).toBe("meli-profile-1");
+    expect(payload.endpoint).toBe("/billing/integration/group/ML/order/details");
+    expect(payload.orders_schema).toEqual(ordersSchema);
+    expect(payload.payment_info_schema).toEqual(paymentInfoSchema);
+    expect(payload.details_schema).toEqual(byOrderDetailsSchema);
+    expect(payload.details_sales_schema).toEqual(byOrderDetailsSalesSchema);
+    expect(payload.details_items_schema).toEqual(byOrderDetailsItemsSchema);
+    const orders = payload.orders;
+    const paymentInfo = payload.payment_info;
+    const details = payload.details;
+    const detailsSales = payload.details_sales;
+    const detailsItems = payload.details_items;
+    expect(orders).toHaveLength(1);
+    expect(orders[0][0]).toBe("O1");
+    expect(orders[0][1]).toBeNull();
+    expect(paymentInfo).toHaveLength(1);
+    expect(paymentInfo[0][0]).toBe("O1");
+    expect(details).toHaveLength(1);
+    expect(details[0][0]).toBe("O1");
+    expect(detailsSales).toHaveLength(1);
+    expect(detailsItems).toHaveLength(1);
+    const metadata = payload.metadata;
+    expect(metadata.order_ids_requested).toEqual(["O1"]);
+    expect(metadata.order_ids_found).toEqual(["O1"]);
+    expect(metadata.order_ids_not_found).toEqual([]);
+    expect(metadata.coverage_complete).toBe(true);
+  });
+});
 describe("meliGetBillingProvisionsSummaryHandler", () => {
   beforeEach(() => {
     vi.clearAllMocks();