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.
@dtFechaInicial DATETIME,
@dtFechaFinal DATETIME,
@iPuntoDeVentaID INT
Código del punto de venta
Sistema contable
@vSistemaContable VARCHAR(20)
— P: PREVISUALIZADOR, H: HELISA,
— S: SIIGO
— G: SOLIGEM
— C: CONTAPYME
— O: OFIMATICA
— OCXP: OFIMATICACXP
— SIESA
— SP: SIIGO PYME
Tipo de interface
@vTipoDeInterface VARCHAR(2)
FI: Por factura y por item
FS: Por factura y por subgrupo
FC: Por factura y por cuenta
DI: Por día y por item
DS: Por día y por subgrupo
DC: Por día y por cuenta
Tipo consecutivo
@TipoConsecutivo CHAR = ‘C’
Aplica cuando se agrupa por día
C: Continuo
A: Anual
M: Mensual
Consecutivo inicial
@ConsecutivoInicial INT = 1,
Aplica cuando el tipo de consecutivo es C (Continuo)
Fecha consecutivo inicial
@FechaConsecutivoInicial DATETIME = NULL,
Aplica cuando el tipo de consecutivo es C (Continuo)
Tipo de documento
Nombre del documento contable que se va usar para las compras.
@TipoDocumento VARCHAR(3) = NULL,
Tipo de documento FP, C, etc
@CodigoDocumento INT = NULL,
Código de documento, válido para SIIGO y CONTAPYME
@IvaComoCosto CHAR = ‘N’,
Esta bandera se utiliza para tomar el IVA como costo adicional del producto
@SubcentroCostoTEMP VARCHAR(3) = NULL
Subcentro de costo TEMPORAL
EXEC [sp_InterfaceCompras] @dtFechaInicial = @dtFechaInicial,
@dtFechaFinal = @dtFechaFinal,
@iPuntoDeVentaID = NULL,
@vSistemaContable = N’SP’,
@vTipoDeInterface = N’FI’,
@TipoConsecutivo = N’F’,
@TipoDocumento = N’FC’,
@CodigoDocumento = 1
EJEMPLO DE VENTAS
EXEC [dbo].[sp_InterfaceVentas] @dtFechaInicial = @dtFechaInicial,
@dtFechaFinal = @dtFechaFinal,
@iPuntoDeVentaID = NULL,
@vSistemaContable = N’S’,
@vTipoDeInterface = N’DC’,
@TipoConsecutivo = N’C’,
@ConsecutivoInicial = 1614,
@FechaConsecutivoInicial = N’2015-07-01 04:00′,
@TipoDocumento = N’F’,
@CodigoDocumento = 1,
@NitClientesVarios = N’222222222′
EXEC[sp_InterfaceCostos]@dtFechaInicial = @dtFechaInicial,
@dtFechaFinal = @dtFechaFinal,
@iPuntoDeVentaID = 12301,
@vSistemaContable = N’SP’,
@TipoDocumento = N’L’,
@CodigoDocumento = 1,
@SubcentroCostoTEMP = 12301,
@iWarehouseID = 1230101