Processing Orders
Contents
Filling new orders
The Job Queue
Check for new hosting and domain orders in the job queue. The 'Job Queue' in the Quick Alerts box on the admin home page will show red if there are any open jobs, pending jobs (awaiting approval) or failed jobs.
Click on the Job Queue link in the Quick Alerts box or click on the Queue Manager link on the left menu to enter the job queue.
Pending Jobs:
Orders in the pending job queue are awaiting approval or a generic (non supported) module.
Open Jobs:
Orders in the open job queue will be run automatically when the master_cron.php cron runs. Orders with open invoices will not be run until the invoice is paid.
Processing Jobs:
Orders will only be in the processing queue while they are processing. There is no need to do anything with those. If orders remain in the processing queue, there is a problem (or was a problem) when your cron runs.
Hold Jobs:
Use the hold queue to place orders that you want to place on hold to manually run or approve. Example: You receive a domain order from a customer that you know and are aware that they have misspelled the domain name, place it in the hold queue until you have contacted them to verify it is what they want. Another example: An order will be paid by check and you know they won't be paying for a long period of time. Move the job to the hold queue to keep your open job queue clear for easy administration. Then when you receive the payment, click to run or edit and move to open.
Closed Jobs:
Closed jobs are completed and processed. The can be searched for easy reference at any time.
Errors:
Jobs in the errors queue failed when they ran. You will need to determine the problem and rectify it. If you click the edit link beside the failed job, you can normally get an error message in the return field that will help determine the problem. If the problem is not clear, you can also enable debug mode by clicking the 'Debug Mode' link at the top of the Queue Manager page, then run the failed job in debug mode. Debug mode will show more detailed communication to your hosting server or domain registrar depending upon what type of job it is.
Hosting orders
The following information applies if you have Configuration >> System Options >> Activate new hosting packages immediately: set to False The new orders will be found in the pending area of the job queue manager.
- if you want to create the account on the default server, or if you have server load balancing and no adjustments need to be made, click the 'approve' link to move the job to the open queue and it will be run when your master_cron.php job runs the next time.
If you want to set the server or edit the username (**customization hook) or any other information, click the edit link and make the desired changes and save. Then click the approve link.
Another option is to click the run link to immediately setup the account.
The following information applies if you have Configuration >> System Options >> Activate new hosting packages immediately: set to True The new orders will be found in the open area of the job queue manager.
All new hosting orders will be processed without intervention when the master_cron.php runs.
Note: All of the above will generate the email setup on the hosting package configuration to the customer and a copy to the 'copy-to admin' mail setup in the company information configuration page.
- Relevant links;
Overridiing system generated hosting usernames and/or passwords.
Hold hosting jobs based on server or package
AddOn orders
- Addon orders will need to be manually handled and then click the run link. Example: Addon for an IP address, login to your hosting server and setup the hosting account with the new IP. When you have done that click run.
Executing code upon addon package queue job run
Domain name orders
- Click the approve link to send the domain order to the open queue or run to register it immediately (if using a supported registrar).
If using a non supported registrar, register the domain name at your registrar and then click run link.
Note: If a domain is ordered with hosting and you want to use the run link to immediately process, click the run link on the hosting order first, then the domain name. This way it will register the domain name with the correct hosting nameservers. The only exception to this is eNom hosting. If it is eNom hosting, click the domain registration link first, then the hosting.
Note:The system will register domains with nameservers in this order:
1. User's domain profile.
2. If no nameservers in user domain profile, use the ones in the registrar setup of AWBS.
Here's the exception:
If hosting is ordered with the domain, the hosting server's nameservers override both of above
IDN domain name orders
IDN orders are to be placed using the IDN form, located at:
http://[your_AWBS_url]/check.php?isidn=1
IDN orders will show up in the job queue with the SLD field showing the domain in the language the customer typed it in. There is an additional field labeled IDN SLD, which will reflect the plain text version of the IDN domain name (SLD). Near the end of the queue fields, there will be a field labeled Idn_type, which will reflect your configured language as per your registrar settings.
Process IDN domain orders the same way you process any Domain name order.
Dedicated Servers
- Once the dedicated server order is filled, edit the job with any details such as login, IP, etc and save. Then click the run link.
Other Package Orders
Other items offered through the 'Other Package Setup' section of the configuration will not show up in the job queue. Find new 'other orders' by clicking on the Other Package Manager on the left menu or the Pending Other link in the Quick Alerts box on the admin home page.
New orders will be in a 'Pending' status.
Fill the order as needed (send the product, complete the service, etc.) and click to edit the order in the Other Manager. Make any adjustments necessary and set the Status to 'Filled/Closed' if the item/service is non recurring (a one time price). Set to 'Filled/Active' if the item/service is recurring. Check the Send Activate/Cancel Mail checkbox if you want to send the customer the email configured in the other package setup for that package. Click Save Record.
Cancelling new orders
New orders with unpaid invoices can be cancelled by clicking the 'cancel order' link in the job queue.
Orders with paid invoices will need more attention:
First go to the invoice manager and click to edit that invoice. Change status to 'open' and select the 3rd radio choice 'Re-Open invoice, remove journal transaction entries, remove payment'. Click the 'Save Record' button at the bottom of the page.
Note: this does not refund the money, you have to manually refund the payment at the payment gateway.
Then go back to the job queue and use the 'cancel order' link to remove the order from the system.
Orders for 'other' items and services are manual removals.
If the invoice is paid, use the 're-open' procedure in the invoice manager as above in the 'orders with paid invoices' paragraph.
(Go to the invoice manager and click to edit that invoice. Change status to 'open' and select the 3rd radio choice 'Re-Open invoice, remove journal transaction entries, remove payment'. Click the 'Save Record' button at the bottom of the page.)
Then click to edit the invoice again and void it; Change status to void and select the 2nd radio choice 'Void invoice, delete journal and transaction entries' and then click the 'Save Record' button at the bottom.
Then in the Other Package Manager, click to edit the pending other you wish to cancel and use the delete record checkbox and save to remove it from the database OR you can set it's status to cancelled if you do not wish to remove it from the database.
