# ShipStation
curl -u "API_KEY:API_SECRET" https://ssapi.shipstation.com/orders

# Package Retriever
curl -H "Authorization: Bearer pr_live_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4" \
  https://api.packageretriever.com/v1/rates

const response = await fetch('https://ssapi.shipstation.com/shipments/getrates', {
  method: 'POST',
  headers: {
    'Authorization': 'Basic ' + btoa(`${API_KEY}:${API_SECRET}`),
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    carrierCode: 'stamps_com',
    fromPostalCode: '94105',
    toPostalCode: '78701',
    toCountry: 'US',
    weight: { value: 16, units: 'ounces' },
    dimensions: { length: 9, width: 6, height: 2, units: 'inches' }
  })
});

import PackageRetriever from '@packageretriever/sdk';
const pr = new PackageRetriever('pr_live_YOUR_KEY');

const rates = await pr.rates.get({
  from_address: { name: 'Warehouse', street1: '417 Montgomery St', city: 'San Francisco', state: 'CA', zip: '94105', country: 'US' },
  to_address: { name: 'Customer', street1: '123 Main St', city: 'Austin', state: 'TX', zip: '78701', country: 'US' },
  parcel: { weight_oz: 16, length: 9, width: 6, height: 2 }
});

// rates.rates is sorted cheapest-first by default
// Every carrier returned in one response — USPS, UPS, FedEx, Sendle
console.log(rates.rates[0]);
// { carrier: 'USPS', service: 'Ground Advantage', rate_cents: 542, carbon_grams: 142, ... }

const label = await fetch('https://ssapi.shipstation.com/shipments/createlabel', {
  method: 'POST',
  headers: { 'Authorization': 'Basic ' + btoa(`${API_KEY}:${API_SECRET}`) },
  body: JSON.stringify({
    carrierCode: 'stamps_com',
    serviceCode: 'usps_ground_advantage',
    packageCode: 'package',
    weight: { value: 16, units: 'ounces' },
    shipFrom: { /* ... */ },
    shipTo: { /* ... */ },
    testLabel: false
  })
});

// Step 1: Get rates (already done above)
const rates = await pr.rates.get({ /* ... */ });

// Step 2: Purchase the cheapest rate
const label = await pr.labels.create({ rate_id: rates.rates[0].id });

console.log(label.tracking_number); // 9400111899223408065744
console.log(label.label_url);       // PDF download URL
console.log(label.rate_cents);      // 542

// Sandbox — use pr_test_ prefix. No billing, no real labels.
const pr = new PackageRetriever('pr_test_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4');

// Every call works identically — returns realistic responses
const rates = await pr.rates.get({ /* ... */ });
const label = await pr.labels.create({ rate_id: rates.rates[0].id });
// label.tracking_number starts with 9999 (sandbox indicator)
// label.label_url points to a sample PDF
// Wallet is infinite in sandbox mode

// Your BYOA rates appear alongside platform rates — no extra configuration
const rates = await pr.rates.get({ /* ... */ });

// BYOA rates are labeled with account_type: 'byoa'
rates.rates.forEach(rate => {
  console.log(`${rate.carrier} ${rate.service}: $${rate.rate_cents / 100} (${rate.account_type})`);
});
// USPS Ground Advantage: $5.42 (platform)
// UPS Ground: $7.18 (byoa)       ← your negotiated UPS rate
// FedEx Home Delivery: $8.91 (byoa)  ← your negotiated FedEx rate

// Verify webhook signature (Node.js)
import crypto from 'crypto';

function verifySignature(payload, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  return signature === `sha256=${expected}`;
}

// In your webhook handler:
app.post('/webhooks/pr', (req, res) => {
  const isValid = verifySignature(
    JSON.stringify(req.body),
    req.headers['pr-signature'],
    process.env.PR_WEBHOOK_SECRET
  );
  if (!isValid) return res.status(401).send('Invalid signature');

  const { event, data } = req.body;
  // event = 'label.created'
  // data = full label object (tracking_number, label_url, carrier, etc.)

  res.status(200).send('OK');
});

const batch = await pr.batches.create({
  items: orders.map(order => ({
    from_address: warehouse,
    to_address: order.address,
    parcel: order.parcel,
    rate_id: order.selectedRateId,
    carrier: order.carrier,
    service: order.service,
    rate_cents: order.rateCents
  }))
});

// Full batch cost deducted from wallet upfront
console.log(batch.total_cost_cents);           // 27100
console.log(batch.wallet_balance_after_cents); // 47300

// Start processing
await pr.batches.buy(batch.id);

// Poll for progress
const status = await pr.batches.get(batch.id);
console.log(status.estimated_completion_percentage); // 45
console.log(status.estimated_time_remaining_seconds); // 120

{
  "error": {
    "code": "LABEL.ADDRESS.UNDELIVERABLE",
    "message": "The destination address cannot receive this carrier service.",
    "suggestion": "Validate the address with POST /v1/addresses/validate before creating a label.",
    "docs_url": "https://docs.packageretriever.com/reference/errors#LABEL.ADDRESS.UNDELIVERABLE",
    "request_id": "req_8f3kd92ms"
  }
}