Guias
Unidades de medida
Toda quantidade de estoque tem uma unidade. É ela que diferencia 3 caixas de 3 quilos, define o limite padrão de estoque baixo e permite somar itens comparáveis nos relatórios.
Para que servem
Cada item aponta para uma unidade de medida em unit_of_measure_id. A unidade dá sentido ao número: sem ela, uma quantidade de 12 pode ser 12 unidades, 12 quilos ou 12 litros. Ao amarrar cada item a uma unidade, a Quobo consegue mostrar o estoque com a abreviação certa (UN, KG, L), sugerir um limite de estoque baixo coerente e agregar itens da mesma natureza nos relatórios.
Categorias
Toda unidade pertence a uma categoria, que fixa a grandeza que ela mede. Isso impede unidades vagas como “Grande” ou “Pacote”, que quebrariam qualquer comparação. São seis:
| Categoria | Mede | Exemplos |
|---|---|---|
count | Contagem (itens discretos) | Unidade, caixa, dúzia, par |
mass | Massa | Quilograma, grama |
volume | Volume | Litro, mililitro |
length | Comprimento | Metro, centímetro |
area | Área | Metro quadrado |
time | Tempo | Hora |
Unidades globais e próprias
A Quobo já vem com um conjunto de unidades globais, compartilhadas por todas as organizações. Você também pode criar unidades próprias da sua organização. Se uma unidade sua tiver o mesmo nome de uma global, a sua substitui a global na listagem, sem afetar as outras contas.
- namestringobrigatório
- Nome da unidade, até 60 caracteres, único dentro da organização.
- abbreviationstring
- Abreviação exibida junto da quantidade, ex. KG, UN, CX.
- categoryenumobrigatório
- Uma das seis categorias acima.
- low_stock_thresholdinteger
- Limite padrão de estoque baixo para itens nesta unidade quando o item não define o seu próprio. Veja estoque baixo.
- is_globalboolean
- True para as unidades que a Quobo distribui; suas unidades vêm como false.
- activeboolean
- Unidades inativas ficam ocultas na seleção.
Unidades já inclusas
Estas são as unidades globais que acompanham toda conta, com o limite de estoque baixo padrão de cada uma:
| Categoria | Unidade | Abrev. | Limite padrão |
|---|---|---|---|
| count | Unidade | UN | 5 |
| count | Caixa | CX | 3 |
| count | Pacote | PCT | 5 |
| count | Fardo | FD | 3 |
| count | Saca | SC | 3 |
| count | Dúzia | DZ | 2 |
| count | Par | PAR | 5 |
| count | Peça | PÇ | 5 |
| mass | Quilograma | KG | 10 |
| mass | Grama | G | 100 |
| volume | Litro | L | 5 |
| volume | Mililitro | ML | 100 |
| length | Metro | M | 5 |
| length | Centímetro | CM | 50 |
Unidades por pacote
Muitos negócios compram numa unidade e vendem em outra: chega uma caixa com 12 unidades, mas a venda é por unidade. Para isso, um item pode declarar uma unidade de pacote (pack_unit_of_measure_id) e quantos itens-base ela contém (units_per_pack). A unidade de pacote precisa ser da categoria count.
Quantidades fracionadas
Nem tudo se conta em inteiros. Areia se recebe em quilos, líquido em litros. Por isso as quantidades de estoque aceitam até três casas decimais: você pode registrar 12,500 KG ou 3,250 L. A precisão vale para a quantidade em estoque, o estoque mínimo e o estoque de segurança.
Escolha a unidade que casa com a compra
Meça o item na unidade em que você de fato movimenta: se compra e conta em quilos, use KG; se conta peças inteiras, use UN. É essa escolha que faz o estoque baixo e os relatórios baterem com a realidade da prateleira.