Tutorial: Postage, Envelope & Scheduling

import Intelliprint from 'intelliprint';

const ip = Intelliprint('your-api-key-here');

const printJob = await ip.prints.create({
  testmode: true,
  content: '<h1>Urgent Notice</h1>',
  recipients: [{address: {/* ... */}}],
  
  postage: {
    service: 'uk_first_class'  // Faster delivery
  },
  
  confirmed: true
});

const printJob = await ip.prints.create({
  testmode: true,
  content: '<h1>Multi-page Document</h1>',
  recipients: [{address: {/* ... */}}],
  
  postage: {
    service: 'uk_first_class',
    ideal_envelope: 'c4'  // Prefer larger envelope
  },
  
  confirmed: true
});

// Calculate future date (7 days from now)
const futureDate = new Date();
futureDate.setDate(futureDate.getDate() + 7);
const timestamp = Math.floor(futureDate.getTime() / 1000);

const printJob = await ip.prints.create({
  testmode: true,
  content: '<h1>Scheduled Campaign</h1>',
  recipients: [{address: {/* ... */}}],
  
  postage: {
    service: 'uk_first_class',
    mail_date: timestamp  // UNIX timestamp (day-adjusted)
  },
  
  confirmed: true
});

console.log('Scheduled for:', new Date(timestamp * 1000).toLocaleDateString());

const printJob = await ip.prints.create({
  testmode: false,  // Tracking only available in live mode
  content: '<h1>Tracked Letter</h1>',
  recipients: [{address: {/* ... */}}],
  
  postage: {
    service: 'uk_first_class_signed_for'  // Tracked service
  },
  
  confirmed: true
});

// Check status later
const updated = await ip.prints.retrieve(printJob.id);
const trackingNumber = updated.letters[0].tracking_number;

if (trackingNumber) {
  console.log('Tracking:', trackingNumber);
  console.log('Track at: https://www.royalmail.com/track-your-item');
}

async function sendBlackFridayCampaign() {
  // Schedule for day before Black Friday
  const blackFriday = new Date('2024-11-29');
  const sendDate = new Date(blackFriday);
  sendDate.setDate(sendDate.getDate() - 3); // 3 days before for delivery
  
  const printJob = await ip.prints.create({
    testmode: false,
    content: '<h1>Black Friday Preview!</h1>',
    mailing_list: 'mal_black_friday_2024',
    
    postage: {
      service: 'uk_first_class',  // Fast delivery
      mail_date: Math.floor(sendDate.getTime() / 1000)
    },
    
    background: {
      first_page: 'bg_black_friday'
    },
    
    confirmed: true
  });
  
  console.log(`Campaign scheduled for ${sendDate.toDateString()}`);
  console.log(`Expected delivery: ${blackFriday.toDateString()}`);
  
  return printJob;
}

async function sendLegalNotice(recipient) {
  const printJob = await ip.prints.create({
    testmode: false,
    
    file: fs.createReadStream('./legal-notice.pdf'),
    recipients: [{address: recipient.address}],
    
    postage: {
      service: 'uk_special_delivery',  // Tracked + fast
      ideal_envelope: 'c4'
    },
    
    background: {
      first_page: 'bg_legal_letterhead'
    },
    
    extra_documents: [{
      document: fs.createReadStream('./terms.pdf')
    }],
    
    reference: `Legal Notice ${recipient.case_number}`,
    confirmed: true
  });
  
  // Store tracking number for records
  console.log('Print job:', printJob.id);
  console.log('Check tracking later for proof of delivery');
  
  return printJob;
}

async function scheduleAbandonedBasketPostcards(customers) {
  const printJobs = [];
  
  for (const customer of customers) {
    // Schedule to arrive a few days after abandonment
    const abandonedAt = new Date(customer.basket_abandoned_at);
    const sendDate = new Date(abandonedAt);
    sendDate.setDate(sendDate.getDate() + 3); // Send 3 days later
    
    const printJob = await ip.prints.create({
      testmode: false,
      type: 'postcard',  // Send as postcard (perfect for re-engagement)
      
      content: `
        <h1>Still thinking it over, ${customer.first_name}?</h1>
        <p>You left items in your basket – complete your order for fast delivery.</p>
      `,
      
      recipients: [{address: customer.address}],
      
      postage: {
        service: 'uk_first_class',
        mail_date: Math.floor(sendDate.getTime() / 1000),
        ideal_envelope: 'postcard_a5'  // Larger postcard
      },
      
      reference: `Abandoned basket ${customer.id}`,
      confirmed: true
    });
    
    printJobs.push(printJob);
  }
  
  console.log(`Scheduled ${printJobs.length} abandoned basket postcards`);
  return printJobs;
}