Guia de configuração de localizações Stokkap

Compreender o sistema de dois níveis

Os tipos de localização são categorias que descrevem o tipo de local onde o stock é armazenado. Pense neles como etiquetas: Loja, Armazém, Fornecedor.

Os locais são os nomes específicos de locais dentro dessas categorias. «Loja Principal», «Armazém de Londres» e «Acme Supplies Ltd» são todos locais.

Um produto pode estar associado a várias localizações do mesmo tipo, como duas lojas ou várias prateleiras de armazém. Use os tipos para agrupar localizações semelhantes; não precisa de um tipo diferente para cada lugar.

Passo 1 - Criar tipos de localização

Aceda ao painel de administração do WordPress:

Stokkap → Location Types

Adicionar um tipo

1. Introduza um rótulo - o nome que será exibido em toda a área de administração (por exemplo, «Loja»)
2. Opcionalmente, defina um slug — um identificador interno gerado automaticamente a partir do rótulo, caso este campo seja deixado em branco. Utilize apenas letras minúsculas, números e sublinhados. O slug não pode ser alterado após a criação; por isso, escolha-o com cuidado ou deixe-o em branco para que seja gerado automaticamente.
3. Definir a prioridade - isto controla a ordem de esgotamento do stock (explicado em pormenor abaixo). Números mais baixos significam maior prioridade. O valor predefinido aumenta automaticamente em incrementos de 10 (10, 20, 30...) para deixar margem para novas encomendas posteriormente.

Clique em «Adicionar tipo de localização» para guardar.

Exemplos práticos

Aqui estão as configurações para diferentes tipos de lojas:

Pequena loja independente:

Tipo	Prioridade
Shop	10
Supplier	20

É simples: venda primeiro o que tem na loja e, se não houver, recorra ao stock do fornecedor.

Rede de lojas com várias filiais:

Tipo	Prioridade
Shop	10
Warehouse	20
Supplier	30

O stock da loja é vendido em primeiro lugar. Quando a loja fica sem stock, recorre-se ao stock do armazém. O stock do fornecedor é o último recurso.

Empresa exclusivamente online com vários armazéns:

Tipo	Prioridade
Armazém principal	10
Armazém de excedentes	20
Fornecedor de envio direto	30

Dê prioridade ao seu armazém principal; o armazém de transbordamento lida com o excedente e os fornecedores tratam do restante.

Lojista com mercadoria nas prateleiras e em exposição:

Tipo	Prioridade
Exibir	10
Prateleira	20
Sala dos fundos	30
Supplier	40

Venda primeiro os artigos expostos, reabasteça a partir das prateleiras, depois do armazém e, por fim, recorra ao fornecedor.

Negócio de armazenamento de contentores (exemplo de cliente real):

Tipo	Prioridade
Piso de produção	10
Contentor pequeno	20
Contentor de grandes dimensões	30
Escritório	40
Supplier	50

Este cliente utiliza tipos de contentores para separar diferentes áreas de armazenamento físico. O stock é retirado primeiro da área de produção, depois dos contentores pequenos, seguidamente dos contentores grandes, depois das reservas administrativas e, por fim, do fornecedor. Cada tipo de contentor pode conter vários nomes de localização que descrevem posições exatas.

Tipos de edição e eliminação

• Clique em «Editar» ao lado de qualquer tipo para alterar o seu nome ou prioridade. O slug permanece inalterado.
• Clique em «Eliminar» para remover um tipo. Só é possível eliminar um tipo ao qual não estejam atribuídos locais. Reatribua ou elimine primeiro os seus locais.

Passo 2 - Criar locais

Aceda ao painel de administração do WordPress:

Stokkap → Locations

Esta página não estará disponível até que tenha criado pelo menos um tipo de localização.

Adicionar uma localização

1. Introduza um nome - o local específico (por exemplo, «Loja Principal», «Armazém de Birmingham», «Acme Supplies Ltd»)
2. Selecione o tipo no menu suspenso
3. Definir a prioridade - o valor padrão é a prioridade do tipo, mas pode ser substituído por localização. Isto controla a ordem dentro do mesmo tipo e entre tipos.

Clique em «Adicionar localização» para guardar.

Exemplos de localizações reais

Pequena loja independente com um único fornecedor:

Nome do local	Tipo	Prioridade
My Shop	Shop	10
Main Supplier	Supplier	20

Rede de lojas com várias filiais:

