Apariencia
Glosario de Términos Técnicos — Amazon SP-API
Términos técnicos importantes organizados alfabéticamente. Los términos en inglés se mantienen en inglés (es la nomenclatura estándar de Amazon).
A
access token Token de corta duración (1 hora) que se incluye en cada petición a SP-API como header x-amz-access-token. Se obtiene usando el refresh_token + credenciales LWA. Ver 02-autenticacion-y-conexion.md.
ARN (Amazon Resource Name) Identificador único de recursos de AWS. Formato: arn:aws:sqs:region:cuenta:nombre-recurso. Se usa para identificar colas SQS, roles IAM, etc.
ASIN (Amazon Standard Identification Number) El identificador único de cada producto en el catálogo de Amazon. Formato: B08XXXXXX. Un mismo producto físico puede tener distintos ASINs en diferentes marketplaces.
AWS (Amazon Web Services) La plataforma cloud de Amazon. Necesaria para configurar la Notifications API (SQS) y opcionalmente para alojar tu app (Lambda, etc.). Desde octubre 2024, ya no es necesaria para autenticación básica.
AWS IAM (Identity and Access Management) Servicio de AWS para gestionar permisos y roles. Antes de octubre 2024, era necesario para autenticar en SP-API. Ahora es opcional (solo necesario si usas ciertas funcionalidades avanzadas).
B
boto3 La librería oficial de Python para interactuar con servicios de AWS (S3, SQS, Lambda, etc.). Se usa para leer mensajes de SQS en la Notifications API.
burst En el token bucket algorithm, el tamaño máximo del bucket. Representa el número máximo de peticiones que puedes hacer de golpe antes de ser throttled. Ver 12-rate-limits-y-throttling.md.
BuyBox La caja de compra destacada en la página de producto de Amazon. El vendedor con el buybox recibe la mayoría de las ventas para ese ASIN. Los datos del buybox se obtienen a través de la Catalog Items API.
C
client_id El identificador de tu aplicación SP-API (también llamado LWA app ID). Se obtiene al crear una app en el Developer Central de Amazon.
client_secret La contraseña secreta de tu aplicación SP-API. Junto con el client_id, se usa para obtener access_token.
D
DataDo Plataforma de terceros (de Delta Logic) que actúa como capa de datos entre SP-API y herramientas de IA. Expone datos de Amazon a través de un servidor MCP. Ver 15-mcp-y-herramientas-ia.md.
Destination En la Notifications API, el destino donde Amazon enviará las notificaciones (ej. el ARN de una cola SQS).
Dynamic usage plans Mecanismo por el que Amazon puede subir o bajar automáticamente los rate limits de tu app según el histórico de uso.
E
endpoint La URL base del servidor de SP-API según la región:
- Norteamérica:
https://sellingpartnerapi-na.amazon.com - Europa:
https://sellingpartnerapi-eu.amazon.com - Extremo Oriente:
https://sellingpartnerapi-fe.amazon.com
F
FBA (Fulfillment by Amazon) Modelo en el que Amazon almacena, empaqueta y envía los productos del vendedor.
FBM (Fulfillment by Merchant) Modelo en el que el vendedor gestiona el almacén y el envío directamente.
feed En la Feeds API, el archivo XML con datos que subes a Amazon para actualizar precios, inventario, listings, etc.
feedDocumentId Identificador del documento XML que subes a Amazon antes de crear el feed. Diferente del feedId.
feedId Identificador del trabajo de procesamiento del feed. Se obtiene al llamar a CreateFeed.
G
GetOrders Operación de la Orders API que devuelve una lista de pedidos con filtros (fecha, estado, marketplace). Devuelve máximo 100 por petición + NextToken si hay más.
grant_type Parámetro del protocolo OAuth 2.0. Para SP-API, siempre es "refresh_token" al obtener un access token.
I
IAM Role Rol de AWS con permisos específicos. Antes de octubre 2024 era necesario para SP-API. Ahora es opcional para la mayoría de operaciones.
includedData Parámetro que especifica qué campos adicionales quieres recibir en ciertas APIs (Catalog Items, Listings). Ej: "summaries,attributes,images,offers".
Issues Lista de problemas detectados por Amazon en un listing (precio fuera de rango, imágenes faltantes, etc.). Puede aparecer en respuestas 200 OK de Listings API.
L
Lambda Servicio de AWS que ejecuta código sin servidor. Se puede configurar como consumer de mensajes SQS para procesar notificaciones de SP-API automáticamente.
Listings API API para gestionar listings individuales (precio, cantidad, atributos). Operaciones clave: putListingsItem, patchListingsItem, deleteListingsItem.
LWA (Login with Amazon) El sistema de autenticación OAuth 2.0 de Amazon. Gestiona la emisión de access_token y refresh_token para SP-API.
M
marketplace La tienda de Amazon en un país específico. Cada marketplace tiene un marketplaceId único.
marketplaceId Identificador único de un marketplace de Amazon. Ejemplos: España A1RKKUPIHCS9HS, Alemania A1PA6795UKMFR9, Reino Unido A1F83G8C2ARO7P, EE.UU. ATVPDKIKX0DER.
MCP (Model Context Protocol) Protocolo abierto creado por Anthropic para conectar agentes de IA con herramientas y fuentes de datos externas. Ver 15-mcp-y-herramientas-ia.md.
MWS (Marketplace Web Service) La antigua API de Amazon (XML/SOAP). Completamente deprecada desde 2024. Ver 13-migracion-mws-a-sp-api.md.
N
NextToken Token de paginación devuelto por APIs cuando hay más resultados que el máximo por petición (normalmente 100). Se pasa como parámetro en la siguiente petición para obtener la siguiente página.
NotificationType El tipo de evento al que te suscribes en la Notifications API. Ej: ORDER_CHANGE, REPORT_PROCESSING_FINISHED, OFFER_CHANGED.
O
OAuth 2.0 El protocolo de autorización usado por SP-API a través de LWA. Gestiona los tokens de acceso sin exponer contraseñas directamente.
P
PII (Personally Identifiable Information) Información personal identificable del comprador: nombre completo, dirección de envío completa, número de teléfono. Está oculta por defecto en SP-API. Requiere aprobación especial para acceder. Ver 04-acceso-pii-y-rdt.md.
Private developer Tipo de desarrollador en SP-API que solo usa la API para sus propias cuentas de Amazon. Sin fees desde enero 2026.
processingStatus Estado de procesamiento de un informe en Reports API: IN_QUEUE, IN_PROGRESS, DONE, CANCELLED, FATAL.
productType El tipo de producto en el sistema de Amazon (ej. SHIRT, ELECTRONICS, BOOK). Define los atributos válidos de un listing.
Public developer (Unlisted) Tipo de desarrollador que puede dar acceso a su app a hasta 25 otros vendedores. Sin necesidad de aprobación de Amazon para empezar.
Public developer (Listed) Tipo de desarrollador con app publicada en el Amazon App Store. Sin límite de vendedores. Requiere aprobación de Amazon.
Q
QuotaExceeded Error HTTP 429 que indica que has superado el rate limit (bucket vacío). Debes esperar antes de reintentar.
R
rate En el token bucket algorithm, el número de tokens por segundo que se añaden al bucket. Define la velocidad sostenible de peticiones.
RDT (Restricted Data Token) Token especial necesario para acceder a datos PII de compradores. Se obtiene mediante una petición específica a SP-API y dura 1 hora.
refresh_token Token de larga duración que se usa para obtener nuevos access_token. No caduca (a menos que la app sea revocada). Debe guardarse de forma segura.
reportDocumentId El identificador del documento descargable cuando un informe está listo. Se obtiene de la respuesta de GetReport cuando processingStatus = DONE.
reportId El identificador de un trabajo de generación de informe. Se obtiene de la respuesta de CreateReport.
reportType El tipo de informe que se solicita a Reports API. Ej: GET_FLAT_FILE_OPEN_LISTINGS_DATA, GET_FLAT_FILE_ALL_ORDERS_DATA_BY_ORDER_DATE_GENERAL.
S
scope En OAuth, los permisos que se solicitan. En SP-API, el scope define qué APIs puede usar tu app.
sellerId El identificador de la cuenta del vendedor en Amazon. Diferente del client_id (que es el ID de la app).
SKU (Stock Keeping Unit) El identificador interno del vendedor para un producto. Lo define el propio vendedor (diferente del ASIN de Amazon).
SP-API (Selling Partner API) La API actual de Amazon para vendedores y desarrolladores. Basada en REST/JSON. Reemplazó a MWS.
SQS (Simple Queue Service) Servicio de colas de mensajes de AWS. Se usa en la Notifications API para recibir eventos de Amazon.
Subscription En la Notifications API, la suscripción a un tipo de notificación específico asociada a un Destination.
T
Third-party developer Tipo de desarrollador en SP-API que construye apps para otros vendedores. Sujeto a fees desde enero 2026.
throttling El mecanismo por el que Amazon limita tu velocidad de peticiones cuando superas el rate limit.
token bucket Algoritmo de control de flujo usado por Amazon. Ver 12-rate-limits-y-throttling.md.
TSV (Tab-Separated Values) Formato de archivo de texto donde los valores se separan por tabulaciones. La mayoría de informes de Reports API están en formato TSV (no CSV).
X
x-amz-access-token Header HTTP obligatorio en todas las peticiones a SP-API. Contiene el access_token obtenido mediante LWA.
x-amz-rate-limit-limit Header HTTP devuelto por Amazon en cada respuesta. Contiene tu rate limit real actual para esa operación (puede ser diferente al documentado si tienes dynamic usage plan).
XML Envelope
Estructura XML estándar que envuelve todos los feeds de la Feeds API de Amazon. Contiene el Header con el MerchantIdentifier y uno o más elementos Message.