Ejemplo de acción Gestionar inventario externo con llamada HTTP

Este ejemplo revisa los niveles de inventario de su establecimiento y realiza una llamada HTTP a la API de su proveedor para realizar pedidos cuando el inventario es bajo.

Ediciones necesarias

Disponible en: Lightning Experience

Ver ediciones compatibles.

Permisos de usuario necesarios
Para abrir, modificar, crear, activar o desactivar un flujo utilizando todos los tipos de flujo, elementos y funciones disponibles en Flow Builder, incluyendo Einstein y Agentforce for Flow:	Gestionar flujo
Para crear una credencial externa, una credencial nombrada y una acción de llamada HTTP:	Personalizar aplicación

Supongamos que desea facilitar la gestión del inventario de su establecimiento de mascotas integrándolo con el sistema de pedidos de su proveedor de modo que pueda realizar pedidos en tiempo real. Desea crear un flujo que revise sus niveles de inventario y desencadene una llamada a la API de su proveedor cuando son bajos. Cuando hace clic en Enviar pedido, solicita una llamada de API en tiempo real que realiza automáticamente su pedido.

Antes de configurar una acción de llamada HTTP:

Cree una credencial externa y una credencial nombrada de modo que el servicio externo pueda conectarse a la API. Consulte Directrices para autenticar acciones de llamadas HTTP. En este ejemplo, la credencial externa es PetStore y la credencial nombrada es Acme Pet Supplies.
Prepare una respuesta de API de muestra en formato JSON. Si una muestra no existe en la documentación de la API, puede utilizar una plataforma de API externa para recuperar una respuesta. En este ejemplo, la respuesta de API de muestra utilizada es:
```
{
  "id": 0,
  "petId": 0,
  "quantity": 0,
  "shipDate": "2024-10-09T08:49:33.605Z",
  "status": "placed",
  "complete": true
}
```
Comience con una API bien documentada. Si los detalles como los requisitos de campo o las definiciones son imprecisos o desfasados, puede tardar tiempo en depurarse.

