AccountImports

Preview an import of managed accounts

Reads the same files as POST /v1/accounts/imports and answers the same shape without writing anything: no account is provisioned, no NIF is switched on, no series and no customer are created, and nothing is billed.

  • Result shape: metadata.is_dry_run is true, every write counter in statistics is 0, and statistics.importable is what a real import would create.
  • Per row: it resolves the row's own data — including the repairs a spreadsheet export needs, which accounts_file describes — whether the tax id is in the AEAT register, whether the external_ref is already an account of yours, and the Live activation verdict that decides whether the import would execute the row at all.
  • statistics.live_activations_pending: read it before importing. Every NIF switched on in Live adds an item to your subscription, and this is the only place to see the total before it is charged.
  • The customers file is checked once for the whole import: whether a customer is new to a given account depends on the account, and that only shows up when the import runs.
post/v1/accounts/imports/preview

Request

  • Base URL: https://app.beel.es/api
  • URL: https://app.beel.es/api/v1/accounts/imports/preview
  • Auth: HTTP bearer

Response

Preview completed. Nothing was written and nothing was billed.

successboolean required

Example response

{
  "success": true,
  "data": {
    "metadata": {
      "total_rows": 19,
      "processing_time_ms": 18400,
      "environment": "PROD"
    },
    "accounts_validation": [
      {
        "row_number": 2,
        "status": "VALID",
        "live_activation_verdict": "CHECKOUT_REQUIRED",
        "customers": {
          "created": 3,
          "already_existed": 37
        },
        "errors": [
          {
            "code": "LIVE_ACTIVATION_NOT_ENTITLED",
            "column": "direccion_codigo_postal"
          }
        ],
        "warnings": [
          {
            "code": "LIVE_ACTIVATION_NOT_ENTITLED",
            "column": "direccion_codigo_postal"
          }
        ]
      }
    ],
    "customers_source": {
      "total_rows": 42,
      "valid": 40,
      "invalid": 2,
      "rejected": [
        {
          "errors": [
            {
              "code": "LIVE_ACTIVATION_NOT_ENTITLED",
              "column": "direccion_codigo_postal"
            }
          ]
        }
      ]
    },
    "own_company_customers": {
      "created": 3,
      "already_existed": 37
    },
    "statistics": {
      "total_rows": 19,
      "valid": 11,
      "with_warnings": 1,
      "already_existed": 6,
      "blocked": 1,
      "importable": 12,
      "accounts_created": 12,
      "live_activations_created": 12,
      "series_created": 24,
      "customers_created": 24
    }
  },
  "meta": {
    "timestamp": "2025-01-15T10:30:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.