Nome do local	Tipo	Prioridade
Manchester Store	Shop	10
Leeds Store	Shop	10
Central Warehouse	Warehouse	20
Acme Wholesale	Supplier	30
Budget Parts Ltd	Supplier	30

Armazém com estantes organizadas por zonas:

Nome do local	Tipo	Prioridade
Zone A - Electronics	Shelf	10
Zone B - Clothing	Shelf	10
Zone C - Homeware	Shelf	10
Returns Area	Shelf	15
Main Supplier	Supplier	20

Um produto pode ter stock em várias prateleiras. Uma localização chamada Returns Area continua a ser vendável, a menos que tenha sido explicitamente criada como não vendável. Uma prioridade de dedução inferior apenas adia a sua utilização; não impede vendas a partir dela.

Armazenamento de contentores com códigos de posição (exemplo real de um cliente):

Nome do local	Tipo	Prioridade
Shop Front	Piso de produção	10
L/H/S/Shelf 1	Contentor pequeno	20
L/H/S/Shelf 2	Contentor pequeno	20
L/H/S/Rack 1	Contentor pequeno	20
R/H/S/Shelf 1	Contentor de grandes dimensões	30
R/H/S/Rack 1	Contentor de grandes dimensões	30
Back Office Store	Escritório	40
Wholesale Direct	Supplier	50

Códigos curtos como L/H/S (lado esquerdo) ou R/H/S (lado direito), seguidos do número da prateleira ou estante, ajudam a encontrar os artigos. Um produto pode ter várias localizações em cada tipo de contentor.

A tabela de localizações

As suas localizações são apresentadas numa tabela que mostra:

• Número de prioridade
• Nome
• Slug (apresentado como o formato da chave meta _st_stock_{slug})
• Tipo
• Estado (Ativo/Inativo)
• Ações (Editar, Eliminar)

Arraste as linhas para alterar a prioridade de dedução. As encomendas usam as localizações ativas vendáveis elegíveis de cima para baixo; o stock não vendável é ignorado.

Editar uma localização

Clique em «Editar» ao lado de qualquer localização. Pode alterar:

• Nome - renomeie o local a qualquer momento
• Tipo - reatribuir a um tipo diferente
• Prioridade - ajustar a ordem de esgotamento
• Ativa — as localizações normais só podem ser desativadas depois de transferir ou remover o seu stock. As localizações não vendáveis não podem ser desativadas.

A condição de venda é definida na criação. As localizações existentes não podem passar de vendáveis a não vendáveis, nem o contrário. Transfira o stock para uma localização vendável quando estiver pronto para venda.

Eliminar um local

Eliminar uma localização remove o lugar em si, não apenas a associação a um produto. As localizações não vendáveis têm de ser esvaziadas antes da eliminação. Referências ou operações pendentes também podem impedir a eliminação e têm de ser resolvidas primeiro.

Quando estiver vazia: confirme a eliminação depois de resolver as referências ou operações restantes.

Para localizações vendáveis normais com stock: a janela de eliminação apresenta estas opções. Não permitem contornar as verificações das localizações não vendáveis:

1. Descarregar relatório - Gera um ficheiro de texto que lista todos os produtos nesse local, indicando o SKU, o código de barras, a quantidade em stock e o nome do produto. Utilize esta função para verificar o que será afetado antes de prosseguir.
2. Transferir e eliminar - Selecione um local de destino no menu suspenso. Todo o stock é transferido para o destino em segundo plano e, em seguida, o local é eliminado. Utilize esta opção ao transferir stock para um novo local (por exemplo, ao encerrar uma loja e transferir o inventário para o seu armazém).
3. Eliminar sem transferência - Remove definitivamente a localização e todos os dados de stock associados. Isto requer uma caixa de seleção de confirmação adicional: «Compreendo que isto implicará a perda definitiva de X unidade(s)». Utilize esta opção apenas se o stock já não existir fisicamente.

Remover a associação a um produto é uma ação separada. Use uma transferência normal ou em massa para mover os artigos antes de eliminar uma localização não vendável.

Localizações não vendáveis

As localizações não vendáveis contêm stock registado indisponível para venda, como artigos danificados, devoluções à espera de inspeção ou stock a aguardar controlos de qualidade.

Não vendável é uma propriedade de cada localização, não um tipo de localização separado. As localizações vendáveis e não vendáveis podem pertencer a Warehouse ou Shop.

Ativar e criar uma localização não vendável

