SendLetterAndAddressV2
Description
The SendLetterAndAddressV2() method is the simplest way to send a letter through the PostalMethods service.
With this method, you must create a letter with whitespace in the area showing through the envelope bottom window, according to the envelope type you wish to use. Letter templates are available for the various envelope types that PostalMethods supports.
Formal Definition
https://api.postalmethods.com/PostalWS.asmx?op=SendLetterAndAddressV2
Input
| Property | Type | Comments |
|---|---|---|
| Username | String | As provided during registration |
| Password | String | As provided during registration |
| MyDescription | String | Up to 100 characters. Free text. User may add any text to help identify the request (UTF8) |
| FileExtension | String | The extension of the attached document Example: pdfList of supported file types |
| FileBinaryData | base64Binary | Attached document represented as binary data List of supported file types |
| WorkMode | Default or Production or Development | Indicates whether the letter should be processed completely ('Production') or only simulated as a test ('Development'). 'Default' will use the PostalMethods User's default Work Mode setting |
| AttentionLine1 | String | Up to 45 characters. Non-address data, such as company, name, position, department, etc. Line will not be printed when empty. At least one of the attention or company lines must contain data. |
| AttentionLine2 | String | Up to 45 characters. Non-address data, such as name, position, department, etc. Line will not be printed when empty |
| AttentionLine3 | String | Up to 45 characters. Non-address data, such as name, position, department, etc. Line will not be printed when empty |
| Company | String | Up to 45 characters. Company / Firm name. At least one of the attention or company lines must contain data. |
| Address1 | String | Up to 45 characters.Main delivery address (e.g., 123 Main St.) or PO Box. This line must contain data. |
| Address2 | String | Up to 45 characters. Secondary address unit (i.e., Additional address elements such as Apartment, Suite, Building, Room, etc.) |
| City | String | Up to 30 characters. Use 'FPO' or 'APO' when sending to U.S. Military destinations. This line must contain data. |
| State | String | Up to 30 characters. State or Region. Use 'AE', 'AP' or 'AA' when sending to U.S. Military destinations |
| PostalCode | String | Up to 15 characters. Provide postal code in a format used in the destination country. When destination country is the USA, use a ZIP+4 code. If ZIP+4 is not provided we will try to add it |
| Country | String | Up to 30 characters. Value is required only when destination country is different than the user's country. |
Output: SendLetterAndAddressV2Response
| Element | Type | Comments |
|---|---|---|
| SendLetterV2Result | int | In case of successful submission, a positive number is returned indicating the letter's unique identifier on the system. In case of failure, a negative number is returned indicating the failure reason. See the list of Web Service Result Codes. |

