Contrato para crear comprometidos desde Televentas

Header
URL: http://10.181.3.106/despachos/apis/RestDespachos.php/comprometerTeleventas
Formato de solicitud: JSON
Formato de respuesta: JSON (depende del estado Http)
Método: POST
Autenticación necesaria: No

Atributos
SOLICITUD

Atributo Descripción Tipo Tamaño Mandatorio

aplicacionOrigen Valor fijo “Televentas” Alfanumérico Longitud mínima Si
es 10 caracteres
pedido Numero de pedido en Alfanumérico Longitud mínima Si
CRM es un carácter
fechaHora Fecha del proceso Alfanumérico Longitud mínima Si
AAAA-MM-DD HH:MM:SS es un carácter
unidadVenta Unidad de negocio de Alfanumérico Longitud mínima Si
venta es un carácter
idUsuario Id de identificación del Alfanumérico Longitud mínima Si
usuario/asesor/vendedor es un carácter
datosFactura Datos del cliente a Objeto Si
facturar
datosDespacho Datos para el despacho Objeto Si
articulos Detalle de los eanes Array de Si
Objetos

Atributo datosFactura
Atributo Descripción Tipo Tamaño Mandatorio
tipoDocumento Tipo de Documento del Alfanumérico Longitud mínima Si
Cliente, Valores es un carácter
aceptados: “C”(cedula);
“N”(NIT); “O”(Otros)
identificacion Número de identificación Alfanumérico Longitud mínima Si
del cliente es un carácter
primerNombre Primer nombre Alfanumérico Longitud mínima Si
es un carácter
segundoNombre Segundo nombre Alfanumérico Longitud mínima No
es un carácter
 primerApellido Primer apellido Alfanumérico Longitud mínima No
es un carácter
segundoApellido Segundo apellido Alfanumérico Longitud mínima No
es un carácter
telefono Teléfono Alfanumérico Longitud mínima Si
es un carácter
celular Celular Alfanumérico Longitud mínima Si
es un carácter
email Email Alfanumérico Longitud mínima Si
es un carácter
ciudad Código de la ciudad Alfanumérico Longitud mínima Si
es un carácter
barrio Código barrio Alfanumérico Longitud mínima Si
es un carácter
direccion Dirección Alfanumérico Longitud mínima Si
es un carácter

Atributo datosDespacho
Atributo Descripción Tipo Tamaño Mandatorio
tipoDocumento Tipo de Documento del Alfanumérico Longitud mínima Si
Cliente, Valores es un carácter
aceptados: “C”(cedula);
“N”(NIT); “O”(Otros)
identificacion Número de identificación Alfanumérico Longitud mínima Si
del cliente es un carácter
primerNombre Primer nombre Alfanumérico Longitud mínima Si
es un carácter
segundoNombre Segundo nombre Alfanumérico Longitud mínima No
es un carácter
primerApellido Primer apellido Alfanumérico Longitud mínima No
es un carácter
segundoApellido Segundo apellido Alfanumérico Longitud mínima No
es un carácter
telefono Teléfono - Celular Alfanumérico Longitud mínima Si
es un carácter
ciudad Código de la ciudad Alfanumérico Longitud mínima Si
es un carácter
barrio Código barrio Alfanumérico Longitud mínima Si
es un carácter
direccion Dirección Alfanumérico Longitud mínima Si
es un carácter
fechaEnvio AAAAMMDD Alfanumérico Longitud mínima Si
es 8 caracteres
fechaEntrega AAAAMMDD Alfanumérico Longitud mínima Si
es 8 caracteres
flagRecoge 1 = recoge en punto Alfanumérico Longitud mínima Si
2 = recoge en tienda es un carácter
 agenciaRecoge Unidad de negocio para Alfanumérico Longitud mínima Si
recogida es un carácter
observaciones Agrupamiento de horario Alfanumérico Longitud mínima Si
y datos del cliente es un carácter
sitidata Datos de Sitidata Objeto Si

