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

                      CONFIGURACION PARAMETROS INTEGRACIÓN CONTABLE

                      por | Abr 12, 2023 | INTEGRACIÓN CONTABLE

                      CONSULTAR PARAMETROS INTEGRACIÓN CONTABLE 

                      INSTRUCTIVO

                        INTERFACE DE COMPRAS

                        @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

                        INTERFACE DE VENTAS

                        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′

                        INTERFACE DE COSTOS

                        EXEC[sp_InterfaceCostos]@dtFechaInicial = @dtFechaInicial,
                        @dtFechaFinal = @dtFechaFinal,
                        @iPuntoDeVentaID = 12301,
                        @vSistemaContable = N’SP’,
                        @TipoDocumento = N’L’,
                        @CodigoDocumento = 1,
                        @SubcentroCostoTEMP = 12301,
                        @iWarehouseID = 1230101