Error Codes

{
  "error": {
    "code": "validation_error",
    "message": "The given data was invalid.",
    "details": {
      "customer_id": ["The customer_id field is required."],
      "items": ["The items field must have at least 1 item."]
    },
    "request_id": "req_abc123xyz"
  }
}

{
  "error": {
    "code": "zimra_submission_failed",
    "message": "ZIMRA rejected the invoice submission.",
    "details": {
      "zimra_code": "ERR_INVALID_TIN",
      "zimra_message": "Customer TIN is not registered with ZIMRA"
    },
    "request_id": "req_def456uvw"
  }
}

<?php

use VasBox\VasBox;
use VasBox\Exceptions\ValidationException;
use VasBox\Exceptions\ZimraException;
use VasBox\Exceptions\RateLimitException;

$vasbox = new VasBox(env('VASBOX_API_KEY'));

try {
    $invoice = $vasbox->invoices->create([
        'customer_id' => 'cust_123',
        'items' => [],
    ]);
} catch (ValidationException $e) {
    // Handle validation errors
    foreach ($e->getErrors() as $field => $messages) {
        echo "$field: " . implode(', ', $messages);
    }
} catch (ZimraException $e) {
    // Handle ZIMRA-specific errors
    echo "ZIMRA Error: " . $e->getZimraCode();
} catch (RateLimitException $e) {
    // Handle rate limiting - retry after delay
    sleep($e->getRetryAfter());
} catch (\Exception $e) {
    // Handle other errors
    echo "Error: " . $e->getMessage();
}

import { VasBox, ValidationError, ZimraError, RateLimitError } from '@vasbox/sdk';

const vasbox = new VasBox(process.env.VASBOX_API_KEY);

try {
    const invoice = await vasbox.invoices.create({
        customer_id: 'cust_123',
        items: [],
    });
} catch (error) {
    if (error instanceof ValidationError) {
        // Handle validation errors
        Object.entries(error.details).forEach(([field, messages]) => {
            console.log(`${field}: ${messages.join(', ')}`);
        });
    } else if (error instanceof ZimraError) {
        // Handle ZIMRA-specific errors
        console.log('ZIMRA Error:', error.zimraCode);
    } else if (error instanceof RateLimitError) {
        // Handle rate limiting - retry after delay
        await new Promise(r => setTimeout(r, error.retryAfter * 1000));
    } else {
        // Handle other errors
        console.error('Error:', error.message);
    }
}