FlowManagement

API administración de flujos de cuenta Comercios Vendemás

El Flow Management es un API REST que disponibiliza operaciones de los negocios de evaluación de créditos, préstamos y recaudos a los comercios de la red Vendemás. Es necesario autenticarse (http://authorization.vendemasdev.pe/doc) para obtener un token de acceso a las operaciones del API, este token debe viajar en el header de cada operación.

URLs base ambiente Sandbox: Autenticación: http://authorization.vendemasdev.pe Operaciones: http://flowmanagement.vendemasdev.pe

Las operaciones del catálogo:

Obtener Reporte
Obtener Comercio
Crear Contrato
Autorización
Reversa
Estado Transacción
Estado Diario
Obtener Disponible
Obtener Contrato
Listar Partners

Diccionario de códigos de respuesta del API:

POST /obtenerReporte

Operación para obtener datos de comercio Vendemás y sus movimientos. Se muestran datos estadísticos por periodo de consulta diario o mensual.

Request headers

Content-Type

string required

Default:

application/json

Authorization

string required

Token de autenticación

Example:

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

Request body

Object

fecha

string required

Fecha de transacción

Pattern: YYYY-MM-DD

Example:

2019-07-15

hora

string required

Hora de transacción

Pattern: hh:mm:ss

Example:

10:00:00

cliente

string required

Provisto por Vendemás

Example:

CLIENTE1

programa

string required

Provisto por Vendemás

Example:

PROGRAMA1

datos

Object

comercio

Object required

tipoDocumento

string required

Tipo de documento de identidad del comercio

Enumeration:

DNI

PASAPORTE

CARNET DE EXTRANJERIA

RUC

documento

string required

Número de documento del comercio

Example:

12345678

transaccional

Object required

corte

string required

Corte de agrupación de datos

Enumeration:

MENSUAL

DIARIO

Examples

Responses

200 OK

Body

Object

fecha

string

Fecha de respuesta de transacción

Pattern: YYYY-MM-DD

Example:

2019-07-15

hora

string

Hora de respuesta de transacción

Pattern: hh:mm:ss

Example:

10:00:00

cliente

string

Provisto por Vendemás

Example:

CLIENTE1

programa

string

Provisto por Vendemás

Example:

PROGRAMA1

codigoRespuesta

string

Código de Respuesta de transacción

Example:

mensajeRespuesta

string

Mensaje de Respuesta

Example:

EXITO

operacion

string

Nombre de operación ejecutada

Default:

obtenerReporte

Example:

obtenerReporte

datos

Object

Objeto específico de respuesta

reporteComercios

Array

Arreglo de información transaccional por comercio según filtros

Object

comercio

Object

tipo_documento

string

Tipo de documento de comercio

Enumeration:

DNI

PASAPORTE

CARNET DE EXTRANJERIA

RUC

documento

string

Número de documento del comercio

Example:

12345678

codigoComercio

string

Código único de comercio en plataforma Vendemás

Example:

123456789

direccion

string

Dirección del comercio

Example:

Av. Aaaaa 123 int. 5

departamento

string

Departamento en que se ubica el comercio (según afiliación)

Example:

LIMA

provincia

string

Provincia en que se ubica el comercio (según afiliación)

Example:

LIMA

distrito

string

Distrito en que se ubica el comercio (según afiliación)

Example:

LIMA

telefono

string

Teléfono del comercio

Example:

987654321

string

Example:

mail@mail.com

mcc

string

Correo electrónico del comercio

Example:

5411

transaccional

Object

corte

string

Corte de agrupación del reporte

Enumeration:

DIARIO

MENSUAL

fechaCalculo

string

Fecha en que se calculó los datos del reporte

Example:

20190715

reporte

Array

Object

periodo

string

Periodo de información

Pattern: YYYY-MM-DD (DIARIA) / YYYY-MM (MENSUAL)

Example:

2019-07-01

trxTotal

integer

Cantidad total de transacciones en el periodo

Example:

volTotal

number

Volumen total de ventas en el periodo

Example:

100

401 Unauthorized

500 Internal Server Error

Examples

Consulta de reporte de comercio por corte mensual

POST http://flowmanagement.vendemasdev.pe/obtenerReporte HTTP/1.1 

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

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "datos": {
        "comercio": {
            "tipoDocumento": "P",
            "documento": "12345678"
        },
        "transaccional": {
            "corte": "M"
        }
    }
}

HTTP/1.1 200 OK 

Content-Type: application/json

{
    "fecha": "2019-07-15", 
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "codigoRespuesta": "00",
    "mensajeRespuesta": "EXITO",
    "operacion": "obtenerReporte",
    "datos": {
        "reporteComercios": [
            {
                "comercio": {
                    "tipo_documento": "C",
                    "documento": "12345678",
                    "codigoComercio": "123456789",
                    "direccion": "Av. Aaaaa 123 int. 5",
                    "departamento": "LIMA",
                    "provincia": "LIMA",
                    "distrito": "LIMA",
                    "telefono": "987654321",
                    "email": "mail@mail.com",
                    "mcc": "5411"
                },
                "transaccional": {
                    "corte": "M",
                    "fechaCalculo": "20190715",
                    "reporte": [
                        {
                            "periodo": "2019-07-01",
                            "trxTotal": 10,
                            "volTotal": 100
                        },
                        {
                            "periodo": "2019-06-01",
                            "trxTotal": 10,
                            "volTotal": 100
                        }
                    ]
                }
            }
        ]
    }
}

Consulta de reporte de comercio por corte diario

POST http://flowmanagement.vendemasdev.pe/obtenerReporte HTTP/1.1 

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

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "datos": {
        "comercio": {
            "tipoDocumento": "R",
            "documento": "12345678"
        },
        "transaccional": {
            "corte": "D"
        }
    }
}

HTTP/1.1 200 OK 

Content-Type: application/json

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "codigoRespuesta": "00",
    "mensajeRespuesta": "EXITO",
    "operacion": "obtenerReporte", 
    "datos": {
        "reporteComercios": [
            {
                "comercio": {
                    "tipo_documento": "C",
                    "documento": "12345678",
                    "codigoComercio": "123456789",
                    "direccion": "Av. Aaaaa 123 int. 5",
                    "departamento": "LIMA",
                    "provincia": "LIMA",
                    "distrito": "LIMA",
                    "telefono": "987654321",
                    "email": "mail@mail.com",
                    "mcc": "5411"
                },
                "transaccional": {
                    "corte": "D",
                    "fechaCalculo": "20190715",
                    "reporte": [
                        {
                            "periodo": "2019-07-01",
                            "trxTotal": 10,
                            "volTotal": 100
                        },
                        {
                            "periodo": "2019-07-02",
                            "trxTotal": 10,
                            "volTotal": 100
                        }
                    ]
                }
            }
        ]
    }
}

No autorizado

POST /obtenerReporte HTTP/1.1 

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

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "datos": {
        "comercio": {
            "tipoDocumento": "C",
            "documento": "12345678"
        },
        "transaccional": {
            "corte": "M"
        }
    }
}

HTTP/1.1 401 Unauthorized

Error en el servidor

POST /obtenerReporte HTTP/1.1 

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

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "datos": {
        "comercio": {
            "tipoDocumento": "R",
            "documento": "12345678"
        },
        "transaccional": {
            "corte": "M"
        }
    }
}

