Download Integration Manual

bpost shipping manager Integration Manual
Table of Contents
1
Application modifications........................................................................................ 4
2
Glossary of Terms .................................................................................................... 5
3
Introduction ............................................................................................................ 6
3.1
Required knowledge ............................................................................................ 6
3.2
bpack Shipping Manager solution ........................................................................ 7
3.2.1
3.2.2
3.3
Four integration solutions .................................................................................... 9
3.3.1
3.3.2
3.3.3
3.3.4
3.4
4
Front End easy integration .............................................................................................. 9
Back End easy integration ............................................................................................... 9
Front End deep integration ............................................................................................. 9
Back End deep integration ............................................................................................ 10
Four integration scenarios.................................................................................. 10
3.4.1
3.4.2
3.4.3
3.4.4
3.5
Front End......................................................................................................................... 7
Back End .......................................................................................................................... 7
Scenario 1 – story line ................................................................................................... 11
Scenario 2 – story line ................................................................................................... 11
Scenario 3 – story line ................................................................................................... 12
Scenario 4 – story line ................................................................................................... 13
ICT Impact .......................................................................................................... 14
General configuration / Setup ............................................................................... 15
4.1
Logging in ........................................................................................................... 15
4.2
Configuration ..................................................................................................... 15
5
Front end integration ............................................................................................ 18
5.1
Parameters......................................................................................................... 18
5.1.1
5.1.2
5.1.3
5.1.4
HTTP POST parameters ................................................................................................. 18
Checksum ...................................................................................................................... 21
Order lines..................................................................................................................... 22
Delivery method overrides............................................................................................ 23
5.2
Sending parameters via HTTP POST ................................................................... 23
5.3
Showing the Front End pop-up ........................................................................... 24
5.4
Returned parameters ......................................................................................... 25
5.5
Confirming the order .......................................................................................... 27
5.6
Backup solution.................................................................................................. 27
5.7
Error codes ......................................................................................................... 27
6
Web Services ......................................................................................................... 29
6.1
Shipping API implementation ............................................................................. 29
6.1.1
6.1.2
REST............................................................................................................................... 29
Protocol......................................................................................................................... 29
Confidential | Copyright © 2011 by bpost. All rights reserved.
Version 2.0 | 9/08/2012
bpost, limited company under public law | Centre Monnaie, 1000 Brussels
VAT BE 0214.596.464 | Legal Entities Register Brussels | Postal Current Account
IBAN BE94 0000 0000 1414 | BIC BPOTBEB1
2 / 87