Quote

A Quote (Devis) represents a customer quotation in the system. It contains pricing information, validation state, and relationships to projects, companies, and quote items. Quotes can contain both configured products (from Briefs) and predefined articles.

Main Purpose

Generate customer quotations with comprehensive pricing
Group multiple products (Quote Items) into a single quotation
Track validation states (draft, published, signed, rejected, expired)
Generate multi-language PDF documents
Manage quote validity periods and client acceptance
Support guest access via temporary links

Key Properties

Property	Type	Description
`id`	UUID	Unique identifier
`code`	number	Sequential quote identifier (generated on validation)
`name`	string	Quote name
`totalPrice`	number	Total price of the quote (min: 0, default: 0)
`toolingCost`	number	Cost of tooling (default: 0)
`deliveryCost`	number	Cost of delivery (default: 0)
`state`	QuoteValidationState	Current validation state (default: “draft”)
`acceptTerms`	boolean	Terms acceptance flag (default: false)
`validatedAt`	Date	Validation timestamp
`validUntil`	Date	Expiration date for quote
`phoneNumber`	string	Contact phone number
`receiverName`	string	Name of the recipient
`email`	string	Contact email address (required, must be valid)
`uploadStatus`	TemporalStatus	PDF generation upload status (default: “undefined”)
`temporaryAccessLink`	string	Temporary access link for guest users
`externalId`	string	External ID for ERP synchronization
`createdAt`	Date	Creation timestamp
`updatedAt`	Date	Last update timestamp
`deletedAt`	Date	Soft delete timestamp

Quote Validation States

enum QuoteValidationState {
  Draft = "draft",         // En brouillon - Quote is being edited
  Published = "published", // Nouveau (publié) - Quote sent to client
  Signed = "signed",       // Signé - Client has accepted
  Rejected = "rejected",   // Rejeté - Client has declined
  Expired = "expired"      // Expiré - Quote validity period has passed
}

Main Relationships

Relationship	Entity	Type	Description
`items`	QuoteItem	One-to-Many	Quote line items (required, min: 1)
`project`	Project	Many-to-One	Associated project
`company`	Company	Many-to-One	Client company
`status`	Status	Many-to-One	Current workflow status
`pdfs`	File	One-to-Many	Generated quote PDFs (multi-language support)
`contact`	User	Many-to-One	Contact person
`address`	Address	Many-to-One	Delivery address
`user`	User	Many-to-One	Quote creator
`validatedBy`	User	Many-to-One	User who validated the quote
`quoteSettings`	QuoteSetting	Many-to-One	Quote settings configuration
`termAndCondition`	File	Many-to-One	Terms and conditions file
`comment`	Comment	Many-to-One	Associated comment

Workflow States

flowchart LR
  Draft --> Published --> Signed
  Draft --> Deleted
  Published --> Rejected
  Published --> Expired

Draft: Quote is being edited (no code assigned)
Published: Quote sent to client (unique code assigned)
Signed: Client has accepted the quote
Rejected: Client has declined the quote
Expired: Quote validity period has passed

POST /quotes - Create quote
GET /quotes/:id - Get quote details with all relations
GET /quotes - Get paginated quotes list
PUT /quotes/:id - Update quote
DELETE /quotes/:id - Delete quote
POST /quotes/:id/generate-pdf - Generate PDF document
GET /quotes/:id/localisation/:localisationId - Download PDF by language
POST /quotes/:id/quote-items - Add items to quote
DELETE /quotes/:id/quote-items/:itemId - Remove item from quote

Key Features

Multi-language PDF: Quotes can be generated in multiple languages
Guest Access: Share quotes via temporary access links without login
Draft System: Auto-save quotes as drafts before publishing
ERP Integration: External ID field for synchronization with ERP systems
Mixed Content: Support for both configured products (Briefs) and predefined articles
Expiration Management: Automatic expiration based on validity period
Pricing Components: Separate tracking of base price, tooling, and delivery costs