Data Import/Export API: Extend import API

[beesaferoot]

Makes progress on #1232

Brief summary of the change made

Are there any other side effects of this change that we should be aware of?

Describe how you tested your changes?

Pull Request checklist

Please confirm you have completed any of the necessary steps below.

• Meaningful Pull Request title and description
• Changes tested as described above
• Added appropriate documentation for the change.
• Created GitHub issues for any relevant followup/future enhancements if appropriate.

[dmohns]

I'm trying to import a customer + device. They both import fine, but the resulting objects are not linked 🤔

{
  "data": [
    {
      "title": "Mr",
      "name": "Daniel",
      "surname": "Test User",
      "birth_date": "2026-03-01",
      "gender": "male",
      "email": "",
      "phone": "",
      "city": "Mafia Village",
      "devices": "123456789",
      "agent": ""
    }
  ]
}

{
  "data": [
    {
      "id": 71,
      "customer": "Daniel Test User",
      "device_info": {
        "type": "solar_home_system",
        "manufacturer": "Spark SHS",
        "serial_number": "123456789",
        "appliance": "Spark Kit"
      },
      "tokens": [],
      "address": {
        "city": "Mafia Village",
        "street": "fadfkldsajlkf"
      },
      "created_at": "2026-03-04 11:34:57",
      "updated_at": "2026-03-04 11:35:31"
    }
  ]
}

But the result

[beesaferoot]

I'm trying to import a customer + device. They both import fine, but the resulting objects are not linked 🤔

{
  "data": [
    {
      "title": "Mr",
      "name": "Daniel",
      "surname": "Test User",
      "birth_date": "2026-03-01",
      "gender": "male",
      "email": "",
      "phone": "",
      "city": "Mafia Village",
      "devices": "123456789",
      "agent": ""
    }
  ]
}

{
  "data": [
    {
      "id": 71,
      "customer": "Daniel Test User",
      "device_info": {
        "type": "solar_home_system",
        "manufacturer": "Spark SHS",
        "serial_number": "123456789",
        "appliance": "Spark Kit"
      },
      "tokens": [],
      "address": {
        "city": "Mafia Village",
        "street": "fadfkldsajlkf"
      },
      "created_at": "2026-03-04 11:34:57",
      "updated_at": "2026-03-04 11:35:31"
    }
  ]
}

But the result

Let me investigate that, thanks for providing the import data.

[beesaferoot]

@dmohns The devices weren't being linked before; I have updated the logic to handle this. Please, can you test again?

[dmohns]

Thanks for the fix! Proving further range of feedback here:

1. Could we find a different place for the "Import"? Currently, it's in "Settings which I think it doesn't really belong. WDYT about: Rename the top menu to "Configuration", rename the Menu Item to Settings, e.g.

2. Currently, the confirmation dialog only distinguishes between "Imported" and "Failed". From a user's PoV it would be great if we can say "Added" or "Modified". For example, re-importing the same JSON twice. First time it should say N entries added. Second time it should say N entries modified.

   PS: If this is too hard too add, we can keep as nice-to-have.

3. Something is off with device geo. The sample contains an address field. But it should have a GeoInformation entry, right? Not sure if I'm missing something.

[dmohns]

Another thing I just noticed:

4. Phone number is not enforced to be unique. For example using the import it is possible to create two different users with the same Phone number. The database seems to allow this, but it causes problems mapping sms to the right customer.

[beesaferoot]

@dmohns I've addressed your comments. Please let me know if anything else is left to be done on my end.

[dmohns]

I'm trying to modify an existing user. It works, but the confirmation dialog looks like this:

Same when adding a new Device. The device gets added. But the dialog shows 0/0/0.

[dmohns]

Is there a way to surface the import error to the users?

For example

is not very helpful.

But what I can see in dev tools is

[beesaferoot]

Is there a way to surface the import error to the users?

For example

is not very helpful.

But what I can see in dev tools is

There should be a way, but it will be quite tricky. Handling bulk uploads, the errors can become pretty large.

How about adding this as an improvement on subsequent PRs?

[beesaferoot]

I'm trying to modify an existing user. It works, but the confirmation dialog looks like this:

Same when adding a new Device. The device gets added. But the dialog shows 0/0/0.

This has now been fixed.

[dmohns]

Nice! Let's keep the error handling as a future improvement.