Changelog

All notable changes to the SmartBills API will be documented here.

Version 1.2.0 - 2024-01-15

Added

• Line item extraction: New extract_line_items parameter for detailed invoice breakdown
• Webhook signatures: Added signature verification for enhanced security
• Multi-currency support: Improved currency detection for international invoices
• Batch processing: Support for processing multiple files in a single request

Improved

• Accuracy improvements: Enhanced AI models with 15% better extraction accuracy
• Processing speed: 30% faster processing for PDF documents
• Error messages: More detailed error responses with specific guidance

Fixed

• Fixed issue with date parsing for European date formats
• Resolved timeout issues with large PDF files
• Fixed webhook delivery for certain URL patterns

Version 1.1.2 - 2024-01-01

Fixed

• Fixed critical bug in vendor address extraction
• Resolved issue with special characters in invoice numbers
• Fixed webhook retry mechanism

Security

• Updated dependencies to address security vulnerabilities
• Enhanced API key validation

Version 1.1.1 - 2023-12-15

Added

• Rate limit headers: Added rate limit information in response headers
• Request ID tracking: Each request now includes a unique X-Request-ID header

Improved

• Better handling of rotated images
• Improved table detection in complex layouts
• Enhanced validation for webhook URLs

Fixed

• Fixed issue with decimal parsing in certain locales
• Resolved memory leak in image processing
• Fixed pagination in list endpoints

Version 1.1.0 - 2023-12-01

Added

• Webhook support: Real-time notifications when processing completes
• File format expansion: Added support for WEBP images
• Customer information extraction: Now extracts customer/buyer details
• Due date detection: Automatic extraction of payment due dates

Improved

• Enhanced OCR: New machine learning models for better text recognition
• API response format: More consistent and detailed response structure
• Documentation: Comprehensive API documentation with examples

Changed

• Default behavior: extract_line_items now defaults to true
• File size limit: Increased maximum file size from 5MB to 10MB
• Rate limits: Adjusted rate limits for better performance

Deprecated

• Old webhook format (v1.0) will be removed in version 2.0

Version 1.0.5 - 2023-11-15

Fixed

• Fixed issue with PDF parsing for certain PDF generators
• Resolved timeout errors for complex multi-page documents
• Fixed currency symbol recognition

Security

• Implemented additional API key validation
• Enhanced file upload security checks

Version 1.0.4 - 2023-11-01

Added

• Tax information extraction: Now extracts tax IDs and VAT numbers
• Confidence scores: Added confidence metrics for extracted fields

Improved

• Better handling of handwritten invoices
• Improved table extraction for line items
• Enhanced error reporting

Fixed

• Fixed issue with invoice number detection in certain formats
• Resolved encoding issues with special characters

Version 1.0.3 - 2023-10-15

Added

• Multi-page PDF support: Process documents with up to 50 pages
• Address parsing: Structured extraction of vendor and customer addresses

Improved

• Faster processing for single-page documents
• Better detection of invoice vs. receipt documents
• Enhanced total amount extraction accuracy

Fixed

• Fixed issue with date formats in non-English documents
• Resolved API timeout for large files

Version 1.0.2 - 2023-10-01

Added

• Image rotation detection: Automatic correction of rotated images
• Quality validation: Pre-processing quality checks with suggestions

Improved

• Enhanced vendor name extraction
• Better handling of scanned documents
• Improved error messages for common issues

Fixed

• Fixed decimal parsing for different number formats
• Resolved issue with invoice detection in receipts

Version 1.0.1 - 2023-09-15

Added

• Line item extraction: Basic support for extracting individual line items
• Currency detection: Automatic detection of invoice currency

Improved

• Better OCR accuracy for printed text
• Enhanced invoice boundary detection
• Improved total amount extraction

Fixed

• Fixed issue with PDF text extraction
• Resolved timeout errors for large images

Version 1.0.0 - 2023-09-01

Added

• Initial release: Core invoice extraction functionality
• Basic field extraction: Invoice number, date, total amount, vendor name
• File format support: PDF, JPG, PNG
• RESTful API: Simple HTTP API for invoice processing
• Authentication: API key-based authentication
• Rate limiting: Basic rate limiting for API usage

Breaking Changes

Version 1.1.0

• Response format changes: Some field names in the response have been updated for consistency
• Error codes: New standardized error codes (old codes still supported but deprecated)

Migration Guide

From v1.0 to v1.1

Updated Response Fields:

// Old format (v1.0)
{
  "vendor_info": {
    "company_name": "Acme Corp"
  }
}

// New format (v1.1+)
{
  "vendor": {
    "name": "Acme Corp"
  }
}

Updated Error Codes:

// Old format
{
  "error": "INVALID_FILE"
}

// New format
{
  "error": {
    "code": "INVALID_FILE_FORMAT",
    "message": "File format not supported"
  }
}

Upcoming Features

Version 1.3.0 (Q2 2024)

• SDK releases: Official SDKs for Python, JavaScript, and PHP
• Advanced line item extraction: Enhanced table detection and parsing
• Custom field extraction: Configure custom fields for specific use cases
• Bulk processing API: Process multiple files with a single API call

Version 2.0.0 (Q3 2024)

• GraphQL API: Alternative GraphQL endpoint for more flexible queries
• Real-time processing: WebSocket support for real-time extraction updates
• Advanced analytics: Detailed processing metrics and insights
• Template matching: AI-powered template recognition for faster processing

API Versioning

SmartBills uses semantic versioning for our API:

• Major version (e.g., 1.x.x → 2.x.x): Breaking changes that require code updates
• Minor version (e.g., 1.1.x → 1.2.x): New features, backward compatible
• Patch version (e.g., 1.1.1 → 1.1.2): Bug fixes and security updates

Version Support Policy

• Current version: Full support with new features and bug fixes
• Previous major version: Security updates and critical bug fixes for 12 months
• Deprecated versions: 6-month notice before discontinuation

API Version Headers

You can specify the API version in your requests:

curl -X POST https://api.smartbills.com/v1/invoices/extract \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "SmartBills-Version: 1.2.0" \
  -F "file=@invoice.pdf"

If no version is specified, the latest stable version is used.

Stay Updated

• API Status: status.smartbills.com
• Developer Newsletter: Subscribe for API updates and new features
• GitHub: Follow our public roadmap
• Discord: Join our developer community