Create file processing settings | Solvimon

curl -X POST https://test.api.solvimon.com/v1/file-processing-settings \
     -H "X-API-KEY: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "reference": "meter_data_config_2024",
  "type": "METER_DATA"
}'

{
  "reference": "meter_data_config_2024",
  "type": "METER_DATA",
  "object_type": "file_processing_settings",
  "id": "f3a1b2c4-d567-4e89-9abc-1234567890ab",
  "meter_data": {
    "mapping_column": "meter_id",
    "mappings": [
      {
        "column_values": [
          "electricity",
          "water"
        ],
        "meter_reference_mapping": {
          "column": "meter_ref",
          "custom_field": "custom_meter_ref",
          "id": "meter123",
          "reference": "meter_ref_001"
        },
        "ingest_reference_mapping": {
          "column": "ingest_ref",
          "prefix": {
            "column": "prefix_col",
            "custom_field": "prefix_custom_field"
          }
        },
        "meter_property_mappings": [
          {
            "column": "voltage",
            "id": "prop001",
            "reference": "voltage_level",
            "default_value": {
              "absent_column": "N/A",
              "empty_field": "0"
            }
          }
        ],
        "meter_value_mappings": [
          {
            "id": "val001",
            "reference": "consumption_value",
            "column": {
              "number": "consumption_num",
              "amount": {
                "quantity": "consumption_qty",
                "currency": "USD"
              }
            },
            "default_value": {
              "number": {
                "absent_column": "0",
                "empty_field": "0"
              },
              "amount": {
                "quantity": {
                  "absent_column": "0",
                  "empty_field": "0"
                },
                "currency": {
                  "absent_column": "USD",
                  "empty_field": "USD"
                }
              }
            }
          }
        ]
      }
    ],
    "customer_reference_mapping": {
      "column": "customer_id",
      "custom_field": "customer_ref"
    }
  },
  "bucket_location": "s3://solvimon-meter-data/2024/",
  "download_settings": {
    "authentication": {
      "api_key": {
        "header": "X-API-KEY",
        "value": "a1b2c3d4e5f67890"
      },
      "client_credentials": {
        "client_id": "client_abc123",
        "client_secret": "secretXYZ789"
      },
      "username_password": {
        "username": "apiuser",
        "password": "securePass!2024"
      }
    }
  },
  "included_customers": [
    {
      "id": "cust001",
      "reference": "customer_001",
      "custom_field_value": "premium"
    }
  ],
  "excluded_customers": [
    {
      "id": "cust999",
      "reference": "customer_999",
      "custom_field_value": "inactive"
    }
  ]
}

Authentication

X-API-KEYstring

API Key authentication via header

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

versionstringRequiredDefaults to 1

version

Request

This endpoint expects an object.

referencestringRequiredformat: "^\S+$"0-256 characters

typeenumRequired

Allowed values:

meter_dataobjectOptional

bucket_locationstring or nullOptional

download_settingsobjectOptional

included_customerslist of objects or nullOptional

excluded_customerslist of objects or nullOptional

Response

Created

referencestringformat: "^\S+$"0-256 characters

typeenum

Allowed values:

object_typestring or nullRead-only

idstring or nullRead-only

meter_dataobject

bucket_locationstring or null

download_settingsobject

included_customerslist of objects or null

excluded_customerslist of objects or null

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

409

Conflict Error

500

Internal Server Error

Authentication

Path parameters

Headers

Request

Response

Errors