1. Atualize o Stokkap Connect para a versão 1.6.6 ou posterior e use a versão mais recente da aplicação Stokkap.
2. Abra Stokkap → Definições.
3. Por baixo do cartão de definições Tipos de localização, procure Localizações não vendáveis e clique em Ativar localizações não vendáveis.
4. Abra Stokkap → Localizações, crie uma nova localização e assinale Não vendável.

As localizações existentes continuam a ser vendáveis. Ativar esta funcionalidade não altera o stock existente.

Para disponibilizar stock para venda, transfira-o para uma localização vendável.

Fluxos suportados e limitações

Para produtos normais sem controlo por número de série:

• Consultar e ajustar: a edição de produtos, Quick Lookup, Stock Control e Scan suportam quantidades não vendáveis. As localizações apresentam uma etiqueta clara de classificação Não vendável.
• Mover stock: as transferências normais e em massa permitem mover stock entre localizações vendáveis e não vendáveis.
• Contagens: as localizações não vendáveis são excluídas dos inventários e das contagens por registo ou em massa.
• Destinos não suportados: as localizações não vendáveis não podem ser usadas para stock com números de série, receções de compras ou ativação em massa.
• Importações CSV: os fluxos de importação suportados não podem criar nem alterar saldos não vendáveis. As importações normais de stock vendável continuam a funcionar.
• Relatórios e exportações: podem apresentar quantidades não vendáveis e etiquetas das localizações. O stock não vendável é excluído da valorização ao custo e ao preço de venda e não conta como stock disponível para venda nos relatórios de stock baixo ou esgotado.

Reordenar locais (arrastar e soltar)

A tabela de localizações permite reordenar os itens através da função arrastar e largar. Agarre na alça do lado esquerdo de qualquer linha e arraste-a para uma nova posição. Os números de prioridade atualizam-se automaticamente quando largar.

O stock vendável elegível é deduzido de cima para baixo. As encomendas usam as localizações ativas vendáveis por prioridade, passando à seguinte quando necessário. O stock não vendável é ignorado independentemente da prioridade.

Esta é a forma mais rápida de ajustar a ordem de esgotamento sem ter de editar manualmente os números de prioridade.

Como funcionam a prioridade e a redução de stock

A prioridade é o conceito fundamental que determina qual o stock de qual local é utilizado em primeiro lugar quando um cliente faz uma encomenda.

A cascata de esgotamento

Ao receber uma encomenda, o Stokkap usa as localizações ativas vendáveis elegíveis desde o número de prioridade mais baixo (prioridade mais alta) até ao mais alto. O stock não vendável é sempre ignorado:

Exemplo: Um cliente encomenda 8 unidades de um produto.

Nome do local	Prioridade	Em stock	Ação
Main Shop	10	3 unidades	Toma 3 (restam 0)
Warehouse	20	10 unidades	Pausa de 5 minutos (faltam 5)
Supplier	30	50 unidades	Ignorado (encomenda processada)

Resultado: 3 unidades vêm de Main Shop e 5 de Warehouse. O stock de venda do WooCommerce diminui em 8.

Se forem permitidas encomendas pendentes e o stock vendável elegível for insuficiente, a quantidade em falta é atribuída à localização vendável elegível com maior prioridade. O stock não vendável não pode cobrir essa falta.

Prioridade de tipo vs. prioridade de localização

Os tipos de localização têm uma prioridade predefinida que as novas localizações herdam. É possível substituir esta prioridade em localizações individuais.

Na maioria dos casos, atribuir a mesma prioridade a todos os locais do mesmo tipo funciona bem — o sistema processa-os pela ordem em que aparecem. Se precisar de um controlo mais preciso (por exemplo, dar preferência a um armazém em detrimento de outro), atribua números de prioridade diferentes a cada local.

Complemento Smart Delivery: substituições de prioridade com base na zona

Com o complemento Smart Delivery (disponível em breve como assinatura), pode substituir a prioridade de tipo predefinida por zona de envio do WooCommerce. Isto permite-lhe alterar o tipo de localização preferido com base no destino do envio do cliente.

Por exemplo, a sua prioridade predefinida pode ser Loja (10) > Armazém (20) > Fornecedor (30). Mas, no caso de encomendas internacionais, pode definir o Armazém como prioridade, uma vez que fica mais próximo do porto. Cada zona de envio pode ter a sua própria ordem de prioridade.

O Smart Delivery também permite:

