Warranty Templates

Pocketbook supports comprehensive product warranty certificates through custom enterprise templates. This guide explains how to create, use, and manage warranty certificates for products.

Overview

Warranty templates enable enterprises to issue blockchain-backed warranty certificates for their products. Each warranty certificate is an NFT that includes structured warranty information, making it verifiable, transferable, and immutable.

Key Benefits:

Blockchain Verification: Warranties are immutably recorded on-chain
Automatic Calculations: End dates calculate automatically based on warranty periods
Status Tracking: Real-time warranty status (Active, Expired, Not Yet Active)
Transferable: Warranties can transfer with product ownership
Transparent: Public verification available for buyers and recipients

Quick Start

1. Access Template Manager

Navigate to your enterprise dashboard
Click on "Templates" or "Manage Templates"
Select "Create Custom Template"

2. Add Warranty Fields Using the Preset

Pocketbook provides a warranty preset that automatically adds all necessary warranty fields to your custom template:

Warranty Period: 1 year, 2 years, 3 years, 5 years, 10 years, or Lifetime
Warranty Type: Manufacturer, Extended, Limited, Full Coverage, Parts Only, Labor Only
Warranty Start Date: When coverage begins (required)
Warranty End Date: Auto-calculated or manually overridden
Coverage Details: What is covered under the warranty
Exclusions: What is NOT covered
Claim Process: How to file a warranty claim
Contact Information: Email or phone for warranty service
Terms & Conditions URL: Link to full warranty terms

3. Create a Warranty Certificate

Select your custom warranty template from the template dropdown
Fill in the required fields:
- Choose warranty period and type
- Set start date (end date auto-calculates)
- Describe coverage details and exclusions
- Provide claim process and contact information
Upload product images
Mint the certificate

Warranty Features

Auto-calculation

The warranty end date automatically calculates based on:

Start date + selected period (e.g., "2 years" = start date + 2 years)
"Lifetime" warranties are set to 100 years from start date

You can override the auto-calculated end date if needed.

Status Indicators

Warranty certificates display status chips:

Active: Current date is between start and end dates (green indicator)
Expired: Current date is past end date (red indicator)
Not Yet Active: Current date is before start date (yellow indicator)

Validation

Warning on Expired Warranties: If you attempt to create a certificate with an expired warranty, you'll receive a warning but can proceed
Date Validation: End date cannot be before start date
Required Fields: Period, type, start date, coverage details, claim process, and contact info are required

Creating Custom Warranty Templates

Step-by-Step Template Creation

Go to Template Manager in your enterprise dashboard
Click "Create Custom Template"
In the template field editor, select "Warranty Preset" from the dropdown
Click "Add Warranty Preset" to automatically add all warranty fields
Optionally add additional custom fields for your specific product needs
Save your template

Recommended Field Structure

The warranty preset includes these fields:

Field Key	Field Type	Required	Description
`warranty_period`	select	Yes	Period options (1 year, 2 years, etc.)
`warranty_type`	select	Yes	Coverage type options
`warranty_start_date`	date	Yes	Coverage start date
`warranty_end_date`	date	No	Coverage end (auto-calculated)
`warranty_coverage`	textarea	Yes	What's covered
`warranty_exclusions`	textarea	No	What's not covered
`warranty_claim_process`	textarea	Yes	How to file a claim
`warranty_contact`	text	Yes	Contact information
`warranty_terms_url`	url	No	Link to full terms

Field Configuration Options

Each field supports:

Required/Optional: Mark critical fields as required
Field Types: Text, number, date, select, textarea, URL, email, etc.
Help Text: Provide guidance for users filling out the template
Options: For select fields, define available choices

Practical Examples

Example 1: Electronics Manufacturer Warranty

json

{
  "warranty_period": "2 years",
  "warranty_type": "Manufacturer",
  "warranty_start_date": "2024-01-15",
  "warranty_end_date": "2026-01-15",
  "warranty_coverage": "Covers all defects in materials and workmanship under normal use. Includes free repairs or replacement of defective components.",
  "warranty_exclusions": "Does not cover: accidental damage, water damage, unauthorized repairs, cosmetic damage, or normal wear and tear.",
  "warranty_claim_process": "1. Contact customer service at warranty@electronics.com\n2. Provide proof of purchase and serial number\n3. Describe the issue in detail\n4. Ship product to our service center (prepaid shipping label provided)\n5. Receive repair or replacement within 14 business days",
  "warranty_contact": "warranty@electronics.com or 1-800-TECH-HELP",
  "warranty_terms_url": "https://electronics.com/warranty-terms"
}

Example 2: Furniture Limited Warranty

