Payment Cloud API
by integracionesvendemas

Payment Cloud API

Api de enrutamiento de ventas
Solución

Payment Cloud es un API REST que disponibiliza operaciones de administración de usuarios y asignación de ventas de sistemas terceros a medios de pago Vendemás. Para todas las operaciones del catálogo es necesario autenticarse en el servidor Oauth2 para generación de token, mismo que debe viajar por header en cada petición del API.

Consideraciones:

  • El usuario solo podrá registrar una pre venta por vez, cada que quiera registrar una nueva pre venta deberá haber ejecutado el pago de la existente o limpiar las preventas.
  • El usuario no podrá registrar pre ventas o pre anulaciones mientras se tenga un cierre en curso.
  • La anulación requiere que la plataforma del partner haya recibido la notificación de la transacción de origen o que haya consultado el estado, pues debe tener el número de referencia generado por la transacción de pago en Vendemás para poder registrar la pre anulación.
  • En la configuración y matrícula del partner se tendrán terminales asociados a las sucursales. Al registrar un usuario podrá matricular terminales específicos (entre los que están asociados a la sucursal) o dejar vacío el campo de terminales, en cuyo caso heredará la asociación de la sucursal en que el usuario está siendo registrado
  • La operación de Notificación de transacción deberá ser implementada en la plataforma del partner. Cada que una transacción de venta o anulación se ejecuta en plataforma de Vendemás, se notificará al partner vía Web Service.

Flujo básico de una venta:

  • El partner deberá crear una pre-venta utilizando el api de “registrarPreventa”
  • El partner deberá presionar el botón 1 del dispositivo POS. o llamando al API “listarPreventa”. Luego de listado la preventa tiene un vencimiento de 1 minuto.
  • El POS deberá solicitar el código del usuario (atributo usuario) que generó la preventa.
  • El partner deberá ingresar el código del usuario, luego presionar el botón verde.
  • El POS mostrará el importe con la opción de pasar la tarjeta
  • El partner deberá pasar la tarjeta por el POS. También se puede llamar al api “NotificarTransaccion”
  • El POS procesará la venta y notificará la venta al API que el partner disponga.

Códigos de estado:

  • 00 : EXITO
  • 10 : Error Genérico
  • 11 : No existe información
  • 12 : Datos incorrectos
  • 13 : Usuario ya existe
  • 14 : Existe una venta pendiente
  • 15 : Existe una anulación pendiente
  • 16 : Existe un cierre de lote en curso
  • 17 : Sólo se puede transaccionar en estado pendiente
  • 18 : No se puede realizar el cierre. Existen transacciones en curso
  • 19 : La transaccion ya se encuentra procesada
  • 20 : El ID de venta ya fue utilizado
  • 21 : El ID de anulación ya fue utilizado
  • 22 : No se puede actualizar una transacción al estado de creación

URLs base ambiente Sandbox:

Autenticación: https://auth2.vmas.com.pe/vm-api-autorizacion/oauth/

Operaciones: https://paymentcloud.dev.vmas.com.pe:443/paymentcloud/

Las operaciones del catálogo:

PARA CONSUMO DEL PARTNER:

  • Registrar Usuario. Permitirá registrar los operarios dentro de la plataforma.
  • Registrar PreVenta. Permitirá registrar la pre-venta al partner.
  • Limpiar Preventas. Permitirá limpiar preventas previamente creadas.
  • Consultar Transacción. Permite consultar las transacciones generadas.
  • Listar Transacciones. Permite listar las transacciones del partner

PARA IMPLEMENTACIÓN DEL PARTNER (CONSUMO DE VENDEMÁS):

  • Notifica Transacción. Para poder notificar es necesario que el partner exponga un API para reportar la venta.

PARA USO INTERNO (VENDEMÁS):

  • Listar Pre ventas

CHANGELOG (03-11-2022) -Notifica Transacción: Se realizó un ajuste en las url de consumo y términos de uso.

(31-01-2019) -Notifica Transacción: Se agregaron los diferentes codigos de tarjeta en marca tarjeta.

(21-01-2019) -Registrar Usuario: Se cambió la descripción de los campos usuario y idUsuarioExterno.

(20-01-2019) -Registrar Preventa: Se quitó el campo numero de autorizacion.

(17-12-2019)

  • Consultar Transacción: Se agregaron los output tipoTarjeta y marcaTarjeta. Se corrigieron errores menores en nombres de parámetros request (upper y lower case).
  • Listar Transacciones: Se agregaron los output tipoTarjeta y marcaTarjeta.
  • Generar Token: Se agregó documentación del API para generar el token de autenticación.
  • Notifica Transacción: Se agregarón los inputs tipoTarjeta y marcaTarjeta.

(16-12-2019)

  • Registrar pre anulación: Se agregaron los parametros terminal, idTransaccion y lote en el request.
  • Notifica Transacción: Se modificó el campo idVentaExterna por idTransaccionExterna. Se modificó el tipo de dato del campo estado de STRING a ENUM. Se modificó el tipo de dato del campo idVenta de STRING a ENTERO. Se agregaron los parametros terminal y lote al request.
  • Listar pre Ventas: Se agrego el parametro cuotas en el array data en el response.
  • Listar pre Anulaciones: Se agregaron los parametros idTerminal, idTransaccion y lote en el array data del response