HTTP/1.1 500 Internal Server Error

POST /obtenerComercio

Operación para obtener datos de comercio Vendemás por identificador único.

Request headers

Content-Type

string required

Default:

application/json

Authorization

string required

Token de autenticación

Example:

Request body

Object

fecha

string required

Fecha de transacción

Pattern: YYYY-MM-DD

Example:

2019-07-15

hora

string required

Hora de transacción

Pattern: hh:mm:ss

Example:

10:00:00

cliente

string required

Provisto por Vendemás

Example:

CLIENTE1

programa

string required

Provisto por Vendemás

Example:

PROGRAMA1

datos

Object

comercio

Object required

codigoComercio

string required

Identificador único del comercio en plataforma Vendemás

Example:

123456789

tokenComercio

string

Token de comercio logueado en app Vendemás para limite de tiempo de consumo de obtener datos de comercio

Example:

eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJodHRwczovL3d3dy52ZW5kZW1hcy5jb20ucGUiLCJleHAiOjE1Nzk2NDMyOTQsInVzZXJuYW1lIjoiYXBwX2dlb191c2VyIiwidG9rZW5fdHlwZSI6IkJlYXJlciAifQ.aOfCcvIi1hBafbdgqQQmOmzAlAPpmbvYNVVdNeoxxCo

Examples

Responses

200 OK

Body

Object

fecha

string

Fecha de respuesta de transacción

Pattern: YYYY-MM-DD

Example:

2019-07-15

hora

string

Hora de respuesta de transacción

Pattern: hh:mm:ss

Example:

10:00:00

cliente

string

Provisto por Vendemás

Example:

CLIENTE1

programa

string

Provisto por Vendemás

Example:

PROGRAMA1

codigoRespuesta

string

Código de Respuesta de transacción

Example:

mensajeRespuesta

string

Mensaje de Respuesta

Example:

EXITO

operacion

string

Nombre de operación ejecutada

Default:

obtenerComercio

Example:

obtenerComercio

datos

Object

comercio

Object

tipo_documento

string

Tipo de documento de comercio

Enumeration:

DNI

PASAPORTE

CARNET DE EXTRANJERIA

RUC

documento

string

Número de documento del comercio

Example:

12345678

codigoComercio

string

Código único de comercio en plataforma Vendemás

Example:

123456789

nombreLegal

string

Nombre del representante legal o Razon social según sea el caso

Example:

Bodegas Peruanas SAC

nombreComercio

string

Nombre del comercio (según su afiliación)

Example:

Bodega Pepito

direccion

string

Dirección del comercio

Example:

Av. Aaaaa 123 int. 5

departamento

string

Departamento en que se ubica el comercio (según afiliación)

Example:

LIMA

provincia

string

Provincia en que se ubica el comercio (según afiliación)

Example:

LIMA

distrito

string

Distrito en que se ubica el comercio (según afiliación)

Example:

LIMA

telefono

string

Teléfono del comercio

Example:

987654321

string

Correo electrónico del comercio

Example:

mail@mail.com

mcc

string

Código de categoría de comercio

Example:

5411

401 Unauthorized

500 Internal Server Error

Examples

Consulta de datos de comercio

POST http://flowmanagement.vendemasdev.pe/obtenerComercio HTTP/1.1 

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

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "datos": {
        "comercio": {
            "codigoComercio": "123456789",
            "tokenComercio" : "eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJodHRwczovL3d3dy52ZW5kZW1hcy5jb20ucGUiLCJleHAiOjE1Nzk2NDMyOTQsInVzZXJuYW1lIjoiYXBwX2dlb191c2VyIiwidG9rZW5fdHlwZSI6IkJlYXJlciAifQ.aOfCcvIi1hBafbdgqQQmOmzAlAPpmbvYNVVdNeoxxCo"
        }
    }
}

HTTP/1.1 200 OK 

Content-Type: application/json

{
    "fecha": "2019-07-15", 
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "codigoRespuesta": "00",
    "mensajeRespuesta": "EXITO",
    "operacion": "obtenerComercio",
    "datos": {
        "comercio": {
            "tipo_documento": "P",
            "documento": "12345678",
            "codigoComercio": "123456789",
            "nombreLegal": "Bodegas Peruanas SAC",
            "nombreComercio": "Bodega Pepito",
            "direccion": "Av. Aaaaa 123 int. 5",
            "departamento": "LIMA",
            "provincia": "LIMA",
            "distrito": "LIMA",
            "telefono": "987654321",
            "email": "mail@mail.com",
            "mcc": "5411"
        }
    }
}

No autorizado

POST /obtenerComercio HTTP/1.1 

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

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "datos": {
        "comercio": {
            "codigoComercio": "123456789",
            "tokenComercio": "eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJodHRwczovL3d3dy52ZW5kZW1hcy5jb20ucGUiLCJleHAiOjE1Nzk2NDMyOTQsInVzZXJuYW1lIjoiYXBwX2dlb191c2VyIiwidG9rZW5fdHlwZSI6IkJlYXJlciAifQ.aOfCcvIi1hBafbdgqQQmOmzAlAPpmbvYNVVdNeoxxCo"
        }
    }
}

HTTP/1.1 401 Unauthorized

Error en el servidor

POST /obtenerComercio HTTP/1.1 

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

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "datos": {
        "comercio": {
            "codigoComercio": "123456789",
            "tokenComercio": "eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJodHRwczovL3d3dy52ZW5kZW1hcy5jb20ucGUiLCJleHAiOjE1Nzk2NDMyOTQsInVzZXJuYW1lIjoiYXBwX2dlb191c2VyIiwidG9rZW5fdHlwZSI6IkJlYXJlciAifQ.aOfCcvIi1hBafbdgqQQmOmzAlAPpmbvYNVVdNeoxxCo"
        }
    }
}

HTTP/1.1 500 Internal Server Error

POST /crearContrato

Operación para creación de contrato de definición de límites de flujo con comercio. El serial enviado en la respuesta de la ejecución se usará para identificar en qué contexto de acuerdos se ejecutarán las operaciones de cash in / cash out.

Request headers

Content-Type

string required

Default:

application/json

Authorization

string required

Token de autenticación

Example:

Request body

Object

fecha

string required

Fecha de transacción

Pattern: YYYY-MM-DD

Example:

2019-07-15

hora

string required

Hora de transacción

Pattern: hh:mm:ss

Example:

10:00:00

cliente

string required

Provisto por Vendemás

Example:

CLIENTE1

programa

string required

Provisto por Vendemás

Example:

PROGRAMA1

datos

Object

comercio

Object required

codigoComercio

string required

Identificador único de comercio en plataforma Vendemás

Example:

123456789

tokenComercio

string

Token de comercio logueado en app Vendemás para limite de tiempo de consumo de creación de contrato

Example:

contrato

Object

inicio

string required

Fecha de inicio de operaciones con comercio en contexto de crédito

Pattern: YYYY-MM-DD

Example:

2019-07-01

fin

string required

Fecha de fin de operaciones con comercio en contexto de crédito

Pattern: YYYY-MM-DD

Example:

2020-06-30

limite

number required

Monto máximo de operación con el comercio (Σ in / Σ out)

Example:

1000

