Magento

Here’s a list of what you will need to do to get Zenprint_Ordership (v0.0.4) working. Note that these steps apply to US shippers. This module has not been tested with international shippers elsewhere :

GENERAL STEPS:

1. First of all you need to get an API account setup with Fedex and/or UPS. This process requires that you sign up and go through an approval process where you will receive a test API key and then you will have to submit printed shipping labels back to the carrier for each shipping method you plan to use for their approval. This has been done with the 4x6 labels that are produced through the extension, so you should have no problem getting approval. If you have questions or problems obtaining this API key, talk to your account representative.
2. The next step is to install the Zenprint_Xajax and Zenprint_Ordership extensions through Magento Connect in that order.
3. In the asmin, go to System->Configuration and click on the ‘Shipping Settings’ tab. You will need to populate the ‘Origin’ data with details on where the package will ship from. If you have a warehouse with daily pickup, this will be the address of that location. Some shipping methods also require a phone number, so make sure you populate that field as well.
4. In the admin, go to System->Configuration and click on the ‘Shipping Methods’ tab. Then select the carrier of your choice (either Fedex or UPS) and follow the corresponding steps below.

STEPS FOR FEDEX CONFIGURATION

1. Under the Fedex section, set ‘Enabled’ to Yes.
2. Set ‘Test Mode’ to No (setting this to Yes will force the code to hit the API at a specifc URL, but it is not the correct test URL, so this feature will likely be removed in a future release).
3. Set the Gateway URL. For the production API, the URL is https://gateway.fedex.com/GatewayDC. The testing API is located at https://gatewaybeta.fedex.com/web-services
4. Enter your Fedex ‘Account ID’.
5. Select the ‘Account Country’.
6. Enter the ‘Password’, ‘Key’, and ‘Meter’ you have been given for API access
7. Select your desired ‘Packaging’. Unless you always ship in the same type packaging, you will want to select ‘Your Packaging’.
8. The ‘Maximum Package Weight’ should be 150 for Fedex in the US.
9. Select your desired ‘Dropoff’. This module has been validated to work with ‘Regular Pickup’.

The rest of the Fedex settings should be self explanatory, so they are not covered here.

STEPS FOR UPS CONFIGURATION

1. Under the UPS section, set ‘Enabled’ to Yes.
2. The ‘UPS type’ must be set to ‘United Parcel Service XML’.
3. If you are using Magento 1.2.1+, the ‘Enable Negotiated Rates’ and ‘Shipper Number’ fields will currently be ignored, as this module was developer prior to their release. This will be fixed in a future version to utilize these settings.
4. Set the ‘Access license number’, ‘Userid’, and ‘Password’ fields to your UPS API account info. Note that the username and password are the same as you use to login to your acount on the UPS website.
5. Set the ‘Gateway XML URL’. For production this should be https://onlinetools.ups.com/ups.app/xml/Rate. You should be able to hit this URL fine in development mode as well if you have a valid account.
6. Set the ‘Tracking XML URL’. For production this is https://onlinetools.ups.com/ups.app/xml/Track.
7. Set the ‘Shipping XML URL’. The production value is https://onlinetools.ups.com/ups.app/xml/. For development use https://wwwcie.ups.com/ups.app/xml/ShipConfirm
8. Set the ‘Origin of the shipment’ value.
9. Set the ‘Shipper Attention’ to the name you want to appear on the shipment as the Shipper.
10. Select the desired ‘Pickup Method’. This extension has been validated to work with ‘Regular Daily Pickup’

The rest of the UPS settings should be self explanatory so they are not covered here.

ACCESSING THE ORDERSHIP INTERFACE IN THE ADMIN

The ordership interface can be accessed at the following url http://yoursite.com/ordership. This is accessible through the ‘Ship Orders’ button that exists on the Sales->Orders page, or by clicking the ‘Autoship’ button on the order details page. Using the ‘Autoship’ button will pre-populate the order increment id into the interface.

Entering the order increment id and clicking ‘Retrieve Order’ will display the order details and shipping options. You can then configure packages and which items and quantities from the order will ship in each. The default will set all outstanding items to ship in a single package. Once you have configured this to your liking, click the ‘Create Shipment’ button to submit the shipment and the tracking numbers and shipping labels. You will be notified of success and links and a button will appear to view the shipping label PDFs. They will be in 4"x6" standard label size and are best printed on a shipping label printer which you can obtain from your carrier.

