Pedido Tracking Lead

API para registro de pedido de compra en base a la información de un lead
Operaciones

La api tendrá el siguiente método para registrar pedidos

POST /v1/pedido/registrarPedidoLead
Registrar Pedido Lead
POST /v1/pedido/registrarPedidoLead

Registra un pedido proveniente de un lead

El endpoint será el siguiente

https://api-tracking.qa.vmas.com.pe/v1/pedido/registrarPedidoLead

Las credenciales serán a través de basic autentication Usuario : usr_test
Clave : ftw23vt14

Request body

application/json

Estructura de registro de pedido

Examples
{
    "idLeadReferencia": "619",
    "idTipoProducto": "2",
    "sku": "poketprovm",
    "idTipoVenta": "1",
    "idCanal": "13",
    "codigoComercio": "43552314",
    "nombreComercio": "Empresa",
    "codSegmento": "1",
    "procedencia": "2",
    "tipoDocIdent": "1",
    "dni": "123456789",
    "tipoPago": "VENDEMAS PAGOLINK 197",
    "nombreUsuario": "Jose Perez",
    "telefonoUsuario": "999999999",
    "nombreContacto": "Jose Perez",
    "telefonoContacto": "999999999",
    "departamento": "Lima",
    "provincia": "Lima",
    "distrito": "Chorrillos",
    "codDep": "15",
    "codProv": "1501",
    "codDist": "150108",
    "nombreVia": "Calle Los Bazares",
    "numeroVia": "123",
    "referencia": "Espalda de fábrica",
    "estado": "1",
    "tipoDocumentoPago": "1",
    "rucComercio": "10123456781",
    "razonSocial": "Empresa Test S.A.C.",
    "direccionFiscal": "Av. Los Jazmines 311",
    "emailRepresentante": "correo@gmail.com",
    "cantidadItems": "2",
    "monto": "394",
    "idVisanet": "1241414535434141",
    "codRecaudo": "232132"
}

Responses

200 200

Pedido registrado satisfactoriamente.

Body
application/json;charset=UTF-8
Examples

Pedido registrado satisfactoriamente, el “idEstado” será “0” si fue un prospecto o “1” si fue una venta ya concretada, en caso de haber error en registro se devolverá una descripción en el parámetro “descripción” error y el “idPedido” será -1

{
    "idPedido": "2134",
    "idEstado": "1",
    "descripcionError": ""
}
401 401

No permitido.

Body
application/json;charset=UTF-8

Credenciales no válidas

Estructuras de Entrada y Salida

Las estructuras de entrada y salida de la petición son las siguientes:

PedidoRequest

Estructura de petición de pedido para registrar

Object
idLeadReferencia
string required

Vendemas enviará al call los leads, el call al tener el identificador del lead, debe enviarlo al registro de pedido para tener la traza completa

idTipoProducto
string required

Listado de productos de Vendemas

Enumeration:
1

POKET

2

POKET PRO

4

VENDEMAS FULL

5

CONTOMETRO X10

6

CONTOMETRO X20

sku
string

Listado de SKUs aceptados

Enumeration:
poketvm

Poket de Vendemas

poketvn

Poket de Niubiz

poketprovm

Poket Pro de Vendemas

poketprovmblack

Poket Pro de Vendemas Color Negro

poketprovmkit

Poket Pro de Vendemas con Kit

poketprovn

Poket Pro de Niubiz

fullvm

Poket Full Vendemas

fullvn

Poket Full Niubiz

fullct-10

Paquete de contómetros (x10)

fullct-20

Paquete de Contómetros (x20)

poketbbva

Poket de BBVA por oferta

poketprobbva

Poket Pro de BBVA por oferta

poketpaneton

Poket + panetón (temporada de Navidad)

poketpavo

Poket + pavo (temporada de Navidad)

propaneton

Poket Pro + panetón (temporada de Navidad)

propavo

Poket Pro + pavo (temporada de Navidad)

fullpaneton

Poket Full + panetón (temporada de Navidad)

fullpavo

Poket Full + pavo (temporada de Navidad)

idTipoVenta
string required

Listado de tipo de venta

Enumeration:
1

ESTANDAR

2

