How Integration Works

TraceLink communicates with certain operating systems or programs of choice through SOAP (XML-based messaging protocol) integration. As indicated in the diagram below, the TraceLink applications that use the SOAP API are Serialized Operations Manager, Serial Number Exchange, and Product Track.

For example, if an internal system needs serial numbers, the SerialNumberRequest SOAP call is sent from that internal system to TraceLink's SOAP API endpoint, which is the main request-response communication hub. The endpoint simply extracts the XML from the SerialNumberRequest call and passes it to the TraceLink platform (the Serial Number Exchange app, in this example). Serial Number Exchange waits for the XML response containing the requested serial numbers, sends the serial number data back through the endpoint where the SOAP response generates, and sends the response back to the original system. This response also confirms whether the operation is successful or if it fails.

See below for an XML Serial Numbers Request and Response example:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:tracelink:soap">
   <soapenv:Header/>
   <soapenv:Body>
      <urn:serialNumbersRequest>
         <SendingSystem>LineSys11</SendingSystem>
         <ReceivingSystem>0060354701201</ReceivingSystem>
        <IdType>CN_SER</IdType>
         <EncodingType>CN_EDMC</EncodingType>
         <Size>10</Size>
         <ObjectKey>
            <Name>CN_SUBTYPE_LEVEL_RATIO</Name>
            <Value>1008721001|3|1:5:50></Value>
         </ObjectKey>
	 <ReferenceDocuments>
		<PONumber>10043</PONumber>
		<POLine>2</POLine>
		<WorkOrderNumber>10043-001<WorkOrderNumber>
		<ReferenceIdentifier>917902db-1307-4182-ad3d-29eca2d699ae</ReferenceIdentifier>
	 </ReferenceDocuments>	
      </urn:serialNumbersRequest>
   </soapenv:Body>
</soapenv:Envelope>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
	<S:Body>
		<ns2:serialNumbersRequestResponse xmlns:ns2="urn:tracelink:soap">
			<SNResponse>
				<ReceivingSystem>LineSys11</ReceivingSystem>
				<SendingSystem>0060354701201</SendingSystem>
				<ActionCode>C</ActionCode>
				<EncodingType>CN_EDMC</EncodingType>
				<IDType>CN_SER</IDType>
				<ObjectKey>
					<Name>CN_SUBTYPE_LEVEL_RATIO</Name>
					<Value>1008721001|3|1:5:50</Value>
				</ObjectKey>
				<ReferenceDocuments>
					<PONumber>10043<PONumber>
					<POLine>2</POLine>
					<WorkOrderNumber>10043-001<WorkOrderNumber>
					<ReferenceIdentifier>917902db-1307-4182-ad3d-29eca2d699ae</ReferenceIdentifier>
				</ReferenceDocuments>
				<RandomizedNumberList>
					<SerialNo>88102310003224703914</SerialNo>
					<SerialNo>88102310003224711129</SerialNo>
					<SerialNo>88102310003224729784</SerialNo>
					<SerialNo>88102310003224737489</SerialNo>
					<SerialNo>88102310003224745328</SerialNo>
					<SerialNo>88102310003224754037</SerialNo>
					<SerialNo>88102310003224765706</SerialNo>
					<SerialNo>88102310003224772104</SerialNo>
					<SerialNo>88102310003224780113</SerialNo>
					<SerialNo>88102310003224790304</SerialNo>
				</RandomizedNumberList>
			</SNResponse>
		</ns2:serialNumbersRequestResponse>
	</S:Body>
</S:Envelope>