Etsy (publicador independiente)

Este conector usa la clave de API para acceder a varias características de Etsy.com. Admite acciones para el inventario, los pedidos de venta y la administración de tiendas. Todas las acciones se basan en Etsy Open API v3, que tiene puntos de conexión que todavía están en versión beta. Si, por ejemplo, las acciones usan la API beta, la acción con incluir Beta en el título y devolverá un código de respuesta 501.

Este conector está disponible en los siguientes productos y regiones:

Service	Class	Regions
Copilot Studio	Premium	Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas	Estándar	Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD)
Power Apps	Premium	Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD)
Power Automate	Premium	Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD)

Contacto
Nombre	Troy Taylor
URL	https://www.hitachisolutions.com
Correo Electrónico	ttaylor@hitachisolutions.com

Metadatos del conector
Publicador	Troy Taylor, Hitachi Solutions
Sitio web	https://www.etsy.com/
Directiva de privacidad	https://www.etsy.com/legal/privacy/
Categorías	Commerce

Creación de una conexión

El conector admite los siguientes tipos de autenticación:


Predeterminado	Parámetros para crear una conexión.	Todas las regiones	No se puede compartir

Predeterminado

Aplicable: Todas las regiones

Parámetros para crear una conexión.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre	Tipo	Description	Obligatorio
API key	securestring	La clave de API para esta API	Cierto

Limitaciones

Nombre	Llamadas	Período de renovación
Llamadas API por conexión	100	60 segundos

Acciones

Actualización de un destino de perfil de envío	Actualiza un destino de envío existente, que puede establecer o reasignar el costo de envío, el transportista y la clase para un destino.
Actualización de un perfil de envío	Cambia la configuración de un perfil de envío.
Actualización de una actualización del perfil de envío	Actualiza una actualización de perfil de envío y actualiza las descripciones que usan el perfil de envío.
Actualización de una traducción de lista	Actualiza una traducción de listados al enumerar el identificador y el idioma.
Actualizar el inventario de una lista	Actualiza el inventario de una lista identificada por un identificador de lista. Se produce un error en la actualización si los valores proporcionados para la SKU del producto, la cantidad de ofertas o el precio son incompatibles con los valores de en los campos de propiedad. Al establecer un precio, asigne un float igual a la cantidad dividida por divisor según se especifica en el recurso money.
Actualizar las imágenes de variación de una lista	Crea imágenes de variación en una lista.
Actualizar una lista	Actualiza un listado, identificado por un identificador de descripción, para una tienda específica identificada por un identificador de tienda.
Actualizar una propiedad de lista	Actualiza o rellena la lista de propiedades que define las ofertas de productos para una lista. Cada oferta requiere un valor y un identificador de valor que sean válidos para un identificador de escalado asignado a la lista o que asigne a la lista con esta solicitud.
Actualizar una tienda	Actualizar una tienda. Supone que todos los parámetros de cadena se proporcionan en el idioma principal de la tienda.
Buscar tiendas	Devuelve una lista de tiendas con el nombre coincidente.
Carga de una imagen de lista	Carga o asigna una imagen a una descripción identificada por un identificador de tienda con un identificador de descripción. Para cargar una nueva imagen, establezca el archivo de imagen como valor para el parámetro image. Puede asignar una imagen eliminada previamente a una lista mediante el identificador de imagen de la imagen eliminada en el parámetro id. de imagen de lista. Cuando una solicitud contiene valores de parámetro de id. de imagen y de lista, el punto de conexión carga la imagen solo en el parámetro image.
Cargar un archivo de lista	Carga un nuevo archivo para una lista digital o asocia un archivo existente a una lista específica. Debe proporcionar el identificador de archivo de lista de un archivo existente o el nombre y los datos de archivo binarios para que se cargue un archivo. La asociación de un archivo existente a una lista física convierte la lista física en una lista digital, lo que elimina todos los costos de envío y cualquier variación de producto e inventario.
Creación de un destino de perfil de envío	Crea un nuevo destino de envío, que establece el costo de envío, el transportista y la clase para un destino en un perfil de envío. Esto asigna los costos utilizando la moneda de la tienda asociada. Establezca el destino mediante iso de país de destino o región de destino; el país de destino ISO y la región de destino son mutuamente excluyentes: establezca uno o otro. Al establecer ambos desencadenadores, se produce el error 400. Si la solicitud no establece iso de país de destino ni región de destino, el destino predeterminado está en todas partes. También debe asignar un identificador de transportista de envío y una clase de correo o tanto días de entrega mínimo como días de entrega máximo.
Creación de un perfil de envío	Crea un nuevo perfil de envío. Puede pasar un código ISO de país o una región al crear un perfil de envío, pero no ambos. Solo se requiere uno. Debe pasar un identificador de transportista de envío y una clase de correo, o tanto días de entrega mínimo como máximo.
Creación de una actualización de perfil de envío	Crea una nueva actualización del perfil de envío, que puede establecer un precio para una opción de envío, como un transportista alternativo o una entrega más rápida.
Creación de una traducción de lista	Crea una traducción de listados mediante el identificador y el idioma de la lista.
Crear un recibo de envío	Envía información de seguimiento para un recibo de la tienda, que crea una entrada de envío de recibo de la tienda para el identificador de recibo especificado. Cada vez que envíes correctamente la información de seguimiento, Etsy envía un correo electrónico de notificación al usuario comprador. Cuando enviar BCC es true, Etsy también envía notificaciones de envío al vendedor. Cuando no se envía el código de seguimiento y el nombre del operador, el recibo solo se marca como enviado.
Crear una lista de borradores	Crea un borrador físico del producto en una tienda en el canal Etsy.
Crear una sección de tiendas	Crea una nueva sección en una tienda específica.
Eliminar un archivo de la lista	Al eliminar el archivo final de una lista digital, la lista se convierte en una lista física. La respuesta a una solicitud de eliminación devuelve una lista de los registros de archivo restantes asociados a la lista especificada.
Eliminar un destino de perfil de envío	Elimina un destino de envío y quita la opción de destino de cada lista que usa el perfil de envío asociado. Un perfil de envío requiere al menos un destino de envío, por lo que este punto de conexión no puede eliminar el destino de envío final para cualquier perfil de envío. Para eliminar el destino de envío final de un perfil de envío, debe eliminar todo el perfil de envío.
Eliminar un perfil de envío	Elimina un perfil de envío mediante un identificador determinado.
Eliminar una actualización de perfil de envío	Elimina una actualización de perfil de envío y quita la opción de actualización de cada lista que usa el perfil de envío asociado.
Eliminar una imagen de lista	Elimina una imagen de lista. Una copia del archivo permanece en nuestros servidores, por lo que una imagen eliminada puede volver a asociarse con la descripción sin volver a cargar la imagen original.
Eliminar una lista	Esta acción elimina una descripción de la tienda. Una lista solo se puede eliminar si el estado es uno de los siguientes: SOLD_OUT, DRAFT, EXPIRED, INACTIVE, ACTIVE y is_available o ACTIVE y tiene marcas de vendedor: SUPRESSED (congelado), VACATION, CUSTOM_SHOPS (patrón), SELL_ON_FACEBOOK
Eliminar una propiedad de lista	Elimina una propiedad de una lista.
Obtención de destinos de perfil por perfil de envío	Recupera una lista de objetos de destino de envío asociados a un perfil de envío.
Obtención de direcciones de usuario	Recupere una lista de direcciones de usuario.
Obtención de la tienda por identificador de propietario	Recupera la tienda identificada por el identificador de usuario del propietario de la tienda.
Obtención de nodos de taxonomía de vendedores	Recupera el árbol de jerarquía completo de los nodos de taxonomía del vendedor.
Obtención de propiedades del producto por identificador de taxonomía	Recupera una lista de propiedades de producto, con escalas y valores aplicables, compatibles con un identificador de taxonomía de vendedor específico.
Obtención de un pago a partir de un identificador de entrada del libro de contabilidad de la cuenta de pago	Obtenga un pago a partir de un identificador de entrada del libro de contabilidad de cuenta de pago, si procede.
Obtención de una transacción	Recupera una transacción por identificador de transacción.
Obtener actualizaciones de perfil de envío	Recupera la lista de actualizaciones de perfil de envío asignadas a un perfil de envío específico.
Obtener el inventario de una lista	Recupera el registro de inventario de una lista. Los listados que no editó con las herramientas de inventario de Etsy.com no tienen registros de inventario. Este punto de conexión devuelve datos de SKU si es el propietario de los registros de inventario que se capturan.
Obtener el producto de una descripción	Recupere un producto de lista por identificador.
Obtener la dirección del usuario	Recupera la dirección del usuario. El desarrollo de este punto de conexión está en curso. Solo devolverá una respuesta 501.
Obtener la oferta de una descripción	Obtener una oferta para una descripción.
Obtener la propiedad de una descripción (Beta)	Recupera la propiedad de una lista. El desarrollo de este punto de conexión está en curso. Solo devolverá una respuesta 501.
Obtener la traducción de una lista	Devuelve la traducción de una lista en el idioma especificado.
Obtener la transacción de un recibo	Recupera la lista de transacciones asociadas a un recibo específico.
Obtener la transacción de una tienda	Recupera la lista de transacciones asociadas a una tienda.
Obtener las entradas del libro de contabilidad de una cuenta de pago de la tienda	Recupere las entradas del libro de contabilidad de la cuenta de pago de una tienda.
Obtener las imágenes de una lista	Recupera todos los recursos de imagen de lista para una lista con un identificador de descripción específico.
Obtener las imágenes de variación de la lista	Obtiene todas las imágenes de variación de una lista.
Obtener las propiedades de una lista	Devuelve una lista de las propiedades de una lista.
Obtener listados activos	Lista de todas las listas activas en Etsy paginada por su fecha de creación. Sin las listas de ordenación se devolverán de forma predeterminada más reciente.
Obtener listados activos por tienda	Recupera una lista de todas las listas activas de Etsy en una tienda específica, paginada por fecha de creación de la lista.
Obtener listados destacados por tienda	Recupera listados asociados a una tienda destacada.
Obtener listados por identificador	Permite consultar varios identificadores de lista a la vez. Limite 100 identificadores como máximo por consulta.
Obtener listados por identificador de sección de la tienda	Recupera todos los listados de la sección de una tienda específica.
Obtener listados por recibo de la tienda	Obtiene todas las listas asociadas a un recibo.
Obtener listados por tienda	Devuelve listados que pertenecen a una tienda. Los listados se pueden filtrar mediante el parámetro state.
Obtener perfiles de envío	Recupera una lista de perfiles de envío disponibles en la tienda etsy específica identificada por su identificador de tienda.
Obtener recibos	Solicita los recibos de la tienda desde una tienda específica, sin filtrar o filtrar por intervalo de identificadores de recibo o desplazamiento, fecha, pago o compras enviadas.
Obtener revisiones	Recupera las revisiones de una tienda dada su identificador.
Obtener secciones de la tienda	Recupera la lista de secciones de la tienda en una tienda específica identificada por el identificador de la tienda.
Obtener todos los archivos de lista	Recupera todos los archivos asociados a la lista digital especificada. La solicitud de archivos de una lista física devuelve un resultado vacío.
Obtener transportistas de envío	Recupera una lista de los transportistas de envío disponibles y las clases de correo asociadas a ellas para un país determinado.
Obtener un archivo de una lista	Recupera un único archivo asociado a la lista digital especificada. La solicitud de un archivo de una lista física devuelve un resultado vacío.
Obtener un pago a partir de un recibo específico	Recupera un pago de un recibo específico, identificado por id. de recibo, de una tienda específica, identificada por el identificador de la tienda.
Obtener un perfil de envío	Recupera un perfil de envío al que hace referencia el identificador del perfil de envío.
Obtener un recibo	Recupera un recibo, identificado por un identificador de recibo, de una tienda etsy.
Obtener una imagen de lista	Recupera las referencias y los metadatos de una imagen de lista con un identificador de imagen específico.
Obtener una lista	Recupera un registro de lista mediante el identificador de la lista.
Obtener una lista de pagos	Recupera una lista de pagos de una tienda identificada por el identificador de la tienda. También puede filtrar los resultados mediante una lista de identificadores de pago.
Obtener usuario	Devuelve el perfil de usuario para el usuario identificado por un identificador de usuario.
Ping	Compruebe para confirmar la conectividad con la API de Etsy con una aplicación.
Recuperar las transacciones de una lista	Recupera la lista de transacciones asociadas a una lista.
Sección Obtener tienda	Recupera una sección de tiendas, a la que hace referencia el identificador de sección y el identificador de la tienda.

Actualización de un destino de perfil de envío

Id. de la operación:: ShippingUpdateProfileDestination

Actualiza un destino de envío existente, que puede establecer o reasignar el costo de envío, el transportista y la clase para un destino.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Id. de perfil de envío	shipping_profile_id	True	string	Identificador numérico del perfil de envío asociado a la lista.
Id. de destino del perfil de envío	shipping_profile_destination_id	True	string	Identificador numérico del destino del perfil de envío asociado con la lista.
primary_cost	primary_cost		string	primary_cost
secondary_cost	secondary_cost		string	secondary_cost
destination_country_iso	destination_country_iso		string	destination_country_iso
destination_region	destination_region		string	destination_region
shipping_carrier_id	shipping_carrier_id		integer	shipping_carrier_id
mail_class	mail_class		string	mail_class
min_delivery_days	min_delivery_days		integer	min_delivery_days
max_delivery_days	max_delivery_days		integer	max_delivery_days

Devoluciones

Representa un destino de envío asignado a un perfil de envío.

ShopShippingProfileDestination: ShopShippingProfileDestination

Actualización de un perfil de envío

Id. de la operación:: ShippingUpdateProfile

Cambia la configuración de un perfil de envío.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Id. de perfil de envío	shipping_profile_id	True	integer	Identificador numérico del perfil de envío asociado a la lista.
Title	title		string	Cadena de nombre de este perfil de envío.
ISO del país de origen	origin_country_iso		string	Código ISO del país desde el que se distribuye el listado.
Tiempo mínimo de procesamiento	min_processing_time		integer	El tiempo mínimo necesario para procesar para enviar listados con este perfil de envío.
Tiempo máximo de procesamiento	max_processing_time		integer	Tiempo máximo de procesamiento que la lista debe enviar.
Unidad de tiempo de procesamiento	processing_time_unit		string	Unidad que se usa para representar cuánto tiempo es un tiempo de procesamiento. Una semana equivale a 5 días laborables. Si no se proporciona ninguno, la unidad se establece en business_days.
Código postal de origen	origin_postal_code		string	Cadena de código postal (no necesariamente un número) para la ubicación desde la que se distribuye la lista.

Devoluciones

Representa un perfil usado para establecer la información de envío de una lista. Tenga en cuenta que no es posible crear plantillas de envío calculadas a través de la API. Sin embargo, puede asociar perfiles de envío calculados creados desde Shop Manager con listados mediante la API.

ShopShippingProfile: ShopShippingProfile

Actualización de una actualización del perfil de envío

Id. de la operación:: ShippingUpdateProfileUpgrade

