• +39 035 622 43 51

Letters (Hibrid Mail)

With eMessage Letters Web Services, you can send some different types of hybrid mail (only to ITALY):
- Prioritaria: is the standard mail service.
- Raccomandata: is the premium mail service. Every letter has legal value and you can track the letter on Poste Italiane web site (www.poste.it).
- Raccomandata AR: is the premium mail service. Every letter has legal value and you can track the letter on Poste Italiane web site (www.poste.it).
- Raccomandata_SMART: is a special delivery service, at a lower price, which based on the geographical areas (as defined in appendix H). Every letter has legal value and you can track the letter on Poste Italiane web site (www.poste.it).
- Raccomandata_AR_SMART: is a special delivery service, at a lower price, which based on the geographical areas (as defined in appendix H). Every letter has legal value and you can track the letter on Poste Italiane web site (www.poste.it).
- Massiva: is a special delivery service, at a very lower price, which based on the geographical areas (as defined in appendix H).

Letters will follow those procedures:

 1. Letter prints on A4 sheets.
 2. Letter envelop in standard C5 envelope or bigger envelope is there are more than eight sheets.
 3. We apply correct stamp type.
 4. If letter is AR type, we print return receipt.
 5. We deliver letter to Poste Italiane.

Send

Web Service URL: https://ct.emessage.it/webservices/WSLetters.asmx
Method name: Send

Description
Web method to send letters.

Parameter
- Username (MANDATORY): account username.
- Password (MANDATORY): account password.
- SenderName (MANDATORY): sender name or company.
- SenderAddress (MANDATORY): sender address.
- SenderZipCode (MANDATORY): sender zip code.
- SenderCity (MANDATORY): sender city.
- SenderProv (MANDATORY): sender state or province.
- SenderCountry (MANDATORY): sender country.
- PrintType (MANDATORY): a string indicating type of print (see appendix I).
- Stamptype (MANDATORY): a string indicating type of stamp (see appendix I).
- Time: send time. (format: HH:mm:ss)
- Data: send date. (format: dd/MM/yyyy)
- PDFFile (MANDATORY): a byte array containing PDF file to send.
- ContactsList (MANDATORY): an array of WSContact object (see WSContacts.asmx web service).
- ForceSendByPriority (MANDATORY): true means that all letters that have an invalid zip code or the zip code does not belong to the city will sent as Priority mail (only for “Massiva” type).
- RePostalOperatorSpec (MANDATORY): true means that the document does NOT respect the specifications and needs to be overwritten as described in appendix F. If the document exactly respect the specifications in appendix F, you can set this field to false.
Warning: if you set FALSE AND THE DOCUMENT IS WRONG, IT WILL NOT SENT BUT DEBITED.
- Params: optional parameters array:
  -IdContactFolderOverride: id of contact folder used to override report ContactFolder field
  - ContactFolderCredit: true means that condominium with Id same as IdContactFolderOverride pay the spedition
  - HasCover: true means that a first page will be added by default
  - CoverHtmlContent: html body of first page
  - Note: a string used as note

Returns
This web method return a standard Result class:
- Data: number of KO letters (Error or not send).
- OptionResults:
  - SpeditionCode: assigned spedition code.
  - IdList: JSON list of ids

Send single

Web Service URL: http://cts.emessage.it/webservices/WSLetters.asmx
Method name: SendSingle

Description
Web method to send a single letter.

