Skip to main content

customerCsvImport

Import multiple customers from CSV data with validation and error handling.

Key Features​

  • **Bulk Import**: Process multiple customers from CSV data in a single operation
  • **Data Validation**: Validates all customer data according to business rules
  • **Error Handling**: Provides detailed results for successful and failed imports
  • **Transaction Safety**: Ensures data integrity during bulk operations

Business Rules​

  • CSV data must conform to expected format and structure
  • All customer validation rules apply to imported data
  • Email uniqueness is enforced across all imported customers
  • Debtor ID uniqueness is enforced if provided
  • Import is processed in batches for performance

Validation Rules​

  • All standard customer validation rules apply
  • CSV format validation is enforced
  • Required fields must be present in CSV data
  • Field length limits are enforced
  • Email format validation is applied

Error Scenarios​

  • **CUSTOMER_CSV_IMPORT_ERROR**: System error occurred during CSV import
  • **CUSTOMER_BULK_VALIDATION_ERROR**: Validation errors in CSV data
  • **CUSTOMER_BULK_CREATE_ERROR**: Error occurred during bulk customer creation
  • **CUSTOMER_ALREADY_EXISTS_ERROR**: Imported customer conflicts with existing data

Use Cases​

  • Customer data migration
  • Bulk customer onboarding
  • Data import from external systems
  • Customer database population

AUTH: Role=[user.OWNER]

customerCsvImport(
  input: CustomerCsvInput!
): CsvImportResponse!

Arguments​

customerCsvImport.input ● CustomerCsvInput! non-null input​

CSV import data including file content and mapping configuration

Type​

CsvImportResponse object​