Actualiza una actualización de perfil de envío y actualiza las descripciones que usan el perfil de envío.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Id. de perfil de envío	shipping_profile_id	True	integer	Identificador numérico del perfil de envío asociado a la lista.
Id. de actualización	upgrade_id	True	integer	Identificador numérico asociado a una actualización de envío
Tipo	type		string	Tipo de la actualización de envío. Nacional (0) o internacional (1).
Nombre de actualización	upgrade_name		string	Nombre de la actualización de envío que se muestra a los compradores al finalizar la compra, por ejemplo, prioridad de USPS.
Precio	price		float	Costo adicional de agregar la actualización de envío.
Precio secundario	secondary_price		float	Costo adicional de agregar la actualización de envío para cada artículo adicional.
Id. del transportista de envío	shipping_carrier_id		integer	Identificador único de un transportista de envío admitido, que se usa para calcular una fecha de entrega estimada.
Clase Mail	mail_class		string	Cadena de identificador único de la clase de correo de un transportista de envío, que se usa para calcular una fecha de entrega estimada.
Días de entrega mínimos	min_delivery_days		integer	min_delivery_days
Máximo de días de entrega	max_delivery_days		integer	El número máximo de días laborables que un comprador puede esperar esperar para recibir su artículo comprado una vez que se haya enviado.

Devoluciones

Representación de una opción de actualización de perfil de envío.

ShopShippingProfileUpgrade: ShopShippingProfileUpgrade

Actualización de una traducción de lista

Id. de la operación:: ListingUpdateTranslation

Actualiza una traducción de listados al enumerar el identificador y el idioma.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Id. de lista	listing_id	True	integer	Identificador numérico de la lista asociada a esta transacción.
Language	language	True	string	Etiqueta de idioma IETF para el idioma de esta traducción. Por ejemplo: de, en, es, fr, it, ja, nl, pl, pt, ru.
Title	title	True	string	Título de la lista de esta traducción.
Description	description	True	string	Descripción de la descripción de esta traducción.
Etiquetas	tags		string	Etiquetas de la lista de esta traducción.

Devoluciones

Representa los datos de traducción de un listado.

ListingTranslation: ListingTranslation

Actualizar el inventario de una lista

Id. de la operación:: ListingUpdateInventory

Actualiza el inventario de una lista identificada por un identificador de lista. Se produce un error en la actualización si los valores proporcionados para la SKU del producto, la cantidad de ofertas o el precio son incompatibles con los valores de en los campos de propiedad. Al establecer un precio, asigne un float igual a la cantidad dividida por divisor según se especifica en el recurso money.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de lista	listing_id	True	string	Identificador numérico de la lista asociada a esta transacción.
Products	products	True	string	Matriz JSON de productos disponibles en una lista, incluso si solo un producto. Todos los nombres de campo de los blobs JSON están en minúsculas.
Precio en propiedad	price_on_property		string	Matriz de enteros de identificadores de propiedad de lista únicos para las propiedades que cambian los precios del producto, si los hay. Por ejemplo, si cobra precios específicos para distintos productos de tamaño en la misma lista, esta matriz contiene el identificador de propiedad para el tamaño.
Quantity on (propiedad)	quantity_on_property		string	Matriz de enteros de identificadores de propiedad de lista únicos para las propiedades que cambian la cantidad de los productos, si los hay. Por ejemplo, si almacena cantidades específicas de diferentes productos de color en la misma lista, esta matriz contiene el identificador de propiedad para el color.
SKU on (propiedad)	sku_on_property		string	Matriz de enteros de identificadores de propiedad de lista únicos para las propiedades que cambian la SKU del producto, si existe. Por ejemplo, si usa sku específicas para distintos productos de color en la misma lista, esta matriz contiene el identificador de propiedad para el color.

Devoluciones

Representación del registro de inventario de una sola lista.

ListingInventory: ListingInventory

Actualizar las imágenes de variación de una lista

Id. de la operación:: ListingUpdateVariation

Crea imágenes de variación en una lista.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Id. de lista	listing_id	True	integer	Identificador numérico de la lista asociada a esta transacción.
Imágenes de variación	variation_images	True	string	Matriz de datos de imagen de variación.

Devoluciones

Representa varias imágenes de variación de lista.

ListingVariationImages: ListingVariationImages

Actualizar una lista

Id. de la operación:: ListingUpdate

Actualiza un listado, identificado por un identificador de descripción, para una tienda específica identificada por un identificador de tienda.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Id. de lista	listing_id	True	integer	Identificador numérico de la lista asociada a esta transacción.
Cantidad	quantity		integer	Número positivo distinto de cero de productos disponibles para la compra en el listado.
Title	title		string	Cadena de título de la lista. Las cadenas de título válidas solo contienen letras, números, signos de puntuación, símbolos matemáticos, caracteres de espacio en blanco, ™ , © y ® . (regex: /[^\p{L}\p{Nd}\p{P}\p{Sm}\p{Zs}™©®]/u) Solo puede usar los caracteres %, :, y + una vez cada uno.
Description	description		string	Cadena de descripción del producto para la venta en la lista.
Precio	price		float	Precio positivo distinto de cero del producto. (Los listados de productos vendidos son privados) Nota: El precio es el precio mínimo posible.
Quién hizo	who_made		string	Cadena enidcatada que hizo el producto. Ayuda a los compradores a localizar la descripción bajo el encabezado Hechos a mano. Requiere "is_supply" y "when_made".
Cuándo se hizo	when_made		string	Cadena para la era en la que el fabricante hizo el producto en esta lista. Ayuda a los compradores a localizar la descripción bajo el encabezado Vintage. Requiere "is_supply" y "who_made".
Id. de taxonomía	taxonomy_id		integer	Id. de taxonomía numérica de la lista. El vendedor administra los identificadores de taxonomía para su tienda.
Id. de perfil de envío	shipping_profile_id		integer	Identificador numérico del perfil de envío asociado a la lista.
Materials	materials		string	Matriz de cadenas de material para materiales utilizados en el producto. Las cadenas de materiales válidas solo contienen letras, números y caracteres de espacio en blanco. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u)
Id. de sección de tienda	shop_section_id		integer	Identificador numérico de la sección de la tienda para este listado.
Procesamiento mínimo	processing_min		integer	Número mínimo de días necesarios para procesar esta lista.
Procesamiento máximo	processing_max		integer	Número máximo de días necesarios para procesar esta lista.
Etiquetas	tags		string	Matriz de cadenas de etiqueta para la lista. Las cadenas de etiqueta válidas solo contienen letras, números, caracteres de espacio en blanco, -, ', ™ , © y ® . (regex: /[^\p{L}\p{Nd}\p{Zs}-'™©®]/u)
Destinatario	recipient		string	Cadena que indica a una persona para la que este producto haría un regalo adecuado.
Ocasión	occasion		string	Cadena que indica una ocasión para la que este producto haría un regalo adecuado.
Estilos	styles		string	Matriz de cadenas de estilo para esta lista, cada una de las cuales es una cadena de texto de forma libre, como Formal o Steampunk. Un listado puede tener hasta dos estilos. Las cadenas de estilo válidas solo contienen letras, números y caracteres de espacio en blanco. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u)
Peso del elemento	item_weight		float	Peso numérico del producto medido en unidades establecidas en la unidad de peso del artículo.
Longitud del elemento	item_length		integer	Longitud numérica del producto medido en unidades establecidas en la unidad de dimensiones de elemento.
Ancho del elemento	item_width		float	Ancho numérico del producto medido en unidades establecidas en "unidad de dimensiones de elemento".
Alto del elemento	item_height		float	Alto numérico del producto medido en unidades establecidas en "unidad de dimensiones de elemento".
Unidad de peso del elemento	item_weight_unit		string	Cadena que define las unidades usadas para medir el peso del producto.
Unidad de dimensiones de elemento	item_dimensions_unit		string	Cadena que define las unidades usadas para medir las dimensiones del producto.
Es personalizable	is_personalizable		boolean	Cuando es true, esta lista es personalizable.
Identificadores de imagen	image_ids		string	Matriz de identificadores de imagen numéricos de las imágenes de una lista, que puede incluir hasta 10 imágenes.
Is Supply	is_supply		boolean	Cuando es true, etiqueta la lista como un producto de suministro; de lo contrario, indica que es un producto terminado. Ayuda a los compradores a localizar la lista bajo el encabezado Suministros. Requiere "quién hizo" y "cuando se hizo".
Es personalizable	is_customizable		boolean	Cuando es cierto, un comprador puede ponerse en contacto con el vendedor para obtener un pedido personalizado. El valor predeterminado es true cuando una tienda acepta pedidos personalizados. No se aplica a tiendas que no aceptan pedidos personalizados.
Es sujeto pasivo	is_taxable		boolean	Cuando es true, las tasas de impuestos aplicables a las tiendas se aplican a esta descripción al finalizar la compra.
Clasificación destacada	featured_ rank		integer	Posición numérica positiva no cero en las listas destacadas de la tienda con listados de clasificación 1 que aparecen en la posición más izquierda en la lista destacada en la página principal de una tienda.
Debe renovarse automáticamente	should_auto_renew		boolean	Cuando es true, renueva una lista durante cuatro meses tras la exprisión. Si se establece en true cuando anteriormente es false, etsy.com renueva la lista antes de que expire, pero el período de renovación comienza immidiatemente en lugar de extender la fecha de expiración de la lista. Se pierde el tiempo que queda sin usar en la lista. Las renovaciones generan cargos por la factura de un usuario.
Tipo	type		string	Indica si la lista es física o una descarga digital.
Canales	channels		string	Matriz de cadenas de identificador de canal enumeradas. Un canal es un lugar para que los vendedores lleguen a los compradores con el fin de realizar ventas.

Devoluciones

Un listado de una tienda, que contiene una cantidad de producto, título, descripción, precio, etc.

ShopListing: ShopListing

Actualizar una propiedad de lista

Id. de la operación:: ListingUpdateProperty

Actualiza o rellena la lista de propiedades que define las ofertas de productos para una lista. Cada oferta requiere un valor y un identificador de valor que sean válidos para un identificador de escalado asignado a la lista o que asigne a la lista con esta solicitud.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Id. de lista	listing_id	True	integer	Identificador numérico de la lista asociada a esta transacción.
Id. de propiedad	property_id	True	integer	Identificador único de una propiedad de lista de Etsy.
Identificadores de valor	value_ids	True	integer	Identificador numérico de una sola escala de medida de Etsy.com.
Valores	values	True	string	Matriz de cadenas de valor para varios valores de propiedad de lista de Etsy.
Id. de escalado	scale_id		integer	Identificador numérico de una sola escala de medida de Etsy.com.

Devoluciones

Representación de valores de datos estructurados.

ListingPropertyValue: ListingPropertyValue

Actualizar una tienda

Id. de la operación:: ShopUpdate

Actualizar una tienda. Supone que todos los parámetros de cadena se proporcionan en el idioma principal de la tienda.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Title	title		string	Una breve cadena de encabezado para la página principal de la tienda.
Anuncio	announcement		string	Cadena de anuncio a los compradores que se muestran en la página principal de la tienda.
Mensaje de venta	sale_message		string	Una cadena de mensaje enviada a los usuarios que completan una compra de esta tienda.
Mensaje de venta digital	digital_sale_message		string	Una cadena de mensaje enviada a los usuarios que compran un artículo digital de esta tienda.

Devoluciones

Una tienda creada por un usuario de Etsy.

Comprar: Shop

Buscar tiendas

Id. de la operación:: ShopSearch

Devuelve una lista de tiendas con el nombre coincidente.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Nombre de la tienda	shop_name	True	string	Cadena de nombre de la tienda.
Limit	limit		integer	El número máximo de resultados que se devolverán.
Desplazar	offset		integer	Número de registros que se omitirán antes de seleccionar el primer resultado.

Devoluciones

Un conjunto de registros shop.

Tiendas: Shops

Carga de una imagen de lista

Id. de la operación:: ListingUploadImage

Carga o asigna una imagen a una descripción identificada por un identificador de tienda con un identificador de descripción. Para cargar una nueva imagen, establezca el archivo de imagen como valor para el parámetro image. Puede asignar una imagen eliminada previamente a una lista mediante el identificador de imagen de la imagen eliminada en el parámetro id. de imagen de lista. Cuando una solicitud contiene valores de parámetro de id. de imagen y de lista, el punto de conexión carga la imagen solo en el parámetro image.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Id. de lista	listing_id	True	integer	Identificador numérico de la lista asociada a esta transacción.
Imagen	image		string	Cadena de nombre de archivo de un archivo que se va a cargar.
Id. de imagen de lista	listing_image_id		integer	Identificador numérico de la imagen de lista principal para esta transacción.
Rango	rank		integer	Posición numérica positiva no cero en las imágenes mostradas en una lista, con las imágenes de clasificación 1 que aparecen en la posición más izquierda de una lista.
Sobrescribir	overwrite		boolean	Cuando es true, esta solicitud reemplaza la imagen existente en un rango determinado.
Es marca de agua	is_watermarked		boolean	Cuando es true, indica que la imagen cargada tiene una marca de agua.

Devoluciones

Direcciones URL de referencia y metadatos de una imagen asociada a una lista específica. El url_fullxfull parámetro contiene la dirección URL del archivo de imagen binaria de tamaño completo.

ListingImage: ListingImage

Cargar un archivo de lista

Id. de la operación:: ListingUpload

Carga un nuevo archivo para una lista digital o asocia un archivo existente a una lista específica. Debe proporcionar el identificador de archivo de lista de un archivo existente o el nombre y los datos de archivo binarios para que se cargue un archivo. La asociación de un archivo existente a una lista física convierte la lista física en una lista digital, lo que elimina todos los costos de envío y cualquier variación de producto e inventario.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Id. de lista	listing_id	True	integer	Identificador numérico de la lista asociada a esta transacción.
Enumerar el identificador de archivo	listing_file_id		integer	Identificador numérico único de un archivo asociado a una lista digital.
Archivo	file	True	string	Archivo binario que se va a cargar.
Nombre	name		string	Cadena de nombre de archivo de un archivo que se va a cargar
Rango	rank		integer	Posición numérica positiva no cero en las imágenes mostradas en una lista, con las imágenes de clasificación 1 que aparecen en la posición más izquierda de una lista.

Devoluciones

Un archivo asociado a una lista digital.

ShopListingFile: ShopListingFile

Creación de un destino de perfil de envío

Id. de la operación:: ShippingCreateDestination

Crea un nuevo destino de envío, que establece el costo de envío, el transportista y la clase para un destino en un perfil de envío. Esto asigna los costos utilizando la moneda de la tienda asociada. Establezca el destino mediante iso de país de destino o región de destino; el país de destino ISO y la región de destino son mutuamente excluyentes: establezca uno o otro. Al establecer ambos desencadenadores, se produce el error 400. Si la solicitud no establece iso de país de destino ni región de destino, el destino predeterminado está en todas partes. También debe asignar un identificador de transportista de envío y una clase de correo o tanto días de entrega mínimo como días de entrega máximo.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Id. de perfil de envío	shipping_profile_id	True	integer	Identificador numérico del perfil de envío asociado a la lista.
Costo principal	primary_cost	True	float	El costo de envío solo a este país o región, medido en la moneda predeterminada de la tienda.
Costo secundario	secondary_cost	True	string	El costo del envío a este país o región con otro artículo, medido en la moneda predeterminada de la tienda.
destination_country_iso	destination_country_iso		string	destination_country_iso
destination_region	destination_region		string	destination_region
shipping_carrier_id	shipping_carrier_id		integer	shipping_carrier_id
mail_class	mail_class		string	mail_class
min_delivery_days	min_delivery_days		integer	min_delivery_days
max_delivery_days	max_delivery_days		integer	max_delivery_days

