Upnify API Docs
CRM · /ventas/:tk

Ventas

Ventas Detalles

GET/ventas/:tk

Permite obtener los detalles de una venta específica registrada en el sistema.

Parámetros

NombreTipoValidaciónDescripción
tkvarchar
tkVentaUUIDRequeridoIdentificador unico de una venta en el sistema, de la cual se requiere obtener los detalles.

Respuesta

NombreTipoDescripción
propioIntegerDefine si el registro pertenece al usuario de la sesion.
compartidoIntegerIndica si el prospecto se encuentra actualmente compartido.
compartidoConmigoIntegerIndica si el prospecto se encuentra actualmente compartido con el usuario de la sesion.
archivadoIntegerIndica si la oportunidad se encuentra archivada.
puedeCompartir=0IntegerCódigo que indica si el ejecutivo de la sesion tiene permitido compartir el prospecto.
puedeReasignar=0IntegerCódigo que indica si el ejecutivo de la sesion tiene permitido reasignar la oportunidad.
puedeDescartar=0IntegerCódigo que indica si el ejecutivo de la sesion tiene permitido descartar la oportunidad.
ventaDirecta=0IntegerCódigo que indica si el ejecutivo de la sesion tiene permitido crearle una venta directa al prospecto.
puedeArchivar=0IntegerCódigo que indica si el ejecutivo de la sesion tiene permitido archivar el prospecto.
puedeReactivar=0IntegerCódigo que indica si el ejecutivo de la sesion tiene permitido reactivar el prospecto.
puedeCrearOportunidad=0IntegerCódigo que indica si el ejecutivo de la sesion tiene permitido crearle una oportunidad al prospecto.
puedeAprobar=0IntegerCódigo que indica si el ejecutivo de la sesion tiene permitido ligar el prospecto a una empresa.
puedeRechazar=0IntegerCódigo que indica si el ejecutivo de la sesion tiene permitido rechazar la peticion de ligar el prospecto a una empresa.
puedeEtiquetar=0IntegerCódigo que indica si el ejecutivo de la sesion tiene permitido etiquetar el prospecto.
puedeDarSeguimiento=0IntegerCódigo que indica si el ejecutivo de la sesion tiene permitido dar seguimiento al prospecto.
correoValidoIntegerIndica si el correo del contacto es o no valido.
esCanalizadoIntegerAlmacena un código que define si el registro se encuentra canalizado o compartido.
esClienteIntegerDefine si el registro es o no cliente.
descartadoIntegerDefine si el registro está o no descartado.
tieneArchivosIntegerCódigo que indica si el prospecto tiene archivos asociados.
aprobacionEstadoIntegerCódigo que indica si el prospecto necesita ser aprobado por el dueño de la compañia con la cual se registró el prospecto.
movilValidoIntegerCódigo que indica si el móvil registrado ha sido validado.
tkProspectoUUIDIdentificador unico de un prospecto dentro el sistema.
contactoStringGuarda el nombre completo del prospecto, uniendo nombre y apellido.
nombreStringContiene el nombre del prospecto al cual se asocia la oportunidad.
apellidosStringContiene los apellidos del prospecto al cual se asocia la oportunidad.
fechaContactoDateTimeContiene un formato compuesto de fecha y hora, el cual indica la fecha del primer contacto con el prospecto.
tkUsuarioUUIDIdentificador de un usuario o ejecutivo del sistema.
ejecutivoNombreStringContiene el nombre del ejecutivo que atendió al prospecto.
ejecutivoInicialesStringContiene las iniciales del ejecutivo que atendío al prospecto.
ultimoContactoNombreStringContiene el nombre del ejecutivo que realizó el último contacto.
ultimoContactoInicialesStringContiene las iniciales del nombre del ejecutivo que realizó el último contacto.
ultimoContactoStringContiene una descripción breve que indica el motivo del último cotacto.
ultimoContactoFechaHoraDateTimeContiene un formato compuesto por fecha y hora que indica cuando se realizaró el último contacto con el prospecto.
tkEmpresaUUIDIdentificador unico de una empresa dentro el sistema.
empresaStringGuarda el nombre de la empresa a la que pertenece el prospecto.
tkIndustriaUUIDIdentificador unico de una industria dentro el sistema.
industriaStringIndica el nombre o descripción al tipo de industria a la que pertenece la empresa del prospecto.
tkCorporativoUUIDIdentificador unico de un corporativo dentro el sistema.
corporativoStringEn caso de existir, indica el nombre del corporativo al que pertenece la empresa del prospecto.
tkFaseUUIDIdentificador unico de a una fase de prospecto.
faseStringIndica en que fase se encuentra el prospecto.
tkOrigenUUIDIdentificador unico de un origen de prospecto.
origenStringGuarda el origen desde la cual se originó una oportunidad.
idPaisStringContiene un código que especifica el país utilizado.
paisStringContiene el nombre del país.
idEstadoStringContiene el identificador para un estado de un país.
estadoStringGuarda el nombre del estado de un país.
idMunicipioStringContiene el identificador para un municipio de un estado de un país.
municipioStringGuarda el nombre del municipio del estado de un país.
codigoPostalStringAlmacena el codigo postal el prospecto.
proximoEventoStringContiene un arreglo de datos que proporciona los datos de un evento.
compartidoConObjectContiene un arreglo de datos que proporciona los datos de ejecutivos con los que está compartido el prospecto.
etiquetasObjectArreglo de datos que contiene las etiquetas asociadas al prospecto.
tituloStringAlmacena el titulo con el que se registra el prospecto.
comentariosStringContiene un comentario que describe al prospecto.
puestoStringAlmacena el puesto que ocupa el prospecto en la empresa.
calleStringContiene el nombre o número de la calle, que forma parte de la ubicación del prospecto.
coloniaStringContiene el nombre o número de la colonia, que forma parte de la ubicación del prospecto.
ciudadStringContiene el nombre o número de la ciudad, que forma parte de la ubicación del prospecto.
fechaCanalizadoDateTimeContiene un formato de fecha que indica cuando el registro fué canalizado.
canalizoStringIndica el usuario que realizó la canalización.
canalizadoStringIndica el usuario al que se le realizó la canalización.
sexoStringGuarda el sexo que corresponde al prospecto.
correoStringEspecifica el correo del prospecto.
telefonoIntegerAlmacena el número de teléfono que pertenece al prospecto (Si tiene un valor no númerico, devolvera un String).
telefono2IntegerEn caso de existir, se guarda un número de teléfono secundario del prospecto (Si tiene un valor no númerico, devolvera un String).
movilIntegerAlmacena un número de teléfono movil del prospecto (Si tiene un valor no númerico, devolvera un String).
urlStringContiene laq url o dirección del sitio web del prospecto.
facebookStringContiene la dirección o nombre de facebook del prospecto.
twitterStringContiene la dirección o nombre de twitter del prospecto.
skypeStringContiene la dirección o nombre de skype del prospecto.
unicodeIntegerIndica el valor decimal unicode que identifica al símbolo de moneda.
monedaSimboloStringContiene el símbolo de la moneda.
separadorDecimalStringEl simbolo utilizado para separar los numeros decimales.
separadorMilStringEl simbolo utilizado para separar las milecimas de los numeros.
linkedInStringContiene la dirección o nombre de linkedin del prospecto.
googlePlusStringContiene la dirección o nombre de google plus del prospecto.
tkOportunidadUUIDIdentificador unico de una oportunidad dentro el sistema.
conceptoStringContiene un título o descripción de concepto para una oportunidad.
subtotalFloatContiene un monto monetario que indica una cantidad subtotal.
impuestosFloatContiene un monto monetario que indica la cantidad de impuestos.
descuentoFloatContiene una cantidad monetaria que indica un descuento.
descuentoProductosFloatContiene una cantidad monetaria que indica un descuento aplicado a los productos.
tkLineaUUIDCódigo toeken que corresponde a una línea de productos.
lineaProductoStringLa línea de productos donde surgió la oportunidad de venta.
tkMonedaUUIDIdentificador unico de una moneda en el sistema utilizada en la oportunidad.
monedaStringCóntiene un código que define el tipo de moneda utilizada.
tipoDeCambioFloatIndica el valor de la moneda utilizada, con respecto a la moneda nacional.
totalLetrasStringContiene la descripción del total de una cotización realizada.
totalLetrasInglesStringContiene la descripción del total en inglés de una cotización realizada.
impuestosCotizacionObjectContiene un arreglo que contiene los objetos de todos los impuesto e impuestos retenidos de la cotizacion.
folioStringContiene el folio del archivo de cotizacion de la oportunidad en caso de tenerlo.
comisionFloatAlmacena una catidad monetaria que corresponde a una comisión.
cantidadFloatContiene un monto monetario que indica una cantidad.
montoFloatAlmacena la catidad monetaria que corresponde a un monto.
comisionMontoFloatAlmacena la catidad monetaria que corresponde a una comision.
recibirCorreosIntegerIndica si el contacto recibe correos.
empresaEsClienteBooleanCódigo que indica si la empresa a la que pertenece el cliente es cliente.
cotizacionSimpleObjectObjeto que almacena la cotizacion simple
tieneProductosIntegerIndica si la oportunidad tiene productos registrados.
tkVentaUUIDCódigp token que corresponde a una venta registrada en el sistema.
ganadaFechaDateTimeContiene un formato compuesto de fecha y hora que indica cuando se completó la venta.
tiempoTranscurridoIntegerCantidad de días desde que se realizó la venta.
anticiposMontoFloatIndica una cantidad monetaria que corresponde a un anticipo.
anticiposComisionFloatContiene una cantidad monetaria que representa una comisión.
facturarIntegerCódigo que indica si la venta ya ha sido facturada.
referenciaStringContiene un comentario referente a la venta.
porcentajeComisionFloatContiene un porcentaje que corresponde a la comisión ganada.
fechaCierreVentaDateTimeContiene un formato compuesto de fecha y hora que indica cuando se finalizó la venta.
fechaUltimoPagoVentaDateTimeContiene un formato compuesto de fecha y hora que indica cuando se realizó el último pago de una venta a plazos.
fechaProximoPagoVentaDateTimeContiene un formato compuesto de fecha y hora que indica cuando se realizará el próximo pago de una venta a plazos.
cp1StringContiene el valor del primer campo personalizado para prospectos, el cual es establecido por el usuario.
cp100StringContiene el valor del centésimo campo personalizado para prospectos, el cual es establecido por el usuario.
cp1oStringContiene el valor del primer campo personalizado para oportunidades, el cual es establecido por el usuario.
cp100oStringContiene el valor del centésimo campo personalizado para oportunidades, el cual es establecido por el usuario.
cp1eStringContiene el valor del primer campo personalizado para empresas, el cual es establecido por el usuario.
cp60eStringContiene el valor del sexagésimo campo personalizado para empresas, el cual es establecido por el usuario.
utmDateStringContiene el valor para el rastreo de las campañas, el cual es establecido por el usuario.
utmReferrerStringContiene el valor para el rastreo de las campañas, el cual es establecido por el usuario.