(20-12-2019)

  • Feature propinas: Se agregaron los parametros monto y propinas en el request notificar transacción con el objetivo de integrar la funcionalidad de propinas en Payment Cloud
Generar Token
POST /vm-api-autorizacion/oauth/token

API REST para generar token de autenticación utilizando el host de sandbox o producción.

Request headers

Content-Type
string required
Example:
application/x-www-form-urlencoded
Authorization
string required

Autenticación básica en base 64 con los parámetros Username y Password (username=usr_001&password=pass_002)

Example:
Basic dXNyX3dzX21hcmF0aG9uOjEyMzQ1Ng==

Request body

Object
usuario
string required

Usuario de Login

Example:
app_user_001
clave
string required

Password de Login

Example:
pass0rd01*

Examples

POST /vm-api-autorizacion/oauth/token HTTP/1.1 

Content-Type: application/x-www-form-urlencoded
Authorization: Basic dXNyX3dzX21hcmF0aG9uOjEyMzQ1Ng==

{
    "usuario": "app_user_001",
    "clave": "pass0rd01*"
}
Registrar usuario
POST /registrarUsuario

Operación para registrar usuarios con permiso de registro de Ventas y para cobro en terminales Vendemás.

Request headers

Content-Type
string required
Default:
application/json
Authorization
string required

Token de autenticación generado en API Autorización

Example:
Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

Request body

Object
usuario
string required

Identificación del usuario en la sucursal. Puede ser codigo personalizado, dni, pasaporte, etc.

Example:
usuario1, 48126159.
nombres
string

Nombres de usuario

Example:
nombres
apellidos
string

Apellidos de Usuario

Example:
apellidos
documento
string required

Número de documento (DNI, Carnet de Extranjería, Pasaporte)

Example:
012345678
idUsuarioExterno
string required

Identificador del usuario en sistema del Partner, Este identificador será utilizado en el pocket para realizar el pago, anulación y/o cierre. debe ser numérico textual. El límite es de 6 dígitos.

Example:
565
sucursal
string required

Identificador de la sucursal

Example:
SUCURSAL1
franquicia
string required

Identificador de la franquicia

Example:
FRANQUICIA1
terminales
string

VACÍO: hereda todos los terminales asociados a la sucursal. / Datos separados por comas

Example:
654987451236,658749658742

Responses

200 OK
Body
Object
estado
string

Estado de la operación (“00” : EXITO, [OTRO] : ERROR)

Example:
00
descripcionEstado
string

Descripción del estado de la operación

Example:
Usuario Creado
fechaOperacion
string

Fecha de operación ejecutada

Example:
2019-10-31 10:00:00
data
Object

Objeto de datos específicos de la operación

idusuarioExterno
string

Id de usuario en sistema del partner

Example:
ABC123
usuario
string

Usuario en API

Example:
usuario1
idUsuario
integer

Id generado en API

Example:
1
sucursal
string

Identificador de la sucursal

Example:
SUCURSAL1
franquicia
string

Identificador de la franquicia

Example:
FRANQUICIA1
401 Unauthorized
500 Internal Server Error

Examples

POST /registrarUsuario HTTP/1.1 

Content-Type: application/json
Authorization: Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

{
    "usuario": "usuario1",
    "nombres": "nombres",
    "apellidos": "apellidos",
    "documento": "012345678",
    "idUsuarioExterno": "ABC123",
    "sucursal": "SUCURSAL1",
    "franquicia": "FRANQUICIA1"
}

HTTP/1.1 200 OK 

Content-Type: application/json

{
    "estado": "00",
    "descripcionEstado": "Usuario Creado",
    "fechaOperacion": "2019-10-31 10:00:00",
    "data": {
        "idusuarioExterno": "ABC123",
        "usuario": "usuario1",
        "idUsuario": 1,
        "sucursal": "SUCURSAL1",
        "franquicia": "FRANQUICIA1"
    }
}
show more
POST /registrarUsuario HTTP/1.1 

Content-Type: application/json
Authorization: Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

{
    "usuario": "usuario1",
    "nombres": "nombres",
    "apellidos": "apellidos",
    "documento": "012345678",
    "idUsuarioExterno": "ABC123",
    "sucursal": "SUCURSAL1",
    "franquicia": "FRANQUICIA1"
}

HTTP/1.1 401 Unauthorized
show more
POST /registrarUsuario HTTP/1.1 

Content-Type: application/json
Authorization: Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

{
    "usuario": "usuario1",
    "nombres": "nombres",
    "apellidos": "apellidos",
    "documento": "012345678",
    "idUsuarioExterno": "ABC123",
    "sucursal": "SUCURSAL1",
    "franquicia": "FRANQUICIA1"
}

HTTP/1.1 500 Internal Server Error
show more
Registrar pre Venta
POST /registraPreventa

Operación para pre registro de Venta y derivación a sistema de pagos desde Dispositivos Vendemás

Request headers

Content-Type
string required
Default:
application/json
Authorization
string required
Example:
Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

Request body

Object
usuario
string required

