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
 permite el acceso a información de facturación y clientes de la base de datos desde aplicaciones externas.
Para esto están disponibles un grupo de Vistas en el
En esta nota se describen las vistas disponibles y datos de conexión del servidor MySQL.

Conexión a MySQL Server

Usuario
:
admin_
reportes
reports
Puerto
51897
Contraseña
:
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

Lista de clientes creados hoy

SELECT * FROM view_Clientes Customers WHERE
CAST(creacionaccount_cuenta creation AS DATE)= CAST(NOW() AS DATE)

Todos los clientes menores de 18 años

SELECT * FROM view_clientes Customers WHERE
YEAR(NOW()) - YEAR(fecha_de_nacimientobirthday) < 18
Creditos de clientesSELECT usuariouser, creditocredit,
sec_to_time(tiempooffers_de_promostime * 60) as tiempo_de_promos,
sec_to_time(tiempo
exchange_depoints_canje_puntostime * 60) as tiempo_de_canje_puntos 
FROM view_clientes Customers



Vista: view view_customer_SeguimientoClientetracking

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 productostiempo
timeTIMETiempo de la sesión (Si se aplica)
PCdeviceNoVARCHAR(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'
importepaid_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
Eventos de hoy para cliente juanSELECT * FROM view_customer_seguimientocliente tracking WHERE
usuariouser='juan' AND CAST(fecha date_time AS DATE)= CAST(NOW() AS DATE)
order by fecha date_time
Tiempo total de sesiones de cada clienteSELECT usuariouser, sec_to_time(SUM(time_to_sec(tiempotime))) as tiempo
FROM view_seguimientoclientecustomer_tracking
GROUP BY usuariouser

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.


Ejemplo de uso
Tickets con su importe para la caja 1
:
SELECT 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.

Ejemplo de uso
Todas las notas de crédito de la caja 1
:
SELECT * 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.