# Thursday, November 24, 2016

Please be aware that our USA printing station is currently closed for the Thanksgiving Holiday on the 24th and 25th of November. They will reopen as normal on the 28th of November. Any US based mail sent during this time will be sent to our printing station as normal for processing on Monday the 28th of November.

posted on Thursday, November 24, 2016 9:37:00 AM (GMT Standard Time, UTC+00:00)  #    Comments [0] Trackback
# Tuesday, October 25, 2016

The Royal Mail tracking system is currently experiencing problems. Valid tracking numbers are showing the error "tracking number is invalid and not recognised". Royal Mail are aware of the issue and are working to resolve it. Please note there are no issues with tracked items being dispatched from PC2Paper, they are still being mailed as normal.

posted on Tuesday, October 25, 2016 11:08:27 AM (GMT Daylight Time, UTC+01:00)  #    Comments [0] Trackback
# Wednesday, August 24, 2016

PC2Paper is closed for the Bank Holiday on Monday the 29th of August. There are also no Royal Mail deliveries or collections on this day. Any Mail sent after our 3.30pm cut-off time on Friday the 26th of August will be posted on the next available working day Tuesday the 30th of August. Please note our earlier cut-off time of 1pm for Signed services such as Special Delivery and Recorded Delivery.

posted on Wednesday, August 24, 2016 10:41:35 AM (GMT Daylight Time, UTC+01:00)  #    Comments [0] Trackback
# Sunday, July 31, 2016

Below is an example of using our JSON API to send a letter.

Our JSON API has exactly the same fields as our SOAP API and uses the same functionality as our SOAP API.

In the example below we are sending a letter to one person with the body included as free text. You may also use HTML to format the body of your letter. The JSON below could quite easily be used straight from JavaScript or from nodejs, but could just as well be used from almost any coding language. The endpoint to post your JSON to is https://www.pc2paper.co.uk/lettercustomerapi.svc/json/SendSubmitLetterForPosting

{
    "letterForPosting":
    {
    "SourceClient" : "My App name 1",
    "Addresses" :[
        {"ReceiverName": "John Smith",
        "ReceiverAddressLine1" : "1 Acme Road",
        "ReceiverAddressLine2" : "My Street",
        "ReceiverAddressTownCityOrLine3" : "Town",
        "ReceiverAddressCountyStateOrLine4" : "County",
        "ReceiverAddressPostCode" : "Postcode"}
        ],
        "ReceiverCountryCode" :1,
        "Postage":31,
        "Paper":1,
        "Envelope":1,
        "Extras":0,
        "LetterBody" : "Dear Peter, 
Please find my letter attached"
,
        "IncludeSenderAddressOnEnvelope" : true,
        "SenderAddress" : "22 Acme Acres\n Acme Town",
        "YourRef" : "MyRef001" 
        
    },
     "username" : "yourusername",
    "password" : "yourpassword"
}

In the above examples you will notice we use a ReceiverCountryCode you can lookup the code to use for the country you are sending to here. In the above example the country code 1 represents the UK.

For the postage options you can lookup the options you would like to use by using our postage calculator. The postage calculator will list the API options at the bottom of the page for you after you make your selection.  In the example above we have chosen Postage 31 (UK Second Class), Paper 1 (Black and White 80 gsm), Envelope 1 (Standard DL). If you would like the ability to lookup your own postage options, you can use our letter pricing API which you can find out more about here

If you'd like to include PDF's as attachment's to your letter, you can upload these and use the unique id's the website gives you to attach them to your letter.

You can upload PDF's one of two ways.

JSON PDF File Upload

https://www.pc2paper.co.uk/lettercustomerapi.svc/json/UploadDocument

With a JSON file upload you will need to convert what ever file you are uploading into an integer array. This can usually be done by converting your file into a byte array and then into an integer array

{
    "filename":"myfile.pdf",
    "username":"yourusername",
    "password":"yourpassword",
    "fileContent":[37,80,68,70,45,49,46,53,13,10,37...]
}

 

After successfully uploading your PDF file you should receive a response similar to the following.

{
  "d": {
    "__type": "UploadedFileResult:#PC2Paper.Entity.Public.Letters",
    "ErrorMessages": null,
    "FileCreatedGUID": "648b6725-a3c6-4396-b28a-33e86589aa4b",
    "Status": "OK"
  }
}

Store the FileCreatedGUID somewhere as you will need this to attach it to your letter. 

SOAP PDF File Upload

If you would prefer to upload your PDF file over SOAP instead of JSON you can use this endpoint.

https://www.pc2paper.co.uk/lettercustomerapi.svc?wsd

You can find a PHP example and C# example of how to use our SOAP API to upload a file.