Usuario al que se asociará la preventa, debe haber sido registrado en el API

Example:
99
idVentaExterno
string required

Identificador de la venta en sistema de Partner (único)

Example:
00099
total
number required

Monto total de la venta a cobrar

Example:
100.5
moneda
string required

Moneda de la transacción

Default:
PEN
cuotas
string

Cantidad de cuotas para pago (referencial, no se valida)

Example:
3
detalle
Array

Detalles de la venta (opcional)

Object
descripcion
string

Descripción del item

Example:
Producto 1
precioUnidad
integer

Precio unitario del item

Example:
100
cantidad
integer

Cantidad de item

Example:
1
precioTotal
integer

Precio total del item

Example:
100
codigoItem
string

Código del item en sistema del Partner

Example:
PRODUCTO123

Responses

200 OK
Body
Object
estado
string

Estado de la operación (“00” : EXITO, [OTRO] : ERROR)

Example:
00
descripcionEstado
string

Descripción del estado de la operación

Example:
Venta registrada
fechaOperacion
string

Fecha de operación ejecutada

Example:
2019-10-31 10:00:00
data
Object
idVentaExterno
string

Id de la venta en sistema del Partner

Example:
VENTA123
total
integer

Monto total de la venta pre registrada

Example:
100
idVenta
integer

Id generado de la venta en API

Example:
1
estadoVenta
string

Estado del cobro de la venta en API

Example:
PENDIENTE
numAutorizacion
string

Número de Autorización manejada por el Partner (único)

Example:
273937292
401 Unauthorized
500 Internal Server Error

Examples

POST /registraPreventa HTTP/1.1 

Content-Type: application/json
Authorization: Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

{
    "usuario": "USUARIO1",
    "idVentaExterno": "VENTA123",
    "total": 100.5,
    "moneda": "PEN",
    "detalle": [
        {
            "descripcion": "Producto 1",
            "precioUnidad": 100,
            "cantidad": 1,
            "precioTotal": 100,
            "codigoItem": "PRODUCTO123",
            "cuotas": "3"
        }
    ]
}

HTTP/1.1 200 OK 

Content-Type: application/json

{
    "estado": "00",
    "descripcionEstado": "Venta registrada",
    "fechaOperacion": "2019-10-31 10:00:00",
    "data": {
        "idVentaExterno": "VENTA123",
        "total": 100,
        "idVenta": "d7dc8555-8c18-4d28-bdc2-50acf70f86ef",
        "estadoVenta": "PENDIENTE"
    }
}
show more
POST /registraPreventa HTTP/1.1 

Content-Type: application/json
Authorization: Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

{
    "usuario": "USUARIO1",
    "idVentaExterno": "VENTA123",
    "total": 100.5,
    "moneda": "PEN",
    "detalle": [
        {
            "descripcion": "Producto 1",
            "precioUnidad": 100,
            "cantidad": 1,
            "precioTotal": 100,
            "codigoItem": "PRODUCTO123",
            "cuotas": "3"
        }
    ]
}

HTTP/1.1 401 Unauthorized
show more
POST /registraPreventa HTTP/1.1 

Content-Type: application/json
Authorization: Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

{
    "usuario": "USUARIO1",
    "idVentaExterno": "VENTA123",
    "total": 100.5,
    "moneda": "PEN",
    "detalle": [
        {
            "descripcion": "Producto 1",
            "precioUnidad": 100,
            "cantidad": 1,
            "precioTotal": 100,
            "codigoItem": "PRODUCTO123",
            "cuotas": "3"
        }
    ]
}

HTTP/1.1 500 Internal Server Error
show more
Limpiar Pre ventas
POST /limpiarPreventas

Operación para limpiar ventas pre registradas asociadas a un usuario

Request headers

Content-Type
string required
Default:
application/json
Authorization
string required
Example:
Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

Request body

Object
usuario
string

Usuario registrado en plataforma

Example:
99

Responses

200 OK
Body
Object
estado
string

Estado de la operación (“00” : EXITO, [OTRO] : ERROR)

Example:
00
descripcionEstado
string

Descripción del estado de la operación

Example:
OK
fechaOperacion
string

Fecha de operación ejecutada

Example:
2019-10-31 10:00:00
401 Unauthorized
500 Internal Server Error

Examples

POST /limpiarPreventas HTTP/1.1 

Content-Type: application/json
Authorization: Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

{
    "usuario": "usuario1"
}

HTTP/1.1 200 OK 

Content-Type: application/json

{
    "estado": "00",
    "descripcionEstado": "OK",
    "fechaOperacion": "2019-10-31 10:00:00"
}
show more
POST /limpiarPreventas HTTP/1.1 

Content-Type: application/json
Authorization: Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

{
    "usuario": "usuario1"
}

HTTP/1.1 401 Unauthorized
show more
POST /limpiarPreventas HTTP/1.1 

Content-Type: application/json
Authorization: Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

{
    "usuario": "usuario1"
}

HTTP/1.1 500 Internal Server Error
show more
Registra pre anulación
POST /registraPreanulacion

Operación para registrar una solicitud de anulación y encolarla al dispositivo.

Request headers

Content-Type
string required
Default:
application/json
Authorization
string required
Example:
Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

