ebay-mcp 1.4.3

package/build/api/order-management/dispute.js

@@ -0,0 +1,69 @@
+/**
+ * Dispute API - Manage payment disputes
+ * Based on: docs/sell-apps/order-management/sell_fulfillment_v1_oas3.json
+ */
+export class DisputeApi {
+    client;
+    basePath = '/sell/fulfillment/v1';
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get payment dispute details
+     */
+    async getPaymentDispute(paymentDisputeId) {
+        return await this.client.get(`${this.basePath}/payment_dispute/${paymentDisputeId}`);
+    }
+    /**
+     * Get payment dispute evidence file
+     */
+    async fetchEvidenceContent(paymentDisputeId, evidenceId, fileId) {
+        const params = {
+            evidence_id: evidenceId,
+            file_id: fileId,
+        };
+        return await this.client.get(`${this.basePath}/payment_dispute/${paymentDisputeId}/fetch_evidence_content`, params);
+    }
+    /**
+     * Get payment dispute activity
+     */
+    async getActivities(paymentDisputeId) {
+        return await this.client.get(`${this.basePath}/payment_dispute/${paymentDisputeId}/activity`);
+    }
+    /**
+     * Search for payment disputes
+     */
+    async getPaymentDisputeSummaries(params) {
+        return await this.client.get(`${this.basePath}/payment_dispute_summary`, params);
+    }
+    /**
+     * Contest a payment dispute
+     */
+    async contestPaymentDispute(paymentDisputeId, body) {
+        return await this.client.post(`${this.basePath}/payment_dispute/${paymentDisputeId}/contest`, body);
+    }
+    /**
+     * Accept a payment dispute
+     */
+    async acceptPaymentDispute(paymentDisputeId, body) {
+        return await this.client.post(`${this.basePath}/payment_dispute/${paymentDisputeId}/accept`, body);
+    }
+    /**
+     * Upload an evidence file
+     */
+    async uploadEvidenceFile(paymentDisputeId, body) {
+        return await this.client.post(`${this.basePath}/payment_dispute/${paymentDisputeId}/upload_evidence_file`, body, { headers: { 'Content-Type': 'multipart/form-data' } });
+    }
+    /**
+     * Add an evidence file
+     */
+    async addEvidence(paymentDisputeId, body) {
+        return await this.client.post(`${this.basePath}/payment_dispute/${paymentDisputeId}/add_evidence`, body);
+    }
+    /**
+     * Update an evidence file
+     */
+    async updateEvidence(paymentDisputeId, body) {
+        return await this.client.post(`${this.basePath}/payment_dispute/${paymentDisputeId}/update_evidence`, body);
+    }
+}

package/build/api/order-management/fulfillment.d.ts

