Maintenance
Migrate BoxBilling exports
BoxBilling native collections, exact export requirements, mapping limits and safe imported state.
About 2 min read
On this page
Supported source and collections
The reviewed newer Migration centre has an explicit BoxBilling reader. This is an export-file reader requiring the matching released core; it is not a live account connector or an automatic database cutover. Select BoxBilling and the exact destination storefront.
Native export format: Admin client, product and order API JSON exports.
Native collections: customers, products, services.
Source-specific preparation
Legacy API field mapping, separate from FOSSBilling version assumptions. Use mapped files for complete domain and financial history. Service quantity must be one.
Export all pages and keep stable source IDs. Remove passwords, password hashes, tokens, saved card/payment instruments and provider credentials. Use a stable source_instance across batches and explicit ISO currency mappings; never infer currency from a symbol or destination default. For collections outside this native reader, choose mapped CSV/JSON and supply every required field explicitly.
Preview and import
Review the complete field and wrapper reference, then upload within the bounded size/row limit. Preview owner, destination, counts, normalised samples, currency mappings and conflicts. Apply only that unchanged reviewed preview with the required sensitive-admin confirmation. An exact repeated source import is idempotent; conflicting changed records are held, not overwritten.
Imported state and limits
New customers start disabled with new random passwords; products stay inactive/manual; automatic service/domain renewal and provider mapping remain off. Historical invoices remain legacy_review and cannot request payment until reconciliation. Historical payments move no funds. Source contacts, ownership, dates and amounts are preserved where supported, while unsupported ticket attachments/messages, orders, credit ledgers, mandates and configuration need separate review. Negative native credit lines are refused instead of silently converted.
Use Migration centre operations for multi-batch parent references, explicit existing-customer mapping, encrypted provenance, transaction/conflict behavior and the guarded CLI. A successful preview is not a production migration acceptance.