# Bulk Site Creation

Bulk site creation is used to onboard up to 2,000 sites to Verifone Commander Central rather than one site at a time. This feature utilizes an Excel Spreadsheet where site information such as service ID, address, and hierarchy assignment is entered in a spreadsheet and then uploaded to the cloud. The data entered is checked for validity after it is uploaded to the cloud and a Bulk Upload Report is generated to provide information on whether the site creation was successful.

### **Downloading the Template**

{% stepper %}
{% step %}
**Sites Form**

Navigate to **Administration > Site Management > Sites**.
{% endstep %}

{% step %}
**Create Site**

Select **Create Site** in the top right corner of the menu.

<figure><img src="/files/ayXWWwJGJylTF4h6SjWl" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Create in Bulk**

Select **Create in Bulk**.

<figure><img src="/files/ZFTMBjgSV20K3PFpxVtT" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Excel Template**

Click on **Downloading Excel Template File.**

<figure><img src="/files/q8jl1ewrd3Di2hSU52Lz" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Download Petro\_Cloud\_Template.xlsx**

Download the Excel document titled **‘Petro\_Cloud\_Template.xlsx’**. When you open the document, you may need to Enable Editing depending upon your Microsoft Excel version.

<figure><img src="/files/teCjWghbzdaHI6oRdvge" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Enter Site Information**

Enter in the site information, one site per row. All fields that have an asterisk (\*) are required. After all the entries are completed, save the changes made to the spreadsheet.

<table><thead><tr><th width="238">Field</th><th>Description</th></tr></thead><tbody><tr><td>Service ID*</td><td>The Verifone Service ID shown in the site’s contract with Verifone.</td></tr><tr><td>Site ID</td><td>Any ID number used by the organization operating the site.</td></tr><tr><td>Site Name*</td><td>The name of the site. This is useful when searching for sites. You must enter a site name and it must be unique to the site.</td></tr><tr><td>Sub Groups*</td><td>Assign a site to a location in the hierarchy using the Sub Groups. The hierarchy subgroups must exist before the bulk upload, or the site will be added to the root company.</td></tr><tr><td>Street Address*</td><td>The physical address of the site.</td></tr><tr><td>City*</td><td>The municipality in which the site is located (or equivalent).</td></tr><tr><td>Zip Code*</td><td>The ZIP code for the site.</td></tr><tr><td>State*</td><td>Choose a state from the drop-down list.</td></tr><tr><td>Custom Attributes</td><td>You can create your own attributes for sorting and filtering sites. See below for more information.</td></tr></tbody></table>

{% hint style="warning" %}
A valid Verifone Service ID MUSTbe entered. If the entry is incorrect the site will not be onboarded.
{% endhint %}
{% endstep %}

{% step %}
**Template Download Page**

Return to the Template Download page on Verifone Commander Central and select Continue at the bottom of the page.
{% endstep %}

{% step %}
**Drag and Drop**

Drag and dropthe Petro Cloud Template Spread sheet in the dotted area or Browse files and locate the file to upload.

<figure><img src="/files/TWFNAjcxYgtEPFthFnq0" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Drag and drop XLS file here**

After the file is ready to transfer, the ‘’ will update to the name of the file selected. Click Continue to upload the file.
{% endstep %}

{% step %}
**Transaction ID**

The Done screen will appear. A **transaction ID**for the upload will be generated for your reference. From here, you can select reports page on the screen to view the **Bulk Upload Report**, or you can navigate to View Sites.

<figure><img src="/files/U5D8o5A35Tg78p5cz8e3" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### **Bulk Upload Report**

After a bulk site upload is completed, a Bulk Upload report is generated to provide details on which sites were successfully added to Verifone Commander Central.

The report can be accessed by selecting the ‘reports page’ text in blue (shown above) or by navigating to Administration > Site Management > Bulk Upload Report. Each Bulk Upload performed has a Transaction ID generated, allowing you to review the specific Transaction ID in the reports list.

A status is generated to let you know if there was an Error in the upload, or if the upload was completed successfully. Since multiple sites can be uploaded at the same time, an Error response will appear even if there is only one site that had an issue. If all sites upload without any errors, the Status will show a green Success.