• Esgotamento com base na localização geográfica - O Stokkap deteta automaticamente a localização do cliente e aplica a ordem de prioridade correta antes mesmo de este chegar à finalização da compra.
• Mensagens sobre prazos de entrega - Mostre aos clientes os prazos de entrega estimados nas páginas dos produtos, com base no local de onde a encomenda será enviada.
• Filtragem de tarifas de envio - Mostrar ou ocultar automaticamente os métodos de envio com base nos tipos de localização que irão processar a encomenda.
• Processamento de encomendas «Click & Collect» - As encomendas com uma tarifa de envio «Click & Collect» podem ser priorizadas para esgotar o stock disponível na loja.

Bulk import & export (CSV)

Use the built-in CSV import and export tools when you need to create a lot of locations or location types at once - for example, 10+ locations, warehouse aisle-and-bin grids, or multi-store rollouts.

Two separate CSVs

Stokkap uses separate importers for:

1. Location Types - the categories such as Shop, Warehouse, Supplier, or Aisle M01.
2. Locations - the actual places within those types, such as Main Shop, Central Warehouse, or M01-G01.

Create location types first, then import locations that reference those types.

Location Types CSV columns

Coluna	Obrigatório?	Notas
label	Obrigatório	Nome apresentado para o tipo, como Warehouse ou Aisle M01.
slug	Opcional	Identificador interno. Se estiver vazio, o Stokkap gera-o a partir do nome. Os slugs são permanentes após a criação e não podem ser alterados posteriormente através de uma importação CSV.
priority	Opcional	Prioridade de consumo do stock. Os números mais baixos são usados primeiro. Se estiver vazio, aplica-se o comportamento predefinido de prioridades do Stokkap.

Locations CSV columns

Coluna	Obrigatório?	Notas
name	Obrigatório	Nome apresentado para a localização, como Main Shop ou M01-G01.
type	Obrigatório	Tipo de localização. Pode usar o slug ou o nome do tipo; a correspondência não distingue maiúsculas de minúsculas.
priority	Opcional	Prioridade de consumo desta localização. Se estiver vazia, aplica-se a prioridade ou o comportamento predefinido do tipo de localização.

Duplicate detection and preview

For locations, duplicates are detected by name + type. If your CSV contains a location with the same name under the same type as an existing location, Stokkap treats it as the same location rather than creating a duplicate.

After you drop in a CSV, Stokkap shows an import preview table with a per-row status. Review this before importing so you can catch missing required columns, unknown types, duplicate rows, and invalid priority values.

Export existing data

Use Export existing before preparing a large import. The exported CSV gives you the current column structure and real examples from your store, so it is the safest starting point for edits in a spreadsheet.

From the Locations import card, you can also use the Export location types shortcut. This is useful when building a locations CSV because you can copy the exact type labels or slugs into the type column.

Worked example: 792 warehouse bins

Scenario: a warehouse with 8 aisles x 99 bays = 792 storage bins.

1. Create 8 location types, one per aisle: M01, M02, ... M08. You can create them through the UI or import a Location Types CSV:

   label,priority
   Aisle M01,10
   Aisle M02,20
   ...
   Aisle M08,80

2. Generate the bay locations in a spreadsheet:

   name,type,priority
   M01-G01,aisle_m01,10
   M01-G02,aisle_m01,20
   ...
   M08-G99,aisle_m08,990

3. Save the spreadsheet as CSV, drop it into the import widget, review the preview table, then click Import.

Atribuir localizações aos produtos

A atribuição de localização no plugin está disponível no ecrã de edição de produtos do WooCommerce e na edição rápida. A aplicação web Stokkap oferece formas adicionais de atribuir localizações, incluindo a leitura de códigos de barras, a lista de produtos e a visualização detalhada do produto.

Produtos simples (edição completa)

1. Abra qualquer produto simples e aceda ao separador «Inventário»
2. Selecione «Gerir com o Stokkap» para ativar a gestão de stock em várias localizações. Isto também ativa a opção «Gerir stock?» do WooCommerce, caso ainda não estivesse ativada.
3. A secção de inventário por localização é apresentada. Clique em «Adicionar tipo de localização...» e selecione um tipo (por exemplo, «Loja»)
4. Aparece uma linha com uma lista suspensa de todos os locais desse tipo. Selecione o local específico (por exemplo, «Loja Principal»)
5. Introduza a quantidade em stock
6. Repita para outras localizações, incluindo várias do mesmo tipo.
7. Os totais distinguem o stock vendável, o stock não vendável e o stock registado. Apenas o stock em localizações ativas vendáveis é usado como stock de venda do WooCommerce.