@@ -0,0 +1,80 @@
+import type { components } from '../../types/sell-apps/order-management/sellFulfillmentV1Oas3.js';
+import type { EbayApiClient } from '../client.js';
+type IssueRefundRequest = components['schemas']['IssueRefundRequest'];
+type ShippingFulfillmentDetails = components['schemas']['ShippingFulfillmentDetails'];
+type Order = components['schemas']['Order'];
+type OrderSearchPagedCollection = components['schemas']['OrderSearchPagedCollection'];
+type Refund = components['schemas']['Refund'];
+type ShippingFulfillment = components['schemas']['ShippingFulfillment'];
+type ShippingFulfillmentPagedCollection = components['schemas']['ShippingFulfillmentPagedCollection'];
+/**
+ * Fulfillment API - Order processing and shipping
+ * Based on: docs/sell-apps/order-management/sell_fulfillment_v1_oas3.json
+ */
+export declare class FulfillmentApi {
+    private client;
+    private readonly basePath;
+    constructor(client: EbayApiClient);
+    /**
+     * Get orders for the seller
+     */
+    getOrders(filter?: string, limit?: number, offset?: number): Promise<OrderSearchPagedCollection>;
+    /**
+     * Get a specific order
+     */
+    getOrder(orderId: string): Promise<Order>;
+    /**
+     * Create a shipping fulfillment
+     */
+    createShippingFulfillment(orderId: string, fulfillment: ShippingFulfillmentDetails): Promise<void>;
+    /**
+     * Get shipping fulfillments for an order
+     */
+    getShippingFulfillments(orderId: string): Promise<ShippingFulfillmentPagedCollection>;
+    /**
+     * Get a specific shipping fulfillment
+     * @param orderId The unique identifier of the order.
+     * @param fulfillmentId The unique identifier of the fulfillment.
+     */
+    getShippingFulfillment(orderId: string, fulfillmentId: string): Promise<ShippingFulfillment>;
+    /**
+     * Issue a refund
+     */
+    issueRefund(orderId: string, refund: IssueRefundRequest): Promise<Refund>;
+    /**
+     * Get payment dispute summaries
+     * Note: This method delegates to the DisputeApi
+     */
+    getPaymentDisputeSummaries(params?: {
+        order_id?: string;
+        buyer_username?: string;
+        open_date_from?: string;
+        open_date_to?: string;
+        payment_dispute_status?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<unknown>;
+    /**
+     * Get payment dispute activities
+     * Note: This method delegates to the DisputeApi
+     */
+    getActivities(paymentDisputeId: string): Promise<unknown>;
+    /**
+     * Get payment dispute details
+     * Note: This method delegates to the DisputeApi
+     */
+    getPaymentDispute(paymentDisputeId: string): Promise<unknown>;
+    /**
+     * Get shipping quote
+     */
+    getShippingQuote(request: {
+        rateTableId?: string;
+        shippingAddress?: unknown;
+        lineItems?: unknown[];
+    }): Promise<unknown>;
+    /**
+     * Get cancellation details for an order
+     */
+    getCancellation(orderId: string, cancellationId: string): Promise<unknown>;
+}
+export {};

package/build/api/order-management/fulfillment.js

@@ -0,0 +1,89 @@
+/**
+ * Fulfillment API - Order processing and shipping
+ * Based on: docs/sell-apps/order-management/sell_fulfillment_v1_oas3.json
+ */
+export class FulfillmentApi {
+    client;
+    basePath = '/sell/fulfillment/v1';
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get orders for the seller
+     */
+    async getOrders(filter, limit, offset) {
+        const params = {};
+        if (filter)
+            params.filter = filter;
+        if (limit)
+            params.limit = limit;
+        if (offset)
+            params.offset = offset;
+        return await this.client.get(`${this.basePath}/order`, params);
+    }
+    /**
+     * Get a specific order
+     */
+    async getOrder(orderId) {
+        return await this.client.get(`${this.basePath}/order/${orderId}`);
+    }
+    /**
+     * Create a shipping fulfillment
+     */
+    async createShippingFulfillment(orderId, fulfillment) {
+        return await this.client.post(`${this.basePath}/order/${orderId}/shipping_fulfillment`, fulfillment);
+    }
+    /**
+     * Get shipping fulfillments for an order
+     */
+    async getShippingFulfillments(orderId) {
+        return await this.client.get(`${this.basePath}/order/${orderId}/shipping_fulfillment`);
+    }
+    /**
+     * Get a specific shipping fulfillment
+     * @param orderId The unique identifier of the order.
+     * @param fulfillmentId The unique identifier of the fulfillment.
+     */
+    async getShippingFulfillment(orderId, fulfillmentId) {
+        return await this.client.get(`${this.basePath}/order/${orderId}/shipping_fulfillment/${fulfillmentId}`);
+    }
+    /**
+     * Issue a refund
+     */
+    async issueRefund(orderId, refund) {
+        return await this.client.post(`${this.basePath}/order/${orderId}/issue_refund`, refund);
+    }
+    /**
+     * Get payment dispute summaries
+     * Note: This method delegates to the DisputeApi
+     */
+    async getPaymentDisputeSummaries(params) {
+        return await this.client.get(`${this.basePath}/payment_dispute_summary`, params);
+    }
+    /**
+     * Get payment dispute activities
+     * Note: This method delegates to the DisputeApi
+     */
+    async getActivities(paymentDisputeId) {
+        return await this.client.get(`${this.basePath}/payment_dispute/${paymentDisputeId}/activity`);
+    }
+    /**
+     * Get payment dispute details
+     * Note: This method delegates to the DisputeApi
+     */
+    async getPaymentDispute(paymentDisputeId) {
+        return await this.client.get(`${this.basePath}/payment_dispute/${paymentDisputeId}`);
+    }
+    /**
+     * Get shipping quote
+     */
+    async getShippingQuote(request) {
+        return await this.client.post(`${this.basePath}/shipping_quote`, request);
+    }
+    /**
+     * Get cancellation details for an order
+     */
+    async getCancellation(orderId, cancellationId) {
+        return await this.client.get(`${this.basePath}/order/${orderId}/cancellation/${cancellationId}`);
+    }
+}

package/build/api/other/compliance.d.ts

@@ -0,0 +1,26 @@
+import type { EbayApiClient } from '../client.js';
+/**
+ * Compliance API - Listing compliance checks
+ * Based on: docs/sell-apps/other-apis/sell_compliance_v1_oas3.json
+ */
+export declare class ComplianceApi {
+    private client;
+    private readonly basePath;
+    constructor(client: EbayApiClient);
+    /**
+     * Get listing violations
+     */
+    getListingViolations(complianceType?: string, offset?: number, limit?: number): Promise<unknown>;
+    /**
+     * Get listing violation summary
+     */
+    getListingViolationsSummary(complianceType?: string): Promise<unknown>;
+    /**
+     * Suppress a violation
+     */
+    suppressViolation(listingViolationId: string): Promise<unknown>;
+    /**
+     * Get compliance snapshot (alias for getListingViolations)
+     */
+    getComplianceSnapshot(complianceType?: string, offset?: number, limit?: number): Promise<unknown>;
+}

package/build/api/other/compliance.js

@@ -0,0 +1,47 @@
+/**
+ * Compliance API - Listing compliance checks
+ * Based on: docs/sell-apps/other-apis/sell_compliance_v1_oas3.json
+ */
+export class ComplianceApi {
+    client;
+    basePath = '/sell/compliance/v1';
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get listing violations
+     */
+    async getListingViolations(complianceType, offset, limit) {
+        const params = {};
+        if (complianceType)
+            params.compliance_type = complianceType;
+        if (offset)
+            params.offset = offset;
+        if (limit)
+            params.limit = limit;
+        return await this.client.get(`${this.basePath}/listing_violation`, params);
+    }
+    /**
+     * Get listing violation summary
+     */
+    async getListingViolationsSummary(complianceType) {
+        const params = {};
+        if (complianceType)
+            params.compliance_type = complianceType;
+        return await this.client.get(`${this.basePath}/listing_violation_summary`, params);
+    }
+    /**
+     * Suppress a violation
+     */
+    async suppressViolation(listingViolationId) {
+        return await this.client.post(`${this.basePath}/suppress_violation`, {
+            listing_violation_id: listingViolationId,
+        });
+    }
+    /**
+     * Get compliance snapshot (alias for getListingViolations)
+     */
+    async getComplianceSnapshot(complianceType, offset, limit) {
+        return this.getListingViolations(complianceType, offset, limit);
+    }
+}

package/build/api/other/edelivery.d.ts

@@ -0,0 +1,153 @@
+import type { EbayApiClient } from '../client.js';
+/**
+ * eDelivery API - International shipping eDelivery
+ * Based on: docs/sell-apps/other-apis/sell_edelivery_international_shipping_oas3.json
+ */
+export declare class EDeliveryApi {
+    private client;
+    private readonly basePath;
+    constructor(client: EbayApiClient);
+    /**
+     * Create shipping quote
+     */
+    createShippingQuote(shippingQuoteRequest: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Get shipping quote
+     */
+    getShippingQuote(shippingQuoteId: string): Promise<unknown>;
+    /**
+     * Get actual costs for shipped packages
+     * Endpoint: GET /actual_costs
+     */
+    getActualCosts(params?: Record<string, string>): Promise<unknown>;
+    /**
+     * Get address preferences
+     * Endpoint: GET /address_preference
+     */
+    getAddressPreferences(): Promise<unknown>;
+    /**
+     * Create address preference
+     * Endpoint: POST /address_preference
+     */
+    createAddressPreference(addressPreference: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Get consign preferences
+     * Endpoint: GET /consign_preference
+     */
+    getConsignPreferences(): Promise<unknown>;
+    /**
+     * Create consign preference
+     * Endpoint: POST /consign_preference
+     */
+    createConsignPreference(consignPreference: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Get available shipping agents
+     * Endpoint: GET /agents
+     */
+    getAgents(params?: Record<string, string>): Promise<unknown>;
+    /**
+     * Get battery qualifications
+     * Endpoint: GET /battery_qualifications
+     */
+    getBatteryQualifications(params?: Record<string, string>): Promise<unknown>;
+    /**
+     * Get dropoff sites
+     * Endpoint: GET /dropoff_sites
+     */
+    getDropoffSites(params: Record<string, string>): Promise<unknown>;
+    /**
+     * Get available shipping services
+     * Endpoint: GET /services
+     */
+    getShippingServices(params?: Record<string, string>): Promise<unknown>;
+    /**
+     * Create a bundle of packages
+     * Endpoint: POST /bundle
+     */
+    createBundle(bundleRequest: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Get bundle by ID
+     * Endpoint: GET /bundle/{bundle_id}
+     */
+    getBundle(bundleId: string): Promise<unknown>;
+    /**
+     * Cancel a bundle
+     * Endpoint: POST /bundle/{bundle_id}/cancel
+     */
+    cancelBundle(bundleId: string): Promise<unknown>;
+    /**
+     * Get bundle label
+     * Endpoint: GET /bundle/{bundle_id}/label
+     */
+    getBundleLabel(bundleId: string): Promise<unknown>;
+    /**
+     * Create a package
+     * Endpoint: POST /package
+     */
+    createPackage(packageRequest: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Get package by ID
+     * Endpoint: GET /package/{package_id}
+     */
+    getPackage(packageId: string): Promise<unknown>;
+    /**
+     * Delete a package
+     * Endpoint: DELETE /package/{package_id}
+     */
+    deletePackage(packageId: string): Promise<unknown>;
+    /**
+     * Get package by order line item
+     * Endpoint: GET /package/{order_line_item_id}/item
+     */
+    getPackageByOrderLineItem(orderLineItemId: string): Promise<unknown>;
+    /**
+     * Cancel a package
+     * Endpoint: POST /package/{package_id}/cancel
+     */
+    cancelPackage(packageId: string): Promise<unknown>;
+    /**
+     * Clone a package
+     * Endpoint: POST /package/{package_id}/clone
+     */
+    clonePackage(packageId: string): Promise<unknown>;
+    /**
+     * Confirm a package
+     * Endpoint: POST /package/{package_id}/confirm
+     */
+    confirmPackage(packageId: string): Promise<unknown>;
+    /**
+     * Bulk cancel packages
+     * Endpoint: POST /package/bulk_cancel_packages
+     */
+    bulkCancelPackages(bulkCancelRequest: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Bulk confirm packages
+     * Endpoint: POST /package/bulk_confirm_packages
+     */
+    bulkConfirmPackages(bulkConfirmRequest: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Bulk delete packages
+     * Endpoint: POST /package/bulk_delete_packages
+     */
+    bulkDeletePackages(bulkDeleteRequest: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Get labels
+     * Endpoint: GET /labels
+     */
+    getLabels(params?: Record<string, string>): Promise<unknown>;
+    /**
+     * Get handover sheet
+     * Endpoint: GET /handover_sheet
+     */
+    getHandoverSheet(params?: Record<string, string>): Promise<unknown>;
+    /**
+     * Get tracking information
+     * Endpoint: GET /tracking
+     */
+    getTracking(params: Record<string, string>): Promise<unknown>;
+    /**
+     * Create a complaint
+     * Endpoint: POST /complaint
+     */
+    createComplaint(complaintRequest: Record<string, unknown>): Promise<unknown>;
+}

package/build/api/other/edelivery.js

@@ -0,0 +1,219 @@
+/**
+ * eDelivery API - International shipping eDelivery
+ * Based on: docs/sell-apps/other-apis/sell_edelivery_international_shipping_oas3.json
+ */
+export class EDeliveryApi {
+    client;
+    basePath = '/sell/logistics/v1';
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Create shipping quote
+     */
+    async createShippingQuote(shippingQuoteRequest) {
+        return await this.client.post(`${this.basePath}/shipping_quote`, shippingQuoteRequest);
+    }
+    /**
+     * Get shipping quote
+     */
+    async getShippingQuote(shippingQuoteId) {
+        return await this.client.get(`${this.basePath}/shipping_quote/${shippingQuoteId}`);
+    }
+    // ==================== Cost & Preferences ====================
+    /**
+     * Get actual costs for shipped packages
+     * Endpoint: GET /actual_costs
+     */
+    async getActualCosts(params) {
+        return await this.client.get(`${this.basePath}/actual_costs`, params);
+    }
+    /**
+     * Get address preferences
+     * Endpoint: GET /address_preference
+     */
+    async getAddressPreferences() {
+        return await this.client.get(`${this.basePath}/address_preference`);
+    }
+    /**
+     * Create address preference
+     * Endpoint: POST /address_preference
+     */
+    async createAddressPreference(addressPreference) {
+        return await this.client.post(`${this.basePath}/address_preference`, addressPreference);
+    }
+    /**
+     * Get consign preferences
+     * Endpoint: GET /consign_preference
+     */
+    async getConsignPreferences() {
+        return await this.client.get(`${this.basePath}/consign_preference`);
+    }
+    /**
+     * Create consign preference
+     * Endpoint: POST /consign_preference
+     */
+    async createConsignPreference(consignPreference) {
+        return await this.client.post(`${this.basePath}/consign_preference`, consignPreference);
+    }
+    // ==================== Agents & Services ====================
+    /**
+     * Get available shipping agents
+     * Endpoint: GET /agents
+     */
+    async getAgents(params) {
+        return await this.client.get(`${this.basePath}/agents`, params);
+    }
+    /**
+     * Get battery qualifications
+     * Endpoint: GET /battery_qualifications
+     */
+    async getBatteryQualifications(params) {
+        return await this.client.get(`${this.basePath}/battery_qualifications`, params);
+    }
+    /**
+     * Get dropoff sites
+     * Endpoint: GET /dropoff_sites
+     */
+    async getDropoffSites(params) {
+        return await this.client.get(`${this.basePath}/dropoff_sites`, params);
+    }
+    /**
+     * Get available shipping services
+     * Endpoint: GET /services
+     */
+    async getShippingServices(params) {
+        return await this.client.get(`${this.basePath}/services`, params);
+    }
+    // ==================== Bundles ====================
+    /**
+     * Create a bundle of packages
+     * Endpoint: POST /bundle
+     */
+    async createBundle(bundleRequest) {
+        return await this.client.post(`${this.basePath}/bundle`, bundleRequest);
+    }
+    /**
+     * Get bundle by ID
+     * Endpoint: GET /bundle/{bundle_id}
+     */
+    async getBundle(bundleId) {
+        return await this.client.get(`${this.basePath}/bundle/${bundleId}`);
+    }
+    /**
+     * Cancel a bundle
+     * Endpoint: POST /bundle/{bundle_id}/cancel
+     */
+    async cancelBundle(bundleId) {
+        return await this.client.post(`${this.basePath}/bundle/${bundleId}/cancel`, {});
+    }
+    /**
+     * Get bundle label
+     * Endpoint: GET /bundle/{bundle_id}/label
+     */
+    async getBundleLabel(bundleId) {
+        return await this.client.get(`${this.basePath}/bundle/${bundleId}/label`);
+    }
+    // ==================== Packages (Single) ====================
+    /**
+     * Create a package
+     * Endpoint: POST /package
+     */
+    async createPackage(packageRequest) {
+        return await this.client.post(`${this.basePath}/package`, packageRequest);
+    }
+    /**
+     * Get package by ID
+     * Endpoint: GET /package/{package_id}
+     */
+    async getPackage(packageId) {
+        return await this.client.get(`${this.basePath}/package/${packageId}`);
+    }
+    /**
+     * Delete a package
+     * Endpoint: DELETE /package/{package_id}
+     */
+    async deletePackage(packageId) {
+        return await this.client.delete(`${this.basePath}/package/${packageId}`);
+    }
+    /**
+     * Get package by order line item
+     * Endpoint: GET /package/{order_line_item_id}/item
+     */
+    async getPackageByOrderLineItem(orderLineItemId) {
+        return await this.client.get(`${this.basePath}/package/${orderLineItemId}/item`);
+    }
+    /**
+     * Cancel a package
+     * Endpoint: POST /package/{package_id}/cancel
+     */
+    async cancelPackage(packageId) {
+        return await this.client.post(`${this.basePath}/package/${packageId}/cancel`, {});
+    }
+    /**
+     * Clone a package
+     * Endpoint: POST /package/{package_id}/clone
+     */
+    async clonePackage(packageId) {
+        return await this.client.post(`${this.basePath}/package/${packageId}/clone`, {});
+    }
+    /**
+     * Confirm a package
+     * Endpoint: POST /package/{package_id}/confirm
+     */
+    async confirmPackage(packageId) {
+        return await this.client.post(`${this.basePath}/package/${packageId}/confirm`, {});
+    }
+    // ==================== Packages (Bulk) ====================
+    /**
+     * Bulk cancel packages
+     * Endpoint: POST /package/bulk_cancel_packages
+     */
+    async bulkCancelPackages(bulkCancelRequest) {
+        return await this.client.post(`${this.basePath}/package/bulk_cancel_packages`, bulkCancelRequest);
+    }
+    /**
+     * Bulk confirm packages
+     * Endpoint: POST /package/bulk_confirm_packages
+     */
+    async bulkConfirmPackages(bulkConfirmRequest) {
+        return await this.client.post(`${this.basePath}/package/bulk_confirm_packages`, bulkConfirmRequest);
+    }
+    /**
+     * Bulk delete packages
+     * Endpoint: POST /package/bulk_delete_packages
+     */
+    async bulkDeletePackages(bulkDeleteRequest) {
+        return await this.client.post(`${this.basePath}/package/bulk_delete_packages`, bulkDeleteRequest);
+    }
+    // ==================== Labels & Tracking ====================
+    /**
+     * Get labels
+     * Endpoint: GET /labels
+     */
+    async getLabels(params) {
+        return await this.client.get(`${this.basePath}/labels`, params);
+    }
+    /**
+     * Get handover sheet
+     * Endpoint: GET /handover_sheet
+     */
+    async getHandoverSheet(params) {
+        return await this.client.get(`${this.basePath}/handover_sheet`, params);
+    }
+    /**
+     * Get tracking information
+     * Endpoint: GET /tracking
+     */
+    async getTracking(params) {
+        return await this.client.get(`${this.basePath}/tracking`, params);
+    }
+    // ==================== Other ====================
+    /**
+     * Create a complaint
+     * Endpoint: POST /complaint
+     */
+    async createComplaint(complaintRequest) {
+        return await this.client.post(`${this.basePath}/complaint`, complaintRequest);
+    }
+}