datoAdicional1

string

Dato adicional 1

datoAdicional2

string

Dato adicional 2

Examples

Responses

200 OK

Body

Object

fecha

string

Fecha de respuesta de transacción

Pattern: YYYY-MM-DD

Example:

2019-07-15

hora

string

Hora de respuesta de transacción

Pattern: hh:mm:ss

Example:

10:00:00

cliente

string

Provisto por Vendemás

Example:

CLIENTE1

programa

string

Provisto por Vendemás

Example:

PROGRAMA1

codigoRespuesta

string

Código de Respuesta de transacción

Example:

mensajeRespuesta

string

Mensaje de Respuesta

Example:

EXITO

operacion

string

Nombre de operación ejecutada

Default:

crearContrato

Example:

crearContrato

datos

Object

comercio

Object

tipo_documento

string

Tipo de documento de comercio

Enumeration:

DNI

PASAPORTE

CARNET DE EXTRANJERIA

RUC

documento

string

Número de documento del comercio

Example:

12345678

codigoComercio

string

Código único de comercio en plataforma Vendemás

Example:

123456789

nombreLegal

string

Nombre de representante legal o razón social según sea el caso

Example:

Bodegas Peruanas SAC

nombreComercial

string

Nombre del comercio

Example:

Bodega Pepito

direccion

string

Dirección del comercio

Example:

Av. Aaaaa 123 int. 5

departamento

string

Departamento en que se ubica el comercio (según afiliación)

Example:

LIMA

provincia

string

Provincia en que se ubica el comercio (según afiliación)

Example:

LIMA

distrito

string

Distrito en que se ubica el comercio (según afiliación)

Example:

LIMA

telefono

string

Teléfono del comercio

Example:

987654321

string

Correo electrónico del comercio

Example:

mail@mail.com

Contrato

Object

idContrato

integer

Identificador secuencial del contrato

Example:

token

string

Serial de identificación del contrato para operaciones en contexto del crédito

Example:

48d85571-11eb-4fd5-a2ba-71e345d133f3

inicio

string

Fecha de inicio de operaciones con comercio en contexto de crédito

Pattern: YYYY-MM-DD

Example:

2019-07-01

fin

string

Fecha de fin de operaciones con comercio en contexto de crédito

Pattern: YYYY-MM-DD

Example:

2020-06-30

datoAdicional1

string

Dato adicional 1

datoAdicional2

string

Dato adicional 2

totalIn

number

Monto total inyectado sobre el contrato

Example:

totalOut

number

Monto total descontado sobre el contrato

Example:

estado

string

estado del contrato. Siempre se creará como activo

Default:

ACTIVO

Example:

ACTIVO

401 Unauthorized

500 Internal Server Error

Examples

Creación de contrato y generación de serial

POST /crearContrato HTTP/1.1 

Content-Type: application/json

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "datos": {
        "comercio": {
            "codigoComercio": "123456789",
            "tokenComercio" : "eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJodHRwczovL3d3dy52ZW5kZW1hcy5jb20ucGUiLCJleHAiOjE1Nzk2NDMyOTQsInVzZXJuYW1lIjoiYXBwX2dlb191c2VyIiwidG9rZW5fdHlwZSI6IkJlYXJlciAifQ.aOfCcvIi1hBafbdgqQQmOmzAlAPpmbvYNVVdNeoxxCo"
        },
        "contrato": {
            "inicio": "2019-07-01",
            "fin": "2020-06-30",
            "limite": 1000,
            "datoAdicional1": "",
            "datoAdicional2": ""
        }
    }
}

HTTP/1.1 200 OK 

Content-Type: application/json

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "codigoRespuesta": "00",
    "mensajeRespuesta": "EXITO",
    "operacion": "crearContrato",
    "datos": {
        "comercio": {
            "tipo_documento": "D",
            "documento": "12345678",
            "codigoComercio": "123456789",
            "nombreLegal" : "Bodegas Peruanas SAC",
            "nombreComercial" : "Bodega Pepito",
            "direccion": "Av. Aaaaa 123 int. 5",
            "departamento": "LIMA",
            "provincia": "LIMA",
            "distrito": "LIMA",
            "telefono": "987654321",
            "email": "mail@mail.com"
        },
        "Contrato": {
            "idContrato": 1,
            "token": "48d85571-11eb-4fd5-a2ba-71e345d133f3",
            "inicio": "2019-07-01",
            "fin": "2020-06-30",
            "datoAdicional1": "",
            "datoAdicional2": "",
            "totalIn" : 0.00,
            "totalOut" : 0.00,
            "estado" : "ACTIVO"
        }
    }
}

No autorizado

POST /crearContrato HTTP/1.1 

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

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "datos": {
        "comercio": {
            "codigoComercio": "123456789",
            "tokenComercio" : "eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJodHRwczovL3d3dy52ZW5kZW1hcy5jb20ucGUiLCJleHAiOjE1Nzk2NDMyOTQsInVzZXJuYW1lIjoiYXBwX2dlb191c2VyIiwidG9rZW5fdHlwZSI6IkJlYXJlciAifQ.aOfCcvIi1hBafbdgqQQmOmzAlAPpmbvYNVVdNeoxxCo"
        },
        "contrato": {
            "inicio": "2019-07-01",
            "fin": "2020-06-30",
            "limite": 1000,
            "datoAdicional1": "",
            "datoAdicional2": ""
        }
    }
}

HTTP/1.1 401 Unauthorized

Error en el servidor

POST /crearContrato HTTP/1.1 

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

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "datos": {
        "comercio": {
            "codigoComercio": "123456789",
            "tokenComercio" : "eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJodHRwczovL3d3dy52ZW5kZW1hcy5jb20ucGUiLCJleHAiOjE1Nzk2NDMyOTQsInVzZXJuYW1lIjoiYXBwX2dlb191c2VyIiwidG9rZW5fdHlwZSI6IkJlYXJlciAifQ.aOfCcvIi1hBafbdgqQQmOmzAlAPpmbvYNVVdNeoxxCo"
        },
        "contrato": {
            "inicio": "2019-07-01",
            "fin": "2020-06-30",
            "limite": 1000,
            "datoAdicional1": "",
            "datoAdicional2": ""
        }
    }
}

HTTP/1.1 500 Internal Server Error

POST /autorizacion

Operación para ejecutar depósitos o retiros al flujo transaccional del comercio (cash in / cash out).

Request headers

Content-Type

string required

Default:

application/json

Authorization

string required

Token de autenticación

Example:

Request body

Object

fecha

string required

Fecha de transacción

Pattern: YYYY-MM-DD

Example:

2019-07-15

hora

string required

Hora de transacción

Pattern: hh:mm:ss

Example:

10:00:00

cliente

string required

Provisto por Vendemás

Example:

CLIENTE1

programa

string required

Provisto por Vendemás

Example:

PROGRAMA1

datos

Object

contrato

Object required

token

string required

Serial generado en la creación del contrato con el comercio

Example:

a91ce883-464f-4a78-95cc-9ffd9fe64f04

transaccion

Object

tipo

string

Dirección de flujo de dinero

Enumeration:

Cash In: inyección de dinero al flujo del comercio

OUT

Cash Out: descuento de dinero del flujo del comercio

Example:

idOriginal

string

Id de transacción en plataforma del cliente

