XML Integration Example: XML Messages for WOs

This article describes XML messages sent in and out during a typical work order (WO) processing.

This basic scenario covers the following intercommunication:

1 1. [SC → Prov] New WO Created
2 2. [Prov → SC] WO Dispatch Confirmed
3 3. [SC → Prov] Check-In via IVR or GPS App
4 4. [SC → Prov] Check-Out via IVR or GPS App
5 5. [Prov → SC] New Note Сreated
6 6. [SC → Prov] Priority, NTE, and Scheduled Date Updated
7 7. [Prov → SC] Check-In via XML
8 8. [Prov → SC] Check-Out via XML
9 9. [SC → Prov] WO Completion Confirmation

1. [SC → Prov] New WO Created

A new work order created by a subscriber is sent to a provider as the following XML message:

<?xml version="1.0" encoding="UTF-8"?>
<DATA2SC PIN="1069693" ID="67099954">
   <CALL TYPE="WONEW" DATETIME="2016/01/21 07:48:00" OPERATOR="SoWerxXML1" CALLER="test-xml" CATEGORY="CAPITAL - OTHER" SUB="2014917018" LOC="SoWerx-XML" TRADE="BUILDING EXTERIOR" PRO="2000074085" PRO_NAME="SoWerx Contractor Services" TR_NUM="67099954" WO_NUM="67099954" PO_NUM="67099954" STATUS="OPEN" PRIORITY="Sev 3" NTE="500" SCHED_DATETIME="2016/01/28 07:48:00">
      <PROBLEM>sample work order</PROBLEM>
   </CALL>
</DATA2SC>

2. [Prov → SC] WO Dispatch Confirmed

The provider has confirmed the WO dispatch.

<?xml version="1.0" encoding="UTF-8"?>
<DATA2SC PIN="1069693" ID="67099955">
   <CALL TR_NUM="67099954" STATUS="DISPATCH_CONFIRMED" />
</DATA2SC>

The screenshot below shows the updated WO status in the subscriber user interface (UI) of ServiceChannel.

3. [SC → Prov] Check-In via IVR or GPS App

A technician has visited the location and reported a check-in via IVR. In this case, an outgoing XML notification is sent to the provider.

<?xml version="1.0" encoding="UTF-8"?>
<DATA2SC PIN="1069693" ID="63122971">
   <CALL TYPE="WOUPDATE" DATETIME="2016/01/21 07:48:00" OPERATOR="SoWerxXML1" CALLER="test-xml" CATEGORY="CAPITAL - OTHER" SUB="2014917018" LOC="SoWerx-XML" TRADE="BUILDING EXTERIOR" PRO="2000074085" PRO_NAME="SoWerx Contractor Services" TR_NUM="67099954" WO_NUM="67099954" PO_NUM="67099954" STATUS="ON_SITE" PRIORITY="Sev 3" NTE="500" SCHED_DATETIME="2016/01/28 07:48:00" COMPL_DATETIME="2016/01/21 08:24:18">
      <PROBLEM>sample work order</PROBLEM>
      <CHECK TYPE="IN" PIN="1069693" DATETIME="2016/01/21 08:24:18" TECHS_COUNT="1" CALLERID="266696687" />
   </CALL>
</DATA2SC>

The screenshot below shows the WO details indicated in the UI of ServiceChannel.

4. [SC → Prov] Check-Out via IVR or GPS App

The technician has reported a check-out. The work is not yet completed as some parts should be ordered.

<?xml version="1.0" encoding="UTF-8"?>
<DATA2SC PIN="1069693" ID="63122971">
   <CALL TYPE="WOUPDATE" DATETIME="2016/01/21 07:48:00" OPERATOR="SoWerxXML1" CALLER="test-xml" CATEGORY="CAPITAL - OTHER" SUB="2014917018" LOC="SoWerx-XML" TRADE="BUILDING EXTERIOR" PRO="2000074085" PRO_NAME="SoWerx Contractor Services" TR_NUM="67099954" WO_NUM="67099954" PO_NUM="67099954" STATUS="PARTS_ON_ORDER" PRIORITY="Sev 3" NTE="500" SCHED_DATETIME="2016/01/28 07:48:00" COMPL_DATETIME="2016/01/21 09:24:18">
      <PROBLEM>sample work order</PROBLEM>
      <CHECK TYPE="OUT" PIN="1069693" DATETIME="2016/01/21 09:24:18" TECHS_COUNT="1" CALLERID="266696687" />
   </CALL>
</DATA2SC>