Atributo sitidata
Atributo Descripción Tipo Tamaño Mandatorio
ck_directrad ck_directrad Alfanumérico Es posible enviar en Si
null o espacios
ck_validacion ck_validacion Alfanumérico Es posible enviar en Si
null o espacios
ck_valida_placa ck_valida_placa Alfanumérico Es posible enviar en Si
null o espacios
ck_esambigua ck_esambigua Alfanumérico Es posible enviar en Si
null o espacios
ck_fuente2 ck_fuente2 Alfanumérico Es posible enviar en Si
null o espacios
ck_diralterna ck_diralterna Alfanumérico Es posible enviar en Si
null o espacios
ck_barriotraducido ck_barriotraducido Alfanumérico Es posible enviar en Si
null o espacios
ck_codigodireccion ck_codigodireccion Alfanumérico Es posible enviar en Si
null o espacios
ck_coddirplaca ck_coddirplaca Alfanumérico Es posible enviar en Si
null o espacios
ck_nivsocio ck_nivsocio Alfanumérico Es posible enviar en Si
null o espacios
ck_manzana ck_manzana Alfanumérico Es posible enviar en Si
null o espacios
ck_barrio1 ck_barrio1 Alfanumérico Es posible enviar en Si
null o espacios
ck_codbar ck_codbar Alfanumérico Es posible enviar en Si
null o espacios
ck_localidad1 ck_localidad1 Alfanumérico Es posible enviar en Si
null o espacios
ck_cx2 ck_cx2 Alfanumérico Es posible enviar en Si
null o espacios
ck_cy2 ck_cy2 Alfanumérico Es posible enviar en Si
null o espacios
ck_barrio_people ck_barrio_people Alfanumérico Es posible enviar en Si
null o espacios
ck_estado3 ck_estado3 Alfanumérico Es posible enviar en Si
null o espacios
mensaje mensaje Alfanumérico Es posible enviar en Si
null o espacios
Atributo articulos
Atributo Descripción Tipo Tamaño Mandatorio
tipo Valores aceptados: Alfanumérico Longitud mínima Si
“END”(Envió directo); es un carácter
“PS”(Inventario en PS);
“PREVTA”(Pre venta);
“NOINV”(No
inventariable)
ean Ean Alfanumérico Longitud mínima Si
es un carácter
cantidad Cantidad Alfanumérico Longitud mínima Si
es un carácter
bodegaDespacho Unidad de negocio o Alfanumérico Longitud mínima No
bodega de despacho es un carácter
Es mandatorio para tipo
PS, PREVTA y END
precioVenta Precio de venta Alfanumérico Longitud mínima Si
es un carácter
Ejemplo
{
"aplicacionOrigen":"Televentas",
"pedido":"1234567",
"fechaHora":"2019-05-06 17:02:15",
"unidadVenta":"AKB68",
"idUsuario":"23614654989",
"datosFactura":{
"tipoDocumento":"C",
"identificacion":"11205634",
"primerNombre":" primerNombreFactura",
"segundoNombre":" segundoNombreFactura ",
"primerApellido":" primerApellidoFactura ",
"segundoApellido":" segundoApellidoFactura ",
"telefono":"3111111111",
"celular":"3111111111",
"email":"prueba@correo.com",
"ciudad":"11001",
"barrio":"000173",
"direccion":"CL 25 B # 69 C - 80 BOGOTA CUNDINAMARCA COLOMBIA"
},
"datosDespacho":{
"tipoDocumento":"C",
"identificacion":"11205634",
"primerNombre":" primerNombreDespacho ",
"segundoNombre":" segundoNombreDespacho ",
"primerApellido":" primerApellidoDespacho ",
"segundoApellido":" segundoApellidoDespacho ",
"telefono":"3111111111",
"ciudad":"11001",
"barrio":"000207",
"direccion":"CL 25 B # 69 C - 80 BOGOTA CUNDINAMARCA COLOMBIA",
"fechaEnvio":"20191014",
"fechaEntrega":"20191016",
"flagRecoge":"2",
"agenciaRecoge":"AKB68",
"observaciones":"J0-3165275592 - jhon navarro - 11205634",
"sitidata":{
"ck_directrad":" CL 25 B # 69 C - 80",
"ck_validacion":"",
"ck_valida_placa":"",
"ck_esambigua":"",
"ck_fuente2":"",
"ck_diralterna":"",
"ck_barriotraducido":"",
"ck_codigodireccion":"",
"ck_coddirplaca":"",
"ck_nivsocio":"",
"ck_manzana":"",
 "ck_barrio1":"",
"ck_codbar":"",
"ck_localidad1":"",
"ck_cx2":"",
"ck_cy2":"",
"ck_barrio_people":"",
"ck_estado3":"",
"mensaje":""
}
},
"articulos":[
{
"tipo":"END",
"ean":"123456",
"cantidad":"2",
"bodegaDespacho":"KTINT",
"precioVenta":"120000"
},
{
"tipo":"PS",
"ean":"1234567",
"cantidad":"2",
"bodegaDespacho":"KTINT",
"precioVenta":"120000"
},
{
"tipo":"PREVTA",
"ean":"12345678",
"cantidad":"2",
"bodegaDespacho":"KTINT",
"precioVenta":"120000"
},
{
"tipo":"NOINV",
"ean":"12345679",
"cantidad":"2",
"bodegaDespacho":"",
"precioVenta":"120000"
}
]
}
RESPUESTA (HTTP STATUS 200: OK)

Atributo Descripción Tipo Tamaño Mandatorio

code Status 200 Numérico 3 caracteres Si
description Descripción Alfanumérico Longitud mínima Si
es un carácter
data Numero de Alfanumérico Longitud mínima Si
comprometido es un carácter

Ejemplo
{
"code": 200,
"description": "Se genera comprometido numero 0000011215",
"data": "0000011215"
}

RESPUESTA (HTTP STATUS 400: BAD REQUEST)

Atributo Descripción Tipo Tamaño Mandatorio

code Status 400 Numérico 3 caracteres Si
description Detalle del error Alfanumérico Longitud mínima Si
es un carácter
data Objeto Si

Ejemplo (Pendiente confirmar)

{
"code": 400,
"description": " Detalle del error ",
"data": []
}