Example:

4675956759786976

monto

number

Monto en operación en moneda soles

Example:

100

comercioOrigen

string

código de comercio para inyección/descuento de monto de transacción según sea IN/OUT

Example:

123456789

Examples

Responses

200 OK

Body

Object

fecha

string

Fecha de respuesta de transacción

Pattern: YYYY-MM-DD

Example:

2019-07-15

hora

string

Hora de respuesta de transacción

Pattern: hh:mm:ss

Example:

10:00:00

cliente

string

Provisto por Vendemás

Example:

CLIENTE1

programa

string

Provisto por Vendemás

Example:

PROGRAMA1

codigoRespuesta

string

Código de Respuesta de transacción

Example:

mensajeRespuesta

string

Mensaje de Respuesta

Example:

EXITO

operacion

string

Nombre de operación ejecutada

Default:

autorizacion

Example:

autorizacion

datos

Object

contrato

Object

idContrato

integer

Identificador secuencial del contrato

Example:

token

string

Serial de identificación del contrato para operaciones en contexto del crédito

Example:

48d85571-11eb-4fd5-a2ba-71e345d133f3

inicio

string

Fecha de inicio de operaciones con comercio/recaudo en contexto de crédito/deuda

Pattern: YYYY-MM-DD

Example:

2019-07-01

fin

string

Fecha de fin de operaciones con comercio/recaudo en contexto de crédito/deuda

Pattern: YYYY-MM-DD

Example:

2020-06-30

datoAdicional1

string

Dato adicional 1

datoAdicional2

string

Dato adicional 2

totalIn

integer

Monto total inyectado sobre el contrato

Example:

totalOut

integer

Monto total descontado sobre el contrato

Example:

estado

string

estado del contrato

Example:

ACTIVO

tipo

string

Tipo de contrato según partner

Enumeration:

NOMINADO

Contrato establecido a un comercio

RECAUDO

Contrato establecido a un código solo significativo en plataforma del partner

partner

string

Partner de crédito/recaudo

Example:

CLIENTE1

programa

string

Programa del crédito/recaudo

Example:

PROGRAMA1

totalDeuda

integer

Monto total de la deuda del contrato reportado por el partner

Example:

1000

codigo

string

Identificador único de comercio/recaudo en plataforma Vendemás.

Example:

123456789

transaccion

Object

tipo

string

Dirección de flujo de dinero

Enumeration:

Cash In: inyección de dinero al flujo del comercio

OUT

Cash Out: descuento de dinero del flujo del comercio

idOriginal

string

Id de transacción en plataforma del cliente (referencia si se requiere reversar)

Example:

4675956759786976

idTransaccion

string

Id de transacción en plataforma Vendemás

Example:

4356728356475246

monto

integer

Monto en operación en moneda soles

Example:

100

estado

string

Estado de la transacción

Enumeration:

PENDIENTE

Transacción ingresada pero no ejecutada, no es estado final

APROBADA

Transacción ejecutada de Cash In / Cash Out según sea el caso

RECHAZADA

Transacción rechazada

motivoEstado

string

Descripción del motivo del estado

fechaTransaccion

string

Fecha en que se ingresa la transacción

Example:

2019-07-01 10:00:00

fechaActualizacion

string

Fecha en que se actualiza el estado final de la transacción (APROBADA/DENEGADA/REVERSADA)

Example:

2019-07-01 16:00:00

comercioOrigen

string

Comercio al que se descontará/inyectará flujo out/in de la transacción

Example:

123456789

401 Unauthorized

500 Internal Server Error

Examples

Transacción exitosa de tipo de partner nominado

POST http://flowmanagement.vendemasdev.pe/autorizacion HTTP/1.1 

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

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "datos": {
        "contrato": {
            "token": "a91ce883-464f-4a78-95cc-9ffd9fe64f04"
        },
        "transaccion": {
            "tipo": "IN",
            "idOriginal": "4675956759786976",
            "monto": 100,
            "comercioOrigen": "123456789"
        }
    }
}

HTTP/1.1 200 OK 

Content-Type: application/json

{
    "fecha": "2019-07-15",
    "hora": "10:00:00", 
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "codigoRespuesta": "00",
    "mensajeRespuesta": "EXITO",
    "operacion": "autorizacion",
    "datos": {
        "contrato": {
            "idContrato": 1,
            "token": "48d85571-11eb-4fd5-a2ba-71e345d133f3",
            "inicio": "2019-07-01",
            "fin": "2020-06-30",
            "datoAdicional1": "",
            "datoAdicional2": "",
            "totalIn": 1,
            "totalOut": 1,
            "estado": "ACTIVO",
            "tipo": "NOMINADO",
            "partner": "CLIENTE1",
            "programa": "PROGRAMA1",
            "totalDeuda": 1000,
            "codigo": "123456789"
        },
        "transaccion": {
            "tipo": "IN",
            "idOriginal": "4675956759786976",
            "idTransaccion": "4356728356475246",
            "monto": 100,
            "estado": "PENDIENTE",
            "motivoEstado": "",
            "fechaTransaccion": "2019-07-01 10:00:00",
            "fechaActualizacion": "2019-07-01 16:00:00",
            "comercioOrigen": "123456789"
        }
    }
}

Transacción exitosa de tipo de partner recaudo

POST http://flowmanagement.vendemasdev.pe/autorizacion HTTP/1.1 

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

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "datos": {
        "contrato": {
            "token": "a91ce883-464f-4a78-95cc-9ffd9fe64f04"
        },
        "transaccion": {
            "tipo": "IN",
            "idOriginal": "4675956759786976",
            "monto": 100,
            "comercioOrigen": "123456789"
        }
    }
}

HTTP/1.1 200 OK 

Content-Type: application/json

{
    "fecha": "2019-07-15",
    "hora": "10:00:00", 
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "codigoRespuesta": "00",
    "mensajeRespuesta": "EXITO",
    "operacion": "autorizacion",
    "datos": {
        "contrato": {
            "idContrato": 1,
            "token": "48d85571-11eb-4fd5-a2ba-71e345d133f3",
            "inicio": "2019-07-01",
            "fin": "2020-06-30",
            "datoAdicional1": "",
            "datoAdicional2": "",
            "totalIn": 1,
            "totalOut": 1,
            "estado": "ACTIVO",
            "tipo": "RECAUDO",
            "partner": "CLIENTE1",
            "programa": "PROGRAMA1",
            "totalDeuda": 1000,
            "codigo": "ABC12345"
        },
        "transaccion": {
            "tipo": "OUT",
            "idOriginal": "4675956759786976",
            "idTransaccion": "4356728356475246",
            "monto": 100,
            "estado": "PENDIENTE",
            "motivoEstado": "",
            "fechaTransaccion": "2019-07-01 10:00:00",
            "fechaActualizacion": "2019-07-01 16:00:00",
            "comercioOrigen": "123456789"
        }
    }
}

No autorizado

POST http://flowmanagement.vendemasdev.pe/autorizacion HTTP/1.1 

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

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "datos": {
        "contrato": {
            "token": "a91ce883-464f-4a78-95cc-9ffd9fe64f04"
        },
        "transaccion": {
            "tipo": "IN",
            "idOriginal": "4675956759786976",
            "monto": 100,
            "comercioOrigen": "123456789"
        }
    }
}

