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_

    Clientes 

    Customers

    Devuelve los detalles de todos clientes registrados en CyberPlanet.

    CampoTipoComentario
    usuariouserVARCHAR(50)Nombre de usuario
    nombrenameVARCHAR(50)Nombre del cliente
    apellidosurnameVARCHAR(50)Apellido del cliente

    telefonophone

    VARCHAR(15)Teléfono del cliente
    e-mailemailVARCHAR(50)Correo electrónico del cliente
    identificacionpersonal_identificationVARCHAR(50)Identificación personal del cliente (DNI, pasaporte, etc.)
    fecha_de_nacimientobirthdayDATEFecha de nacimiento del cliente
    creditocreditDECIMAL(18,3)Crédito monetario remanente
    PuntospointsINT(11)Puntos remanentes
    tiempooffers_de_promostimeINT(11)Tiempo remanente de promociones (Minutos)
    tiempoexchange_depoints_canje_puntostimeINT(11)Tiempo remanente de tiempo de puntos (Minutos)
    (Resultado del canje de puntos por tiempo (Minutos)
    creacionaccount_cuentacreationDATETIMEFecha y hora de creación de la cuenta
    vencimientoexpiration_cuentaaccountDATETIMEFecha límite de uso de la cuenta
    cuentablocked_bloqueadaaccountSMALLINTIndica si la cuenta fue bloqueada por el operador
    (Si el valor es 1, la cuenta está bloqueada.)
    ultimolast_loginDATETIMEFecha y hora del último inicio de sesión

    Ejemplos de uso

    Para ver la lista
    Lista de clientes creados hoy
    :

    SELECT * FROM view_

    Clientes

    Customers WHERE
    CAST(

    creacion

    account_

    cuenta

    creation AS DATE)= CAST(NOW() AS DATE)

    Para listar todos

    Todos los clientes menores de 18 años

    :

    SELECT * FROM view_
    clientes
    Customers WHERE
    YEAR(NOW()) - YEAR
    (fecha_de_nacimiento) < 18Vista: view_SeguimientoCliente
    (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.

    gasto
    CampoTipoComentario
    fechadate_timeDATETIMEFecha y hora del evento
    detalledetailsVARCHAR(100)Detalles informativos del evento
    usuariouserVARCHAR(50)Nombre de usuario del cliente

    idcliente

    INT(11)Uso interno
    EsCanjePuntosSMALLINTis_paid_with_pointsBOOLEANIndica si el evento se corresponde con un canje de puntos por tiempo o productos
    tiempoINT(11)timeTIMETiempo de la sesión en segundos (Si se aplica)
    PCdeviceNoVARCHAR(10)Número de PC , o 'WiFi' si era una o Consola de videojuego
    En caso de sesión iniciada a través del Control de zonas WiFiimporte, el dato será 'WiFi'
    paid_in_cashDECIMAL(18,3)Importe pagado si el evento representa una carga o recarga de créditocompra en efectivo.
    paid_with_creditDECIMAL(18,3)Crédito monetario consumido por uso de tiempo o compra de productos/servicios con crédito
    saldoCredit_BalanceDECIMAL(18,4)Crédito monetario remanente luego del evento
    efvoDECIMAL(18,4)Importe pagado si el evento representa una compra en efectivo.
    ncajaPoints_TimeINT(11)número de caja Tiempo remanente de canje de puntos al momento del evento
    TiempoOfertasPuntosOffers_TimeINT(11)Tiempo remanente de promociones + tiempo de canje de puntos al momento del evento
    idCashNoINT(11)Uso internonúmero de caja al momento del evento
    Ejemplos de uso
    Para ver los eventos
    Eventos de hoy para cliente juan
    :
    SELECT * FROM view_customer_
    seguimientocliente
    tracking WHERE
    usuario
    user='juan' AND CAST(
    fecha
    date_time AS DATE)= CAST(NOW() AS DATE)
    Para ver el tiempo

    order by date_time
    Tiempo total de sesiones de cada cliente
    :
    SELECT
    usuario
    user, sec_to_time(SUM(time_to_sec(
    tiempo
    time))) as tiempo
    FROM view_customer_
    seguimientocliente
    tracking
    GROUP BY
    usuario
    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 RemovedEsta 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.