1. Mapeo de su primer pedido con PlugSales

Para realizar pedidos a través de PlugSales, es necesario mapear las operaciones. Estas operaciones las realiza directamente PlugBot en su sistema de datos (archivos bancarios o de texto), y son:

• Insertar el nuevo pedido;
• Consultar ID del nuevo pedido;
• Agregar artículos al nuevo pedido.

Nota: Si aún no ha asignado las otras funciones de PlugSales, le sugerimos que lea los siguientes artículos antes de continuar con el mapeo de pedidos: - ¿Cómo mapear usuarios? - ¿Cómo mapear productos? - ¿Cómo mapear clientes? - ¿Cómo mapear métodos de pago? - ¿Cómo mapear datos financieros? - ¿Cómo mapear comisiones?

Para comenzar a configurar estas operaciones debes acceder a la pestaña PEDIDO.

SQL para crear un nuevo pedido

Este SQL se ejecutará cada vez que la aplicación PlugSales emita un nuevo pedido y se envíe a PlugMobile Cloud (si tiene conexión a Internet).

Para que la inserción de la nueva orden se realice correctamente, SQL debe recibir los parámetros enviados desde la aplicación.

Parámetros enviados por la aplicación:

• USUARIO*(entero)*
  • Este parámetro devuelve el ID del usuario que emite el pedido (vendedor).
  • El ID devuelto será el mismo que el ingresado en la pestaña USUARIO.
• CLIENTE (número entero)
  • Este parámetro devuelve el ID del cliente seleccionado en el pedido.
  • El ID devuelto en este parámetro será el mismo que el ingresado en la pestaña [CLIENTE] (/es/parceiros/plugsales/02-plugsales-dados-sobre-os-clientes/573623-plugsales-como-mapear-clientes/).
• FECHA (texto)
  • Este parámetro devuelve la fecha del pedido en el formato AAAA-MM-DD.
  • La fecha devuelta en este parámetro será acorde a la fecha seleccionada en el pedido.
• HORA*(texto)*
  • Este parámetro devuelve la hora del pedido en el formato HH:MM.
  • El tiempo devuelto en este parámetro será acorde al tiempo seleccionado en el pedido.
• NOTA*(texto)*
  • Este parámetro devuelve las observaciones que el usuario haya podido realizar sobre el pedido.
• ORDER_DEADLINE (texto)
  • Este parámetro devuelve el plazo de pedido definido por el vendedor en el momento de la venta.
• PAGO (número real)
  • Este parámetro devuelve el ID del método de pago seleccionado en el pedido.
  • El ID devuelto en este parámetro será el mismo que el ingresado en la pestaña [MÉTODO DE PAGO] (/es/parceiros/plugsales/07-plugsales-formas-de-pagamento/573624-como-mapear-formas-de-pagamento/).
• DISCOUNT_VALUE (número real)
  • Este parámetro devuelve el importe del descuento otorgado para este pedido.
• TOTAL_ORDER (número real)
  • Este parámetro devuelve el valor total del pedido.
• TABLETABLE *(número entero) *(OPCIONAL)
  • Si utiliza tablas de precios, este parámetro devuelve el ID de la tabla de precios seleccionada en el momento de emitir la orden.
• OPERATION_TYPE*(entero)*(OPCIONAL)
  • Si utiliza tipo de operación, este parámetro devuelve el ID de la operación seleccionada al emitir la orden.
• CONDICIÓN_PAGO*(entero)*(OPCIONAL)
  • Si utiliza condiciones de pago, este parámetro devuelve el ID del término de pago seleccionado al emitir la cotización.
• NEW_BALANCE*(número real)*(OPCIONAL)
  • Si utiliza el saldo para controlar los descuentos de los usuarios, este parámetro proporcionará el saldo actualizado del vendedor después de realizar un pedido.
  • El valor del saldo será el mismo que el configurado en SALDO POR USUARIO.

Como estos parámetros se envían desde la aplicación PlugSales a tu PlugBot, el SQL que ingresas para insertar el nuevo pedido tiene acceso a ellos.

