Web Service Description Language (WSDLs)

 

 1 Introduction

WSDL (Web Services Description Language) is an XML-based language for describing Web services and how to access them. WSDL is an XML format for describing network services as a set of endpoints operating on messages containing either document-oriented or procedure-oriented information. WSDLs can operate either as push message or as pull message. Push messages in a client/server application are defined as sending data to a client without the client requesting it. A defined trigger can cause a push message to be sent. A pull message occurs when the client sends a request and a subsequent response is delivered to the client. Postal Service supports WSDLs for the follow four systems: FAST, PostalOne! eDoc, Full-Service Data Feedback, and Profile Management. 

  

2 WSDLs

WSDL categories:

1.       CAT

2.       TEM

3.       Pre-Production

4.       Production

5.       Push Subscription

The links for downloading WSDLs are defined by the environment, Mail.XML version and message type. Select the version of the WSDL based on the environment and Mail.XML version you will exchange the Mail.XML data.

 

2.1 CAT Environment

 

This section describes the Mail.XML WSDLs that are supported in the CAT Environment. These WSDLs are for the upcoming release and are accessible and available only for the selected mailers who participate in USPS CAT certification phase. These WSDLs are subject to be revised at any time without notice. It is recommended for the mailers not to use these WSDLs unless participating in the CAT phase.

 

2.2 TEM Environment

 

The USPS Test Environment for Mailers (TEM) is the dedicated Mail.XML test environment that is required for all new customers, as well as users migrating to a different electronic documentation (eDoc), to test their desired Mail.XML version in. TEM simulates the Production environment, and completion of TEM testing is required for access to the Production environment.  Refer to the Test Environment for Mailers (TEM): Checklist and Troubleshooting on RIBBS.

 

2.3 Pre-Production Environment

 

This section describes the Mail.XML WSDLs that are supported in the Pre-Production Environment.

 

2.4 Production Environment

 

This section describes the Mail.XML WSDLs that are supported in the Production Environment.

 

2.5 Push Data Feedback WSDLs

There are five WSDLs for Push data feedback which are required to automatically receive Full-Service feedback data or notification at a regular frequency from USPS servers. Mailers must subscribe to Push messages on the Business Customer Gateway (BCG) and make the necessary authentication and authorization information available to the Postal Service. Push data feedback WSDLs are configured by users on their own servers. Full-Service feedback data includes Start-The-Clock, Address Correction COA and Nixie, Mail Quality Reports, By/For Conflict, Container Scan information, Stale Content, All Appointment Closeout, USPS Delivery Content Updated, Non Compliance Data with Postage Owed Report, Container Status, and MPS VIS. Customers need to implement Web services to receive data distribution messages from USPS.

 

Updated 11/26/2014