{"section":"known-issues","requestedLocale":"pt","requestedSlug":"descricao-dos-itens-da-fatura-em-pacotes-sobrescritos-com-base-na-regra-invoicevalue-reconstrucao-de-pedidosoms-get-order","locale":"pt","slug":"descricao-dos-itens-da-fatura-em-pacotes-sobrescritos-com-base-na-regra-invoicevalue-reconstrucao-de-pedidosoms-get-order","path":"docs/pt/known-issues/Order Management/descricao-dos-itens-da-fatura-em-pacotes-sobrescritos-com-base-na-regra-invoicevalue-reconstrucao-de-pedidosoms-get-order.md","branch":"main","content":">ℹ️ Este problema conhecido foi traduzido automaticamente do inglês.\n\n## Sumário\n\n\nAo enviar uma fatura por meio da API de notificação de faturas de pedidos com itens personalizados[].description, a descrição mostrada posteriormente em GET Order (packages.items[].description) pode ser substituída pelo nome do produto. O sintoma visível é que alguns pedidos exibem o nome do produto em vez da descrição personalizada fornecida na carga da fatura. Isso afeta os consumidores de OMS/Orders que dependem das descrições de packages.items para reconciliação logística, fiscal ou de ERP, especialmente quando o invoiceValue é igual ou maior que o valor total do pedido. O departamento de engenharia confirmou que esse é um comportamento de longa data vinculado à reconstrução do pedido GET, e não uma interrupção transitória.\r\n## Simulação\n\n\n\n- Pré-requisitos:\n  - Um pedido pronto para receber uma fatura.\n  - Capacidade de fazer o POST da fatura para a API de notificação de faturas de pedidos e, posteriormente, obter o pedido da API do OMS.\n-\n\nEtapas:\n\n1) Enviar um POST de fatura com itens e uma descrição personalizada por item (por exemplo, items[].description = \"1010\").\n\n\n\n2) Caso A: Defina invoiceValue maior ou igual ao valor total do pedido. Depois que a fatura for processada, chame GET /api/oms/pvt/orders/\\{orderId\\}. Observe que packages.items[].description é reconstruído como o nome do item (substitui a descrição personalizada).\n\n\n\n3) Caso B: Definir invoiceValue menor que o valor total do pedido. Após o processamento, chame GET /api/oms/pvt/orders/\\{orderId\\}. Observe que os itens originais da fatura enviada são preservados, inclusive a descrição personalizada que você enviou.\n\n\n\n4) Se você omitir totalmente a descrição nos itens da fatura, o GET Order mostrará packages.items[].description preenchido automaticamente com o nome do produto.\n\n\n\n- Observações:\n  - A engenharia destacou que essa reconstrução ocorre em cada GET Order e é apoiada por testes existentes que validam o comportamento replace-when-invoiceValue>=order.Value\r\n## Workaround\n\n\nN/A\n\n\n\n%0A"}