Search guides, API overviews and endpoints by name, path or keyword.

Mass load

Upload a device offer or devices file, validate it and execute the load.

Admin Last updated

Update the catalogue of the selected tenant from an Excel file: you upload it, the system validates it and, if the validation passes, you execute the load. The Loads table keeps the history.

Open Mass load in Admin →

ℹBefore you start
Select a tenant in the Admin header. The load applies to that tenant, and the file name must contain the tenant name.

How a load works

Every load goes through three phases:

PhaseWhat happensStatuses
LoadThe file is uploaded.Loaded
ValidationThe file content is checked without changing the catalogue.Validation in progress, Validated, Validation error
ExecutionThe changes are applied to the catalogue.Execution in progress, Executed, Execution error

While a load is being validated or executed, the Load in progress notice appears and you cannot start another one.

Look up the loads

The Loads table shows, for each load, the file and its ID, the type, who uploaded, validated and executed it (with the date of each phase) and the status. The clock icon of a phase shows when it finished. You can filter by User (the exact email of whoever uploaded it), Load type and State.

Loads table with loads in several statuses

The menu of each load offers, depending on the case:

  • Validate: only if the load is Loaded and you have write permission.
  • Execute: only if the load is Validated and you have write permission.
  • Download: downloads the original file. Available when the load is Loaded, Validated or Executed.
  • View status: the detail the system returned, for example the validation errors. It also opens when you press the status.

Create a load

  1. Press New load.

  2. In Entity to load, pick what you are loading:

    EntityWhat for
    Device offerThe sale terms of the devices.
    DevicesThe device data.
    Offer of devices on loanThe terms of the devices on loan. It is in beta.
  3. If you picked Device offer, pick the Load type: New registration (Tariff) or Renewal (Segment), and press Continue.

  4. Drag or select the file. Only one XLS or XLSX file is accepted, up to 20 MB, whose name contains the tenant name. The upload starts at once.

  5. When you see “The file has been uploaded successfully”, press:

    • Validate to validate the file and decide later whether to execute the load;
    • Validate and execute to have the load executed on its own as soon as the validation passes.
Picking the entity to load

These guides do not cover the columns of each file. For that, ask the Catalogue team.

Validate and execute a load

  1. In the Validation step, wait for it to finish. If it passes, you see “Load validated successfully”.
  2. Press Execute and wait for “Load executed successfully”. Press Finish.

If the validation fails, Status detail shows the errors. Fix the file and create a new load.

If you do not want to execute the load now, close the file with ✕ and answer Yes to “Do you wish to postpone the execution process?”. The load stays Validated: you can execute it later from its menu, with Execute.

To validate or execute a load that is already in the table, use Validate or Execute in its menu. A panel opens with the load data and the same progress.

Catalogue deployments are handled separately, in Offer deployment.

The screenshots show the Admin interface in Spanish.

When something is not as expected

You seeWhat it means and what to do
”The file cannot be uploaded because the name does not match the selected tenant for the load”The file name does not contain the header tenant name. Rename it or change tenant.
”There was an error uploading the file”The upload failed. The error the system returned appears below. Delete the file and upload it again.
Validation errorThe file has errors. Press the status or View status to read them, fix the file and upload it again.
Execution errorThe load could not be applied. Press the status to see the detail and ask the Catalogue team.
New load is disabledA load is being validated or executed in the tenant. Wait for it to finish.
You do not see New load, Validate or ExecuteYou do not have write permission for this section. Ask whoever manages your access.
You do not see Mass load in the menuYou do not have read permission for this section. Ask whoever manages your access.

Reference

Load types

TypeWhen it appears
Device offer by tariffDevice offer with the New registration (Tariff) type.
Device offer by segmentDevice offer with the Renewal (Segment) type.
DevicesDevices.
Offer of devices on loanOffer of devices on loan.

In the Load type filter, the first two appear as Tariff and Segment.