Devoluciones

Representa un destino de envío asignado a un perfil de envío.

ShopShippingProfileDestination: ShopShippingProfileDestination

Creación de un perfil de envío

Id. de la operación:: ShippingCreateProfile

Crea un nuevo perfil de envío. Puede pasar un código ISO de país o una región al crear un perfil de envío, pero no ambos. Solo se requiere uno. Debe pasar un identificador de transportista de envío y una clase de correo, o tanto días de entrega mínimo como máximo.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Title	title	True	string	Cadena de nombre de este perfil de envío.
ISO del país de origen	origin_country_iso	True	string	Código ISO del país desde el que se distribuye el listado.
Costo principal	primary_cost	True	float	El costo de envío solo a este país o región, medido en la moneda predeterminada de la tienda.
Costo secundario	secondary_cost	True	float	El costo del envío a este país o región con otro artículo, medido en la moneda predeterminada de la tienda.
Tiempo mínimo de procesamiento	min_processing_time	True	integer	El tiempo mínimo necesario para procesar para enviar listados con este perfil de envío.
Tiempo máximo de procesamiento	max_processing_time	True	integer	Tiempo máximo de procesamiento que la lista debe enviar.
Unidad de tiempo de procesamiento	processing_time_unit		string	Unidad que se usa para representar cuánto tiempo es un tiempo de procesamiento. Una semana equivale a 5 días laborables.
ISO del país de destino	destination_country_iso		string	Código ISO del país al que se envía el listado. Si es null, la solicitud establece el destino en la región de destino.
Región de destino	destination_region		string	Código de la región a la que se distribuye la lista. Una región representa un conjunto de países. Las regiones admitidas son Unión Europea y No Unión Europea (países de Europa que no están en la UE). Si no es ninguno, la solicitud establece el destino en la iso del país de destino o en todas partes si la iso del país de destino también es null.
Código postal de origen	origin_postal_code		string	Cadena de código postal (no necesariamente un número) para la ubicación desde la que se distribuye la lista.
Id. del transportista de envío	shipping_carrier_id		integer	El identificador único de un transportista de envío admitido, que se usa para calcular una fecha de entrega estimada.
Clase Mail	mail_class		string	Cadena de identificador único de la clase de correo de un transportista de envío, que se usa para calcular una fecha de entrega estimada.
Días de entrega mínimos	min_delivery_days		integer	El número mínimo de días laborables que un comprador puede esperar esperar para recibir su artículo comprado una vez que se haya enviado.
Máximo de días de entrega	max_delivery_days		integer	El número máximo de días laborables que un comprador puede esperar esperar para recibir su artículo comprado una vez que se haya enviado.

Devoluciones

ShopShippingProfile: ShopShippingProfile

Creación de una actualización de perfil de envío

Id. de la operación:: ShippingCreateUpgrade

Crea una nueva actualización del perfil de envío, que puede establecer un precio para una opción de envío, como un transportista alternativo o una entrega más rápida.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Id. de perfil de envío	shipping_profile_id	True	integer	Identificador numérico del perfil de envío asociado a la lista.
Tipo	type	True	string	Tipo de la actualización de envío. Nacional (0) o internacional (1).
Nombre de actualización	upgrade_name	True	string	Nombre de la actualización de envío que se muestra a los compradores al finalizar la compra, por ejemplo, prioridad de USPS.
Precio	price	True	float	Costo adicional de agregar la actualización de envío.
Precio secundario	secondary_price	True	float	Costo adicional de agregar la actualización de envío para cada artículo adicional.
Id. del transportista de envío	shipping_carrier_id		integer	Identificador único de un transportista de envío admitido, que se usa para calcular una fecha de entrega estimada.
Clase Mail	mail_class		string	Cadena de identificador único de la clase de correo de un transportista de envío, que se usa para calcular una fecha de entrega estimada.
Días de entrega mínimos	min_delivery_days		integer	min_delivery_days
Máximo de días de entrega	max_delivery_days		integer	El número máximo de días laborables que un comprador puede esperar esperar para recibir su artículo comprado una vez que se haya enviado.

Devoluciones

Representación de una opción de actualización de perfil de envío.

ShopShippingProfileUpgrade: ShopShippingProfileUpgrade

Creación de una traducción de lista

Id. de la operación:: ListingCreateTranslation

Crea una traducción de listados mediante el identificador y el idioma de la lista.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Id. de lista	listing_id	True	integer	Identificador numérico de la lista asociada a esta transacción.
Language	language	True	string	Etiqueta de idioma IETF para el idioma de esta traducción. Por ejemplo: de, en, es, fr, it, ja, nl, pl, pt, ru.
Title	title	True	string	Título de la lista de esta traducción.
Description	description	True	string	Descripción de la descripción de esta traducción.
Etiquetas	tags		string	Etiquetas de la lista de esta traducción.

Devoluciones

Representa los datos de traducción de un listado.

ListingTranslation: ListingTranslation

Crear un recibo de envío

Id. de la operación:: ReceiptCreateShipment

Envía información de seguimiento para un recibo de la tienda, que crea una entrada de envío de recibo de la tienda para el identificador de recibo especificado. Cada vez que envíes correctamente la información de seguimiento, Etsy envía un correo electrónico de notificación al usuario comprador. Cuando enviar BCC es true, Etsy también envía notificaciones de envío al vendedor. Cuando no se envía el código de seguimiento y el nombre del operador, el recibo solo se marca como enviado.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Id. de recepción	receipt_id	True	integer	Recibo para el que se va a enviar el seguimiento.
Código de seguimiento	tracking_code		string	Código de seguimiento de este recibo.
Nombre del operador	carrier_name		string	Nombre del operador de este recibo.
Enviar CCO	send_bcc		boolean	Si es true, la notificación de envío también se enviará al vendedor.

Devoluciones

El registro de una compra de una tienda. Los recibos de la tienda muestran valores monetarios con la moneda de la tienda.

ShopReceipt: ShopReceipt

Crear una lista de borradores

Id. de la operación:: ListingCreate

Crea un borrador físico del producto en una tienda en el canal Etsy.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Cantidad	quantity	True	integer	Número positivo distinto de cero de productos disponibles para la compra en el listado.
Title	title	True	string	Cadena de título de la lista. Las cadenas de título válidas solo contienen letras, números, signos de puntuación, símbolos matemáticos, caracteres de espacio en blanco, ™ , © y ® . (regex: /[^\p{L}\p{Nd}\p{P}\p{Sm}\p{Zs}™©®]/u) Solo puede usar los caracteres %, :, y + una vez cada uno.
Description	description	True	string	Cadena de descripción del producto para la venta en la lista.
Precio	price	True	float	Precio positivo distinto de cero del producto. (Los listados de productos vendidos son privados) Nota: El precio es el precio mínimo posible.
Quién hizo	who_made	True	string	Cadena enidcatada que hizo el producto. Ayuda a los compradores a localizar la descripción bajo el encabezado Hechos a mano. Requiere "is_supply" y "when_made".
Cuándo se hizo	when_made		string	Cadena para la era en la que el fabricante hizo el producto en esta lista. Ayuda a los compradores a localizar la descripción bajo el encabezado Vintage. Requiere "is_supply" y "who_made".
Id. de taxonomía	taxonomy_id	True	integer	Id. de taxonomía numérica de la lista. El vendedor administra los identificadores de taxonomía para su tienda.
Id. de perfil de envío	shipping_profile_id	True	integer	Identificador numérico del perfil de envío asociado a la lista.
Materials	materials		string	Matriz de cadenas de material para materiales utilizados en el producto. Las cadenas de materiales válidas solo contienen letras, números y caracteres de espacio en blanco. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u)
Id. de sección de tienda	shop_section_id		integer	Identificador numérico de la sección de la tienda para este listado.
Procesamiento mínimo	processing_min		integer	Número mínimo de días necesarios para procesar esta lista.
Procesamiento máximo	processing_max		integer	Número máximo de días necesarios para procesar esta lista.
Etiquetas	tags		string	Matriz de cadenas de etiqueta para la lista. Las cadenas de etiqueta válidas solo contienen letras, números, caracteres de espacio en blanco, -, ', ™ , © y ® . (regex: /[^\p{L}\p{Nd}\p{Zs}-'™©®]/u)
Destinatario	recipient		string	Cadena que indica a una persona para la que este producto haría un regalo adecuado.
Ocasión	occasion		string	Cadena que indica una ocasión para la que este producto haría un regalo adecuado.
Estilos	styles		string	Matriz de cadenas de estilo para esta lista, cada una de las cuales es una cadena de texto de forma libre, como Formal o Steampunk. Un listado puede tener hasta dos estilos. Las cadenas de estilo válidas solo contienen letras, números y caracteres de espacio en blanco. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u)
Peso del elemento	item_weight		float	Peso numérico del producto medido en unidades establecidas en la unidad de peso del artículo.
Longitud del elemento	item_length		integer	Longitud numérica del producto medido en unidades establecidas en la unidad de dimensiones de elemento.
Ancho del elemento	item_width		float	Ancho numérico del producto medido en unidades establecidas en "unidad de dimensiones de elemento".
Alto del elemento	item_height		float	Alto numérico del producto medido en unidades establecidas en "unidad de dimensiones de elemento".
Unidad de peso del elemento	item_weight_unit		string	Cadena que define las unidades usadas para medir el peso del producto.
Unidad de dimensiones de elemento	item_dimensions_unit		string	Cadena que define las unidades usadas para medir las dimensiones del producto.
Es personalizable	is_personalizable		boolean	Cuando es true, esta lista es personalizable.
Identificadores de imagen	image_ids		string	Matriz de identificadores de imagen numéricos de las imágenes de una lista, que puede incluir hasta 10 imágenes.
Is Supply	is_supply		boolean	Cuando es true, etiqueta la lista como un producto de suministro; de lo contrario, indica que es un producto terminado. Ayuda a los compradores a localizar la lista bajo el encabezado Suministros. Requiere "quién hizo" y "cuando se hizo".
Es personalizable	is_customizable		boolean	Cuando es cierto, un comprador puede ponerse en contacto con el vendedor para obtener un pedido personalizado. El valor predeterminado es true cuando una tienda acepta pedidos personalizados. No se aplica a tiendas que no aceptan pedidos personalizados.
Es sujeto pasivo	is_taxable		boolean	Cuando es true, las tasas de impuestos aplicables a las tiendas se aplican a esta descripción al finalizar la compra.

Devoluciones

Un listado de una tienda, que contiene una cantidad de producto, título, descripción, precio, etc.

ShopListing: ShopListing

Crear una sección de tiendas

Id. de la operación:: ShopCreateSection

Crea una nueva sección en una tienda específica.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Title	title	True	string	Cadena de título de una sección de tienda.

Devoluciones

Una sección dentro de una tienda, en la que un usuario puede ordenar las descripciones.

ShopSection: ShopSection

Eliminar un archivo de la lista

Id. de la operación:: ListingDeleteFile

Al eliminar el archivo final de una lista digital, la lista se convierte en una lista física. La respuesta a una solicitud de eliminación devuelve una lista de los registros de archivo restantes asociados a la lista especificada.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Id. de lista	listing_id	True	integer	Identificador numérico de la lista asociada a esta transacción.
Enumerar el identificador de archivo	listing_file_id	True	integer	Identificador numérico único de un archivo asociado a una lista digital.

Eliminar un destino de perfil de envío

Id. de la operación:: ShippingDeleteProfileDestination

Elimina un destino de envío y quita la opción de destino de cada lista que usa el perfil de envío asociado. Un perfil de envío requiere al menos un destino de envío, por lo que este punto de conexión no puede eliminar el destino de envío final para cualquier perfil de envío. Para eliminar el destino de envío final de un perfil de envío, debe eliminar todo el perfil de envío.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Id. de perfil de envío	shipping_profile_id	True	integer	Identificador numérico del perfil de envío asociado a la lista.
Id. de destino del perfil de envío	shipping_profile_destination_id	True	integer	Identificador numérico del destino del perfil de envío en el perfil de envío asociado a la lista.

Eliminar un perfil de envío

Id. de la operación:: ShippingDeleteProfile

Elimina un perfil de envío mediante un identificador determinado.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Id. de perfil de envío	shipping_profile_id	True	integer	Identificador numérico del perfil de envío asociado a la lista.

Devoluciones

ShopShippingProfile: ShopShippingProfile

Eliminar una actualización de perfil de envío

Id. de la operación:: ShippingDeleteProfileUpgrade

Elimina una actualización de perfil de envío y quita la opción de actualización de cada lista que usa el perfil de envío asociado.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Id. de perfil de envío	shipping_profile_id	True	integer	Identificador numérico del perfil de envío.
Id. de actualización	upgrade_id	True	integer	Identificador numérico asociado a una actualización de envío

Eliminar una imagen de lista

Id. de la operación:: ListingDeleteImage

Elimina una imagen de lista. Una copia del archivo permanece en nuestros servidores, por lo que una imagen eliminada puede volver a asociarse con la descripción sin volver a cargar la imagen original.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Id. de lista	listing_id	True	integer	Identificador numérico de la lista asociada a esta transacción.
Id. de imagen de lista	listing_image_id	True	integer	Identificador numérico de la imagen de lista principal para esta transacción.

Eliminar una lista

Id. de la operación:: ListingDelete

Esta acción elimina una descripción de la tienda. Una lista solo se puede eliminar si el estado es uno de los siguientes: SOLD_OUT, DRAFT, EXPIRED, INACTIVE, ACTIVE y is_available o ACTIVE y tiene marcas de vendedor: SUPRESSED (congelado), VACATION, CUSTOM_SHOPS (patrón), SELL_ON_FACEBOOK

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de lista	listing_id	True	integer	Identificador numérico de la lista asociada a esta transacción.

Eliminar una propiedad de lista

Id. de la operación:: ListingDeleteProperty

Elimina una propiedad de una lista.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Id. de lista	listing_id	True	integer	Identificador numérico de la lista asociada a esta transacción.
Id. de propiedad	property_id	True	integer	Identificador único de una propiedad de lista de Etsy.

Obtención de destinos de perfil por perfil de envío

Id. de la operación:: ShippingGetDestinations

Recupera una lista de objetos de destino de envío asociados a un perfil de envío.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Id. de perfil de envío	shipping_profile_id	True	integer	Identificador numérico del perfil de envío asociado a la lista.
Limit	limit		integer	El número máximo de resultados que se devolverán.
Desplazar	offset		integer	Número de registros que se omitirán antes de seleccionar el primer resultado.

Devoluciones

Representa una lista de objetos de destino de envío.

ShopShippingProfileDestinations: ShopShippingProfileDestinations

Obtención de direcciones de usuario

Id. de la operación:: UserGetAddresses

Recupere una lista de direcciones de usuario.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Limit	limit		integer	El número máximo de resultados que se devolverán.
Desplazar	offset		integer	Número de registros que se omitirán antes de seleccionar el primer resultado.

Devoluciones

Representa varios registros UserAddress.

UserAddresses: UserAddresses

Obtención de la tienda por identificador de propietario

Id. de la operación:: ShopGetByOwnerID

Recupera la tienda identificada por el identificador de usuario del propietario de la tienda.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de usuario	user_id	True	string	Identificador numérico de usuario del usuario propietario de esta tienda.

Devoluciones

Una tienda creada por un usuario de Etsy.

Comprar: Shop