HTTP/1.1 401 Unauthorized

Error en el servidor

POST http://flowmanagement.vendemasdev.pe/autorizacion HTTP/1.1 

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

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "datos": {
        "contrato": {
            "token": "a91ce883-464f-4a78-95cc-9ffd9fe64f04"
        },
        "transaccion": {
            "tipo": "IN",
            "idOriginal": "4675956759786976",
            "monto": 100,
            "comercioOrigen": "123456789"
        }
    }
}

HTTP/1.1 500 Internal Server Error

POST /reversa

Operación para reversar transacciones de Cash In/ Cash Out. La ejecución exitosa de la reversa dependerá de los límites de cortes diarios que se definan para la ejecución de las transacciones.

Request headers

Content-Type

string required

Default:

application/json

Authorization

string required

Token de autenticación

Example:

Request body

Object

fecha

string required

Fecha de transacción

Pattern: YYYY-MM-DD

Example:

2019-07-15

hora

string required

Hora de transacción

Pattern: hh:mm:ss

Example:

10:00:00

cliente

string required

Provisto por Vendemás

Example:

CLIENTE1

programa

string required

Provisto por Vendemás

Example:

PROGRAMA1

datos

Object

contrato

Object required

token

string required

Serial generado en la creación del contrato con el comercio

Example:

a91ce883-464f-4a78-95cc-9ffd9fe64f04

transaccion

Object

Datos de la transacción original a reversar

tipo

string

Dirección de flujo de dinero

Enumeration:

Cash In: inyección de dinero al flujo del comercio

OUT

Cash Out: descuento de dinero del flujo del comercio

Example:

idOriginal

string

Id de transacción en plataforma del cliente

Example:

4675956759786976

monto

number

Monto en operación en moneda soles

Example:

100

referencia

string

Id de transacción original a reversar

Example:

4675956759786975

Examples

Responses

200 OK

Body

Object

fecha

string

Fecha de respuesta de transacción

Pattern: YYYY-MM-DD

Example:

2019-07-15

hora

string

Hora de respuesta de transacción

Pattern: hh:mm:ss

Example:

10:00:00

cliente

string

Provisto por Vendemás

Example:

CLIENTE1

programa

string

Provisto por Vendemás

Example:

PROGRAMA1

codigoRespuesta

string

Código de Respuesta de transacción

Example:

mensajeRespuesta

string

Mensaje de Respuesta

Example:

EXITO

operacion

string

Nombre de operación ejecutada

Default:

reversa

Example:

reversa

datos

Object

contrato

Object

idContrato

string

Identificador secuencial del contrato

Example:

token

string

Serial de identificación del contrato para operaciones en contexto del crédito

Example:

87d50500-4939-4f93-a8e3-9fab7716eeb7

inicio

string

Fecha de inicio de operaciones con comercio en contexto de crédito

Example:

2019-07-01

fin

string

Fecha de fin de operaciones con comercio en contexto de crédito

Example:

2020-06-30

limite

integer

Monto máximo de operación con el comercio (Σ in / Σ out)

Example:

1000

datoAdicional1

string

Dato adicional 1

datoAdicional2

string

Dato adicional 2

totalOut

integer

Monto total descontado sobre el contrato

Example:

100

totalIn

integer

Monto total inyectado sobre el contrato

Example:

500

estado

string

Enumeration:

ACTIVO

INACTIVO

Example:

ACTIVO

transaccion

Object

tipo

string

Dirección de flujo de dinero

Enumeration:

Cash In: inyección de dinero al flujo del comercio

OUT

Cash Out: descuento de dinero del flujo del comercio

idOriginal

string

Id de transacción en plataforma del cliente (referencia si se requiere reversar)

Example:

4675956759786976

idTransaccion

string

Id de transacción en plataforma Vendemás

Example:

4356728356475246

monto

integer

Monto en operación en moneda soles

Example:

100

estado

string

Estado de la transacción

Enumeration:

APROBADA

Reversa ejecutada con éxito

RECHAZADA

Reversa rechazada

motivoEstado

string

Descripción del motivo del estado

fechaTransaccion

string

Fecha en que se ingresa la transacción

Example:

2019-07-01 10:00:00

fechaActualizacion

string

Fecha en que se actualiza el estado final de la transacción

Example:

2019-07-01 16:00:00

referencia

string

Id de transacción original a reversar

Example:

4675956759786975

401 Unauthorized

500 Internal Server Error

Examples

Transacción de reversa exitosa

POST /reversa HTTP/1.1 

Content-Type: application/json

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "datos": {
        "contrato": {
            "token": "a91ce883-464f-4a78-95cc-9ffd9fe64f04"
        },
        "transaccion": {
            "tipo": "IN",
            "idOriginal": "4675956759786976",
            "monto": 100,
            "referencia" : "4675956759786976"
        }
    }
}

HTTP/1.1 200 OK 

Content-Type: application/json

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "codigoRespuesta": "00",
    "mensajeRespuesta": "EXITO",
    "operacion": "reversa",
    "datos": {
        "contrato": {
            "idContrato": "1",
            "token": "87d50500-4939-4f93-a8e3-9fab7716eeb7",
            "inicio": "2019-07-01",
            "fin": "2020-06-30",
            "limite": 1000,
            "datoAdicional1": "",
            "datoAdicional2": "",
            "totalOut": 100,
            "totalIn": 500,
            "estado": "ACTIVO"
        },
        "transaccion": {
            "tipo": "OUT",
            "idOriginal": "4675956759786976",
            "idTransaccion": "4356728356475246",
            "monto": 100,
            "estado": "APROBADA",
            "motivoEstado": "",
            "fechaTransaccion" : "2019-07-01 10:00:00",
            "fechaActualizacion" : "2019-07-01 16:00:00",
            "referencia" : "4675956759786976"
        }
    }
}

No autorizado

POST /reversa HTTP/1.1 

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

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "datos": {
        "contrato": {
            "token": "a91ce883-464f-4a78-95cc-9ffd9fe64f04"
        },
        "transaccion": {
            "tipo": "IN",
            "idOriginal": "4675956759786976",
            "monto": 100,
            "referencia" : "4675956759786976"
        }
    }
}

HTTP/1.1 401 Unauthorized

Error en el servidor

POST /reversa HTTP/1.1 

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

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "datos": {
        "contrato": {
            "token": "a91ce883-464f-4a78-95cc-9ffd9fe64f04"
        },
        "transaccion": {
            "tipo": "IN",
            "idOriginal": "4675956759786976",
            "monto": 100,
            "referencia" : "4675956759786976"
        }
    }
}

HTTP/1.1 500 Internal Server Error

POST /estadoTransaccion

Operación para obtener el estado de transacción ejecutada

Request headers

Content-Type

string required

Default:

application/json

Authorization

string required

Token de autenticación

Example:

Request body

Object

fecha

string required

Fecha de transacción

Pattern: YYYY-MM-DD

Example:

2019-07-15

hora

string required

Hora de transacción

Pattern: hh:mm:ss

Example:

10:00:00

cliente

string required

Provisto por Vendemás

Example:

CLIENTE1

programa

string required

Provisto por Vendemás

Example:

PROGRAMA1

datos

Object

contrato

Object required

token

string required