Request body

Object
usuario
string required

Usuario al que se asociará la preanulación, debe haber sido registrado en el API

Example:
USUARIO1
idAnulacionExterno
string required

Identificador de la anulación en sistema de Partner (único)

Example:
VENTA123
numReferencia
string required

Número de referencia de la transacción original a anular

Example:
123456789456123
terminal
string required

Identificador del terminal asociado a la transacción original a anular

Example:
654987451236
idTransaccion
string required

Identificador de la transacción asociado a la transacción original a anular

Example:
1234567890123
lote
string required

Identificador del lote asociado a la transacción original a anular

Example:
00001

Responses

200 OK
Body
Object
estado
string

Estado de la operación (“00” : EXITO, [OTRO] : ERROR)

Example:
00
descripcionEstado
string

Descripción del estado de la operación

Example:
Pre anulación registrada
fechaOperacion
string

Fecha de operación ejecutada

Example:
2019-10-31 10:00:00
data
Object
idAnulacionExterno
string

Id de la anulación en sistema del Partner

Example:
ANULACION123
idAnulacion
string

Id generado de la anulación en API

Example:
d7dc8555-8c18-4d28-bdc2-50acf70f86ef
estadoAnulacion
string

Estado de la anulación de la venta en API

Example:
PENDIENTE
numReferencia
string

Número de referencia de la transacción original a anular

Example:
123456789456123
401 Unauthorized
500 Internal Server Error

Examples

POST /registraPreanulacion HTTP/1.1 

Content-Type: application/json
Authorization: Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

{
    "usuario": "USUARIO1",
    "idAnulacionExterno": "VENTA123",
    "numReferencia": "123456789456123",
    "terminal": "654987451236",
    "idTransaccion": "1234567890123",
    "lote": "00001"
}

HTTP/1.1 200 OK 

Content-Type: application/json

{
    "estado": "00",
    "descripcionEstado": "Pre anulación registrada",
    "fechaOperacion": "2019-10-31 10:00:00",
    "data": {
        "idAnulacionExterno": "ANULACION123",
        "idAnulacion": "d7dc8555-8c18-4d28-bdc2-50acf70f86ef",
        "estadoAnulacion": "PENDIENTE",
        "numReferencia": "123456789456123"
    }
}
show more
POST /registraPreanulacion HTTP/1.1 

Content-Type: application/json
Authorization: Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

{
    "usuario": "USUARIO1",
    "idAnulacionExterno": "VENTA123",
    "numReferencia": "123456789456123",
    "terminal": "654987451236",
    "idTransaccion": "1234567890123",
    "lote": "00001"
}

HTTP/1.1 401 Unauthorized
show more
POST /registraPreanulacion HTTP/1.1 

Content-Type: application/json
Authorization: Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

{
    "usuario": "USUARIO1",
    "idAnulacionExterno": "VENTA123",
    "numReferencia": "123456789456123",
    "terminal": "654987451236",
    "idTransaccion": "1234567890123",
    "lote": "00001"
}

HTTP/1.1 500 Internal Server Error
show more
Consultar Transacción
POST /consultarTransaccion

Operación de consulta de estado de la transacción de ejecución de la venta. Deberá enviar necesariamente o el ID de venta enviado por el partner o el ID generado por Vendemás en el registro de pre venta.

Request headers

Content-Type
string required
Default:
application/json
Authorization
string required
Example:
Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

Request body

Object
idVentaExterno
string required

Identificador de la venta en sistema de partner

Example:
VENTA123
idTransaccion
string

Identificador de la venta generada por sistema vendemás

Example:
123456789456123

Responses

200 OK
Body
Object
estado
string

Estado de la operación (“00” : EXITO, [OTRO] : ERROR)

Example:
00
descripcionEstado
string

Descripción del estado de la operación

Example:
OK
fechaOperacion
string

Fecha de operación ejecutada

Example:
2019-10-31 10:00:00
data
Object
IdVentaExterno
string

Id de la venta en sistema del Partner

Example:
VENTA123
MontoTotal
integer

Monto total de la venta pre registrada

Example:
100
IdVenta
string

Id generado de la venta en API

Example:
d7dc8555-8c18-4d28-bdc2-50acf70f86ef
Estado
string

Estado del cobro de la venta en API

Example:
APROBADA
IdTransaccion
string

ID de transacción (nulo, o lleno en caso de transacción de pago aprobada)

Example:
1234567891234567
RetrievalReferenceNumber
string

Identificador de la transacción en sistema Transaccional Vendemás

Example:
S7F674H62KUIR89
NumVoucher
string

Número de voucher

Example:
789456123
NumReferencia
string

Número de referencia (DATO NECESARIO PARA SOLICITUD DE ANULACIÓN)

Example:
123456789456123
NumAutorizacion
string

Número de Autorización manejada por el Partner (único)

Example:
273937292
NumeroTarjeta
string

Número ofuscado de la tarjeta de pago

Example:
4557********1234
MarcaTarjeta
string

Marca de la tarjeta de pago

Example:
VISA
TipoTarjeta
string

Tipo de la tarjeta de pago

Example:
CREDITO
Cuotas
string

Cantidad de cuotas seleccionadas en pago