EXPRESS

20

OTROS

idCanal
string required

Listado de canales, para el desarrollo todos los de LeadManager enviar el valor 4

Enumeration:
3

Call Center Retenciones

4

Click to call

6

Whatsapp

7

Call Inbound

8

BCP y Alianzas

9

Banbif

10

Call Outbound

12

BBVA

13

Caja Arequipa

14

Scotiabank

15

Banco Pichincha

16

Caja Ica

codigoComercio
string

Código del comercio si es que ya existe en la base de datos del backend Vendemás

nombreComercio
string

Nombre del comercio si es que ya existe en la base de datos del backend Vendemás

codSegmento
string

Listado de segmentos

Enumeration:
5

BANCOS

6

SCC

7

DIGITEX NIUBIZ

8

DIGITEX VENDEMAS

9

BPO

procedencia
string required

Listado de procedencias, para las que vienen de leadmanager colocar el valor 10

Enumeration:
1

OTROS

2

Lead Landing

3

Lead Manya

4

Lead Interbank

5

Lead Referidos

6

Call In

7

Web Vendemas

8

Retencion Visanet

9

Venta FB

10

VENDEMAS

11

VISANET-NIUBIZ

12

No Aplica

tipoDocIdent
string required

Tipos de documento

Enumeration:
1

DNI

2

Carnet Extranjeria

dni
string

Número del doc de identidad sea DNI de Perú o Carnet de extranjeria (obligatorio si es boleta)

tipoPago
string required

Se adjunta una lista aparte el formato es por ejemplo VENDEMAS PAGOLINK 197 o VISANET CONTRAENTREGA 99, esta lista es cambiante por parte del Área de producto de Vendemas y Niubiz, la cual coordinará con TI-Vendemas y con el call para estar alineados en el listado

nombreUsuario
string required

La api soporta datos de usuario diferentes para el que compró y del que recibirá, pero para el caso de un lead puede mandarse nombreUsuario = nombreContacto, y telefonoUsuario=telefonoContacto

telefonoUsuario
string required

Telefono del usuario

nombreContacto
string required

Nombde del contacto

telefonoContacto
string required

Telefono del contacto

departamento
string required

El nombre tal cual estará en un excel adjunto

provincia
string required

El nombre tal cual estará en un excel adjunto

distrito
string required

El nombre tal cual estará en un excel adjunto

codDep
string required

Ejemplo Ubigeo 010605 :Departamento -> Amazonas:1,Provincia -> Rodriguez de Mendoza:106,Distrito -> Limabamba: 10605;Ejemplo Ubigeo 150108,Departamento -> Lima:15,Provincia -> Lima:1501,Distrito -> Chorrillos:150108

codProv
string required

Tomar como referencia codDep para informacion

codDist
string required

Tomar como referencia codDep para informacion

nombreVia
string required

Direccion para la entrega

numeroVia
string

Puede incluirse como parte de la direccion

referencia
string

Es preferible para facilitar entrega del pedido

estado
string required

1: si es una venta confirmada, 0: si es un prospecto

tipoDocumentoPago
string required

1: Factura / 2: Boleta

Enumeration:
1

Factura

2

Boleta

rucComercio
string

Obligatorio si es factura

razonSocial
string

Obligatorio si es factura

direccionFiscal
string

Direccion fiscal para la factura, obligatorio si es factura

emailRepresentante
string required

Email para el contacto, por lo general es email del representante legal del negocio

cantidadItems
string required

Total de items del producto

monto
string required

Con formato de punto decimal, sin separador de miles

idVisanet
string

Identificador de la transacción de compra con tarjeta realizada a través de un ecommerce o de un Pagolink

codRecaudo
string

Esto es cuando el tipo de pago tiene asociado un codigo de recaudo como el PAGOLINK, es un codigo de 6 digitos

PedidoResponse

Estructura de la respuesta al registrar pedido

Object
idPedido
string

Id del pedido generado en tracking, -1 si no se registró

idEstado
string

Listado de estados

Enumeration:
0

Prospecto

1

Venta asegurada

-1

No se registró nada

descripcionError
string

Mensaje en caso de que hubiese un error al registrar, vacio si no ocurrieron errores