Order

​

Campos

​

Relacionamentos

• Relaciona-se com Checkout
• Relaciona-se com Customer
• Relaciona-se com Organization
• Relaciona-se com Company
• 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 PromotionalUsageHistory, quando promoções são aplicadas ao pedido ou aos tickets
• Relaciona-se com múltiplos CreditLedgerEntry, quando créditos são usados no pedido

​

Regras de Negócio

• Agrupa tickets de uma única empresa dentro de um checkout.
• Um checkout com tickets de múltiplas empresas gera um Order por empresa.
• 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 emite um Invite ACCOUNT_ACTIVATION para o customer usar o app depois.
• O valor (amount) é armazenado em centavos — ex.: R$ 150,00 = 15000.
• O amount do Order é a soma dos tickets daquela empresa.
• Promoções e créditos só podem ser aplicados quando pertencem à mesma companyId do Order.
• O campo code é um identificador legível único para o pedido.

​

Enums

​

OrderType

​

OrderStatus

​

Example

{
  "orderId": "0197a813-0fb9-7d42-9c81-50c0f6d9ae5a",
  "checkoutId": "0197a812-b835-79c4-8f0b-0e3863eb6d34",
  "customerId": "0197a7f6-4d36-7c0a-a7cb-54fcb33a3148",
  "organizationId": "0197a801-1690-7590-b3cf-19599b9be3e4",
  "companyId": "0197a801-6a42-79aa-9e56-d3c85148c0fa",
  "soldById": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "externalProvider": "billing_interface",
  "externalProviderId": "ord_6e3d7a21",
  "type": "ONLINE",
  "code": "OAB-20260703-0001",
  "amount": 11400,
  "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"
}