====== Posse de Explosivos ======

A **Posse** representa uma entrada de explosivos na empresa — geralmente atrelada a uma Nota Fiscal de compra emitida pelo fornecedor. Ela registra quais produtos foram recebidos, em quais lotes e com quais identificações individuais (IIS).

===== Como acessar =====

Menu principal → **Explosivos** → **Posse de Explosivos**.

===== Registrando uma nova Posse =====

==== Importação via XML ====

O método recomendado é importar o arquivo XML enviado pelo fornecedor junto à NF-e:

  - Clique em **Novo** na listagem de posses.
  - Na aba **Produtos**, clique no botão **Abrir XML** (atalho F10).
  - Selecione o arquivo XML recebido do fornecedor.
  - O sistema preencherá automaticamente: CNPJ do vendedor, número e série da NF, Guia de Tráfego, fornecedor e os produtos com seus lotes e códigos IIS.
  - Se o fornecedor não estiver cadastrado, o sistema oferece a opção de criá-lo automaticamente.
  - Confirme os dados e salve.

==== Preenchimento manual ====

Caso não haja arquivo XML disponível:

  - Preencha os dados do cabeçalho (CNPJ vendedor, NF, Guia de Tráfego, datas).
  - Na aba **Produtos**, adicione cada produto manualmente com o botão **Adicionar** (F5).
  - Para cada produto, registre os **lotes** com Lote, IIS e data de produção.

===== Estrutura hierárquica de embalagens =====

Os produtos de uma Posse podem ter vários níveis de embalagem. Por exemplo: uma caixa contendo pacotes, cada pacote contendo cartuchos individuais. O sistema suporta essa hierarquia completa — cada nível registra seu próprio lote, IIS e data de produção.

===== Rastreabilidade =====

Para cada lote registrado na Posse são informados:

  * **Lote** — número do lote de fabricação.
  * **IIS** — código de identificação individual do item.
  * **Data de produção** — quando o item foi fabricado.
  * **Quantidade** — total de unidades naquele lote/embalagem.

===== Regras importantes =====

**Modificação limitada:** após o início do consumo dos produtos (quando qualquer quantidade já foi utilizada em um [[ello_erp:modulos:explosivos:plano_de_fogo|Plano de Fogo]]), a Posse entra em modo de edição limitada. Nesse estado, apenas a **data de recebimento** pode ser atualizada — a lista de produtos e lotes não pode mais ser alterada.

**Exclusão bloqueada:** não é possível excluir uma Posse que tenha produtos vinculados a um Plano de Fogo. Exclua primeiro os planos relacionados.

===== Dúvidas frequentes (Suporte) =====

**"Não consigo editar os produtos da Posse."**\\
A Posse está em modo de modificação limitada porque já há consumo registrado. Apenas a data de recebimento pode ser alterada.

**"O sistema não encontrou o fornecedor ao importar o XML."**\\
O CNPJ do vendedor no XML não está cadastrado. O sistema oferecerá a opção de criar o fornecedor automaticamente durante a importação.

**"Produtos aparecem com código zero na lista."**\\
Significa que o produto do XML não foi associado a um produto cadastrado no sistema. Use o botão **Sincronizar** (F9) para associar os produtos pendentes ao cadastro.