Serial generado en la creación del contrato con el comercio

Example:

a91ce883-464f-4a78-95cc-9ffd9fe64f04

transaccion

Object

idOriginal

string

Id de transacción en plataforma del cliente

Example:

4675956759786976

Examples

Responses

200 OK

Body

Object

fecha

string

Fecha de respuesta de transacción

Pattern: YYYY-MM-DD

Example:

2019-07-15

hora

string

Hora de respuesta de transacción

Pattern: hh:mm:ss

Example:

10:00:00

cliente

string

Provisto por Vendemás

Example:

CLIENTE1

programa

string

Provisto por Vendemás

Example:

PROGRAMA1

codigoRespuesta

string

Código de Respuesta de transacción

Example:

mensajeRespuesta

string

Mensaje de Respuesta

Example:

EXITO

operacion

string

Nombre de operación ejecutada

Default:

estadoTransaccion

Example:

estadoTransaccion

datos

Object

contrato

Object

idContrato

string

Identificador secuencial del contrato

Example:

token

string

Serial de identificación del contrato para operaciones en contexto del crédito

Example:

87d50500-4939-4f93-a8e3-9fab7716eeb7

inicio

string

Fecha de inicio de operaciones con comercio en contexto de crédito

Example:

2019-07-01

fin

string

Fecha de fin de operaciones con comercio en contexto de crédito

Example:

2020-06-30

limite

integer

Monto máximo de operación con el comercio (Σ in / Σ out)

Example:

1000

datoAdicional1

string

Dato adicional 1

datoAdicional2

string

Dato adicional 2

totalOut

integer

Monto total descontado sobre el contrato

Example:

100

totalIn

integer

Monto total inyectado sobre el contrato

Example:

500

estado

string

Enumeration:

ACTIVO

INACTIVO

Example:

ACTIVO

transaccion

Object

tipo

string

Dirección de flujo de dinero

Enumeration:

Cash In: inyección de dinero al flujo del comercio

OUT

Cash Out: descuento de dinero del flujo del comercio

idOriginal

string

Id de transacción en plataforma del cliente (referencia si se requiere reversar)

Example:

4675956759786976

idTransaccion

string

Id de transacción en plataforma Vendemás

Example:

4356728356475246

monto

integer

Monto en operación en moneda soles

Example:

100

estado

string

Estado de la transacción

Enumeration:

PENDIENTE

Transacción ingresada pero no ejecutada, no es estado final

APROBADA

Transacción ejecutada de Cash In / Cash Out según sea el caso

RECHAZADA

Transacción rechazada

ANULADA

Transacción anulada

motivoEstado

string

Descripción del motivo del estado

fechaTransaccion

string

Fecha en que se ingresa la transacción

Example:

2019-07-01 10:00:00

fechaActualizacion

string

Fecha en que se actualiza el estado final de la transacción (APROBADA/DENEGADA/REVERSADA)

Example:

2019-07-01 16:00:00

referencia

string

Id de transacción original reversada

Example:

4675956759786975

401 Unauthorized

500 Internal Server Error

Examples

Estado de transacción

POST /estadoTransaccion HTTP/1.1 

Content-Type: application/json

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "datos": {
        "contrato": {
            "token": "a91ce883-464f-4a78-95cc-9ffd9fe64f04"
        },
        "transaccion": {
            "idOriginal": "4675956759786976"
        }
    }
}

HTTP/1.1 200 OK 

Content-Type: application/json

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "codigoRespuesta": "00",
    "mensajeRespuesta": "EXITO",
    "operacion": "estadoTransaccion",
    "datos": {
        "contrato": {
            "idContrato": "1",
            "token": "87d50500-4939-4f93-a8e3-9fab7716eeb7",
            "inicio": "2019-07-01",
            "fin": "2020-06-30",
            "limite": 1000,
            "datoAdicional1": "",
            "datoAdicional2": "",
            "totalOut": 100,
            "totalIn": 500,
            "estado": "ACTIVO"
        },
        "transaccion": {
            "tipo": "OUT",
            "idOriginal": "4675956759786976",
            "idTransaccion": "4356728356475246",
            "monto": 100,
            "estado": "APROBADA",
            "motivoEstado": "",
            "fechaTransaccion" : "2019-07-01 10:00:00",
            "fechaActualizacion" : "2019-07-01 16:00:00",
            "referencia" : ""
        }
    }
}

No autorizado

POST /estadoTransaccion HTTP/1.1 

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

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "datos": {
        "contrato": {
            "token": "a91ce883-464f-4a78-95cc-9ffd9fe64f04"
        },
        "transaccion": {
            "idOriginal": "4675956759786976"
        }
    }
}

HTTP/1.1 401 Unauthorized

Error en el servidor

POST /estadoTransaccion HTTP/1.1 

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

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "datos": {
        "contrato": {
            "token": "a91ce883-464f-4a78-95cc-9ffd9fe64f04"
        },
        "transaccion": {
            "idOriginal": "4675956759786976"
        }
    }
}

HTTP/1.1 500 Internal Server Error

POST /estadoDiario/{fechaConsulta}

Operación para obtener los estados de transacciones ejecutadas en fecha de consulta

Path variables

fechaConsulta

string YYYY-MM-DD required

Fecha de consulta de estado de transacciones

Example:

2019-07-01

Request headers

Content-Type

string required

Default:

application/json

Authorization

string required

Token de autenticación

Example:

Request body

Object

fecha

string required

Fecha de transacción

Pattern: YYYY-MM-DD

Example:

2019-07-15

hora

string required

Hora de transacción

Pattern: hh:mm:ss

Example:

10:00:00

cliente

string required

Provisto por Vendemás

Example:

CLIENTE1

programa

string required

Provisto por Vendemás

Example:

PROGRAMA1

Examples

Responses

200 OK

Body

Object

fecha

string

Fecha de respuesta de transacción

Pattern: YYYY-MM-DD

Example:

2019-07-15

hora

string

Hora de respuesta de transacción

Pattern: hh:mm:ss

Example:

10:00:00

cliente

string

Provisto por Vendemás

Example:

CLIENTE1

programa

string

Provisto por Vendemás

Example:

PROGRAMA1

codigoRespuesta

string

Código de Respuesta de transacción

Example:

mensajeRespuesta

string

Mensaje de Respuesta

Example:

EXITO

operacion

string

Nombre de operación ejecutada

Default:

estadoDiario

Example:

estadoDiario

datos

Array

Object

transaccion

Object

tipo

string

Dirección de flujo de dinero

Enumeration:

Cash In: inyección de dinero al flujo del comercio

OUT

Cash Out: descuento de dinero del flujo del comercio

idOriginal

string

Id de transacción en plataforma del cliente (referencia si se requiere reversar)

Example:

4675956759786976

idTransaccion

string

Id de transacción en plataforma Vendemás

Example:

4356728356475246

monto

number

Monto en operación en moneda soles

Example:

100

estado

string

Estado de la transacción

Enumeration:

PENDIENTE

Transacción ingresada pero no ejecutada, no es estado final

APROBADA

Transacción ejecutada de Cash In / Cash Out según sea el caso. Es un estado final.

RECHAZADA

Transacción rechazada. Es un estado final

ANULADA

Transacción Reversada. Es un estado final

motivoEstado

string

