Juegos de Azar y Apuestas WEB SERVICE JAZAService Manual para el Desarrollador - Versión 1.0.1
←
→
Transcripción del contenido de la página
Si su navegador no muestra la página correctamente, lea el contenido de la página a continuación
Juegos de Azar y Apuestas
WEB SERVICE JAZAService
Versión 1.0.1
Manual para el DesarrolladorContenido
1 Introducción .......................................................................................................................... 3
1.1 Objetivo ........................................................................................................................ 3
1.2 Alcance ........................................................................................................................ 3
1.3 Tratamiento de errores Excepcionales en el WS ........................................................ 4
1.4 Tratamiento de errores en el WS por validaciones de formato. .................................. 5
1.5 Tratamiento de errores en el WS por validaciones del negocio. ................................. 6
1.6 Operatoria. ................................................................................................................... 7
1.6.1 Informar Resumen diario por Punto de Explotación ................................................ 7
1.6.2 Casos de Uso .......................................................................................................... 7
1.6.3 Informar Resumen diario de Máquinas Electrónicas para un Punto de
Explotación ........................................................................................................................... 7
1.6.4 Informar Resumen diario – Otros (Partidas de Bingo, Cajas Consolidadas
Bingo y Mesas Vivas) para un Punto de Explotación ........................................................... 8
1.7 Manejo transaccional ................................................................................................... 9
2 Web Services de Negocio .................................................................................................. 10
2.1 Dirección URL ............................................................................................................ 10
2.2 Validaciones sobre la Entidad informante ................................................................. 10
2.3 Autenticación.............................................................................................................. 10
2.4 Operaciones ............................................................................................................... 12
2.4.1 Informar Resumen Diario – Máquinas Electrónicas (informarResumenDiaME) ... 12
2.4.1.1 Mensaje de Solicitud ..................................................................................... 12
2.4.1.2 Mensaje de Respuesta ................................................................................. 14
2.4.1.3 Validaciones del Negocio .............................................................................. 15
2.4.1.4 Ejemplos ....................................................................................................... 17
2.4.2 Informar Resumen Diario – Otros (informarResumenDiaOtros) ........................... 18
2.4.2.1 Mensaje de Solicitud ..................................................................................... 20
2.4.2.2 Mensaje de Respuesta ................................................................................. 23
2.4.2.3 Validaciones del Negocio .............................................................................. 24
2.4.2.4 Ejemplos ....................................................................................................... 27
2.4.3 Consultar Máquina Electrónica Informada (consultarMEInformada) .................... 32
2.4.3.1 Mensaje de Solicitud ..................................................................................... 32
2.4.3.2 Mensaje de Respuesta ................................................................................. 32
2.4.3.3 Validaciones del Negocio .............................................................................. 34
2.4.4 Consultar Ids de Máquinas Electrónicas Informadas
(consultarIdsMEInformadas) .............................................................................................. 36
2.4.4.1 Mensaje de Solicitud ..................................................................................... 36
2.4.4.2 Mensaje de Respuesta ................................................................................. 36
2.4.4.3 Validaciones del Negocio .............................................................................. 38
2.4.5 Consultar Ids de Máquinas Electrónicas Pendientes
(consultarIdsMEPendientes) .............................................................................................. 39
2.4.5.1 Mensaje de Solicitud ..................................................................................... 39
2.4.5.2 Mensaje de Respuesta ................................................................................. 39
2.4.5.3 Validaciones del Negocio .............................................................................. 41
2.4.6 Consultar Resumen Diario - Otros (consultarResumenDiaOtros) ........................ 42
2.4.6.1 Mensaje de Solicitud ..................................................................................... 42
2.4.6.2 Mensaje de Respuesta ................................................................................. 42
2.4.6.3 Validaciones del Negocio .............................................................................. 46
2.4.7 Dummy .................................................................................................................. 47
2.4.7.1 Mensaje de Solicitud ..................................................................................... 47
2.4.7.2 Mensaje de Respuesta ................................................................................. 47
2.4.7.3 Ejemplo para “Dummy” ................................................................................. 47
3 Definición de tipos de datos ............................................................................................... 49
3.1 Simple Types ............................................................................................................. 49
3.2 Complex Types (genéricos) ....................................................................................... 50
3.3 Aclaraciones y Definiciones ....................................................................................... 52
3.4 Abreviaturas ............................................................................................................... 52
21 Introducción
1.1 Objetivo
Brindar la información necesaria para desarrollar un cliente del Web Service de informe de
operaciones en puntos de explotación.
1.2 Alcance
Comprende desde la definición del WSDL hasta las validaciones de negocio que realizará el
servicio.
El presente WS permite llevar a cabo las siguientes operaciones:
Informar el resumen del día por punto de explotación – Máquinas Electrónicas
Informar el resumen del día por punto de explotación – Otros
dummy
Este documento debe complementarse con los documentos correspondientes al Servicio de
Autenticación y Autorización (WSAA), al SERVICIO DE AUTENTICACION DE
CONTRIBUYENTES DE AFIP y Resoluciones Generales que norman los proyectos
pertinentes.
31.3 Tratamiento de errores Excepcionales en el WS
Los errores excepcionales serán del tipo descriptivo y tendrán el siguiente tratamiento:
ns3: Receiver
[wscommon_007] La firma no corresponde al token
enviado.
(ejemplo)
donde:
es del tipo string
Describe al error que se generó al procesar la solicitud.
Los errores excepcionales incluyen también errores graves de estructura XML (ej: tags sin
cerrar).
41.4 Tratamiento de errores en el WS por validaciones de formato.
El tratamiento de errores originados por validaciones de formato (definido en los diferentes
tipos de datos), para todos los métodos, tendrá el siguiente esquema:
…..
string
string
…..
Donde:
es del tipo ArrayCodigosDescripcionesStringType que es un
array de
Campo Descripción
codigo Código de error
descripción Descripción del error
Cabe aclarar que, de no superar alguna de las validaciones de formato, el WS devolverá el
arrayErroresFormato y no continuará con las validaciones de negocio, por lo cual no existirá
el elemento arrayErrores. Son excluyentes.
…
cvc-datatype-valid.1.2.1
'?' no es un valor válido para un
tipo de dato entero.
5cvc-type.3.1.3
El valor '?' en el elemento
'cuitComprador' no es válido.
...
…
(Ejemplo)
1.5 Tratamiento de errores en el WS por validaciones del negocio.
El tratamiento de errores originados por validaciones del negocio, para todos los métodos,
tendrá el siguiente esquema:
…..
short
string
…..
Donde:
es del tipo ArrayCodigosDescripcionesType que es un array de
Campo Descripción
codigo Código de error
descripcion Descripción del error
61.6 Operatoria.
1.6.1 Informar Resumen diario por Punto de Explotación
Se podrán obtener los siguientes resultados:
A: Aceptado sin inconsistencias. En este caso el response NO va a contener el
arrayErrores ni el arrayErroresFormato.
R: Rechazado. El requerimiento presenta errores que impiden la aceptación. Esto puede
suceder ante errores de formato o errores de validaciones de negocio excluyentes (ejemplo
máquina no registrada en JAzA).
Los errores de formato serán indicados mediante el array arrayErroresFormato, mientras
que los errores por validaciones del negocio serán detallados mediante el array
arrayErrores.
1.6.2 Casos de Uso
1.6.3 Informar Resumen diario de Máquinas Electrónicas para un Punto de
Explotación
El resumen diario de información de máquinas electrónicas se realiza máquina por máquina,
debiendo enviarse un resumen por día de la operatoria de cada máquina.
Antes de poder informar el resumen diario de máquinas electrónicas para un punto de
explotación dado, se debe:
Registrar el Punto de Explotación en la aplicación web JAzA
Registrar las máquinas electrónicas de dicho punto de explotación en la aplicación web
JAzA
Una vez realizados los pasos previos descriptos, desde WSJAZA se podrá proceder a:
Invocar el método consultarIdsMEPendientes, indicando como parámetro el número
identificador del punto de explotación, para obtener el listado de máquinas cuyos
movimientos deben informarse. Este paso es opcional.
Por cada máquina, invocar el método informarResumenDiaME. Si una máquina tuvo
eventos de reseteo o rollover, se deberá realizar una invocación adicional por cada
evento, incrementando en cada caso el número de secuencia.
o En caso de rechazo por parte del sistema WSJAZA para una presentación y
secuencia de una máquina, se deberá corregir la causa de dicho rechazo y volver
a informar la máquina, con el mismo número de presentación y secuencia.
o Si la información de una máquina es aceptada por el sistema WSJAZA pero el
emisor luego descubre que la información enviada es incorrecta, deberá volver a
enviar la misma con los datos correctos, incrementando el número de
presentación en 1. Si en la presentación original había mas de una secuencia, se
deberán reenviar todas, no sólo la secuencia en la que se hayan detectado
7información incorrecta. Sólo se toma como válida la última presentación de una
máquina para cada fecha de presentación.
Invocar el método consultarIdsMEInformadas, indicando como parámetro el número
identificador del punto de explotación y la fecha de la presentación informada, para
obtener el listado de máquinas que figuran como informadas. Este paso es opcional.
Informe aceptado sin inconsistencias:
Se invoca el método para informar el resumen diario. El resultado del requerimiento es A.
Informe con al menos una inconsistencia de nivel rechazo:
Se invoca el método para informar el resumen diario. El resultado del requerimiento es R.
1.6.4 Informar Resumen diario – Otros (Partidas de Bingo, Cajas
Consolidadas Bingo y Mesas Vivas) para un Punto de Explotación
El resumen diario de información de partidas de bingo y cajas consolidadas de bingo y mesas
vivas se realiza de forma conjunta, en una sola invocación, debiendo enviarse un resumen por
día.
Antes de poder informar el resumen diario para un punto de explotación dado, se debe:
Registrar el Punto de Explotación en la aplicación web JAzA
Registrar, en caso de corresponder, la cantidad de sillas (sala de bingo) y la cantidad y
tipos de mesas vivas asociadas a dicho punto de explotación en la aplicación web JAzA
Una vez realizados los pasos previos descriptos, desde WSJAZA se podrá proceder a:
Invocar el método informarResumenDiaOtros, indicando como parámetros mínimos
obligatorios el número de punto de explotación y la fecha a la cual corresponde la
presentación. En caso de corresponder, se deberá incluir también el detalle de partidas de
bingos, la caja consolidada de bingos y las cajas consolidadas de mesas vivas (una por
cada tipo de mesa).
o En caso de rechazo por parte del sistema WSJAZA para una presentación, se
deberá corregir la causa de dicho rechazo y volver a informar el resumen
completo, con el mismo número de presentación.
o Si la información es aceptada es aceptada por el sistema WSJAZA pero el emisor
luego descubre que la información enviada es incorrecta, deberá volver a enviar
la misma con los datos correctos, incrementando el número de presentación en 1.
Se deberá enviar toda la información, no solo la parte que fue corregida.
Invocar el método consultarResumenDiaOtros, indicando como parámetro el número
identificador del punto de explotación y la fecha de la presentación informada, para
verificar la información registrada. Este paso es opcional.
Informe aceptado sin inconsistencias:
Se invoca el método para informar el resumen diario. El resultado del requerimiento es A.
Informe con al menos una inconsistencia de nivel rechazo:
Se invoca el método para informar el resumen diario. El resultado del requerimiento es R.
81.7 Manejo transaccional
Si no se obtiene respuesta luego de la invocación de un método, puede haber ocurrido un
error de comunicación (corte de conexión, timeout, etc.) De ser así puede ocurrir que el
request no llegue a los servidores de AFIP o que llegue y se emita una respuesta pero la
misma no llegue al cliente.
Si se invoca el método para informar el resumen diario y no se obtiene respuesta deberá
utilizarse el método de consulta individual de máquina electrónicas para verificar si la
información ya fue registrada en los servidores AFIP. De no ser así, se deberá reenviar la
información. Cabe aclarar que si se reenvía la información sin verificar previamente la no
recepción del envío previo, el sistema rechazará el envío en caso de ser un duplicado
(misma fecha de presentación, numero de presentación y secuencia para una máquina
dada).
92 Web Services de Negocio
2.1 Dirección URL
Este servicio se llama en Testing desde:
https://fwshomo.afip.gov.ar/wsjaza/JAZAService
Nota: el URL precedente es al cual se conectará la aplicación cliente, no es un URL para ser ingresado en un
navegador Web.
Para visualizar el WSDL en Testing:
https://fwshomo.afip.gov.ar/wsjaza/JAZAService?wsdl
Este servicio se llama en Producción desde:
https://serviciosjava.afip.gob.ar/wsjaza/JAZAService
Nota: el URL precedente es al cual se conectará la aplicación cliente, no es un URL para ser ingresado en un
navegador Web.
Para visualizar el WSDL en Producción:
https://serviciosjava.afip.gob.ar/wsjaza/JAZAService?wsdl
2.2 Validaciones sobre la Entidad informante
Campo Validación NO es superada
Debe encontrarse activa en el
cuitRepresentada Rechaza
Sistema Registral
Debe encontrarse dentro del
cuitRepresentada Rechaza
padrón de JAzA
La CUIT emisora deberá figurar en
token la lista de CUITs proveedoras Rechaza
homologadas
2.3 Autenticación
Para utilizar cualquiera de los métodos disponibles en el presente WS se deberá remitir la
información obtenida del WSAA resultante del proceso de autenticación, mediante el
siguiente esquema:
10.
.
string
string
CuitSimpleType
.
.
Donde:
es del tipo AuthRequestType. Contiene la información referente a la
autenticación
Campo / Grupo Descripción Obligatorio Tipo Longitud
Token devuelto por el
token S String --
WSAA
Signature devuelta por
sign S String --
el WSAA
cuitRepresentada CUIT de la Entidad S CuitSimpleType 11
Se validará en todos los casos que la CUIT informante se encuentre entre sus
representados. El Token y el Sign remitidos deberán ser válidos y no estar vencidos.
De no superarse algunas de las situaciones descriptas anteriormente retornará un error del
tipo excepcional.
112.4 Operaciones
2.4.1 Informar Resumen Diario – Máquinas Electrónicas
(informarResumenDiaME)
Mediante este método se podrá informar el resumen diario de la operatoria de máquinas
electrónicas para cada punto de explotación, indicando para cada máquina el estado inicial
y final de sus contadores, reseteos, etc.
2.4.1.1 Mensaje de Solicitud
Esquema
string
string
CuitSimpleType
short
date
short
IdMaquinaElectronicaSimpleType
short
dateTime
dateTime
ImporteNoNegativoSimpleType
ContadorSimpleType
ContadorSimpleType
ContadorSimpleType
ContadorSimpleType
ContadorSimpleType
ContadorSimpleType
ContadorSimpleType
12ContadorSimpleType
Donde:
es del tipo
InformarResumenDiaMERequestType. Contiene el resumen diario para un punto de
explotación dado.
Longitud
Campo / Grupo Descripción Oblig. Tipo
(máx)
Información de
authRequest autenticación del emisor S AuthRequestType --
del request
Número identificador del
nroPuntoExplotacion Punto de Explotación que S short 5
se está informando
fechaPresentacion Fecha de la presentación S date --
Número de la
nroPresentacion S short 4
presentación
arrayDetalleMaquinasElectroni Lista de detalles de ArrayDetalleMaquina
S --
cas máquinas electronicas sElectronicasType
es un array de elementos ,
que son de tipo DetalleMaquinaElectronicaType
DetalleMaquinaElectronicaType
Longitud
Campo / Grupo Descripción Oblig. Tipo
(máx)
Identificador de la máquina IdMaquinaElectronicaSimple
idMaquina S --
electrónica Type
Número de secuencia. Para
un día y una máquina
secuencia S short 4
dada, deberá comenzar en
1
fechaHoraSecuencia Fecha y hora de inicio de la
S dateTime --
Inicio secuencia informada
fechaHoraSecuencia Fecha y hora de fin de la
S dateTime --
Fin secuencia informada
Denominación de ImporteNoNegativoSimpleTy
denomContabilidad S --
Contabilidad pe
Grupo con los valores
contadoresInicial S GrupoContadoresMEType --
iniciales de los contadores
Grupo con los valores
contadoresFinal S GrupoContadoresMEType --
finales de los contadores
132.4.1.2 Mensaje de Respuesta
Esquema
ResultadoSimpleType
short
string
string
string
Donde:
es del tipo InformarResumenDiaMEReturnType
Longitud
Campo Descripción Oblig. Tipo
(máx)
Indica si la información
resultado provista fue aceptada o S ResultadoSimpleType 1
presenta errores
Si la información enviada
no supera las
ArrayCodigosDescrip
arrayErrores validaciones de negocio, N --
cionesType
en este array se detallan
los errores detectados
Si el request presenta
errores de formato (tags
inválidos, sin cerrar,
datos que no ArrayCodigosDescrip
arrayErroresFormato N --
corresponden al tipo de cionesStringType
dato del elemento, etc),
en este array se detallan
dichos errores
142.4.1.3 Validaciones del Negocio
…
Validaciones Excluyentes
Código de NO es
Campo / Grupo Validación
Error superada
El punto de explotación deberá
cuitRepresentada,
1000 estar dado de alta en el sistema Rechaza
nroPuntoExplotacion
JAzA para la CUIT representada
La fecha de presentación no
fechaPresentacion 1020 puede ser superior a la fecha Rechaza
actual
La máquina electrónica a
cuitRepresentada,
informar debe estar declarada en
nroPuntoExplotacion, 1001 Rechaza
JAzA para la CUIT y punto de
idMaquina
explotación indicados
La fecha de presentación
cuitRepresentada,
indicada no debe ser anterior al
nroPuntoExplotacion,
1002 inicio de operaciones registrado Rechaza
idMaquina,
en JAzA para la máquina
fechaPresentacion
electrónica
cuitRepresentada, Antes de informar los datos de la
nroPuntoExplotacion, máquina electrónica para la
1003 Rechaza
idMaquina, fecha indicada, debe informarlos
fechaPresentacion para la primer fecha pendiente
cuitRepresentada,
Sólo se pueden rectificar
nroPuntoExplotacion,
1004 presentaciones dentro de los 30 Rechaza
idMaquina,
días
fechaPresentacion
cuitRepresentada, Para el primer envío de
nroPuntoExplotacion, información de una máquina en
idMaquina, 1005 una fecha dada, se debe Rechaza
fechaPresentacion, informar número de presentación
nroPresentacion 1
cuitRepresentada,
nroPuntoExplotacion, Para el primer envío de
idMaquina, información de una máquina en
1006 Rechaza
fechaPresentacion, una fecha dada, se debe
nroPresentacion, informar secuencia 1
nroSecuencia
Si se informa una secuencia
cuitRepresentada, adicional para una máquina
nroPuntoExplotacion, (debido a la existencia de un
idMaquina, rollover o reseteo) se debe
1007 Rechaza
fechaPresentacion, indicar el mismo número de
nroPresentacion, presentación e incrementar el
nroSecuencia número de secuencia en uno
para dicha máquina
15Código de NO es
Campo / Grupo Validación
Error superada
cuitRepresentada,
Para el primer envío de
nroPuntoExplotacion,
información de una máquina en
idMaquina,
1008 una fecha y número de Rechaza
fechaPresentacion,
presentación dada (rectificativa),
nroPresentacion,
se debe informar secuencia 1
nroSecuencia
Para una máquina, punto de
explotación y fecha dada, se
debe informar nro de
cuitRepresentada, presentación 1 si es el primer
nroPuntoExplotacion, envío. Si no es el primer envío,
idMaquina, 1009 se deberá informar el mismo Rechaza
fechaPresentacion, número de presentación enviado
nroPresentacion previamente (si es una nueva
secuencia) o incrementar el
número de presentación en 1 (si
es una rectificativa)
cuitRepresentada,
nroPuntoExplotacion, Si se informa una nueva
idMaquina, secuencia para una máquina, la
fechaPresentacion, fecha-hora de inicio de secuencia
1010 Rechaza
nroPresentacion, debe ser mayor o igual a la
nroSecuencia, fecha-hora de fin de secuencia
fechaHoraSecuenciaInicio, de la secuencia anterior
fechaHoraSecuenciaFin
cuitRepresentada,
nroPuntoExplotacion, Si se informa la primer secuencia
idMaquina, de una máquina y existen datos
fechaPresentacion, informados el día anterior, el
nroPresentacion, contador inicial de juegos
1011 Rechaza
nroSecuencia, jugados deberá coincidir con el
contadoresInicial.juegos contador final de juegos jugados
Jugados, de la última secuencia informada
contadoresFinal.juegosJ el día anterior para esa máquina
ugados
cuitRepresentada, Si se informa la primer secuencia
nroPuntoExplotacion, de una máquina y existen datos
idMaquina, informados el día anterior, el
fechaPresentacion, contador inicial de coin-in deberá
1012 Rechaza
nroPresentacion, coincidir con el contador final de
nroSecuencia, coin-in de la última secuencia
contadoresInicial.coinIn informada el día anterior para
, contadoresFinal.coinIn esa máquina
cuitRepresentada,
Si se informa la primer secuencia
nroPuntoExplotacion,
de una máquina y existen datos
idMaquina,
informados el día anterior, el
fechaPresentacion,
contador inicial de coin-out
nroPresentacion, 1013 Rechaza
deberá coincidir con el contador
nroSecuencia,
final de coin-out de la última
contadoresInicial.coinO
secuencia informada el día
ut,
anterior para esa máquina
contadoresFinal.coinOut
16Código de NO es
Campo / Grupo Validación
Error superada
cuitRepresentada,
Si se informa la primer secuencia
nroPuntoExplotacion,
de una máquina y existen datos
idMaquina,
informados el día anterior, el
fechaPresentacion,
contador inicial de jackpot
nroPresentacion, 1014 Rechaza
deberá coincidir con el contador
nroSecuencia,
final de jackpot de la última
contadoresInicial.jackpo
secuencia informada el día
t,
anterior para esa máquina
contadoresFinal.jackpot
contadoresInicial.juegos El contador final de juegos debe
, 1101 ser mayor o igual al contador Rechaza
contadoresFinal.juegos inicial
El contador final de coin-in debe
contadoresInicial.coinIn
1102 ser mayor o igual al contador Rechaza
, contadoresFinal.coinIn
inicial
contadoresInicial.coinO El contador final de coin-out
ut, 1103 debe ser mayor o igual al Rechaza
contadoresFinal.coinOut contador inicial
contadoresInicial.jackpo El contador final de jackpot debe
t, 1104 ser mayor o igual al contador Rechaza
contadoresFinal.jackpot inicial
2.4.1.4 Ejemplos
Ejemplo 1: se envía información de la máquina SDFGDFG1 del punto de
explotación 1 correspondiente a la fecha 05/10/2014. La misma supera todas las
validaciones y es aceptada.
Request:
?
?
30000000007
1
2014-10-05
1
SDFGDFG1
1
2014-07-10T12:00:00
2014-07-10T13:00:00
3000
171010
5010
7010
9010
2000
7000
8000
10000
Response:
A
Ejemplo 2: se envía información de la máquina SDFGDFG1 del punto de
explotación 1 correspondiente a la fecha 20/10/2014. La misma es rechazada
porque hay información correspondiente a fechas previas que aún no ha sido
informada.
Request:
?
?
30000000007
1
2014-10-20
1
SDFGDFG1
1
2014-07-
10T12:00:00
2014-07-
10T13:00:00
3000
1000
4000
186000
8000
2000
5000
7000
9000
Response:
R
1003
Antes de informar los datos para la fecha
20/10/2014 debe informar los datos para la fecha 06/10/2014
192.4.2 Informar Resumen Diario – Otros (informarResumenDiaOtros)
Mediante este método se podrá informar el resumen diario para cada punto de explotación
en lo que respecta a partidas de bingo, y cajas consolidadas de mesas vivas y bingo, en
caso de corresponder.
2.4.2.1 Mensaje de Solicitud
Esquema
string
string
CuitSimpleType
short
date
short
EnteroPositivoSimpleType
dateTime
ImporteNoNegativoSimpleType
EnteroPositivoSimpleType
EnteroPositivoSimpleType
EnteroNoNegativoSimpleType
EnteroNoNegativoSimpleType
EnteroNoNegativoSimpleType
ImporteNoNegativoSimpleType
short
short
20ImporteNoNegativoSimpleType
ImporteNoNegativoSimpleType
ImporteNoNegativoSimpleType
ImporteNoNegativoSimpleType
ImporteNoNegativoSimpleType
ImporteNoNegativoSimpleType
ImporteNoNegativoSimpleType
ImporteNoNegativoSimpleType
ImporteNoNegativoSimpleType
ImporteNoNegativoSimpleType
ImporteSimpleType
ImporteNoNegativoSimpleType
ImporteNoNegativoSimpleType
ImporteNoNegativoSimpleType
ImporteNoNegativoSimpleType
ImporteNoNegativoSimpleType
ImporteNoNegativoSimpleType
ImporteSimpleType
Donde:
es del tipo
InformarResumenDiaOtrosRequestType. Contiene el resumen diario para un punto de
explotación dado.
Longitud
Campo / Grupo Descripción Oblig. Tipo
(máx)
Información de
authRequest autenticación del emisor S AuthRequestType --
del request
Número identificador del
nroPuntoExplotacion Punto de Explotación que S short 5
se está informando
21Longitud
Campo / Grupo Descripción Oblig. Tipo
(máx)
fechaPresentacion Fecha de la presentación S date --
Número de la
nroPresentacion S short 4
presentación
Lista de detalles de ArrayDetallePartidas
arrayDetallePartidasBingo N --
partidas de bingo BingoType
Lista de cajas
arrayCajasConsolidadaMesasV ArrayCajasConsolida
consolidadas de mesas N --
ivas daMesasVivasType
vivas
Caja consolidada de CajaConsolidadaBing
cajaConsolidadaBingos N --
bingos osType
es un array de elementos , que son de tipo
DetallePartidaBingoType
DetallePartidaBingoType
Longitud
Campo / Grupo Descripción Oblig. Tipo
(máx)
nroPartida Número de partida S EnteroPositivoSimpleType 9
Fecha-hora de inicio de la
fechaHoraInicio S dateTime --
partida
valorCarton Valor del cartón S ImporteNoNegativoSimpleType --
Número de serie (se debe
informar sólo si hay más
nroSerie N EnteroPositivoSimpleType 4
de una serie para una
misma partida)
cantidadCartonesSer Cantidad de cartones en la
S EnteroNoNegativoSimpleType 6
ie serie
cantidadCartonesVe Cantidad de cartones
S EnteroNoNegativoSimpleType 6
ndidos vendidos
nroPrimerCartonVen Número del primer cartón
S EnteroNoNegativoSimpleType 6
dido vendido
nroUltimoCartonVen Número del último cartón
S EnteroNoNegativoSimpleType 6
dido vendido
totalPremiosPagados Total de premios pagados S ImporteNoNegativoSimpleType --
es un array de elementos
, que son de tipo CajaConsolidadaMesasVivasType
CajaConsolidadaMesasVivasType
Longitud
Campo / Grupo Descripción Oblig. Tipo (máx)
Código identificador del
tipoMesa S short 4
tipo de mesa
Cantidad de mesas del tipo
cantidadMesas S short 4
indicado
Efectivo en el momento de
efectivoApertura S ImporteNoNegativoSimpleType --
apertura
Efectivo en el momento de
efectivoCierre S ImporteNoNegativoSimpleType --
cierre
importeEqFichasApe Importe equivalente fichas
S ImporteNoNegativoSimpleType --
rtura apertura
importeEqFichasCier Importe equivalente fichas
S ImporteNoNegativoSimpleType --
re cierre
totalRetiros Total de retiros S ImporteNoNegativoSimpleType --
totalReposiciones Total de reposiciones S ImporteNoNegativoSimpleType --
totalRetirosEqFichas Total de retiros equivalente S ImporteNoNegativoSimpleType --
22Longitud
Campo / Grupo Descripción Oblig. Tipo
(máx)
fichas
totalReposicionesEq Total de reposiciones
S ImporteNoNegativoSimpleType --
Fichas equivalente fichas
totalVentas Total de ventas S ImporteNoNegativoSimpleType --
totalPagos Total de pagos S ImporteNoNegativoSimpleType --
Diferencia de caja (puede
diferenciaCaja S ImporteSimpleType --
ser positiva o negativa)
Total equivalente ticketes
totalEqTicketsFondP
fondos promocionales S ImporteNoNegativoSimpleType --
romOtorg
otorgados
Total equivalente ticketes
totalEqTicketsFondP
fondos promocionales S ImporteNoNegativoSimpleType --
romRecup
recuperados
es de tipo CajaConsolidadaBingosType
CajaConsolidadaBingosType
Longitud
Campo / Grupo Descripción Oblig. Tipo
(máx)
Efectivo en el momento de
efectivoApertura S ImporteNoNegativoSimpleType --
apertura
Efectivo en el momento de
efectivoCierre S ImporteNoNegativoSimpleType --
cierre
totalVentas Total de ventas S ImporteNoNegativoSimpleType --
totalPagos Total de pagos S ImporteNoNegativoSimpleType --
Diferencia de caja (puede
diferenciaCaja S ImporteSimpleType --
ser positiva o negativa)
2.4.2.2 Mensaje de Respuesta
Esquema
ResultadoSimpleType
short
string
string
23string
Donde:
es del tipo
InformarResumenDiaOtrosReturnType
Longitud
Campo Descripción Oblig. Tipo
(máx)
Indica si la información
resultado provista fue aceptada o S ResultadoSimpleType 1
presenta errores
Si la información enviada
no supera las
ArrayCodigosDescrip
arrayErrores validaciones de negocio, N --
cionesType
en este array se detallan
los errores detectados
Si el request presenta
errores de formato (tags
inválidos, sin cerrar,
datos que no ArrayCodigosDescrip
arrayErroresFormato N --
corresponden al tipo de cionesStringType
dato del elemento, etc),
en este array se detallan
dichos errores
2.4.2.3 Validaciones del Negocio
…
Validaciones Excluyentes
Código de NO es
Campo / Grupo Validación
Error superada
El punto de explotación deberá
cuitRepresentada,
2000 estar dado de alta en el sistema Rechaza
nroPuntoExplotacion
JAzA para la CUIT representada
La fecha de presentación no
fechaPresentacion 2001 puede ser superior a la fecha Rechaza
actual
24Código de NO es
Campo / Grupo Validación
Error superada
Si se trata de la primer
presentación para esa fecha de
presentación, CUIT y nro. de
cuitRepresentada, punto de explotación, el número
nroPuntoExplotacion, de presentación debe ser 1. Si es
2002 Rechaza
fechaPresentacion, una presentación correctiva,
nroPresentacion debe ser igual a 1 + el último
número de presentación
informado para esa
fecha/CUIT/punto de explotación
La fecha de presentación no
cuitRepresentada, puede ser posterior a la última
nroPuntoExplotacion, 2003 fecha informada + 1 (no se Rechaza
fechaPresentacion puede dejar un día sin informar
entre dos presentaciones)
cuitRepresentada, La fecha de presentación no
nroPuntoExplotacion, 2004 puede ser anterior a la fecha de Rechaza
fechaPresentacion la última presentación autorizada
…
Validaciones Excluyentes
Código NO es
Campo / Grupo Validación
de Error superada
La cantidad de cartones vendidos
cantidadCartonesVendidos 2101 Rechaza
no debe superar los seis dígitos
La cantidad de cartones de la
cantidadCartonesSerie 2102 serie no debe superar los seis Rechaza
dígitos
El número del primer cartón
nroPrimerCartonVendido 2103 vendido no debe superar los seis Rechaza
dígitos
El número del último cartón
nroUltimoCartonVendido 2104 vendido no debe superar los seis Rechaza
dígitos
La cantidad de cartones vendidos
cantidadCartonesVendidos,
2105 no puede ser mayor a la cantidad Rechaza
cantidadCartonesSerie
de cartones de la serie
La cantidad de cartones de la
cantidadCartonesSerie, serie no puede ser menor a la
nroPrimerCartonVendido, 2106 cantidad de cartones existente Rechaza
nroUltimoCartonVendido entre el primer número de cartón
vendido y el último
La cantidad de cartones vendidos
cantidadCartonesVendidos, no puede ser mayor a la cantidad
nroPrimerCartonVendido, 2107 de cartones existente entre el Rechaza
nroUltimoCartonVendido primer número de cartón
vendido y el último
25Código NO es
Campo / Grupo Validación
de Error superada
Si la cantidad de cartones
cantidadCartonesVendidos, vendidos es 0 (cero), el total de
2108 Rechaza
totalPremiosPagados premios pagados debe ser 0
(cero)
Si la cantidad de cartones
cantidadCartonesVendidos, vendidos es mayor a 0 (cero), el
2109 Rechaza
totalPremiosPagados total de premios pagados debe
ser mayor a 0 (cero)
La fecha-hora informada no
fechaHoraInicio 2110 Rechaza
puede ser superior a la actual
El número de partida debe ser
único para el punto de
explotación informado. Si existe
más de una serie para una
nroPartida, nroSerie 2111 Rechaza
misma partida, el número de
partida podrá estar duplicado,
pero en cada caso con un
número de serie diferente
La cantidad de cartones vendidos
nroSerie 2112 no debe superar los cuatro Rechaza
dígitos
…
Validaciones Excluyentes
Código NO es
Campo / Grupo Validación
de Error superada
Efectivo de apertura + total de
efectivoApertura,
ventas + diferencia de caja -
efectivoCierte, totalVentas, 2201 Rechaza
total de pagos debería ser igual
totalPagos, diferenciaCaja
al efectivo de cierre
…
Validaciones Excluyentes
Código NO es
Campo / Grupo Validación
de Error superada
El tipo de mesa debe ser uno de
los siguientes valores:
1 – Ruleta
tipoMesa 2301 2 – Naipes Rechaza
3 – Dados
4 – Torneo
99 – Otros
26Código NO es
Campo / Grupo Validación
de Error superada
La cantidad de mesas debe ser
cantidadMesas 2302 Rechaza
mayor o igual a 0 (cero)
La cantidad de mesas debe ser
cantidadMesas 2303 Rechaza
menor o igual a 9999 (cero)
No se debe informar un mismo
tipo de mesa más de una vez en
tipoMesa 2304 Rechaza
una presentación dada (se
totaliza por tipo de mesa)
2.4.2.4 Ejemplos
Ejemplo 1: se envía información del punto de explotación 1 correspondiente a la
fecha 22/03/2014. La misma supera todas las validaciones y es aceptada.
Request:
?
?
30000000007
1
2014-03-22
2
3
2014-03-22T12:00:00
5
100
10
88
98
1300
4
2014-03-22T12:00:00
5
100
10
88
98
1300
2
10
271000
8000
2000
9000
3000
4000
0
7000
5000
6000
100
200
300
3
10
1000
8000
2000
9000
3000
4000
0
7000
5000
6000
100
200
300
1
10
1000
8000
2000
9000
3000
4000
0
7000
5000
6000
100
200
300
0
50
195
150
5
Response:
28A
Ejemplo 2: se envía información del punto de explotación 1 correspondiente a la
fecha 23/03/2014. La misma no supera todas las validaciones y es rechazada.
Request:
?
?
30000000007
1
2014-03-23
1
3
2014-03-11T12:00:00
5
100
10
88
98
1300
3
2014-03-11T12:00:00
5
100
10
88
98
1300
1
10
1000
8000
2000
9000
3000
4000
0
297000
5000
6000
100
200
300
3
10
1000
8000
2000
9000
3000
4000
0
7000
5000
6000
100
200
300
1
30
1000
8000
2000
9000
3000
4000
0
7000
5000
6000
100
200
300
50
200
150
200
5
Response:
R
302111
Partida de Bingo 3: El número de partida
informado (3) está duplicado
2201
Caja Consolidada Bingo: Efectivo de apertura +
total de ventas + diferencia de caja - total de pagos debería ser igual al
efectivo de cierre. Se informó: 200.00 - Se esperaba: 5.00
2304
Caja Consolidada Mesa Viva tipo 1: El tipo de
mesa informado (1) está duplicado
312.4.3 Consultar Máquina Electrónica Informada (consultarMEInformada)
Mediante este método se podrá consultar la información enviada de una máquina para una
fecha de presentación en particular: estado inicial y final de sus contadores, reseteos, etc.
2.4.3.1 Mensaje de Solicitud
Esquema
string
string
CuitSimpleType
short
date
IdMaquinaElectronicaSimpleType
Donde:
es del tipo ConsultarMEInformadaRequestType.
Permite indentificar el punto de explotación, fecha y máquina a consultar.
Longitud
Campo / Grupo Descripción Oblig. Tipo
(máx)
Información de
authRequest autenticación del emisor S AuthRequestType --
del request
Número identificador del
nroPuntoExplotacion Punto de Explotación que S short 5
se está informando
fechaPresentacion Fecha de la presentación S date --
Identificador Electrónico
idMaquina S short 4
de la máquina
2.4.3.2 Mensaje de Respuesta
32Esquema
IdMaquinaElectronicaSimpleType
short
dateTime
dateTime
ImporteNoNegativoSimpleType
ContadorSimpleType
ContadorSimpleType
ContadorSimpleType
ContadorSimpleType
ContadorSimpleType
ContadorSimpleType
ContadorSimpleType
ContadorSimpleType
short
string
string
string
33Donde:
es del tipo ConsultarMEInformadaReturnType
Longitud
Campo Descripción Oblig. Tipo
(máx)
arrayDetalleMaquinasEle Lista de detalles de ArrayDetalleMaquina
N --
ctronicas máquinas electronicas sElectronicasType
Si la información enviada
no supera las
ArrayCodigosDescrip
arrayErrores validaciones de negocio, N --
cionesType
en este array se detallan
los errores detectados
Si el request presenta
errores de formato (tags
inválidos, sin cerrar,
datos que no ArrayCodigosDescrip
arrayErroresFormato N --
corresponden al tipo de cionesStringType
dato del elemento, etc),
en este array se detallan
dichos errores
es un array de elementos ,
que son de tipo DetalleMaquinaElectronicaType
DetalleMaquinaElectronicaType
Longitud
Campo / Grupo Descripción Oblig. Tipo (máx)
Identificador de la máquina IdMaquinaElectronicaSimple
idMaquina S --
electrónica Type
Número de secuencia. Para
un día y una máquina
secuencia S short 4
dada, deberá comenzar en
1
fechaHoraSecuencia Fecha y hora de inicio de la
S dateTime --
Inicio secuencia informada
fechaHoraSecuencia Fecha y hora de fin de la
S dateTime --
Fin secuencia informada
Denominación de ImporteNoNegativoSimpleTy
denomContabilidad S --
Contabilidad pe
Grupo con los valores
contadoresInicial S GrupoContadoresMEType --
iniciales de los contadores
Grupo con los valores
contadoresFinal S GrupoContadoresMEType --
finales de los contadores
2.4.3.3 Validaciones del Negocio
…
Validaciones Excluyentes
34Código de NO es
Campo / Grupo Validación
Error superada
La fecha de presentación no
fechaPresentacion 3001 puede ser superior a la fecha Rechaza
actual
El punto de explotación deberá
cuitRepresentada,
3002 estar dado de alta en el sistema Rechaza
nroPuntoExplotacion
JAzA para la CUIT representada
cuitRepresentada, Deberá existir al menos una
nroPuntoExplotacion, presentación para la máquina,
3003 Rechaza
fechaPresentacion, punto de explotación y fechas
idMaquina buscadas
352.4.4 Consultar Ids de Máquinas Electrónicas Informadas
(consultarIdsMEInformadas)
Mediante este método se podrá consultar el listado de Ids de máquinas electrónicas
informadas para una fecha de presentación en particular.
2.4.4.1 Mensaje de Solicitud
Esquema
string
string
CuitSimpleType
short
date
Donde:
es del tipo
ConsultarIdsMEInformadasRequestType. Permite identificar el punto de explotación y
fecha a consultar
Longitud
Campo / Grupo Descripción Oblig. Tipo
(máx)
Información de
authRequest autenticación del emisor S AuthRequestType --
del request
Número identificador del
nroPuntoExplotacion Punto de Explotación que S short 5
se está consultando
fechaPresentacion Fecha de la presentación S date --
2.4.4.2 Mensaje de Respuesta
Esquema
36short
date
IdMaquinaElectronicaSimpleType
short
string
string
string
Donde:
es del tipo
ConsultarIdsMEInformadasReturnType
Longitud
Campo Descripción Oblig. Tipo
(máx)
Número del Punto de
nroPuntoExplotacion N short 5
Explotación
fechaPresentacion Fecha de la Presentación N date --
Lista de Ids de máquinas
electrónicas informadas
para el punto de
arrayIdsMaquinasElectro ArrayIdsMaquinasEle
explotación N --
nicas ctronicasType
correspondientes a la
fecha de presentación
indicada
Si la información enviada
no supera las
ArrayCodigosDescrip
arrayErrores validaciones de negocio, N --
cionesType
en este array se detallan
los errores detectados
37Si el request presenta
errores de formato (tags
inválidos, sin cerrar,
datos que no ArrayCodigosDescrip
arrayErroresFormato N --
corresponden al tipo de cionesStringType
dato del elemento, etc),
en este array se detallan
dichos errores
es del tipo ArrayIdsMaquinasElectronicasType. Es un array
de elementos idMaquina que son del tipo IdMaquinaElectronicaSimpleType
ArrayIdsMaquinasElectronicasType
Longitud
Campo / Grupo Descripción Oblig. Tipo (máx)
Identificador de la máquina IdMaquinaElectronicaSimple
idMaquina S --
electrónica Type
2.4.4.3 Validaciones del Negocio
…
Validaciones Excluyentes
Código de NO es
Campo / Grupo Validación
Error superada
El punto de explotación deberá
nroPuntoExplotacion 5001 estar dado de alta en el sistema Rechaza
JAzA para la CUIT representada
Debe ser menor o igual a la
fechaPresentacion 5002 Rechaza
fecha actual
382.4.5 Consultar Ids de Máquinas Electrónicas Pendientes
(consultarIdsMEPendientes)
Mediante este método se podrá consultar el listado de Ids de máquinas electrónicas
pendientes de ser informadas, indicando para cada Id. a partir de qué fecha no figuran
datos informados.
2.4.5.1 Mensaje de Solicitud
Esquema
string
string
CuitSimpleType
short
Donde:
es del tipo
ConsultarIdsMEPendientesRequestType. Permite identificar el punto de explotación
que se desea consultar
Longitud
Campo / Grupo Descripción Oblig. Tipo (máx)
Información de
authRequest autenticación del emisor S AuthRequestType --
del request
Número identificador del
nroPuntoExplotacion Punto de Explotación que S short 5
se está consultando
2.4.5.2 Mensaje de Respuesta
Esquema
39short
IdMaquinaElectronicaSimpleType
date
short
string
string
string
Donde:
es del tipo
ConsultarIdsMEPendientesReturnType
Longitud
Campo Descripción Oblig. Tipo
(máx)
Número del Punto de
nroPuntoExplotacion N short 5
Explotación
fechaPresentacion Fecha de la Presentación N date --
Lista de Ids de máquinas
electrónicas informadas
para el punto de
arrayIdsMaquinasElectro ArrayIdsMaquinasEle
explotación N --
nicas ctronicasType
correspondientes a la
fecha de presentación
indicada
Si la información enviada
no supera las
ArrayCodigosDescrip
arrayErrores validaciones de negocio, N --
cionesType
en este array se detallan
los errores detectados
40Si el request presenta
errores de formato (tags
inválidos, sin cerrar,
datos que no ArrayCodigosDescrip
arrayErroresFormato N --
corresponden al tipo de cionesStringType
dato del elemento, etc),
en este array se detallan
dichos errores
es un array de elementos idFechaMaquina que son del
tipo IdMaquinaElectronicaSimpleType
IdFechaMaquinaType
Longitud
Campo / Grupo Descripción Oblig. Tipo (máx)
Identificador de la máquina IdMaquinaElectronicaSimple
idMaquina S --
electrónica Type
Fecha de la primer
fecha presentación aún pendiente S date --
de ser informada
2.4.5.3 Validaciones del Negocio
…
Validaciones Excluyentes
Código de NO es
Campo / Grupo Validación
Error superada
El punto de explotación deberá
nroPuntoExplotacion 6001 estar dado de alta en el sistema Rechaza
JAzA para la CUIT representada
412.4.6 Consultar Resumen Diario - Otros (consultarResumenDiaOtros)
Mediante este método se podrá consultar la información enviada sobre partidas de bingo y
cajas consolidadas de bingo y mesas vivas para una fecha de presentación en particular.
2.4.6.1 Mensaje de Solicitud
Esquema
string
string
CuitSimpleType
short
date
Donde:
es del tipo
ConsultarResumenDiaOtrosRequestType. Permite indentificar el punto de explotación y
fecha a consultar.
Longitud
Campo / Grupo Descripción Oblig. Tipo
(máx)
Información de
authRequest autenticación del emisor S AuthRequestType --
del request
Número identificador del
nroPuntoExplotacion Punto de Explotación que S short 5
se está informando
fechaPresentacion Fecha de la presentación S date --
2.4.6.2 Mensaje de Respuesta
Esquema
42EnteroPositivoSimpleType
dateTime
ImporteNoNegativoSimpleType
EnteroPositivoSimpleType
EnteroNoNegativoSimpleType
EnteroNoNegativoSimpleType
EnteroNoNegativoSimpleType
ImporteNoNegativoSimpleType
1
1
ImporteNoNegativoSimpleType
ImporteNoNegativoSimpleType
ImporteNoNegativoSimpleType
ImporteNoNegativoSimpleType
ImporteNoNegativoSimpleType
ImporteNoNegativoSimpleType
ImporteNoNegativoSimpleType
ImporteNoNegativoSimpleType
ImporteNoNegativoSimpleType
ImporteNoNegativoSimpleType
ImporteSimpleType
ImporteNoNegativoSimpleType
43ImporteNoNegativoSimpleType
ImporteNoNegativoSimpleType
ImporteNoNegativoSimpleType
ImporteNoNegativoSimpleType
ImporteNoNegativoSimpleType
ImporteSimpleType
short
string
string
string
Donde:
es del tipo
ConsultarResumenDiaOtrosReturnType
Longitud
Campo Descripción Oblig. Tipo
(máx)
arrayDetallePartidasBin Lista de detalles de ArrayDetallePartidas
N --
go partidas de bingo BingoType
arrayCajasConsolidadaM Lista de detalles de ArrayCajasConsolida
N --
esasVivas partidas de bingo daMesasVivasType
Caja consolidada de CajaConsolidadaBing
cajaConsolidadaBingos N --
bingo oType
Si la información enviada
no supera las
ArrayCodigosDescrip
arrayErrores validaciones de negocio, N --
cionesType
en este array se detallan
los errores detectados
44Si el request presenta
errores de formato (tags
inválidos, sin cerrar,
datos que no ArrayCodigosDescrip
arrayErroresFormato N --
corresponden al tipo de cionesStringType
dato del elemento, etc),
en este array se detallan
dichos errores
es un array de elementos , que son de tipo
DetallePartidaBingoType
DetallePartidaBingoType
Longitud
Campo / Grupo Descripción Oblig. Tipo
(máx)
nroPartida Número de partida S EnteroPositivoSimpleType 9
Fecha-hora de inicio de la
fechaHoraInicio S dateTime --
partida
valorCarton Valor del cartón S ImporteNoNegativoSimpleType --
nroSerie Número de serie N EnteroPositivoSimpleType 4
cantidadCartonesSer Cantidad de cartones en la
S EnteroNoNegativoSimpleType 6
ie serie
cantidadCartonesVe Cantidad de cartones
S EnteroNoNegativoSimpleType 6
ndidos vendidos
nroPrimerCartonVen Número del primer cartón
S EnteroNoNegativoSimpleType 6
dido vendido
nroUltimoCartonVen Número del último cartón
S EnteroNoNegativoSimpleType 6
dido vendido
totalPremiosPagados Total de premios pagados S ImporteNoNegativoSimpleType --
es un array de elementos
, que son de tipo CajaConsolidadaMesasVivasType
CajaConsolidadaMesasVivasType
Longitud
Campo / Grupo Descripción Oblig. Tipo (máx)
Código identificador del
tipoMesa S short 4
tipo de mesa
Cantidad de mesas del tipo
cantidadMesas S short 4
indicado
Efectivo en el momento de
efectivoApertura S ImporteNoNegativoSimpleType --
apertura
Efectivo en el momento de
efectivoCierre S ImporteNoNegativoSimpleType --
cierre
importeEqFichasApe Importe equivalente fichas
S ImporteNoNegativoSimpleType --
rtura apertura
importeEqFichasCier Importe equivalente fichas
S ImporteNoNegativoSimpleType --
re cierre
totalRetiros Total de retiros S ImporteNoNegativoSimpleType --
totalReposiciones Total de reposiciones S ImporteNoNegativoSimpleType --
Total de retiros equivalente
totalRetirosEqFichas S ImporteNoNegativoSimpleType --
fichas
totalReposicionesEq Total de reposiciones
S ImporteNoNegativoSimpleType --
Fichas equivalente fichas
totalVentas Total de ventas S ImporteNoNegativoSimpleType --
45Longitud
Campo / Grupo Descripción Oblig. Tipo
(máx)
totalPagos Total de pagos S ImporteNoNegativoSimpleType --
Diferencia de caja (puede
diferenciaCaja S ImporteSimpleType --
ser positiva o negativa)
Total equivalente ticketes
totalEqTicketsFondP
fondos promocionales S ImporteNoNegativoSimpleType --
romOtorg
otorgados
Total equivalente ticketes
totalEqTicketsFondP
fondos promocionales S ImporteNoNegativoSimpleType --
romRecup
recuperados
es de tipo CajaConsolidadaBingosType
CajaConsolidadaBingosType
Longitud
Campo / Grupo Descripción Oblig. Tipo (máx)
Efectivo en el momento de
efectivoApertura S ImporteNoNegativoSimpleType --
apertura
Efectivo en el momento de
efectivoCierre S ImporteNoNegativoSimpleType --
cierre
totalVentas Total de ventas S ImporteNoNegativoSimpleType --
totalPagos Total de pagos S ImporteNoNegativoSimpleType --
Diferencia de caja (puede
diferenciaCaja S ImporteSimpleType --
ser positiva o negativa)
2.4.6.3 Validaciones del Negocio
…
Validaciones Excluyentes
Código de NO es
Campo / Grupo Validación
Error superada
La fecha de presentación no
fechaPresentacion 4001 puede ser superior a la fecha Rechaza
actual
El punto de explotación deberá
cuitRepresentada,
4002 estar dado de alta en el sistema Rechaza
nroPuntoExplotacion
JAzA para la CUIT representada
cuitRepresentada, Deberá existir al menos una
nroPuntoExplotacion, 4003 presentación para el punto de Rechaza
fechaPresentacion explotación en la fecha buscada
462.4.7 Dummy
Permite verificar el funcionamiento del presente WS.
2.4.7.1 Mensaje de Solicitud
Esquema
2.4.7.2 Mensaje de Respuesta
Retorna el resultado de la verificación de los elementos principales de infraestructura del
servicio.
Esquema
string
string
string
Donde:
detalla el resultado de la validación, contiene los siguientes campos:
Campo/Grupo Detalle Obligatorio Tipo
appserver Servidor de aplicaciones S string
authserver Servidor de autenticación S string
dbserver Servidor de base de datos S string
2.4.7.3 Ejemplo para “Dummy”
47OK
OK
OK
483 Definición de tipos de datos
3.1 Simple Types
Tipo de dato
Type Restricción
primitivo
Total máximo de dígitos: 9
EnteroNoNegativoSimpleType int
Valor mínimo permitido: 0
Total máximo de dígitos: 9
EnteroPositivoSimpleType int
Valor mínimo permitido: 1
Total máximo de dígitos: 12
Valor mínimo permitido: 0
ContadorSimpleType long
Valor máximo permitido:
999999999999
Valor entero con un total de
CuitSimpleType long
dígitos igual a: 11
IdMaquinaElectronicaSimpleType string Longitud: 1 a 50 caracteres
Total máximo de dígitos: 12 (10
enteros y 2 decimales).
Valor mínimo permitido:
ImporteSimpleType decimal
-9999999999.99
Valor máximo permitido:
9999999999.99
Total máximo de dígitos: 12 (10
enteros y 2 decimales).
ImporteNoNegativoSimpleType decimal Valor mínimo permitido: 0
Valor máximo permitido:
9999999999.99
Conjunto de valores permitidos:
{ 'A', 'R'}
ResultadoSimpleType string
A: Aceptado
R: Rechazado
Conjunto de valores permitidos:
{ 'S, 'N'}
SiNoSimpleType string
S: Sí
N: No3.2 Complex Types (genéricos)
AuthRequestType contiene la información referente a la autenticación
Campo / Grupo Descripción Obligatorio Tipo Longitud
token Token devuelto por el WSAA S string --
Signature devuelta por el
sign S string --
WSAA
CUIT de la Entidad
cuitRepresentada S CuitSimpleType 11
Representada
ArrayCodigosDescripcionesType es un Array de del tipo
CodigoDescripcionType
CodigoDescripcionType
Longitud
Campo Descripción Obligatorio Tipo
(máx)
codigo codigo S short 5
descripción descripción S string 2000
ArrayCodigosDescripcionesStringType es un Array de que
es del tipo CodigoDescripcionStringType
CodigoDescripcionStringType
Longitud
Campo Descripción Obligatorio Tipo
(máx)
codigo Codigo S string 100
descripción Descripción S string 2000
50GrupoContadoresMEType
Longitud
Campo Descripción Obligatorio Tipo
(máx)
juegosJugados Cantidad de juegos S ContadorSimpleType 12
coinIn Contador de coin-in S ContadorSimpleType 12
coinOut Contador de coin-out S ContadorSimpleType 12
jackpot Contador de jackpot S ContadorSimpleType 12
513.3 Aclaraciones y Definiciones
(1) No se especifica la longitud del atributo token y del atributo sign porque es variable
y depende de la respuesta del WSAA
(2) Formato para el tipo de dato date es: AAAA-MM-DD, sin uso horario
(3) Formato para el tipo de dato dateTime es:
AAAA-MM-DDThh:mm:ss[Z|(+|-)hh:mm]
Aclaración: entre corchetes “[]” indica que es opcional.
(4) El separador de decimales es el punto “.”
(5) Cuando un elemento es opcional y no se desea enviar ningún valor para este, no
deberá enviarse el tag. Por ejemplo si no corresponde enviar un valor para
fechaPresentacion en un request en el cual dicho elemento sea opcional, no hay que
enviar el tag, es decir no debe enviarse:
(6) Para las columnas con título Oblig. u Obligatorio, el valor de la celda N significa que
el atributo no es obligatorio a nivel estructura y S que el atributo es obligatorio
(7) Los campos y métodos deprecados son aquellos que temporariamente siguen siendo
funcionales, pero serán eliminados en próximas actualizaciones
3.4 Abreviaturas
(1) JAzA: Juegos de Azar y Apuestas
(2) WS: Web Services
(3) WSDL: Web Services Description Language
(4) WSAA: WebService de Autenticación y Autorización
52También puede leer
