# The Company Email: Setup and Usage

In XoroERP, any outgoing email from the system that is auto-generated, such as payment links (e.g., “Deposit link” or “Invoice Payment link”) or emails to other users, will be sent from the email ID defined in the Company Email setup. Configuring the company email ensures that all system-generated emails are sent from a consistent and official email address, providing a professional and unified communication front for the organization.

The Company Email will be used for sending the following emails from the system:

* “Auto email reminder for overdue Invoices”.
* “Auto email send confirmation on SO allocation”.
* “Auto email Ship confirmation on Pack & Ship”.
* “Auto send email confirmation on Bill Payment”.
* “Auto email send confirmation on Order Release”.
* “Auto email Packing Slip along with Invoice”.
* “Notification for Goods Received”.

### Setting up the company email

The process for **setting up the User Email**  involves selecting the service type to configure the email , (**Webmail (Microsoft), Exchange, or Email Services)** and then setting up the details of the selected type.

{% hint style="info" %}
To set up the Company Email, go to **Menu > Configuration > Company > Company Email Setup**
{% endhint %}

\
On the email configuration page, select the email service type to begin the process.

<figure><img src="/files/fe1ll67WG7qyhGkiqr4n" alt=""><figcaption></figcaption></figure>

#### Web Email Services Setup

To set up the “Web Mail” Email Services, follow the steps below:

* In the "Email Service Type" field, select the "Web Mail" option and enter the following details:
  * Outgoing Mail Server(SMTP): **smtp.office365.com- for Microsoft & smtp.gmail.com- for Gmail.**
  * Email Address: Enter your email address.
  * Port Number–>587
  * Enable SSL: Check this option.
  * Display Name: Enter the display name of the user.
  * User Name: Enter the user name of the respective user.
  * Email Password: Enter your email password.
* Click "Validate" to verify that the information you entered is correct.
* Once validated, click "Save".

<figure><img src="/files/wLJyj6MvWp70DJnl0zAe" alt=""><figcaption></figcaption></figure>

#### Exchange Services Setup

For the Email Service Type **Exchange**, select "Exchange" as the "Email Service Type" and **fill in the following details:**

* **Exchange Uri**: <https://outlook.office365.com/EWS/Exchange.asmx>
* Fill in the “**Domain**“, “**Username**“, and the “**Email Password**“.
* Click "Validate" to verify the information you entered is correct.
* Once validated, click Save.

<figure><img src="/files/ZgfYTaguUxuxcr0CSOY4" alt=""><figcaption></figcaption></figure>

#### Email Services Setup

To set up the “Gmail” Services, follow the steps below:

* Select Email Service Type: **Email services**.
* Then click on “**Connect**” in the Add Service.

  <figure><img src="/files/uUOyY41MgPGcGre8pDql" alt=""><figcaption></figcaption></figure>
* Sign in with **Google Account**.
* Then click on the “**Allow**“. (This will activate the email Services in the Xoro).

### Common Issues in Email Setup and Suggested Resolutions

1\. **Getting the error “Cannot complete the request. Cannot send a test mail**. The SMTP server required a secure connection, or the client was not authenticated. The server response was: 5.7.1 Authentication Required. Please try again.” while validating. This message typically appears if the email or password, or both are incorrect. Please re-check them all.

This message can also appear if you use Gmail and Google is blocking the sign-in attempts due to Security Standards. In that case, you will need to generate an App Password for your Gmail Account to validate the Email. Here’s how:

* Click on the Google icon.

  <div align="left"><figure><img src="/files/Ggf5CRs5Sd9hBSAqwwab" alt=""><figcaption></figcaption></figure></div>
* Then, click on “Manage your Google Account”.<br>

  <div align="left"><figure><img src="/files/v9RbM3x71SfwBwWynIVm" alt=""><figcaption></figcaption></figure></div>
* Click on the “Security” tab.

<figure><img src="/files/D68qxBKzwrO91NGlkoMY" alt=""><figcaption></figcaption></figure>

* Under the “Signing in to Google” section, ensure the 2-Step Verification is turned on. If it is not, then turn it on.

<figure><img src="/files/YXDedMc0u1iB5KpHu6gJ" alt=""><figcaption></figcaption></figure>

* After turning on the 2-Step Verification, go back to the “Security” tab and click on “2-Step Verification”.<br>

  <figure><img src="/files/aoGhdI8rheMnK77gKtis" alt=""><figcaption></figcaption></figure>
* Enter your Google Account Password for Validation, if prompted, and click on “**Next**”.<br>

  <figure><img src="/files/dP0OG0qaTWa6S0OGYeo9" alt=""><figcaption></figcaption></figure>
* In the “2-Step Verification” page, scroll down to the bottom and click on the “App Passwords” option.

<figure><img src="/files/e55jiZYn4m93Qj40cDFz" alt=""><figcaption></figcaption></figure>

* To generate an app-specific password, type the desired App Name (e.g., “Xorosoft”) and select **Create**.

<figure><img src="/files/syQi3g2m5tRBS46UIbtn" alt=""><figcaption></figcaption></figure>

* A 16-digit App Password will be generated for your device. This password grants complete access to your Google Account.

<figure><img src="/files/AdOkRfDj48UtO63WzVkd" alt=""><figcaption></figcaption></figure>

* Copy this Password and paste this into Xoro’s “Email Password” field on the Email Configuration Setup page.<br>

  <div align="left"><figure><img src="/files/sLnmvmoLuqhof03tnst5" alt=""><figcaption></figcaption></figure></div>
* Save the changes and Validate the Email.<br>

  <div align="left"><figure><img src="/files/D2ghZy7aR8tsKNQwgcyO" alt=""><figcaption></figcaption></figure></div>

*\*\*Please note that it is mandatory to enable 2-Step Verification to be able to use this feature.*

2\. **Getting the error “Cannot complete the request. Cannot send a test mail. Failure sending mail. Please try again” while validating.** This typically appears if the outgoing mail server, the port number, or both are incorrect. Please re-check them all.

3\. **Getting the error “Cannot complete the request. Cannot test mail. The SMTP server requires a secure connection, or the client was not authenticated.”** This typically appears if the SSL setting is incorrect. Please re-check this.

4\. If you are using the Exchange Service type, then the domain should be in the format of “company.com” (without quotes).


---

# 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.xorosoft.com/xoroerp-1/configuration/company/the-company-email-setup-and-usage.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.
