Actualizacion Pos
by integracionesvendemas

Actualizacion Pos

Operaciones
Validar Terminal
POST /v1/validarTerminal
Registrar historial
POST /v1/registrarHistorial
Registrar Actualizacion
POST /v1/registrarActualizacion
Validar Terminal
POST /v1/validarTerminal

Request body

Object
ipOrigen
string

Origen de la peticion

Example:
200.43.526.13
serial
string
Example:
MPOS434523552
firmware
string
Example:
304.546.234.51
modelo
string
Example:
Cute
porcentajeBateria
number
Example:
85.6
nroDocumento
string
Example:
45147339
Examples
{
    "ipOrigen": "200.43.526.13",
    "serial": "MPOS434523552",
    "firmware": "304.546.234.51",
    "modelo": "Cute",
    "porcentajeBateria": 85.6,
    "nroDocumento": "45147339"
}

Responses

200 OK
Body
Object
responseCode
string
Enumeration:
00

El terminal se encuentra en la lista

96

El terminal no se encuentra en la lista

98

El terminal no pertenece al documento indicado

99

El terminal no está vinculado a un comercio

mensajeRespuesta
string
Example:
El terminal se encuentra en la lista
codigoComercio
string

Codigo de comercio asociado, solo debe devolver si es que el responseCode es 00

Example:
898954544
Examples

Ejemplo correcto

{
    "responseCode": "00",
    "mensajeRespuesta": "El terminal se encuentra en la lista",
    "codigoComercio": "898954544"
}

Ejemplo errado

{
    "responseCode": "99",
    "mensajeRespuesta": "El terminal no está vinculado a un comercio",
    "codigoComercio": ""
}
Registrar historial
POST /v1/registrarHistorial

Request body

Object
ipOrigen
string
Example:
272.124.11.45
serial
string
Example:
MPOS434523552
firmware
string
Example:
304.546.234.51
modelo
string
Example:
Cute
porcentajeBateria
number
Example:
85.4
nroDocumento
string
Example:
45147339
codigoComercio
string

Devuelto por el api anterior

Example:
898954544
estadoActualizacion
string
Enumeration:
1

PENDIENTE

2

EN PROCESO

3

COMPLETADO

4

ERROR

mensajeDetalle
string
Examples:
Ocurrió un errorIncompatiblidad de hardware
Examples
{
    "ipOrigen": "272.124.11.45",
    "serial": "MPOS434523552",
    "firmware": "304.546.234.51",
    "modelo": "Cute",
    "porcentajeBateria": 85.4,
    "nroDocumento": "898954544",
    "codigoComercio": "",
    "estadoActualizacion": "2",
    "mensajeDetalle": "Ocurrió un error"
}

Responses

200 OK
Body
Object
responseCode
string
Enumeration:
00

El registro se realizó correctamente

96

No se pudo registrar el historial (error en bd o algo)

98

El documento y el codigo de comercio no coinciden

99

El codigo de comercio está vacio

100

El dni está vacio

mensajeRespuesta
string
Example:
El registro se realizó correctamente
Examples
{
    "responseCode": "00",
    "mensajeRespuesta": "El registro se realizó correctamente"
}
Registrar Actualizacion
POST /v1/registrarActualizacion

Request body

Object
hwSerial
string
Example:
29001300120090425006
serial
string
Example:
MPOS0090425006
firmware
string
Example:
204.12.45.12
modelo
string
Example:
Cute
porcentajeBateria
number
Example:
85.6
estadoActualizacion
string
Enumeration:
2

EN PROCESO

3

COMPLETADO

4

ERROR

porcentajeActualizacion
string
Example:
98.5
codigoError
string
Examples:
Ocurrió un errorIncompatiblidad de hardware
Examples
{
    "hwSerial": "29001300120090425006",
    "serial": "MPOS0090425006",
    "firmware": "204.12.45.12",
    "modelo": "Cute",
    "porcentajeBateria": 85.6,
    "estadoActualizacion": "3",
    "porcentajeActualizacion": "98.5",
    "codigoError": "Ocurrió un error"
}

Responses

201 OK
Body
Object
responseCode
string
Enumeration:
00

La operación se realizó correctamente

10

Error interno

11

Request invalido

91

El terminal no se encuentra en la lista

96

El terminal no es Cute

97

El terminal no necesita actualizacion

responseMessage
string
Example:
EXITO
message
string
Example:
El registro se realizó correctamente
Examples
{
    "responseCode": "97",
    "responseMessage": "EXITO",
    "message": "El registro se realizó correctamente"
}