Example:
3
FechaTransaccion
string

Fecha y momento en que se ejecutó la transacción

Example:
2019-11-26 10:00:00
show more
401 Unauthorized
500 Internal Server Error

Examples

POST /consultarTransaccion HTTP/1.1 

Content-Type: application/json
Authorization: Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

{
    "idVentaExterno": "VENTA123",
    "idTransaccion": "123456789456123"
}

HTTP/1.1 200 OK 

Content-Type: application/json

{
    "estado": "00",
    "descripcionEstado": "OK",
    "fechaOperacion": "2019-10-31 10:00:00",
    "data": {
        "idVentaExterno": "VENTA123",
        "total": 100,
        "idVenta": "d7dc8555-8c18-4d28-bdc2-50acf70f86ef",
        "estadoVenta": "APROBADA",
        "idTransaccion": "1234567891234567",
        "retrievalReferenceNumber": "S7F674H62KUIR89",
        "numVoucher": "789456123",
        "numReferencia": "123456789456123",
        "numTarjeta": "4557********1234",
        "cuotas": "3",
        "fechaTransaccion": "2019-11-26 10:00:00"
    }
}
show more
POST /consultarTransaccion HTTP/1.1 

Content-Type: application/json
Authorization: Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

{
    "idVentaExterno": "VENTA123",
    "idTransaccion": "123456789456123"
}

HTTP/1.1 200 OK 

Content-Type: application/json

{
    "estado": "00", 
    "descripcionEstado": "OK",
    "fechaOperacion": "2019-10-31 10:00:00",
    "data": {
        "idVentaExterno": "VENTA123",
        "total": 100,
        "idVenta": "d7dc8555-8c18-4d28-bdc2-50acf70f86ef",
        "estadoVenta": "PENDIENTE",
        "idTransaccion": "",
        "retrievalReferenceNumber": "",
        "numVoucher": "",
        "numReferencia": "",
        "numTarjeta": "",
        "cuotas": "",
        "fechaTransaccion": ""
    }
}
show more
POST /consultarTransaccion HTTP/1.1 

Content-Type: application/json
Authorization: Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

{
    "idVentaExterno": "VENTA123",
    "idTransaccion": "123456789456123"
}

HTTP/1.1 401 Unauthorized
show more
POST /consultarTransaccion HTTP/1.1 

Content-Type: application/json
Authorization: Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

{
    "idVentaExterno": "VENTA123",
    "idTransaccion": "123456789456123"
}

HTTP/1.1 500 Internal Server Error
show more
Listar Transacciones
POST /listarTransacciones

Operación de listado de Transacciones ejecutadas en dispositivos Vendemás. Se mostrarán las transacciones del día en curso y día anterior

Request headers

Content-Type
string required
Default:
application/json
Authorization
string required
Example:
Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

Request body

Object
usuario
string

Usuario registrado en plataforma

Example:
usuario1

Responses

200 OK

El listado de ventas se mostrará en orden de novedad.

Body
Object
estado
string

Estado de la operación (“00” : EXITO, [OTRO] : ERROR)

Example:
00
descripcionEstado
string

Descripción del estado de la operación

Example:
OK
fechaOperacion
string

Fecha de operación ejecutada

Example:
2019-10-31 10:00:00
data
Array
Object
idVentaExterno
string

Id de la venta en sistema del Partner

Example:
VENTA123
total
integer

Monto total de la venta pre registrada

Example:
100
idVenta
string

Id generado de la venta en API

Example:
d7dc8555-8c18-4d28-bdc2-50acf70f86ef
estadoVenta
string

Estado del cobro de la venta en API

Example:
APROBADA
idTransaccion
string

ID de transacción (nulo, o lleno en caso de transacción de pago aprobada)

Example:
1234567891234567
retrievalReferenceNumber
string

Identificador de la transacción en sistema Transaccional Vendemás

Example:
S7F674H62KUIR89
numVoucher
string

Número de voucher

Example:
789456123
numReferencia
string

Número de referencia (DATO NECESARIO PARA SOLICITUD DE ANULACIÓN)

Example:
123456789456123
numAutorizacion
string

Número de Autorización manejada por el Partner (único)

Example:
273937292
numTarjeta
string

Número ofuscado de la tarjeta de pago

Example:
4557********1234
marcaTarjeta
string

Marca de la tarjeta de pago

Example:
VISA
tipoTarjeta
string

Tipo de la tarjeta de pago

Example:
DEBITO
cuotas
string

Cantidad de cuotas seleccionadas en pago

Example:
3
fechaTransaccion
string

Fecha y momento en que se ejecutó la transacción

Example:
2019-11-26 10:00:00
Lote
string

Lote perteneciente a la transacción

Example:
2
401 Unauthorized
500 Internal Server Error

Examples

POST /listarTransacciones HTTP/1.1 

Content-Type: application/json
Authorization: Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

{
    "usuario": "usuario1"
}

HTTP/1.1 200 OK 

Content-Type: application/json

