Job Card has been submitted

Posts about the simPRO API. Help/support/how-to etc.
Forum rules
  • Check the documentation first. Before posting questions, please check the documentation to ensure it doesn't already cover what you need.
  • No spam. All automated messages, advertisements, and links to competitor websites will be deleted immediately.
  • Post in relevant sub-forums only. Messages posted in the wrong topic area will be removed and placed in the correct sub-forum by moderators.
  • Respect other users. No flaming or abusing fellow forum members. Users who continue to post inflammatory, abusive comments will be deleted from the forum after two warnings are issued by moderators.
  • Harassment. No threats or harassment of other users will be tolerated. Any instance of threatening or harassing behavior is grounds for deletion from the forums.
  • Adult content. No profanity or pornography is allowed. Posts containing adult material will be deleted.
  • Bandwidth. All images and signatures must be 500 x 500 pixels or smaller. Posts containing over-sized images and signatures will be removed.
  • Illegal content. No re-posting of copyrighted materials or other illegal content is allowed. Any posts containing illegal content or copyrighted materials will be deleted.
zoes
Posts: 37
Joined: Sun Sep 13, 2020 2:05 am

Job Card has been submitted

Post by zoes » Wed Dec 02, 2020 11:56 pm

How to tell if a job card / work order has been completed for a schedule?
Muqeet
Posts: 772
Joined: Mon Dec 03, 2018 3:24 am

Re: Job Card has been submitted

Post by Muqeet » Thu Dec 03, 2020 1:39 am

There is no data within work order that would suggest a work order has been completed. However you can look at the mobile status logs, if technicians are using simPRO mobile application.

https://developer.simprogroup.com/apido ... f8d88e6143
Muqeet
API Developer | simPRO Software Group
zoes
Posts: 37
Joined: Sun Sep 13, 2020 2:05 am

Re: Job Card has been submitted

Post by zoes » Thu Dec 03, 2020 2:41 am

Is it correct that when a schedule is created for a job, a work order/job card is simultaneously created?

In timesheets I can see only the job cards that have been completed. So there must be some way to differentiate between those that have been completed and those not?
Muqeet
Posts: 772
Joined: Mon Dec 03, 2018 3:24 am

Re: Job Card has been submitted

Post by Muqeet » Thu Dec 03, 2020 4:26 am

Is it correct that when a schedule is created for a job, a work order/job card is simultaneously created?
No. You can test it on the web application, create a schedule for an employee, access the cost center work order endpoint.
In timesheets I can see only the job cards that have been completed. So there must be some way to differentiate between those that have been completed and those not?
Employee time sheets are just schedules, you can view schedule of an employee on any date (past, future) regardless of whether the work has been performed on the workorders based on those schedules.

api/v1.0/companies/0/employees/{employeeID}/timesheets/?StartDate=2021-12-04&EndDate=2021-12-05

Above endpoint should work as long as an employee is scheduled within given date range.
Muqeet
API Developer | simPRO Software Group
zoes
Posts: 37
Joined: Sun Sep 13, 2020 2:05 am

Re: Job Card has been submitted

Post by zoes » Tue Dec 08, 2020 1:22 am

I created a new schedule for which a job card was not created (by me). However:

Code: Select all

"/api/v1.0/companies/{companyID}/jobs/{jobID}/sections/{sectionID}/costCenters/{costCenterID}/schedules/"
and

Code: Select all

"/api/v1.0/companies/{companyID}/jobs/{jobID}/sections/{sectionID}/costCenters/{costCenterID}/workOrders/"
both returned:

Code: Select all

[{'ID': xxx, 'TotalHours': 1.5, 'Staff': {'ID': yyy, 'Name': 'zzz', 'Type': 'employee', 'TypeId': 78}, 'Date': '2020-12-08'}]
This is why I believed a work order/job card is simultaneously created when a schedule is created. What am I missing?
Last edited by zoes on Tue Dec 08, 2020 2:59 am, edited 1 time in total.
Muqeet
Posts: 772
Joined: Mon Dec 03, 2018 3:24 am

Re: Job Card has been submitted

Post by Muqeet » Tue Dec 08, 2020 2:02 am

You can go through the helpguide or contact support for more information about schedules and work orders.
Muqeet
API Developer | simPRO Software Group
zoes
Posts: 37
Joined: Sun Sep 13, 2020 2:05 am

Re: Job Card has been submitted

Post by zoes » Tue Dec 08, 2020 2:29 am

You can test it on the web application, create a schedule for an employee, access the cost center work order endpoint.
I did as you suggested and did not get the expected result. Can you explain that?
Muqeet
Posts: 772
Joined: Mon Dec 03, 2018 3:24 am

Re: Job Card has been submitted

Post by Muqeet » Tue Dec 08, 2020 2:32 am

I should have said rest api, instead of web application. Create a schedule from rest api and check work order endpoint.
Muqeet
API Developer | simPRO Software Group
zoes
Posts: 37
Joined: Sun Sep 13, 2020 2:05 am

Re: Job Card has been submitted

Post by zoes » Tue Dec 08, 2020 3:04 am

Cool, cool. Can I access the work orders of an employee without specifying job, cost center etc.?

Something like:

Code: Select all

"/api/v1.0/companies/{companyID}/workOrders/?Staff.ID=0&Date=2020-12-08"
Muqeet
Posts: 772
Joined: Mon Dec 03, 2018 3:24 am

Re: Job Card has been submitted

Post by Muqeet » Tue Dec 08, 2020 5:02 am

We do not have a top level endpoint for work orders. You will need to have a job, section and cost center IDs to access a work order.
Muqeet
API Developer | simPRO Software Group
Post Reply