# Peças

O cadastro de **Peças** registra os itens utilizados nos reparos e vendidos no balcão, que são lançados nas Ordens de Serviço, no PDV e nos Pedidos.

---

## Acessando *(Novo)*

Menu **Suprimentos › Peças**. Com a reorganização do menu, o cadastro de peças saiu de *Cadastros* e passou a ficar junto das demais funcionalidades de estoque, em [[10 - Suprimentos|10 - Suprimentos]].

---

## Listando peças

A lista mostra **código**, **código de barras**, **nome**, **preço de compra**, **preço de venda** e **estoque** de cada peça. Peças com estoque igual ou abaixo da **quantidade mínima** aparecem destacadas em vermelho.

- **Buscar** — pesquise por **nome**, **código** ou **código de barras**. Veja *Buscando com o leitor de código de barras*, abaixo.
- **Estabelecimento** — em operações com estabelecimentos vinculados, um filtro permite escolher a unidade. Peças de estabelecimentos vinculados aparecem com um ícone de vínculo e abrem apenas para **visualização**.
- **Paginação** — ao trocar de página, a busca e o estabelecimento escolhidos são mantidos.

---

## Cadastrando uma peça

1. Clique em **Nova Peça**.
2. Informe o **nome**, **código**, **código de barras (GTIN)**, **marca**, **preço compra**, **preço venda**, **quantidade**, **quantidade mínima** e observação, se necessário.
3. Se a peça for vendida com nota fiscal, preencha a seção **Fiscal** (veja abaixo).
4. Se quiser, envie as **imagens** da peça (veja abaixo).
5. Conforme a necessidade, vincule os **fornecedores** da peça.
6. Salve.

![](./Captura_de_tela_2026-07-10_165006.png)

::: info
# Controle de estoque e financeiro
Observe que os dados de **Preço compra**, **Preço venda**, **Quantidade** e **Qtd Mínima** são importantes para a gestão de estoque e o relatório financeiro! Recursos extras em [[10.2 - Controle Estoque|10_2 - Controle Estoque]]
:::

> Quando a peça tem quantidade distribuída por **local de estoque**, o campo **Quantidade** fica bloqueado: ele passa a ser a soma dos locais, ajustada no [[10.2 - Controle Estoque|10_2 - Controle Estoque]].

---

## Código de barras (GTIN) *(Novo)*

O campo **Código de Barras (GTIN)** guarda o código impresso na embalagem da peça. São aceitos os padrões **EAN-13**, **EAN-8**, **UPC** e **DUN-14** (8, 12, 13 ou 14 dígitos).

- **Leia com o leitor** ou digite. Espaços, pontos e traços são ignorados: só os dígitos são guardados.
- **Conferência na hora**: o último dígito do código confere os anteriores. Um código digitado errado é recusado com a mensagem *"Código de barras inválido"*, e o que você já tinha preenchido no formulário é mantido.
- **Sem repetição**: o mesmo código de barras não pode estar em duas peças do estabelecimento. Se já estiver em uso, o sistema avisa em qual peça.
- **Opcional**: deixe em branco se a peça não tiver código de barras. Apagar o campo remove o código da peça.

### Buscando com o leitor de código de barras

Com o cursor no campo de busca, passe o leitor no código de barras: o código completo **localiza exatamente a peça** dele, sem trazer uma lista para escolher. Digitando à mão um pedaço do código, a busca continua mostrando todas as peças que o contêm.

A busca pelo código de barras funciona na lista de peças, no [[10.2 - Controle Estoque|10_2 - Controle Estoque]], ao incluir peças na [[05 - Ordens de Serviço|05 - Ordens de Serviço]] e na tela de venda do [[08.2 - PDV|08_2 - PDV]] e dos [[08.3 - Pedidos|08_3 - Pedidos]].

---

## Imagens da peça *(Novo)*

Cada peça pode ter **até 5 imagens**. Elas ajudam quem atende a confirmar que a peça é a certa, sem precisar ir até o estoque.

1. No cadastro da peça, no quadro **Imagens**, clique para escolher os arquivos (JPG, PNG, WEBP ou GIF). É possível escolher várias de uma vez.
2. As imagens escolhidas aparecem em **prévia**, com borda tracejada, antes de salvar.
3. Clique em **Salvar**: as imagens são **enviadas junto com o cadastro**.

Depois de salvar, o sistema confirma quantas imagens entraram. Se alguma for recusada (arquivo que não é imagem, acima de 15 MB ou além do limite de 5), o cadastro é salvo do mesmo jeito e a mensagem diz qual imagem ficou de fora e por quê.

