Contract Shipping

Code Samples for Contract Shipping: Java (.zip) | PHP (.zip) | C# (.zip)

Get MOBO Customer Information – SOAP

Summary

Name:	Get MOBO Customer Information
Reason to Call:	To retrieve details on allowed payers, methods of payment and other information about a mailed on behalf of customer to determine the proper customer number for charging shipping costs.
Input:	The mailed-on-behalf-of customer number for which customer information is desired.
Output:	Contract numbers, authorized payers and allowed methods of payment.
Error Examples:	Customer number not valid
Possible Prior Calls:	Get Customer Information
Possible Next Calls:	Create Shipment
Version history:	Release notes

Call Details

WSDL:	customerinfo.wsdl
Endpoint (Development):	https://ct.soa-gw.canadapost.ca/rs/soap/customerinfo
Endpoint (Production):	https://soa-gw.canadapost.ca/rs/soap/customerinfo
Namespace:	http://www.canadapost.ca/ws/soap/customer
Operation:	GetMoboCustomerInformation

SOAP Body

This section describes the XML input elements to this service. For the hierarchical structure, see the XML diagram.

Get MOBO Customer Information – Request Elements
Element Name	Type	Required / Optional	Description
get-mobo-customer-information-request	complex	required	The top level XML element for the request input information.
customer-number	simple	required	(1-10 digit numeric) The 10-digit customer number of the mailed-by customer.
mobo	simple	required	(1-10 digit numeric) The 10-digit customer number of the mailed-on-behalf-of customer.
locale	simple	optional	Indicates your language preference for receiving error messages. EN = English FR = French If no value is provided, the default language is English.

Request – XML Diagram

Get MOBO Customer Information – Structure of the XML Request

Response Details

Response – Elements

The following table describes the XML elements in the response to Get MOBO Customer Information. For the hierarchy of the response, see the XML diagram.

Get MOBO Customer Information – Response Elements
Field Name	Type	Description
get-mobo-customer-information-response	complex	The top level XML element for the response. It will either contain the results of a successful completion or the error message structure.
behalf-of-customer	complex	Contains all of the requested information about the behalf-of-customer for which information is being gathered.
customer-number	simple	Mailed-by customer number
contracts	complex	Contains the contracts that the customer owns or is authorized to use. Only contracts effective as of the date of the request are listed.
contract-id	simple	Contract number (also called agreement number).
authorized-payers	complex	Contains allowable paid-by customer numbers and methods of payment.
payer	complex	The customer number of an authorized payer.
payer-number	simple	Customer number of a payer which could be used for the mailed-by customer (where the mailed-by and behalf-of numbers are the same)
methods-of-payment	complex	Structure that contains the methods of payment this payer can use.
method-of-payment	simple	Can contain: account creditCard Note that if a payer has no method of payment, the payer can’t be used to ship.
mobos	complex	Contains information about the mailed-on-behalf-of customers that are associated with the requested customer number.
mobo	simple	The customer number of a specific mobo.

Response – XML Diagram

Get MOBO Customer Information – Structure of the XML Response

View full-size image

Response – Possible Error Responses

The response to error conditions for this web service follows the standard SOAP error response approach used for all Canada Post web services. For more information, see SOAP Fundamentals of Canada Post Web Services.

Possible error messages for this service include the following.

Code	Message
9152	The customer number provided does not have the correct format.

Examples

Sample SOAP XML Request – Get MOBO Customer Information


  

    <get-mobo-customer-information-request>
  
    <customer-number>2222222</customer-number>

    <mobo>1111111</mobo>

  
    </get-mobo-customer-information-request>

Sample SOAP XML Response – Get MOBO Customer Information


  

    <get-mobo-customer-information-response>
  
    <behalf-of-customer>
  
    <customer-number>0001111111</customer-number>

    <contracts>
  
    <contract-id>0012345678</contract-id>

  
    </contracts>

    <authorized-payers>
  
    <payer>
  
    <payer-number>0001111111</payer-number>

    <methods-of-payment></methods-of-payment>

  
    </payer>

  
    </authorized-payers>

  
    </behalf-of-customer>

  
    </get-mobo-customer-information-response>

Sign in

Resources