Descripción del motivo del estado

fechaTransaccion

string

Fecha en que se ingresa la transacción

Example:

2019-07-01 10:00:00

fechaActualizacion

string

Fecha en que se actualiza el estado final de la transacción (APROBADA/DENEGADA/ANULADA)

Example:

2019-07-01 16:00:00

referencia

string

Id de transacción original reversada

Example:

4675956759786975

401 Unauthorized

500 Internal Server Error

Examples

Estado de transacción

POST /estadoDiario/2019-07-01 HTTP/1.1 

Content-Type: application/json

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "datos": {
    }
}

HTTP/1.1 200 OK 

Content-Type: application/json

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "codigoRespuesta": "00",
    "mensajeRespuesta": "EXITO",
    "operacion": "estadoDiario",
    "datos": {
        [
            {"transaccion": {
                "tipo": "OUT",
                "idOriginal": "4675956759786976",
                "idTransaccion": "4356728356475246",
                "monto": 100,
                "estado": "APROBADA",
                "motivoEstado": "",
                "fechaTransaccion" : "2019-07-01 10:00:00",
                "fechaActualizacion" : "2019-07-01 16:00:00",
                "referencia" : ""
                },
            {"transaccion": {
                "tipo": "OUT",
                "idOriginal": "4675956759786977",
                "idTransaccion": "4356728356475247",
                "monto": 200,
                "estado": "APROBADA",
                "motivoEstado": "",
                "fechaTransaccion" : "2019-07-01 10:00:00",
                "fechaActualizacion" : "2019-07-01 16:00:00",
                "referencia" : ""
                },
            {"transaccion": {
                "tipo": "OUT",
                "idOriginal": "4675956759786978",
                "idTransaccion": "4356728356475248",
                "monto": 100,
                "estado": "RECHAZADA",
                "motivoEstado": "",
                "fechaTransaccion" : "2019-07-01 10:00:00",
                "fechaActualizacion" : "2019-07-01 16:00:00",
                "referencia" : ""
                },
        ]   
    }
}

No autorizado

POST /estadoDiario/2019-07-01 HTTP/1.1 

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

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1"
}

HTTP/1.1 401 Unauthorized

Error en el servidor

POST /estadoDiario/2019-07-01 HTTP/1.1 

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

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1"
}

HTTP/1.1 500 Internal Server Error

POST /obtenerDisponible

Operación para obtener saldo disponible del flujo del comercio para retirar en el día.

Request headers

Content-Type

string required

Default:

application/json

Authorization

string required

Token de autenticación

Example:

Request body

Object

fecha

string required

Fecha de transacción

Pattern: YYYY-MM-DD

Example:

2019-07-15

hora

string required

Hora de transacción

Pattern: hh:mm:ss

Example:

10:00:00

cliente

string required

Provisto por Vendemás

Example:

CLIENTE1

programa

string required

Provisto por Vendemás

Example:

PROGRAMA1

datos

Object

comercio

Object required

codigoComercio

string required

Identificador único del comercio en plataforma Vendemás

Example:

123456789

Examples

Responses

200 OK

Body

Object

fecha

string

Fecha de respuesta de transacción

Pattern: YYYY-MM-DD

Example:

2019-07-15

hora

string

Hora de respuesta de transacción

Pattern: hh:mm:ss

Example:

10:00:00

cliente

string

Provisto por Vendemás

Example:

CLIENTE1

programa

string

Provisto por Vendemás

Example:

PROGRAMA1

codigoRespuesta

string

Código de Respuesta de transacción

Example:

mensajeRespuesta

string

Mensaje de Respuesta

Example:

EXITO

operacion

string

Nombre de operación ejecutada

Default:

obtenerDisponible

Example:

obtenerDisponible

datos

Object

comercio

Object

codigoComercio

string

Código único de comercio en plataforma Vendemás

Example:

123456789

disponible

number

Monto disponible del flujo en tránsito del comercio

Example:

100

401 Unauthorized

500 Internal Server Error

Examples

Consulta de saldo disponible de comercio para cash out

POST http://flowmanagement.vendemasdev.pe/obtenerDisponible HTTP/1.1 

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

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "datos": {
        "comercio": {
            "codigoComercio": "123456789"
        }
    }
}

HTTP/1.1 200 OK 

Content-Type: application/json

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1", 
    "programa": "PROGRAMA1",
    "codigoRespuesta": "00",
    "mensajeRespuesta": "EXITO",
    "operacion": "obtenerDisponible",
    "datos": {
        "comercio": {
            "codigoComercio": "123456789"
        },
        "disponible": 100
    }
}

No autorizado

POST http://flowmanagement.vendemasdev.pe/obtenerDisponible HTTP/1.1 

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

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "datos": {
        "comercio": {
            "codigoComercio": "123456789"
        }
    }
}

HTTP/1.1 401 Unauthorized

Error en el servidor

POST http://flowmanagement.vendemasdev.pe/obtenerDisponible HTTP/1.1 

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

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "datos": {
        "comercio": {
            "codigoComercio": "123456789"
        }
    }
}

HTTP/1.1 500 Internal Server Error

POST /obtenerContrato

Operación para obtener datos de contrato. El contrato será de tipo nomimado cuando sea establecido para un comercio, y tipo recaudo cuando sea establecido para un código significativo en plataforma del partner (cliente).

Request headers

Content-Type

string required

Default:

application/json

Authorization

string required

Token de autenticación

Example:

Request body

Object

fecha

string required

Fecha de transacción

Pattern: YYYY-MM-DD

Example:

2019-07-15

hora

string required

Hora de transacción

Pattern: hh:mm:ss

Example:

10:00:00

cliente

string required

Provisto por Vendemás

Example:

CLIENTE1

programa

string required

Provisto por Vendemás

Example:

PROGRAMA1

datos

Object

contrato

Object

codigo

string

Identificador único de comercio/recaudo en plataforma Vendemás.

Example:

ABC123456

partner

string

Identificador del partner en plataforma Vendemás (provisto por operación Listado de Partners)

Example:

PARTNER1

programa

string

Identificador del programa del partner en plataforma Vendemás (provisto por operación Listado de Partners)

Example:

PROGRAMA1

Examples

Responses

200 OK

Body

Object

fecha

string

Fecha de respuesta de transacción

Pattern: YYYY-MM-DD

Example:

2019-07-15

hora

string

Hora de respuesta de transacción

Pattern: hh:mm:ss

Example:

10:00:00

cliente

string

Provisto por Vendemás

Example:

CLIENTE1

programa

string

Provisto por Vendemás

Example:

PROGRAMA1

codigoRespuesta

string

Código de Respuesta de transacción

Example:

mensajeRespuesta

string

Mensaje de Respuesta

Example:

EXITO

operacion

string

Nombre de operación ejecutada

Default:

obtenerContrato

Example:

obtenerContrato

datos

Object

Contrato

Object

idContrato

integer

Identificador secuencial del contrato

Example:

token

string

Serial de identificación del contrato para operaciones en contexto del crédito

Example:

48d85571-11eb-4fd5-a2ba-71e345d133f3

inicio

string

Fecha de inicio de operaciones con comercio/recaudo en contexto de crédito/deuda

Pattern: YYYY-MM-DD

Example:

2019-07-01

fin

string