Once you have printed the labels and affixed them to your packages, they are ready to ship. The tracking info and package data will be written back into Magento. Shipped orders will now contain ‘Shipments’ that can be viewed from the order details page. Tracking numbers are activated when the carrier initially scans the package.

HI,
I have been waiting for this from the day I heard of Mageto.
I was hoping you can point me in the direction on installing Imagick for the installer says its missing.

Thanks
Yitzy

The steps to do this will depend on your server OS. Googling something like ‘install php Imagick, Ubuntu’ or whatever your OS is will likely afford you a workable answer. If you have issues, you can try posting back here and someone can probably help you. My server runs Ubuntu, so I use aptitude to install the library and PHP extension.

I’m very excited about this module!!!

Shaaps:
login to your box
wget http://pecl.php.net/get/imagick-2.2.2.tgz
tar -zxvf imagick-2.2.2.tgz
cd imagick-2.2.2
phpize
./configure
make
make install

Edit you php.ini file to include the imagick.so file

restart apache

I’m going to get myself approved for the API ASAP so I can start giving feedback.

bott: Where would you like us to post the suggestions?

Please just go ahead and use the ‘Request New Feature’, ‘Report a Bug’, and ‘Discuss this Extension’ links from the Zenprint_Ordership extension details page: http://www.magentocommerce.com/extension/862/zenprint-api-shipping-module

Thanx I actually got my hosting comapny to take care of it, it was supposed to be standard setup either way with them.
FYI They are amazing service is excellent and speed for magento is from what I have seen unbeatable. www.Hostgator.com

Our hosting company used the extension key and installed the product but the only thing that was installed was the zenprint_xajax stuff not the ordership part.  Was there a 2nd extension key that we needed or did we do something wrong?

Thanks,
bc

I am trying to install the extension via SSH and getting the following message:

My command in ssh was: ./pear install magento-community/zenprint_ordership

Attempting to discover channel “magento-community"…
unknown channel “magento-community” in “magento-community/zenprint_ordership”
invalid package name/package file “magento-community/zenprint_ordership”
Cannot initialize ‘magento-community/zenprint_ordership’, invalid or missing package file
Package “magento-community/zenprint_ordership” is not valid
install failed

anyone else having this issue?

@bclark & @growstrong

After you have installed the zenprint_xajax extension, you will also need to install zenprint_ordership. It should have a separate extension key. The easiest way to do this is through the admin interface. Under ‘System->Magento Connect->Magento Connect Manager’ you can manage extensions that get installed via PEAR. Using this will ensure that the proper file system permissions and PEAR dependencies exist.

@growstrong, I’m not familiar enough with PEAR to know the exact cause of your error, but it appears to be an issue with how the PEAR repositories are setup. Have you tried installing it through the admin web interface? Perhaps it is even an issue with needing the proper extension key. I’ve never installed extensions from the command line, so I’m not sure.

Very cool.  I found the 2nd extension key.  I have asked our sys admin to install the imagick library and then the 2nd key.  When I looked up the keys a couple days ago, I could only find the xajax one and assumed it would it install the whole kit.

Will post an update once my sys admin has installed the 2 remaining pieces.

Thanks,
bc

We installed all three components and it seemed like everything was working just as the document described.  Until
we received the following error after pushing the create shipment button:

Warning: simplexml_load_string() [function.simplexml-load-string]: Entity: line 1: parser error : Space required after the Public Identifier in /chroot/home/dinovite/dinovite.com/html/lib/Varien/Simplexml/Config.php on line 500

Anyone else have this problem or have any suggestions?

Thanks

bott - 16 February 2009 04:29 PM

@bclark & @growstrong

After you have installed the zenprint_xajax extension, you will also need to install zenprint_ordership. It should have a separate extension key. The easiest way to do this is through the admin interface. Under ‘System->Magento Connect->Magento Connect Manager’ you can manage extensions that get installed via PEAR. Using this will ensure that the proper file system permissions and PEAR dependencies exist.

@growstrong, I’m not familiar enough with PEAR to know the exact cause of your error, but it appears to be an issue with how the PEAR repositories are setup. Have you tried installing it through the admin web interface? Perhaps it is even an issue with needing the proper extension key. I’ve never installed extensions from the command line, so I’m not sure.

Thank you for the response… I will give it a shot through admincp… does the Imagix (spelling) have to be installed on the server before installing the extension?

Thanks in advance

@growstrong,

Yes Imagick will need to be installed on the server before you can install the extension. I’m pretty sure you will get a PEAR error otherwise.

bclark@dinovite.com - 17 February 2009 09:03 AM

