Skip to Content
ChangelogAPI Changelog

API Changelog

All notable changes to the Borderbolt API are documented here. The API follows Semantic Versioning : MAJOR (breaking changes), MINOR (new features), PATCH (fixes).

v1.10.0

Release Date: 2026-04-21

New Features

  • Portbase Integration — Borderbolt now integrates with Portbase, the Netherlands’ digital port community system. Automatically pre-notify import and export documents to port terminals when declarations are released by customs. Track cargo status in real-time including vessel arrival, unloading progress, inspection status, and documentation availability. See Portbase Settings and Portbase Notifications.

Enhancements

  • Notifications for import declarations are sent automatically to configured terminals when release confirmation is received
  • Notifications for export declarations are sent when release or exit confirmation is received
  • Real-time cargo tracking available on declaration detail pages
  • Configurable automatic or manual submission workflow
  • Automatic retry logic for failed notifications (3 attempts with exponential backoff)
  • Encrypted credential storage for Portbase API keys

Configuration

  • New setting: Portbase Integration in Settings → Portbase
  • Credentials stored per company with encrypted secret key storage
  • Separate test and production environment support
  • Granular control over import/export notification services

v1.9.0

Release Date: 2026-04-08

New Features

  • Warehouse Inventory — Borderbolt now manages warehouse stock created from import placements and from manual starting inventory entries. Stock is automatically credited when a placement declaration is released by Dutch Customs, and can also be created directly via the Inventory screen or the Inventory API.
  • Stock allocation on declarations — Import clearance, export, and co-filing declaration line items can now carry an inventory_line_id field to allocate them to a specific stock lot. The previous-document references are populated automatically from the lot’s parent placement. FIFO is the default suggestion when no specific lot is supplied. See Stock Allocation.
  • Inventory API — GET /v1/inventory, GET /v1/inventory/{id}, GET /v1/inventory/lines/{id}/movements, POST /v1/inventory/starting, POST /v1/inventory/lines/{id}/adjust, plus per-line allocation endpoints GET /v1/declaration-lines/{id}/allocation/available, POST /v1/declaration-lines/{id}/allocation, PUT /v1/declaration-lines/{id}/allocation, DELETE /v1/declaration-lines/{id}/allocation.
  • Entry in Declarant’s Records — Full support for declarations recorded in your own books and notified to Dutch Customs afterwards, with both minimum and maximum dataset variants, the chain procedure exemption, the 10-day supplementary deadline tracking, and the daily supplementary batch. See Entry in Declarant’s Records.
  • Warehouse Audit File — Generate a monthly password-protected stock audit file from the Warehouse Audit File screen. The report contains the full stock ledger, opening and closing balances, and all goods characteristics for the selected month. Download the password-protected archive and upload it to Dutch Customs via their file transfer service. The Warehouse Audit File is a UI feature in this release; API generation support is planned for a future version.

Enhancements

  • Declaration line responses now include inventory_line_id, inventory_header_id, and the resolved registration and customs references for allocated stock.
  • The validation engine now blocks any submission attempt that cites a registration reference without the matching customs reference on chain-procedure supplementary declarations.
  • The validation engine now blocks any Entry in Declarant’s Records submission whose consignee is not authorised for the procedure.

Scopes

  • New scopes: inventory:read, inventory:write. Allocating stock to a declaration line at submit time requires both declarations:write and inventory:write.

v1.8.0

Release Date: 2026-04-07

New Features

  • Declaration variants B through F — Support for incomplete declarations (B, C), advance declarations (D), and combined incomplete advance declarations (E, F). Each variant enters a multi-step lifecycle with follow-up calls after the initial submission. See Declaration Variants and Declarations.
  • Send advance notification endpoint — POST /v1/declarations/{id}/send-presentation dispatches the advance notification for advance declarations (D, E, F) after goods arrival.
  • Send supplementary declaration endpoint — POST /v1/declarations/{id}/send-supplementary dispatches the supplementary declaration for incomplete declarations (B, C, E, F) within the one-month deadline. Returns the additional_declaration_type (X or Y) that was sent.
  • Combined variant ordering — For variants E and F, the advance notification must be accepted by Dutch Customs before the supplementary declaration can be sent. The API enforces this order and returns advance_notification_pending if called out of sequence.

Enhancements

  • The symbol request field on declaration create/update now accepts A through F (previously A only).
  • Declaration list and detail responses now include is_incomplete, is_pre_declaration, supplementary_sent_at, and presentation_sent_at status fields so API consumers can track the multi-step lifecycle.
  • Corrected the declaration-submit reference: imex carries the direction (IM, EX, CO) and symbol carries the variant (A-F). Previous revisions of the docs had these two fields swapped.

Scopes

No new scopes; the new endpoints use the existing declarations:submit scope.

v1.7.0

Release Date: 2026-03-27

