Central de Ajuda Quaza Provedores

Estoque (PT)

Estoque — Quaza

Estoque — Equipamentos, Movimentações e Compras — Como Quaza controla lo que entra, lo que sale y lo que está con cada técnico/cliente

Esta guía explica desde cero o módulo Estoque — para quien nunca usó un sistema de control de inventario de provedor de internet. Todo equipo (ONU, router, switch, cable) que sale da matriz, va al técnico y termina en la casa do cliente pasa por aquí.

O que es o módulo Estoque? Es donde está cada ítem físico do provedor: ONUs en el depósito, routers en la furgoneta do técnico, switches en uma CTO, o un equipo ya instalado en la casa do cliente. El sistema rastrea onde está, quién manipuló, cuánto costó e si aún funciona (RMA).

Nesta wiki:

Visão geral — a cadeia do estoque
Glossário — conceitos antes das telas
Fluxos típicos passo-a-passo
Pegadinhas frequentes
Documentos relacionados
Perguntas frequentes

Visão geral — a cadeia do estoque

Antes de profundizar en as telas, comprende la relación entre os 5 conceitos centrales:

┌──────────┐ ┌────────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ COMPRA │───→│ PRODUCTO │───→│ EQUIPO ───→│ MOVIMIENTO ───→│ UBICACIÓN │ │ (XML/NF) │ │ (cadastro) │ │ (item físico)│ │ (onde foi) │ │(estoque/cli)│ └──────────┘ └────────────┘ └──────────┘ └──────────┘ └──────────┘ │ ↓ ┌──────────────┐ │ CATEGORÍA │ → fiscalização (NFe, ICMS, IPI...) │ UNIDAD │ → cx, kg, unid, kit │ PROVEEDOR │ → de onde veio └──────────────┘

Resumiendo: tú compras un ítem (gera fatura), se vuelve un producto registrado, cada ítem físico é um equipamento con serial único, y se mueve entre ubicaciones (depósito → técnico → cliente).

Glossário — conceitos antes das telas

Producto × Equipe — no es lo mismo!

	Produto	Equipamento
O que es	Tipo/modelo registrado uma vez no catálogo	Ítem físico individual con número de serie
Ejemplo	"Router Mikrotik RB750GR3"	"Router con serial V25A011001415" (una unidad específica)
Cantidad	1 registro pode tener 100 equipos vinculados	1 equipo = 1 unidad física
Onde está	Estoque → Producto	Estoque → Equipe

Trampa: Cuando un técnico instala "una ONU" en la casa do cliente, está vinculando un equipo específico (ej: serial FHTT2D2C8360) al contrato — no "cualquier ONU do tipo X". Esto permite trazabilidad total: si esa ONU falla en 6 meses, sabes quién instaló, quando y que modelo.

Tipos de producto

Tipo	Quando usar	Exemplo
Produto	Ítem físico que se almacena (sin serial individual obligatorio)	Cable de fibra, conector, tornillo
Equipamento	Ítem físico con serial — trazable individualmente	ONU, Router, Switch, Decodificador
Serviço	Mano de obra cobrada (instalação, visita técnica)	Instalación fibra, traslado técnico
SVA	Serviço de valor agregado vinculado al plan	Streaming, antivirus, IP fijo

Tipos de movimiento

Tipo	O que é	Quando acontece
Entrada	Ítem entró al inventario	Compra, devolución de cliente, retorno de RMA
Saída	Ítem salió do inventario	Venta puntual, pérdida, descarte
Transferência	Ítem cambió de ubicación (sin salir do sistema)	Depósito → Técnico, Técnico → Cliente, RMA → Provedor
Consumo	Ítem usado en uma OS de instalação	Cable cortado para instalação, conector fusionado
RMA	Ítem con defecto enviado al provedor	ONU quemada, switch defectuoso en garantía

1 Estoque — el estado actual

Estoque → Estoque

Vista consolidada de cuánto há de cada producto, en cada ubicación. Es la tela más usada para responder "tengo ONU disponible?", "cuánto cable de fibra queda en el depósito?".

Inventário consolidado — saldo por producto y por ubicación. Note os botones "Adicionar inventario" e "Transferencia de inventario" arriba.

Columna	O que mostra
Produto	Modelo do produto registrado
Ubicación	Onde está físicamente (Estoque Geral, con Cliente, con Técnico)
Saldo en inventario	Cantidad disponible en esta ubicación
Modificación	Última movimentación registrada

Casos de uso reales:

