Gets status and details about an import process.
GetProcessDetails(int idList, string listGUID, int idProcess)
ReturnCode=0 for successful requests, otherwise a negative value is returned.
Returned results contains the following information:
The "mobile" fields refer to text messaging (SMS) and are not part of integrations with third party systems. |
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://ws.mailupnet.it/"> <soapenv:Header> <ws:Authentication> <ws:User>a1234</ws:User> <ws:Password>mypassword</ws:Password> <ws:encType>UTF-8</ws:encType> </ws:Authentication> </soapenv:Header> <soapenv:Body> <ws:GetProcessDetails> <ws:idList>1</ws:idList> <ws:listGUID>00000000-aaaa-bbbb-cccc-000123456789</ws:listGUID> <ws:idProcess>275</ws:idProcess> </ws:GetProcessDetails> </soapenv:Body> </soapenv:Envelope> |
<mailupMessage> <mailupBody> <ReturnCode>0</ReturnCode> <ImportProcess idProcess="275"> <StartDate>30/10/2012 15.39.12</StartDate> <EndDate>30/10/2012 15.39.24</EndDate> <TotalContacts>0</TotalContacts> <NewMobile>0</NewMobile> <NewEmail>0</NewEmail> <OptOutMobile>0</OptOutMobile> <OptOutEmail>0</OptOutEmail> <ExistingMobile>0</ExistingMobile> <ExistingEmail>0</ExistingEmail> <StatusCode>3</StatusCode> <IsRunning>False</IsRunning> <ConfirmationEmail>False</ConfirmationEmail> <!-- ConfirmationSent is empty if Confirmation request was not set during import --> <ConfirmationSent></ConfirmationSent> </ImportProcess> </mailupBody> </mailupMessage> |
<mailupMessage> <mailupBody> <ReturnCode>0</ReturnCode> <ImportProcess idProcess="4"> <StartDate>14/06/2013 10.36.19</StartDate> <EndDate>14/06/2013 10.36.25</EndDate> <TotalContacts>0</TotalContacts> <NewMobile>1</NewMobile> <NewEmail>1</NewEmail> <OptOutMobile>0</OptOutMobile> <OptOutEmail>0</OptOutEmail> <ExistingMobile>0</ExistingMobile> <ExistingEmail>0</ExistingEmail> <StatusCode>3</StatusCode> <IsRunning>False</IsRunning> <ConfirmationEmail>True</ConfirmationEmail> <!-- When Confirmation request (double optin) is required the process details will contain ConfirmationEmail=true and ConfirmationSent will have a value (True or False) --> <!-- Please note that when you set confirm=1 (true) during import process the confirmation email is not automatically sent, it is simply enqueued. Then you will have to manually send enqueued message by selecting Email > SendStatus > Send Now on your MailUp console --> <!-- Value of ConfirmationSent field is False until MailUp user proceeds with manually sending the enqueued confirmation requests --> <ConfirmationSent>False</ConfirmationSent> </ImportProcess> </mailupBody> </mailupMessage> |
<mailupMessage> <mailupBody> <ReturnCode>0</ReturnCode> <ImportProcess idProcess="4"> <StartDate>14/06/2013 10.36.19</StartDate> <EndDate>14/06/2013 10.36.25</EndDate> <TotalContacts>0</TotalContacts> <NewMobile>1</NewMobile> <NewEmail>1</NewEmail> <OptOutMobile>0</OptOutMobile> <OptOutEmail>0</OptOutEmail> <ExistingMobile>0</ExistingMobile> <ExistingEmail>0</ExistingEmail> <StatusCode>3</StatusCode> <IsRunning>False</IsRunning> <ConfirmationEmail>True</ConfirmationEmail> <!-- User has manually sent enqueued confirmation messages --> <ConfirmationSent>True</ConfirmationSent> </ImportProcess> </mailupBody> </mailupMessage> |
Error code | Description |
---|---|
-500 | unrecognized error |
-501 | idProcess not found |
# Refer to https://mailup.atlassian.net/wiki/display/mailupapi/MailUp+RubyGem for gem information. require 'mailup' m = MailUp::Import.new('username', 'password', 'console_url') m.get_process_details(:idList => 123456, :listGuid => 123456, :idProcess => 123) # => <?xml version=\"1.0\" encoding=\"windows-1252\" ?><mailupMessage><mailupBody><ReturnCode>0</ReturnCode><ImportProcess idProcess="17">...</ImportProcess></mailupBody></mailupMessage> |