Activador del metacampo «Ubicación de la empresa»

Activador del metacampo «Ubicación de la empresa»

Copiar página

Inicie un flujo de trabajo de Shopify Flow cuando cambie un metacampo de la ubicación de una empresa B2B y obtenga el valor anterior y el nuevo.

Un cliente B2B cuenta con varias sucursales, y cada una de ellas acepta entregas en horarios diferentes. Los horarios se guardan en el metacampo Fenster de entrega (custom.delivery_window) de la ubicación de la empresa, y el departamento de logística debe ser informado de cualquier cambio antes de que se planifique el siguiente envío.

En esta página se explica cómo iniciar un flujo de trabajo de Shopify Flow cada vez que cambie un metacampo de la ubicación de una empresa, mediante Workflow Trigger Extensions. Los pasos son los mismos para todos los metacampos de este tipo de recurso; en el ejemplo se utiliza Fenster de entrega (custom.delivery_window).

Lo que necesita

  • Una definición de metacampo. Créela en su panel de administración de Shopify, en Configuración > Metacampos y metaobjetos > Ubicaciones de la empresa. No es posible realizar un seguimiento de un metacampo que no cuente con una definición.
  • El permiso Acceso a datos de empresas y ubicaciones (B2B). Concédalo en la página de permisos de la aplicación; consulte Permisos y acceso a los datos.
  • Las ubicaciones de las empresas forman parte de B2B en Shopify. Este tipo de recurso solo resulta útil en una tienda que cuente con empresas.

1. Realice un seguimiento del metacampo

  1. Abra Metacampos de activación en la aplicación y haga clic en Añadir activador.
  2. Seleccione el tipo de recurso Ubicación de la empresa.
  3. Marque el metacampo Plazo de entrega. Puede marcar varios a la vez o utilizar la opción Seleccionar todo.
  4. Haga clic en Añadir activador.

Para realizar un seguimiento de todos los metacampos de este tipo de recurso, incluidos los que cree posteriormente, seleccione Todos los metacampos en lugar de marcar uno por uno y, a continuación, haga clic en Realizar seguimiento de todos los metacampos.

El cuadro de diálogo «Añadir activador de metacampo» con el tipo de recurso «Ubicación de la empresa» y el metacampo «Ventana de entrega», custom.delivery_window, marcado
Tipo de recurso: «Ubicación de la empresa», con el metacampo marcado. La opción «Todos los metacampos» tiene en cuenta, en cambio, todos los metacampos de ese tipo.

El nuevo activador muestra Inicializando mientras la aplicación lee el valor actual del metacampo en las ubicaciones de su empresa existentes y, a continuación, Activo. Esa primera lectura es la razón por la que el primer cambio ya llega con el valor anterior correcto.

Si el metacampo no aparece en la lista, haga clic en Actualizar metacampos en la página «Activadores de metacampos»: la aplicación conserva la lista de definiciones durante una hora.

2. Lo que recibe el flujo de trabajo

Cada cambio activa el activador Metacampo Update en Shopify Flow con estos valores:

Variable Valor
resourceType COMPANYLOCATION
resourceId El identificador de la ubicación de la empresa; por ejemplo, gid://shopify/CompanyLocation/1234567890
metafieldKey Espacio de nombres y clave, en este caso custom.delivery_window
metafield.value El nuevo valor
metafield.previousValue El valor anterior al cambio; vacío cuando se configuró el metacampo por primera vez
metafield.type El tipo del metacampo, por ejemplo, single_line_text_field

3. Crear el flujo de trabajo

  1. En Shopify Flow, cree un flujo de trabajo y seleccione el activador Actualización de metacampos de Workflow Trigger Extensions.
  2. Añada una condición: resourceType es igual a COMPANYLOCATION. La actualización de metacampos se inicia para cada tipo de recurso que realice un seguimiento, por lo que esta condición limita este flujo de trabajo a las ubicaciones de la empresa. Si realiza un seguimiento de varios metacampos de este tipo, añada como segundo criterio que metafieldKey sea igual a custom.delivery_window.
  3. Añada la acción que necesite. En el ejemplo se envía un correo electrónico interno con el valor anterior y el nuevo.
El flujo de trabajo de ejemplo en Shopify Flow: Actualización de metacampos, una condición sobre el tipo de recurso COMPANYLOCATION y envío de un correo electrónico interno
El flujo de trabajo de ejemplo: el activador, la condición relativa al tipo de recurso y una acción.

Empiece por el ejemplo

  1. Descargue el archivo .flow que se adjunta al final de esta página.
  2. En su panel de administración de Shopify, abra Shopify Flow, haga clic en Importar y seleccione el archivo.
  3. Abra el paso Enviar correo electrónico interno e introduzca el destinatario. El archivo no contiene ninguna dirección a propósito.
  4. Active el flujo de trabajo.

Hágalo suyo

  • Envíe la nueva ventana a su operador o herramienta de planificación mediante la opción Enviar solicitud HTTP.
  • Añada una condición en metafieldKey cuando realice un seguimiento de varios metacampos de ubicación de la empresa.
  • Conserve el valor anterior en el correo electrónico mediante metafield.previousValue, para que nadie tenga que buscarlo.

Con qué rapidez reacciona

Shopify notifica a la aplicación cuando se guarda una ubicación de la empresa. En el caso de un cambio que solo afecte a un metacampo, en ocasiones no envía ninguna notificación, por lo que la aplicación también comprueba las ubicaciones de su empresa aproximadamente una vez por minuto. El flujo de trabajo se completará en cuestión de segundos y, a más tardar, en uno o dos minutos.

Más