{
    "estado": "00",
    "descripcionEstado": "OK",
    "fechaOperacion": "2019-10-31 10:00:00",
    "data": [
        {
            "idVentaExterno": "VENTA123", 
            "total": 100,
            "idVenta": "d7dc8555-8c18-4d28-bdc2-50acf70f86ef",
            "estadoVenta": "APROBADA",
            "idTransaccion": "1234567891234567",
            "retrievalReferenceNumber": "S7F674H62KUIR89",
            "numVoucher": "789456123",
            "numReferencia": "123456789456123",
            "numTarjeta": "4557********1234",
            "cuotas": "3",
            "fechaTransaccion": "2019-11-26 10:00:00"
        },
         {
            "idVentaExterno": "VENTA124", 
            "total": 100,
            "idVenta": "d7dc8555-8c18-4d28-bdc2-50acf70fwe6ef",
            "estadoVenta": "APROBADA",
            "idTransaccion": "1234567891234565",
            "retrievalReferenceNumber": "S7F674H62KUIR89",
            "numVoucher": "789456126",
            "numReferencia": "123456789445323",
            "numTarjeta": "4557********1234",
            "cuotas": "3",
            "fechaTransaccion": "2019-11-25 10:00:00"
        }
    ]
}
show more
POST /listarTransacciones HTTP/1.1 

Content-Type: application/json
Authorization: Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

{
    "usuario": "usuario1"
}

HTTP/1.1 401 Unauthorized
show more
POST /listarTransacciones HTTP/1.1 

Content-Type: application/json
Authorization: Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

{
    "usuario": "usuario1"
}

HTTP/1.1 500 Internal Server Error
show more
Pre Cierre Lote
POST /preCierreLote

Operación de pre cierre de lote en plataforma de Partner. Esta operación deja el cierre en estado de espera hasta ejecución en el dispositivo. Requiere de no tener pre ventas registradas (ejecutar servicio Limpiar Pre ventas) y no tener ventas precargadas en los dispositivos para pago en los dispositivos.

Request headers

Content-Type
string required
Default:
application/json
Authorization
string required
Example:
Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

Request body

Object
usuario
string

Usuario registrado en plataforma

Example:
usuario1
fechaExterno
string

Fecha y momento en que se ejecuta la operación de pre cierre desde plataforma de partner

Example:
2019-11-26 10:00:00
terminal
string

Terminal de lote a cerrar

Example:
654879458745

Responses

200 OK
Body
Object
estado
string

Estado de la operación (“00” : EXITO, [OTRO] : ERROR)

Example:
00
descripcionEstado
string

Descripción del estado de la operación

Example:
OK
fechaOperacion
string

Fecha de operación ejecutada

Example:
2019-11-26 10:01:00
401 Unauthorized
500 Internal Server Error

Examples

POST /preCierreLote HTTP/1.1 

Content-Type: application/json
Authorization: Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

{
    "usuario": "usuario1",
    "fechaExterno": "2019-11-26 10:00:00",
    "terminal": "654879458745"
}

HTTP/1.1 200 OK 

Content-Type: application/json

{
    "estado": "00",
    "descripcionEstado": "OK",
    "fechaOperacion": "2019-11-26 10:01:00"
}
show more
POST /limpiarPreventas HTTP/1.1 

Content-Type: application/json
Authorization: Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

{
    "usuario": "usuario1"
}

HTTP/1.1 401 Unauthorized
show more
POST /limpiarPreventas HTTP/1.1 

Content-Type: application/json
Authorization: Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

{
    "usuario": "usuario1"
}

HTTP/1.1 500 Internal Server Error
show more
Notifica Transacción
POST /notificaTransaccion

Web Service implementado en plataforma del partner para notificación de transacción ejecutada en plataforma Vendemás.

Request body

Object
idTransaccionExterna
string

Id de la venta o anulación en sistema del Partner

Example:
VENTA123
total
number

Imorte total de la venta pre registrada

Example:
250
monto
number

Importe parcial de la venta pre registrada

Example:
245
propina
number

Importe propina de la venta pre registrada

Example:
5
idVenta
integer

Id generado de la venta en API

Example:
1
estadoVenta
string

Estado del cobro de la venta en API

Enumeration:
PAGADA

Transacción aprobada por la plataforma vendemas

ANULADA

Transacción anulada por usuario

RECHAZADA

Transacción rechazada por la plataforma vendemas

idTransaccion
string

ID de transacción (nulo, o lleno en caso de transacción de pago aprobada)

Example:
1234567891234567
retrievalReferenceNumber
string

Identificador de la transacción en sistema Transaccional Vendemás

Example:
S7F674H62KUIR89
numVoucher
string

Número de voucher

Example:
789456123
numReferencia
string

Número de referencia (DATO NECESARIO PARA SOLICITUD DE ANULACIÓN)

Example:
123456789456123
numTarjeta
string

Número ofuscado de la tarjeta de pago

Example:
4557********1234
marcaTarjeta
string

Marca de la tarjeta de pago

Example:
VISA, MA, MC, JCB, AE, UP, DIN, OTRO
tipoTarjeta
string

Tipo de la tarjeta de pago

Example:
CREDITO
cuotas
string

Cantidad de cuotas seleccionadas en pago

Example:
3
fechaTransaccion
string

Fecha y momento en que se ejecutó la transacción

Example:
2019-11-26 10:00:00
terminal
string

