Page History

Sv translation

language	es

Info

title	Contenido

Table of Contents

...

maxLevel	2

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

...

Puerto: 51897

Warning

title	Advertencia

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

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.

Campo	Tipo	Comentario
user	VARCHAR(50)	Nombre de usuario
name	VARCHAR(50)	Nombre del cliente
surname	VARCHAR(50)	Apellido del cliente
phone	VARCHAR(15)	Teléfono del cliente
email	VARCHAR(50)	Correo electrónico del cliente
personal_identification	VARCHAR(50)	Identificación personal del cliente (DNI, pasaporte, etc.)
birthday	DATE	Fecha de nacimiento del cliente
credit	DECIMAL(18,3)	Crédito monetario remanente
points	INT(11)	Puntos remanentes
offers_time	INT(11)	Tiempo remanente de promociones (Minutos)
exchange_points_time	INT(11)	Tiempo remanente de tiempo de puntos (Minutos) (Resultado del canje de puntos por tiempo)
account_creation	DATETIME	Fecha y hora de creación de la cuenta
expiration_account	DATETIME	Fecha límite de uso de la cuenta
blocked_account	SMALLINT	Indica si la cuenta fue bloqueada por el operador (Si el valor es 1, la cuenta está bloqueada.)
last_login	DATETIME	Fecha 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 clientes	SELECT 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.

Campo	Tipo	Comentario
date_time	DATETIME	Fecha y hora del evento
details	VARCHAR(100)	Detalles informativos del evento
user	VARCHAR(50)	Nombre de usuario del cliente
is_paid_with_points	BOOLEAN	Indica si el evento se corresponde con un canje de puntos por tiempo o productos
time	TIME	Tiempo de la sesión (Si se aplica)
deviceNo	VARCHAR(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_cash	DECIMAL(18,3)	Importe pagado si el evento representa una compra en efectivo.
paid_with_credit	DECIMAL(18,3)	Crédito monetario consumido por uso de tiempo o compra de productos/servicios con crédito
Credit_Balance	DECIMAL(18,4)	Crédito monetario remanente luego del evento
Points_Time	INT(11)	Tiempo remanente de canje de puntos al momento del evento
Offers_Time	INT(11)	Tiempo remanente de promociones al momento del evento
CashNo	INT(11)	número de caja al momento del evento

Ejemplos de uso
Eventos de hoy para cliente juan	SELECT * 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 cliente	SELECT 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.

Campo	Tipo	Comentario
TicketNo	INT(11)	Número de ticket, autoincremental.
CashNo	INT(11)	Número de caja en la que se emitió el ticket
Cashier	VARCHAR(20)	Nombre del Cajero
CategoryINT	INT(11)	id Categoría
CategorySTR	VARCHAR(100)	Categoría
Quantity	INT(11)	Cantidad
Details	VARCHAR(103)	Detalles
unit_price	DECIMAL(22,8)	Precio unitario
Discount	DECIMAL(19,4)	Importe del Descuento
total	DECIMAL(18,4)	Total a cobrar
DateTime_consumed	DATETIME	Fecha y hora del consumo
DateTime_ticket	DATETIME	Fecha y hora de la emisión del ticket
duration	TIME	Duración, en caso de sesiones
pc	SMALLINT(6)	Número de PC del consumo
PosNo	INT(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

...

view_notascredito

...

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

CategoryInt	CategorySTR

Image Added

Vista: view_creditnotes

Devuelve las notas de crédito emitidas.

Campo	Tipo	Comentario
TicketNo	INT(11)	Ticket vinculado a la nota de crédito
CashNo	INT(11)	número de caja
Cashier	VARCHAR(20)	Operador que realiza la NC
Details	VARCHAR(640)	Comentarios agregados a la NC
number	INT(11)	Número de nota de crédito
total	DECIMAL(18,4)	Importe de la NC
DateTime	DATETIME	Fecha 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_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

language	en

Info

title	Content

Table of Contents

maxLevel	2

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.

Field	Type	Comment
TicketNo	INT(11)	Ticket number, auto-incremental.
CashNo	INT(11)	Box number on which the ticket was issued
Cashier	VARCHAR(20)	Cashier’s Name
CategoryINT	INT(11)	id Category
CategorySTR	VARCHAR(100)	Category
Quantity	INT(11)	Quantity
Details	VARCHAR(103)	Details
unit_price	DECIMAL(22,8)	Unit price
Discount	DECIMAL(19,4)	discount amount
total	DECIMAL(18,4)	Total receivable
DateTime_consumed	DATETIME	Date and time of consumption
DateTime_ticket	DATETIME	Date and time of ticket issuance
duration	TIME	Duration, in the case of meetings
pc	SMALLINT(6)	Number of PCs of consumption
PosNo	INT(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.

Field	Type	Comment
TicketNo	INT(11)	Ticket linked to credit note
CashNo	INT(11)	box number
Cashier	VARCHAR(20)	Operator performing the NC
Details	VARCHAR(640)	Comments added to the NC
number	INT(11)	Credit note number
total	DECIMAL(18,4)	Amount of the CN
DateTime	DATETIME	Date 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.

Space shortcuts

Documentación CyberPlanet 6.5

Page tree

Versions Compared

Old Version 6

New Version Current

Key