json

{
  "warranty_period": "5 years",
  "warranty_type": "Limited",
  "warranty_start_date": "2024-03-01",
  "warranty_end_date": "2029-03-01",
  "warranty_coverage": "Covers structural defects and manufacturing flaws in frames, joints, and mechanisms. Fabric and upholstery covered for 1 year against defects.",
  "warranty_exclusions": "Does not cover: damage from improper use, stains, fading from sunlight, damage during moving, pet damage, or commercial use.",
  "warranty_claim_process": "Submit a claim through our online portal at furniture.com/warranty-claim with photos of the issue and your certificate ID. Our team will review within 3-5 business days.",
  "warranty_contact": "support@furniture.com",
  "warranty_terms_url": "https://furniture.com/warranty-policy"
}

Example 3: Automotive Parts Warranty

json

{
  "warranty_period": "Lifetime",
  "warranty_type": "Parts Only",
  "warranty_start_date": "2024-06-10",
  "warranty_end_date": "2124-06-10",
  "warranty_coverage": "Lifetime warranty on parts against defects. Covers replacement parts only for as long as you own the vehicle.",
  "warranty_exclusions": "Labor costs not covered. Does not cover damage from accidents, improper installation, racing, or commercial use.",
  "warranty_claim_process": "Return defective part to any authorized dealer with your warranty certificate. Replacement part will be provided free of charge. Installation labor is customer's responsibility.",
  "warranty_contact": "1-888-AUTO-PART or warranty@autoparts.com",
  "warranty_terms_url": "https://autoparts.com/lifetime-warranty"
}

Example 4: Appliance Extended Warranty

json

{
  "warranty_period": "3 years",
  "warranty_type": "Extended",
  "warranty_start_date": "2024-02-20",
  "warranty_end_date": "2027-02-20",
  "warranty_coverage": "Extended coverage beyond manufacturer warranty. Includes parts, labor, and service calls for mechanical and electrical failures. No deductible required.",
  "warranty_exclusions": "Does not cover: cosmetic issues, regular maintenance, filters, light bulbs, or damage from power surges not protected by surge protector.",
  "warranty_claim_process": "Call our 24/7 service hotline at 1-800-APPLIANCE. A technician will be dispatched within 48 hours. All repairs are covered with no out-of-pocket costs.",
  "warranty_contact": "1-800-APPLIANCE (available 24/7)",
  "warranty_terms_url": "https://appliance-warranty.com/terms"
}

Certificate Display

In Certificate Viewer

Warranty information appears as a collapsible section in the Details tab:

Collapsed View: Shows "Product Warranty" header with status chip and period/type summary
Expanded View: Displays full warranty details including:
- Coverage period and type
- Start and end dates
- What's covered
- Exclusions
- Claim process instructions
- Contact information
- Link to full terms

Public Verification

Warranty information is visible on public certificate verification pages, maintaining transparency for buyers and recipients. Anyone can verify:

Warranty status (active/expired)
Coverage period
What's covered
How to file claims
Contact information

Metadata Structure

Warranty data is stored in two places for maximum compatibility:

NFT Metadata (for marketplaces)

json

{
  "name": "Product Warranty Certificate",
  "description": "Official warranty for Product XYZ",
  "attributes": [
    {"trait_type": "Warranty Period", "value": "2 years"},
    {"trait_type": "Warranty Type", "value": "Manufacturer"},
    {"trait_type": "Start Date", "value": "2024-01-01"},
    {"trait_type": "End Date", "value": "2026-01-01"},
    {"trait_type": "Status", "value": "Active"}
  ]
}

Structured Warranty Object

json

{
  "warranty": {
    "period": "2 years",
    "type": "Manufacturer",
    "startDate": "2024-01-01",
    "endDate": "2026-01-01",
    "coverage": "Covers defects in materials and workmanship under normal use conditions.",
    "exclusions": "Does not cover accidental damage, misuse, or unauthorized repairs.",
    "claimProcess": "Contact customer service at support@company.com with proof of purchase and description of issue.",
    "contactInfo": "support@company.com or 1-800-WARRANTY",
    "termsUrl": "https://company.com/warranty-terms"
  }
}

Best Practices

For Manufacturers

Clear Coverage Details: Be specific about what's covered to avoid disputes
Realistic Exclusions: Clearly state what's not covered to set proper expectations
Accessible Claim Process: Make it easy for customers to file claims with step-by-step instructions
Multiple Contact Methods: Provide email, phone, and online portal options
Regular Updates: Review and update warranty templates as products evolve

For Enterprises