Obtención de nodos de taxonomía de vendedores

Id. de la operación:: ListingGetTaxonomyNodes

Recupera el árbol de jerarquía completo de los nodos de taxonomía del vendedor.

Devoluciones

Lista de nodos de taxonomía del árbol de taxonomía del vendedor.

SellerTaxonomyNodes: SellerTaxonomyNodes

Obtención de propiedades del producto por identificador de taxonomía

Id. de la operación:: ListingGetPropertiesByTaxonomy

Recupera una lista de propiedades de producto, con escalas y valores aplicables, compatibles con un identificador de taxonomía de vendedor específico.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de taxonomía	taxonomy_id	True	string	Identificador numérico único de un nodo de taxonomía etsy, que es una categoría de metadatos para las listas organizadas en el árbol de jerarquía de taxonomía del vendedor.

Devoluciones

Lista de definiciones de propiedades de producto.

TaxonomyNodeProperties: TaxonomyNodeProperties

Obtención de un pago a partir de un identificador de entrada del libro de contabilidad de la cuenta de pago

Id. de la operación:: PaymentGetEntryID

Obtenga un pago a partir de un identificador de entrada del libro de contabilidad de cuenta de pago, si procede.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Identificadores de entrada del libro de contabilidad	ledger_entry_ids	True	string	Matriz de enteros.

Devoluciones

Representa varios pagos realizados con pagos etsy. Todos los importes monetarios están en centavos de USD a menos que se especifique lo contrario.

Payments: Payments

Obtención de una transacción

Id. de la operación:: TransactionGet

Recupera una transacción por identificador de transacción.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Id. de transacción	transaction_id	True	integer	Identificador numérico único de una transacción.

Devoluciones

Objeto de transacción asociado a un recibo de la tienda. Etsy genera una transacción por lista comprada como registrada en el recibo del pedido.

ShopReceiptTransaction: ShopReceiptTransaction

Obtener actualizaciones de perfil de envío

Id. de la operación:: ShippingGetProfileUpgrades

Recupera la lista de actualizaciones de perfil de envío asignadas a un perfil de envío específico.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Id. de perfil de envío	shipping_profile_id	True	integer	Identificador numérico del perfil de envío asociado a la lista.

Devoluciones

Lista de opciones de actualización de envío.

ShopShippingProfileUpgrades: ShopShippingProfileUpgrades

Obtener el inventario de una lista

Id. de la operación:: ListingGetInventory

Recupera el registro de inventario de una lista. Los listados que no editó con las herramientas de inventario de Etsy.com no tienen registros de inventario. Este punto de conexión devuelve datos de SKU si es el propietario de los registros de inventario que se capturan.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de lista	listing_id	True	integer	Identificador numérico de la lista asociada a esta transacción.
Includes	includes		string	Cadena enumerada que adjunta una asociación válida.

Devoluciones

Representación del registro de inventario de una sola lista con asociaciones

ListingInventoryWithAssociations: ListingInventoryWithAssociations

Obtener el producto de una descripción

Id. de la operación:: ListingGetProduct

Recupere un producto de lista por identificador.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de lista	listing_id	True	integer	Lista para la que se va a devolver un producto de descripción.
Id. del producto	product_id	True	integer	Identificador numérico de un producto específico adquirido en una lista.

Devoluciones

Representación de un producto para una lista.

ListingInventoryProduct: ListingInventoryProduct

Obtener la dirección del usuario

Id. de la operación:: UserGetAddress

Recupera la dirección del usuario. El desarrollo de este punto de conexión está en curso. Solo devolverá una respuesta 501.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de dirección de usuario	user_address_id	True	integer	Identificador numérico de la dirección del usuario.

Devoluciones

Representa la dirección de un usuario.

UserAddress: UserAddress

Obtener la oferta de una descripción

Id. de la operación:: ListingGetOffering

Obtener una oferta para una descripción.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de lista	listing_id	True	integer	Identificador numérico de la lista asociada a esta transacción.
Id. del producto	product_id	True	integer	Identificador numérico del producto asociado a esta transacción.
Id. de oferta de producto	product_offering_id	True	integer	Identificador numérico de la oferta de producto asociada a esta transacción.

Devoluciones

Representación de una oferta para una lista.

ListingInventoryProductOffering: ListingInventoryProductOffering

Obtener la propiedad de una descripción (Beta)

Id. de la operación:: ListingGetProperty

Recupera la propiedad de una lista. El desarrollo de este punto de conexión está en curso. Solo devolverá una respuesta 501.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de lista	listing_id	True	integer	Identificador numérico de la lista asociada a esta transacción.
Id. de propiedad	property_id	True	integer	Identificador único de una propiedad de lista de Etsy.

Devoluciones

Representación de valores de datos estructurados.

ListingPropertyValue: ListingPropertyValue

Obtener la traducción de una lista

Id. de la operación:: ListingGetTranslation

Devuelve la traducción de una lista en el idioma especificado.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Id. de lista	listing_id	True	integer	Identificador numérico de la lista asociada a esta transacción.
Language	language	True	string	Etiqueta de idioma IETF para el idioma de esta traducción. Por ejemplo: de, en, es, fr, it, ja, nl, pl, pt, ru.

Devoluciones

Representa los datos de traducción de un listado.

ListingTranslation: ListingTranslation

Obtener la transacción de un recibo

Id. de la operación:: TransactionReceipt

Recupera la lista de transacciones asociadas a un recibo específico.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Id. de recepción	receipt_id	True	integer	Identificador numérico del recibo asociado a esta transacción.

Devoluciones

Un conjunto de recursos de transacción de recibos de tienda

ShopReceiptTransactions: ShopReceiptTransactions

Obtener la transacción de una tienda

Id. de la operación:: TransactionGetShop

Recupera la lista de transacciones asociadas a una tienda.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Limit	limit		integer	El número máximo de resultados que se devolverán.
Desplazar	offset		integer	Número de registros que se omitirán antes de seleccionar el primer resultado.

Devoluciones

Un conjunto de recursos de transacción de recibos de tienda

ShopReceiptTransactions: ShopReceiptTransactions

Obtener las entradas del libro de contabilidad de una cuenta de pago de la tienda

Id. de la operación:: PaymentLedgerEntries

Recupere las entradas del libro de contabilidad de la cuenta de pago de una tienda.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Mínimo creado	min_created	True	integer	Marca de tiempo de unix más antigua para cuando se creó un registro.
Máximo creado	max_created	True	integer	Marca de tiempo de Unix más reciente para cuando se creó un registro.
Limit	limit		integer	El número máximo de resultados que se devolverán.
Desplazar	offset		integer	Número de registros que se omitirán antes de seleccionar el primer resultado.

Devoluciones

Un conjunto de recursos de entrada del libro de contabilidad de cuentas de pago

PaymentAccountLedgerEntries: PaymentAccountLedgerEntries

Obtener las imágenes de una lista

Id. de la operación:: ListingGetImages

Recupera todos los recursos de imagen de lista para una lista con un identificador de descripción específico.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Id. de lista	listing_id	True	integer	Identificador numérico de la lista asociada a esta transacción.

Devoluciones

Representa una lista de recursos de imagen de lista, cada uno de los cuales contiene las direcciones URL de referencia y los metadatos de una imagen.

ListingImages: ListingImages

Obtener las imágenes de variación de la lista

Id. de la operación:: ListingGetVariation

Obtiene todas las imágenes de variación de una lista.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Id. de lista	listing_id	True	integer	Identificador numérico de la lista asociada a esta transacción.

Devoluciones

Representa varias imágenes de variación de lista.

ListingVariationImages: ListingVariationImages

Obtener las propiedades de una lista

Id. de la operación:: ListingGetProperties

Devuelve una lista de las propiedades de una lista.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Id. de lista	listing_id	True	integer	Identificador numérico de la lista asociada a esta transacción.

Devoluciones

Representa varios valores de propiedad de lista.

ListingPropertyValues: ListingPropertyValues

Obtener listados activos

Id. de la operación:: ListingGetActive

Lista de todas las listas activas en Etsy paginada por su fecha de creación. Sin las listas de ordenación se devolverán de forma predeterminada más reciente.

Parámetros

Nombre	Clave	Tipo	Description
Limit	limit	integer	El número máximo de resultados que se devolverán.
Desplazar	offset	integer	Número de registros que se omitirán antes de seleccionar el primer resultado.
Includes	keywords	string	Término o frase de búsqueda que debe aparecer en todos los resultados.
Ordenar por	sort_on	string	Valor en el que se va a ordenar un resultado de búsqueda de listados. NOTA: ordenar solo funciona cuando se combina con una de las opciones de búsqueda (palabras clave, región, etc.).
Criterio de ordenación	sort_order	string	Orden ascendente(ascendente) o descendente(abajo) por el que se ordenan las descripciones. NOTA: sort_order solo funciona cuando se combina con una de las opciones de búsqueda (palabras clave, región, etc.).
Precio mínimo	min_price	float	El precio mínimo de los listados que se van a devolver mediante un resultado de búsqueda.
Precio máximo	max_price	float	El precio máximo de los listados que se van a devolver mediante un resultado de búsqueda.
Id. de taxonomía	taxonomy_id	integer	Id. de taxonomía numérica de la lista. El vendedor administra los identificadores de taxonomía para su tienda.
Ubicación de la tienda	shop_location	string	Filtra por ubicación de la tienda. Si no se puede analizar la ubicación, Etsy responde con un error.

Devoluciones

Un conjunto de recursos de descripción de tiendas.

ShopListings: ShopListings

Obtener listados activos por tienda

Id. de la operación:: ListingGetActiveByShop

Recupera una lista de todas las listas activas de Etsy en una tienda específica, paginada por fecha de creación de la lista.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Limit	limit		integer	El número máximo de resultados que se devolverán.
Desplazar	offset		integer	Número de registros que se omitirán antes de seleccionar el primer resultado.
Includes	keywords		string	Término o frase de búsqueda que debe aparecer en todos los resultados.

Devoluciones

Un conjunto de recursos de descripción de tiendas.

ShopListings: ShopListings

Obtener listados destacados por tienda

Id. de la operación:: ListingGetFeatured

Recupera listados asociados a una tienda destacada.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Limit	limit		integer	El número máximo de resultados que se devolverán.
Desplazar	offset		integer	Número de registros que se omitirán antes de seleccionar el primer resultado.

Devoluciones

Un conjunto de recursos de descripción de tiendas.

ShopListings: ShopListings

Obtener listados por identificador

Id. de la operación:: ListingGetByID

Permite consultar varios identificadores de lista a la vez. Limite 100 identificadores como máximo por consulta.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Identificadores de lista	listing_ids	True	string	Matriz de identificadores numéricos para los listados en una tienda etsy específica.
Includes	includes		string	Cadena enumerada que asocia una asociación válida.

Devoluciones

Un conjunto de recursos de descripción de tiendas con asociaciones.

ShopListingsWithAssociations: ShopListingsWithAssociations

Obtener listados por identificador de sección de la tienda

Id. de la operación:: ListingGetBySectionID

Recupera todos los listados de la sección de una tienda específica.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Identificadores de sección de tienda	shop_section_ids	True	string	Matriz de identificadores numéricos para todas las secciones de una tienda etsy específica.
Limit	limit		integer	El número máximo de resultados que se devolverán.
Desplazar	offset		integer	Número de registros que se omitirán antes de seleccionar el primer resultado.
Ordenar por	sort_on		string	Valor en el que se va a ordenar un resultado de búsqueda de listados.
Criterio de ordenación	sort_order		string	Orden ascendente(ascendente) o descendente(abajo) por el que se ordenan las descripciones.

Devoluciones

Un conjunto de recursos de descripción de tiendas.

ShopListings: ShopListings

Obtener listados por recibo de la tienda

Id. de la operación:: ListingGetByReceipt

Obtiene todas las listas asociadas a un recibo.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico del recibo asociado a esta transacción.
Id. de recepción	receipt_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Limit	limit		integer	El número máximo de resultados que se devolverán.
Desplazar	offset		integer	Número de registros que se omitirán antes de seleccionar el primer resultado.

Devoluciones

Un conjunto de recursos de descripción de tiendas.

ShopListings: ShopListings

Obtener listados por tienda

Id. de la operación:: ListingGetShop

Devuelve listados que pertenecen a una tienda. Los listados se pueden filtrar mediante el parámetro state.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Estado	State		string	Cadena enumerada de cualquiera de: activa o inactiva.
Limit	limit		integer	El número máximo de resultados que se devolverán.
Desplazar	offset		integer	Número de registros que se omitirán antes de seleccionar el primer resultado.
Ordenar por	Sort On		string	Valor en el que se va a ordenar un resultado de búsqueda de listados.
Criterio de ordenación	Sort Order		string	Orden ascendente(ascendente) o descendente(abajo) por el que se ordenan las descripciones.

Devoluciones

Un conjunto de recursos de descripción de tiendas.

ShopListings: ShopListings

Obtener perfiles de envío

Id. de la operación:: ShippingProfiles

Recupera una lista de perfiles de envío disponibles en la tienda etsy específica identificada por su identificador de tienda.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.

Devoluciones

ShopShippingProfile: ShopShippingProfile

Obtener recibos

Id. de la operación:: ReceiptsGet

Solicita los recibos de la tienda desde una tienda específica, sin filtrar o filtrar por intervalo de identificadores de recibo o desplazamiento, fecha, pago o compras enviadas.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Mínimo creado	min_created		integer	Marca de tiempo de unix más antigua para cuando se creó un registro.
Máximo creado	max_created		integer	Marca de tiempo de Unix más reciente para cuando se creó un registro.
Última modificación más antigua	min_last_modified		integer	Marca de tiempo de unix más antigua para cuando un registro cambió por última vez.
Última modificación	max_last_modified		integer	Marca de tiempo de Unix más reciente para cuando un registro cambió por última vez.
Limit	limit		integer	El número máximo de resultados que se devolverán.
Desplazar	offset		integer	Número de registros que se omitirán antes de seleccionar el primer resultado.
Se pagó	was_paid		boolean	Cuando es true, el vendedor recibió el pago de los productos en este recibo.
Se envió	was_shipped		boolean	Cuando es true, el vendedor envió los productos en este recibo.

Devoluciones

Los recibos de una tienda específica.

ShopReceipts: ShopReceipts

Obtener revisiones

Id. de la operación:: ReviewsGet

Recupera las revisiones de una tienda dada su identificador.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Limit	limit		integer	El número máximo de resultados que se devolverán.
Desplazar	offset		integer	Número de registros que se omitirán antes de seleccionar el primer resultado.

Devoluciones

Un conjunto de registros de revisión de transacciones dejados por Los usuarios.

TransactionReviews: TransactionReviews

Obtener secciones de la tienda

Id. de la operación:: ShopGetSections

Recupera la lista de secciones de la tienda en una tienda específica identificada por el identificador de la tienda.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.

Devoluciones

Todas las secciones de una tienda sprecific.

ShopSections: ShopSections

Obtener todos los archivos de lista

Id. de la operación:: ListingGetFiles

Recupera todos los archivos asociados a la lista digital especificada. La solicitud de archivos de una lista física devuelve un resultado vacío.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico de la lista asociada a esta transacción.
Id. de lista	listing_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.

Devoluciones

Representa varios ShopListingFiles.

ShopListingFiles: ShopListingFiles

Obtener transportistas de envío

Id. de la operación:: ShippingCarriers

