{"v":{"area":"admin","slug":"orders","path":"/home/tiixcom/public_html/sistema/docs/readme/admin/orders.md","relative_path":"docs/readme/admin/orders.md","title":"Pedidos","html":"<h1>Pedidos</h1><h2>Rota</h2><ul><li><code>/adm/orders</code></li></ul><h2>O que e</h2><p>Tela financeira para listar, criar e operar pedidos com itens.</p><h2>Para que serve</h2><ul><li>listar pedidos por contrato, cliente, status ou ID;</li><li>abrir a tela detalhada de um pedido;</li><li>criar um novo pedido com itens em JSON;</li><li>confirmar ou cancelar pedidos diretamente pela tabela;</li><li>buscar clientes para filtro ou preenchimento de novo pedido.</li></ul><h2>Blocos principais</h2><ul><li>hero Matdash com KPIs de pedidos, abertos, confirmados e total;</li><li>leitura consolidada do recorte atual;</li><li>alerta contextual sobre acoes financeiras;</li><li>tabela principal em <code>DataTable</code>;</li><li>offcanvas de filtros;</li><li>modal de novo pedido;</li><li>modal de busca de cliente;</li><li>modal de detalhes do cliente.</li></ul><h2>Botoes do topo</h2><ul><li><code>Novo Pedido</code>: abre o modal de criacao.</li><li><code>Filtrar</code>: abre o offcanvas com contrato, status, cliente e ID.</li><li><code>Atualizar</code>: recarrega a tabela mantendo o recorte atual.</li></ul><h2>Filtros</h2><ul><li><code>Contrato</code>: restringe pedidos ao contrato selecionado.</li><li><code>Status</code>: restringe por <code>open</code>, <code>confirmed</code> ou <code>cancelled</code>.</li><li><code>Cliente</code>: filtra por ID do cliente e permite abrir a busca de cliente.</li><li><code>Busca (ID exato)</code>: procura por ID especifico.</li><li><code>Aplicar filtros</code>: recarrega o DataTable com o recorte informado.</li><li><code>Limpar filtros</code>: remove status, cliente e busca; limpa contrato quando o usuario pode selecionar contratos.</li></ul><h2>Tabela</h2><p>A tabela usa DataTable para busca local, ordenacao, paginacao e controle de quantidade exibida.</p><h2>Acoes da tabela</h2><ul><li><code>Abrir</code>: acessa a tela detalhada do pedido.</li><li><code>Confirmar</code>: confirma o pedido pela API financeira.</li><li><code>Cancelar</code>: cancela o pedido pela API financeira.</li><li><code>Ver cliente</code>: abre o modal com dados seguros do cliente quando existe cliente vinculado.</li></ul><h2>Observacoes</h2><ul><li>A criacao de pedido espera itens em JSON no formato <code>{type, ref_id?, qty, unit_price, description?}</code>.</li><li>O resumo do hero considera o recorte retornado pela API.</li><li>Confirmar e cancelar pedidos tem efeito direto no status financeiro.</li></ul>"},"exp":1780849823}