How to Integrate Bolt.new with DHL API

1# .env file additions
2# DHL API credentials — server-side only, never NEXT_PUBLIC_
3DHL_API_KEY=your_sandbox_api_key_here
4DHL_TRACKING_API_BASE=https://api-eu.dhl.com
5DHL_EXPRESS_API_BASE=https://express.api.dhl.com/mydhlapi
6# Use 'test' for sandbox, 'production' for live
7DHL_ENVIRONMENT=test

1// app/api/dhl/track/route.ts
2import { NextResponse } from 'next/server';
3
4async function dhlRequest(url: string) {
5  const response = await fetch(url, {
6    headers: {
7      'DHL-API-Key': process.env.DHL_API_KEY ?? '',
8      'Accept': 'application/json',
9    },
10  });
11  if (!response.ok) {
12    const error = await response.json().catch(() => ({}));
13    throw Object.assign(new Error('DHL API error'), { status: response.status, body: error });
14  }
15  return response.json();
16}
17
18export async function GET(request: Request) {
19  const url = new URL(request.url);
20  const waybill = url.searchParams.get('waybill')?.trim();
21
22  if (!waybill) {
23    return NextResponse.json({ error: 'waybill query parameter is required' }, { status: 400 });
24  }
25
26  try {
27    const trackingUrl = `${process.env.DHL_TRACKING_API_BASE}/track/shipments?trackingNumber=${encodeURIComponent(waybill)}`;
28    const data = await dhlRequest(trackingUrl);
29
30    const shipment = data?.shipments?.[0];
31    if (!shipment) {
32      return NextResponse.json({ error: 'Shipment not found' }, { status: 404 });
33    }
34
35    const normalized = {
36      waybill,
37      status: shipment.status?.status ?? 'unknown',
38      description: shipment.status?.description ?? '',
39      estimatedDelivery: shipment.estimatedTimeOfDelivery ?? null,
40      origin: {
41        name: shipment.origin?.address?.addressLocality ?? '',
42        countryCode: shipment.origin?.address?.countryCode ?? '',
43      },
44      destination: {
45        name: shipment.destination?.address?.addressLocality ?? '',
46        countryCode: shipment.destination?.address?.countryCode ?? '',
47      },
48      events: (shipment.events ?? []).map((event: Record<string, unknown>) => ({
49        timestamp: event.timestamp,
50        location: (event.location as Record<string, unknown>)?.address
51          ? `${((event.location as Record<string, unknown>).address as Record<string, unknown>).addressLocality}, ${((event.location as Record<string, unknown>).address as Record<string, unknown>).countryCode}`
52          : 'Unknown',
53        description: event.description,
54        remark: event.remark ?? '',
55      })),
56    };
57
58    return NextResponse.json(normalized);
59  } catch (error: unknown) {
60    const err = error as { status?: number };
61    if (err.status === 404) {
62      return NextResponse.json({ error: 'Shipment not found' }, { status: 404 });
63    }
64    console.error('DHL tracking error:', error);
65    return NextResponse.json({ error: 'Failed to fetch tracking data' }, { status: 500 });
66  }
67}

1// app/api/dhl/rates/route.ts
2import { NextResponse } from 'next/server';
3
4export async function POST(request: Request) {
5  try {
6    const body = await request.json();
7    const {
8      originCountry, originPostalCode, originCity,
9      destinationCountry, destinationPostalCode, destinationCity,
10      weightKg, packageDimensions,
11    } = body;
12
13    // Shipment date must be today or future, in ISO format
14    const plannedDate = new Date();
15    plannedDate.setHours(14, 0, 0, 0); // 2pm local time
16    const plannedShipmentDateAndTime = plannedDate.toISOString();
17
18    const rateRequest = {
19      customerDetails: {
20        shipperDetails: {
21          postalCode: originPostalCode,
22          cityName: originCity,
23          countryCode: originCountry,
24        },
25        receiverDetails: {
26          postalCode: destinationPostalCode,
27          cityName: destinationCity,
28          countryCode: destinationCountry,
29        },
30      },
31      accounts: [{
32        typeCode: 'shipper',
33        number: process.env.DHL_ACCOUNT_NUMBER ?? 'TEST_ACCOUNT',
34      }],
35      plannedShipmentDateAndTime,
36      unitOfMeasurement: 'metric',
37      isCustomsDeclarable: false,
38      packages: [{
39        weight: Number(weightKg),
40        dimensions: {
41          length: Number(packageDimensions?.length ?? 20),
42          width: Number(packageDimensions?.width ?? 15),
43          height: Number(packageDimensions?.height ?? 10),
44        },
45      }],
46    };
47
48    const response = await fetch(`${process.env.DHL_EXPRESS_API_BASE}/rates`, {
49      method: 'POST',
50      headers: {
51        'DHL-API-Key': process.env.DHL_API_KEY ?? '',
52        'Content-Type': 'application/json',
53        'Accept': 'application/json',
54      },
55      body: JSON.stringify(rateRequest),
56    });
57
58    if (!response.ok) {
59      const error = await response.json();
60      return NextResponse.json({ error: error?.detail ?? 'Rate request failed' }, { status: response.status });
61    }
62
63    const data = await response.json();
64    const rates = (data?.products ?? []).map((product: Record<string, unknown>) => ({
65      productName: product.productName,
66      serviceCode: product.productCode,
67      totalCharge: (product.totalPrice as Array<Record<string, unknown>>)?.[0]?.price ?? 0,
68      currency: (product.totalPrice as Array<Record<string, unknown>>)?.[0]?.priceCurrency ?? 'USD',
69      deliveryDate: (product.deliveryCapabilities as Record<string, unknown>)?.estimatedDeliveryDateAndTime ?? null,
70    })).sort((a: Record<string, unknown>, b: Record<string, unknown>) => Number(a.totalCharge) - Number(b.totalCharge));
71
72    return NextResponse.json({ rates });
73  } catch (error) {
74    console.error('DHL rates error:', error);
75    return NextResponse.json({ error: 'Failed to calculate rates' }, { status: 500 });
76  }
77}