Amazon SP-API

Descripción

Este módulo permite interactuar con la Amazon Selling Partner API (SP-API) para gestionar operaciones de un vendedor en Amazon. Incluye funcionalidades para pedidos (consultar, obtener items, confirmar envío), catálogo (buscar productos por ASIN/UPC/EAN/keyword), listings (consultar y actualizar), inventario FBA (consultar y actualizar stock), precios competitivos y Buy Box, feeds para actualización masiva (productos, precios, inventario) y reportes (ventas, inventario, financieros).

La autenticación se maneja mediante AWS Signature v4 a través del módulo de credenciales. El módulo utiliza funciones auxiliares buildAuthHeaders y getEndpoint para construir las cabeceras de autenticación y seleccionar el endpoint regional correcto.

Configuración

Parámetros

Parámetro	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial Amazon SP-API
operation	text	Sí	Operación: getOrders, getOrder, getOrderItems, confirmShipment, getCatalogItem, getListings, updateListing, getInventory, updateInventory, getPricing, createFeed, getFeedResult, createReport, getReport
order_id	text	Condicional	ID del pedido (ej: 403-1234567-8901234)
created_after	datetime	No	Filtro de fecha de creación (ISO 8601)
created_before	datetime	No	Filtro de fecha hasta
order_statuses	select	No	Estado: Pending, Unshipped, PartiallyShipped, Shipped, Canceled
max_results	number	No	Máximo de resultados (default: 100)
fulfillment_channels	select	No	Canal: MFN (vendedor), AFN (FBA)
identifiers	text	Condicional	ASIN/UPC/EAN para búsqueda de catálogo
identifiers_type	select	No	Tipo: ASIN, EAN, UPC, ISBN
sku	text	Condicional	SKU del producto
asins	text	Condicional	ASINs separados por coma (max 20 para precios)
feed_type	select	Condicional	Tipo de feed para actualización masiva
report_type	select	Condicional	Tipo de reporte a solicitar
tracking_number	text	Condicional	Número de seguimiento (para confirmShipment)
carrier_code	select	Condicional	Transportista (UPS, FedEx, DHL, SEUR, etc.)

Credenciales

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

Campos de configuración:

• region: Región de Amazon (NA, EU, FE)
• marketplace_id: ID del marketplace (ej: A1RKKUPIHCS9HS para España)
• selling_partner_id: ID del vendedor
• Credenciales AWS para firma de solicitudes

Salida

{
  "nextModule": null,
  "data": [
    {
      "AmazonOrderId": "403-1234567-8901234",
      "OrderStatus": "Shipped",
      "PurchaseDate": "2025-01-15T10:30:00Z",
      "OrderTotal": { "Amount": "29.99", "CurrencyCode": "EUR" }
    }
  ],
  "_meta_": {
    "operation": "getOrders",
    "marketplace": "A1RKKUPIHCS9HS",
    "recordCount": 1,
    "executionTime": "450ms"
  }
}

Ejemplo de Uso

Caso básico - Obtener pedidos

{
  "credentials_id": 1,
  "operation": "getOrders",
  "created_after": "2025-01-01T00:00:00Z",
  "order_statuses": "Unshipped",
  "max_results": 50
}

API Utilizada

• Amazon Selling Partner API (SP-API)
• Orders API v0, Catalog Items API v2022-04-01, Listings Items API v2021-08-01
• FBA Inventory API v1, Product Pricing API v0, Feeds API v2021-06-30, Reports API v2021-06-30
• Documentación: https://developer-docs.amazon.com/sp-api/

Notas

• El rate limit de Amazon SP-API varía por operación; si se alcanza (HTTP 429), el módulo indica reintento con delay
• La consulta de precios acepta un máximo de 20 ASINs por solicitud
• Los feeds requieren un proceso de 3 pasos: crear documento, subir contenido y crear feed
• Los reportes son asíncronos: se solicitan, se espera procesamiento y luego se descargan
• La actualización de inventario se realiza internamente mediante patches en la Listings API
• El timeout por defecto de las solicitudes es de 30 segundos (60 segundos para feeds)

Nodos Relacionados

• Obtener Pedidos, Obtener Pedido, Items del Pedido, Confirmar Envío
• Buscar Producto, Mis Listings, Actualizar Listing
• Consultar Inventario, Actualizar Inventario, Consultar Precios
• Enviar Feed, Resultado de Feed, Solicitar Reporte, Descargar Reporte