Recupera una lista de los transportistas de envío disponibles y las clases de correo asociadas a ellas para un país determinado.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
ISO del país de origen	origin_country_iso	True	string	Código ISO del país desde el que se distribuye el listado.

Devoluciones

Representa varios ShippingCarriers.

ShippingCarriers: ShippingCarriers

Obtener un archivo de una lista

Id. de la operación:: ListingGetFile

Recupera un único archivo asociado a la lista digital especificada. La solicitud de un archivo de una lista física devuelve un resultado vacío.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Id. de lista	listing_id	True	integer	Identificador numérico de la lista asociada a esta transacción.
Enumerar el identificador de archivo	listing_file_id	True	integer	Identificador numérico único de un archivo asociado a una lista digital.

Devoluciones

Un archivo asociado a una lista digital.

ShopListingFile: ShopListingFile

Obtener un pago a partir de un recibo específico

Id. de la operación:: PaymentGetReceipt

Recupera un pago de un recibo específico, identificado por id. de recibo, de una tienda específica, identificada por el identificador de la tienda.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Id. de recepción	receipt_id	True	string	Identificador numérico del recibo asociado a esta transacción.

Devoluciones

Representa varios pagos realizados con pagos etsy. Todos los importes monetarios están en centavos de USD a menos que se especifique lo contrario.

Payments: Payments

Obtener un perfil de envío

Id. de la operación:: ShippingGetProfile

Recupera un perfil de envío al que hace referencia el identificador del perfil de envío.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Id. de perfil de envío	shipping_profile_id	True	integer	Identificador numérico del perfil de envío asociado a la lista.

Obtener un recibo

Id. de la operación:: ReceiptGet

Recupera un recibo, identificado por un identificador de recibo, de una tienda etsy.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Id. de recepción	receipt_id	True	integer	Identificador numérico del recibo asociado a esta transacción.

Devoluciones

El registro de una compra de una tienda. Los recibos de la tienda muestran valores monetarios con la moneda de la tienda.

ShopReceipt: ShopReceipt

Obtener una imagen de lista

Id. de la operación:: ListingGetImage

Recupera las referencias y los metadatos de una imagen de lista con un identificador de imagen específico.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Id. de lista	listing_id	True	integer	Identificador numérico de la lista asociada a esta transacción.
Id. de imagen de lista	listing_image_id	True	integer	Identificador numérico de la imagen de lista principal para esta transacción.

Devoluciones

Direcciones URL de referencia y metadatos de una imagen asociada a una lista específica. El url_fullxfull parámetro contiene la dirección URL del archivo de imagen binaria de tamaño completo.

ListingImage: ListingImage

Obtener una lista

Id. de la operación:: ListingGet

Recupera un registro de lista mediante el identificador de la lista.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de lista	listing_id	True	integer	Identificador numérico de la lista asociada a esta transacción.
Includes	includes		string	Cadena enumerada que asocia una asociación válida. Las entradas aceptables son "shop", "images" y "user".

Obtener una lista de pagos

Id. de la operación:: PaymentsGet

Recupera una lista de pagos de una tienda identificada por el identificador de la tienda. También puede filtrar los resultados mediante una lista de identificadores de pago.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Identificador de pago	payment-ids	True	string	Matriz separada por comas de números de identificadores de pago.

Devoluciones

Representa varios pagos realizados con pagos etsy. Todos los importes monetarios están en centavos de USD a menos que se especifique lo contrario.

Payments: Payments

Obtener usuario

Id. de la operación:: UserGet

Devuelve el perfil de usuario para el usuario identificado por un identificador de usuario.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de usuario	user_id	True	integer	Identificador numérico positivo distinto de cero único para un usuario.

Devoluciones

Representa un único usuario del sitio

Usuario: User

Ping

Id. de la operación:: Ping

Compruebe para confirmar la conectividad con la API de Etsy con una aplicación.

Devoluciones

Confirmación de que la aplicación actual tiene acceso a Open API

Peste: Pong

Recuperar las transacciones de una lista

Id. de la operación:: TransactionsListing

Recupera la lista de transacciones asociadas a una lista.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Id. de lista	listing_id	True	integer	Identificador numérico de la lista asociada a esta transacción.
Limit	limit		integer	El número máximo de resultados que se devolverán.
Desplazar	offset		integer	Número de registros que se omitirán antes de seleccionar el primer resultado.

Devoluciones

Un conjunto de recursos de transacción de recibos de tienda

ShopReceiptTransactions: ShopReceiptTransactions

Sección Obtener tienda

Id. de la operación:: ShopGetSection

Recupera una sección de tiendas, a la que hace referencia el identificador de sección y el identificador de la tienda.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Id. de tienda	shop_id	True	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Id. de sección de tienda	shop_section_id	True	integer	Identificador numérico de una sección de una tienda de Etsy específica.

Devoluciones

Una sección dentro de una tienda, en la que un usuario puede ordenar las descripciones.

ShopSection: ShopSection

Definiciones

ShopListing

Un listado de una tienda, que contiene una cantidad de producto, título, descripción, precio, etc.

Nombre	Ruta de acceso	Tipo	Description
Id. de lista	listing_id	integer	Identificador numérico de la lista asociada a esta transacción.
Id. de usuario	user_id	integer	Identificador numérico del usuario que publica la lista.
Id. de tienda	shop_id	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Title	title	string	Cadena de título de la lista. Las cadenas de título válidas solo contienen letras, números, signos de puntuación, símbolos matemáticos, caracteres de espacio en blanco, ™ , © y ® . (regex: /[^\p{L}\p{Nd}\p{P}\p{Sm}\p{Zs}™©®]/u) Solo puede usar los caracteres %, :, y + una vez cada uno.
Description	description	string	Cadena de descripción del producto para la venta en la lista.
Estado	state	State	Cadena enumerada de cualquiera de: activa o inactiva. Nota: Al establecer un borrador de lista en activo, también se publicará la lista en etsy.com.
Marca de tiempo de creación	creation_timestamp	integer	Tiempo de creación de la lista, en segundos de época.
Marca de tiempo final	ending_timestamp	integer	Hora de expiración de la lista, en segundos de época.
Marca de tiempo de creación original	original_creation_timestamp	integer	Tiempo de creación de la lista, en segundos de época.
Marca de tiempo de última modificación	last_modified_timestamp	integer	Hora de la última actualización de la lista, en segundos de época.
Marca de tiempo del último cambio de estado	state_timestamp	integer	Fecha y hora del último cambio de estado de esta lista.
Cantidad	quantity	integer	Número positivo distinto de cero de productos disponibles para la compra en el listado. Nota: La cantidad de lista es la suma de las cantidades de ofertas disponibles. Puede solicitar las cantidades de ofertas individuales del recurso ListingInventory mediante el punto de conexión obtener el inventario de listados.
Id. de sección de tienda	shop_section_id	integer	Identificador numérico de una sección de una tienda de Etsy específica.
Clasificación destacada	featured_rank	integer	Posición numérica positiva no cero en las listas destacadas de la tienda, con listados de clasificación 1 que aparecen en la posición más izquierda en la lista destacada en la página principal de una tienda.
URL	url	string	Dirección URL completa de la página de la lista en Etsy.
Número de favores	num_favorers	integer	Número de usuarios que marcaron este listado como favorito.
No sujeto pasivo	non_taxable	boolean	Cuando es true, los tipos de impuestos aplicables de la tienda no se aplican a este listado en el momento de la compra.
Es personalizable	is_customizable	boolean	Cuando es cierto, un comprador puede ponerse en contacto con el vendedor para obtener un pedido personalizado. El valor predeterminado es true cuando una tienda acepta pedidos personalizados. No se aplica a tiendas que no aceptan pedidos personalizados.
Es peronalizable	is_personalizable	boolean	Cuando es true, esta lista es personalizable. El valor predeterminado es null.
La personalización es necesaria	personalization_is_required	boolean	Cuando es true, esta lista requiere personalización. El valor predeterminado es null.
Número máximo de caracteres de personalización	personalization_char_count_max	integer	Este valor entero representa la longitud máxima del mensaje de personalización introducido por el comprador.
Instrucciones de personalización	personalization_instructions	string	Cuando es true, esta lista requiere personalización. El valor predeterminado es null.
Tipo de lista	listing_type	boolean	Cadena de tipo enumerada que indica si la lista es física o una descarga digital.
Etiquetas	tags	array of string	Lista de cadenas de etiqueta para la lista. Las cadenas de etiqueta válidas solo contienen letras, números, caracteres de espacio en blanco, -, ', ™ , © y ® . (regex: /[^\p{L}\p{Nd}\p{Zs}\-'™©®]/u) El valor predeterminado es NULL.
Materials	materials	array of string	Lista de cadenas de material para materiales utilizados en el producto. Las cadenas de materiales válidas solo contienen letras, números y caracteres de espacio en blanco. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u) El valor predeterminado es NULL.
Id. de perfil de envío	shipping_profile_id	integer	Identificador numérico del perfil de envío asociado a la lista.
Días de procesamiento mínimos	processing_min	integer	Número mínimo de días necesarios para procesar esta lista. El valor predeterminado es NULL.
Número máximo de días de procesamiento	processing_max	integer	Número máximo de días necesarios para procesar esta lista. El valor predeterminado es NULL.
WhoMade	who_made	WhoMade	Cadena enumerada inidcated que hizo el producto. Ayuda a los compradores a localizar la descripción bajo el encabezado Hechos a mano. Requiere "is_supply" y "when_made".
WhenMade	when_made	WhenMade	Cadena enumerada para la era en la que el fabricante hizo el producto en esta lista. Ayuda a los compradores a localizar la descripción bajo el encabezado Vintage. Requiere "is_supply" y "who_made".
Producto de suministro	is_supply	boolean	Cuando es true, etiqueta la lista como un producto de suministro; de lo contrario, indica que es un producto terminado. Ayuda a los compradores a localizar la lista bajo el encabezado Suministros. Requiere "who_made" y "when_made".
Peso del elemento	item_weight	double	Peso numérico del producto medido en unidades establecidas en la unidad de peso del artículo. El valor predeterminado es NULL. Si se establece, el valor debe ser mayor que 0.
ItemWeightUnit	item_weight_unit	ItemWeightUnit	Cadena que define las unidades usadas para medir el peso del producto. El valor predeterminado es NULL.
Longitud del elemento	item_length	double	Longitud numérica del producto medido en unidades establecidas en la unidad de dimensiones de elemento. El valor predeterminado es NULL. Si se establece, el valor debe ser mayor que 0.
Ancho del elemento	item_width	double	Ancho numérico del producto medido en unidades establecidas en la unidad de dimensiones de elemento. El valor predeterminado es NULL. Si se establece, el valor debe ser mayor que 0.
Alto del elemento	item_height	double	Longitud numérica del producto medido en unidades establecidas en la unidad de dimensiones de elemento. El valor predeterminado es NULL. Si se establece, el valor debe ser mayor que 0.
ItemDimensionsUnit	item_dimensions_unit	ItemDimensionsUnit	Cadena que define las unidades usadas para medir las dimensiones del producto. El valor predeterminado es NULL.
Es privado	is_private	boolean	Cuando es true, se trata de una lista privada que pretende un comprador específico y oculta de la vista de la tienda.
Destinatario	recipient	Recipient	Cadena enumerada que indica a una persona para la que este producto haría un regalo adecuado. El valor predeterminado es NULL.
Ocasión	occasion	Occasion	Cadena enumerada que indica una ocasión para la que este producto haría un regalo adecuado. El valor predeterminado es NULL.
Style	style	array of string	Matriz de cadenas de estilo para esta lista, cada una de las cuales es una cadena de texto de forma libre, como Formal o Steampunk. Un listado puede tener hasta dos estilos. Las cadenas de estilo válidas solo contienen letras, números y caracteres de espacio en blanco. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u) El valor predeterminado es NULL.
Datos de archivo	file_data	string	Cadena que describe los archivos adjuntos a una lista digital.
Tiene variaciones	has_variations	boolean	Cuando es true, la lista tiene variaciones.
Debe renovarse automáticamente	should_auto_renew	boolean	Cuando es true, renueva una lista durante cuatro meses tras la exprisión. Si se establece en true cuando anteriormente es false, etsy.com renueva la lista antes de que expire, pero el período de renovación comienza immidiatemente en lugar de extender la fecha de expiración de la lista. Se pierde el tiempo que queda sin usar en la lista. Las renovaciones generan cargos por la factura de un usuario.
Language	language	string	Etiqueta de idioma IETF para el idioma predeterminado de la lista. Por ejemplo: `de`, `en`, `frnlitesja`, `pl`, , `pt`, . `ru`
Dinero	price	Money	Representación de una cantidad de dinero.
Id. de taxonomía	taxonomy_id	integer	Id. de taxonomía numérica de la lista. El vendedor administra los identificadores de taxonomía para su tienda. Consulte taxonomía de vendedores para obtener más información.

Dinero

Representación de una cantidad de dinero.

Nombre	Ruta de acceso	Tipo	Description
Importe	amount	integer	Cantidad de representada por estos datos.
Divisor	divisor	integer	Divisor que se va a representar la cantidad.
Código de moneda	currency_code	string	Código de moneda ISO para estos datos.

ShopListingFile

Un archivo asociado a una lista digital.

Nombre	Ruta de acceso	Tipo	Description
Enumerar el identificador de archivo	listing_file_id	integer	Identificador numérico único de un archivo asociado a una lista digital.
Id. de lista	listing_id	integer	Identificador numérico de la lista asociada a esta transacción.
Rango	rank	integer	Índice numérico de la posición de orden de visualización de este archivo en la lista, a partir de 1.
Filename	filename	string	Cadena de nombre de archivo de un archivo asociado a una lista digital.
Filesize	filesize	string	Cadena de tamaño de formato legible para el tamaño de un archivo.
Tamaño en bytes	size_bytes	integer	Número que indica el tamaño de un archivo, medido en bytes.
Tipo de archivo	filetype	string	Cadena de tipo que indica el tipo MIME de un archivo.
Crear marca de tiempo	create_timestamp	integer	Marca de tiempo numérica única de un archivo asociado a una lista digital.

ShopListingFiles

Representa varios ShopListingFiles.

Nombre	Ruta de acceso	Tipo	Description
Contar	count	integer	Número de ShopListingFiles que se devuelve..
Results	results	array of ShopListingFile	Matriz de recursos ShopListingFile.

ShopListings

Un conjunto de recursos de descripción de tiendas.

Nombre	Ruta de acceso	Tipo	Description
Contar	count	integer	Número de recursos de descripción de la tienda encontrados.
Results	results	array of ShopListing	Se encontraron los recursos de descripción de la tienda.

Usuario

Representa un único usuario del sitio

