Atualização no POST de Rastreamento para Suporte a Pedidos do Tipo Fulfillment

Foi adicionada uma melhoria ao endpoint POST /pedidos/{pedidoId}/rastreamento, permitindo o envio de informações de rastreamento para pedidos do tipo fulfillment, mesmo quando não possuem centro de distribuição (CD).

Contexto

Pedidos fulfillment são criados sem centroDistribuicaoId (valor padrão = 0). Anteriormente, a API exigia o preenchimento desse campo para registrar o rastreamento, obrigando a integradores a informar um centro de distribuição cadastrado na plataforma neste método.

Para resolver esse problema, foi incluído um novo campo que flexibiliza a regra de validação quando o pedido pertence a uma operação fulfillment.

O que mudou?

Agora, o endpoint aceita o novo campo opcional:

"fulfillment": true

Esse campo informa à API que o pedido é fulfillment e, portanto, não deve exigir o preenchimento de centroDistribuicaoId.

Novo Comportamento da API

Quando fulfillment = true

• O campo centroDistribuicaoId deixa de ser obrigatório.
• O rastreamento pode ser registrado normalmente, mesmo sem CD.

Quando fulfillment = false ou não enviado

• O comportamento atual é mantido.
• centroDistribuicaoId permanece obrigatório.
• A validação da API continua exigindo um CD válido.

Exemplo de Request

{
  "situacaoPedidoId": 0,
  "centroDistribuicaoId": 0,
  "rastreamento": "string",
  "dataEvento": "2025-12-03T14:31:26.358Z",
  "numeroNotaFiscal": "string",
  "chaveAcessoNFE": "string",
  "urlNFE": "string",
  "serieNFE": "string",
  "cfop": 0,
  "urlRastreamento": "string",
  "fulfillment": true
}

📘

Nota técnica

• O campo fulfillment é opcional e mantém compatibilidade retroativa com integrações existentes.
• O fluxo dos demais tipos de pedido permanece inalterado.
• Quando o campo não é informado, a API aplica o comportamento padrão, exigindo o preenchimento de centroDistribuicaoId.