El menú de intuipos, contiene, listado de productos de venta, y listado de combos. Los combos es un conjunto de productos de venta, en algunos casos los productos de venta dentro de un combo puede ser cambiado por otros productos y sobre cargar un precio sobre el precio del combo. Por ejemplo, cambiar papás fritas, por anillos de cebolla.
Los web-API de INTUIPOS, integrar intuipos con otros sistemas. Los tokens de acceso, credenciales y/o códigos de punto de venta y ambientes de prueba deberán ser solicitados directamente a soporte@intuipos.com y comercial@intuipos.com
Para pruebas puede utilizarse la siguiente API:
http://demo.intuipos.net/webapi.intuipos.net/api/v1/Order/CreateOrder
Métodos disponibles
CreateOrder
Permite el ingreso de transacciones de venta.
Documentación JSON de entrada.
CreateInventoryOrder
Permite el ingreso de transacciones de inventario. (En construcción).
GetPuntoDeVentaMenu
Permite consultar el menú de venta. (En construcción)
Documentación para recibir/importar transacciones de venta de otros sistemas terceros. ** Funcionalidad disponible a demanda y con costo adicional.
Objeto Order (Transacción de venta)
Definición de los campos en el objeto Order.
ClientID, iPuntoDeventaID_Cliente: Tomar estos valores según la consulta de cliente obtenido de la tabla de clientes.
Date : Fecha de cierre de la venta.
DeliveryTypeID: Tipo de entrega de la venta.
1 DRIVE-THRU
2 VENTA MOSTRADOR
3 PARA LLEVAR
4 COMEDOR
5 DOMICILIO
6 EVENTO
7 VENTA INSTITUCIONAL
8 AUTO-SERVICIO
DocumentID: Número de factura generado para ésta venta.
DueDate: Fecha de vencimiento, para venta POS, utilizar la misma de cierre.
UserID, PuntoDeVentaID_User: Código de empleado compuesto de empleado tomado de la consulta de la tabla de empleados. Si no existe el empleado debe crearse el empleado.
InvoicePrefix, InvoiceResolutionID: Código compuesto de la resolución de facturación autorizada por el departamento administrativo de impuestos de la localidad. Obtener código de la consulta de la tabla de definición de impuestos, si no existe, deberá crearse.
Observations: Observaciones generales del documento de venta.
Pax: Número de personas, visitantes.
PuntoDeVentaID: Código del punto de venta / Tienda, debe ser dado por el administrador del sistema.
TableID, PuntoDeVentaID_Table: Utilizar según consulta de la tabla de mesas, o por defecto valor ( 0 , [PuntoDeventaID]).
StatusID: Estado de la transacción.
1 CERRADA
3 ANULADA
StatusID: Estado de la transacción.
SubPuntoDeVentaID: Utilizar código del punto de venta dentro de un punto de venta. Si no existen divisiones de punto de venta, utilizar por defecto el mismo código en PuntoDeVentaID.
TerminalID, PuntoDeVentaID_Terminal: Utilizar llave compuesta de la terminal, definida en la consulta de la tabla de terminales. O usar por defecto el valor (CAJA,[PuntoDeVentaID]).
TransactionTypeID: Tipo de traslado.
5 VENTA
51 REQUISICIÓN por TRASLADO
WareHouseID: Código de bodega, según consulta de códigos de la tabla de bodegas para el punto de venta.
Objeto Detalle de Orden
ItemID, PuntoDeVentaID_Item: Código del producto, según consulta de productos. Punto de Venta que define el producto, en cadenas usar el del administrador y/o el de la franquicia.
UnitPrice: Precio de venta por unidad antes de descuentos, y después de impuestos.
DiscountPercentage: Porcentaje de descuento entre 0 y 100.
TaxPercentage: Porcentaje del impuesto de venta entre 0 y 100.
TaxID: Código del impuesto de venta
0 – No Gravados
6 – I.V.A 19%
2 – IMPTO.NAL.CONSUMO 8%
TaxPercentage2: Porcentaje del segundo(2do) impuesto de venta entre 0 y 100.
TaxID: Código del segundo (2do) impuesto de venta
0 – No Gravados
6 – I.V.A 19%
2 – IMPTO.NAL.CONSUMO 8%
Quantity: Cantidad vendida.
DetailType: Tipo de detalle.
0 DEFAULT
1 ENTRADAS
2 FUERTES
3 POSTRES
4 PARA LLEVAR
WareHouseID: Código de bodega, según consulta de códigos de la tabla de bodegas para el punto de venta.
SeatNumber: Número de la silla. 0 si no tiene.
Date: Fecha de marchado/ordenado el producto.
ItemRoleID: Puede ser el encabezado de un combo (Conjunto de productos), o un producto de venta solo.
5 Combo Combo
0 Item Item ó producto.
DiscountID, PuntoDeVentaID_Discount: Código del descuento aplicado. Punto de venta qué define el descuento, en cadenas usar el del administrador y/o el de la franquicia.
Observations: Observaciones.
PuntoDeVentaID: Código del punto de venta / Tienda, debe ser dado por el administrador del sistema.
Objeto Detalle de Pago
PuntoDeVentaID: Código del punto de venta / Tienda, debe ser dado por el administrador del sistema.
PaymentTypeID: Código de tipo de medio de pago utilizado.
1 EFECTIVO CAJA
2 TCREDITO
3 TDEBITO
DocumentID: Código del documento de pago utilizado.
ApprovalCode: Código de aprobación del medio de pago utilizado.
DocumentTypeID: Sub categoría documento de pago utilizado.
18 TC VISA
19 TC MASTER CARD
20 TC DINNERS
21 TC AMERICAN EXPRESS
22 TC CREDENCIAL
23 TC FALABELLA
24 TC FRAGATA
61 TD VISA
62 TD VISA ELECTRON
63 TD MASTERCARD
64 TD CREDENCIAL
65 TD AMERICAN EXPRESS
66 TD DINNERS
UserrID, PuntoDeVentaID_User: Código de empleado compuesto de empleado tomado de la consulta de la tabla de empleados. Si no existe el empleado debe crearse el empleado.
Credit: Valor del pago.
Debit: Valor deducido.
Base: Base de impuestos. Sólo para retenciones.
JSON DE EJEMPLO
Se podrá conectar con Tableau software, herramienta para realizar reportes y análisis de datos. A continuación los pasos para integrarse y realizar un ejemplo. Pre-requisito: Deberá tener instalado y licenciado Tableau desktop, contactando directamente al representante de venta en su país.
Estando en el menú principal, escoger la fuente de datos, para INTUIPOS seleccionar Microsoft SQL SERVER
Aparecerá cuadro de dialogo, para ingresar los datos de conexión al motor de base de datos donde se encuentra la data de INTUIPOS. Ingresar la dirección del servidor, el nombre de la base de datos, usuario y contraseña según hayan sido otorgados por el administrador de la base de datos.
Una vez establecida la conexión se muestran en la parte izquierda los objetos de la base de datos, en este caso el de las tablas donde está la información de venta, y en la parte superior izquierda el nombre de la fuente de datos, el cual podrá de ahora en adelante ser personalizada.
Arrastrar hacia el centro donde dice “Arrastrar aquí”, las tablas que se encuentran en la parte izquierda, que contienen la información de ventas para armar el modelo de datos que contiene la información de venta. En su orden deberán arrastrarse: T_PuntoDeVenta, T_Transaction, T_TransactionOrderDetail, T_Item, T_Group, T_SubGroup que son la fuente principal de la venta.
En la parte inferior izquierda hacer click en “Hoja 1”, para comenzar a diagramar un reporte.
Arrastrar los campos de datos según la información que se quiera obtener. Hemos arrastrado los campos # de visitantes, año y mes del campo fecha, y al cruzarlos se puede obtener un reporte que visualiza los visitantes por mes y por año. Así mismo usted podrá reordenar los campos, cambiar los filtros para armar otro tipo de reportes.
Haciendo click en nueva hoja en la parte inferior izquierda, podrá realizar otro reporte. En este ejemplo, podremos construir un reporte que visualice la venta por año, arrastrar los campos mItemPrice (realizar la formula que provee INTUIPOS) y arrastrar el campo fecha del encabezado de factura. Se obtendrá de esta forma la venta por año.
Una vez se conozca el modelo de datos, podrá seguir realizando más reporte de acuerdo a las necesidad de consulta de información. Para la publicación del reporte y visualizarlo en teléfonos celulares o en la web, favor consultar el tutorial de publicación de reportes en Tableau.
Existe la posibilidad de integrarse con los sistemas de business intelligence que hay en el mercadocomo por ejemplo, Tableau o Power BI, y así enriquecer los reportes que desea obtener a partir de información que se guarda en las distintas bases de datos de INTUIPOS. Al integrarse, INTUIPOS, se
vierte en una fuente de datos con motor SQL que sirve para alimentar los sistemas de business intelligence.
Deberá contactar a soporte INTUIPOS, para obtener un usuario con PERMISOS DE LECTURA sobre tablas de Ventas de la base de datos de INTUIPOS. Los datos de conexión se enviarán también por solicitud a soporte.
** INTUIPOS no brindará soporte y/o capacitación sobre software de terceros.
Las tablas de ventas, es el conjunto de tablas de base de datos que contiene la información de venta generada en el POS en la base de datos DBINTUIPOS, instalada en la SQLINTUIPOS, instalada en lo
del LICENCIATARIO. Las tablas y especificación del permiso son:
• SELECT ON T_Transaction
Tabla de encabezado de transacción, según diseño maestro – detalle para ventas.
| T_Transaction | tiTransactionTy-peID | tinyint | Tipo de transacción, según tabla T_TransactionTyp |
| T_Transaction | vTerminalID | var-char | Terminal donde se realiza la transacción. |
| T_Transaction | dtDate | date-time | Fecha de la transacción |
| T_Transaction | tiStatusID | tinyint | Estado de la transacción, según tabla T_TrxStatus. |
| T_Transaction | tiDeliveryTypeID | tinyint | Código del tipo de entrega, según tabla T_Delivery. |
| T_Transaction | vObservations | var-char | Observaciones de la transacción. |
| T_Transaction | tiTableID | tinyint | Código de la mesa donde se realiza la transacción gún tabla T_Furniture. |
| T_Transaction | biEmployeeID | bigint | Código del usuario que realiza la transacción, segú bla T_Persona. |
| T_Transaction | dtSystemDate | date-time | Fecha del sistema en el INSERT. |
| T_Transaction | biDocumentID | bigint | Número de factura para venta, número de consec por tipo de transacción. |
| T_Transaction | iPax | int | Cantidad de personas atendidas en la transacción. |
| T_Transaction | biClientID | bigint | Código del cliente de la transacción, según tabla T_Client. |
| T_Transaction | NombreEnPedido | var-char | Nombre del cliente o localizador para visualizar en comandas de cocina. |
| T_Transaction | iProfitCenterID | int | Código de la bodega. |
| T_Transaction | iPuntoDeVentaID | int | Código del punto de venta. |
| T_Transaction | vExternalDocumentID | var-char |
En notas crédito, hace referencia al número de
documento de venta asociado.
En compras hace referencia al número de factura
de compra del proveedor.
En documentos importados de Woo Commerce hace
referencia al número de pedido. |
• SELECT ON T_TransactionOrderDetail
Tabla con el detalle de venta, para cada transacción, según diseño maestro – detalle.
| T_TransactionOrderDetail | biTransactio-nOrderDetailID | bigint | Identificador de detalle de orden de transacción |
| T_TransactionOrderDetail | iItemID | int | Código de item, según tabla T_Item. |
| T_TransactionOrderDetail | biTransactionID | bigint | Código de la transacción (maestro). |
| T_TransactionOrderDetail | mItemPrice | money | Precio de venta, final al público. |
| T_TransactionOrderDetail | biFatherID | bigint | Código de detalle de orden de transacción dre, para combos. |
| T_TransactionOrderDetail | DiscountPercentage | float | Valor del descuento aplicado. |
| T_TransactionOrderDetail | dTaxPercentage | decimal | Valor porcentual del impuesto de venta. |
| T_TransactionOrderDetail | dQuantity | decimal | Cantidad de detalle de orden. |
| T_TransactionOrderDetail | tiDetailTypeID | tinyint | Tipo de detalle, según tabla T_DetailType |
| T_TransactionOrderDetail | iProfitCenterID | int | Código de bodega. |
| T_TransactionOrderDetail | iReplicationStatusID | inyint | Código del estado de replicación. |
| T_TransactionOrderDetail | tiSeatNumber | tinyint | Número de la silla, según entrada del usuario. |
| T_TransactionOrderDetail | iPuntoDeVentaID | int | Código del punto de venta. |
| T_TransactionOrderDetail | dtDate | datetime | Fecha de detalle de orden. |
| T_TransactionOrderDetail | tiItemRoleID | tinyint | Rol del item, según tabla T_ItemRole. |
| T_TransactionOrderDetail | tiDetailStatusID | tinyint | Código de estado del detalle de orden, seg tabla T_DetailStatus. |
| T_TransactionOrderDetail | iDiscountID | int | Código del descuento aplicado al detalle d orden. |
• SELECT ON T_PaymentDetail
Tabla con el detalle de pagos para cada transacción, según diseño maestro – detalle de pagos.
| T_PaymentDetail | biDetailID | bigint | Indentificador de detalle de pago. |
| T_PaymentDetail | tiPaymentTypeID | tinyint | Código del tipo de pago, según tabla T_PaymentType. |
| T_PaymentDetail | biTransactionID | bigint | Código de transacción (maestro). |
| T_PaymentDetail | vDocumentID | varchar | Número de documento de pago. |
| T_PaymentDetail | ProfitCenterID | int | Código de bodega. |
| T_PaymentDetail | iReplicationStatusID | tinyint | Código del estado de replicación. |
| T_PaymentDetail | vApprovalCode | varchar | Código de aprobación del pago. |
| T_PaymentDetail | dtDate | datetime | Fecha del pago. |
| T_PaymentDetail | iDocumentTypeID | tinyint | Tipo de documento de pago, según tabla T_PaymentType. |
| T_PaymentDetail | tiStatusID | tinyint | Código del estado del detalle de pago, según ta T_Status. |
| T_PaymentDetail | biUserID | bigint | Código del usuario que registra el pago, según bla T_Persona. |
| T_PaymentDetail | dCredit | decimal | Valor crédito para cuenta de pago. |
| T_PaymentDetail | dDebit | decimal | Valor débito para cuenta del pago. |
• SELECT ON T_City
| T_City | iCityID | int | Código de ciudad |
| T_City | vName | varchar | Nombre de ciudad. |
| T_City | iStateID | int | Código de estado al que pertenece. |
| T_City | vExternalCo | varchar | Código externo otros sistemas. |
| T_City | vCodigoDANE | varchar | Código de ciudad segú tabla del DANE. |
• SELECT ON T_ClientType
Tabla de tipos de cliente.
• SELECT ON T_Item
| T_Item | iItemId | int | Código de item. |
| T_Item | vName | varchar | Nombre de item. |
| T_Item | tiGroupID | tinyint | Código grupo al que pertenece. |
| T_Item | vDescription | varchar | Descripción del item. |
| T_Item | vExternalCode | varchar | Código del item en sistemas alternos. |
| T_Item | vButtonName | varchar | Nombre del item en los botones del POS. |
| T_Item | vReceiptName | varchar | Nombre del item en recibos de impresora |
| T_Item | tiItemRoleID | tinyint | Código del tipo de item en el sistema. |
| T_Item | tiMeasureUnitID_Recipe | tinyint | Código de unidad de medida para receta. |
| T_Item | tiMeasureUnitID_Inventory | tinyint | Código de unidad de medida para inventario. |
| T_Item | tiReplicationStatusID | tinyint | Código del estado en el proceso de replicación. |
| T_Item | iPuntoDeVentaID | int | Código del punto de venta. |
• SELECT ON T_Discounts
Tabla maestra de definición de descuentos.
• SELECT ON T_Group
Tabla maestra de definición de grupos de venta.
• SELECT ON T_SubGroup
Tabla maestra de definición de sub-grupos de venta.
• SELECT ON T_Furniture
Tabla maestra de definición de mesas de comedor.
• SELECT ON T_DetailStatus
Tabla maestra de definición de los estados para detalles de venta.
• SELECT ON T_Persona
Tabla maestra de usuarios.
• SELECT ON T_PuntoDeVenta
Tabla maestra de puntos de venta.
• SELECT ON T_Gender
Tabla maestra de definición de género de clientes