Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Diego31-10/TableOrderApp/llms.txt

Use this file to discover all available pages before exploring further.

The PDF service renders order receipts as HTML and converts them to PDF files using expo-print. Generated PDFs are saved to the device’s temporary file system and can be passed to the Telegram service for dispatch.

​
Types

​
TicketData

Input data required to generate a receipt PDF. 
interface TicketData {
  items: CartItem[];
  subtotal: number;
  discount: number;
  total: number;
  shippingCost: number;
  serviceType: 'TABLE' | 'DELIVERY';
  tableName?: string;
  timestamp?: string;
}
​
TicketData
object
Complete order information for receipt generation

​
Functions

​
generateTicketPDF

Renders an HTML receipt template and saves it as a PDF file. 
generateTicketPDF(data: TicketData): Promise<string>
​
data
TicketData
required
Order data to render in the receipt
​
uri
string
Local file URI of the generated PDF (e.g., file:///path/to/ticket.pdf)

​
Example

import { generateTicketPDF } from '@/src/lib/services/pdfService';

const ticketData = {
  items: [
    {
      product: { id: '1', name: 'Burger Clásica', price: 12.50, category: 'FOOD', image: '...' },
      quantity: 2
    },
    {
      product: { id: '2', name: 'Coca-Cola', price: 3.00, category: 'DRINK', image: '...' },
      quantity: 1
    }
  ],
  subtotal: 28.00,
  discount: 0.10,
  total: 25.20,
  shippingCost: 5.50,
  serviceType: 'DELIVERY',
  timestamp: new Date().toISOString()
};

const pdfUri = await generateTicketPDF(ticketData);
console.log('PDF generated at:', pdfUri);

// Pass to Telegram service
await sendTicketToTelegram(pdfUri);

​
Table order example

const tableTicketData = {
  items: cartItems,
  subtotal: 45.00,
  discount: 0.15, // 15% birthday discount
  total: 38.25,
  shippingCost: 0,
  serviceType: 'TABLE',
  tableName: 'Mesa 7'
};

const pdfUri = await generateTicketPDF(tableTicketData);

​
Receipt template

The generated PDF includes:
  • Header: TableOrder branding with orange theme (#E25822)
  • Metadata: Auto-generated order ID, service type badge, date/time
  • Order details: Itemized list with quantities and line totals
  • Totals section:
    • Subtotal
    • Discount (only shown if > 0%)
    • Shipping cost (only shown if > 0)
    • Grand total with emphasized styling
  • Footer: Restaurant name from configuration

​
Order ID format

Order IDs are generated using the pattern: 
const orderId = `TO-${Date.now().toString(36).toUpperCase()}`;
// Example: TO-L3K4M9P2

​
Localization

All text in the receipt is in Spanish (es-ES):
  • Date formatting uses toLocaleString('es-ES')
  • Labels and messages are in Spanish
  • Currency formatting uses 2 decimal places

​
Styling

The receipt uses a modern, mobile-optimized design:
  • Font: Apple system fonts with Helvetica fallback
  • Colors: Orange primary (#E25822), neutral grays
  • Layout: 420px max width, rounded corners, box shadow
  • Typography: Clean hierarchy with uppercase labels
The HTML template is embedded in the service code. Modify the buildTicketHTML function (src/lib/services/pdfService.ts:30-230) to customize the receipt design.

​
Configuration

The service uses Config.restaurant.name for the footer branding. Ensure this is configured before generating receipts.

​
Integration

Typical workflow:
  1. Collect order data from checkout flow
  2. Generate PDF using generateTicketPDF
  3. Send PDF to Telegram using sendTicketToTelegram
  4. Clean up temporary files if needed

Build docs developers (and LLMs) love

Get started for freeTalk to us