"Cuántas ONUs quedan en el depósito geral?" — filtra por Ubicación=Depósito Geral, Producto=ONU
"O que técnico tem más equipos?" — agrupa por Ubicación, ordena por Saldo
"Cliente dice que no recibió equipo" — filtre por Local=Cliente Exemplo X — ve todo lo que tem

Estoque Individual

Estoque → Estoque Individual

Versión expandida: lista cada equipo individualmente con número de serie, técnico responsable, orden de servicio de origen.

Inventário individual — cada línea es un equipo físico, con serial y OS de movimentación

Diferencia práctica: "Estoque consolidado" dice "3 ONUs en el depósito". "Estoque individual" dice "ONU serial FHTT2D2C8360 está con técnico Cliente Exemplo X desde la OS AT098631". El segundo es para trazabilidad fina.

2 Catálogo — lo que vendes/usas

Productos

Estoque → Producto

Registro maestro de productos/equipos/serviços. Cada producto tem categoría fiscal (que define como será tratado en la fatura electrónica), valor de costo, valor de venda, código de referencia interno.

Catálogo de productos — note as pestañas pre-creadas (Roteador, ONU, Switch, Sucata, Cabo de Rede, etc.) y columnas con saldo, costo y venda

Campo	Para que sirve
Nome	Descripción completa (aparece en fatura)
Categoría	Agrupa para fiscal e informes — ver Categorías abajo
Tipo	Equipe / Producto / Serviço
Referencia	Código interno (ex: `NT_UNIFIU7`)
Unidad	Unidad de medida (cx, kg, unid)
Valor costo	Cuánto pagaste al provedor
Valor venda	Cuánto cobras al cliente
Categoría fiscal	NCM, CFOP, ICMS — campos da fatura

Usa pestañas/filtros pre-creados: as pestañas "Roteador", "ONU", "Switch", "Cabo de Rede", "Sucata", etc. son filtros guardados. Crea as tuyas (Filtros → Salvar como pestaña) para encontrar rápido.

Unidades

Estoque → Unidad

Unidades de medida usadas en el catálogo. Cada provedor define as suyas (kg para cable, unid para equipo, kit para material agrupado).

Unidades de medida — usadas en el campo "Unidad" de cada produto

Ubicaciones

Estoque → Ubicación

Os ubicaciones físicas donde el inventario pode estar. Categorizadas en Fijo (depósito, RMA, guardia) ou Móvil (furgoneta do técnico, equipo externo). Dos ubicaciones especiales y automáticas:

Cliente — destino cuando el equipo se instala en casa do cliente
Técnico — destino cuando va al equipo técnico antes da instalação

Ubicaciones de estoque — note el Tipo (Fijo/Móvil), Técnico responsable y Situação (Habilitado/Desabilitado)

Ubicaciones móveis vs fixos: use Móvil pra vans/equipes que circulam. Sistema permite rastrear "ONU XYZ está con Equipe 02" sin tener que criar un registro para cada técnico individual do equipo.

3 Entrada de inventario — Compras e Importación XML

Compras manuales

Estoque → Compra

Registro de compras hechas por el provedor — cuando compras equipos do provedor para reponer inventario. Cada compra tem provedor, número do documento (NF do provedor), fecha y valor total.

Listagem de compras — pestañas Estándar / Compras movidas / Compras sin documento

Quando usar:

Compra manual: provedor envió producto sin NFe (raro pero ocurre — comprar de un técnico autónomo)
Ajuste retroactivo: producto entró sin NF en el momento
Importaciones de otras empresas, donaciones, transferencia interna

Importación XML (NFe do provedor)

Estoque → Importación Xml

Camino automatizado: el provedor envía la NFe (XML), la anexas aquí y Quaza crea automáticamente la compra, el movimiento de entrada e incluso registra productos nuevos (mapeando NCM/EAN).

Importaciones XML — note o nome do arquivo (clave de acesso da NFe), fornecedor, total importado y valor total

Fluxo recomendado: sempre que sea posible, usa Importación XML. Manual está sujeto a error de tipeo y no crea os movimientos con la precisión fiscal correcta. XML automatiza todo: produtos registrados ganham EAN/NCM/valor, y la entrada ya queda vinculada a la NFe.

4 Equipamentos — ítems físicos rastreados

Estoque → Equipe

Cada ítem físico que tem serial aparece aquí. Diferente do producto (que es el catálogo), el equipo es la unidad individual — uma ONU específica, un switch específico.

