Operation management

From NETIM
Jump to: navigation, search

Contents

New operations

When an operation is requested, you get a unique tracking number. The latter can then be used to track the progress and status of an operation.

Operations can be requested in several ways:


Using the API

Each call to the API function returns an array containing the operation information

For experienced users seeking to automate tasks


Using API forms into the Web Interface

Each function has a form in the section "Resellers" > "API domain", "API hosting" et "API SSL"

These forms are used to enter the parameters needed by each function. After submitting the form, the API is called and returns an array containing the operation information.

For experienced users seeking to use complex or not automated tasks 


Using the Web Interface

In general, the use of the Web Interface to manage services systematically generates an operation

For all users


Using our website

For registrations or transfers, using the website to pass orders offers the advantage of providing a simplified wizard especially in complex steps relative to additional fields.

For all users

Operation follow-up

Operation results are as follows:

PENDING The operation is being processed
DONE The operation has been successfully performed and is finished
FAILED The operation has failed and is finished
CANCELLED The operation has been cancelled either by Netim, either by the reseller


Using the API

In order to retrieve the status of any operation, the function queryOpe must be called with the corresponding tracking number as parameter.

In practice, Resellers develop a script that will query the API at regular intervals on the uncommitted transactions in their system For each operation, they obtain the result, update their data and continues their internal processes.


Using notifications

The result is described in the CPS of #notifications.

In practice, Resellers develop a script that will read at regular intervals the email address that receives all notifications. For each email received, they obtain the result, update their data and continues their internal processes.


Using the Web Interface

Resellers can track all operations in the Web Interface, section "Resellers" > "List of operations"


Restart an operation

There is no function for restarting an operation by yourself.

So when an operation has failed, you must request it again (with the needed changes into the parameters) and you will get a new tracking ID.


Sometimes, an operation failed on our side and you got one of the following error codes:

E12-M1201 Operation can't be performed - An internal error occurred
E12-M1210 Operation can't be performed - An error occured during the request at the registry

If this situation occurs, as we monitor all requested operations, we will intervene onto the problem that causes the error and restart the operation.


Cancel an operation

It is possible to cancel a transaction with the CancelOpe function provided that it has not yet been initiated with the registry


Inquiring opened operations

We provide a list of possible operations onto domain names and contact objects. However, according to the extension of the domain name, some of them can be impossible. For example, if the autorization code doesn't exist for belgium, the function domainAuthID onto a .BE domain name will be closed.

With the queryOpeList function , the reseller can query the system onto an extension and an operation to see if the latter is opened. For example, opened operations for each extension is displayed in the section Category:Tld


Notifications

Structure

Each notification is sent by email and contains a CPS section (Computer Parsed Section) in order to facilitate the parsing of the body and retreive easily the needed information. Below an example of a CPS section:

with status DONE

----BEGIN-OF-CPS----
TYPE: domainCreate
REQUEST: 318110
OBJECT: xxxxxxxxxxxx.com
ACTION: DONE
----END-OF-CPS----

with status FAILED

----BEGIN-OF-CPS----
TYPE: domainCreate
REQUEST: 318110
OBJECT: xxxxxxxxxxxx.com
ACTION: FAILED
ERRNO: EXX-XXXXX 
ERRSTR:  ?????????????
----END-OF-CPS----


The fields for CPS are defined as follows:

TYPE The operation
REQUEST The tracking number
OBJECT The object for which the operation applies
ACTION The result
ERRNO The error number optional
ERRSTR The error message optional
VALUE The value corresponding to the operation optional


Settings

The resellet can enable/disable these notifications or define the recipient email address. See Reseller settings

Expiration reminder notifications

The notifications below are not related to an operation but to the life cycle of a domain name.

The reseller can enable / disable the receipt of these notifications. Reseller settings


Domain name expiration

Dear customer,

Your domain name xxxxxxx.com is due to expire today !
 
Creation date : 2008-12-01
Expiry date : 2009-12-01
Deadline for renewal : 2009-12-08 before 09:00 PM (UTC+1)

Your domain is now in state of "Pre-closing" status during which we maintain,
free of charge, your domain in order to allow you enough time to renew it.
However, after this period, your domain shall be deleted.
 
In order to keep your domain, you will have to renew it before 2009-12-08 09:00 PM (UTC+1).

For any further information, feel free to contact our support.
 
Netim

----BEGIN-OF-CPS----
TYPE: DOMAIN_NOTIFY
OBJECT: xxxxxxx.com
ACTION: EXPIRED
VALUE: 2009-12-08
----END-OF-CPS----

Domain name deletion followed by a quarantine

Dear customer,

Please note that this is our last letter about your domain name xxxxxxx.ch,
which has still not been renewed and will be removed.

Creation date : 2008-12-01
Expiry date : 2009-12-01
Deadline for renewal : 2009-12-08 before 09:00 PM (UTC+1)

Netim has now requested the deletion of domain for non-renewal and will be removed soon.

Restoration procedure:
The domain will be in a redemption status until 2009-12-22 and before becoming
available again for registration. During this stage, you are the only one able
to restore the domain and keep the ownership.

For any further information, feel free to contact our support.

Netim 

----BEGIN-OF-CPS----
TYPE: DOMAIN_NOTIFY
OBJECT: xxxxxxx.ch
ACTION: DELETION_WITH_REDEMPTION
VALUE: 2009-12-22
----END-OF-CPS----

Domain name deletion without quarantine

Dear customer,

Please note that this is our last letter about your domain name xxxxxxx.cz,
which has not yet been renewed and will be removed.
 
Creation date : 2008-12-01
Expiry date : 2009-12-01
Deadline for renewal : 2009-12-01 before 09:00 PM (UTC+1)

Netim has now requested the domain deletion for non-renewal and will be removed soon.
 
For any further information, feel free to contact our support.
 
Netim

----BEGIN-OF-CPS----
TYPE: DOMAIN_NOTIFY
OBJECT: xxxxxxx.cz
ACTION: DELETION
----END-OF-CPS----
Personal tools
Namespaces

Variants
Actions
Your account
Domain names
Contact Us
Web Hosting
Email Hosting
Website Builder
Resellers
Affiliates
Miscellaneous