How to Integrate FreshBooks with V0

1// app/api/freshbooks/invoices/route.ts
2import { NextRequest, NextResponse } from 'next/server';
3
4const FB_API_BASE = 'https://api.freshbooks.com';
5
6async function getAccessToken(): Promise<string> {
7  // Refresh the access token using the stored refresh token
8  const response = await fetch(`${FB_API_BASE}/auth/oauth/token`, {
9    method: 'POST',
10    headers: { 'Content-Type': 'application/json' },
11    body: JSON.stringify({
12      grant_type: 'refresh_token',
13      client_id: process.env.FRESHBOOKS_CLIENT_ID,
14      client_secret: process.env.FRESHBOOKS_CLIENT_SECRET,
15      refresh_token: process.env.FRESHBOOKS_REFRESH_TOKEN,
16    }),
17  });
18
19  if (!response.ok) {
20    throw new Error('Failed to refresh FreshBooks access token');
21  }
22
23  const data = await response.json();
24  return data.access_token;
25}
26
27interface LineItem {
28  description: string;
29  quantity: number;
30  rate: number;
31}
32
33interface CreateInvoiceRequest {
34  clientId: string;
35  lines: LineItem[];
36  notes?: string;
37  dueDays?: number;
38}
39
40export async function POST(request: NextRequest) {
41  const accountId = process.env.FRESHBOOKS_ACCOUNT_ID;
42
43  if (!accountId || !process.env.FRESHBOOKS_CLIENT_ID) {
44    return NextResponse.json(
45      { error: 'FreshBooks is not configured' },
46      { status: 500 }
47    );
48  }
49
50  let body: CreateInvoiceRequest;
51  try {
52    body = await request.json();
53  } catch {
54    return NextResponse.json({ error: 'Invalid request body' }, { status: 400 });
55  }
56
57  const { clientId, lines, notes, dueDays = 30 } = body;
58
59  if (!clientId || !lines?.length) {
60    return NextResponse.json(
61      { error: 'clientId and at least one line item are required' },
62      { status: 400 }
63    );
64  }
65
66  try {
67    const accessToken = await getAccessToken();
68
69    const invoiceLines = lines.map((line) => ({
70      description: { name: line.description },
71      amount: { amount: (line.quantity * line.rate).toFixed(2), code: 'USD' },
72      qty: line.quantity,
73      unit_cost: { amount: line.rate.toFixed(2), code: 'USD' },
74    }));
75
76    const payload = {
77      invoice: {
78        customerid: clientId,
79        lines: invoiceLines,
80        notes: notes || '',
81        due_offset_days: dueDays,
82        status: 1, // 1 = draft, 2 = sent
83      },
84    };
85
86    const response = await fetch(
87      `${FB_API_BASE}/accounting/account/${accountId}/invoices/invoices`,
88      {
89        method: 'POST',
90        headers: {
91          Authorization: `Bearer ${accessToken}`,
92          'Content-Type': 'application/json',
93          'Api-Version': 'alpha',
94        },
95        body: JSON.stringify(payload),
96      }
97    );
98
99    if (!response.ok) {
100      const errorData = await response.json();
101      throw new Error(errorData.response?.errors?.[0]?.message || 'Invoice creation failed');
102    }
103
104    const data = await response.json();
105    const invoice = data.response.result.invoice;
106
107    return NextResponse.json({
108      success: true,
109      invoiceId: invoice.id,
110      invoiceNumber: invoice.invoice_number,
111      total: invoice.amount.amount,
112    });
113  } catch (error) {
114    const message = error instanceof Error ? error.message : 'Unknown error';
115    console.error('FreshBooks invoice creation failed:', message);
116    return NextResponse.json(
117      { error: 'Failed to create invoice', details: message },
118      { status: 500 }
119    );
120  }
121}
122
123export async function GET(request: NextRequest) {
124  const accountId = process.env.FRESHBOOKS_ACCOUNT_ID;
125  const { searchParams } = new URL(request.url);
126  const clientId = searchParams.get('clientId');
127
128  if (!accountId || !process.env.FRESHBOOKS_CLIENT_ID) {
129    return NextResponse.json({ error: 'FreshBooks is not configured' }, { status: 500 });
130  }
131
132  try {
133    const accessToken = await getAccessToken();
134    const url = clientId
135      ? `${FB_API_BASE}/accounting/account/${accountId}/invoices/invoices?search[customerid]=${clientId}`
136      : `${FB_API_BASE}/accounting/account/${accountId}/invoices/invoices`;
137
138    const response = await fetch(url, {
139      headers: {
140        Authorization: `Bearer ${accessToken}`,
141        'Api-Version': 'alpha',
142      },
143    });
144
145    if (!response.ok) throw new Error('Failed to fetch invoices');
146
147    const data = await response.json();
148    return NextResponse.json(data.response.result);
149  } catch (error) {
150    const message = error instanceof Error ? error.message : 'Unknown error';
151    return NextResponse.json({ error: message }, { status: 500 });
152  }
153}