Notes & Communication

Order notes provide a chat-style communication channel between customers and FTS staff, attached to individual orders.

Where Notes Appear

Notes are displayed on the Order Detail Page (/order/{id}):

• Sidebar: Scrollable list of all notes
• Main content: Form to compose new notes

Viewing Notes

Note List

Notes are fetched via GET /order/{id}/notes and displayed in chronological order. Each note shows:

Note Attachments

• Notes can include file attachments
• Images are displayed inline within the note
• Other file types show as downloadable links
• Attachments are uploaded to the note via POST /v3/api/ordering/project-orders/{orderId}/notes/{noteId}/attachments

Creating Notes

Compose Form

The note creation form includes:

• Text area — for the note content
• Attach file button — to upload files with the note
• Submit button — posts the note

How It Works

1. Customer types a message in the text area
2. Optionally attaches files
3. Clicks submit
4. Frontend calls POST /order/{id}/notes with the note content
5. If files are attached, they are uploaded separately to the note's attachment endpoint
6. The notes list refreshes to show the new note

Use Cases

Note Visibility

Notes on an order are visible to:

• The customer who placed the order
• FTS staff assigned to the order or project
• Admin users

Notes are order-specific — they belong to a single order, not the entire project. For project-level communication, the Customer Portal provides Project Notes (a separate feature).