send-letter.php

<?php

/**
 * Create a letter as a concept, inspect it, then delete it again.
 *
 * Nothing is sent: the item is created with send(false) and removed at the end,
 * so this is safe to run against a sandbox mailbox.
 *
 *     POSTBODE_API_KEY=your-key php examples/send-letter.php PSBD
 */

declare(strict_types=1);

use Postbode\Enum\PostalPlex;
use Postbode\Enum\PostalPrinting;
use Postbode\Enum\ShippingType;
use Postbode\Exception\PostbodeException;
use Postbode\Exception\ValidationException;
use Postbode\Request\PostalRequest;

/** @var \Postbode\PostbodeApiClient $postbode */
$postbode = require __DIR__ . '/bootstrap.php';

$customerCode = $argv[1] ?? null;

if ($customerCode === null) {
    fwrite(STDERR, "Usage: php examples/send-letter.php <customer-code>\n");

    exit(1);
}

$envelope = $postbode->envelopes->listForMailbox($customerCode)->first();

if ($envelope === null) {
    fwrite(STDERR, "Mailbox {$customerCode} has no envelopes yet.\n");

    exit(1);
}

$request = PostalRequest::make($customerCode, $envelope->uuid)
    ->addDocumentFromFile(__DIR__ . '/../tests/pdf/Letter.pdf')
    ->shipping(ShippingType::NL_FAST)
    ->printing(PostalPrinting::BLACK)
    ->plex(PostalPlex::DUPLEX)
    ->customerReference('EXAMPLE-' . bin2hex(random_bytes(4)))
    ->metadata(['source' => 'postbode-api examples'])
    ->send(false);

try {
    $postal = $postbode->postals->create($request);
} catch (ValidationException $exception) {
    fwrite(STDERR, $exception->getMessage() . "\n");

    foreach ($exception->getErrors() as $field => $messages) {
        fwrite(STDERR, sprintf("  %s: %s\n", $field, implode(' ', $messages)));
    }

    exit(1);
} catch (PostbodeException $exception) {
    fwrite(STDERR, $exception->getMessage() . "\n");

    exit(1);
}

printf("Created  %s\n", $postal->reference);
printf("UUID     %s\n", $postal->uuid);
printf("Status   %s (%d)\n", $postal->status->name, $postal->status->rawCode);
printf("Pages    %d on %d sheets, %d grams\n", $postal->pages, $postal->sheets, $postal->weight);
printf("Price    € %.2f incl. VAT\n", $postal->financial->price->amountInclVat);

// Retrieving it again proves the item exists on the server, not just in this response.
$fetched = $postbode->postals->get($postal->uuid);
printf("Fetched  %s\n", $fetched->reference);

// To actually ship it, call this instead of the delete below:
// $postbode->postals->send($postal->uuid);

$postbode->postals->delete($postal->uuid);
echo "Deleted the concept again.\n";