Documentación CyberPlanet 6.5


Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Sv translation
languagees
Info
titleContenido

Table of Contents
maxLevel2

CyberPlanet
 cuenta con la posibilidad de que se acceda en tiempo real a la
 permite el acceso a información de facturación y clientes de la base de datos
. Para esto están disponibles un grupo de Vistas configuradas en el servidor MySql
desde aplicaciones externas.
En esta nota se describen las vistas disponibles y datos de conexión del servidor MySQL.

Conexión a

base MySql

MySQL Server

Usuario
:
admin_
reportes
reports
Puerto
51897
Contraseña
: CyberPlanet 6.5.0.112 o posterior: 
La contraseña se configura en
  • CyberPlanet 6.5.0.110 o anterior: 
    La contraseña es la del usuario "admin" de CyberPlanet. 
  • Se configura en CyberPlanet:
    Menú PC Servidor, Configuración, Seguridad, Administración/Operadores, "Acceso remoto a Vistas"

     

    Acceso a datos

    Vista: view_Customers

    Devuelve los detalles de todos clientes registrados en CyberPlanet.

    CampoTipoComentario
    userVARCHAR(50)Nombre de usuario
    nameVARCHAR(50)Nombre del cliente
    surnameVARCHAR(50)Apellido del cliente

    phone

    VARCHAR(15)Teléfono del cliente
    emailVARCHAR(50)Correo electrónico del cliente
    personal_identificationVARCHAR(50)Identificación personal del cliente (DNI, pasaporte, etc.)
    birthdayDATEFecha de nacimiento del cliente
    creditDECIMAL(18,3)Crédito monetario remanente
    pointsINT(11)Puntos remanentes
    offers_timeINT(11)Tiempo remanente de promociones (Minutos)
    exchange_points_timeINT(11)Tiempo remanente de tiempo de puntos (Minutos)
    (Resultado del canje de puntos por tiempo)
    account_creationDATETIMEFecha y hora de creación de la cuenta
    expiration_accountDATETIMEFecha límite de uso de la cuenta
    blocked_accountSMALLINTIndica si la cuenta fue bloqueada por el operador
    (Si el valor es 1, la cuenta está bloqueada.)
    last_loginDATETIMEFecha y hora del último inicio de sesión

    Ejemplos de uso

    Lista de clientes creados hoy

    SELECT * FROM view_Customers WHERE
    CAST(account_creation AS DATE)= CAST(NOW() AS DATE)

    Todos los clientes menores de 18 años

    SELECT * FROM view_Customers WHERE
    YEAR(NOW()) - YEAR(birthday) < 18
    Creditos de clientesSELECT user, credit,
    sec_to_time(offers_time * 60) as tiempo_de_promos,
    sec_to_time(
    exchange_points_time * 60) as tiempo_de_canje_puntos 
    FROM view_Customers



    Vista: view_customer_tracking

    Devuelve toda la historia de los clientes.

    CampoTipoComentario
    date_timeDATETIMEFecha y hora del evento
    detailsVARCHAR(100)Detalles informativos del evento
    userVARCHAR(50)Nombre de usuario del cliente
    is_paid_with_pointsBOOLEANIndica si el evento se corresponde con un canje de puntos por tiempo o productos
    timeTIMETiempo de la sesión (Si se aplica)
    deviceNoVARCHAR(10)Número de PC o Consola de videojuego
    En caso de sesión iniciada a través del Control de zonas WiFi, el dato será 'WiFi'
    paid_in_cashDECIMAL(18,3)Importe pagado si el evento representa una compra en efectivo.
    paid_with_creditDECIMAL(18,3)Crédito monetario consumido por uso de tiempo o compra de productos/servicios con crédito
    Credit_BalanceDECIMAL(18,4)Crédito monetario remanente luego del evento
    Points_TimeINT(11)Tiempo remanente de canje de puntos al momento del evento
    Offers_TimeINT(11)Tiempo remanente de promociones al momento del evento
    CashNoINT(11)número de caja al momento del evento
    Ejemplos de uso
    Eventos de hoy para cliente juanSELECT * FROM view_customer_tracking WHERE
    user='juan' AND CAST(date_time AS DATE)= CAST(NOW() AS DATE)
    order by date_time
    Tiempo total de sesiones de cada clienteSELECT user, sec_to_time(SUM(time_to_sec(time))) as tiempo
    FROM view_customer_tracking
    GROUP BY user

    Vista: view_tickets 

    Devuelve los tickets emitidos.

    CampoTipoComentario
    TicketNoINT(11)Número de ticket, autoincremental.
    CashNoINT(11)Número de caja en la que se emitió el ticket
    CashierVARCHAR(20)Nombre del Cajero

    CategoryINT

    INT(11)id Categoría
    CategorySTRVARCHAR(100)Categoría
    QuantityINT(11)Cantidad
    DetailsVARCHAR(103)Detalles
    unit_priceDECIMAL(22,8)Precio unitario
    DiscountDECIMAL(19,4)Importe del Descuento
    totalDECIMAL(18,4)Total a cobrar
    DateTime_consumedDATETIMEFecha y hora del consumo
    DateTime_ticketDATETIMEFecha y hora de la emisión del ticket
    durationTIMEDuración, en caso de sesiones
    pcSMALLINT(6)Número de PC del consumo
    PosNoINT(11)Número de TPV. "0" es PC Servidor.

     

    Un ticket puede contener varios registros, por lo que se debe agrupar por campo 'TicketNo' para saber el total de cada ticket.

    Ejemplos:

     1) tickets


    Ejemplo de uso
    Tickets con su importe para la caja
    1SELECT ticketNo, SUM(T.total) AS Importe from view_tickets
    T

    WHERE
    T.
    CashNo=1 GROUP BY
    ticketno
    ticketNo

     

    Tabla de categorías de tickets

    Image Removed

    Esta es la lista de tipos de tickets posibles de la vista con su código y texto. 

    CategoryIntCategorySTR

    Image Added

    Vista: view_

    notascredito

    creditnotes

    Devuelve las notas de crédito emitidas.

    CampoTipoComentario
    TicketNoINT(11)Ticket vinculado a la nota de crédito
    CashNoINT(11)número de caja
    CashierVARCHAR(20)Operador que realiza la NC
    DetailsVARCHAR(640)Comentarios agregados a la NC
    numberINT(11)Número de nota de crédito
    totalDECIMAL(18,4)Importe de la NC
    DateTimeDATETIMEFecha y hora de emisión.

     

    Las notas de crédito están siempre asociadas a un ticket.Ej:

    Ejemplo de uso
    Todas las notas de crédito de la caja 1SELECT * FROM view_
    notascredito
    creditnotes
    WHERE cashNo = 1  

     

    Situaciones a tener en cuenta

    • Los tickets filtrados por fecha pueden no ser los mismos que filtrados por número de caja:
      Ej: Si una caja se cierra al dia siguiente de su apertura. Ej2: Si hay más de una caja (turno) en un mismo día. 
    • Las vistas están disponibles solo en bases Mysql instaladas en PC servidor de CyberPlanet (base Local).
    • Los Ingresos o Egresos adicionales que pueden formar parte de un turno no son accesibles desde la integración.

    Sv translation
    languageen


    Info
    titleContent

    Table of Contents
    maxLevel2

    CyberPlanet has the possibility to access the billing information in the database in real time. For this a group of Views configured on the MySql server are available.

    Connection to MySql base

    User: admin_reportes
    Port: 51897

    Password: 

    • CyberPlanet 6.5.0.110 or preview: 
      The password is that of the user "admin" of CyberPlanet. 
    • CyberPlanet 6.5.0.112 or later: 
      The password is configured in PC Menu Server, Configuration, Security, Administration/Operators, "Remote Access to Views"

    Data access

    View: view_tickets 

    Returns the tickets issued.

    FieldTypeComment
    TicketNoINT(11)Ticket number, auto-incremental.
    CashNoINT(11)Box number on which the ticket was issued
    CashierVARCHAR(20)Cashier’s Name

    CategoryINT

    INT(11)id Category
    CategorySTRVARCHAR(100)Category
    QuantityINT(11)Quantity
    DetailsVARCHAR(103)Details
    unit_priceDECIMAL(22,8)Unit price
    DiscountDECIMAL(19,4)discount amount
    totalDECIMAL(18,4)Total receivable
    DateTime_consumedDATETIMEDate and time of consumption
    DateTime_ticketDATETIMEDate and time of ticket issuance
    durationTIMEDuration, in the case of meetings
    pcSMALLINT(6)Number of PCs of consumption
    PosNoINT(11)POS number. "0" is PC Server.

     


    A ticket can contain multiple records, so it must be grouped by 'TicketNo' field to know the total of each ticket.

    Examples:

     1) Tickets with your cash amount 1
    SELECT ticketNo , SUM(T.total) AS Importe from view_tickets T WHERE T.CashNo=1 GROUP BY ticketno 


    Table of categories of tickets

    View: view_notascredito

    Returns the credit notes issued.

    FieldTypeComment
    TicketNoINT(11)Ticket linked to credit note
    CashNoINT(11)box number
    CashierVARCHAR(20)Operator performing the NC
    DetailsVARCHAR(640)Comments added to the NC
    numberINT(11)Credit note number
    totalDECIMAL(18,4)Amount of the CN
    DateTimeDATETIMEDate and time of issue.
     


    Credit notes are always associated with a ticket.

    Example: All credit notes in box 1

    SELECT * FROM view_notascredito WHERE cashNo = 1  

    Situations to consider

    • Tickets filtered by date may not be the same as tickets filtered by box number:
      Example: If a box closes the day after it opens. Ex 2: If there is more than one box (turn) on the same day. 
    • Views are available only on Mysql databases installed on CyberPlanet server PC (Local base).
    • Additional Income or Expenses that may be part of a shift are not accessible since integration.

     

    CyberPlanet has the possibility to access the billing information in the database in real time. A group of Views configured on the MySql server is available for this
    • .