Using an uploaded PDF file in your letter

After you have uploaded your PDF file using one of the two methods above you will be provided with a FileCreatedGUID for each file you upload. Construct the JSON for your letter as before but include an array of File GUIDs you would like to attach in the FileAttachementGUIDs field.

{
    "letterForPosting":
    {
    "SourceClient" : "My PC2Paper Client",
    "Addresses" :[
        {"ReceiverName": "John Smith",
        "ReceiverAddressLine1" : "1 Acme Road",
        "ReceiverAddressLine2" : "My Street",
        "ReceiverAddressTownCityOrLine3" : "Town",
        "ReceiverAddressCountyStateOrLine4" : "County",
        "ReceiverAddressPostCode" : "Postcode"}
        ],
        "ReceiverCountryCode" :1,
        "Postage":31,
        "Paper":1,
        "Envelope":11,
        "Extras":0,
        "LetterBody" : "Dear Peter, 
Please find my letter attached"
,
        "FileAttachementGUIDs":["648b6725-a3c6-4396-b28a-33e86589aa4b"]
        
    },
     "username" : "your username",
    "password" : "yourpassword"
    
    
}

You should receive the following response after submitting a successful letter.

{
  "d": {
    "__type": "LetterForPostingResult:#PC2Paper.Entity.Public.Letters",
    "CostOfLetter": 2.02,
    "ErrorMessages": null,
    "FundsLeftInYourAccount": 160.54,
    "LetterId": "71566",
    "Status": "OK"
  }
}

Sending a letter to more than one person

If you would like to send the same letter to more than one person. Just add more people to the Addresses array.

 "Addresses" :[
        {"ReceiverName": "John Smith",
        "ReceiverAddressLine1" : "1 Acme Road",
        "ReceiverAddressLine2" : "My Street",
        "ReceiverAddressTownCityOrLine3" : "Town",
        "ReceiverAddressCountyStateOrLine4" : "County",
        "ReceiverAddressPostCode" : "Postcode"},
        
         {"ReceiverName": "Bob Smith",
        "ReceiverAddressLine1" : "The Gables",
        "ReceiverAddressLine2" : "Another Road",
        "ReceiverAddressTownCityOrLine3" : "Town",
        "ReceiverAddressCountyStateOrLine4" : "County",
        "ReceiverAddressPostCode" : "ZZ1 0ZZ"}
        ]
posted on Sunday, July 31, 2016 6:59:08 PM (GMT Daylight Time, UTC+01:00)  #    Comments [0] Trackback
# Monday, July 4, 2016

Our USA based printing station is closed today for the 4th of July public holiday. We are continuing to send mail to the USA as normal for processing, however, customers should be aware no mail will enter the US postal system until our printing station reopens on the 5th of July.

posted on Monday, July 4, 2016 12:03:17 PM (GMT Daylight Time, UTC+01:00)  #    Comments [0] Trackback
# Friday, May 27, 2016

Monday the 30th of May is a Bank Holiday in the UK. As a result there are no postal collections or deliveries on this day. The PC2Paper office will be closed for the holiday. Any letters sent after our 3.30pm cut-off time on Friday the 27th of May will be queued and processed the next available working day Tuesday the 31st of May. Customers should also expect delivery of mail to take longer as Monday is not classed as a working day.

posted on Friday, May 27, 2016 1:06:56 PM (GMT Daylight Time, UTC+01:00)  #    Comments [0] Trackback
# Friday, April 29, 2016

PC2Paper is closed on Monday the 1st of May for the Bank Holiday. There are no Royal Mail deliveries or collections on this day and customers should expect delivery to take longer over the Bank Holiday weekend. Any mail sent after our cut-off time on Friday the 29th of April will be processed on the next available working day Tuesday the 2nd of May.

posted on Friday, April 29, 2016 12:47:46 PM (GMT Daylight Time, UTC+01:00)  #    Comments [0] Trackback
# Tuesday, April 5, 2016

We have been aware of an issue with postal tracking numbers in eBay. The ebay website sometimes displays the error "The tracking number you entered is already in use for another transaction and cannot be applied for this transaction. Please enter the correct tracking number for this order."

Having checked Google there are many forum threads with ebay customers reporting this error for valid tracking number. If you receive this error from ebay it is not a problem with the tracking number that we have provided for your letter. This is a ebay problem and customers should approach ebay directly.

Any letters that display this error can still be tracked as normal through the Royal Mail or USPS website, the only issue being that they cannot be entered into the ebay system.

posted on Tuesday, April 5, 2016 9:58:10 AM (GMT Daylight Time, UTC+01:00)  #    Comments [0] Trackback