Código del terminal

Example:
123456912812
lote
string

Código del lote

Example:
1234
show more
Examples

Responses

200 OK
Body
Object
estado
string

Estado de la operación (“00” : EXITO, [OTRO] : ERROR)

Example:
00
descripcionEstado
string

Descripción del estado de la operación

Example:
OK
fechaOperacion
string

Fecha de operación ejecutada

Example:
2019-10-31 10:00:00

Examples

POST /notificaTransaccion HTTP/1.1 

Content-Type: application/json

{
    "idTransaccionExterna": "VENTA123",
    "total": 250,
    "monto": 245,
    "propina": 5,
    "idVenta": 1,
    "estadoVenta": "PAGADA",
    "idTransaccion": "1234567891234567",
    "retrievalReferenceNumber": "S7F674H62KUIR89",
    "numVoucher": "789456123",
    "numReferencia": "123456789456123",
    "numTarjeta": "4557********1234",
    "cuotas": "3",
    "fechaTransaccion": "2019-11-26 10:00:00",
    "terminal": "123456912812",
    "lote": "1234"
}

HTTP/1.1 200 OK 

Content-Type: application/json

{
    "estado": "00",
    "descripcionEstado": "OK",
    "fechaOperacion": "2019-10-31 10:00:00"
}
show more
Listar Pre ventas
POST /listarPreventas

Operación de listado de Ventas pre registradas para pago en dispositivos Vendemás. Al realizarse la operación nuevamente, las ventas pre registradas cambiaran al estado EXPIRADA después de un minuto

Request headers

Content-Type
string required
Default:
application/json
Authorization
string required
Example:
Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

Request body

Object
usuario
string required

Usuario registrado en plataforma

Example:
99
terminal
string required

IDentificador del terminal

Example:
99

Responses

200 OK

El listado de ventas se mostrará en orden de novedad.

Body
Object
estado
string

Estado de la operación (“00” : EXITO, [OTRO] : ERROR)

Example:
00
descripcionEstado
string

Descripción del estado de la operación

Example:
OK
fechaOperacion
string

Fecha de operación ejecutada

Example:
2019-10-31 10:00:00
data
Array
Object
idVentaExterno
string

Id de la venta en sistema del Partner

Example:
VENTA123
total
number

Monto total de la venta pre registrada

Example:
100
idVenta
string

Id generado de la venta en API

Example:
d7dc8555-8c18-4d28-bdc2-50acf70f86ef
estadoVenta
string

Estado del cobro de la venta en API

Example:
PENDIENTE
moneda
string

Moneda

Example:
PEN
cuotas
integer

Número de cuotas

Example:
4
401 Unauthorized
500 Internal Server Error

Examples

POST /listarPreventas HTTP/1.1 

Content-Type: application/json
Authorization: Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

{
    "usuario": "usuario1",
    "terminal": "654879458745"
}

HTTP/1.1 200 OK 

Content-Type: application/json

{
    "estado": "00",
    "descripcionEstado": "OK",
    "fechaOperacion": "2019-10-31 10:00:00",
    "data": [
        {
            "idVentaExterno": "VENTA123",
            "total": 100,
            "idVenta": "d7dc8555-8c18-4d28-bdc2-50acf70f86ef",
            "estadoVenta": "PENDIENTE",
            "moneda": "PEN"
        }
    ]
}
show more
POST /listarPreventas HTTP/1.1 

Content-Type: application/json
Authorization: Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

{
    "usuario": "usuario1",
    "terminal": "654879458745"
}

HTTP/1.1 401 Unauthorized
show more
POST /listarPreventas HTTP/1.1 

Content-Type: application/json
Authorization: Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

{
    "usuario": "usuario1",
    "terminal": "654879458745"
}

HTTP/1.1 500 Internal Server Error
show more
Listar Pre anulaciones
POST /listarPreanulaciones

Operación de listado de anulaciones pre registradas para ejecución en dispositivos Vendemás.

Request headers

Content-Type
string required
Default:
application/json
Authorization
string required
Example:
Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

Request body

Object
usuario
string required

Usuario registrado en plataforma

Example:
usuario1
terminal
string required

Identificador del terminal

Example:
654879458745

Responses

200 OK

El listado de anulaciones se mostrará en orden de novedad.

Body
Object
estado
string

Estado de la operación (“00” : EXITO, [OTRO] : ERROR)

Example:
00
descripcionEstado
string

Descripción del estado de la operación

Example:
OK
fechaOperacion
string

Fecha de operación ejecutada

Example:
2019-10-31 10:00:00
data
Array
Object
idAnulacionExterno
string

Id de la anulación en sistema del Partner

Example:
ANULACION123
idAnulacion
string

Id generado de la anulación en API

Example:
d7dc8555-8c18-4d28-bdc2-50acf70f86ef
estadoAnulacion
string

Estado de ejecución de la anulación de la venta en API

Example:
PENDIENTE
numReferencia
string

Número de referencia

Example:
123456789456123
idTerminal
string

Código del terminal

Example:
12345678912092
idTransaccion
string

Código de transacción

Example:
1234566123123
lote
string

Código de lote

Example:
12192121
401 Unauthorized
500 Internal Server Error