Template Consistency: Use standardized warranty templates across similar product lines
Required Fields: Mark essential warranty information as required to ensure completeness
Validation Rules: Set up appropriate validation to prevent errors
Staff Training: Train team members on warranty certificate creation
Documentation: Maintain internal documentation of warranty policies

For Customers

Review Details: Always check warranty coverage before purchase
Save Certificates: Keep digital certificates accessible and backed up
Understand Terms: Review full terms and conditions at the provided URL
Note Contact Info: Save warranty service contact information
Check Status: Regularly verify warranty status through Pocketbook

Advanced Features

Template Inheritance

Create base warranty templates and extend them for specific product lines with additional custom fields:

Create a base "Standard Product Warranty" template
Clone it for specific product categories
Add category-specific fields (e.g., "Battery Coverage" for electronics)
Maintain consistent core warranty fields across all templates

Bulk Operations

Use warranty templates with bulk certificate creation for large product releases:

Prepare a CSV file with product information and warranty data
Upload to bulk certificate creation tool
Select your warranty template
Generate hundreds of warranty certificates at once

Integration Capabilities

Warranty certificates integrate with:

NFT Marketplaces: Attributes display on OpenSea, Rarible, etc.
Certificate Verification Systems: QR codes link to public verification
Ownership Transfer Tracking: Warranties transfer with product ownership
Burn Functionality: Products can be retired with warranty intact

Troubleshooting

Common Issues

End date not calculating

Ensure start date is properly selected in date format
Verify warranty period is selected from dropdown
Check browser console for JavaScript errors

Template not saving

Verify all required fields are filled
Ensure field keys are unique (no duplicates)
Check that field key names follow naming conventions (lowercase, underscores)

Warranty not displaying

Verify template includes warranty-specific field keys starting with warranty_
Check that warranty preset was properly added
Ensure certificate was minted after template was created

Validation errors

Check date formats (YYYY-MM-DD)
Ensure required fields are completed
Verify end date is after start date

Getting Help

For technical issues with warranty templates:

Check browser console for error messages
Verify template field keys match expected format (warranty_*)
Ensure all required fields are properly configured
Review this documentation for guidance
Contact Pocketbook support with specific error messages

Security Considerations

Immutability: Warranty certificates are immutable once minted on the blockchain
Template Versioning: Template changes only affect future certificates, not existing ones
Access Controls: Enterprise access controls apply to template management
Privacy: Public verification displays warranty info while protecting sensitive data
Audit Trail: All warranty certificate creation and transfers are recorded on-chain

Next Steps

Custom Templates Guide - Learn more about creating custom templates
Certificate Management - Managing issued certificates
Bulk Operations - Issue multiple warranty certificates at once
API Reference - Programmatic certificate creation

Overview ​

Quick Start ​

1. Access Template Manager ​

2. Add Warranty Fields Using the Preset ​

3. Create a Warranty Certificate ​

Warranty Features ​

Auto-calculation ​

Status Indicators ​

Validation ​

Creating Custom Warranty Templates ​

Step-by-Step Template Creation ​

Recommended Field Structure ​

Field Configuration Options ​

Practical Examples ​

Example 1: Electronics Manufacturer Warranty ​

Example 2: Furniture Limited Warranty ​

Example 3: Automotive Parts Warranty ​

Example 4: Appliance Extended Warranty ​

Certificate Display ​

In Certificate Viewer ​

Public Verification ​

Metadata Structure ​

NFT Metadata (for marketplaces) ​

Structured Warranty Object ​

Best Practices ​

For Manufacturers ​

For Enterprises ​

For Customers ​

Advanced Features ​

Template Inheritance ​

Bulk Operations ​

Integration Capabilities ​

Troubleshooting ​

Common Issues ​

Getting Help ​

Security Considerations ​

Next Steps ​

Overview

Quick Start

1. Access Template Manager

2. Add Warranty Fields Using the Preset

3. Create a Warranty Certificate

Warranty Features

Auto-calculation

Status Indicators

Validation

Creating Custom Warranty Templates

Step-by-Step Template Creation

Recommended Field Structure

Field Configuration Options

Practical Examples

Example 1: Electronics Manufacturer Warranty

Example 2: Furniture Limited Warranty

Example 3: Automotive Parts Warranty

Example 4: Appliance Extended Warranty

Certificate Display

In Certificate Viewer

Public Verification

Metadata Structure

NFT Metadata (for marketplaces)

Structured Warranty Object

Best Practices

For Manufacturers

For Enterprises

For Customers

Advanced Features

Template Inheritance

Bulk Operations

Integration Capabilities

Troubleshooting

Common Issues

Getting Help

Security Considerations

Next Steps