Web Service Description Language (WSDLs)

 

Table of Contents

1 Introduction

1.1 Modular XSD Specifications Overview

2 Web Service Description Languages (WSDLs)

2.1 TEM WSDLs

2.2 Pre-Production WSDLs

2.3 Production WSDLs

2.4 Push 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.

Supported Mail.XML versions by year:

         Click here to see Releases in 2014.

 

1.1 Modular XSD Specifications Overview

The Modular XSD specification is supported on Mail.XML versions. Messages are grouped by message sets, created for Mailing, Supply Chain, Transportation, Data Distribution and Identification. This helps customers who are interested in one or more message groups to develop and validate just those message groups without the requirement to address the entire Mail.XML specification. We support WSDL endpoints based on the Message Group (Mailing, Supply Chain, Transportation, Data Distribution and Identification). The WSDL endpoint for the message group will not change and will be enhanced to support multiple versions from Mail.XML 10.x and above.

 

2 WSDLs

WSDL categories:

1.       TEM

2.       Pre-Production

3.       Production

4.       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 TEM Environment

 

This section describes the Mail.XML WSDLs that are supported in 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.

Below zip file contains the WSDLs for the supported versions of Mailing, Supply Chain, Data Distribution, Identification, and Transportation modular XSDs:

 

2.2 Pre-Production Environment

 

This section describes the Mail.XML WSDLs that are supported in the Pre-Production Environment. Below zip file contains the WSDLs for the supported versions of Mailing, Supply Chain, Data Distribution, Identification, and Transportation modular XSDs:

 

2.3 Production Environment

 

This section describes the Mail.XML WSDLs that are supported in the Production Environment. Below zip file contains the WSDLs for the supported versions of Mailing, Supply Chain, Data Distribution, Identification, and Transportation modular XSDs:

 

2.4 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. Refer to the Test Environment for Mailers (TEM): Checklist and Troubleshooting on RIBBS.

 

Updated 06/12/2014