Abra la vista de lista Flujos.
- En Configuración, en el cuadro Búsqueda rápida, introduzca Flujos y luego seleccione Flujos.
- Desde la aplicación Automatización, seleccione la ficha Flujos.
- Desde la ficha Flujos en cualquier aplicación Lightning, haga clic en el menú de acciones y seleccione Abrir flujo.
Cree un flujo de pantalla.
- Desde la aplicación Automatización, haga clic en Nuevo | Pantalla | Flujo de pantalla .
- Desde Configuración, haga clic en Nuevo flujo | Pantalla | Flujo de pantalla .
Agregue el elemento Obtener registros y configúrelo.
1. Para Etiqueta, introduzca Obtener inventario de mascotas.
2. En Objeto, seleccione Inventario.
3. Para Requisitos de condición, seleccione Ninguno: Obtener todos los registros de inventario.
4. Para la opción Cuántos registros almacenar, seleccione Todos los registros.
Después del elemento Obtener inventario de mascotas, agregue un elemento Pantalla y configúrelo.
1. Para Etiqueta, introduzca Reordenar inventario de mascotas.
2. Para Nombre de API, introduzca Reorder_Pet_Inventory.
3. Bajo Configurar encabezado, active Mostrar encabezado.
4. Bajo Configurar pie de página, active Mostrar pie de página.
Agregue un componente Sección a la pantalla Reordenar inventario de mascotas y configúrelo.
1. Active Incluir encabezado.
2. Para Etiqueta, introduzca Inventario de mascotas.
3. Para Nombre de API, introduzca Available_Pets.
4. Bajo Configurar columnas, agregue las columnas requeridas y establezca la anchura.
Agregue un componente Tabla de datos como secundario de la sección Inventario de mascotas y configúrelo.
1. Para Nombre de API, introduzca petTable.
2. En Etiqueta, introduzca Mascotas disponibles.
3. Active Utilizar etiqueta como título de tabla.
4. Para Recopilación de origen bajo Configurar origen de datos, introduzca {!Get_Pet_Inventory}.
5. Active Mostrar barra de búsqueda.
6. Bajo Configurar columnas, agregue columnas requeridas.
Agregue otro componente Sección como secundario de la pantalla Reordenar inventario de mascotas y configúrelo.
1. Active Incluir encabezado.
2. Para Etiqueta, introduzca Reabastecer mascota seleccionada.
3. Para Nombre de API, introduzca Reorder_Information.
4. Bajo Configurar columnas, agregue las columnas requeridas y establezca su anchura.
Agregue un componente Texto como secundario de la sección Reabastecer mascota seleccionada e introduzca estos valores.
1. Para Etiqueta, introduzca Mascota seleccionada.
2. Para Nombre de API, introduzca Selected_Pet.
3. Para Valor predeterminado, introduzca {!petTable.firstSelectedRow.Name}.
Agregue un componente Divisa como secundario de la sección Reabastecer mascota seleccionada e introduzca estos valores.
1. En Etiqueta, introduzca Coste por unidad.
2. Para Nombre de API, introduzca Coste_por_unidad.
3. Para Valor predeterminado, introduzca {!petTable.firstSelectedRow.Current_MSRP__c}.
Agregue un componente Número como secundario de la sección Reabastecer mascota seleccionada e introduzca estos valores.
1. Para Etiqueta, introduzca Cantidad de pedido.
2. Para Nombre de API, introduzca Order_Quantity.
3. Para Decimales, introduzca 0.
Agregue otro componente Número como secundario de la sección Reabastecer mascota seleccionada e introduzca estos valores.
1. En Etiqueta, introduzca Coste total.
2. Para Nombre de API, introduzca Total_Cost.
3. Para Valor predeterminado, introduzca {!formulaTotalCost}.
4. Para Decimales, introduzca 2.
Después del elemento Pantalla, agregue un elemento Acción y configúrelo.
1. Haga clic en Crear llamada HTTP.
2. En Crear servicio externo, para Nombre, introduzca OrderPetTest.
3. Para Credencial nombrada, seleccione Suministros para mascotas Acme.
  La URL asociada con la credencial se rellena automáticamente.
