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
Puerto51897
Contraseña

...

Puerto: 51897

Warning
titleAdvertencia

Si cambia la contraseña del usuario "admin" de CyberPlanet, también cambiará para el usuario "admin_reportes" en el próximo inicio de CyberPlanet.

Vistas

1. view_tickets

2. view_notas_credito

3. View_tipos

Ejemplos de uso de las vistas

1. select * from view_tickets;

...

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.

...

select nticket, sum(importe) as total_ticket from View_tickets group by nticket;

3. select * from view_tipos;

Contiene la descripción de cada tipo de movimiento. Ejemplo:

select ti.detalle, tk.*
from view_tickets tk
left join view_tipos ti on tk.tipo=ti.codigo;

Datos y situaciones a tener en cuenta:

1. Cada caja en CyberPlanet tiene su fecha establecida al iniciarse.

En el uso normal, se cierra caja 1 a 3 veces por dia (con cada cambio de turno del empleado).

Así que al ver todos los tickets agrupados por caja, podrán ver totales de recaudación coincidentes con los reportes de caja de CyberPlanet:

select sum(importe), ncaja from view_tickets group by ncaja;

2. Si la agrupación se hace por fecha podrían verse resultados distintos.
select sum(importe) as recaudacion, date(fecha) as fecha from view_tickets group by (date(fecha));

 

...


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

 

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

Image Added

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.

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

Image Added

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.