invoice-generation

What this skill does

# Invoice Generation

Generate professional invoices, receipts, quotes, and financial documents using each::sense. This skill creates visually appealing, accurate business documents optimized for printing and digital delivery.

## Features

- **Invoices**: Professional invoices with line items, taxes, and totals
- **Receipts**: Transaction receipts for completed payments
- **Quotes/Estimates**: Pre-sale quotes with validity periods
- **Credit Notes**: Refund and adjustment documents
- **Purchase Orders**: Procurement and ordering documents
- **Multi-Currency**: Support for various currencies and formats
- **Tax Calculations**: Automatic VAT, GST, sales tax handling
- **Company Branding**: Custom logos, colors, and layouts
- **Recurring Templates**: Standardized templates for repeat billing

## Quick Start

```bash
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Generate a professional invoice for web development services, $2,500 total, due in 30 days"}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max"
  }'
```

## Document Types & Use Cases

| Document Type | Use Case | Key Elements |
|---------------|----------|--------------|
| Invoice | Billing for goods/services | Line items, tax, due date, payment terms |
| Receipt | Payment confirmation | Transaction ID, payment method, timestamp |
| Quote/Estimate | Pre-sale pricing | Validity period, optional items, terms |
| Credit Note | Refunds/adjustments | Reference to original invoice, reason |
| Purchase Order | Procurement | Vendor details, shipping info, approval |
| Proforma Invoice | Pre-shipment | Similar to invoice, marked as proforma |

## Use Case Examples

### 1. Basic Invoice Generation

```bash
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Create a simple invoice: Invoice #INV-2024-001, From: Acme Corp (123 Business St, NY 10001), To: Client Inc (456 Customer Ave, LA 90001), Service: Consulting Services - $1,500. Due date: March 15, 2024. Clean, professional design."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max"
  }'
```

### 2. Detailed Invoice with Line Items

```bash
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Generate a detailed invoice with multiple line items: Invoice #INV-2024-042 From: Digital Solutions LLC To: TechStart Inc Line items: 1) Website Development - 40 hours @ $150/hr = $6,000 2) UI/UX Design - 20 hours @ $125/hr = $2,500 3) SEO Setup - flat rate $800 4) Hosting (Annual) - $480 Subtotal, 8% tax, and grand total. Payment terms: Net 30. Include bank transfer details section."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max"
  }'
```

### 3. Invoice with Company Branding

```bash
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Create a branded invoice for a creative agency. Company: Pixel Perfect Studios, use modern minimalist design with a navy blue and gold color scheme. Include space for logo at top left. Invoice #PP-2024-089 to MediaMax Corp. Services: Brand Identity Package $4,500, Social Media Templates $1,200, Brand Guidelines Document $800. Total $6,500. Due in 14 days. Include Pay Now button placeholder and QR code area for payment link."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max",
    "image_urls": ["https://example.com/company-logo.png"]
  }'
```

### 4. Receipt Generation

```bash
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Generate a payment receipt: Receipt #REC-78432 From: Cloud Services Pro To: Johnson Enterprises Payment received: $3,250.00 Payment method: Credit Card (Visa ending 4242) Transaction ID: TXN-2024-02-15-98765 Date: February 15, 2024 at 2:34 PM For: Invoice #INV-2024-038 (Annual SaaS Subscription) Status: PAID in full. Include a thank you message and support contact."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max"
  }'
```

### 5. Quote/Estimate Generation

```bash
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Create a project quote/estimate: Quote #QT-2024-015 From: BuildRight Construction To: Greenfield Properties Project: Office Renovation - 2nd Floor Line items: 1) Demolition and prep - $8,500 2) Electrical work - $12,000 3) Plumbing updates - $6,500 4) Flooring (800 sq ft) - $9,600 5) Painting and finishing - $4,200 6) Project management (10%) - $4,080 Total estimate: $44,880 Valid for 30 days. Include terms: 50% deposit required, final payment on completion. Add signature line for acceptance."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max"
  }'
```

### 6. Multi-Currency Invoice

```bash
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Generate an international invoice in Euros: Invoice #EU-2024-0023 From: TechGlobal GmbH (Berlin, Germany, VAT: DE123456789) To: Societe Digitale SARL (Paris, France, VAT: FR987654321) Services: Software License (Enterprise) - 12 months @ 850 EUR/month = 10,200 EUR Implementation Services - 3,500 EUR Training (Remote) - 1,800 EUR Subtotal: 15,500 EUR VAT (19%): 2,945 EUR Total: 18,445 EUR Payment: SEPA transfer, IBAN: DE89 3704 0044 0532 0130 00, BIC: COBADEFFXXX Due: 30 days. Reverse charge note for intra-EU B2B."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max"
  }'
```

### 7. Invoice with Tax Calculations

```bash
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Create an invoice with complex tax breakdown: Invoice #TAX-2024-156 From: Retail Solutions Inc (GST: 12-3456789) To: Shop & Save Stores Line items with different tax rates: 1) POS Hardware (5 units @ $899) = $4,495 - Standard rate 10% GST 2) Software License = $2,400 - Standard rate 10% GST 3) Installation Services = $1,200 - Standard rate 10% GST 4) Training Materials (books) = $350 - Zero rated 5) Extended Warranty = $600 - Exempt Subtotal: $9,045 GST Summary: Standard rated (10%): $8,095 x 10% = $809.50 Zero rated: $350 x 0% = $0 Exempt: $600 Total GST: $809.50 Grand Total: $9,854.50 Include ABN and tax invoice statement."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max"
  }'
```

### 8. Recurring Invoice Template

```bash
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Design a recurring monthly invoice template: Invoice #[AUTO-NUMBER] From: CloudHost Pro Services To: [CLIENT NAME] Billing Period: [MONTH YEAR]