Menú
Feedback
Problemas conocidos
La descripción de los elementos de la factura en los paquetes se sobrescribe en función de la regla invoiceValue (reconstrucción de pedidos/OMS GET Order)
Order Management
ID: 1330069
Backlog
Publicado el25/11/2025
Última actualización el25/11/2025
2 min de lectura

Este problema conocido ha sido traducido automáticamente del inglés.

Sumario

Al enviar una factura a través de la API de notificación de facturas de pedidos con items[].description personalizados, es posible que la descripción mostrada posteriormente en GET Order (packages.items[].description) se sustituya por el nombre del producto. El síntoma visible es que algunos pedidos muestran el nombre del producto en lugar de la descripción personalizada proporcionada en la carga útil de la factura. Esto afecta a los consumidores de OMS/pedidos que dependen de las descripciones de packages.items para la conciliación logística, fiscal o ERP, especialmente cuando invoiceValue es igual o superior al valor total del pedido. El departamento de ingeniería ha confirmado que se trata de un comportamiento antiguo relacionado con la reconstrucción de pedidos GET, no de una interrupción transitoria.

Simulación

  • Requisitos previos:
    • Un pedido listo para recibir una factura.
    • Posibilidad de enviar la factura por POST a la API de notificación de facturas de pedidos y posteriormente obtener el pedido de la API de OMS.

Pasos:

  1. Enviar una factura POST con artículos y una descripción personalizada por artículo (por ejemplo, items[].description = "1010").

  2. Caso A: Establecer invoiceValue mayor o igual que el valor total del pedido. Una vez procesada la factura, llame a GET /api/oms/pvt/orders/{orderId}. Observe que packages.items[].description se reconstruye como el nombre del artículo (sobrescribe la descripción personalizada).

  3. Caso B: Establecer invoiceValue menor que el valor total del pedido. Tras el procesamiento, llame a GET /api/oms/pvt/orders/{orderId}. Observe que se conservan los elementos originales de la factura enviada, incluida la descripción personalizada que envió.

  4. Si omite la descripción por completo en los artículos de la factura, GET Order mostrará packages.items[].description autocompletado con el nombre del producto.

  • Notas:
    • La ingeniería destacó que esta reconstrucción ocurre en cada GET Order y está respaldada por pruebas existentes que validan el comportamiento replace-when-invoiceValue>=order.Value.

Workaround

provisional N/A

%0A

Contribuidores
1
Photo of the contributor
+ 1 contributors
¿Te ha parecido útil?
No
Sugerir cambios (GitHub)
Contribuidores
1
Photo of the contributor
+ 1 contributors
En esta página
¿Tienes otras preguntas?
Pregunta a la comunidad
Encuentra soluciones y comparte ideas en VTEX Community
Únete a nuestra comunidad
Solicita soporte a VTEX
Recibe asistencia personalizada de nuestros especialistas
Abre un ticket de soporte
GitHubDeveloper PortalComunidadFeedback