We installed all three components and it seemed like everything was working just as the document described.  Until
we received the following error after pushing the create shipment button:

Warning: simplexml_load_string() [function.simplexml-load-string]: Entity: line 1: parser error : Space required after the Public Identifier in /chroot/home/dinovite/dinovite.com/html/lib/Varien/Simplexml/Config.php on line 500

Anyone else have this problem or have any suggestions?

Thanks

@bclark, I’ve not encountered this issue before. What OS are you running on? Is this Fedex or UPS? The simplexml classes are used for parsing XML, so I’m guessing it is an issue with either the XML request or response to the API. I would suggest debugging through the submission and response parsing to see if you can pinpoint where it is happening. It is possible it may be an issue with one of your configuration settings.

bott - 20 February 2009 11:50 AM

@growstrong,

Yes Imagick will need to be installed on the server before you can install the extension. I’m pretty sure you will get a PEAR error otherwise.

Great thank you for clarification… going to get this installed then give the extension install another try.  THANKS!

Hi

Thank you for this contribution, it is excellent unfortunately I am getting an error. I installed imagick on the server and then installed (via Magento Connect) both extensions in the order stated in your instructions

1. magento-community/Zenprint_Xajax
2. magento-community/Zenprint_Ordership

This worked perfectly, I then created an order on the site frontend and made payment (SSL Authorize.net) this worked perfectly… I then went to this newly created order in Admin Dashboard ---> Sales ---> Orders ---> View --->

All good so far… but when I then try to ---> Create Shipment ... I get this error

Notice: SoapClient::__doRequest() [soapclient.--dorequest]: Unable to find the wrapper “https” - did you forget to enable it when you configured PHP? in /home/someuser/public_html/app/code/community/Zenprint/Ordership/Model/Shipping/Carrier/Fedex.php on line 996

Line 996 contains

This is the SoapClient class http://www.php.net/manual/en/class.soapclient.php

Thank you again.

END

UPDATE:

I believe I need to get https into the Registered PHP Streams

I am not sure how to achieve this or even if this is indeed the desired fix… see here for stream wrapper info--->

http://no2.php.net/manual/en/function.stream-wrapper-register.php

END

UPDATE 2:

To fix the above error I recompiled php with OpenSSL, this resulted in the following (desired) phpinfo

PHPINFO:
Configure Command
‘./configure’ ‘--enable-bcmath’ ‘--enable-calendar’ ‘--enable-fastcgi’ ‘--enable-force-cgi-redirect’ ‘--enable-ftp’ ‘--enable-gd-native-ttf’ ‘--enable-libxml’ ‘--enable-magic-quotes’ ‘--enable-mbstring’ ‘--enable-pdo=shared’ ‘--enable-soap’ ‘--enable-sockets’ ‘--prefix=/usr’ ‘--with-curl=/opt/curlssl/’ ‘--with-freetype-dir=/usr’ ‘--with-gd’ ‘--with-jpeg-dir=/usr’ ‘--with-libexpat-dir=/usr’ ‘--with-libxml-dir=/opt/xml2’ ‘--with-libxml-dir=/opt/xml2/’ ‘--with-mcrypt=/opt/libmcrypt/’ ‘--with-mhash=/opt/mhash/’ ‘--with-mysql=/usr’ ‘--with-mysql-sock=/var/lib/mysql/mysql.sock’ ‘--with-openssl=/usr’ ‘--with-openssl-dir=/usr’ ‘--with-pdo-mysql=shared’ ‘--with-pdo-sqlite=shared’ ‘--with-png-dir=/usr’ ‘--with-pspell’ ‘--with-sqlite=shared’ ‘--with-ttf’ ‘--with-xmlrpc’ ‘--with-xpm-dir=/usr/X11R6’ ‘--with-xsl=/opt/xslt/’ ‘--with-zlib’ ‘--with-zlib-dir=/usr’

Registered PHP Streams php, file, data, http, ftp, compress.zlib, https, ftps
Registered Stream Socket Transports tcp, udp, unix, udg, ssl, sslv3, sslv2, tls
Registered Stream Filters string.rot13, string.toupper, string.tolower, string.strip_tags, convert.*, consumed, convert.iconv.*, zlib.*

All good so far, but when I again tried ---> Create Shipment ... I now get this error

ERROR: Authentication Failed

Can anyone advise please?

Thanks

END

File Attachments

Fedex.php  (File Size: 53KB - Downloads: 307)

 Signature 

Tablecloths