Cria um ou mais endereços
POST/sku/location
Cria endereço(s). O comportamento depende da parametrização da empresa:
Modo WMS (NewAddressParameter = 1):
- Campos obrigatórios:
IDStockKeepingUnitWarehouse,IDTypeAddress,IDStockKeepingUnitLocationCategory, dimensões (Height,Width,Length,MaxWeight— todos> 0). - Cadastro individual: enviar
Floor,Street,Module(numérico),Column(alfanumérico),Level(numérico). O backend montaAddress = Floor-Street-Module-Column-Level(separador padrão-, customizável viaConcatenator:-,.ou|). Falha se já existe esse mesmo conjunto Floor/Street/Module/Column/Level + CD. - Cadastro em massa (
BulkLocation = 1): enviarFloor,Street,StartModule/EndModule,StartColumn/EndColumn,StartLevel/EndLevel. O backend gera o produto cartesiano das faixas (ex.:StartModule=1,EndModule=3,StartColumn=A,EndColumn=C,StartLevel=1,EndLevel=2→ 18 endereços). Falha se qualquer endereço gerado já existe no CD. - Validações: armazém ativo da empresa, categoria ativa da empresa, grupo da empresa (se informado), tipo de endereço válido. Módulo e nível precisam ser numéricos; coluna pode ser alfanumérica (letras viram maiúsculas).
Modo legado (NewAddressParameter = 0):
- Campo obrigatório:
Address(string livre). IDStockKeepingUnitWarehouseopcional; quando informado, valida que o armazém pertence à empresa e que não existe outro endereço com mesmo nome no CD. QuandoDefault = 1, zera oDefaultdos demais endereços do armazém antes de inserir.
Devolve o detalhe via list (OnlyLocation=1) ou — em cadastro em massa WMS — a string Endereços cadastrados com sucesso.
Request
Responses
- 200
- 400
- 500
Endereço criado (array com 1 item no modo individual) ou string de sucesso (modo em massa).
Validações WMS: [BadRequest] - As dimensões do endereço não podem ser negativas ou vazias; [BadRequest] - As faixas de módulo, coluna e nível iniciais não podem ser nulas, maiores que as finais e módulo e nível possuir letras; [BadRequest] - Preencha corretamente o armazém, tipo e categoria de armazenamento; [BadRequest] - Armazém não foi encontrado; [BadRequest] - Categoria de armazenamento não encontrada; [BadRequest] - Grupo endereço não encontrado; [BadRequest] - Tipo de endereço não encontrado; [BadRequest] - Preencha todos os campos do endereço (Andar, Rua, Modulo, Coluna e Nivel); [BadRequest] - Preencha módulo e nível com números; [BadRequest] - Já existe este endereço para o mesmo centro de distribuição; [BadRequest] - Endereços repitidos, consulte seus endereços; [BadRequest] - Erro ao gerar endereços em massa; [BadRequest] - Erro ao inserir endereços. Validações legado: [BadRequest] - Endereço precisa ser informado; [BadRequest] - Armazém não localizado; [BadRequest] - Já existe este endereço para o centro de distribuição. Gerais: [BadRequest] - Empresa não existe.
Erro interno.