====== Romaneios de Carga ======

O **romaneio de carga** — também chamado de //Espelho Cego// ou //Packing List// — é um documento de controle utilizado para registrar as informações de cada carga transportada: o produto, o cliente, o veículo, o motorista, os pesos e os descontos de qualidade. Ele funciona como um registro intermediário que antecede ou acompanha a emissão da nota fiscal.

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

Menu **''Produtor Rural''** → **''Romaneios de Carga''**.

\\
===== Lista de romaneios =====

A tela principal exibe todos os romaneios do período, com informações de cliente, produto, safra, placa do veículo, pesos e situação. Romaneios **cancelados** aparecem riscados e em cor mais clara.

A lista é atualizada automaticamente quando outro usuário inclui ou altera um romaneio, sem necessidade de sair e voltar à tela.

\\
===== Registrando um romaneio =====

Para incluir um novo romaneio:

  - Clique em **Novo** (ou pressione **Insert** ou **F5**).
  - Selecione o **produto** que está sendo transportado — essa escolha é obrigatória antes de abrir o formulário.
  - Preencha os dados do romaneio.

^ Campo ^ Descrição ^
| Produto | Produto transportado (definido na etapa anterior) |
| Safra | Identificação da safra ou período de colheita |
| Tipo | Classificação da carga (conforme uso da empresa) |
| Cliente | Quem está entregando ou recebendo a carga |
| Nota Fiscal | Número e série da nota fiscal que acompanha a carga (quando houver) |
| Data de Emissão | Data do romaneio |
| Hora de Entrada / Saída | Horário de chegada e saída do veículo |
| Placa | Placa do veículo |
| Transportadora | Empresa responsável pelo transporte |
| Motorista | Motorista que conduziu o veículo |

\\
===== Pesagem e cálculo do peso líquido =====

A aba **Pesagem** registra os pesos da carga e os descontos de qualidade:

<uml>
@startuml
skinparam backgroundColor white
skinparam sequenceArrowThickness 2
skinparam sequenceParticipantBackgroundColor #EBF5FB
skinparam sequenceParticipantBorderColor #2471A3
skinparam sequenceArrowColor #2471A3

participant "Peso Bruto" as B
participant "Tara" as T
participant "Peso Parcial\n(Bruto − Tara)" as P
participant "Descontos\n(kg)" as D
participant "Peso Líquido\n(Parcial − Descontos)" as L

B -> P : subtrai Tara
T -> P
P -> L : subtrai Descontos
D -> L
@enduml
</uml>

^ Informação ^ Como é obtida ^
| Peso Bruto | Pesagem do veículo carregado |
| Tara | Peso do veículo vazio |
| Peso Parcial | Peso Bruto menos a Tara — calculado automaticamente |
| Descontos (kg) | Soma dos descontos de qualidade |
| Peso Líquido | Peso Parcial menos os Descontos — calculado automaticamente |
| Sacas | Peso Líquido dividido por 60 — calculado automaticamente |

\\
===== Descontos de qualidade =====

Os descontos representam a perda de peso devida a impurezas e problemas na qualidade do produto. Para cada fator, informa-se o **percentual** e o sistema calcula a quantidade em **quilos** que será descontada:

^ Fator ^ O que representa ^
| Umidade | Excesso de água no produto |
| Impureza | Presença de materiais estranhos (terra, palha, pedras) |
| Avariação | Grãos danificados ou com defeito |
| Quebrados | Grãos partidos |
| Grão Verde | Grãos imaturos, colhidos antes do ponto ideal |
| Outros | Qualquer outro desconto não enquadrado nas categorias acima |

O total de todos esses fatores em quilos forma o campo **Descontos**, que é subtraído do Peso Parcial para obter o Peso Líquido.

\\
===== Cancelando e reativando um romaneio =====

Para cancelar um romaneio, selecione-o na lista e clique em **Cancelar** (ou pressione **Delete** ou **F8**). O sistema pedirá confirmação. Romaneios cancelados aparecem riscados e não devem ser utilizados para emissão de documentos.

Caso o cancelamento tenha sido feito por engano, selecione o romaneio cancelado e clique em **Cancelar** novamente — o sistema perguntará se deseja **anular o cancelamento** e retornará o romaneio ao estado normal.

\\
===== Imprimindo o romaneio =====

Com o romaneio selecionado na lista, clique em **Imprimir** (ou pressione **F8** no romaneio desejado). O sistema gera o documento com os dados do romaneio, incluindo a identificação da empresa, produto, pesos e informações do transporte.

\\
===== Ações disponíveis =====

^ Ação ^ Tecla de atalho ^
| Novo romaneio | Insert ou F5 |
| Editar | F6 ou Espaço |
| Visualizar (somente leitura) | F7 |
| Cancelar / Anular cancelamento | Delete ou F8 |

\\
===== Veja também =====

  * [[ello_erp:modulos:produtor_rural|Módulo de Produtor Rural]]
  * [[ello_erp:modulos:produtor_rural:propriedades_rurais|Propriedades Rurais]]