Equipamentos — note as pestañas (RMA, Plantão, Estoque Geral, Telecomunicações, Eventos), serial/MAC, patrimonio, ubicación actual

Campo	Para que sirve
Serial / MAC	Identificador único do equipo — cada ONU tem el suyo
Patrimonio	Código interno (etiqueta pegada en el equipo)
Ubicación	Onde está ahora (Depósito Geral, Cliente, Técnico, RMA)
Técnico	Si está en poder de alguien, quién es
Cliente	Si ya fue instalado, en qual cliente
Valor de costo	Cuánto costó reponer (importante para contabilidad)

5 Movimentações — lo que pasó

Estoque → Movimiento

Historial cronológico de cada movimiento de equipo/producto: entradas de compra, salidas a cliente, transferencias entre técnicos, devoluciones, RMA.

Movimentações — note as pestañas Equipamentos Vendidos / Equipamentos baixados, y os cores: verde (entrada) / vermelho (salida)

Columna	O que mostra
Produto	O que producto/equipo
Operação	Tipo (Transferencia, Entrada, Salida, RMA)
Tipo de operação	Refinamiento (Entrada/Salida en transferencia interna)
Ubicación	Origen o destino
Cliente / Técnico	Quién está involucrado
Cantidad	Cuántos ítems
Saldo actual	Saldo do producto en esa ubicación depois do movimiento

Movimentações no se borran. Para "estornar" un movimiento equivocado, geras un movimiento contrario (si fue salida → entrada, si fue transferencia A→B → transferencia B→A). Esto preserva o histórico fiscal/contable.

Productos Utilizados

Estoque → Utilizados

Informe de consumo de material en as órdenes de servicio — útil para calcular costo real de instalação, identificar técnicos que gastan más material que otros, y hacer cierre de comisiones por OS.

Informe de produtos utilizados — formulario de filtros por período, técnico, cliente, producto

Fluxos típicos passo-a-passo

Fluxo 1: Recibir compra con NFe

Passo	Onde	O que fazer
1	Estoque → Importación Xml	Anexar XML da NFe enviada por el provedor
2	Sistema valida	Verifica chave de acesso, fornecedor registrado, produtos
3	Mapear productos	Si el producto es nuevo, sistema sugiere registro automático
4	Confirmar importación	Sistema crea la compra + movimientos de entrada por equipo
5	Verificar	Estoque → Estoque mostra saldo atualizado

Fluxo 2: Entregar equipo al técnico

Passo	Onde	O que fazer
1	Estoque → Estoque	Localizar producto disponible en el Depósito Geral
2	Botão Transferencia de inventario	Origen: Depósito Geral, Destino: Ubicación Técnico/Equipe
3	Selecioner equipo(s)	Por serial/patrimonio
4	Confirmar	Sistema gera movimiento de transferencia
5	Estoque do técnico	Equipe aparece como "con Técnico X"

Fluxo 3: Instalação en la casa do cliente

Passo	Onde	O que fazer
1	Orden de servicio	Técnico abre OS de instalação en la app
2	App → Adicionar producto	Técnico escanea/selecciona equipo que va a instalar
3	Sistema vincula	Equipe sale de "Técnico" → va a "Cliente Exemplo X"
4	Movimiento creado	Tipo: Transferencia, Origen: Técnico, Destino: Cliente
5	Equipe en la casa	Estoque muestra "ONU FHTT2D2C8360 con Cliente Exemplo X desde 05/05"

Fluxo 4: Equipe defectuoso (RMA)

Passo	Onde	O que fazer
1	Cliente reclama	Técnico va a retirar
2	OS de retirada	Técnico marca equipo como "Retirado con defecto"
3	Movimiento	Cliente → Técnico → Ubicación "Estoque RMA"
4	Estoque → Equipe aba RMA	Lista equipos para envío al provedor
5	Envío al provedor	Movimiento de salida + abrir RMA con provedor (externo)
6	Retorno do provedor	Equipe vuelve (reparado/sustituido) → Movimiento de entrada → Depósito Geral

Pegadinhas frequentes

1. Saldo "negativo" en el inventario. Ocurre cuando das salida de un equipo sin haber dado entrada antes (registro retroactivo equivocado). El sistema lo permite pero es signo de registro inconsistente — ejecuta Auditoria de Compras para corregir.

2. Equipe con serial en dos ubicaciones. No ocurre automáticamente — es bug si aparece. Significa que hubo transferencia sin el movimiento de salida anterior. Usa Movimiento → Filtrar por serial para ver histórico y descubrir que movimiento se saltó.