### Compactação automática

As imagens são **compactadas automaticamente** ao enviar: são reduzidas para até 1280 pixels no maior lado e gravadas em JPEG, para **carregarem rápido** na OS e na tela de venda. A foto tirada "deitada" no celular é girada para a posição certa. Não é preciso diminuir a foto antes de enviar.

### Imagem principal, ver e excluir

- A **primeira imagem é a principal**, marcada com a etiqueta **Principal**. É ela que aparece primeiro na OS e na venda.
- Passe o mouse sobre outra imagem e clique em **Principal** para torná-la a imagem principal.
- Clique em **Excluir** para remover uma imagem. O sistema pede confirmação.
- Clique na imagem para abri-la em tamanho maior, com setas para passar entre as imagens e a opção de abrir em nova aba.

> [!TIP]
> Os botões **Principal** e **Excluir** gravam na hora. Se você alterou outros campos do cadastro, salve antes — alterações não salvas são perdidas.

Atingido o limite de 5 imagens, exclua uma para enviar outra.

### Onde as imagens aparecem

| Onde | Como |
|---|---|
| **Cadastro da peça** | Quadro **Imagens**, com a principal destacada |
| **Ordem de Serviço** | Botão **Ver imagem** ao lado da peça lançada na OS. Veja [[05 - Ordens de Serviço|05 - Ordens de Serviço]] |
| **Venda no PDV e Pedidos** | Miniatura da imagem principal na busca de itens e botão **Ver imagem** no item da venda e no detalhe dela. Veja [[08.2 - PDV|08_2 - PDV]] e [[08.3 - Pedidos|08_3 - Pedidos]] |

> As imagens contam no **armazenamento** do seu plano, como os demais arquivos enviados ao sistema. Veja [[12.2 - Assinatura (Meu Plano)|12_2 - Assinatura (Meu Plano)]].

---

## Fiscal *(Novo)*

A seção **Fiscal** traz os dados usados na **nota fiscal da peça** (NF-e ou NFC-e). Todos são opcionais no cadastro: a falta só pesa na hora de emitir a nota, e o sistema avisa o que completar.

| Campo | O que informar |
|---|---|
| **NCM** | Classificação fiscal da mercadoria, com **8 dígitos** |
| **CEST** | **7 dígitos**. Preencha só quando a peça estiver sujeita a substituição tributária (ST) |
| **Origem da mercadoria** | Nacional, estrangeira (importação direta ou adquirida no mercado interno) e demais opções da tabela da SEFAZ |
| **Unidade** | Unidade de venda, como **UN**, **PC** ou **KG** (até 6 letras) |
| **Perfil tributário** | Como a peça é tributada na nota. Na opção **Padrão da aba Vendas**, vale o perfil padrão definido na aba *Vendas* das [[12.4 - Parâmetros|12_4 - Parâmetros]] |

Um NCM ou CEST com a quantidade errada de dígitos é recusado ao salvar, sem perder o que foi digitado.

Os perfis tributários são cadastrados em [[10.5 - Perfis Tributários|10_5 - Perfis Tributários]].

> [!TIP]
> A emissão de notas fiscais está em fase de homologação e será liberada em breve. Você já pode deixar NCM, origem, unidade e perfil das peças preenchidos. Confira esses dados com a sua contabilidade. Veja [[08.4 - Notas Fiscais|08_4 - Notas Fiscais]].

---

## Visualizando e editando

- **Visualizar** — abre o cadastro em modo somente leitura, com as imagens, os fornecedores e os dados fiscais. *Requer a permissão **Visualizar** da rotina "Peças".*
- **Editar** — altera os dados da peça, envia e exclui imagens. *Requer a permissão **Editar** da rotina "Peças".*

Quem tem apenas a permissão de visualizar vê o ícone de visualização em cada linha da lista, no lugar do de edição. Veja [[12.1 - Usuários|12_1 - Usuários]].

---

> As peças adicionadas a uma OS compõem o valor do serviço. Veja [[05 - Ordens de Serviço|05 - Ordens de Serviço]].

---

## Integração com o Olist

Com a **Integração Olist** ligada, as peças são espelhadas com os produtos da sua conta Olist nos dois sentidos, inclusive o código de barras, e o saldo em estoque é mantido em linha com o do Olist. Veja [[12.4.1.1 - Olist|12_4_1_1 - Olist]].
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9