Nombre	Ruta de acceso	Tipo	Description
Id. de usuario	user_id	integer	Identificador numérico de un usuario. Este número también es un identificador de tienda válido para la tienda del usuario.
Nombre de inicio de sesión	login_name	string	Cadena de nombre de inicio de sesión del usuario.
Correo electrónico principal	primary_email	string	Cadena de dirección de correo electrónico para la dirección de correo electrónico principal del usuario.
Nombre	first_name	string	Nombre del usuario.
Apellido	last_name	string	Apellidos del usuario.
Marca de tiempo creada	create_timestamp	integer	Fecha y hora en que el usuario creó su cuenta, en segundos de época.
A la que hace referencia el identificador de usuario	referred_by_user_id	integer	Identificador numérico del usuario que hizo referencia a este usuario.
Uso de nuevos puntos de conexión de inventario	use_new_inventory_endpoints	boolean	Deprecated. Siempre es true.
¿Es vendedor?	is_seller	boolean	True si el usuario es vendedor.
Biografía	bio	string	Biografía del usuario.
Gender	gender	string	El sexo del usuario.
Mes de nacimiento	birth_month	string	Mes de nacimiento del usuario.
Cumpleaños	birth_day	string	Día de nacimiento del usuario.
Recuento de transacciones de compra	transaction_buy_count	integer	Número de transacciones en las que el usuario ha comprado.
Recuento de transacciones vendidas	transaction_sold_count	integer	Número de transacciones en las que el usuario ha vendido.

Comprar

Una tienda creada por un usuario de Etsy.

Nombre	Ruta de acceso	Tipo	Description
Id. de tienda	shop_id	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Id. de usuario	user_id	integer	Identificador numérico de usuario del usuario propietario de esta tienda.
Nombre de la tienda	shop_name	string	Cadena de nombre de la tienda.
Fecha de creación	create_date	integer	Fecha y hora en que se creó esta tienda, en segundos de época.
Title	title	string	Una breve cadena de encabezado para la página principal de la tienda.
Anuncio	announcement	string	Cadena de anuncio a los compradores que se muestran en la página principal de la tienda.
Código de moneda	currency_code	string	El código ISO (alfabético) para la moneda de la tienda. La tienda muestra todos los precios de esta moneda de forma predeterminada.
Está de vacaciones	is_vacation	boolean	Cuando es cierto, esta tienda no acepta compras.
Mensaje de vacaciones	vacation_message	string	La cadena de mensaje de la tienda se muestra cuando is_vacation es true.
Mensaje de venta	sale_message	string	Una cadena de mensaje enviada a los usuarios que completan una compra de esta tienda.
Mensaje de venta digital	digital_sale_message	string	Una cadena de mensaje enviada a los usuarios que compran un artículo digital de esta tienda.
Fecha actualizada	update_date	integer	Fecha y hora de la última actualización de la tienda, en segundos de época.
Recuento de listados activos	listing_active_count	integer	Número de listados activos en la tienda.
Recuento de listados digitales	digital_listing_count	integer	Número de listados digitales en la tienda.
Nombre de inicio de sesión	login_name	string	Cadena de nombre de inicio de sesión del propietario de la tienda.
Acepta solicitudes personalizadas	accepts_custom_requests	boolean	Cuando es true, la tienda acepta solicitudes de personalización.
Directiva de bienvenida	policy_welcome	string	La cadena de bienvenida de la directiva de la tienda (puede estar en blanco).
Directiva de pago	policy_payment	string	La cadena de la directiva de pago de la tienda (puede estar en blanco).
Directiva de envío	policy_shipping	string	La cadena de la directiva de envío de la tienda (puede estar en blanco).
Directiva de reembolso	policy_refunds	string	La cadena de la política de reembolso de la tienda (puede estar en blanco).
Directivas adicionales	policy_additional	string	Cadena de directivas adicionales de la tienda (puede estar en blanco).
Información del vendedor	policy_seller_info	string	La cadena de información del vendedor de la tienda (puede estar en blanco).
Fecha de actualización de directiva	policy_update_date	integer	Fecha y hora de la última actualización de las directivas de la tienda, en segundos de época.
Tiene directiva de recibo privado	policy_has_private_receipt_info	boolean	Cuando es true, los recibos de la UE muestran información privada.
Tiene directivas no estructuradas	has_unstructured_policies	boolean	Cuando es true, la tienda muestra campos de directiva no estructurados adicionales.
Directiva de privacidad	policy_privacy	string	La cadena de la política de privacidad de la tienda (puede estar en blanco).
Vacaciones autoreply	vacation_autoreply	string	La cadena de respuesta automática de la tienda se muestra en nuevas conversaciones cuando is_vacation es true.
URL	url	string	Cadena de dirección URL de esta tienda.
Dirección URL de imagen de banner	image_url_760x100	string	Cadena de dirección URL para la imagen de banner de esta tienda.
Número de favores	num_favorers	integer	Número de usuarios que marcaron esta tienda como favorito.
Languages	languages	array of string	Lista de cadenas de idioma para los idiomas inscritos en la tienda.
Dirección URL de imagen de icono	icon_url_fullxfull	string	Cadena de dirección URL de la imagen del icono de esta tienda.
Está usando directivas estructuradas	is_using_structured_policies	boolean	Cuando es true, la tienda aceptó el uso de directivas estructuradas.
Ha incorporado directivas estructuradas	has_onboarded_structured_policies	boolean	Cuando es true, la tienda aceptó O rechazó después de ver la incorporación de directivas estructuradas.
Incluir vínculo de formulario de disputa	include_dispute_form_link	boolean	Cuando es cierto, las políticas de esta tienda incluyen un vínculo a un formulario de disputa en línea de la UE.
¿Está incorporado Direct Checkout?	is_direct_checkout_onboarded	boolean	Cuando es cierto, la tienda se ha incorporado a Etsy Payments.
Se calcula el envío apto	is_calculated_eligible	boolean	Cuando es true, la tienda es elegible para perfiles de envío calculados. (Solo disponible en Estados Unidos y Canadá)
Se ha optado por participar en la promesa del comprador	is_opted_in_to_buyer_promise	boolean	Cuando es cierto, la tienda optó por la promesa del comprador.
Se basa en EE. UU.	is_shop_us_based	boolean	Cuando es cierto, la tienda se basa en estados Unidos.
Recuento de transacciones de ventas	transaction_sold_count	integer	El número total de transacciones de ventas para esta tienda
Envío desde ISO de país	shipping_from_country_iso	string	El país iso desde el que se envía la tienda.
ISO de ubicación de la tienda	shop_location_country_iso	string	El país iso donde se encuentra la tienda.
Recuento de revisión	review_count	integer	Número de reseñas de listados de tiendas en el último año.
Promedio de revisión	review_average	double	Puntuación media basada en opiniones de listados de tiendas en el último año.

ListingImage

Direcciones URL de referencia y metadatos de una imagen asociada a una lista específica. El url_fullxfull parámetro contiene la dirección URL del archivo de imagen binaria de tamaño completo.

Nombre	Ruta de acceso	Tipo	Description
Id. de lista	listing_id	integer	Identificador numérico de la lista asociada a esta transacción.
Id. de imagen de lista	listing_image_id	integer	Identificador numérico de la imagen de lista principal para esta transacción.
Código hexadecimal	hex_code	string	Cadena de webhex para el color promedio de la imagen, en notación webhex.
Valor rojo	red	integer	Valor rojo numérico igual al valor rojo promedio de la imagen, de 0 a 255 (color RGB).
Valor verde	green	integer	Valor rojo numérico igual al valor rojo promedio de la imagen, de 0 a 255 (color RGB).
Valor azul	blue	integer	Valor rojo numérico igual al valor rojo promedio de la imagen, de 0 a 255 (color RGB).
Valor de hue	hue	integer	El matiz numérico igual al tono medio de la imagen, de 0 a 360 (color HSV).
Valor de saturación	saturation	integer	Saturación numérica igual a la saturación media de la imagen, de 0 a 100 (color HSV).
Valor de brillo	brightness	integer	Brillo numérico igual al brillo medio de la imagen, de 0 a 100 (color HSV).
Es negro y blanco	is_black_and_white	boolean	Cuando es true, la imagen está en blanco y negro.
Hora de creación	creation_tsz	integer	Tiempo de creación de la imagen de lista, en segundos de época.
Rango	rank	integer	Posición numérica positiva no cero en las imágenes mostradas en una lista, con las imágenes de clasificación 1 que aparecen en la posición más izquierda de una lista.
Dirección URL de la imagen 75x75	url_75x75	string	Cadena url de una miniatura de 75 x 75 píxeles de la imagen.
Dirección URL de la imagen 170x135	url_170x135	string	Cadena url de una miniatura de 170 x 135 píxeles de la imagen.
Dirección URL de la imagen de 570xN	url_570xN	string	Cadena url de una miniatura de la imagen, no más de 570 píxeles de ancho con altura variable.
Dirección URL de imagen de tamaño completo	url_fullxfull	string	Cadena url de la imagen de tamaño completo, hasta 3000 píxeles en cada dimensión.
Alto de imagen de tamaño completo	full_height	integer	Alto numérico, medido en píxeles, de la imagen de tamaño completo a la que se hace referencia en url_fullxfull.
Ancho de imagen de tamaño completo	full_width	integer	Ancho numérico, medido en píxeles, de la imagen de tamaño completo a la que se hace referencia en url_fullxfull.

ListingImages

Representa una lista de recursos de imagen de lista, cada uno de los cuales contiene las direcciones URL de referencia y los metadatos de una imagen.

Nombre	Ruta de acceso	Tipo	Description
Contar	count	integer	Número de resultados.
Results	results	array of ListingImage	Lista de recursos solicitados.

ListingInventoryWithAssociations

Representación del registro de inventario de una sola lista con asociaciones

Nombre	Ruta de acceso	Tipo	Description
Products	products	array of ListingInventoryProduct	Matriz JSON de productos disponibles en una lista, incluso si solo un producto. Todos los nombres de campo de los blobs JSON están en minúsculas.
Price On Properties	price_on_property	array of integer	Matriz de enteros de identificadores de propiedad de lista únicos para las propiedades que cambian los precios del producto, si los hay. Por ejemplo, si cobra precios específicos para distintos productos de tamaño en la misma lista, esta matriz contiene el identificador de propiedad para el tamaño.
Cantidad en propiedades	quantity_on_property	array of integer	Matriz de enteros de identificadores de propiedad de lista únicos para las propiedades que cambian la cantidad de los productos, si los hay. Por ejemplo, si almacena cantidades específicas de diferentes productos de color en la misma lista, esta matriz contiene el identificador de propiedad para el color.
SKU en propiedades	sku_on_property	array of integer	Matriz de enteros de identificadores de propiedad de lista únicos para las propiedades que cambian la SKU del producto, si existe. Por ejemplo, si usa sku específicas para distintos productos de color en la misma lista, esta matriz contiene el identificador de propiedad para el color.
ShopListing	listing	ShopListing	Un listado de una tienda, que contiene una cantidad de producto, título, descripción, precio, etc.

ListingInventoryProduct

Representación de un producto para una lista.

Nombre	Ruta de acceso	Tipo	Description
Id. del producto	product_id	integer	Identificador numérico de un producto específico adquirido en una lista.
SKU	sku	string	Cadena de SKU para el producto
Está eliminado	is_deleted	boolean	Cuando es true, alguien eliminó este producto.
Offerings	offerings	array of ListingInventoryProductOffering	Lista de entradas de ofertas de productos para este producto.
Valores de propiedad	property_values	array of ListingPropertyValue	Lista de entradas de valor de propiedad para este producto.

ListingInventoryProductOffering

Representación de una oferta para una lista.

Nombre	Ruta de acceso	Tipo	Description
Id. de oferta	offering_id	integer	Identificador de la oferta de producto
Cantidad	quantity	integer	Cantidad de la oferta de producto
Está habilitado	is_enabled	boolean	Si la oferta se puede mostrar a los compradores o no.
Está eliminado	is_deleted	boolean	Si se ha eliminado o no la oferta.
Dinero	price	Money	Representación de una cantidad de dinero.

ListingPropertyValue

Representación de valores de datos estructurados.

Nombre	Ruta de acceso	Tipo	Description
Id. de propiedad	property_id	integer	Identificador numérico de la propiedad.
Nombre	property_name	string	Nombre de la propiedad.
Id. de escalado	scale_id	integer	Identificador numérico de la escala (si existe).
Nombre de escalado	scale_name	string	Etiqueta usada para describir la escala elegida (si existe).
Identificadores de valor	value_ids	array of integer	Identificadores numéricos de los valores de propiedad
Valores	values	array of string	Valores de propiedad

ListingInventory

Representación del registro de inventario de una sola lista.

Nombre	Ruta de acceso	Tipo	Description
Products	products	array of ListingInventoryProduct	Matriz JSON de productos disponibles en una lista, incluso si solo un producto. Todos los nombres de campo de los blobs JSON están en minúsculas.
Price On Properties	price_on_property	array of integer	Matriz de enteros de identificadores de propiedad de lista únicos para las propiedades que cambian los precios del producto, si los hay. Por ejemplo, si cobra precios específicos para distintos productos de tamaño en la misma lista, esta matriz contiene el identificador de propiedad para el tamaño.
Cantidad en propiedades	quantity_on_property	array of integer	Matriz de enteros de identificadores de propiedad de lista únicos para las propiedades que cambian la cantidad de los productos, si los hay. Por ejemplo, si almacena cantidades específicas de diferentes productos de color en la misma lista, esta matriz contiene el identificador de propiedad para el color.
SKU en propiedades	sku_on_property	array of integer	Matriz de enteros de identificadores de propiedad de lista únicos para las propiedades que cambian la SKU del producto, si existe. Por ejemplo, si usa sku específicas para distintos productos de color en la misma lista, esta matriz contiene el identificador de propiedad para el color.

ShopListingsWithAssociations

Un conjunto de recursos de descripción de tiendas con asociaciones.

Nombre	Ruta de acceso	Tipo	Description
Contar	count	integer	Número de recursos de descripción de la tienda encontrados.
Results	results	array of ShopListing	Se encontraron los recursos de descripción de la tienda.

ListingPropertyValues

Representa varios valores de propiedad de lista.

Nombre	Ruta de acceso	Tipo	Description
Contar	count	integer	Número de recursos de descripción de la tienda encontrados.
Results	results	array of ListingPropertyValue	Se encontraron los recursos de descripción de la tienda.

ShopReceiptTransactions

Un conjunto de recursos de transacción de recibos de tienda

Nombre	Ruta de acceso	Tipo	Description
Contar	count	integer	Número de recursos de transacción de recibo de tienda encontrados.
Results	results	array of ShopReceiptTransaction	Se encontraron los recursos de transacción de recibo de la tienda.

ShopReceiptTransaction

Objeto de transacción asociado a un recibo de la tienda. Etsy genera una transacción por lista comprada como registrada en el recibo del pedido.

Nombre	Ruta de acceso	Tipo	Description
Id. de transacción	transaction_id	integer	Identificador numérico único de una transacción.
Title	title	string	Cadena de título de la lista comprada en esta transacción.
Description	description	string	Cadena de descripción de la descripción comprada en esta transacción.
Id. de usuario del vendedor	seller_user_id	integer	Identificador de usuario numérico para el vendedor en esta transacción.
Identificador de usuario del comprador	buyer_user_id	integer	Identificador de usuario numérico para el comprador en esta transacción.
Marca de tiempo creada	create_timestamp	integer	Fecha y hora de creación de la transacción, en segundos de época.
Marca de tiempo de pago	paid_timestamp	integer	La fecha y hora de pago de la transacción, en segundos de época.
Marca de tiempo enviada	shipped_timestamp	integer	Fecha y hora de envío de la transacción, en segundos de época.
Cantidad	quantity	integer	Cantidad numérica de productos adquiridos en esta transacción.
Id. de imagen de lista	listing_image_id	integer	Identificador numérico de la imagen de lista principal para esta transacción.
Id. de recepción	receipt_id	integer	Identificador numérico del recibo asociado a esta transacción.
Es digital	is_digital	boolean	Cuando es true, la transacción registró la compra de una lista digital.
Datos de archivo	file_data	string	Cadena que describe los archivos adquiridos en esta transacción.
Id. de lista	listing_id	integer	Identificador numérico de la lista asociada a esta transacción.
Tipo de transacción	transaction_type	string	Cadena de tipo para la transacción, normalmente enumerando
Id. del producto	product_id	integer	Identificador numérico de un producto específico adquirido en una lista.
Dinero	price	Money	Representación de una cantidad de dinero.
Dinero	shipping_cost	Money	Representación de una cantidad de dinero.

