eBay

Descripción

Este módulo permite interactuar con las APIs REST de eBay para gestionar las operaciones de un vendedor. Cubre las principales APIs: Fulfillment API (pedidos, envíos, reembolsos), Inventory API (items, ofertas/listados, CRUD de inventario), Browse API (búsqueda pública de items), Finances API (transacciones, payouts), Notification API (suscripciones a eventos y webhooks) y Account API (información del vendedor y políticas).

La autenticación se realiza mediante OAuth2 con tokens de acceso gestionados por el módulo de credenciales. El módulo utiliza funciones auxiliares HTTP (ebayGet, ebayPost, ebayPut, ebayDelete) para construir las solicitudes.

Configuración

Parámetros

Parámetro	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial eBay (OAuth2)
operation	text	Sí	Operación: getOrders, getOrder, createShippingFulfillment, issueRefund, getInventoryItems, getInventoryItem, createOrUpdateInventoryItem, deleteInventoryItem, getOffers, browseSearch, browseGetItem, getTransactions, getPayouts, createDestination, createSubscription, getSubscriptions, getSellerInfo
order_id	text	Condicional	ID del pedido
sku	text	Condicional	SKU del producto
limit	number	No	Límite de resultados (varía por operación, max 200)
offset	number	No	Desplazamiento para paginación
order_status	select	No	Estado del pedido: ACTIVE, COMPLETED, CANCELLED
query	text	Condicional	Texto de búsqueda (Browse API)
sort	select	No	Ordenamiento: BEST_MATCH, PRICE, -PRICE, NEWLY_LISTED, ENDING_SOONEST
tracking_number	text	No	Número de seguimiento para envío
shipping_carrier	select	No	Transportista: USPS, UPS, FEDEX, DHL, CORREOS, etc.
title	text	Condicional	Título del producto (para crear/actualizar item)
condition	select	No	Condición: NEW, LIKE_NEW, USED_EXCELLENT, USED_GOOD, etc.
price	text	Condicional	Precio del producto
quantity	number	Condicional	Cantidad en inventario

Credenciales

Tipo de servicio: ebay. Se almacenan en la tabla servicecredentials.

Campos de configuración:

• clientId: App ID de eBay
• clientSecret: Cert ID de eBay
• refreshToken: Token de actualización OAuth2
• marketplace_id: ID del marketplace (ej: EBAY_US, EBAY_ES)
• environment: sandbox o production

Salida

{
  "nextModule": null,
  "data": [
    {
      "orderId": "12-12345-12345",
      "orderFulfillmentStatus": "NOT_STARTED",
      "pricingSummary": {
        "total": { "value": "49.99", "currency": "USD" }
      }
    }
  ],
  "_meta_": {
    "operation": "getOrders",
    "recordCount": 1,
    "executionTime": "320ms"
  }
}

Ejemplo de Uso

Caso básico - Obtener pedidos

{
  "credentials_id": 1,
  "operation": "getOrders",
  "limit": 50,
  "order_status": "ACTIVE"
}

API Utilizada

• eBay Fulfillment API v1, Inventory API v1, Browse API v1
• eBay Finances API v1, Notification API v1, Account API v1
• Documentación: https://developer.ebay.com/docs

Notas

• El límite máximo de resultados varía: 200 para pedidos/transacciones, 100 para inventario
• La Browse API es pública y no requiere refresh token del usuario
• La creación/actualización de items en inventario usa upsert por SKU (operación PUT)
• Los reembolsos se procesan a través de la Fulfillment API
• Las notificaciones requieren primero crear un endpoint destino (destination) y luego la suscripción
• El marketplace EBAY_US es el valor por defecto si no se especifica
• El timeout de solicitudes es de 30 segundos

Nodos Relacionados

• Obtener Pedidos, Obtener Pedido, Marcar Enviado, Emitir Reembolso
• Obtener Inventario, Obtener Item Inventario, Crear/Actualizar Item, Eliminar Item
• Buscar Items (Browse), Obtener Item (Browse), Listados Activos
• Obtener Transacciones, Obtener Pagos/Payouts
• Crear Destino Notificación, Crear Suscripción Notificación, Obtener Suscripciones
• Info del Vendedor