Clique em X junto à linha de uma localização para remover a associação a esse produto. Não precisa de guardar primeiro uma quantidade igual a zero. A remoção retira a quantidade registada desse produto; não transfere stock nem torna vendável o stock não vendável. Use uma transferência quando os artigos se movem fisicamente. Transferir todo o stock pode deixar uma associação com quantidade zero; removê-la é uma ação separada.

Produtos simples (edição rápida)

Para obter atualizações mais rápidas a partir da lista de produtos:

1. Ir para a secção «Produtos» no WooCommerce
2. Passe o cursor sobre um produto e clique em «Edição rápida»
3. A secção Stokkap apresenta as mesmas linhas de tipo de localização — ajuste as quantidades ou adicione/elimine locais
4. Clique em Atualizar para guardar

A edição rápida é ideal para ajustes diários de stock sem ter de abrir o editor de produtos completo.

Produtos variáveis

No caso dos produtos variáveis, o stock é gerido por variação, e não ao nível do produto principal. Abra o painel de cada variação para ver os mesmos campos relativos ao tipo de localização e ao stock que nos produtos simples. Cada variação pode estar em locais diferentes, com quantidades diferentes.

Stock vendável, não vendável e registado

O stock de venda do WooCommerce provém das localizações ativas vendáveis. As quantidades não vendáveis continuam registadas separadamente e são excluídas do stock de venda.

Total	Significado
Stock vendável	Stock em localizações ativas vendáveis; usado como stock de venda do WooCommerce.
Stock não vendável	Quantidades registadas em localizações não vendáveis, excluídas do stock de venda.
Stock registado	Stock vendável mais stock não vendável.

Exemplo: 10 vendáveis + 4 não vendáveis = 14 registadas. O stock de venda do WooCommerce é 10. Transfira 2 unidades para uma localização vendável: 12 vendáveis + 2 não vendáveis = 14 registadas. O stock de venda do WooCommerce passa a 12.

O Stokkap sincroniza automaticamente o stock de venda do WooCommerce quando as quantidades vendáveis elegíveis mudam. Ajustar apenas o stock não vendável não aumenta o stock de venda.

As localizações inativas não contribuem para o stock de venda do WooCommerce. Transfira ou remova o stock antes de desativar uma localização normal; as localizações não vendáveis não podem ser desativadas.

Configuração em massa e importação de CSV

There are three bulk workflows, each for a different job:

• Configuração em massa — ativa a gestão Stokkap para muitos produtos. Use uma localização vendável como destino de ativação; as localizações não vendáveis não são suportadas como destinos.
• CSV import for locations and location types - new in 1.4.9. Use the built-in CSV tools to create or update the locations and types themselves. See Bulk import & export (CSV) above.
• Importações CSV de stock de produtos — as importações normais de stock vendável continuam a ser suportadas, incluindo várias localizações do mesmo tipo. Os fluxos de importação suportados não podem criar nem alterar saldos não vendáveis. Use a edição de produtos, Quick Lookup, Stock Control ou Scan para ajustes e as transferências para mover stock. Os CSV de configuração acima criam ou atualizam localizações e tipos, não quantidades de produtos.

Dicas e boas práticas

• Comece por algo simples. Dois tipos (Loja e Fornecedor) são suficientes para a maioria das pequenas empresas. Adicione mais à medida que as suas necessidades forem aumentando.
• Utilize «tipos» para categorias e «localizações» para detalhes. «Armazém» é um tipo. «Armazém de Birmingham» é uma localização.
• Deixe espaços em branco nos números de prioridade. O incremento automático de 10, 20, 30 deixa margem para inserir novos tipos mais tarde, sem ter de renumerar tudo.
• Arraste para reorganizar, em vez de editar manualmente os números de prioridade — é mais rápido e os números atualizam-se automaticamente.
• Faça o download do relatório antes de eliminar um local com stock. Mesmo que pretenda transferir o stock, o relatório constitui uma cópia de segurança útil.
• Transfira o stock quando os artigos mudam de lugar. As transferências normais e em massa suportam localizações vendáveis e não vendáveis. Esvazie uma localização não vendável antes de a eliminar.
• Os slugs são permanentes. Pense neles como códigos internos. O nome de exibição pode ser alterado livremente, mas o slug permanece. Se cometer um erro, elimine o local e crie um novo (transferindo o stock para o novo local).
• Várias localizações da mesma natureza? Mantenha-as no mesmo tipo. Um produto pode ter stock em mais do que uma dessas localizações.