TPMoveEx

Greg Kolinski edited this page Sep 22, 2017 · 1 revision

Back To Common API Calls


Move a single Trading Partner ID from a Network/Mailbox to a specified Network/Mailbox.

 public int TPMoveEx(string SessionID, 
                     int NetworkID, 
                     int MailboxID, 
                     int ECGridID, 
                     DateTime MoveDateTime)

Parameters:


Returns

ECGrid ID on the specified Network/Mailbox - Integer


Remarks

Moving a Trading Partner Qualifier/ID (QID) from one Network/Mailbox to another is a process also known as a Migration. There are numerous complexities in this process which may include written authorization by the owner of the QID to release the QID from the existing Network. In general, a PDF of such a request on company letterhead is sufficient.

Most Networks require at least 3 business days advanced notification for an ID to be moved. The system enforces this rule. If you need a move expedited, please contact ECGrid NetOps to override this limitation.

ECGrid can optionally manage this migration by sending out notices of the pending migration to all Networks, sending reminders and tracking confirmations.

A Network Admin/Network User can move QIDs between Mailboxes within the same Network. To move QIDs to another Network requires NetOps Authorization Level.

To move a QID on the Session Network/Mailbox use TPMove().


Code Example

C#

using System.Xml;
using System.Web.Services.Protocols;
using ECGridService = <ProjectName>.net.ecgridos;

try
{
    using (ECGridService.ECGridOSAPIv3 ECGrid = new ECGridService.ECGridOSAPIv3())
    {
        try
        {
            string SessionID = "00000000-0000-0000-0000-000000000000";
            int ECGridID = 56845;
            int NetworkID = 56845;
            int MailboxID = 5684456;
            DateTime MoveDateTime = new DateTime(2017, 10, 1);

            int TPECGridIDResults= ECGrid.TPMoveEx(SessionID, NetworkID, MailboxID, ECGridID, MoveDateTime);

        }
        catch (SoapException SoapEx)
        {
            // See SOAP Exceptions in the Appendix
            var ECG_Ex = CatchException(SoapEx);
            Console.WriteLine($"ECGridOS Soap Exception: {ECG_Ex.ErrorCode} , Item: {ECG_Ex.ErrorItem}, Message: {ECG_Ex.ErrorMessage}, String: {ECG_Ex.ErrorString}");
        }
    } // END USING
}
catch (Exception ex){ Console.WriteLine("Unhandled Exception: " + ex.ToString()); }

SOAP 1.1

The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /v3.2/prod/ecgridos.asmx HTTP/1.1
Host: ecgridos.net
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://ecgridos.net/TPMoveEx"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <TPMoveEx xmlns="http://ecgridos.net/">
      <SessionID>string</SessionID>
      <NetworkID>int</NetworkID>
      <MailboxID>int</MailboxID>
      <ECGridID>int</ECGridID>
      <MoveDateTime>dateTime</MoveDateTime>
    </TPMoveEx>
  </soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <TPMoveExResponse xmlns="http://ecgridos.net/">
      <TPMoveExResult>int</TPMoveExResult>
    </TPMoveExResponse>
  </soap:Body>
</soap:Envelope>

SOAP 1.2

The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /v3.2/prod/ecgridos.asmx HTTP/1.1
Host: ecgridos.net
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <TPMoveEx xmlns="http://ecgridos.net/">
      <SessionID>string</SessionID>
      <NetworkID>int</NetworkID>
      <MailboxID>int</MailboxID>
      <ECGridID>int</ECGridID>
      <MoveDateTime>dateTime</MoveDateTime>
    </TPMoveEx>
  </soap12:Body>
</soap12:Envelope>
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <TPMoveExResponse xmlns="http://ecgridos.net/">
      <TPMoveExResult>int</TPMoveExResult>
    </TPMoveExResponse>
  </soap12:Body>
</soap12:Envelope>

HTTP GET

The following is a sample HTTP GET request and response. The placeholders shown need to be replaced with actual values.

GET /v3.2/prod/ecgridos.asmx/TPMoveEx?SessionID=string&NetworkID=string&MailboxID=string&ECGridID=string&MoveDateTime=string HTTP/1.1
Host: ecgridos.net
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<int xmlns="http://ecgridos.net/">int</int>

HTTP POST

The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.

POST /v3.2/prod/ecgridos.asmx/TPMoveEx HTTP/1.1
Host: ecgridos.net
Content-Type: application/x-www-form-urlencoded
Content-Length: length

SessionID=string&NetworkID=string&MailboxID=string&ECGridID=string&MoveDateTime=string
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<int xmlns="http://ecgridos.net/">int</int>

Back To Common API Calls

Clone this wiki locally
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.