O stock inicial regista as quantidades e custos já existentes quando começa a utilizar o SolaStock ou abre um novo armazém. A contabilização cria movimentos de entrada no razão de stock ao custo introduzido, que passa a ser o valor inicial do inventário. Quando o SolaStock está ligado ao SolaCount, a contabilização também é enviada às suas contas.
Use-o uma vez por armazém no início da operação (ou para um lote de estoque legado recém-encontrado). Para correções diárias, use Ajustes; para recebimentos de fornecedores, use Compras.
#Onde encontrar
- Barra lateral: Operações → Estoque Inicial. URL
/inventory/opening-stock. - Nova entrada: Nova entrada (superior direito) —
/inventory/opening-stock/new. - Uma entrada: clique em seu número —
/inventory/opening-stock/{id}; edite um rascunho em/inventory/opening-stock/{id}/edit. - Atalho: os campos de estoque inicial no formulário Novo item (veja Itens).
| Ação | Permissão | Funções padrão |
|---|---|---|
| Ver entradas | Ver saldos de estoque | Todas as funções SolaStock (com escopo: apenas armazéns atribuídos) |
| Criar, importar, editar rascunhos, lançar, reverter | Criar / lançar / reverter estoque inicial | Proprietário, SolaStock Administrador, Gerentes/Membros da organização. Não Gerente de Inventário, Gerente de Armazém, Operador de Armazém, Visualizador de Inventário. |
Sem a permissão, Nova entrada fica desabilitado e o painel Importação em lote fica oculto.
#Tour pela tela — a lista
- Cabeçalho: Estoque inicial e Nova entrada (direita).
- Linha abaixo dele: "O lançamento e a reversão utilizam o razão de estoque canônico. Entradas lançadas não podem ser editadas."
- Painel de Importação em massa (se você puder criar): Armazém, Lançamento → Lançar após importação, Importar CSV, e a ajuda da coluna (Colunas obrigatórias / Colunas opcionais).
- Tabela, mais recentes primeiro (até 50 entradas):
| Coluna | Significado |
|---|---|
| Número | Número da entrada (OS-000001…). Abre a entrada. |
| Data | Data de abertura. |
| Armazém | Nome do armazém. |
| Estado | Rascunho, Lançado ou Revertido. |
| Valor | Valor total das linhas. |
Vazio: Nenhuma entrada de estoque inicial — "Crie uma entrada para definir as quantidades iniciais."
#Status e ciclo de vida
| Estado | Significado | O que você pode fazer |
|---|---|---|
| Rascunho | Salvo; sem estoque ainda. | Editar, Lançar. |
| Lançado | Estoque adicionado; bloqueado. | Ver, Reverter. |
| Estornado | Movimentações opostas adicionadas; o original permanece no razão. | Somente visualização. |
Rascunho → Lançado → Revertido. Não há exclusão. Abrir uma entrada lançada para edição mostra "Documentos lançados são somente leitura." e retorna você à entrada.
#Criar uma entrada
-
Operações → Estoque Inicial → Nova entrada. A página é intitulada Novo estoque inicial.
-
Campos de cabeçalho:
Campo Obrigatório Regras / padrões Notas Número do documento Não "Gerado automaticamente se deixado em branco." Em uma nova entrada, SolaStock sempre atribui o próximo número OS-. Você pode alterá-lo mais tarde ao editar o rascunho (máx. 50 caracteres).Data de abertura Não O padrão é a data de hoje. A data dos movimentos no razão. Armazém Sim Deve ser um ao qual você está atribuído. Escolha-o antes dos compartimentos. Notas Não por exemplo, "Inventário 30 set 2026". -
Em Linhas, uma linha por item (+ Adicionar linha para mais, × para remover):
Coluna Obrigatório Regras Notas Artigo Sim Apenas itens de inventário ativos. Mostrado como SKU · nome. Endereço de armazenagem Não Compartimentos do armazém escolhido. Endereço de armazenagem (opcional)… Quantidade Sim Maior que 0, até 4 casas decimais. Para itens de série, é igual à contagem de série ("A quantidade é igual à contagem de números de série"). Unidade Não Qualquer unidade. Introduza a quantidade noutra unidade, por exemplo caixas; SolaStock converte-a para a unidade base usando as conversões das Configurações e divide o custo em conformidade. Para artigos com números de série, apresenta Cada número de série. Lote / Número de série / Validade Para itens rastreados Artigos por lote: código do lote («É obrigatório um código de lote para artigos controlados por lote.») e data de validade opcional. Artigos por número de série: leia ou escreva cada número e prima Enter; os duplicados são ignorados («:count números de série duplicados ignorados.»). Um selo como Lote rastreado mostra o que é necessário. — para itens não rastreados. Custo unitário Não 0 ou mais, 4 casas decimais. Em branco = 0. Custo por unidade da unidade escolhida. Valor total abaixo das linhas é atualizado conforme você digita.
-
Clique em um botão na parte inferior:
- Salvar rascunho — "Rascunho salvo." ("Rascunho atualizado." ao editar). Nenhuma alteração de estoque.
- Salvar e lançar — confirme Lançar estoque inicial? — «O lançamento grava os movimentos de estoque no razão de estoque e bloqueia esse documento. Não pode ser editado posteriormente.» → Lançar. Aparece «Estoque inicial lançado.»
- Cancelar — sair sem salvar.
Sem linhas utilizáveis: "Adicione pelo menos uma linha." Outras falhas: "Falha ao salvar." ou a mensagem do servidor.
Se a ligação cair durante a gravação ou contabilização, aparece Estado não confirmado — «Não foi possível confirmar se a alteração foi concluída. Verifique o estado atual antes de voltar a submeter.» Clique em Verificar estado atual para abrir o lançamento (ou a lista) e verificar se foi guardado ou contabilizado antes de tentar novamente.
#Editar um rascunho
- Abra o rascunho e clique em Editar (superior direito). A página é intitulada Editar estoque inicial.
- Altere o cabeçalho e as linhas. Os códigos de lote, datas de validade e números de série guardados são recarregados no formulário e mantidos ao guardar. Reveja as linhas com rastreio antes de guardar; altere os detalhes apenas se essa for a sua intenção.
- Salvar rascunho ou Salvar e lançar.
#A página de entrada
- Cabeçalho: número, selo de status, Editar (apenas rascunhos).
- Resumo: Data de abertura, Armazém, Valor total, Notas.
- Abas:
| Aba | Exibe |
|---|---|
| Linhas | Artigo, Localização (número interno da localização), Quantidade (com a quantidade e unidade introduzidas entre parênteses quando foi usada outra unidade), Custo unitário, Total. Os artigos com números de série têm uma linha por série. |
| Resultado do razão | Os movimentos criados: Data, Artigo, Armazém, Direção, Quantidade, Custo unitário, Total, Quantidade acumulada. Antes de lançar: «Ainda não existem movimentos no registo de stock. Aparecem aqui após o lançamento.» |
| Auditoria | Linha do tempo de auditoria — "Eventos de lançamento e estorno são registrados no log de auditoria de estoque." (Ver Razão de Estoque → Auditoria de atividade.) |
- Ações inferiores: Lançar (rascunhos) ou Reverter (lançados). Desabilitado sem permissão.
#Postar um rascunho
- Abra o rascunho e clique em Lançar.
- Confirme Lançar estoque inicial? → Lançar.
- "Estoque inicial lançado." O status torna-se Lançado e o Resultado do razão mostra as linhas de "Entrada".
O lançamento é recusado quando:
| Mensagem | Causa |
|---|---|
| "Você não está atribuído a este armazém." | Armazém fora do seu escopo. |
| "O item … é rastreado por série; um número de série é obrigatório." / "… é rastreado por lote; um lote é obrigatório." | Números de série ou código de lote ausentes. |
| "O SKU do item é um serviço ou item que não é de estoque; ele não pode ter movimentações de estoque." | Tipo de item incorreto em uma linha. |
| "O compartimento selecionado não pertence ao armazém de movimentação." | Depósito de outro armazém. |
required_account_mappings_missing: inventory_asset, opening_offset |
SolaCount está conectado, mas as contas de Ativo de estoque e Compensação inicial não estão mapeadas. Mapeie-as em Administração → SolaCount. |
#Reverter uma entrada lançada
- Abra o lançamento efetuado e clique em Estornar.
- A caixa Estornar stock inicial? diz «O estorno acrescenta lançamentos opostos aos da origem original. Os lançamentos originais permanecem inalterados.» Introduza um Motivo (obrigatório, de 3 a 500 caracteres: Explique por que este documento de origem está a ser estornado).
- Clique em Estornar. Você verá "Estoque inicial estornado." O status torna-se Estornado; linhas de "Saída" datadas de hoje são adicionadas.
A reversão é um documento próprio, numerado REV-OS-…, com linhas próprias no razão. As linhas originais ficam inalteradas e o separador Resultado no razão da entrada de stock inicial passa a listar os movimentos originais e os movimentos opostos da reversão. Quando o SolaStock está ligado, um evento Stock inicial revertido segue o evento original Stock inicial contabilizado, e o SolaCount contabiliza uma única vez o inverso exato do lançamento original.
O estorno é recusado, para qualquer método de custeio (FIFO e média ponderada), quando o estoque aberto foi movimentado desde então:
- «Não é possível reverter este stock inicial porque o stock adicionado já foi consumido a jusante. Reverta primeiro o documento a jusante.» Houve saída do mesmo artigo, armazém, lote e posição após contabilizar o stock inicial, por venda, transferência, ajuste ou consumo interno.
- "Não é possível estornar este estoque inicial porque o estoque que ele adicionou não está mais totalmente disponível." - menos do que a quantidade aberta está disponível agora.
Reverta primeiro os documentos posteriores ou corrija o stock com um ajuste. Consulte o Stock atual antes de reverter. Com a ligação ativa, a reversão também é recusada se não estiver abrangida pela ligação revista ou se as contas não estiverem associadas (consulte SolaCount). Uma entrada inicial contabilizada quando não estava ligado pode continuar a ser revertida localmente; nada é enviado ao SolaCount, porque o SolaCount nunca recebeu a operação original.
#Importação em lote via CSV
- Na lista, em Importação em massa, escolha o Armazém. Importar CSV permanece desativado até que você o faça ("Escolha um armazém antes de importar.").
- Decida Lançar após importação. Deixe desmarcado para revisar um rascunho primeiro (recomendado).
- Clique em Importar CSV (mostra Importando…) e escolha um arquivo
.csvde até 10 MB. - Sucesso: "Importadas :count linhas." (rascunho) ou "Importadas :count linhas e lançado o estoque inicial." A nova entrada está datada de hoje com as notas "Importação em massa de estoque inicial".
| Coluna | Obrigatório | Notas |
|---|---|---|
sku (SKU do item) |
Sim | Corresponde a um item existente. |
name (Nome do item) |
Sim para novos SKUs | Se a coluna estiver presente, ela não deve estar em branco. |
quantity (Quantidade) |
Sim | Positivo. |
unit_cost (Custo unitário) |
Sim | Custo por unidade base. |
lot_code (Código do lote) |
Itens do lote | |
expiry_date (Data de validade) |
Opcional | YYYY-MM-DD. |
bin_id (ID do depósito) |
Opcional | Número interno do compartimento no armazém escolhido. |
category_id, base_unit_id |
Novos SKUs | IDs internos de uma categoria e unidade ativa. |
notes |
Opcional | Observação da linha. |
Um SKU inexistente é criado como artigo de inventário ativo, média ponderada e preço de compra igual ao custo unitário, apenas com category_id e base_unit_id válidos: «Cada novo artigo de inventário precisa de category_id e base_unit_id válidos. Linha n.» Conta para o limite do plano. Artigos rastreados por série não podem ser importados assim, sem coluna de série; registe-os manualmente.
Os erros de linha interrompem a importação e identificam a linha, sendo o cabeçalho a linha 1: «Cada linha de importação precisa de SKU e nome. Linha n.», «Cada linha de importação precisa de uma quantidade positiva. Linha n.» Num ficheiro vazio: «O ficheiro de importação não contém linhas de artigos.» Os artigos criados antes da linha com erro são mantidos. Corrija o ficheiro e importe novamente; esses SKU passam a corresponder aos artigos já criados.
Arquivo de exemplo:
sku,name,quantity,unit_cost,lot_code,expiry_date
CHG-USB-C,USB-C Charger 30W,300,24.5000,,
SNS-VITC,Vitamin C 1000mg,120,18.7500,LOT-2609,2027-09-30
CASE-IP15,iPhone 15 Clear Case,500,6.2000,,
#Permissões
| Ação | Proprietário / Administrador | Gerente de organização / Membro | Funções com escopo, Visualizador, Contador |
|---|---|---|---|
| Ver lista e lançamentos | Todos | Armazéns atribuídos | Armazéns atribuídos |
| Criar, editar, importar | Sim | Sim (atribuído) | Não |
| Lançar, reverter | Sim | Sim (atribuído) | Não |
#Exemplos práticos
#Exemplo 1 — Um armazém, manual (rápido)
{User 2 name} abre Nova entrada, armazém {Warehouse 2 name}, linha USB-C Charger 30W 200 PCS a 24.5000. Valor total 4,900.00. Guardar e contabilizar → Contabilizar → «Stock inicial contabilizado.» Entrada OS-000004; Stock atual mostra 200 em {Warehouse 2 name}.
#Exemplo 2 — Importação de início de operação e contabilidade (completo)
A {Organization name} inicia suas operações em 1 de outubro de 2026 com o SolaCount conectado.
- {User 2 name} importa o CSV acima para {Main warehouse name}, Lançar após importação desmarcado: "Importadas 3 linhas." O rascunho
OS-000005mostra Valor total 7.350 + 2.250 + 3.100 = AED 12.700. - Abre-o, clica em Editar, define Data de abertura 30-09-2026, adiciona a localização
A-01à linha do carregador, volta a introduzir o loteLOT-2609/ validade 2027-09-30 para Vitamin C e adiciona uma linha iPhone 15 Pro 256 GB com 25 números de série lidos a 3,850 (quantidade 25, AED 96,250). Valor total AED 108,950. - Salvar e lançar → confirmar. O Resultado do razão mostra quatro tipos de linhas de "Entrada" datadas de 30/09/2026 (uma por série para os iPhones).
- O SolaCount recebe o evento de estoque inicial: Ativo de estoque debitado AED 108.950, Compensação inicial (patrimônio líquido) creditada AED 108.950.
- Dois dias depois, ele percebe que o custo da caixa deveria ser 5,9000. As caixas já foram vendidas, então, em vez de reverter, ele lança um ajuste para a diferença de valor.
#Como se conecta
- Cria as primeiras linhas no Razão de Estoque e os saldos em Estoque Atual.
- Cria lotes e números de série usados pelo Rastreabilidade.
- Envia eventos
opening_stock.posted/opening_stock.reversedpara SolaCount (Ativo de estoque vs Compensação inicial) — veja Integração SolaCount. - Mostra no Painel o valor do estoque.
#Dicas e problemas comuns
| Problema | Causa | Solução |
|---|---|---|
| Item ausente no seletor de linhas. | Serviço, não inventariável ou inativo. | Verifique o item. |
Meu número de documento foi substituído por OS-…. |
Novas entradas sempre recebem um número gerado. | Edite o rascunho para alterá-lo. |
| Os códigos de lote desapareceram quando editei o rascunho. | O formulário de edição não recarrega dados de lote/série. | Insira-os novamente antes de salvar. |
| "Você não está atribuído a este armazém." | Armazém fora do seu escopo. | Escolha outro ou peça a um administrador. |
| Custo incorreto após o lançamento. | — | Reverta se nada tiver consumido o estoque; caso contrário, faça um ajuste. |
| A importação falhou no meio do processo. | Um erro de linha. | Corrija a linha mencionada na mensagem e importe novamente. |
Lance o estoque inicial antes de recibos de compra e vendas para que as camadas FIFO e médias comecem a partir do custo correto.