4. Haga clic en Siguiente.
5. En Configurar acción invocable, para Etiqueta, introduzca Pedir mascota.
6. En Método, seleccione PUBLICAR.
7. Para Ruta de URL, introduzca /store/order.
8. Haga clic en Siguiente.
9. Para Solicitud JSON de muestra, introduzca el miniprograma JSON requerido para este ejemplo.
10. Para confirmar parámetros de estructura de datos, haga clic en Revisar.
11. En Seleccionar método de respuesta de muestra, seleccione Conectar para esquema y luego haga clic en Siguiente.
12. Haga clic en Guardar.
13. Para Etiqueta, introduzca Llamar para pedir mascotas.
14. Para Nombre de API, introduzca Callout_to_Order_Pets.
15. En Establecer solicitud de cuerpo, para Valor, introduzca {!Order_Pet_Input_Test}.
Antes de la acción Llamar para pedir mascotas, agregue un elemento Asignación y configúrelo.
1. Para Etiqueta, introduzca Asignar campos de solicitud de llamada.
2. Para Nombre de API, introduzca Assign_Callout_Request_Fields.
3. En Establecer valores de variable, introduzca {!Order_Pet_Input_Test.id} igual a. {!petTable.firstSelectedRow.Recommended_Reorder_Quantity__c}.
4. Haga clic en Agregar asignación e introduzca {!Order_Pet_Input_Test.quantity} Es igual a {!Order_Quantity}.
5. Haga clic en Agregar asignación e introduzca {!Order_Pet_Input_Test.shipDate} Es igual a {!$Flow.CurrentDate}.
6. Haga clic en Agregar asignación e introduzca {!Order_Pet_Input_Test.status} igual a colocado.
Después de la acción Llamada para pedir mascotas, agregue un elemento Decisión y configúrelo.
1. Para Etiqueta, introduzca ¿Fue correcta la llamada?.
2. Para Nombre de API, introduzca Was_Callout_Successful.
3. En Seleccionar lógica de decisión, seleccione Definir manualmente (Predeterminado).
4. Para la etiqueta Nuevo resultado, introduzca Llamada correcta.
5. Para Requisitos de condición para ejecutar resultado, seleccione Se cumplen todas las condiciones (AND).
6. En Recursos, introduzca {!Callout_to_Order_Pets.responseCode}Mayor o igual a 200.
7. Haga clic en Agregar recursos, introduzca {!Callout_to_Order_Pets.responseCode} inferior o igual a 200.
8. Haga clic en Resultado predeterminado.
9. Para Etiqueta, elimine el texto y luego introduzca Llamada no correcta.
En la ruta de resultados Llamada no correcta, agregue un elemento Pantalla y configúrelo.
1. Para Etiqueta, introduzca Pantalla de error.
2. Para Nombre de API, introduzca Error_Screen.
3. Bajo Configurar encabezado, active Mostrar encabezado.
4. Bajo Configurar pie de página, active Mostrar pie de página.
En la ruta de resultado Llamada correcta, agregue un elemento Actualizar registros y configúrelo.
1. Para Etiqueta, introduzca Actualizar cantidad de inventario.
2. Para Nombre de API, introduzca Update_Inventory_Quantity_on_Hand.
3. Para Cómo encontrar registros para actualizar y establecer sus valores, seleccione Especificar condiciones para identificar registros y establecer campos individualmente.
4. En Objeto, seleccione Inventario.
5. En Requisitos de condición para actualizar registros en Filtrar registros de inventario, seleccione Se cumplen todas las condiciones (AND).
6. Para Campo, Operador y Valor, seleccione Id. de registro Es igual a {!petTable.firstSelectedRow.Id}.
7. En Establecer valores de campo para los registros de inventario, en Campo, seleccione Cantidad en pedido.
8. En Establecer valores de campo para los registros de inventario, en Valor, introduzca {!UpdateQuantityOnHand}.
En la ruta de resultados Llamada correcta, junto al elemento Actualizar cantidad de inventario a mano, agregue un elemento Pantalla y configúrelo.
1. Para Etiqueta, introduzca Pedido realizado.
2. Para Nombre de API, introduzca Order_Placed.
3. Bajo Configurar pie de página, active Mostrar pie de página.
4. Para Navegación, seleccione Utilizar una etiqueta personalizada.
5. Para Etiqueta de botón Siguiente o Finalizar, introduzca Aceptar.
6. Oculte los botones Anterior y Pausa.
7. Agregue un componente Visualización al elemento Pantalla.
8. Para el nombre de API del componente Visualización, introduzca SuccessDisplayHeader.
9. Para Descripción del componente Visualización, introduzca Su pedido se realizó correctamente.
10. Agregue un componente Sección al elemento Pantalla.
11. Para Etiqueta del componente Sección, introduzca Resumen de pedido.
12. Para el Nombre de API del componente Sección, introduzca OrderSummary.
13. Establezca el ancho de columna basándose en el requisito.
14. Agregue componentes de visualización obligatorios como secundarios de la Sección y configúrelos basándose en el requisito.
Guarde el flujo y luego haga clic en Depurar para solucionar cualquier error del flujo.
Haga clic en Ejecutar.
Seleccione un artículo de inventario que desee pedir.
Introduzca una cantidad de pedido y luego haga clic en Enviar pedido.
El pedido se realiza correctamente. Si el flujo falla, solucione los errores del flujo.
(Opcional) Para reiniciar el flujo utilizando valores iguales o diferentes para las variables de entrada, haga clic en Cambiar entradas o Ejecutar de nuevo.
No puede convertir la ejecución de depuración en una prueba en el flujo de pantalla.