Examples

POST /listarPreanulaciones HTTP/1.1 

Content-Type: application/json
Authorization: Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

{
    "usuario": "usuario1",
    "terminal": "654879458745"
}

HTTP/1.1 200 OK 

Content-Type: application/json

{
    "estado": "00",
    "descripcionEstado": "OK",
    "fechaOperacion": "2019-10-31 10:00:00",
    "data": [
        {
            "idAnulacionExterno": "ANULACION123",
            "idAnulacion": "d7dc8555-8c18-4d28-bdc2-50acf70f86ef",
            "estadoAnulacion": "PENDIENTE",
            "numReferencia": "123456789456123",
            "idTerminal": "12345678912092",
            "idTransaccion": "1234566123123",
            "lote": "12192121"
        }
    ]
}
show more
POST /listarPreanulaciones HTTP/1.1 

Content-Type: application/json
Authorization: Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

{
    "usuario": "usuario1",
    "terminal": "654879458745"
}

HTTP/1.1 401 Unauthorized
show more
POST /listarPreanulaciones HTTP/1.1 

Content-Type: application/json
Authorization: Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

{
    "usuario": "usuario1",
    "terminal": "654879458745"
}

HTTP/1.1 500 Internal Server Error
show more
Cierre Lote
POST /cierreLote

Operación de cierre de lote en plataforma de Vendemás. (Para uso interno)

Request headers

Content-Type
string required
Default:
application/json
Authorization
string required
Example:
Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

Request body

Object
usuario
string required

Usuario registrado en plataforma

Example:
usuario1
fechaExterno
string required

Fecha y momento en que se ejecuta la operación de pre cierre desde plataforma de partner

Example:
2019-11-26 10:00:00
terminal
string required

Terminal de lote a cerrar

Example:
654879458745

Responses

200 OK
Body
Object
estado
string

Estado de la operación (“00” : EXITO, [OTRO] : ERROR)

Example:
00
descripcionEstado
string

Descripción del estado de la operación

Example:
OK
fechaOperacion
string

Fecha de operación ejecutada

Example:
2019-11-26 10:01:00
401 Unauthorized
500 Internal Server Error

Examples

POST /preCierreLote HTTP/1.1 

Content-Type: application/json
Authorization: Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

{
    "usuario": "usuario1",
    "fechaExterno": "2019-11-26 10:00:00",
    "terminal": "654879458745"
}

HTTP/1.1 200 OK 

Content-Type: application/json

{
    "estado": "00",
    "descripcionEstado": "OK",
    "fechaOperacion": "2019-11-26 10:01:00"
}
show more
POST /limpiarPreventas HTTP/1.1 

Content-Type: application/json
Authorization: Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

{
    "usuario": "usuario1"
}

HTTP/1.1 401 Unauthorized
show more
POST /limpiarPreventas HTTP/1.1 

Content-Type: application/json
Authorization: Bearer eyJraWQiOiJmWk1tV3pZR0RBckxHektvalNCK2w3SjFhMnNPXC9zQnNwOTlNNmNuM3F5MD0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzOTFmZmU1MC1mODc3LTRjMjktOWEwOS00YjdjN2JlZTQ1ZDgiLCJjb2duaXRvOmdyb3VwcyI6WyJtcG9zLWFkbWluIl0sImV2ZW50X2lkIjoiNDg0NmEyNTgtOGMyNC0xMWU4LTk4YzMtMmZmYTRiNzlkYjlhIiwidG9rZW5fdXNlIjoiYWNjZXNzIiwic2NvcGUiOiJhd3MuY29nbml0by5zaWduaW4udXNlci5hZG1pbiIsImF1dGhfdGltZSI6MTUzMjA5NDgwOSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfMmNKMVNlMWZJIiwiZXhwIjoxNTMyMDk4NDA5LCJpYXQiOjE1MzIwOTQ4MDksImp0aSI6ImU2MDg0ZTI5LTk3NTYtNGVlNi1iZjMzLTY4YWRjNzk2MDBmMiIsImNsaWVudF9pZCI6IjEwbHYwNjE3bzVkaWM1MWVic25xZWlpamI3IiwidXNlcm5hbWUiOiJnaWFuY2FnYWxsYXJkb0BnbWFpbC5jb20ifQ.PjvPa2NCYuW962kAhL9HZnOKKjMNPL0O-jIVUDev4zhvUqMJUPTLKvVCwqJlXRM37oZD7tmkZBkRl7jWCZwXS2GpPALg5iHa6KvjD-9ml-7mGnl8kSOglqOe6U3my26L5f9QL7BQfoYI9SWA1Rcdh6ZRQsScPxdh9VEZdFEMOVvSTGT0pNBNymBag29cgkHVrdM-OyaxFaMdRqnlEGteJFtoanEXcu52PdiRrm5Y5aQStNLWqEnA1eKhHNPgTgXBIXLVNtLKDJ60Yd-3PADcylDxg8dSsZla5b9jstqUB-EihIkO-aJ4PcEUDYkLFjCPcGQQN5CgJtXuxDXK5hHLHg

{
    "usuario": "usuario1"
}

HTTP/1.1 500 Internal Server Error
show more