This appendix contains the following topics:
Introduction to Email Configuration
If you are using a -PDF- or a -PDFP- printer in Company information to print specific PBS form types you are generating PDF files. These files can be emailed.
Email must be configured in PBS before these features will function properly. This appendix identifies what needs to be configured in PBS in order to email PDF forms to customers or vendors.
If you already have email configured, information on the user functions of emailing and viewing PDFs, is in the System User documentation chapter PDF Form File Processing.
The following is a list of forms that may saved as a PDF and therefore may be emailed:
Application |
Function |
Accounts Receivable |
Batch, immediate, and reprinted invoices |
Accounts Receivable |
Statements |
Order Entry |
Batch, immediate and reprinted invoices |
Purchase Order |
Pre-defined and user-defined new, changed, released and all purchase orders |
Payroll |
Check and Remittance Pay Advices |
Point of Sale |
Batch invoices, credit memos and payments |
Customer Orders |
Packing lists, acknowledgments and invoices |
Product Purchasing |
Purchase orders |
You must have an email address for each PBS user who will be emailing from PBS as well as SMTP or SSL connection settings before you can implement email in PBS.
In order for emailing PDF files to function properly, there are several areas within PBS that require a setup. You must set up the system (CTL) fields in all cases. The A/P, A/R and PR fields depend on which forms you are emailing. Here is a table of those areas and the fields:
Application |
Menu |
Field |
CTL |
Setup information User maintenance |
Email address Email login |
CTL |
Company information |
All fields on the email setup tab (character mode screen 4). See Fifth Tab - Email Setup. |
A/P |
Vendors (F7 = Contacts) * |
E-mail 1 - Enter the vendor's email address. Email documents - Allows emails to be sent for the matching vendor. |
A/P |
Vendors * |
Default PO contact (using graphical mode accessed on the Contacts tab or using character mode, via field 6) |
A/R |
Customers (F7 = Contacts) * |
Email documents |
A/R |
Customers * |
Default contact (accessed on first tab or via field 4) |
PR |
Employees |
E-mail documents flag, E-mail document password and E-mail address |
* If you are not emailing Purchase orders you do not have to set up Vendors and Vendor contacts. The vice versa is true if you are not emailing any customer documents.
Here are some more details on the email setup:
Enter an email address and email login in User maintenance for each user that is going to email PDF forms from PBS. Read the PBS Users chapter for more information on entering the Email address and Email login fields. You must know the users' email address and SMTP or SSL authentication in order to make these entries.
There is no place to save email passwords in PBS. Therefore each PBS user who emails PDF files must know their own email password in order to email PDFs with PBS. The user will be prompted at the time of emailing for the password.
Email Setup
In Company information, Fifth Tab - Email Setup, you must enter the server host name and other email fields. This is required for ALL the form types that you email with PBS.
Within Company information you must test test your email connection. It will test the connection for the user's email address for which you are logged into PBS. The user must know their email password.
Printer Setup
For creating PDF files to be emailed, you must enter a printer as -PDF- or -PDFP- printer. This is also explained in Company information; see The Printer-name field and PDF Printing.
You may enter customer or vendor email addresses on-the-fly if you want, but having them pre-entered in a contact file is a convenience.
You may email PDF forms to vendor and customer contacts. Email addresses are entered in the vendor contacts and customer contacts.
If you are going to stack and email PDFs it is essential that you have a contact set up for emailing. The two contacts fields required for emailing are E-mail (email address field) and Email documents (set it to Y or checked).
If you have more than one contact with an email address the Email documents field determines which contact to use. Even if you only have one contact with an emaiil address, set the field to Y (check the box) or you will have to enter an email address for the customer or vendor when emailing. If you have more than one customer or vendor contact set up for emailing, you can CC the PDF file to the other contacts.
For information on entering A/P contacts, go the Accounts Payable user documentation and read the Vendors chapter. For A/R contacts read the Accounts Receivable documentation chapter called Customers.
If the Company information field Allow email addresses to be entered at send time is set to N (unchecked), then you must enter a contact email address for each customer or vendor to which you will be sending emails.
You should set up a default contact for each customer or vendor who will be emailed PDFs. When this is done, you will not have to enter the email address each time you select a form.
For information on entering vendors go the Accounts Payable user documentation and read the Vendors chapter. For entering A/R customers read the Accounts Receivable documentation chapter called Customers.
If the Company information field Allow email address to be entered at send time is set to N (unchecked) you must have a default contact for the vendor or customer. If set to Y (checked) you may enter an email address when emailing one PDF at a time, at send time. When stacking PDFs to be emailed, the default contact field must be entered.
For stacking employee pay advices, other than Company information setup and the required fields in Employees, there is no other setup.
When stacking PDFs, in addition to the Company information and User fields, you must have the following fields set up for customers or vendors:
Customers > Default contact
Customers (Contacts) > Email and Email documents?
Vendor > Default contact
Vendors (Contacts) > Email and Email documents?
A Pay advice is a PDF form. During a pay run, using Print checks and post, Pay Advice PDF files are generated for each employee set to get them.
For direct deposit paid employees this is a convenience by not having to mail or hand deliver the remittance. For employees paid by check, the emailed pay advice can let the employee know that their pay check is available and ready for pick-up.
Employees Setup
In Employees there are three fields that involve emailing pay advices:
• | The E-mail documents field determines whether or not a pay advice PDF file is generated. This allows you to determine by employee who can be emailed a Pay advice. |
• | The employees Email-address field. |
• | For added security, there is an E-mail document password field. This is written into the PDF file during a pay run. After an employee receives an emailed pay advice, the employee must enter the password in order to view the Pay advice pdf file. This gives you some assurance that, even if the Pay advice is emailed or forwarded accidentally to the wrong employee, that person will not be able to view the contents. |
Checks (and Mailers)
Before doing a pay run, you must have emailing configured and active for the company. If not configured you will be warned on the Payroll calculation and you will be stopped from emailing during a pay run.
During a pay run, you may either elect to have the Pay advices emailed immediately or to stack them for emailing later. When emailing later you will use the Email/view printed PDFs features.
When stacking the PDF emails for sending later, go to CTL -> PFD form file processing.
There are potential error codes that could occur if the PBS email is not set up properly so that a connection cannot be made or the email provider is down. There are standard errors and errors specifically from Marshall Software. Marshall Software is a third party product that PBS uses to send emails.
Note |
Passport recommends that you contact your email hosting provider and inquire as to a limit on the number of emails per hour or day. Emails could start to fail after a round number of messages are sent successfully (perhaps after 50, 100, 200, 500, 1000, etc.) Work with your hosting provider to extend that limit when needed. |
In addition to the error messages below, also see Email Connection Failed and Other Errors, both in the Company information chapter.
Most, if not all, ISP, Web Hosting and Free Email providers have limits on the amount of emails that can be sent per hour or per day. When you encounter this you may find that email works well for the first 50, 100, 200 or so emails and then just stops. You must consult with your provider and request an exception. If that does not work you will have to create your own dedicated web server. Here is a web site, that advertises their own service and goes into detail:
Passport has never used or knows of anyone who has used the Groupmail service. Although their service may be fine, based on no experience we cannot recommend it.
WINSOCK (short for Windows Socket) is a Microsoft Windows DLL program that provides the interface to TCP/IP services, essentially allowing Windows to use Web browsers, FTP programs, and others. It allows you to send data to and from the Internet.
The following table contains the standard WINSOCK error codes and descriptions:
Error code |
Message |
10004 |
Interrupted system call. |
10009 |
Bad file number. |
10013 |
Permission denied. |
10014 |
Bad address. |
10022 |
Invalid argument. |
10024 |
Too many open files. |
10035 |
Would block socket in non-blocking mode. Resource temporarily unavailable. |
10036 |
Blocking call operation already in progress. |
10037 |
Operation already completed. |
10038 |
Not a valid socket. |
10039 |
Destination address required. |
10040 |
Message too large for buffer. |
10041 |
Protocol mismatch. |
10042 |
Protocol option invalid. |
10043 |
Protocol not supported. |
10044 |
Socket type not supported. |
10045 |
Socket operation not supported. |
10047 |
Socket address family not supported. |
10048 |
Socket address already in use. |
10049 |
Socket address not available or not valid. |
10050 |
Network error. |
10051 |
Cannot reach network. |
10052 |
Connection dropped. |
10053 |
Connection timed-out or aborted. |
10054 |
Connection reset by remote host. |
10055 |
Out of buffer space. |
10056 |
Socket already connected. |
10057 |
Socket not connected. |
10058 |
Socket functionality shut down. |
10060 |
Timed-out attempting to connect. |
10061 |
Connection refused by remote host. |
10064 |
Host is down |
10065 |
No route to host |
10091 |
Network not yet ready. |
10092 |
WINSOCK doesn't support requested version. |
10093 |
Sockets not initialized. Call WSAStartup. |
11001 |
Host does not exist. |
11002 |
Host not found. Try again. |
11003 |
Non-recoverable error has occurred. |
11004 |
No data is available. |
The following are the error codes and descriptions from Marshall Software. The letters SEE indicate that it is a Marshall Software error.
Error Code |
Problem |
1 SEE_EOF |
End of file (socket has been closed). |
4 SEE_IS_BLOCKING |
Socket is currently blocking. |
7 SEE_INVALID_SOCKET |
Invalid socket |
8 SEE_TIMED_OUT |
Socket timed out awaiting data. |
9 SEE_NO_SOCK_ADDR |
No socket address. |
12 SEE_NO_HOST |
No host name. |
14 SEE_ABORTED |
The DLL has been corrupted. |
18 SEE_CANNOT_CREATE_SOCK |
Cannot create socket. |
30 SEE_ALREADY_CONNECTED |
Already connected to server. |
31 SEE_BACK_OVERFLOW |
Response buffer has overflowed. |
32 SEE_BAD_ADDRESS_CHAR |
Bad character in email address. |
34 SEE_CANNOT_ATTACH |
Cannot access DLL. |
35 SEE_CANNOT_OPEN |
Cannot open file (for read). |
36 SEE_CONNECT_ERROR |
Error attempting to connect. |
37 SEE_EMPTY_ADDRESS |
EMPTY email address. |
38 SEE_FROM_NULL_ARG |
Required 'From:' argument is NULL. |
39 SEE_MISSING_AT_CHAR |
Missing '@' character in email address. |
40 SEE_MISSING_FROM |
Missing 'From:' email address. |
41 SEE_MISSING_LEFT |
Missing '<' delimiter in email address. |
43 SEE_MISSING_RIGHT |
Missing '>' terminating email address. |
44 SEE_NOT_CONNECTED |
Not connected to server. |
45 SEE_NO_RECIPIENTS |
Must have at least one recipient. |
46 SEE_NO_SERVER |
Cannot find SMTP/POP3 server. |
47 SEE_NULL_POINTER |
Unexpected NULL pointer. |
49 SEE_SMTP_ERROR |
SMTP returned error. |
50 SEE_EMAIL_NULL_ARG |
SMTP/POP3 server not specified. |
51 SEE_SOCK_READ_ERROR |
Socket read error. |
52 SEE_SOCK_WRITE_ERROR |
Socket write error. |
53 SEE_TOO_MANY_AT_CHARS |
Too many '@' symbols in email address. |
55 SEE_CANNOT_ALLOC |
Cannot allocate memory. |
56 SEE_NOT_SERVER |
|
57 SEE_NO_APOP_TIMESTAMP |
POP3 server did not provide a timestamp. |
58 SEE_SMTP_ONLY |
Must be connected to SMTP server. |
59 SEE_POP3_ONLY |
Must be connected to POP3 server. |
60 SEE_OBSOLETE_PARAMETER |
Parameter is obsolete. |
61 SEE_USER_NULL_ARG |
Expected USER name not specified. |
62 SEE_PASS_NULL_ARG |
Required POP3 password argument missing. |
63 SEE_POP3_ERROR |
Error returned by POP3 server. |
64 SEE_MSG_NBR_RANGE |
Message number out of range. |
65 SEE_FILENAME_NULL_ARG |
Required filename is missing. |
66 SEE_EMAIL_PATH_NULL_ARG |
Required file path is missing. |
67 SEE_CANNOT_CREATE |
Cannot create file. |
68 SEE_BUFFER_NULL_ARG |
Required buffer is missing. |
69 SEE_BUFFER_SIZE_ARG |
Buffer size argument is not positive. |
70 SEE_ATTACH_PATH_NULL_ARG |
Attachment argument is missing. |
71 SEE_NOT_ATTACHED |
SEE not attached. Must call seeAttach first. |
72 SEE_ALREADY_ATTACHED |
seeAttach already called. |
73 SEE_CHAN_OUT_OF_RANGE |
Channel number out of range. |
74 SEE_BAD_KEY_CODE |
Bad key code (2nd argument in seeAttach) |
75 SEE_NO_SUCH_FILE |
No such file. |
76 SEE_PATH_NOT_ALLOWED |
Filename only - path not allowed. |
98 SEE_EXPIRED |
Evaluation version expired. |
99 SEE_INTERNAL_ERROR |
Internal SEE error. |
1 SEE_CANNOT_COMPLY |
Cannot comply. Not always an error. |
1 SEE_NO_ERROR |