WEB API INTREGACIÓN INTÜIPOS-TERCEROS

por | Abr 12, 2023 | DESARROLLADORES

WEB API INTEGRACIÓN INTÜIPOS-TERCEROS 

INSTRUCTIVO

    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)

    DICCIONARIO DE CAMPOS J SON DE VENTA PARA WEB API INTÜIPOS

    por | Abr 12, 2023 | DESARROLLADORES

    DICCIONARIO DE CAMPOS JSON DE VENTA WEB API INTÜIPOS 

    INSTRUCTIVO

      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

      PAGAR ORDENES|CUENTAS CON MERCADO LIBRE

      PAGAR ORDENES|CUENTAS CON MERCADO LIBRE

      por | Abr 12, 2023 | VENTA A MESAS, VENTA EVENTOS, VENTA INSTITUCIONAL, VENTA PEDIDO RESERVA, VENTA RÁPIDA

      PAGAR ORDENES | CUENTAS CON MERCADO LIBRE 

      GRÁFICOS DE APOYO

      INSTRUCTIVO

      1. En el momento de solicitar la impresión de la cuenta o pre-factura del cliente, seleccionar el checkbox de “Imprimir QR Mercado Libre”.
      2. Se imprimirá el QR en la pre-factura para pago en el APP de Mercado Libre y se visualizará de la siguiente manera.
      3. El cliente en su App de Mercado Libre escanear el código QR para realizar el pago.

      INTEGRACIÓN CON TABLEAU

      INTEGRACIÓN CON TABLEAU

      por | Abr 12, 2023 | DESARROLLADORES

      INTEGRACIÓN CON TABLEAU

      GRÁFICOS DE APOYO 

      INSTRUCTIVO

        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.

        INTEGRACIÓN CON SOFTWARE DE BUSSINES INTELLIGENCE

        por | Abr 12, 2023 | DESARROLLADORES

        INTEGRACIÓN CON SOFTWARE DE BUSINESS INTELLIGENCE 

        **Esta información esta sujeta a lo pactado en el contrato

          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