3. Precio de venda × costo de compra. Cada compra pode alterar el costo medio do producto (FIFO/medio segundo la config). Verifica si tu contabilidad quiere costo medio o costo da última compra antes de configurar.

4. Categoría fiscal errada quebra emissão de nota. Si la categoría do producto está equivocada (ej: "Serviço" en lugar de "Mercancía"), el sistema intentará emitir NFSe cuando devería emitir NFe — y la SEFAZ rechaza. Verifica en Fiscal Brasil .

5. Productos sem unidade fiscal não vão pra NFe. Si el producto não tem unidad configurada, la NFe no cierra. Sempre verifica ese campo antes de habilitar emisión automática.

6. Ubicación "Cliente" y "Técnico" son especiales. No os borres — el sistema os usa automáticamente cuando instalas/retiras equipo vía OS. Si os borras, flujos rompen.

Galeria de telas

Documentos relacionados

Aprofunde-se nos temas conexos:

Cliente — donde se instalan os equipos (vínculo Cliente → Contrato → Equipe)
Suporte / OS — instalação/retiro de equipo vía OS
Fibra e Rede — ONU, router y fibra que estos equipos usan técnicamente
SVA / NFeSVA — categoría fiscal de producto SVA (Serviços de Valor Agregado) que emite NFeSVA
Painéis / Dashboards — visión ejecutiva, indicadores diarios y alertas operacionales
Telefonia (VoIP + MVNO) — serviços de voz fija y móvil que poden ser vendidos junto con internet
Administração — configuraciones, usuários, permisos (ACL), tarefas (crons) y logs de auditoria
Comunicação — Email, SMS, WhatsApp y campañas masivas para clientes
Chat — atención omnicanal en vivo (WhatsApp, bot, respuestas rápidas)
Portal / Área do Cliente — autoatendimento do cliente final (2da vía, OS, dependientes, recomendaciones)
Mapa — visualización geográfica de clientes, CTOs, postes, cables FO (georreferencia)
Fiscal Brasil — emisión de NFe en entrada/salida de producto
FaturaSend — para Paraguai (DE de productos)
Vendas — venda puntual de equipo (tasa de instalação, equipo extra)
Plano de Vendas — equipo incluido en el plan (ej: ONU como obsequio)
Cobrança — cobrança da venda do equipo
Plano de Contas — plan contable para conta de Estoque

Perguntas frequentes

Como sé cuánto há de cada producto disponible para venda?
Estoque → Estoque, filtra por Ubicación=Depósito Geral. El Saldo es lo que está disponible para entrega.

Onde acho un equipo específico (por serial)?
Estoque → Equipe, busca rápida por Serial/MAC o Patrimonio. Muestra ubicación actual + histórico de movimientos.

Puedo añadir producto sin registrarlo en el catálogo?
Não. Todo equipamento precisa estar associado a um Produto registrado (aunque genérico tipo "ONU suelta"). Sin registro, fiscal no cierra.

Como hago inventario físico (conteo manual)?
Imprime el informe Estoque → Estoque Individual, conta físicamente, y para cada divergencia gera movimiento de ajuste (entrada o salida) con motivo "Ajuste de inventario".

O que aparece en la pestaña "RMA" de os equipos?
Equipamentos en la ubicación "Estoque RMA" — defectuosos esperando envío al provedor o ya enviados en garantía.

Como vincular equipo a la instalação do cliente?
Por la app do técnico durante la OS, o manualmente en Cliente → Contrato → pestaña Equipe → Adicionar.

Puedo transferir producto entre filiales (empresas diferentes)?
Sí, pero se vuelve salida de uma empresa y entrada en la otra (con NFe de transferencia). Configura en Fiscal Brasil .

Como medir o sucesso operacional?

Defina 3 KPIs e acompanhe semanalmente. Tendência importa mais que valor absoluto.

Há treinamento oficial Quaza?

Sim — equipe de suporte oferece sessões de onboarding. Documentação rica também ajuda.

Como reportar bug ou pedir nova feature?

Pelo canal de suporte. Inclua contexto: o que esperava, o que aconteceu, frequência do problema.

Como começar a usar este módulo?

Configure os pré-requisitos, faça um teste com poucos registros, valide com a equipe, e só então ative em produção.

Preciso de permissão especial?

Sim. Cada papel (operador/supervisor/admin) tem permissões distintas. Confirme com administrador.