Puede utilizarlos para almacenar esta información en su base de datos. Vea a continuación un ejemplo de SQL para insertar un nuevo pedido:/* Ejemplo en una base de datos MySQL / INSERT INTO TbPedidos (id_usuario, id_cliente, fecha_pedido, hora, observación, id_formulario de pago, valor_descuento, valor_pedido_total, id_tabla_precio) valores ([USUARIO], [CLIENTE], ‘[FECHA]’, ‘[HORA]’, ‘[OBSERVACIÓN]’, [PAGO], [VALOR_DESCONTO], [TOTAL_ORDER], [TABELAPRECO])Nota: los parámetros que son de tipo texto deben estar entre comillas (o ‘apóstrofo’, dependiendo de la sintaxis de su base de datos) y si los caracteres especiales **’ “ | *,saltos de línea o emojis están identificados en estos parámetros, se eliminarán para evitar conflictos con algunos medios de integración.

¿Es posible agregar campos personalizados al realizar un pedido?

“SQL para consultar ORDER_ID del nuevo pedido”

Después de que PlugBot haya insertado el nuevo pedido en su banco, es necesario conocer el ID de ese pedido para poder agregar los artículos usando el mismo valor en el ID del pedido.

Para ello introduzca el SQL que devuelve el ID del último pedido insertado. El retorno de este SQL debe ser** un registro con una **columna: “ORDER_ID”.

En situaciones donde el ID de la tabla de pedidos es un campo numérico con incremento automático, el SQL podría ser:

/* Ejemplo en una base de datos MySQL */ SELECT id AS ID_PEDIDO FROM TbPedidos ORDER BY id DESC LIMIT 1

“SQL para insertar artículos en el pedido”

Con el pedido insertado en el banco y tu DNI en la mano, llega el momento de que PlugBot reciba los artículos de ese pedido y los introduzca en el banco.

Para ello, SQL tiene acceso a los siguientes parámetros que se envían desde la aplicación:

• ORDER_ID (entero)
  • Este campo debe informar el ID del pedido al que pertenece el artículo.
• PRODUCTO (entero)
  • Este campo debe informar el ID del producto al que se refiere este artículo.
• CANTIDAD (numérica)
  • Este campo debe informar la cantidad pedida para este producto.
• UNIT_VALUE (número real)
  • Este campo debe informar el precio unitario del producto del artículo.
• DISCOUNT_VALUE (número real)
  • Este campo debe informar el monto del descuento otorgado a este artículo.
• TOTAL_VALUE (número real)
  • Este campo debe informar el valor total de este artículo, el cual se obtiene del valor unitario, valor de descuento y cantidad comprada.
• NOTA (texto)
  • Este campo debe informar las observaciones de este producto.
• PRICE_TABLE (número entero)(OPCIONAL)
  • Si utiliza tablas de precios con posibilidad de elegir productos de diferentes tablas, este campo debe informar el ID de la tabla de precios a la que se refiere este artículo.

-** OPTION_ID (entero)(OPCIONAL)**

• Si utiliza opciones de producto, este campo debe informar el ID de la opción elegida para el producto que se agregará, configurado en OPCIONES DE PRODUCTOS.

-** ID_GRADE (número entero ) (OPCIONAL)

• Si utiliza tablas de grillas de productos, este campo debe informar el ID de la grilla elegida del producto que se agregará, configurado en GRID DE PRODUCTO.

El SQL ejecutado para esta función podría ser el siguiente:

/* Ejemplo en una base de datos MySQL */ INSERTAR EN TbItensPedido (order_id, product_id, qty, vlr_unit, vlr_desc, vlr_total, observación, price_table) VALORES ([ORDER_ID], [PRODUCTO], [CANTIDAD], [UNIT_VALUE], [DISCOUNT_VALUE], [TOTAL_VALUE], ‘[OBSERVACAO]’, [TABELA_PRECO])Nota:los parámetros que sean de tipo texto deben estar entre comillas (o ‘apóstrofe’, dependiendo de la sintaxis de tu base de datos) y si los caracteres especiales ’ “ | \ , saltos de línea o emojis, serán eliminados para evitar conflictos con cualquier medio de integración.

---

Después de completar la configuración anterior, haga clic en “Guardar configuración del PEDIDO”.