Utilice este artículo para configurar las cuatro plantillas preconstruidas de conector de datos de Shopify de Fin, para que Fin pueda cotizar reembolsos, emitir crédito en tienda y verificar o revocar tarjetas de regalo durante una conversación de soporte, sin que intervenga un compañero.
Los conectores de datos permiten que Fin llame a APIs externas (application programming interfaces) durante la conversación para obtener o actualizar datos en vivo. Las plantillas de Shopify son conectores preconfigurados que llaman a la Shopify Admin REST API en su nombre. Los ámbitos de API son los permisos específicos que su tienda Shopify debe otorgar antes de que un conector pueda leer o escribir esos datos.
Qué hace cada plantilla de compensación de Shopify
Las cuatro plantillas de conector de datos de Shopify para Fin se enumeran a continuación; cada una cubre una parte diferente del flujo de trabajo de compensación.
Calcular reembolso de Shopify
Cotiza un reembolso, incluyendo envío reembolsable, impuestos y el máximo reembolsable por transacción de pago, sin mover dinero. Esta es una acción de prueba: calcula cuánto sería un reembolso antes de emitirlo. Combínela con la acción Crear reembolso de Shopify cuando quiera que Fin confirme el monto con el cliente antes de procesar. No escribe en Shopify.
Emitir tarjeta de regalo de Shopify
Emite crédito en tienda como una tarjeta de regalo de Shopify. Shopify envía el código directamente al cliente por correo electrónico; el código canjeable nunca se devuelve a Fin ni es visible en la conversación. Fin solo ve el ID de la tarjeta, saldo, moneda, fecha de vencimiento y los últimos 4 caracteres. Esta plantilla escribe en Shopify.
Obtener saldo de tarjeta de regalo de Shopify
Verifica el saldo restante, valor inicial y fecha de vencimiento de la tarjeta de regalo de Shopify de un cliente. Úselo cuando un cliente pregunte cuánto crédito le queda o si una tarjeta ha sido usada. No escribe en Shopify.
Deshabilitar tarjeta de regalo de Shopify
Revoca una tarjeta de regalo que fue emitida por error, por ejemplo, enviada por un monto incorrecto, al cliente equivocado o emitida por equivocación. La tarjeta deja de funcionar inmediatamente.
Importante: Esta acción no se puede deshacer; Shopify no tiene forma de reactivar una tarjeta de regalo deshabilitada. Si una tarjeta es revocada por error, emita un reemplazo usando la plantilla Emitir tarjeta de regalo de Shopify.
Cómo agregar una plantilla
Encuentre la plantilla que desea agregar en la sección Shopify.
Conecte (o reutilice) su conexión de tienda Shopify; la URL de la acción apunta automáticamente a la tienda conectada a su espacio de trabajo. No se necesita configuración de domain por acción.
Revise los parámetros prellenados, la descripción y la guía de uso de Fin. Haga clic en Activar para activar la plantilla. Verá el conector listado como activo en Configuración > Integraciones > Conectores de datos.
Nota: Cada plantilla se habilita por espacio de trabajo. Una vez activa, pruebe el conector en una conversación real; el modo de vista previa de Fin no realiza llamadas en vivo a conectores de datos.
Permisos de Shopify requeridos
Antes de agregar las plantillas de tarjeta de regalo, su tienda Shopify debe tener los ámbitos read_gift_cards y write_gift_cards. Shopify no los otorga por defecto; un administrador comerciante debe solicitarlos al Soporte de Shopify.
Importante: Las tres plantillas de tarjeta de regalo (Emitir tarjeta de regalo de Shopify, Obtener saldo de tarjeta de regalo de Shopify, Deshabilitar tarjeta de regalo de Shopify) devolverán un error de autorización hasta que se otorguen estos ámbitos. Esta es la causa más probable de un fallo en la primera ejecución. Una vez que Soporte de Shopify haya otorgado los ámbitos, regrese a Configuración > Integraciones > Conectores de datos para agregar o volver a probar sus plantillas de tarjeta de regalo; no es necesaria la reinstalación de la aplicación Shopify.
La plantilla Calcular reembolso de Shopify tiene un requisito separado: necesita el ámbito orders o marketplace_orders, que Shopify otorga por defecto.
Limitaciones conocidas
Las siguientes limitaciones se aplican a las cuatro plantillas de conector de datos de Shopify para Fin. Cada limitación nombra la plantilla o plantillas afectadas.
Calcular reembolso de Shopify — solo cotizaciones a nivel de pedido y envío. Esta plantilla no soporta cotizaciones por línea de artículo. El parámetro de moneda también debe coincidir exactamente con la moneda del pedido, o Shopify rechazará la solicitud.
Deshabilitar tarjeta de regalo de Shopify — esta acción es irreversible. Shopify no tiene un endpoint de API para reactivar (la capacidad de restaurar una tarjeta deshabilitada). Si una tarjeta es revocada por error, emita un reemplazo usando la plantilla Emitir tarjeta de regalo de Shopify.
Emitir tarjeta de regalo de Shopify — el código de la tarjeta de regalo nunca es visible en la conversación. Cuando Fin usa esta plantilla, Shopify envía el código directamente al cliente por correo electrónico. Si un cliente dice que no lo recibió, verifique la dirección de correo electrónico del registro del cliente en Shopify Admin y el propio registro de notificaciones de Shopify.
Las cuatro plantillas — los campos de respuesta están limitados a lo que se lista en la configuración de cada plantilla. Solo los atributos de respuesta explícitamente listados en una plantilla son legibles por Fin; cualquier otro campo de Shopify está redactado y no disponible.
Preguntas frecuentes
¿Fin mostrará el código de la tarjeta de regalo al cliente en la conversación?
¿Fin mostrará el código de la tarjeta de regalo al cliente en la conversación?
No, Fin no mostrará el código de la tarjeta de regalo al cliente en la conversación. Cuando Fin emite una tarjeta de regalo usando la plantilla Emitir tarjeta de regalo de Shopify, Shopify envía el código directamente al cliente por correo electrónico. El código canjeable nunca se devuelve a Fin ni es visible en la conversación. Fin solo ve el ID de la tarjeta, saldo, moneda, fecha de vencimiento y los últimos 4 caracteres.
¿Puede Fin cotizar un reembolso antes de emitirlo realmente?
¿Puede Fin cotizar un reembolso antes de emitirlo realmente?
Sí, Fin puede cotizar un reembolso antes de emitirlo realmente. La plantilla Calcular reembolso de Shopify devuelve una cotización de reembolso — envío reembolsable, impuestos y el monto máximo reembolsable — sin mover dinero. Úsela junto con la acción Crear reembolso de Shopify cuando quiera que Fin cotice primero y luego confirme antes de emitir.
¿Qué pasa si se revoca una tarjeta de regalo?
¿Qué pasa si se revoca una tarjeta de regalo?
Si se revoca una tarjeta de regalo usando la plantilla Deshabilitar tarjeta de regalo de Shopify, la tarjeta deja de funcionar inmediatamente y no puede ser restaurada. Shopify no tiene un endpoint para reactivar (la capacidad de restaurar una tarjeta deshabilitada). Si una tarjeta fue revocada por error, emita un reemplazo usando la plantilla Emitir tarjeta de regalo de Shopify.
¿Qué versión de API de Shopify usan estas plantillas?
¿Qué versión de API de Shopify usan estas plantillas?
Las cuatro plantillas de conector de datos de compensación de Shopify funcionan con la Shopify Admin REST API (application programming interface) versión 2025-04.