ListingTranslation

Representa los datos de traducción de un listado.

Nombre	Ruta de acceso	Tipo	Description
Id. de lista	listing_id	integer	Identificador numérico de la lista.
Language	language	string	Etiqueta de idioma IETF (por ejemplo, "fr") para el idioma de esta traducción.
Title	title	string	Título de la lista de esta traducción.
Description	description	string	Descripción de la descripción de esta traducción.
Etiquetas	tags	array of string	Etiquetas de la lista de esta traducción.

ListingVariationImages

Representa varias imágenes de variación de lista.

Nombre	Ruta de acceso	Tipo	Description
Contar	count	integer	Recuento de imágenes de variación.
Results	results	array of ListingVariationImage	Resultados de las imágenes de variación.

ListingVariationImage

Representación de las asociaciones de variaciones e imágenes en una lista.

Nombre	Ruta de acceso	Tipo	Description
Id. de propiedad	property_id	integer	Identificador numérico de la propiedad.
Id. de valor	value_id	integer	Identificador numérico del valor.
Id. de imagen	image_id	integer	Identificador numérico de la imagen.

PaymentAccountLedgerEntries

Un conjunto de recursos de entrada del libro de contabilidad de cuentas de pago

Nombre	Ruta de acceso	Tipo	Description
Contar	count	integer	Número de recursos de entrada del libro de contabilidad de cuentas de pago encontrados.
Results	results	array of PaymentAccountLedgerEntry	Se encontraron los recursos de entrada del libro de contabilidad de la cuenta de pago.

PaymentAccountLedgerEntry

Representa una entrada en el libro de contabilidad de una tienda.

Nombre	Ruta de acceso	Tipo	Description
Id. de entrada	entry_id	integer	Identificador numérico de la entrada del libro de contabilidad.
Id. de libro de contabilidad	ledger_id	integer	Identificador numérico del libro de contabilidad.
Número de secuencia	sequence_number	integer	La secuencia permite ordenar cronológicamente las entradas del libro de contabilidad. Cuanto mayor sea la secuencia, más reciente será la entrada.
Importe	amount	integer	Cantidad de dinero acreditado en el libro de contabilidad.
Moneda	currency	string	Moneda de la entrada en el libro de contabilidad.
Description	description	string	Detalla qué tipo de entrada de libro de contabilidad es: un pago, reembolso, reversión de un reembolso erróneo, desembolsos, desembolsos devueltos, recoupment, crédito varios, débito varios o pago de facturas.
Saldo	balance	integer	Cantidad de dinero en el libro de contabilidad de la tienda el momento después de aplicar esta entrada.
Fecha de creación	create_date	integer	Fecha y hora en que se creó la entrada del libro de contabilidad en los segundos de época.

Payments

Representa varios pagos realizados con pagos etsy. Todos los importes monetarios están en centavos de USD a menos que se especifique lo contrario.

Nombre	Ruta de acceso	Tipo	Description
Contar	count	integer	Número de pagos en la respuesta.
Results	results	array of Payment	Lista de pagos.

Pago

Representa un pago realizado con Pagos etsy. Todos los importes monetarios están en centavos de USD a menos que se especifique lo contrario.

Nombre	Ruta de acceso	Tipo	Description
Identificador de pago	payment_id	integer	Un identificador numérico único para un pago a una tienda de Etsy específica.
Identificador de usuario del comprador	buyer_user_id	integer	Identificador numérico del usuario que pagó la compra.
Id. de tienda	shop_id	integer	Identificador numérico positivo distinto de cero único para una tienda etsy.
Id. de recepción	receipt_id	integer	Identificador numérico del recibo asociado a esta transacción.
Dinero	amount_gross	Money	Representación de una cantidad de dinero.
Dinero	amount_fees	Money	Representación de una cantidad de dinero.
Dinero	amount_net	Money	Representación de una cantidad de dinero.
Dinero	posted_gross	Money	Representación de una cantidad de dinero.
Dinero	posted_fees	Money	Representación de una cantidad de dinero.
Dinero	posted_net	Money	Representación de una cantidad de dinero.
Dinero	adjusted_gross	Money	Representación de una cantidad de dinero.
Dinero	adjusted_fees	Money	Representación de una cantidad de dinero.
Dinero	adjusted_net	Money	Representación de una cantidad de dinero.
Moneda	currency	string	Cadena de código ISO (alfabética) para la moneda del pago.
Moneda de la tienda	shop_currency	string	El código ISO (alfabético) para la moneda de la tienda. La tienda muestra todos los precios de esta moneda de forma predeterminada.
Moneda del comprador	buyer_currency	string	Cadena de moneda del comprador.
Id. de envío de usuarios	shipping_user_id	integer	Identificador numérico del usuario al que el vendedor envía el pedido.
Id. de dirección de envío	shipping_address_id	integer	Identificador numérico que identifica la dirección de envío.
Id. de dirección de facturación	billing_address_id	integer	Identificador numérico que identifica la dirección de facturación del comprador.
Estado	status	string	Cadena que indica el estado actual del pago, más comúnmente liquidado o autenticado.
Marca de tiempo enviada	shipped_timestamp	integer	Fecha y hora de envío de la transacción, en segundos de época.
Marca de tiempo creada	create_timestamp	integer	Fecha y hora de creación de la transacción, en segundos de época.
Actualizar marca de tiempo	update_timestamp	integer	Fecha y hora del último cambio en el ajuste de pago en segundos de época.
Ajustes de pago	payment_adjustments	array of PaymentAdjustment	Lista de objetos de reembolso en una transacción de pagos etsy. Todos los importes monetarios están en centavos de USD a menos que se especifique lo contrario.

PaymentAdjustment

Representa un reembolso, que se aplica a un pago anterior de Etsy. Todos los importes monetarios están en centavos de USD a menos que se especifique lo contrario.

Nombre	Ruta de acceso	Tipo	Description
Id. de ajuste de pago	payment_adjustment_id	integer	Identificador numérico de un ajuste de pago.
Identificador de pago	payment_id	integer	Un identificador numérico único para un pago a una tienda de Etsy específica.
Estado	status	string	Cadena de estado del ajuste de pago.
¿Se ha realizado correctamente?	is_success	boolean	Cuando es true, es probable que el ajuste de pago se complete correctamente.
Id. de usuario	user_id	integer	Identificador numérico del usuario (vendedor) que cumple la compra.
Código de motivo	reason_code	string	Cadena legible que describe el motivo del reembolso.
Importe total de ajuste	total_adjustment_amount	integer	Importe numérico total del reembolso en la moneda de pago.
Importe total de ajuste de la tienda	shop_total_adjustment_amount	integer	Cantidad numérica del reembolso en la moneda de la tienda.
Importe total de ajuste	buyer_total_adjustment_amount	integer	Cantidad numérica del reembolso en la moneda del comprador.
Importe total de ajuste de la tarifa	total_fee_adjustment_amount	integer	Cantidad numérica de tarifas de procesamiento de tarjetas asociadas a un ajuste de pago.
Marca de tiempo creada	create_timestamp	integer	Fecha y hora de creación de la transacción, en segundos de época.
Actualizar marca de tiempo	update_timestamp	integer	Fecha y hora del último cambio en el ajuste de pago en segundos de época.

Peste

Confirmación de que la aplicación actual tiene acceso a Open API

Nombre	Ruta de acceso	Tipo	Description
Id. de solicitud	application_id	integer	Identificador de la aplicación autenticada

ShopReceipt

El registro de una compra de una tienda. Los recibos de la tienda muestran valores monetarios con la moneda de la tienda.

Nombre	Ruta de acceso	Tipo	Description
Id. de recepción	receipt_id	integer	Identificador numérico del recibo asociado a esta transacción.
Tipo de recibo	receipt_type	integer	Valor numérico del canal Etsy que aprotecionó la compra: 0 para Etsy.com, 1 para una tienda pattern.
Id. de usuario del vendedor	seller_user_id	integer	Identificador numérico del usuario (vendedor) que cumple la compra.
Dirección de correo electrónico del vendedor	seller_email	string	Cadena de dirección de correo electrónico para el vendedor de la descripción.
Identificador de usuario del comprador	buyer_user_id	integer	Identificador numérico del usuario que realiza la compra.
Dirección de correo electrónico del comprador	buyer_email	string	Cadena de dirección de correo electrónico para el comprador de la descripción.
Nombre	name	string	Cadena de nombre para el destinatario en la dirección de envío.
Primera línea de direcciones	first_line	string	La primera cadena de línea de direcciones para el destinatario en la dirección de envío.
Segunda línea de direcciones	second_line	string	Cadena opcional de segunda línea de dirección para el destinatario en la dirección de envío.
City	city	string	Cadena de ciudad para el destinatario en la dirección de envío.
Estado	state	string	Cadena de estado para el destinatario en la dirección de envío.
Código postal	zip	string	Cadena de código postal (no necesariamente un número) para el destinatario en la dirección de envío.
Dirección con formato	formatted_address	string	Cadena de dirección de envío con formato para el destinatario en la dirección de envío.
ISO del código de país	country_iso	string	Cadena de código de país alfa-2 ISO-3166 para el destinatario en la dirección de envío.
Método de pago	payment_method	string	Cadena de método de pago que identifica el método de pago del comprador, que debe ser uno de: 'cc' (tarjeta de crédito), 'PayPal', 'check', 'mo' (pedido de dinero), 'bt' (transferencia bancaria), 'otro', 'ideal', 'sofort', 'apple_pay', 'google', 'android_pay', 'google_pay', 'klarna', 'k_pay_in_4' (klarna) o 'k_financing' (klarna).
Dirección de correo electrónico de pago	payment_email	string	Cadena de dirección de correo electrónico de la dirección de correo electrónico a la que enviar confirmación de pago
Mensaje del vendedor	message_from_seller	string	Cadena de mensaje opcional del vendedor.
Mensaje del comprador	message_from_buyer	string	Cadena de mensaje opcional del comprador.
Mensaje del sistema de pago	message_from_payment	string	Cadena de confirmación generada por la máquina del sistema de pago.
Se paga	is_paid	boolean	Cuando es cierto, el comprador pagó esta compra.
Se envía	is_shipped	boolean	Cuando es true, el vendedor envió los productos.
Marca de tiempo creada	create_timestamp	integer	Tiempo de creación del recibo, en segundos de época.
Actualizar marca de tiempo	update_timestamp	integer	Hora de la última actualización a la recepción, en segundos de época.
Mensaje de regalo	gift_message	string	Una cadena de mensaje de regalo que el comprador solicita que se entregue con el producto.
Dinero	grandtotal	Money	Representación de una cantidad de dinero.
Dinero	subtotal	Money	Representación de una cantidad de dinero.
Dinero	total_price	Money	Representación de una cantidad de dinero.
Dinero	total_shipping_cost	Money	Representación de una cantidad de dinero.
Dinero	total_tax_cost	Money	Representación de una cantidad de dinero.
Dinero	total_vat_cost	Money	Representación de una cantidad de dinero.
Dinero	discount_amt	Money	Representación de una cantidad de dinero.
Dinero	gift_wrap_price	Money	Representación de una cantidad de dinero.
Envíos	shipments	array of ShopReceiptShipment	Lista de instrucciones de envío para este recibo.

ShopReceiptShipment

Registro de un evento de envío para un ShopReceipt. Un recibo puede tener muchos registros ShopReceiptShipment.

Nombre	Ruta de acceso	Tipo	Description
Id. de envío de recibos	receipt_shipping_id	integer	Identificador numérico único de un registro de envío de recibo de tienda.
Marca de tiempo de notificación de envío	shipment_notification_timestamp	integer	Hora en la que Etsy notificó al comprador del evento de envío, en segundos de época.
Nombre del operador	carrier_name	string	Cadena de nombre para el transportista o la empresa responsable de entregar el envío.
Código de seguimiento	tracking_code	string	Cadena de código de seguimiento proporcionada por el transportista o la compañía para el envío.

ShopReceipts

Los recibos de una tienda específica.

Nombre	Ruta de acceso	Tipo	Description
Contar	count	integer	Número de recibos de tienda encontrados.
Results	results	array of ShopReceipt	Lista de recursos de recibo de tienda encontrados, con todos los campos Recibo de tienda para cada recurso.

TransactionReviews

Un conjunto de registros de revisión de transacciones dejados por Los usuarios.

Nombre	Ruta de acceso	Tipo	Description
Contar	count	integer	Número de recursos TransactionReview encontrados.
Results	results	array of TransactionReview	Se encontraron los recursos TransactionReview.

TransactionReview

Un registro de revisión de transacciones dejado por un usuario.

Nombre	Ruta de acceso	Tipo	Description
Id. de tienda	shop_id	integer	Identificador numérico de la tienda.
Id. de lista	listing_id	integer	Identificador de la descripción de la tienda a la que pertenece TransactionReview.
Identificador de usuario del comprador	buyer_user_id	integer	Identificador numérico del usuario que era el comprador en esta transacción. Nota: Este campo puede estar ausente, en función de la configuración de privacidad del comprador.
Rating	rating	integer	Valor de clasificación en la escala de 1 a 5
Revisar mensaje	review	string	Mensaje dejado por el autor, que explica los comentarios.
Language	language	string	El idioma de TransactionReview
Dirección URL de imagen de tamaño completo	image_url_fullxfull	string	Dirección URL a una foto proporcionada con los comentarios, dimensiones fullxfull. Nota: Este campo puede estar ausente, en función de la configuración de privacidad del comprador.
Marca de tiempo creada	create_timestamp	integer	Fecha y hora en que se creó TransactionReview en segundos de época.
Actualizar marca de tiempo	update_timestamp	integer	Fecha y hora en que TransactionReview se actualizó en segundos de época.

SellerTaxonomyNodes

Lista de nodos de taxonomía del árbol de taxonomía del vendedor.

Nombre	Ruta de acceso	Tipo	Description
Contar	count	integer	Número de resultados.
Results	results	array of SellerTaxonomyNode	Lista de recursos solicitados.

SellerTaxonomyNode

Nodo de taxonomía en el árbol de taxonomía del vendedor.

