Order

​

Campos

​

Relacionamentos

• Relaciona-se com Checkout.
• Relaciona-se com Customer.
• Relaciona-se com Organization.
• Relaciona-se com Cooperative.
• Relaciona-se com User como responsável pela criação.
• Relaciona-se com múltiplos Ticket.
• Relaciona-se com Payment (1:1, opcional).
• Relaciona-se com múltiplos TripReview.
• Relaciona-se com múltiplos BenefitUsageHistory, quando benefício é aplicado ao pedido.
• Relaciona-se com múltiplos CreditLedgerEntry, quando tickets do pedido usam créditos corporativos.

​

Regras de Negócio

• Agrupa tickets de uma única cooperativa dentro de um checkout.
• Um checkout com tickets de múltiplas cooperativas gera um Order por cooperativa.
• Um Order pode receber uma TripReview por Trip comprada.
• Um checkout pode ter múltiplos TripReviews porque pode gerar múltiplos Orders e Trips.
• customerId é obrigatório também em vendas POS.
• Na venda POS, o sistema resolve ou cria User + Customer antes de criar o Order.
• Quando a venda POS cria uma conta nova, o sistema não emite convite de ativação.
• Na venda DRIVER_APP, o Order deve nascer de uma CheckoutSession confirmada.
• Em venda DRIVER_APP, o Customer é resolvido pelo app do cliente ao escanear o QR Code; o motorista não seleciona Customer manualmente.
• Em venda DRIVER_APP, soldById aponta para o User do motorista que iniciou a sessão.
• O fluxo DRIVER_APP pode confirmar pagamento em dinheiro ou uso de crédito corporativo autorizado pelo Customer.
• Todos os valores monetários são armazenados em centavos — ex.: R$ 150,00 = 15000.
• baseAmount é a soma de Ticket.baseAmount.
• discountAmount é a soma de Ticket.discountAmount.
• creditAmount é a soma de Ticket.creditAmount.
• paidAmount é a soma de Ticket.paidAmount.
• amount é a soma de Ticket.price.
• Créditos corporativos podem ser reservados no checkout, mas a captura definitiva é sempre por Ticket.
• O Order serve como contexto comercial para o uso de crédito; ele não é a unidade final de consumo do crédito.
• O campo code é um identificador legível único para o pedido.
• Criação, confirmação, atualização por billing e cancelamento de Order solicitam auditoria via audit_log.requested com domain = SALES e resource = ORDER.
• Cancelamento de Ticket feito pelo fluxo de Order solicita auditoria via audit_log.requested com domain = SALES e resource = TICKET.
• Confirmação emite order.confirmed com o Order atualizado em data.
• Cancelamento total emite order.cancelled com o Order atualizado em data.
• Atualização vinda de billing emite order.updated com o Order atualizado em data.
• Cancelamento de ticket emite ticket.cancelled com o Ticket atualizado em data.

​

Enums

​

OrderType

​

OrderStatus

​

Example

{
  "orderId": "0197a813-0fb9-7d42-9c81-50c0f6d9ae5a",
  "checkoutId": "0197a812-b835-79c4-8f0b-0e3863eb6d34",
  "customerId": "0197a7f6-4d36-7c0a-a7cb-54fcb33a3148",
  "organizationId": "0197a7f7-7291-7a43-96db-2c8580b80c5d",
  "cooperativeId": "0197a800-24e6-76a2-90ed-ff0f6fba7b0c",
  "soldById": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "externalProvider": "billing_interface",
  "externalProviderId": "ord_6e3d7a21",
  "type": "ONLINE",
  "code": "OAB-20260703-0001",
  "baseAmount": 11400,
  "discountAmount": 3400,
  "creditAmount": 1500,
  "paidAmount": 6500,
  "amount": 8000,
  "status": "PAID",
  "createdBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "createdAt": "2026-07-03T16:00:00.000Z",
  "updatedBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "updatedAt": "2026-07-03T16:02:00.000Z"
}