B2C - Multi-CD
Configuração
Passo 1
O usuário F1, deve acessar o ambiente da loja e habilitar o “Módulo Multi CD”.
Passo 2
Acessar a tela “Fretes > Multi CD > Centros de Distribuição” e cadastrar os CD que serão enviados estoque para a plataforma.
Ao entrar na tela, clicar no botão “Cadastrar Centro de Distribuição” e preencher os dados solicitados e clicar em “Salvar”.
Nome > Qual o nome do CD Código ERP > Código do CD no ERP do cliente, esse dado será usado depois na integração do estoque. Região -> Qual o UF o CD está CEP > Qual o CEP do CD, será usado no cálculo do frete. CNPJ -> Qual o CNPJ do CD, será usado no cálculo do frete. Ativo -> Marse se o CD está ativo. Somente CD ativos são considerados para vender produtos. Ponto de Retirada -> Habilita esse CD para ser usado como opção para retirar o pedido. Webservice Correios -> Habilia o CD para consultar o frete nos correios caso tenha a conta configurada na plataforma.
Ao entrar na tela, clicar no botão “Cadastrar Centro de Distribuição” e preencher os dados solicitados e clicar em “Salvar”.
Passo 3
Acessar a tela “Fretes > Multi CD > Regiões” e cadastrar as regiões que serão vinculadas aos CDs criados no passo 2.
Ao entrar na tela, clicar no botão “Inserir Nova Região de Frete” e preencher os dados solicitados e clicar em “Salvar”.
Nome -> Nome da Região que está cadastrando Faixa de CEP -> Informa CEP Inicial e Final Ativo -> Marca se a faixa de CEP está ativa, somente faixas ativas serão consideradas no calculo de frete. Obs.: Esse cadastro será necessário caso o CD tenha que atender somente uma região específica. Caso o CD antenda o Brasil inteiro, basta criar apenas 1 região chamada Brasil, com o CEP inicial 00000-001 e CEP Final 99999-999
Ao entrar na tela, clicar no botão “Inserir Nova Região de Frete” e preencher os dados solicitados e clicar em “Salvar”.
Passo 4
Acessar a tela “Fretes > Multi CD > Sequência de CDs” e fazer o vinculo entre as regiões criadas no passo 3 com os CD criados no passo 2. Após fazer o vinculo, clicar em “Salvar”.
Passo 5
Acessar a tela “Fretes > Multi CD > Lista de Regiões x CDs” Essa tela apenas traz de forma simplificada os vinculos feitos no passo 4. E tem o botão de editar caso precisa fazer alguma alteração em um viculo já realizado.
Passo 6
Acessar a tela “Configurações > Gerais > Aba Multi CD”, nessa tela serão configurados o comportamento do Multi CD durante a navegação e finalização de pedido.
Preferências Splitar Pedidos > Define se ao finalizar o pedido, será gerado pedidos filhos. Fazer split de Frete > Se marcado, será calculado um frete para cada CD, no front vai somar o valor dos 2 frete. Mas quando finalizar o pedido, cada CD vai se vinculado ao frete calaulado. CD padrão > Caso no momento de finalizar o pedido, a plataforma não consiga definir para qual CD o pedido deve ser gerado, será considerado o CD padrão. Ativar restrição para pedidos CNPJ > Se marcado, os pedidos de clientes CNPJ serão criado no Admin com o Status definoi no item abaixo. Status para pedidos com restrição > Caso o item acima esteja marcado, selecionar o status qus os pedidos de CNPJ entraram na plataforma. Status Movimentação Stataus para verificar existencia de movimentação no pedido > Serve para quando não é feito o Split do Pedido, Nesse caso no XML de pedido vai um campo informando qual o CD o item foi vinculado. Status indica pedido com movimentação > Seguindo a lógica do item acima, indica um status que o integrador precisa se atentar pois tem itens de diferentes CD no pedido e precisa ser feito o split. Status indica pedido sem movimentação > Seguindo a lógica do item acima, indica um status que o integrador precisa se atentar pois não tem itens de diferentes CD no pedido e pór isso não precisa ser feito o split. Status Split Pedido Status pedidos Pai para Filhos > Determina quais status do pedido pai podem ser alterados nos filhos. Status pedidos Filhos para Pai > Determina quais status do pedido filho podem ser alterados nos pais. Status que não replica de Pai para Filho se Filho não tem NF > Determina quais status o pai pode alterar no filho até ele ter os dados de NF.
Passo 7
Na tela “Produtos > Produtos”, em detalhes do produto, na Aba “Multi CD”, traz as informações do CD vinculado ao produto e seus respectivos dados de estoque.
Passo 8
Na tela “Sistema > Agendamentos (Crontab)”, ativar a rotina "split.pedidos.multicd".
Após ativação é necessrio rodar ela e verificar se ocorre algum erro no log de execução da rotina.
Passo 9
Depois que finalizar todas as configurações acima, verificar o Manual de como fazer a integração do Multi CD “Integração Multi CD”
Integração
Passo 1
Antes de realizar qualquer integração de Multi CD é importante habilitar e configurar o módulo, conforme manual “Configurar Multi CD”. Além disso, precisa definir como e se será feito o split de pedidos. Com todas as informações definidas e configuradas aí poderá iniciar as integrações conforme descritas abaixo.
Passo 2
Temos duas formas de integrar o Multi CD no produto. Usando a integração por REST que é a mais nova (API DataIn), e a antiga por XML.Como fazer a integração do Multi CD no produto usando a integração mais nova por REST. Acessar a documentação no link https://docs.godeep.global/atualizar-estoque-multi-cd-18876518e0 Dentro do JSON de produto, tem um objeto chamado “stock”, nesse objeto enviar os dados do CD e estoque. Esse objeto é um array, então pode enviar quantos CD quiser dentro no objeto “stock”. segmentation: Código do CD no ERP. Obrigatório qty_reservation: Qtd de estoque reservado. Opcional qty_stock":Qtd de estoque disponível. Obrigatório store_qty_security: Estoque de segurança Loja. Opcional marketplace_qty_security: Estoque segurança MKP. Opcional ressuply_deadline: Prazo em dias para produto vendido sem estoque. Opcional
Com isso não precisa mais ser enviado dentro do produto o atributo “estoque_produto”, pois ela será substituída automaticamente pela soma dos valores enviados no item a) II. Como fazer a integração do Multi CD no produto usando a integração antiga por XML. Dentro do XML de produto, tem uma tag chamada centro_distribuicao_codigo: Código do CD no ERP. quantidade: Qtd estoque disponível para venda quantidade_segurança_loja: Est. Segurança da loja. quantidade_seguranca_marketplace: Est. Segurança MKP prazo_ressuprimento: Prazo ressup. Venda s/estoque Com isso não precisa mais ser enviado dentro do produto a tag “estoque_produto”, pois ela será substituída automaticamente pela soma dos valores enviados no item a) I.
1.
"stock": [
{
"segmentation": "CODIGOERPRS",
"qty_reservation": "47",
"qty_stock": "180",
"store_qty_security": "1",
"marketplace_qty_security": "2",
"ressuply_deadline": "15"
},
] 2.
<estoques>, nesse objeto enviar os dados do CD e estoque, separados pela tag <estoque>. Esse objeto é um array, então pode enviar quantos CD quiser dentro no objeto <estoques>.<estoques>
<estoque
centro_distribuicao_codigo="1"
quantidade="0"
quantidade_segurança_loja=""
quantidade_seguranca_marketplace=""
prazo_ressuprimento="" />
</estoques>
3.
Passo 3
Temos duas formas de disponibilizar o Multi CD dentro do pedido. Usando a integração por REST que é a mais nova (API DataIn), e a antiga por XML.Quando está configurado para NÃO FAZER SPLIT de Pedido Fazer a integração do Multi CD usando a integração mais nova por REST (Pedido). Dentro o cabeçalho do pedido tem os campos distribution_center_code -> Código do CD que o pedido deve ser integrado caso não esteja configurado para fazer o Split. move_items -> Valores (1 = Sim | 0 = Não), caso existam produtos de vários CDs e estiver marcado para não fazer split, então o “1” significa que precisa varrer os itens para saber qual deve ser movimentado de CD. 
Dentro dos itens do pedido tem os campos distribution_center_code -> Código do CD onde o produto estava no momento do pedido. move_items -> Valores (1 = Sim | 0 = Não), então o “1” significa que precisa mover esse item para o CD padrão, determinado no item a) acima. 
Fazer a integração do Multi CD usando a integração antiga por XML (Pedido). Dentro o cabeçalho do pedido tem os campos Centro_distribuicao -> Código do CD que o pedido deve ser integrado caso não esteja configurado para fazer o Split. movimentar_itens -> Valores (1 = Sim | 0 = Não), caso existam produtos de vários CDs e estiver marcado para não fazer split, então o “1” significa que precisa varrer os itens para saber qual deve ser movimentado de CD. 
Dentro dos itens do pedido tem os campos distribution_center_code -> Código do CD onde o produto estava no momento do pedido. move_itens -> Valores (1 = Sim | 0 = Não), então o “1” significa que precisa mover esse item para o CD padrão, determinado no item b) acima. 
Quando está configurado PARA FAZER SPLIT de Pedido Neste caso, a própria plataforma vai fazer o split dos pedidos. Vai gerar um pedido “Pai” e pedidos “Filhos”, e somente os pedidos filhos vão ser enviados para a integração Cada pedido filho já vai identificado com o CD correspondente no cabeçalho do pedido, conforme itens a) e b). Quando todos os pedidos “Filhos” estiverem atualizados, então o “Pai” será atualizado. Exemplo: Somente quando todos os pedidos filhos estiverem com o status de “Faturado” é que o pai será atualizado para “Faturado”. 
1.
2.
Modificado em 2025-07-17 14:17:27