#### **Bulk Upload Report Errors**

The following errors may occur during upload. Utilize the table below to resolve any errors that occurred during the upload. Be sure to select the Transaction ID associated with the upload.

<table><thead><tr><th valign="top">Error</th><th valign="top">Description</th><th valign="top">Resolution</th></tr></thead><tbody><tr><td valign="top">Mandatory Fields Required</td><td valign="top">If any mandatory fields are missing (Service ID, Site Name, Address Line 1, Country, State, City, or Zip code).</td><td valign="top">Confirm that the information is present in the mandatory fields and upload the site again.</td></tr><tr><td valign="top">Invalid Service ID Range</td><td valign="top">If the Service ID Length is less than 7-Digits.</td><td valign="top">Confirm the Service ID entered is 7-Digits.</td></tr><tr><td valign="top">Service ID Not Found</td><td valign="top">Service ID Not found in CRM Database.</td><td valign="top">Confirm the Service ID is a valid Service ID.</td></tr><tr><td valign="top">Site Created Successfully</td><td valign="top">Site Created Successfully.</td><td valign="top">Upload completed without any errors.</td></tr><tr><td valign="top">Invalid Attribute. Site Created Successfully</td><td valign="top">Site created successfully and an invalid attribute was found.</td><td valign="top">The site was added to the Sites list, but an attribute was invalid. Make corrections to the site on the <strong>Administration > Sites page.</strong></td></tr><tr><td valign="top">Invalid Subgroup Combination Found. Invalid Attribute. Site Created Successfully</td><td valign="top">Site created successfully but has an invalid subgroup name and attribute combination.</td><td valign="top">An invalid attribute and subgroups (hierarchy assignment) were found in the uploaded document. Make corrections to the site on the <strong>Administration > Sites page.</strong></td></tr></tbody></table>

<table><thead><tr><th valign="top">Error</th><th valign="top">Description</th><th valign="top">Resolution</th></tr></thead><tbody><tr><td valign="top">Invalid subgroup combination found. Site Created Successfully</td><td valign="top">Site was created successfully but subgroup combination is incorrect.</td><td valign="top">The subgroups (hierarchy assignment) was invalid in the uploaded document. Make corrections to the site on the <strong>Administration > Sites page.</strong></td></tr><tr><td valign="top">Site Name Already Exists</td><td valign="top">The site name already exists in sites table.</td><td valign="top">Either change the existing site record’s name or change the site name in the upload document. The site will need to be added again after changes are made.</td></tr><tr><td valign="top">Duplicate Service ID and Site Name</td><td valign="top">A duplicate Service ID and Site Name combination found in the upload document.</td><td valign="top">Remove the duplicate records and upload the site again.</td></tr><tr><td valign="top">Duplicate Service ID</td><td valign="top">A duplicate Service ID was found in the upload document.</td><td valign="top">Remove the duplicate service ID and upload the site again.</td></tr><tr><td valign="top">Duplicate Site Name</td><td valign="top">A duplicate site name combination was found in the upload document.</td><td valign="top">Remove the duplicate site name and upload the site again.</td></tr><tr><td valign="top">Site: Entity Service Error</td><td valign="top">Site entity service failure.</td><td valign="top">Attempt the upload again.</td></tr><tr><td valign="top">Address: Entity Service Error</td><td valign="top">Address entity service failure.</td><td valign="top">Attempt the upload again.</td></tr><tr><td valign="top">Mandatory Fields Required</td><td valign="top">If any mandatory fields are missing (Service ID, Site Name, Address Line 1, Country, State, City, or ZIP code).</td><td valign="top">Confirm that the information is present in the mandatory fields and upload the site again.</td></tr><tr><td valign="top">Invalid Service ID Range</td><td valign="top">If the Service ID Length is less than 7-Digits.</td><td valign="top">Confirm the Service ID entered is 7-Digits.</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.verifone.com/petroleum-docs/petro-and-c-store/commander-central/commander-central-user-guide/sites/bulk-site-creation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
