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

Conexión a MySQL Server

Usuario: admin_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_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.


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 ticketnoticketNo

 

Tabla de categorías de tickets

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

CategoryIntCategorySTR

Vista: view_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 1SELECT * FROM view_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.

...