Imports

Import data in bulk to the platform via file upload.

Importable Resources

The same resources supported in exports: products, customers, invoices, subscriptions, plans, service items, coupons, and product groups.

Import Status

Status	Description
pending	Queued
processing	Being processed
completed	Success, no errors
completed_with_errors	Partial success, some records failed
failed	Critical error, processing aborted

Flow

1. Upload the file (CSV, XLSX, or JSON)
2. The file is stored in S3
3. The job is queued for asynchronous processing
4. The worker reads the file, validates each row, and creates/updates records
5. Errors are tracked per row
6. The import is updated with the result

Progress Tracking

Field	Description
Total rows	Total in the file
Processed rows	Current progress
Success	Successfully imported records
Errors	Failed records
Error details	Row and reason for each error

Error Example

[
  { "row": 5, "error": "Invalid product name" },
  { "row": 12, "error": "Duplicate CNPJ" }
]