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