Nombre	Ruta de acceso	Tipo	Description
identificación	id	integer	Identificador numérico único de un nodo de taxonomía etsy, que es una categoría de metadatos para las listas organizadas en el árbol de jerarquía de taxonomía del vendedor. Por ejemplo, el nodo de taxonomía de zapatos (ID: 1429, nivel: 1) es mayor en la jerarquía que los zapatos de las chicas (ID: 1440, nivel: 2). Los nodos de taxonomía asignados a una lista admiten el acceso a propiedades y escalas de productos estandarizados específicos. Por ejemplo, los listados asignados a los zapatos de los nodos de taxonomía o los zapatos de chicas admiten el acceso a la escala de tamaño de calzado de la UE con sus nombres de propiedad y identificadores asociados para los tamaños de calzado de la UE, como la propiedad `value_id`:1394 y `name`:38.
Level	level	integer	Profundidad entera de este nodo de taxonomía en el árbol de taxonomía del vendedor, con raíces en el nivel 0.
Nombre	name	string	Cadena de nombre para este nodo de taxonomía.
Id. primario	parent_id	integer	Identificador de taxonomía numérico del elemento primario de este nodo.
Secundarios	children	array of SellerTaxonomyNode	Matriz de nodos de taxonomía para todos los elementos secundarios directos de este nodo de taxonomía en el árbol taxanomy del vendedor.
Identificadores de ruta de taxonomía	full_path_taxonomy_ids	array of integer	Matriz de identificadores de taxonomía que incluyen este nodo y todos sus elementos primarios directos en el árbol de taxonomía del vendedor hasta un nodo raíz. Se muestran en orden de raíz a hoja.

TaxonomyNodeProperties

Lista de definiciones de propiedades de producto.

Nombre	Ruta de acceso	Tipo	Description
Contar	count	integer	Número de resultados.
Results	results	array of TaxonomyNodeProperty	Lista de recursos solicitados.

TaxonomyNodeProperty

Definición de propiedad de producto.

Nombre	Ruta de acceso	Tipo	Description
Id. de propiedad	property_id	integer	Identificador numérico único de esta propiedad de producto.
Nombre	name	string	Cadena de nombre para este nodo de taxonomía.
Nombre de pantalla	display_name	string	Cadena de nombre de propiedad de producto legible.
Balanza	scales	array of TaxonomyPropertyScale	Lista de escalas disponibles.
Se requiere	is_required	boolean	Cuando es true, los identificadores de taxonomía elegibles asignados requieren esta propiedad.
Admite atributos	supports_attributes	boolean	Cuando es true, puede usar esta propiedad en enumerar atributos.
Admite variaciones	supports_variations	boolean	Cuando es true, puede usar esta propiedad en la lista de variaciones.
Es multivalor	is_multivalued	boolean	Cuando es true, puede asignar varios valores de propiedad a esta propiedad.
Valores posibles	possible_values	array of TaxonomyPropertyValue	Lista de cadenas de valor de propiedad admitidas para esta propiedad.
Valores seleccionados	selected_values	array of TaxonomyPropertyValue	Lista de cadenas de valor de propiedad automáticamente y siempre seleccionadas para la propiedad especificada.

TaxonomyPropertyScale

Escala que desfniza los incrementos asignables para los valores de propiedad disponibles para propiedades de producto específicas.

Nombre	Ruta de acceso	Tipo	Description
Id. de escalado	scale_id	integer	Identificador numérico único de una escala.
Nombre de pantalla	display_name	string	Cadena de nombre de una escala.
Description	description	string	Cadena de descripción de una escala.

TaxonomyPropertyValue

Valor de propiedad para una propiedad de producto específica, que también puede emplear una escala específica.

Nombre	Ruta de acceso	Tipo	Description
Id. de valor	value_id	integer	Identificador numérico de este valor de propiedad.
Nombre	name	string	Cadena de nombre de este valor de propiedad.
Id. de escalado	scale_id	integer	Identificador de escala numérico de la escala a la que pertenece este valor de propiedad.
Igual a	equal_to	array of integer	Una lista de identificadores de valor de propiedad numéricos este valor de propiedad es igual a (si existe).

ShippingCarriers

Representa varios ShippingCarriers.

Nombre	Ruta de acceso	Tipo	Description
count	count	integer
results	results	array of ShippingCarrier

ShippingCarrier

Un transportista de envío compatible, que se usa para calcular una fecha de entrega estimada.

Nombre	Ruta de acceso	Tipo	Description
Id. del transportista de envío	shipping_carrier_id	integer	Identificador numérico de este transportista de envío.
Nombre	name	string	Nombre de este transportista.
Clases nacionales	domestic_classes	array of ShippingCarrierMailClass	Conjunto de clases de correo nacionales de este transportista de envío.
Clases internacionales	international_classes	array of ShippingCarrierMailClass	Conjunto de clases de correo internacionales de este transportista de envío.

ShippingCarrierMailClass

Clase de correo de un transportista de envío, que se usa para calcular una fecha de entrega estimada.

Nombre	Ruta de acceso	Tipo	Description
Id. de clase de correo	mail_class_key	string	Identificador único de esta clase de correo.
Nombre	name	string	Nombre de esta clase de correo.

Tiendas

Un conjunto de registros shop.

Nombre	Ruta de acceso	Tipo	Description
Contar	count	integer	El número total de tiendas
Results	results	array of Shop	Los recursos shop.

ShopSection

Una sección dentro de una tienda, en la que un usuario puede ordenar las descripciones.

Nombre	Ruta de acceso	Tipo	Description
Id. de sección de tienda	shop_section_id	integer	Identificador numérico de una sección de una tienda de Etsy específica.
Title	title	string	Cadena de título de una sección de tienda.
Rango	rank	integer	Posición numérica positiva no cero de esta sección en el orden de visualización de la sección para una tienda, con las secciones de clasificación 1 que aparecen primero.
Id. de usuario	user_id	integer	Identificador numérico del usuario que posee esta sección de la tienda.
Recuento de listados activos	active_listing_count	integer	Número de listados activos en una sección de una tienda etsy específica.

ShopSections

Todas las secciones de una tienda sprecific.

Nombre	Ruta de acceso	Tipo	Description
Contar	count	integer	Número de resultados.
Results	results	array of ShopSection	Lista de recursos solicitados.

ShopShippingProfile

Nombre	Ruta de acceso	Tipo	Description
Id. de perfil de envío	shipping_profile_id	integer	Identificador numérico del perfil de envío.
Title	title	string	Cadena de nombre de este perfil de envío.
Id. de usuario	user_id	integer	Identificador numérico del usuario que posee el perfil de envío.
Días de procesamiento mínimos	min_processing_days	integer	Número mínimo de días para procesar la lista.
Número máximo de días de procesamiento	max_processing_days	integer	Número máximo de días para procesar la lista.
Etiqueta días de procesamiento	processing_days_display_label	string	Cadena de etiqueta de visualización traducida para días de procesamiento.
ISO del país de origen	origin_country_iso	string	Código ISO del país desde el que se distribuye el listado.
Está eliminado	is_deleted	boolean	Cuando es true, alguien eliminó este perfil de envío.
Destinos de perfil de envío	shipping_profile_destinations	array of ShopShippingProfileDestination	Lista de destinos de perfil de envío disponibles para este perfil de envío.
Actualizaciones de perfil de envío	shipping_profile_upgrades	array of ShopShippingProfileUpgrade	Lista de actualizaciones de perfil de envío disponibles para este perfil de envío.
Código postal de origen	origin_postal_code	string	Cadena de código postal (no necesariamente un número) para la ubicación desde la que se distribuye la lista.
Tipo de Perfil	profile_type	ProfileType

ShopShippingProfileDestination

Representa un destino de envío asignado a un perfil de envío.

Nombre	Ruta de acceso	Tipo	Description
Id. de destino del perfil de envío	shipping_profile_destination_id	integer	Identificador numérico del destino del perfil de envío en el perfil de envío asociado a la lista.
Id. de perfil de envío	shipping_profile_id	integer	Identificador numérico del perfil de envío.
ISO del país de origen	origin_country_iso	string	Código ISO del país desde el que se distribuye el listado.
ISO del país de destino	destination_country_iso	string	Código ISO del país al que se envía el listado. Si es null, la solicitud establece el destino en destination_region
DestinationRegion	destination_region	DestinationRegion	Código de la región a la que se distribuye la lista. Una región representa un conjunto de países. Las regiones admitidas son Unión Europea y No Unión Europea (países de Europa que no están en la UE). Si no es ninguno, la solicitud establece el destino en destination_country_iso o en todas partes si destination_country_iso también es null.
Dinero	primary_cost	Money	Representación de una cantidad de dinero.
Dinero	secondary_cost	Money	Representación de una cantidad de dinero.
Id. del transportista de envío	shipping_carrier_id	integer	Identificador único de un transportista de envío admitido, que se usa para calcular una fecha de entrega estimada.
Clase Mail	mail_class	string	Cadena de identificador único de la clase de correo de un transportista de envío, que se usa para calcular una fecha de entrega estimada.
Días de entrega mínimos	min_delivery_days	integer	El número mínimo de días laborables que un comprador puede esperar esperar para recibir su artículo comprado una vez que se haya enviado.
Máximo de días de entrega	max_delivery_days	integer	El número máximo de días laborables que un comprador puede esperar esperar para recibir su artículo comprado una vez que se haya enviado.

ShopShippingProfileUpgrade

Representación de una opción de actualización de perfil de envío.

Nombre	Ruta de acceso	Tipo	Description
Id. de perfil de envío	shipping_profile_id	integer	Identificador numérico del perfil de envío base.
Id. de actualización	upgrade_id	integer	Identificador numérico asociado a una actualización de envío
Nombre de actualización	upgrade_name	string	Nombre de la actualización de envío que se muestra a los compradores al finalizar la compra, por ejemplo, prioridad de USPS.
Tipo	type	Type	Tipo de la actualización de envío. Nacional (0) o internacional (1).
Rango	rank	integer	Posición numérica positiva no cero en las imágenes mostradas en una lista, con las imágenes de clasificación 1 que aparecen en la posición más izquierda de una lista.
Language	language	string	Etiqueta de idioma IETF para el idioma del perfil de envío. Por ejemplo: de, en, es, fr, it, ja, nl, pl, pt, ru.
Dinero	price	Money	Representación de una cantidad de dinero.
Dinero	secondary_price	Money	Representación de una cantidad de dinero.
Id. del transportista de envío	shipping_carrier_id	integer	Identificador único de un transportista de envío admitido, que se usa para calcular una fecha de entrega estimada.
Clase Mail	mail_class	string	Cadena de identificador único de la clase de correo de un transportista de envío, que se usa para calcular una fecha de entrega estimada.
Días de entrega mínimos	min_delivery_days	integer	El número mínimo de días laborables que un comprador puede esperar esperar para recibir su artículo comprado una vez que se haya enviado.
Máximo de días de entrega	max_delivery_days	integer	El número máximo de días laborables que un comprador puede esperar esperar para recibir su artículo comprado una vez que se haya enviado.

ShopShippingProfileDestinations

Representa una lista de objetos de destino de envío.

Nombre	Ruta de acceso	Tipo	Description
Contar	count	integer	Número de resultados.
Results	results	array of ShopShippingProfileDestination	Lista de recursos solicitados.

ShopShippingProfileUpgrades

Lista de opciones de actualización de envío.

Nombre	Ruta de acceso	Tipo	Description
Contar	count	integer	Número de resultados.
Results	results	array of ShopShippingProfileUpgrade	Lista de recursos solicitados.

UserAddress

Representa la dirección de un usuario.

Nombre	Ruta de acceso	Tipo	Description
Id. de dirección de usuario	user_address_id	integer	Identificador numérico de la dirección del usuario.
Id. de usuario	user_id	integer	Identificador numérico del usuario.
Nombre	name	string	Nombre del usuario para esta dirección.
Primera línea de direcciones	first_line	string	Primera línea de la dirección del usuario.
Segunda línea de direcciones	second_line	string	Segunda línea de la dirección del usuario.
City	city	string	Campo de ciudad de la dirección del usuario.
Estado	state	string	Campo de estado de la dirección del usuario.
Código postal	zip	string	Campo de código postal de la dirección del usuario.
ISO del código de país	iso_country_code	string	Código ISO del país en esta dirección.
País	country_name	string	Nombre del país del usuario.
Es la dirección de envío predeterminada.	is_default_shipping_address	boolean	Es la dirección de envío predeterminada del usuario.

UserAddresses

Representa varios registros UserAddress.

Nombre	Ruta de acceso	Tipo	Description
Contar	count	integer	Número de registros UserAddress que se devuelven.
Results	results	array of UserAddress	Matriz de recursos UserAddress.

DestinationRegion

Código de la región a la que se distribuye la lista. Una región representa un conjunto de países. Las regiones admitidas son Unión Europea y No Unión Europea (países de Europa que no están en la UE). Si no es ninguno, la solicitud establece el destino en destination_country_iso o en todas partes si destination_country_iso también es null.

DestinationRegion: string

ItemDimensionsUnit

Cadena que define las unidades usadas para medir las dimensiones del producto. El valor predeterminado es NULL.

ItemDimensionsUnit: string

ItemWeightUnit

Cadena que define las unidades usadas para medir el peso del producto. El valor predeterminado es NULL.

ItemWeightUnit: string

Ocasión

Cadena enumerada que indica una ocasión para la que este producto haría un regalo adecuado. El valor predeterminado es NULL.

Ocasión: string

Tipo de Perfil

Tipo de Perfil: string

Destinatario

Cadena enumerada que indica a una persona para la que este producto haría un regalo adecuado. El valor predeterminado es NULL.

Destinatario: string

Estado

Cadena enumerada de cualquiera de: activa o inactiva. Nota: Al establecer un borrador de lista en activo, también se publicará la lista en etsy.com.

Estado: integer

Tipo

Tipo de la actualización de envío. Nacional (0) o internacional (1).

Tipo: integer

WhenMade

Cadena enumerada para la era en la que el fabricante hizo el producto en esta lista. Ayuda a los compradores a localizar la descripción bajo el encabezado Vintage. Requiere "is_supply" y "who_made".

WhenMade: string

WhoMade

Cadena enumerada inidcated que hizo el producto. Ayuda a los compradores a localizar la descripción bajo el encabezado Hechos a mano. Requiere "is_supply" y "when_made".

WhoMade: string

Compartir a través de

Etsy (publicador independiente)

Creación de una conexión

Predeterminado

Limitaciones

Acciones

Actualización de un destino de perfil de envío

Parámetros

Devoluciones

Actualización de un perfil de envío

Parámetros

Devoluciones

Actualización de una actualización del perfil de envío

Parámetros

Devoluciones

Actualización de una traducción de lista

Parámetros

Devoluciones

Actualizar el inventario de una lista

Parámetros

Devoluciones

Actualizar las imágenes de variación de una lista

Parámetros

Devoluciones

Actualizar una lista

Parámetros

Devoluciones

Actualizar una propiedad de lista

Parámetros

Devoluciones

Actualizar una tienda

Parámetros

Devoluciones

Buscar tiendas

Parámetros

Devoluciones

Carga de una imagen de lista

Parámetros

Devoluciones

Cargar un archivo de lista

Parámetros

Devoluciones

Creación de un destino de perfil de envío

Parámetros

Devoluciones

Creación de un perfil de envío

Parámetros

Devoluciones

Creación de una actualización de perfil de envío

Parámetros

Devoluciones

Creación de una traducción de lista

Parámetros

Devoluciones

Crear un recibo de envío

Parámetros

Devoluciones

Crear una lista de borradores

Parámetros

Devoluciones

Crear una sección de tiendas

Parámetros

Devoluciones

Eliminar un archivo de la lista

Parámetros

Eliminar un destino de perfil de envío

Parámetros

Eliminar un perfil de envío

Parámetros

Devoluciones

Eliminar una actualización de perfil de envío

Parámetros

Eliminar una imagen de lista

Parámetros

Eliminar una lista

Parámetros

Eliminar una propiedad de lista

Parámetros

Obtención de destinos de perfil por perfil de envío

Parámetros