Upnify API Docs
CRM · /ventas

Ventas

Ventas Lista

GET/ventas

Permite obtener la lista de las ventas registradas en el sistema.

Parámetros

NombreTipoValidaciónDescripción
aprobacionEstadointegerIndica el status de asignacion de contacto a compania.
  • 0 Aprobado.
  • 1 Pendiente.
  • 2 Rechazado.
canalizadointegerIndica si el contacto ha sido canalizado.
  • 0 No canalizado.
  • 1 Canalizado.
compartidointegerIndica si el contacto ha sido compartido.
  • 0 No compartido.
  • 1 Compartido.
tkUsuariostringPermite filtrar los registros por un usuario en particular.
tkGrupostringPermite filtrar los registros por un grupo en particular.
tkIndustriastringPermite filtrar los registros por una industria en particular.
tkEtiquetastringPermite filtrar los registros por una etiqueta en particular.
tkFasestringPermite filtrar los registros por una fase en particular.
tkOrigenstringPermite filtrar los registros por un origen en particular.
tkCorporativostringPermite filtrar los registros por un corporativo en particular.
idPaisstringPermite filtrar los registros por un país en particular.
idEstadostringPermite filtrar los registros por un estado/región en particular.
sexostringPermite filtrar los registros por un genero en particular.
  • H Hombre.
  • M Mujer.
puestostringPermite filtrar los registros por un puesto en particular.
textostringPermite filtrar los registros por un texto en particular.
periodostringPermite filtrar los registros por fecha de creación.
periodoUltimoContactostringPermite filtrar los registros por fecha de último seguimiento.
tkMonedastringPermite filtrar los registros por una moneda en particular.
tkLineastringPermite filtrar los registros por una linea en particular.
camposAdicionalesintegerEnvíe un 1 si dedea que la respuesta devuelva campos personalizados de Prospectos y Oportunidades.

Respuesta

NombreTipoDescripción
indiceIntegerDefine la posición del registro respecto a los demás registros.
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 unico 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 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.
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.
tieneProductosIntegerIndica si la oportunidad tiene productos registrados.
cotizacionSimpleObjectObjeto que almacena la cotizacion simple
tkVentaUUIDIdentificador unico de 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.
empresaEsClienteBooleanCódigo que indica si la empresa a la que pertenece el cliente es cliente.