Skip to main content

​
Requests: Orçamentos e Pedidos

No sistema PIED, “requests” são o núcleo do negócio, representando tanto orçamentos quanto pedidos de sistemas de energia solar.

​
Tipos de Request

​
Orçamentos (Budget)

Propostas iniciais para clientes, incluindo:
  • Especificações técnicas do sistema
  • Lista de equipamentos necessários
  • Cálculos de potência e geração
  • Valores e condições comerciais

​
Pedidos (Order)

Orçamentos aprovados que se tornaram vendas efetivas:
  • Confirmação de todos os dados do orçamento
  • Status de produção e entrega
  • Controle de estoque reservado
  • Gestão de pagamentos

​
Fluxo de Status

​
Campos Principais

​
Identificação

  • ID: Identificador único interno
  • Code: Código visível para o cliente (ex: 200000001)
  • Name: Nome descritivo do projeto

​
Especificações Técnicas

  • Kind: Tipo do sistema (Kit Personalizado, etc.)
  • TotalPower: Potência total em kWp
  • Equipment: Lista detalhada de equipamentos

​
Valores Comerciais

  • OriginalValue: Valor base do sistema
  • Discount: Percentual de desconto aplicado
  • Surcharge: Acréscimos adicionais
  • FinalValue: Valor final após descontos/acréscimos

​
Datas Importantes

  • BudgetCreated: Data de criação do orçamento
  • OrderCreated: Data de conversão em pedido
  • DeliveryDate: Data prevista de entrega

​
Operações Disponíveis

Listar Requests

Busque orçamentos ou pedidos com filtros avançados

Atualizar Status

Mude o status de um request no fluxo de aprovação

Aplicar Desconto

Ajuste valores com descontos ou acréscimos

Alterar Responsável

Transfira a responsabilidade entre colaboradores

​
Filtros de Busca

A API oferece diversos filtros para localizar requests:

​
Por Data

  • createdAfter / createdBefore: Filtro por data de criação
  • lastUpdateAfter / lastUpdateBefore: Filtro por última atualização

​
Por Características

  • code: Busca por código (parcial ou completo)
  • name: Busca por nome (parcial ou completo)
  • powerGTE / powerLTE: Filtro por potência mínima/máxima

​
Por Localização

  • freightState: Estado de entrega
  • freightCity: Cidade de entrega

​
Por Relacionamentos

  • companyCNPJ: CNPJ da empresa cliente
  • responsibleEmail: Email do responsável

​
Exemplo de Request

{
  "id": "req_123456789",
  "name": "Sistema Solar Residencial - João Silva",
  "code": "200000001",
  "kind": "Kit Personalizado",
  "totalPower": 5.5,
  "budgetCreated": "2024-01-15T10:30:00.000Z",
  "orderCreated": null,
  "dealStatus": "Em Análise",
  "stockStatus": "available",
  "originalValue": 25000.00,
  "discount": 10.0,
  "surcharge": 0.0,
  "finalValue": 22500.00,
  "company": {
    "name": "Solar Tech Ltda",
    "cnpj": "12.345.678/0001-90"
  },
  "responsible": {
    "name": "Maria Santos",
    "email": "[email protected]"
  }
}

​
Boas Práticas

Paginação: Sempre use paginação ao listar requests para melhor performance
Filtros: Use filtros específicos para reduzir o volume de dados transferidos
Exclusão: Apenas pedidos com status “Recusado” podem ser excluídos