Pular para o conteúdo principal

Guia de Orçamentos (Quotes)

Tipo de Documento: Orçamento
Document Type ID: 1 (verificar com /document-type)

Visão Geral​

Os Orçamentos (Quotes) são documentos comerciais que:

  • 📝 Apresentam propostas de venda ao cliente
  • 💭 NÃO afetam stock
  • 💵 NÃO requerem pagamento imediato
  • 📄 Servem como base para faturas futuras
  • ⏱️ Geralmente têm validade limitada

Quando Usar​

  • ✅ Proposta comercial antes da venda
  • ✅ Apresentação de preços ao cliente
  • ✅ Negociação de condições
  • ✅ Base para aprovação de encomendas

Características dos Orçamentos​

CaracterísticaValorDescrição
Afeta Stock❌ NãoStock não é afetado
Requer Pagamento❌ NãoApenas proposta
Pode ser Fechado✅ SimPode ser finalizado
Validação Fiscal❌ NãoNão é documento fiscal
Permite Edição✅ SimEnquanto não fechado
Conversão✅ SimPode gerar Fatura/Encomenda

Criar Orçamento​

Exemplo Básico​

POST /api/v1/invoices
Content-Type: application/json
Authorization: Bearer {token}
{
  "serieId": 10,
  "documentTypeId": 1,
  "entityKeyId": "CLI001",
  "entityDescription": "Cliente Potencial, Lda",
  "entityVat": "PT123456789",
  "obs": "Orçamento válido até 31/12/2025",
  "dueDate": "2025-12-31",
  "documentBodies": [
    {
      "itemKeyId": "PROD001",
      "itemDescription": "Solução Completa",
      "quantity": 1.0,
      "retailPrice": 5000.00,
      "taxId": 1,
      "paymentType": 1,
      "stockFlow": 0,          // NÃO afeta stock
      "stockBehavior": 0,
      "secondTaxId": 0
    }
  ]
}

Orçamento com Desconto​

{
  "serieId": 10,
  "documentTypeId": 1,
  "entityKeyId": "CLI001",
  "obs": "Desconto especial para novo cliente",
  "documentBodies": [
    {
      "itemKeyId": "PROD001",
      "quantity": 10.0,
      "retailPrice": 100.00,
      "discountValue": 15.00,  // 15% de desconto
      "observation": "Desconto volume",
      "taxId": 1,
      "paymentType": 1,
      "stockFlow": 0,
      "stockBehavior": 0,
      "secondTaxId": 0
    }
  ]
}

Conversão para Fatura​

Passo a Passo​

1. Obter orçamento aprovado:

GET /api/v1/invoices/123
Authorization: Bearer {token}

2. Criar fatura com os mesmos dados:

POST /api/v1/invoices
Content-Type: application/json
Authorization: Bearer {token}
{
  "serieId": 1,                // Série de faturas
  "documentTypeId": 5,         // Fatura
  "entityKeyId": "CLI001",     // Mesmo cliente
  "docReference": "OR A/123",  // Referência ao orçamento
  "documentBodies": [
    {
      "itemKeyId": "PROD001",
      "quantity": 1.0,
      "retailPrice": 5000.00,
      "taxId": 1,
      "paymentType": 1,
      "stockFlow": 1,          // AGORA afeta stock
      "stockBehavior": 1,
      "secondTaxId": 0
    }
  ]
}

3. Fechar orçamento original:

PUT /api/v1/invoices/123
Content-Type: application/json
Authorization: Bearer {token}
{
  "id": 123,
  "close": true,
  "obs": "Convertido em fatura FT A/456"
}

Boas Práticas​

✅ Recomendado​

  • Incluir data de validade no campo dueDate
  • Detalhar condições comerciais no campo obs
  • Referenciar RFQ do cliente em docReference
  • Incluir descontos promocionais em discountValue
  • Fechar orçamentos rejeitados ou expirados

❌ Evitar​

  • Criar orçamentos sem data de validade
  • Deixar orçamentos abertos indefinidamente
  • Esquecer de referenciar orçamento na fatura
  • Definir stockFlow != 0 (orçamentos não afetam stock)

Casos de Uso Comuns​

Proposta Simples​

Orçamento para produto único com condições padrão.

Proposta com Descontos por Volume​

Orçamento com desconto progressivo baseado em quantidade.

Proposta Multi-linha​

Orçamento com vários produtos/serviços.

Proposta com Condições Especiais​

Orçamento com condições de pagamento ou entrega personalizadas.

Diferenças vs Faturas​

AspectoOrçamentoFatura
StockNão afetaAfeta (saída)
FiscalNãoSim
ValidadeLimitadaDefinitivo
EdiçãoSim (aberto)Limitada
ObjetivoPropostaVenda

Próximos Passos​

Última Atualização: 28 de Novembro de 2025