Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Import Link Fixer

...

This document is updated routinely to reflect the current version of the USPS SOAP service.
Links to the latest version of this document can be obtained from the SSDT Public Wiki site at: https://wikimcoecn.ssdt-ohio.orgatlassian.net/wiki/x/EBMO_AYm

Resources

This document does not represent the complete documentation for the USPS SOAP service. The actual API documentation is contained in the WSDL, the USPS XML Schema and the OECN RPC XML schema. These documents are available from the the actual installation of the USPS SOAP service. Developers can find the current development version of the documents at: http://devel.ssdt.nwoca.org/uspssoap/

...

To view a list of changes made to the USPS XML Schema for version 1.6 onward of the USPS SOAP service, view the Updates to USPS XML Schema page.


usps-42.xsd

UspsWebService.wsdl

Status of the USPS SOAP Service

...

It is important that the client invoke setDistrictAccess code to establish the district database to which the session is bound. This must be done exactly once after login and prior to any other USPS operation.{{

Note

...

A client must not invoke _setDistrictAccess _more than once for a session. A fault will be returned if such an attempt is made and the session will be left in an indeterminate state. Client applications that need to access more than one district, must establish at least one session for each district.

...

Session Timeout


Sessions consume resources on both the SOAP server and the back-end USPS server. Therefore, inactivity timeouts apply to the SOAP sessions. The timeout interval is configurable by each ITC and defaults to approximately 45 minutes. If there is no activity for a session during the timeout interval, the session will be deleted from the SOAP service. Any subsequent invocations using an expired sessionId will result in a fault being returned. Client applications that attempt to maintain long running connections, must be prepared to handle such faults.

...

HTML Table
border1


Table Row (tr)


Table Head (th)
You type


Table Head (th)
Looks like



Table Row (tr)


Table Cell (td)
valigntop

UWC_TOKEN_START~1292862896731~UWC_TOKEN_END


 
Table Cell (td)



Table Row (tr)


Table Cell (td)
valigntop

Or with line numbering:
UWC_TOKEN_START~1292862896732~UWC_TOKEN_END


 
Table Cell (td)


 
HTML Table
border1



Table Head (th)
Request


Table Head (th)
Response


 
Table Row (tr)


Table Cell (td)
/resource/W2?employee.id=EMP0001&tax.year=2008


Table Cell (td)
Content-type: application/pdf


 
Table Row (tr)


Table Cell (td)
/resource/W2?employee.id=EMP0001&tax.year=4008


Table Cell (td)
HTTP 404 Response (not found)


 
Table Row (tr)


Table Cell (td)
valigntop
/resource/W2?employee.id=EMP0001&tax.year=*


Table Cell (td)

Returns all URL's found for the specified employee

Panel

Content-type: text/x-resources
Body:
http://host/uspssoap/resource/W2?employee.id=EMP0001&tax.year=2007
http://host/uspssoap/resource/W2?employee.id=EMP0001&tax.year=2008
. . .



 
Table Row (tr)


Table Cell (td)
valigntop
/resource/W2?employee.id=*&tax.year=2008


Table Cell (td)

Returns all URL's for all documents for the specified year

Panel

Content-type: text/x-resources
Body:
http://host/uspssoap/resource/W2?employee.id=EMP0001&tax.year=2008
http://host/uspssoap/resource/W2?employee.id=EMP0002&tax.year=2008
http://host/uspssoap/resource/W2?employee.id=EMP0003&tax.year=2008
http://host/uspssoap/resource/W2?employee.id=EMP0004&tax.year=2008
. . .



 
Table Row (tr)



HTML Table
border1


 
Table Head (th)


Table Head (th)
Footnotes


Table Row (tr)


Table Cell (td)
1


Table Cell (td)
WS-I is a trademark of the Web Services-Interoperability Organization in the United States and other countries.



...