The screenshot below shows the updated WO status in the subscriber user interface (UI) of ServiceChannel.

5. [Prov → SC] New Note Сreated

The provider has sent a note to the subscriber asking to increase the NTE value.

<?xml version="1.0" encoding="UTF-8"?>
<DATA2SC PIN="1069693" ID="67133896">
   <CALL TR_NUM="67099954">
      <ATTR NAME="NOTE">Please increase NTE on this call to $760 - additional parts should be ordered</ATTR>
   </CALL>
</DATA2SC>

6. [SC → Prov] Priority, NTE, and Scheduled Date Updated

The subscriber has changed multiple WO fields, including the NTE value as requested by the provider.

<?xml version="1.0" encoding="UTF-8"?>
<DATA2SC PIN="1069693" ID="254284764">
   <CALL TYPE="WOUPDATE" DATETIME="2016/01/21 07:48:00" OPERATOR="test-xml" CALLER="test-xml" CATEGORY="CAPITAL - OTHER" SUB="2014917018" LOC="SoWerx-XML" TRADE="BUILDING EXTERIOR" PRO="2000074085" TR_NUM="67099954" WO_NUM="67099954" PO_NUM="67099954" STATUS="INCOMPLETE" PRIORITY="Sev 2" NTE="760" SCHED_DATETIME="2016/01/30 08:00:00">
      <PROBLEM>Test WO description updated</PROBLEM>
      <ATTR NAME="NOTE" LINE="5" DATETIME="2016/01/21 12:21:00" CREATED_BY="SoWerxXML1" NEW_SCHED_DATETIME="2016/01/30 08:00:00" SENT_TO="">WO Edited: status changed from IN PROGRESS/PARTS ON ORDER to IN PROGRESS/INCOMPLETE.
WO Edited: Scheduled Date changed from Jan 29, 2016 08:00 to Jan 30, 2016 08:00.
WO Edited: NTE changed from 500 to (USD)760.
WO Edited: Priority changed from Sev 3 to Sev 2.</ATTR>
   </CALL>
</DATA2SC>

7. [Prov → SC] Check-In via XML

A technician has visited the location again, reporting a check-in via the following incoming XML message:

<?xml version="1.0" encoding="UTF-8"?>
<DATA2SC PIN="1069693" ID="146889">
   <CALL TR_NUM="67099954" STATUS="ON_SITE">
      <CHECK TYPE="IN" ID="2" DATETIME="2016/01/21 07:58:00" />
   </CALL>
</DATA2SC>

8. [Prov → SC] Check-Out via XML

The technician has reported a check-out via XML. This time the work is completed. The COMPL_DATETIME value should be specified in this case.

<?xml version="1.0" encoding="UTF-8"?>
<DATA2SC PIN="1069693" ID="146889">
   <CALL TR_NUM="67099954" STATUS="COMPLETED_PENDING" COMPL_DATETIME="2016/01/22 06:35:00">
      <CHECK TYPE="OUT" ID="2" DATETIME="2016/01/22 06:35:00" />
   </CALL>
</DATA2SC>

9. [SC → Prov] WO Completion Confirmation

The subscriber has confirmed that the work order is completed. Now this WO is in a billable status. An auto-generated note about the status change is sent to the provider.

<?xml version="1.0" encoding="UTF-8"?>
<DATA2SC PIN="1069693" ID="254243219">
   <CALL TYPE="WOUPDATE" DATETIME="2016/01/21 07:48:00" OPERATOR="test-xml" CALLER="test-xml" CATEGORY="CAPITAL - OTHER" SUB="2014917018" LOC="SoWerx-XML" TRADE="BUILDING EXTERIOR" PRO="2000074085" TR_NUM="67099954" WO_NUM="67099954" PO_NUM="67099954" STATUS="COMPLETED_CONFIRMED" PRIORITY="Sev 2" NTE="760" SCHED_DATETIME="2016/01/28 07:48:00" COMPL_DATETIME="2016/01/22 06:35:00">
      <PROBLEM>sample work order</PROBLEM>
      <ATTR NAME="NOTE" LINE="3" DATETIME="2016/01/22 07:02:00" CREATED_BY="SoWerxXML1" NEW_SCHED_DATETIME="2016/01/28 07:48:00" SENT_TO="">WO Edited: status changed from COMPLETED/PENDING CONFIRMATION to COMPLETED/CONFIRMED.</ATTR>
   </CALL>
</DATA2SC>

The screenshot below shows the updated WO status in the subscriber user interface (UI) of ServiceChannel.