{"section":"known-issues","requestedLocale":"pt","requestedSlug":"a-atualizacao-do-rastreamento-falha-quando-o-invoicenumber-contem-rotas-de-faturas-omsorders","locale":"pt","slug":"a-atualizacao-do-rastreamento-falha-quando-o-invoicenumber-contem-rotas-de-faturas-omsorders","path":"docs/pt/known-issues/Order Management/a-atualizacao-do-rastreamento-falha-quando-o-invoicenumber-contem-rotas-de-faturas-omsorders.md","branch":"main","content":">ℹ️ Este problema conhecido foi traduzido automaticamente do inglês.\n\n## Sumário\n\n\nQuando uma fatura é criada com um caractere de barra no invoiceNumber (por exemplo, 6584634/09), as chamadas de API subsequentes para adicionar ou atualizar o rastreamento falham.\nO sintoma visível são erros HTTP 404/400 nos pontos de extremidade de rastreamento de faturas porque \"/\" no caminho é interpretado como um separador de URL.\nAs contas que usam integrações para atualizar o rastreamento via OMS são afetadas; as rotas de pedidos suportam parcialmente a codificação, mas o comportamento é inconsistente. Isso é semelhante a um KI-953285 anterior, sobre a propagação do invoiceNumber, mas agora a replicação funciona e a falha está especificamente nas atualizações de rastreamento com caracteres especiais.\r\n## Simulação\n\n\n(Como reproduzir) - Pré-requisitos: - Pedido com uma fatura cujo invoiceNumber contém \"/\" (por exemplo, criado via Admin UI: 123456/71).\n\n- Etapas:\n  - Tentativa de atualizar o rastreamento via OMS:\n    - PATCH /api/oms/pvt/orders/\\{orderId\\}/invoice/\\{invoiceNumber\\}/tracking usando o valor bruto com barra, por exemplo, .../invoice/123456/789 → retorna NOT FOUND devido à análise de rota em \"/\".\n  - Tentativa de codificar a barra por URL e atualizar via OMS:\n    - PATCH .../invoice/123456%2F71/tracking → ainda falha; o OMS parece decodificar automaticamente e interrompe o caminho, retornando 404/400\r\n## Workaround\n\n\nPrefira a interface de usuário do administrador para edições de rastreamento em faturas com \"/\": - Insira ou atualize as informações de rastreamento diretamente na interface de usuário do pedido do administrador, que codifica o valor internamente.\n\n-\n\nSe estiver usando a API, evite caracteres especiais no invoiceNumber:\n\n  - Até que um comportamento consistente de API esteja disponível, instrua os integradores a não incluir \"/\" ou outros caracteres especiais no invoiceNumber quando as faturas forem atualizadas por meio de rotas de API (OMS/Orders)."}