New Features

  • Send Invoice Email - New endpoint to email finalized invoices to customers with PDF attached (POST /invoices/{id}/send-email)
  • Payment Reference Tracking - Mark as Paid now supports payment_reference for bank transaction IDs, returned in invoice responses with paid_by user name
  • Customer Invoice Settings - New invoice_email and invoice_auto_send fields on customer master data for automated invoice delivery
  • Auto-Send on Finalize - When customer has invoice_auto_send enabled, invoices are automatically emailed upon finalization
  • Rate Card Billing Frequencies - Support for delayed, weekly, and monthly billing cycles with delayed_frequency_days and invoice_run_time configuration
  • Periodic Invoice Generation - Automated periodic invoice generation supporting delayed, weekly, and monthly billing frequencies with per-organization processing
  • Invoice Run Logging - Track invoice generation runs with status, results, and error details via InvoiceRunLog
  • Prepayment Invoices - Support for advance billing with is_prepayment flag on invoices
  • Invoice Line Deduplication - Three modes (allow_duplicates, update_existing, skip) to control duplicate line handling
  • Invoicing Payments Permission - New invoicing.payments permission controlling access to mark-paid and prepayment features
  • Dossier Ready-to-Invoice Status - New dossier status enabling invoice generation workflow
  • Customer Locations - New customer_locations table for multi-location customer management

Enhancements

  • Invoice responses now include payment_reference, paid_by, and paid_at fields
  • Mark as Paid endpoint accepts optional payment_reference parameter
  • Finalized invoices with auto-send enabled bypass the “sent” step automatically

v1.6.0

Release Date: 2026-03-25

New Features

  • Documents API - Full document management for declarations via API
    • List all documents for a declaration (GET /declarations/{id}/documents)
    • Get single document metadata (GET /declarations/{id}/documents/{documentId})
    • Download document file (GET /declarations/{id}/documents/{documentId}/download)
    • Upload documents to declarations (POST /declarations/{id}/documents)
    • Update document metadata (PUT /declarations/{id}/documents/{documentId})
    • Supports 20 document types (invoice, packing list, B/L, CMR, EUR.1, etc.)
    • Max upload size: 50 MB per file

Scopes

Documents use existing declarations:read and declarations:write scopes.

v1.5.0

Release Date: 2026-03-24

New Features

  • Report Exports API - Export default Stratech-compatible reports (Import, Export, DVA Departure, DVA Arrival)
    • 7-day weekly cap: query any week, but max 7 days per request
    • CSV output (streamed, semicolon-delimited, UTF-8 BOM) and JSON output (paginated)
    • Filter by acceptance date or created date, and by declaration status

Scopes

  • reports:read - List and run reports
  • reports:export - Export reports to CSV/JSON

v1.4.0

Release Date: 2026-03-24

New Features

  • Guarantee Level API - View customs surety and DVA guarantee balance levels with usage thresholds (normal/warning/critical)
  • Dossier API - Full CRUD for dossiers, purchase lines (costs), and invoice lines (revenue). Status management with validated transitions
  • Invoice API - Full invoice lifecycle: create, add lines, finalize, mark sent/paid. Generate invoices from dossier pending lines
    • Invoice PDF download via API

Scopes

  • guarantees:read - View guarantee balances
  • dossiers:read / dossiers:write / dossiers:delete - Dossier management
  • invoices:read / invoices:write / invoices:delete - Invoice management

v1.3.0

Release Date: 2026-03-14

New Features

  • SKU Consolidation (Mode A) - Send declaration.skus[] with SKU codes + quantities; system resolves from Item Master, groups by HS code, and creates consolidated declaration lines
  • SKU Details (Mode B) - Attach sku_details[] to manual items for per-SKU breakdown tracking
  • Combined mode: use both skus[] and items[] in a single request
  • SKU details returned in GET declaration and lines responses
  • Auto currency normalization to EUR for mixed-currency SKU groups
  • Duplicate SKU codes automatically merged (quantities summed)

v1.1.0

Release Date: 2025-12-31

New Features

  • Declaration Submit API - Submit Import, Export, and Transit declarations
    • Full validation using same rules as UI
    • Support for representation_type (direct/indirect)
    • Domestic duty tax party (id/role) support
    • Packaging data (type, quantity, marks)
  • Webhooks - Real-time status and document callbacks
    • HMAC-SHA256 signature verification

Scopes

  • declarations:write - Submit declarations

v1.0.0

Release Date: 2025-12-10

Initial Release

  • OAuth2 Authentication - Client Credentials flow for machine-to-machine access
    • Token endpoint, revocation, and token info
  • Declarations API - Full CRUD operations
    • List with filters (status, workflow, MRN, reference, customer, dates)
    • Get single declaration with all lines
    • Create, update, and delete draft declarations
    • Declaration lines: add, update, delete, duplicate
  • Reports API - List, run, and export saved reports
    • Default reports: Import, Export, DVA Departure, DVA Arrival
  • Customers API - Customer master data management
    • CRUD operations with contact management
  • Scope-based Access Control - Granular permissions per OAuth client
  • API Usage Logging - Request tracking and monitoring
  • Rate Limiting - 60 requests per minute per OAuth client
  • Error Reference - Structured error responses with field-level validation details
Last updated on
Portal User Management