Tabla de comercios
| Nombre del campo | Restricciones | Descripción | Tabla |
|---|---|---|---|
merchant_name | Texto | Este es el nombre del comercio específico de la tarjeta de regalo. En el caso de que estés solicitando un catálogo que muestre ofertas fijas y variables del mismo comercio, habrá un registro único para cada tipo de oferta en cada comercio. | Merchant |
merchant_slug | Texto | Este es el nombre abreviado del comercio. Se puede usar para pasar las compras a Fluz vía API para un comercio específico. También se usa para generar la URL del comercio en la aplicación web de Fluz. La estructura de la URL es https://fluz.app/store/merchant_slug | Merchant |
updated_at | Fecha, marca de tiempo | Última actualización realizada a ese registro en la tabla de comercios | Merchant |
created_at | Fecha, marca de tiempo | Fecha en la que este comercio fue agregado a nuestro catálogo | Merchant |
merchant_status | Activo o Inactivo | Esto indicará si un comercio está disponible para compra en este momento. El estado de un comercio puede ser activo o inactivo. Si un comercio está archivado, se eliminará por completo de la exportación del catálogo. | Merchant |
logo_url | URL | Imagen del logo del comercio. Será una imagen cuadrada del logo del comercio. Será una imagen vectorial de 300 x 300 píxeles. | Merchant |
faceplate_image | JSON | Objeto JSON de imágenes de diferentes tamaños para la tarjeta de regalo. Serán las imágenes oficiales de la tarjeta de regalo provistas por el comercio. | Merchant |
primary_color | Código Hex | Para la presentación dentro de tu experiencia, Fluz te proporcionará el color principal del logo del comercio. | Merchant |
type | Gift Card o Card Linked Offer | Fluz tiene tanto ofertas de tarjetas de regalo como ofertas vinculadas a tarjeta. Esto se basa en el comercio específico. Cada comercio puede tener cualquiera de las dos opciones. Este campo confirmará el tipo de oferta como una oferta de tarjeta de regalo o una oferta vinculada a tarjeta. | Merchant |
category | Lista | Este es el mapeo del comercio dentro del catálogo general de Fluz. | Merchant |
daily_limit-consumer | Número | Este es el monto máximo total en dólares que se puede comprar en un solo comercio en un solo día. Esto aplica a una sola cuenta de usuario registrada como cuenta de consumidor. Un día calendario se calcula según las zonas horarias UTC. Los límites se restablecerán diariamente. | Merchant |
daily_limit-commercial | Número | Este es el monto máximo total en dólares que se puede comprar en un solo comercio en un solo día. Esto aplica a una sola cuenta de usuario registrada como cuenta comercial. Un día calendario se calcula según las zonas horarias UTC. Los límites se restablecerán diariamente. | Merchant |
monthly_limit-consumer | Número | Este es el monto máximo total en dólares que se puede comprar en un solo comercio en un solo mes calendario. Esto aplica a una sola cuenta de usuario registrada como cuenta de consumidor. Un mes calendario se calcula según las zonas horarias UTC. Corre desde el primer día del mes hasta el último día del mes calendario. Los límites se restablecerán mensualmente. | Merchant |
monthly_limit-commercial | Número | Este es el monto máximo total en dólares que se puede comprar en un solo comercio en un solo mes calendario. Esto aplica a una sola cuenta de usuario registrada como cuenta de consumidor. Un mes calendario se calcula según las zonas horarias UTC. Corre desde el primer día del mes hasta el último día del mes calendario. Los límites se restablecerán mensualmente. | Merchant |
website_url | URL | Esta es la URL de ese comercio específico. Ten en cuenta que, si el comercio tiene múltiples URLs o subdominios, Fluz proporcionará una sola URL para ese comercio. | Merchant |
redemption_information | Texto | Estos son detalles sobre cómo canjear la tarjeta de regalo en ese comercio específico. Estos pueden ser específicos | Merchant |
parent_company | Texto | Si la tarjeta de regalo del comercio específico puede usarse en otras marcas minoristas, listaremos el nombre de la empresa matriz que | Merchant |
redeemable_at_other_brands | Lista | En qué otros comercios se puede canjear esta tarjeta de regalo. A veces serán otros comercios hijos bajo el mismo comercio padre. Pero otras veces será un surtido de comercios para una tarjeta de marca múltiple. Ejemplos: Las tarjetas de regalo de Uber se pueden canjear en Uber + Uber Eats Las tarjetas de regalo de Gap se pueden canjear en Gap + Old Navy + Banana Republic + Athleta Las tarjetas Happy Card Retail Therapy se pueden canjear en Lululemon, Macys, Nike, Boohoo, etc | Merchant |
merchant_gift_card_redemption_url | Texto | Si el comercio tiene una URL específica para aplicar el saldo de la tarjeta de regalo directamente a tu cuenta con ese comercio, esa URL específica se proporcionará en este campo. | Merchant |
description | Texto | Esta es la descripción completa del comercio. | Merchant |
short_description | Texto | Esta es la versión abreviada de la descripción de ese comercio. | Merchant |
merchant_support_phone_number | Número de teléfono | Si el comercio proporciona un número de teléfono dedicado para problemas de soporte relacionados con su programa de tarjetas de regalo, esa información se proporcionará aquí. | Merchant |
merchant_support_email | Dirección de correo electrónico | Si el comercio proporciona una dirección de correo electrónico dedicada para problemas de soporte relacionados con su programa de tarjetas de regalo, esa información se proporcionará aquí. | Merchant |
Tabla de ofertas
| Nombre del campo | Restricciones | Descripción | Tabla |
|---|---|---|---|
offer_id | UUID | Este es el ID público de la oferta que referenciarás | Offer |
rate | number | Esta es la mejor tasa en el comercio correspondiente. Si el valor fijo y el variable tienen la misma tasa, entonces incluye solo el variable. Si el variable es menor que el valor fijo, incluye tanto las ofertas de valor variable como las de valor fijo, a menos que estés solicitando el catálogo que solo tiene ofertas de valor variable. En el caso de que el comercio tenga múltiples ofertas de denominación de valor fijo diferentes con distintas tasas, habrá una oferta separada para cada combinación de denominación + tasa. | Offer |
denomination_type | Fija o Variable | Este campo corresponderá a la denominación de esa oferta en particular. Cada oferta de mayor valor tendrá su propio registro. | Offer |
denominations | rango numérico | Este campo corresponderá a la denominación de esa oferta en particular. Ofertas de valor variable: Proporcionaremos dos valores para las denominaciones. El primer valor será el límite inferior de la oferta. El segundo valor será el límite superior de la oferta. Al realizar un pedido puedes pasar cualquier valor dentro de ese rango. Ofertas de valor fijo: Enumeraremos todas las denominaciones en esa oferta. Ten en cuenta que si hay diferentes tasas en varios valores fijos de un comercio, cada uno será una oferta separada. En la oferta correspondiente, listaremos los valores en esa tasa específica. | Offer |
card_format | URL o código | Algunos comercios solo permiten una URL alojada para la entrega de la tarjeta de regalo. En ese caso, te diremos el formato que puedes esperar. | Offer |
barcode_type | 128, UPC, QR, None | Algunos minoristas requieren un código de barras o código QR y algunos de estos minoristas requieren manipulación del código de la tarjeta de regalo para producir el número del código de barras, como tener un prefijo, eliminar algunos dígitos o agregar el PIN. Para eliminar esta complejidad para nuestros clientes, devolvemos la información del código de barras en nuestros datos de respuesta de Issue. | Offer |
currency | Texto | Esta es la moneda a la que está atado el valor de la tarjeta de regalo. | Offer |
countries | Lista de países | Esto indica en qué países se pueden canjear las tarjetas de regalo Ten en cuenta que el valor subyacente de cada tarjeta de regalo estará atado a la moneda indicada en la tarjeta de regalo. Incluso si funciona en otros países que generalmente operan en una moneda diferente, el valor estará atado a la moneda indicada. | Offer |
gift_card_expiration_window | Número | Esta es la cantidad de meses en los que vence la tarjeta de regalo. Se basa en los meses desde la emisión de la tarjeta. Si es nulo, significa que la tarjeta de regalo no vence. | Offer |
merchant_terms | Texto | Estos son los términos de uso provistos por el comercio sobre los términos de uso del programa de tarjetas de regalo del comercio específico. | Offer |