Issue with Job status received from API

We are getting two different states in the XQN->Details objects
associated to the same JobState. Let me show you an example:

For ELJobIDMRN = 42708856  we get state = “Error” in
JobDetailResultJob.Group[0].XQN[0].Detail

For ELJobIDMRN = 43718039 we get state = “Sent” in JobDetailResultJob.Group[0].XQN[0].Detail

However, we received JobDetailResultJob.JobState returning
“Complete” and “Posted” for both. None of them have more than one object in the XQN
array.

Can we use the JobState object to know if the fax was sent or if there are submittion were errors?

What is the best and more effective way to retrieve the status of a job? 

Thank you. 

Comments

  • All of the Requests return the saame info, but not the same amount. JobDeliverStatusRequest returns the most info. You may be able to use JobSummaryRequest if that gives you what you need. You may get more than one JobState. In your example the Posted means it was delivered. The Complete means the Job has completed and there is no other action happening.

  • Thank you for your reply. We understand what you are explaining, but why are we getting Posted for those that got errors? If Posted means delivered, and the job had errors, then the status Posted should not be received. Complete makes more sense becuase there is nothing else to do with the job, but why Posted as well? 

  • You may get an error, such as a Busy or No Answer. Then the job will get retried and delivers, Posted. Error does not show anymore.

    So depending on the error you would do another JDSR based on your Retry algo.

  • Sorry but this last reply doesn't address our
    concerns. The problem we are having is that we are getting Posted and Completed
    from
    JobDetailResultJob.JobState,
    and only “Error” from JobDetailResultJob.Group[0].XQN[0].Detail. I don’t
    think this is correct. XQN only was one row. In my opinion if the job is posted
    then JobDetailResultJob.Group[0].XQN[0].Detail should not have “Error”
    or perhaps have Error and Sent, but that is not the case. Please advise. 

  • Please attach your Result XML. I need more information.

  • Please find the XML below

     

    <?xml version="1.0"
    encoding="UTF-16"?>

    <JobDetailResult xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

    <Status xmlns="http://ws.easylink.com/JobDetail/2011/01">

    <StatusCode>0</StatusCode>   

    <StatusMessage>OK</StatusMessage>

    <SubmissionTime>2017-10-05T15:20:37.409Z</SubmissionTime>

    <CompletionTime>2017-10-05T15:20:37.515Z</CompletionTime>

    </Status>

    <JobId xmlns="http://ws.easylink.com/JobDetail/2011/01">

    <XDN>xsi</XDN>            

    <MRN>45258827</MRN>

    </JobId>

    <ArrivalColumns xmlns="http://ws.easylink.com/JobDetail/2011/01">xqn,arrival_time,class,subject,detail</ArrivalColumns>

    <RemovalColumns xmlns="http://ws.easylink.com/JobDetail/2011/01">xqn,removal_time,reason</RemovalColumns>

    <PullColumns xmlns="http://ws.easylink.com/JobDetail/2011/01">xqn,pull_number,pull_time</PullColumns>

    <Job xmlns="http://ws.easylink.com/JobDetail/2011/01"
    MRN="45258827" XDN="xsi">

    <JobState>Complete</JobState>

    <JobState>Posted</JobState>

    <JobAttributes>att,entry_time,posted_time
    LogID-bd2c95d7-66ed-4d86-a444-fecffe0fab83-Att-Randall Clinton-Mbr-DONNA
    PIERCE,2017-10-04T20:54:43.000Z,2017-10-04T20:55:01.000Z</JobAttributes>

    <Group
    num="2" type="Normal">

    <DetailColumns>delivery_time,doc_page_count,retries,state,to</DetailColumns>

    <XQN>

    <Detail>2017-10-04T20:54:54.000Z,46,1,Error,7145752751</Detail>

    </XQN>

    </Group>

    </Job>

     

     

    </JobDetailResult>

  • You are using JobDetailRequest and not asking for all of the information. A JobDeliveryStatusRequest will give you a gamma_code with the error message. I still don't have enough information, I cannot tell what kind of job it is.

    However, it is possible to have Complete, Posted and then an error. An example would be a voice job, where it went to an answering machine and the answering machine disconnected before the entire message playe. In that case, it would show as Posted because it was delivered. You wuld then get the Error because of the partial play of the message. More informational than an actual error. You have to look up the gamma_code to see what it is for.

  • This job was a fax. If I send the Job ID, can you look in your system and figure out what happen? 

  • First, to clarify. Posted means that all attempts have been made to deliver the job. You can have Posted, but not be Complete. Complete means the entire job is finished with all aspects.

    The job was looked at. A JDSR shows the Error gamma_code as 1902, which is Phone number unallocated, disconnected or not in service.

    There is also a problem in the JobSubmit. There is no DocData. The document is specified but the data is not provided. This would have caused an Error if it had got that far in processing.

  • Cancel on the JobSubmit comment for DocData. IE was being helpful and stripping it out when it was opened.

  • We got confused with a previous answer where it was indicated that Posted meant delivered. Now in this last response you are saying posted means all attemps to deliver have been made. 

    Can you please clarify what it means to receive Post and Completed for jobs that actually error out. Your support team confirmed that all the jobs below failed. When we pull status from the API we get Posted and Completed to all of them. 

    Thank you for the level attention you have given this post. Your help has been very valuable. 

    ELJobIDMRN

    45258827

    45101300

    44726539

    43639532

    43510097

    42682206

    42708856

    21571700

  • Posted does not mean Delivered as previously stated above.

    Posted means all attempts to Deliver have been made. That can be one if delivery is made, or up to the number of retries that are setup for the job, if not delivered. If not delivered there will be an error message with a gamma_code for the error.

    When all facets in the job have been processed, the job is set to Completed.

    If not Delivered you will see Complete, Posted and the Error.

    If you do not understand the Error and gamma_code, you should contact Customer Support for ckarification. At this point it is not an API issue.

  • Thank you for the clarification. This has been very helpful. One more question, we are not seeing the status Delivered being reported by the API for any of the successful jobs, and according to your explanation we should get Posted and Completed. Is there an instance where should get Delivered as a status? 

  • where can we fine the meaining of each gamma code?

    For now can you tell me what gamma codes 3935 and 3201 mean? 

    Thank you. 

  • Do a Search in the top right for gamma.