SupportCase

​

Campos

​

Relacionamentos

• Relaciona-se com Customer, quando o chamado é do passageiro.
• Relaciona-se com Organization, quando o chamado está no escopo de uma organização.
• Relaciona-se com Company, quando envolve uma empresa.
• Relaciona-se com Cooperative, quando envolve uma cooperativa.
• Relaciona-se com TransportOperator, quando envolve um permissionário.
• Relaciona-se com User como usuário de abertura e atendente atual.
• Relaciona-se com Order, quando o chamado envolve uma compra.
• Relaciona-se com TripReview, quando o chamado nasce de uma avaliação.
• Relaciona-se com Ticket por relatedSalesTicketId, quando o chamado envolve uma passagem.
• Relaciona-se com Trip, quando o chamado envolve uma viagem.
• Relaciona-se com SupportCaseCategory.
• Relaciona-se com múltiplos SupportCaseMessage.
• Relaciona-se com múltiplos SupportCaseAttachment.
• Relaciona-se com múltiplos SupportCaseAssignment.
• Relaciona-se com SupportCaseSatisfactionRating (1:1, opcional).

​

Regras de Negócio

• code deve ser único e legível para atendimento e usuário final.
• scopeType define a superfície principal do chamado e orienta as permissões de leitura.
• relatedTripReviewId deve ser preenchido quando o passageiro usa o botão de contato a partir de uma avaliação.
• Quando relatedTripReviewId estiver preenchido, relatedOrderId deve apontar para o Order que deu elegibilidade para a review.
• relatedSalesTicketId referencia a passagem vendida quando o chamado envolve embarque, QR Code, cancelamento ou outra situação da viagem.
• assignedToUserId representa somente o responsável atual. O histórico fica em SupportCaseAssignment.
• Um chamado resolvido pode receber uma avaliação única em SupportCaseSatisfactionRating.
• Remoção lógica não deve apagar mensagens, anexos ou histórico. Esses registros devem permanecer para auditoria.

​

Enums

​

SupportCaseScopeType

​

SupportCasePriority

​

SupportCaseStatus

​

Example

{
  "supportCaseId": "0197f150-40d6-7c1a-bdf2-c5884e07d401",
  "customerId": "0197a7f6-4d36-7c0a-a7cb-54fcb33a3148",
  "organizationId": "0197a801-1690-7590-b3cf-19599b9be3e4",
  "companyId": "0197a801-6a42-79aa-9e56-d3c85148c0fa",
  "cooperativeId": "0197a800-24e6-76a2-90ed-ff0f6fba7b0c",
  "transportOperatorId": "0197a802-2d95-7ce5-97e7-1cfb5d7590c9",
  "openedByUserId": "0197a7f6-2c4d-74ae-b89b-9d36d9c341f2",
  "assignedToUserId": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "categoryId": "0197f151-0664-7b11-8a9c-a93acaf1ee22",
  "relatedOrderId": "0197a813-0fb9-7d42-9c81-50c0f6d9ae5a",
  "relatedTripReviewId": "0197a815-0fcf-704b-b703-f460b25515d4",
  "relatedSalesTicketId": "0197a813-a9a6-7752-8173-d40a2a2d0ef0",
  "relatedTripId": "0197a80f-2d8f-7710-b243-b67fb477a1c0",
  "code": "SUP-20260704-0001",
  "scopeType": "CUSTOMER",
  "priority": "MEDIUM",
  "status": "WAITING_SUPPORT",
  "subject": "Contato sobre avaliação da viagem",
  "description": "Passageiro solicitou atendimento a partir da avaliação enviada.",
  "resolvedAt": null,
  "closedAt": null,
  "createdAt": "2026-07-04T10:15:00.000Z",
  "updatedAt": "2026-07-04T10:20:00.000Z",
  "deletedAt": null
}