Upnify API Docs
CRM · /oportunidades/:tk

Oportunidades

Modificación

PUT/oportunidades/:tk

Permite modificar los datos de una oportunidad específica.

Parámetros

NombreTipoValidaciónDescripción
tkOportunidadUUIDRequeridoEl código token que identifica a una oportunidad de manera única dentro del CRM, la cual se requiere modificar.
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.
cierreEstimadoDatetimeRequeridoContiene un formato compuesto de fecha y hora que indica la fecha estimada en la que se concretará la oportunidad.
montoFloatRequeridoAlmacena una cantidad monetaria que indica el monto de la oportunidad.
cantidadFloatRequeridoAlmacena la cantidad total de productos vendidos.
subtotalFloatRequeridoAlmacena una cantidad monetaria que indica el subtotal de la oportunidad.
comisionFloatRequeridoAlmacena un valor con base 1, donde 1 es el 100%. Este valor indica el porcentaje de una comisión.
comisionMontoFloatRequeridoIndica la cantidad monetaria de la comisión.
descuentoFloatRequeridoIndica la cantidad monetaria del descuento realizado a la oportunidad.
descuentoPctFloatRequeridoAlmacena un valor con base 1, donde 1 es el 100%. Este valor indica el porcentaje del descuento.
impuestosFloatRequeridoAlmacena una cantidad monetaria que indica el monto total de los impuestos trasladados de la oportunidad.
impuestosRetenidosFloatRequeridoAlmacena una cantidad monetaria que indica el monto total de los impuestos retenidos de la oportunidad.
productosObjectRequeridoArreglo de datos en las que se agregan los productos relacionados a la oportunidad.

Solicitud

Ejemplo de parámetros

{
    "tkFase": "OFAS-FFA76DB2-C58F-4ADF-99A4-88EFB4BA6E7F",
    "tkLineaProducto": "LINP-C58B1E64-C9CD-48EA-BD64-F77E48528AA5",
    "tkMoneda": "MON-0D2015D1-8361-4FC8-9FF4-638F7670F9B0",
    "tkCerteza": "CER-EB31C64E-B483-4268-9082-1F41F6323DB0",
    "concepto":"Oportunidad de prueba",
    "cierreEstimado": "2018-04-11",
    "monto": 1567.18,
    "cantidad": 2,
    "subtotal": 1567.18,
    "comision": 0.3,
    "comisionMonto": 156.718,
    "descuento": 0,
    "descuentoPct": 0,
    "impuestos": 0,
    "impuestosRetenidos":0,
    "productos": [
        {
            "orden": 1,
            "tkProducto": "PRO-FE07F662-638C-4DE6-B84A-0F618647DFC9",
            "nombre": "__test__hu9ql9saqvlp",
            "tkListaPrecio": "LIS-F229787C-57F1-4902-8D2C-6A972DEE77D2",
            "comentario": "comentario para producto",
            "fechaInicio": "2020-03-01",
            "fechaFin": "2020-03-31",
            "noches": 31,
            "cantidad": 3,
            "precio": 860,
            "descuentoUnitario": 50,
            "descuento": 150,
            "descuentoPct": 0.0581395348837209,
            "subtotal": 2430.00,
            "total": 2430.00,
            "comisionMonto": 0,
            "impuesto1": 388.80,
            "impuesto2": 1701.00,
            "impuesto3": 0,
            "impuesto4": 0,
            "impuesto5": 0,
            "impuesto6": 0,
            "impuesto7": 0,
            "impuesto8": 0,
            "impuesto9": 0,
            "impuesto10": 0,
            "impuestoRetenido1": 0,
            "impuestoRetenido2": 0,
            "impuestoRetenido3": 0,
            "impuestoRetenido4": 0,
            "impuestoRetenido5": 0,
            "impuestoRetenido6": 0,
            "impuestoRetenido7": 0,
            "impuestoRetenido8": 0,
            "impuestoRetenido9": 0,
            "impuestoRetenido10": 0
        }
    ]
}