Upnify API Docs
CRM · /ventas

Ventas

Venta - Directa

POST/ventas

Permite crear una venta directa a un contacto

Parámetros

NombreTipoValidaciónDescripción
tkProspectoUUIDRequeridoCódigo token del prospecto al que se agregará la venta.
tkFaseUUIDRequeridoCódigo token que identificade forma única a una fase en el sistema.
tkLineaProductoUUIDRequeridoCódigo token que identificade forma única a una línea de productos en el sistema.
tkMonedaUUIDRequeridoCódigo token que identificade forma única a un tipo de moneda en el sistema.
tkCertezaUUIDRequeridoCódigo token que identificade forma única a una certeza en el sistema.
conceptoStringRequeridoIdentifica el concepto de la oportunidad.
cantidadFloatRequeridoIdentifica la cantidad de productos/servicios de la venta.
referenciaStringRequeridoIdentifica el motivo de la venta.
fechaCierreVentaDateTimeRequeridoContiene un formato compuesto por fecha y hora que indica cuando se realizó la venta.
montoFloatRequeridoCantidad monetaria con la que se generará la venta.
anticiposMontoFloatRequeridoCantidad monetaria que indica el monto que estan pagando de la venta.
anticiposComisionFloatRequeridoCantidad monetaria que indica el monto que estan pagando de la comision de la venta.
comisionFloatRequeridoIndica una cantidad de comision con base 1, (donde 1 es el 100%)por el la venta.
comisionMontoFloatRequeridoCantidad monetaria que indica el monto total de comisión por la venta.
saldoMontoFloatRequeridoCantidad monetaría que identifica el saldo pendiente de la venta.
saldoComisionFloatRequeridoCantidad monetaría que identifica el saldo pendiente de la comisión por la venta.
productosObjectRequeridoArreglo de datos en las que se agregan los productos relacionados a la venta.
pagosObjectRequeridoArreglo de datos en las que se agregan los pagos relacionados a la venta.
tipoDeCambioFloatRequeridoIndica el tipo de cambio con el que se generará la venta.
tipoComisionIntegerRequeridoIndica la forma en la que se pagarán las comisiones.
parcialidadesIntegerRequeridoIndica el numero de parcialidades en las que se liquidará la venta.
periodicidadIntegerRequeridoIndica la forma en la que se realizaran los pagos de la venta
montoPagadoFloatRequeridoIndica el monto que se esta pagando de la venta.
descuentoFloatRequeridoIndica la cantidad monetaria del descuento realizado a la venta.
descuentoPctFloatRequeridoAlmacena un valor con base 1, donde 1 es el 100%. Este valor indica el porcentaje del descuento.
subtotalFloatRequeridoAlmacena una cantidad monetaria que indica el subtotal de la venta.
impuestosFloatRequeridoAlmacena una cantidad monetaria que indica el monto total de los impuestos trasladados de la venta.
impuestosRetenidosFloatRequeridoAlmacena una cantidad monetaria que indica el monto total de los impuestos retenidos de la venta.

Solicitud

Ejemplo de parámetros

{
    "tkProspecto":"P-4D0BB887-9C91-48D0-AFC9-D7F4EB7F43B2",
    "tkMoneda":"MON-0D2015D1-8361-4FC8-9FF4-638F7670F9B0",
    "tkCerteza":"CER-EB31C64E-B483-4268-9082-1F41F6323DB0",
    "tkLinea":"LINP-C58B1E64-C9CD-48EA-BD64-F77E48528AA5",
    "tkFase":"OFAS-FFA76DB2-C58F-4ADF-99A4-88EFB4BA6E7F",
    "concepto":"Concepto de venta",
    "cantidad":1,
    "referencia":"Convertir a venta",
    "fechaCierreVenta":"2020-05-16",
    "monto":100,
    "anticiposMonto":100,
    "anticiposComision":0,
    "comision":0,
    "comisionMonto":0,
    "saldoMonto":0,
    "saldoComision":0,
    "productos":0,
    "pagos":[{"parcialidad":1,"fecha":"2020-06-15","monto":100,"comision":0,"pagado":0,"referencia":"primer pago"}],
    "tipoDeCambio":1,
    "tipoComision":0,
    "parcialidades":1,
    "periodicidad":0,
    "montoPagado":100,
    "descuento":0,
    "descuentoPct":0,
    "subtotal":100,
    "impuestos":0,
    "impuestosRetenidos":0,
    "indiceComision":0
}