Fecha de fin de operaciones con comercio/recaudo en contexto de crédito/deuda

Pattern: YYYY-MM-DD

Example:

2020-06-30

datoAdicional1

string

Dato adicional 1

datoAdicional2

string

Dato adicional 2

totalIn

number

Monto total inyectado sobre el contrato

Example:

totalOut

number

Monto total descontado sobre el contrato

Example:

estado

string

estado del contrato

Default:

ACTIVO

Example:

ACTIVO

tipo

string

Tipo de contrato según partner

Enumeration:

NOMINADO

Contrato establecido a un comercio

RECAUDO

Contrato establecido a un código solo significativo en plataforma del partner

partner

string

Partner de crédito/recaudo

Example:

PARTNER1

programa

string

Programa del crédito/recaudo

Example:

PROGRAMA1

totalDeuda

number

Monto total de la deuda del contrato reportado por el partner

Example:

1000

codigo

string

Identificador único de comercio/recaudo en plataforma Vendemás.

Example:

ABC123456

401 Unauthorized

500 Internal Server Error

Examples

Obtención de contrato tipo nominado (por código de comercio)

POST http://flowmanagement.vendemasdev.pe/obtenerContrato HTTP/1.1 

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

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "datos": {
        "contrato": {
            "codigo": "123456789",
            "partner": "CLIENTE1",
            "programa": "PROGRAMA1"
        }
    }
}

HTTP/1.1 200 OK 

Content-Type: application/json

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1", 
    "programa": "PROGRAMA1",
    "codigoRespuesta": "00",
    "mensajeRespuesta": "EXITO",
    "operacion": "obtenerContrato",
    "datos": {
        "Contrato": {
            "idContrato": 1,
            "token": "48d85571-11eb-4fd5-a2ba-71e345d133f3",
            "inicio": "2019-07-01",
            "fin": "2020-06-30",
            "datoAdicional1": "",
            "datoAdicional2": "",
            "totalIn": 0,
            "totalOut": 0,
            "estado": "ACTIVO",
            "tipo": "NOMINADO",
            "partner": "CLIENTE1",
            "programa": "PROGRAMA1",
            "totalDeuda": 1000,
            "codigo": "123456789"
        }
    }
}

Obtención de contrato tipo recuado (por código de recaudo)

POST http://flowmanagement.vendemasdev.pe/obtenerContrato HTTP/1.1 

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

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "datos": {
        "contrato": {
            "codigo": "ABC123456",
            "partner": "PARTNER1",
            "programa": "PROGRAMA1"
        }
    }
}

HTTP/1.1 200 OK 

Content-Type: application/json

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1", 
    "programa": "PROGRAMA1",
    "codigoRespuesta": "00",
    "mensajeRespuesta": "EXITO",
    "operacion": "obtenerContrato",
    "datos": {
        "Contrato": {
            "idContrato": 1,
            "token": "48d85571-11eb-4fd5-a2ba-71e345d133f3",
            "inicio": "2019-07-01",
            "fin": "2019-07-01",
            "datoAdicional1": "",
            "datoAdicional2": "",
            "totalIn": 1,
            "totalOut": 1,
            "estado": "ACTIVO",
            "tipo": "RECAUDO",
            "partner": "PARTNER1",
            "programa": "PROGRAMA1",
            "totalDeuda": 1000,
            "codigo": "ABC123456"
        }
    }
}

No autorizado

POST http://flowmanagement.vendemasdev.pe/obtenerContrato HTTP/1.1 

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

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "datos": {
        "contrato": {
            "codigo": "ABC123456",
            "partner": "PARTNER1",
            "programa": "PROGRAMA1"
        }
    }
}

HTTP/1.1 401 Unauthorized

Error en el servidor

POST http://flowmanagement.vendemasdev.pe/obtenerContrato HTTP/1.1 

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

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "datos": {
        "contrato": {
            "codigo": "ABC123456",
            "partner": "PARTNER1",
            "programa": "PROGRAMA1"
        }
    }
}

HTTP/1.1 500 Internal Server Error

POST /listarPartner

Operación para obtener listado de partners de préstamos/recaudo

Request headers

Content-Type

string required

Default:

application/json

Authorization

string required

Token de autenticación

Example:

Request body

Object

fecha

string required

Fecha de transacción

Pattern: YYYY-MM-DD

Example:

2019-07-15

hora

string required

Hora de transacción

Pattern: hh:mm:ss

Example:

10:00:00

cliente

string required

Provisto por Vendemás

Example:

CLIENTE1

programa

string required

Provisto por Vendemás

Example:

PROGRAMA1

datos

Object

tipo

string

Tipo de partners a listar

Enumeration:

RECAUDO

Partners con contratos asociados a un código

NOMINADO

Partners con contratos asociados a comercios

Examples

Responses

200 OK

Body

Object

fecha

string

Fecha de respuesta de transacción

Pattern: YYYY-MM-DD

Example:

2019-07-15

hora

string

Hora de respuesta de transacción

Pattern: hh:mm:ss

Example:

10:00:00

cliente

string

Provisto por Vendemás

Example:

CLIENTE1

programa

string

Provisto por Vendemás

Example:

PROGRAMA1

codigoRespuesta

string

Código de Respuesta de transacción

Example:

mensajeRespuesta

string

Mensaje de Respuesta

Example:

EXITO

operacion

string

Nombre de operación ejecutada

Default:

listarPartner

Example:

listarPartner

datos

Array

Object

partner

string

Partner de Vendemás para negocio de recaudo/préstamos

Example:

PARTNER1

programa

string

Programa partner/Vendemás

Example:

PROGRAMA1

tipo

string

Tipo de contrato que se tendrán con el partner

Enumeration:

RECAUDO

Tipo de contrato a códigos no significativos para plataforma Vendemás

NOMINADO

Tipo de contrato asociados a un código de comercio

urlImagen

string

Dirección url del logo del partner

Example:

https://www.google.com/images/branding/googlelogo/1x/googlelogo_color_272x92dp.png

401 Unauthorized

500 Internal Server Error

Examples

Listado de partners exitoso

POST http://flowmanagement.vendemasdev.pe/listarPartner HTTP/1.1 

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

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "datos": {
        "tipo": "RECAUDO"
    }
}

HTTP/1.1 200 OK 

Content-Type: application/json

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "codigoRespuesta": "00",
    "mensajeRespuesta": "EXITO",
    "operacion": "listarPartner",
    "datos": [
        {
            "partner": "PARTNER1",
            "programa": "PROGRAMA1",
            "tipo": "NOMINADO",
            "urlImagen": "https://www.google.com/images/branding/googlelogo/1x/googlelogo_color_272x92dp.png"
        }
    ]
}

No autorizado

POST http://flowmanagement.vendemasdev.pe/listarPartner HTTP/1.1 

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

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "datos": {
        "tipo": "RECAUDO"
    }
}

HTTP/1.1 401 Unauthorized

Error en el servidor

POST http://flowmanagement.vendemasdev.pe/listarPartner HTTP/1.1 

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

{
    "fecha": "2019-07-15",
    "hora": "10:00:00",
    "cliente": "CLIENTE1",
    "programa": "PROGRAMA1",
    "datos": {
        "tipo": "RECAUDO"
    }
}

HTTP/1.1 500 Internal Server Error