Parameter
- Username (MANDATORY): account username.
- Password (MANDATORY): account password.
- SenderName (MANDATORY): sender name or company.
- SenderAddress (MANDATORY): sender address.
- SenderZipCode (MANDATORY): sender zip code.
- SenderCity (MANDATORY): sender city.
- SenderProv (MANDATORY): sender state or province.
- SenderCountry (MANDATORY): sender country.
- PrintType (MANDATORY): a string indicating type of print (see appendix I).
- Stamptype (MANDATORY): a string indicating type of stamp (see appendix I).
- Time: send time. (format: HH:mm:ss)
- Data: send date. (format: dd/MM/yyyy)
- PDFFile (MANDATORY): a byte array containing PDF file to send.
- RecipientFirstName: recipient first name.
- RecipientLastName: recipient last name.
- RecipientCompany: recipient company (Warning: at least one of these parameters must be filled (RecipientFirstName, RecipientLastName or RecipientCompany).
- RecipientAddress (MANDATORY): recipient address.
- RecipientZipCode (MANDATORY): recipient zip code.
- RecipientCity (MANDATORY): recipient city.
- RecipientProvince (MANDATORY): recipient state or province.
- RecipientCountry (MANDATORY): recipient country.
- ForceSendByPriority (MANDATORY): true means that all letters that have an invalid zip code or the zip code does not belong to the city will sent as Priority mail (only for “Massiva” type).
- RePostalOperatorSpec (MANDATORY): true means that the document does NOT respect the specifications and needs to be overwritten as described in appendix F. If the document exactly respect the specifications in appendix F, you can set this field to false.
Warning: if you set FALSE AND THE DOCUMENT IS WRONG, IT WILL NOT SENT BUT DEBITED.
- Params: optional parameters array:
  -IdContactFolderOverride: id of contact folder used to override report ContactFolder field
  - ContactFolderCredit: true means that condominium with Id same as IdContactFolderOverride pay the spedition

Returns
This web method return a standard Result class:
- Data: number of KO letters (Error or not send).
- OptionResults:
  - SpeditionCode: assigned spedition code.
  - IdList: JSON list of ids

Send v2

Web Service URL: https://ct.emessage.it/webservices/WSLetters.asmx
Method name: Sendv2

Description
Web method to send letters.

Parameter
- Username (MANDATORY): account username.
- Password (MANDATORY): account password.
- SenderName (MANDATORY): sender name or company.
- SenderAddress (MANDATORY): sender address.
- SenderZipCode (MANDATORY): sender zip code.
- SenderCity (MANDATORY): sender city.
- SenderProv (MANDATORY): sender state or province.
- SenderCountry (MANDATORY): sender country.
- PrintType (MANDATORY): a string indicating type of print (see appendix I).
- Stamptype (MANDATORY): a string indicating type of stamp (see appendix I).
- Time: send time. (format: HH:mm:ss)
- Data: send date. (format: dd/MM/yyyy)
- PDFFile (MANDATORY): a byte array containing PDF file to send.
- ContactsList (MANDATORY): an array of WSContact object (see WSContacts.asmx web service).
- ForceKO (MANDATORY): true means that all letters that have an invalid zip code or the zip code does not belong to the city will sent through circuit retail.
- RePostalOperatorSpec (MANDATORY): true means that the document does NOT respect the specifications and needs to be overwritten as described in appendix F. If the document exactly respect the specifications in appendix F, you can set this field to false.
Warning: if you set FALSE AND THE DOCUMENT IS WRONG, IT WILL NOT SENT BUT DEBITED.
- Params: optional parameters array:
  -IdContactFolderOverride: id of contact folder used to override report ContactFolder field
  - ContactFolderCredit: true means that condominium with Id same as IdContactFolderOverride pay the spedition
  - HasCover: true means that a first page will be added by default
  - CoverHtmlContent: html body of first page
  - Note: a string used as note

Returns
This web method return a standard Result class:
- Data: number of KO letters (Error or not send).
- OptionResults:
  - SpeditionCode: assigned spedition code.
  - IdList: JSON list of ids

Send single v2

Web Service URL: https://ct.emessage.it/webservices/WSLetters.asmx
Method name: SendSinglev2

Description
Web method to send a single letter.

Parameter
- Username (MANDATORY): account username.
- Password (MANDATORY): account password.
- SenderName (MANDATORY): sender name or company.
- SenderAddress (MANDATORY): sender address.
- SenderZipCode (MANDATORY): sender zip code.
- SenderCity (MANDATORY): sender city.
- SenderProv (MANDATORY): sender state or province.
- SenderCountry (MANDATORY): sender country.
- PrintType (MANDATORY): a string indicating type of print (see appendix I).
- Stamptype (MANDATORY): a string indicating type of stamp (see appendix I).
- Time: send time. (format: HH:mm:ss)
- Data: send date. (format: dd/MM/yyyy)
- PDFFile (MANDATORY): a byte array containing PDF file to send.
- RecipientFirstName: recipient first name.
- RecipientLastName: recipient last name.
- RecipientCompany: recipient company (Warning: at least one of these parameters must be filled (RecipientFirstName, RecipientLastName or RecipientCompany).
- RecipientAddress (MANDATORY): recipient address.
- RecipientZipCode (MANDATORY): recipient zip code.
- RecipientCity (MANDATORY): recipient city.
- RecipientProvince (MANDATORY): recipient state or province.
- RecipientCountry (MANDATORY): recipient country.
- ForceKO (MANDATORY): true means that all letters that have an invalid zip code or the zip code does not belong to the city will sent through circuit retail.
- RePostalOperatorSpec (MANDATORY): true means that the document does NOT respect the specifications and needs to be overwritten as described in appendix F. If the document exactly respect the specifications in appendix F, you can set this field to false.
Warning: if you set FALSE AND THE DOCUMENT IS WRONG, IT WILL NOT SENT BUT DEBITED.
- Params: optional parameters array:
  -IdContactFolderOverride: id of contact folder used to override report ContactFolder field
  - ContactFolderCredit: true means that condominium with Id same as IdContactFolderOverride pay the spedition
  - HasCover: true means that a first page will be added by default
  - CoverHtmlContent: html body of first page
  - Note: a string used as note

Returns
This web method return a standard Result class:
- Data: number of KO letters (Error or not send).
- OptionResults:
  - SpeditionCode: assigned spedition code.
  - IdList: JSON list of ids