All the integration information you need as a developer is available from this page.- Click on any of the links in the table below to expand the information they contain. If you cannot find what you require here, try looking at our demonstration or don’t hesitate to contact us.
This information is broken down into 5 parts: All the integration information you need as a developer is available from this page. Click on any of the links in the table below to expand the information they contain. If you cannot find what you require here, try looking at our demonstration or don’t hesitate to contact us.
This information is broken down into 5 parts:
Part 1: Web services and how to use them
A Web Service is a software component that is described via WSDL and is capable of being accessed via standard network protocols such as but not limited to SOAP over HTTP, Web services typically run from web servers and are operating system independent. The only requirements are that your server can access the web service and that you can read and sent the XML formatted document that is sent over HTTP. Read all about the standards on w3c by going to http://www.w3.org/TR/wsdl
Part 2: Requirements for using the web service
• Open an account with Internet Express
• Register to use the web service and get a Website ID, Website e-mail address and password needed to create transactions!
Part 3: Links to the available web services on the Internet Express side
The SOAP Scema is described in that document. http://www.internetexpress.co.za/webservice/internetexpress.asmx
Part 4: Necessary workflow
There are 8 steps needed to use the courier system.
Step 1: You need the collection address with the corresponding internet express ID number. This is typically only done once and then saved on your own database or website. If you ship or sell your product from multiple locations you will need addresses for each one of those locations.
Step 2: You will need to provide front end functionality to allow for the delivery address. Internet Express allow delivery to Physical Address, Postnet counter, Post office and Post box. For each one the user will need to provide a Postal Code or a Suburb name. The functions available to do this is getStreetAddress, getPostNet, getPostalCounter and getPostalAddress. The partial address is returned and the user will need to provide his street name and house number to complete the address.
Step 3: Gather all other information necessary to create a quotation on the Internet Express server. This includes:
• Commodity item id using getCommodityItems and getProhibitedCommodityItems.
• The description of the goods that is going to be transported. Typed or stored in your database
• Insurance Value if insurance is given as an option to the client
• Collection detail including Name, Telephone area code and number, Cell number and contact email address.
• Delivery Details including Name, Telephone area code and number, Cell number and contact email address.
• Special instructions if needed.
Step 4: Create the quotation on the internet express side using all data gathered up to this point using EditAddDomesticQuote
Step 5: Add line items. Line items can be added in two ways. The first way is one by one using EditAddDomesticQuoteLineItem and the second way is to include many items in one call using AddDomesticQuoteLineItemRange.
Step 6: Return a list of service options for the user to select from using getDomestic- QuoteServices.
Step 7: Return the Selected option to the Internet Express quotation using EditAd- dDomesticQuote.
Step 8: After the client has paid run the completeDomesticQuoteUsingAccount functionality to complete the transaction.
Part 5: E.g. code C# .NET, e.g. script for 1 PHP Call view HTML/Text Version
Example code - C# .NET
Example script for one PHP Call view HTML or Text Version
|Internet Express has made a Web service available for developers who want to tap|
into this courier service. This means that your e-commerce server will access
functionality on the internet express web server to generate all courier related functions.
|This will provide you with real-time information and pricing for the delivery of your|
goods to your customer. The way you then display this information is entirely up to
you because your client only deals with your front end.
15 Aloe Field Crescent
Tel. (Office Hours)
031 579 1055
Cape Town Office
Aero Park, Unit 5
Tel. (Office Hours)
021 386 1552
021 386 1602
021 386 4818