Saltar al contenido principal
Documentación
Documentación
Administrator Guide
Última actualización: 2025-09-19
Concepto: servicios web de oferta de CPQ

Concepto: servicios web de oferta de CPQ

Para crear una oferta totalmente funcional a través de la API de SOAP, utilice las siguientes operaciones de servicio web:
  1. Envío de servicios y líneas de oferta
  2. Envío de estructura de desglose de trabajo de oferta
  3. Envío de asignaciones de oferta
Le recomendamos que utilice la versión más reciente de los servicios web.

Tarea de interfaz de usuario (IU) de Workday equivalente

Creación de oferta
.

Proceso de gestión utilizado por este servicio web

Proceso de gestión
Evento de oferta

Obtención y envío de líneas y servicios de oferta

Estas operaciones le permiten recuperar, crear, editar o cambiar una oferta. Tenga en cuenta que:
  • Es obligatorio introducir un motivo de cambio de oferta para editar una oferta aprobada.
  • Puede utilizar la operación de servicio web para trabajar en los siguientes objetos de oferta:
    • Cabecera de oferta
    • Servicios
    • Líneas para rol, ítems, gastos, descuentos y costos de terceros.
  • Debe definir la
    estimación de dedicación
     para un servicio.
  • Cuando el servicio tiene fases o fases y tareas, puede añadir o actualizar líneas de rol después de añadir la estructura de desglose de trabajo de fases y tareas mediante la operación de servicio web
    Submit Quote Work Breakdown Structure
     .
  • Durante la creación de la oferta inicial, Workday ignora todas las asignaciones de roles. Utilice la operación de servicio web
    Envío de asignaciones de oferta
     para añadir asignaciones.
  • Cuando edita una oferta y excluye algunos servicios de oferta y líneas de oferta, Workday elimina esos servicios y líneas de oferta.
  • Debe especificar los valores de precio unitario y costo por unidad que coincidan con los valores de la hoja de tarifas de facturación de proyecto.
  • No puede crear una oferta cuando la oportunidad asociada tiene un
    error
    .

Operaciones de servicio web de estructura de desglose de trabajo de obtención y envío

Esta operación de servicio web solo le permite añadir o editar fases y tareas. Tenga en cuenta que:
  • No puede utilizar esta operación de servicio web para:
    • Cree una nueva oferta.
    • Cambie cualquier servicio de oferta o datos de cabecera de oferta.
    • Edite un servicio
      de nivel superior,
       ya que no tiene fases ni tareas.
    • Añada datos de tarea cuando el servicio
      Estimación de dedicación
       sea
      Con fases
      .
  • La
    fecha inicial
     del servicio de oferta se ajusta en función de la fecha inicial de la fase o tarea.
  • La
    fecha final
     del servicio de oferta se ajusta en función de la fecha final de la fase o tarea.
  • La
    fecha inicial de
     la fase debe ser igual a la primera
    fecha inicial
    de la tarea .

Operaciones de servicio web de obtención y envío de asignaciones de oferta

Esta operación de servicio web solo le permite añadir o editar asignaciones de rol y fechas de ítem para todos los tipos de servicio. Tenga en cuenta que:
  • No puede utilizar esta operación de servicio web para:
    • Cree una nueva oferta.
    • Cambie cualquier servicio de oferta o datos de cabecera de oferta.
    • Edite fases y tareas.
  • Puede utilizar valores de cantidad o de ETC para las asignaciones. Cuando carga ambos valores, Workday utiliza los valores de ETC para actualizar las asignaciones.
  • Cuando envía asignaciones con fechas iniciales y finales que se solapan con asignaciones existentes que tienen diferentes ETC, Workday crea nuevas asignaciones con nuevos valores de ETC y la asignación existente se divide pero conserva su ETC.
  • Workday no divide automáticamente las asignaciones de rol de manera uniforme entre fases o tareas. Debe especificar las asignaciones de rol manualmente.

Security

Las operaciones del servicio web GET están protegidas en los siguientes dominios en el área funcional Services CPQ:
  • Servicios web iLoad
  • Proceso: ofertas
  • Servicios web especiales de OX
Las operaciones del servicio web Submit están protegidas para:
  • Servicios web iLoad
  • Proceso de gestión de evento de oferta
  • Servicios web especiales de OX
  • Consultar: jerarquías de proyectos de oferta

Consejos para rellenar su solicitud

Utilice una solicitud GET para una oferta existente para obtener una estructura de carga útil y, a continuación, utilice la información recuperada para crear o actualizar una oferta existente.

Limitaciones

Al utilizar las operaciones de servicio web:
  • No puede editar la fecha inicial de oferta de una oferta existente, pero la fecha puede cambiar cuando cambia la fecha inicial de servicio.
  • No puede cambiar los valores totales de los campos
    Precio
    ,
    Margen
    o
    Descuento
     en los niveles de servicio y oferta.
  • No puede crear un servicio añadiendo un ítem de catálogo de servicios.

Pautas para la recuperación de una carga incorrecta

Cuando cargue entradas incorrectas, acceda a una de estas tareas:
  • Cancelación masiva de procesos de gestión
     cuando el evento de proceso de gestión todavía está en curso.
  • Anulación masiva de procesos de gestión
     cuando finalice el evento de proceso de gestión.
  • Seguridad: dominio
    Business Process Administrator
     en el área funcional System.
Después de cancelar o anular los eventos, vuelva a ejecutar las solicitudes de servicio web.

Ejemplo

Consulte los archivos XML de muestra:
  • Envío de servicios y líneas de oferta v45.0
  • Envío de estructura de desglose de trabajo de oferta v45.0
  • Envío de asignaciones de oferta