Cria um ou mais endereços
POST/sku/location
Cadastra um ou mais endereços de estoque. O comportamento depende da parametrização de endereçamento da empresa (NewAddressParameter).
Modo WMS (NewAddressParameter = 1) — exige armazém, tipo de endereço, categoria de armazenamento e as quatro dimensões (Height, Width, Length, MaxWeight, todas maiores que zero). No cadastro individual, o endereço é montado juntando Floor, Street, Module, Column e Level com o separador de Concatenator (padrão -); módulo e nível precisam ser numéricos e a coluna pode ser alfanumérica (letras viram maiúsculas), e o endereço é sempre gravado como não padrão, qualquer que seja o valor enviado em Default. Com BulkLocation = 1 o cadastro é em massa: o sistema gera todas as combinações das faixas StartModule/EndModule, StartColumn/EndColumn e StartLevel/EndLevel — nesse modo Module, Column e Level são ignorados, e o valor enviado em Default é aplicado a todos os endereços gerados, sem desmarcar o padrão anterior do armazém. Em ambos os casos a chamada falha se algum endereço gerado já existir e estiver ativo no mesmo centro de distribuição.
Modo legado (NewAddressParameter = 0) — exige apenas Address, um texto livre. Só Address, IDStockKeepingUnitWarehouse, AddressPriority e Default são gravados; os demais campos do corpo são ignorados. O armazém é opcional; quando informado, precisa estar ativo e pertencer à empresa e a duplicidade é conferida entre os endereços do centro de distribuição dele — sem armazém, a conferência é feita entre os endereços ativos da empresa. Com Default = 1 e armazém informado, os demais endereços daquele armazém deixam de ser padrão.
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 repetidos, 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.