A Priorização dos Centros de Distribuição (CDs) permite definir qual CD deve ser consultado primeiro na cotação de frete dos produtos do carrinho. A definição é feita por faixa de CEP, e você controla tanto as faixas quanto a ordem dos CDs em cada uma, de acordo com a necessidade do seu negócio.

Neste artigo você vai ver como criar e ajustar as regras de priorização, como reordenar os CDs pelo painel administrativo ou pela API Pública e como a cotação se comporta em situações comuns, como falta de estoque ou CD sem serviço de frete vinculado.

Configurando faixas de CEP

Por padrão, a plataforma já vem com uma regra de priorização para cada estado, cada uma com a sua faixa de CEPs. Se a sua operação exigir mais precisão, você pode criar novas regras e dividir as faixas por cidade, bairro, região ou qualquer outro critério.

Para visualizar as regras, acesse o menu CD e Regionalização > Priorização de CDs.

A tela lista as regras existentes na sua loja e oferece as opções:

Adicionar novas regras;
Importar novas regras por planilha;
Exportar as regras cadastradas em planilha no formato .csv.

Adicionando uma nova regra de priorização

Na tela de listagem de Priorização de CD, clique em + Nova Priorização de CDs e siga os passos:

1. Informe o nome da regra.

2. Em “Condições da aplicação de regra”, defina o range de CEP da área que a regra vai atender. Você pode informar o range de duas formas: manualmente, preenchendo o CEP inicial e o CEP final, ou por informações pré-definidas, selecionando regiões, estados, cidades ou bairros.

3. Adicione os Centros de Distribuição em ordem de prioridade, de acordo com a sua operação.

4. Salve a regra.

Importante: Toda regra precisa ter ao menos uma condição de área cadastrada (ranges de CEP).

Priorizando um Centro de Distribuição no admin

Para priorizar um CD em uma região:

Na lista de regras, localize a região desejada e clique no ícone Editar.

Em “Centros de Distribuição” serão retornados todos os CDs vinculados à regra.
Clique em + Adicionar CD e vincule novos CDs que farão parte da regra.
Dentro da regra, arraste cada CD até a posição desejada. O CD que estiver no topo da lista é o primeiro a ser consultado.

Clique em Salvar.

Observação: A lista de seleção exibe apenas os CDs que ainda não estão vinculados à regra.

Priorizando um Centro de Distribuição Pela API Pública

A API Pública permite atualizar a priorização dos CDs de uma regra específica, substituindo por completo a ordenação existente. Para isso, utilize o endpoint:

PUT /centrosdistribuicao/regra/ordenacao

Exemplo de payload:

{

"regra": "Paraná",

"ordenacao": [

{ "cd": 25, "ordem": 1 },

{ "cd": 32, "ordem": 2 },

{ "cd": 37, "ordem": 3 }

]

}

Campo	Descrição
regra	Nome da regra de priorização que será reordenada. Deve ser idêntico ao cadastrado no painel administrativo.
ordenacao	Lista completa com todos os CDs da regra e suas posições de prioridade.
cd	ID do Centro de Distribuição.
ordem	Posição na priorização. Quanto menor o número, maior a prioridade.

Atenção: A atualização substitui completamente a ordenação atual da regra. Qualquer CD que não for enviado na lista "ordenacao" será removido da regra automaticamente. Se qualquer validação falhar, nenhuma alteração é aplicada; a priorização só é regravada se tudo der certo.

Removendo um CD de uma regra

Para desfazer o vínculo de um CD com uma regra, clique no botão de Remover.

Outra forma de priorizar: blocos com linha de corte

Além da lista de prioridades simples, é possível organizar os CDs em blocos. Em vez de uma única fila, você agrupa os CDs e define a ordem em que cada grupo será consultado, separando um do outro por uma linha de corte.

Na cotação, o sistema percorre os blocos na ordem configurada. Em cada bloco, ele tenta primeiro atender o pedido completo e, se a sua operação permitir divisão de pedido (split), tenta dividir a entrega entre os CDs do mesmo bloco. Só avança para o próximo bloco se ainda restarem itens sem atendimento.

Importante: A priorização em blocos exige que o tipo de heurística da regra seja diferente do tipo 1 (padrão da plataforma).

Para ver o passo a passo, exemplos e pontos de atenção, acesse o artigo:

Priorização de CDs em blocos (com linha de corte)

Perguntas frequentes

Como configurar meus serviços de frete para atender a todos os Centros de Distribuição?

Ao cadastrar um novo CD, é necessário vinculá-lo aos serviços de frete que a sua loja utiliza. Essa configuração é feita no Painel de Serviços de Frete. Consulte o artigo correspondente para ver o passo a passo.

Como funciona a cotação quando o produto não tem estoque no CD priorizado?

O serviço de frete retorna a cotação do próximo CD da lista de priorização que tenha estoque do produto.

Como funciona a cotação quando o CD priorizado não está vinculado a um serviço de frete?

Se o CD priorizado para a região do CEP cotado não estiver vinculado a nenhum serviço de frete (Correios, Contratos, Intelipost, Integração Customizada ou Retirada), a cotação é retornada pelo próximo CD da lista que tenha um serviço de frete vinculado.

Como funciona a cotação quando a tabela de frete do CD priorizado não atende às dimensões do carrinho?

Por padrão, quando uma tabela de frete está vinculada a um CD priorizado, avaliamos as configurações da tabela, como faixa de CEP, centro de distribuição e estoque.

Com a configuração "Priorização Tabela de Frete" ativada, se a tabela tiver algum limite de dimensão que o carrinho não atenda, a cotação é retornada pelo próximo CD da lista de priorização que atenda às dimensões, caso exista.

Para mais detalhes, consulte o artigo Contratos de Frete.

Pesquisa

Priorização dos Centros de Distribuição