Configuring the module "NeoSeo New Mail"

1. Installing NeoSeo New Mail

It is necessary to upload files from the Upload archive directory to the root of the site via FTP.

After that, go to the administrative panel of the site and select “Add-ons” -> “Delivery”

Next you need to select the module NeoSeo New Mail and click “Install”

Then you need to enter the module settings.

And make the initial settings:

Parameters tab

• Status - Module Status: Enabled / Disabled.
• API key - key for accessing the new mail API. You can get in your personal account of “New mail” https://my.novaposhta.ua/settings/index#apikeys in the section “Settings” - “API 2.0”. On the page there will be a section “List of keys”. If there are no keys, then you need to click the “Create a key” button. The received key must be entered in this field.
• Url API - Address for accessing the New Mail API. Change it only if you are sure that it has changed.
• Order Status - Select order statuses for which an electronic invoice will be automatically created.
• Use cash on delivery - Indicates whether the use of cash on delivery is allowed. If you select this payment method, a return invoice will be created with the “Money” type of cargo.
• Order status when choosing a payment method "Cash on Delivery" - allows you to select the status that will be assigned to the order when you select the payment method "Cash on Delivery"

Units tab

Here you must specify the default settings and compare the units in the store. Otherwise, the cost will not be calculated correctly.

• The minimum parcel weight in kilograms - if the weight of goods in the basket is less than the specified or not specified, then this value will be used.
• The minimum width of the parcel in meters - if the width of the goods in the basket is less than the specified or not specified, then this value will be used.
• Minimum package height in meters - if the height of goods in the basket is less than the specified one or is not specified, then this value will be used.
• The minimum length of the package in meters - if the length of the goods in the basket is less than the specified or not specified, then this value will be used.
• Select grams in “Weight Units”: - it is necessary to compare the unit for measuring the “Gram” value. Used when calculating the weight of the parcel
• Select centimeters in “Units of measurement”: - - it is necessary to compare the unit for measuring the “Centimeter” value. Used when calculating the size of the package

The “Courier Delivery” tab allows you to customize the delivery method “New courier delivery”

• Courier delivery - status for type of shipment on / off
• Type of shipment - You must select the type of parcel in the directories “New mail”
• Payment type - You must specify the type of payment for directories New mail.
• Display Name - A textual name for display on the storefront in delivery methods.

The tab “Delivery to the office” allows you to configure the delivery method “Delivery to the office of New Mail”.

• Delivery to the department - the status for the type of shipment is enabled / disabled
• Type of shipment - You must select the type of parcel in the directories “New mail”
• Payment type - You must specify the type of payment for the directories of “New mail”.
• Display Name - A textual name to display on the storefront in delivery methods.

The “Directories” tab allows you to update the directories of cities, departments and regions, on the basis of “New Mail”, as well as other directories necessary for the module to work.

• Cities - a directory of cities, displays the number of cities where there is a branch of New Mail.
• Offices - Directory of New Mail Offices
• Areas - Directory of areas on the basis of New Mail
• General reference books - other reference books of new mail.

The “Update directories” button will start the procedure for updating them. This procedure can take up to 20 seconds. You must wait for a response from the server. It is recommended to update once a week.

The “Shipping” tab allows you to set the initial data for sending the package.

• Full name of the sender - you must select the sender. The sender's data is obtained from the personal account of the New Mail using the API key. If this field is empty and does not allow you to select a sender, you may not have completed the registration on the New Mail website.
• Phone number of the contact person - you must specify the phone number of the contact person, which will be specified in the invoice, in the format 380хххххххх
• City of the sender - you must select the city of the sender from the base of cities of New mail.
• Sender's warehouse - you need to select the department or warehouse from where the parcels will be sent, if you want to send parcels from the door, you must select your address obtained from the personal account of the New Mail. If your address is not in the list - maybe you have not created it in your personal account in the section “Counterparties” - “Senders”
• Package Type - You must select the type of shipment from the New Mail directories.
• Who pays for shipping - Specify who will pay for shipping.
• Day of shipment - Select the date of shipment, the day of order formation, or + some interval, for example, tomorrow (+1) or the day after (+2).
• Parcel description - parcel description. You can use the template {order} - will be replaced by the order number in the store.

The “Tariffs” tab allows you to set an additional markup when using the delivery method, or depending on the weight of the goods in the basket, use the shipping cost.

• Additional commission - allows you to specify additional. commission when placing an order
• Use your parcel cost - the parameter enables / disables the calculation of the parcel cost according to the table below. The table indicates the weight and cost of the method of delivery to the office or courier delivery.

After that, you need to save the module settings.

If cash on delivery is used, you must also install the module in the “Payments” section.

Then you need to go to the module settings

Select the status “Enabled” and save the settings.

Module operation:

At the display window:

In the process of placing an order, if the buyer has specified a city in which there are branches of the New Mail, the delivery method will be displayed.

If in the specified city there are no branches of New Mail, the delivery method will not be displayed.

If it is allowed to use cash on delivery in the settings, then the payment method “Cash on delivery by New Mail” will be displayed in the payment methods

In admin:

If the delivery method “NeoSeo New Mail” is selected in the order, then the order card will contain information about this:

After checking all the data, you can create an invoice by clicking on the “Create invoice” button or by setting the status of the order specified in the module settings for automatic creation of the invoice. Frequent causes of invoice creation errors are incorrect recipient data (full name or phone number).

After creating the invoice, information about the created document will be displayed. If the invoice has not been created, you can find out the reason in the module log.

After the invoice is created, its number will be displayed, it will also be possible to print the invoice itself, or print the label on the box with the bar code for New Mail.

Also by clicking on the arrow button (shown in the screenshot above) you can check the status of the invoice. An API request will be sent to New Mail and the current status will be returned.

In the “Orders” section of your online store, next to orders for which invoices have been created, information about the status of shipments will appear:

You can also update the statuses of all shipments by clicking on the “Update TTH status” button at the top of the page.

In the office of New mail

After creating the invoice on the site side, the invoice will be displayed in the New Mail office. Please note that sometimes it takes several minutes to create an invoice on the side of the New Mail, i.e. TTH number will be displayed, and the status will be “Not found” and printing of the label and invoice will not be available. In a few minutes it will be created and you can print and check everything.

If the method of payment “Cash on delivery” is indicated, then an additional service is created to return money to the sender.

Notes.

• It is necessary to update the reference books after specifying the API-key and saving the settings, since for updating directories you need an API key.
• When choosing any delivery method, it is necessary that the real phone number and the real data of the buyer be specified. When creating invoices, the new mail itself checks this data, and if they are entered incorrectly, the invoice will not be created.
• When you create an invoice for courier delivery, you must specify the middle name, delivery address and real phone number, without this, New Mail will not create an invoice
• The New mail module has not been tested at the moment in conjunction with the Simple 4.11.2 module