Skip to main content

Create contact/support ticket

POST 
/company/contact/

Create a new contact/support ticket in the system for companies and carriers to report problems or inquiries.

Objective​

Allow users to report incidents and receive technical support from the CargoOffer team.

Use Cases​

  • A company cannot access its account and needs help
  • A carrier has problems with a specific delivery
  • User requires account configuration
  • Reporting bugs or technical problems on the platform
  • General uncategorized inquiries

Validation Flow​

flowchart TD
  A[Receive Request] --> B{Valid Author?}
  B -->|No| C[400 Invalid Author]
  B -->|Yes| D{Valid relatedTo?}
  D -->|No| E[400 Invalid Category]
  D -->|Yes| F{CheckUTC Valid?}
  F -->|No| G[400 Invalid Timestamp]
  F -->|Yes| H[Create Issue - 200]

Notes​

  • message field: Optional in the model (can create empty tickets), but providing a detailed description is recommended
  • relatedTo enum: The model accepts 12 values: config, delivery, auction, messages, others, user, trucker, address, document, bid, contract, userRegister
  • Authentication: Does not require explicit authentication (allows author=anonymous)
  • Middleware: Validates UTC timestamps via checkUTC
  • Internal codes: Each ticket receives an automatic internal_code (e.g., 2025-12345)

Request​

Responses​

Contact ticket created successfully.

Response Headers