Welcome to Cargonizer Agent
1
How to get started
www.logistra.no/
Cargonizer Agent is an application running trough Java
Web Start.
Because Logistra frequently releases new versions and
updates to its software, images shown in this book may
be different from what you see on your screen.
The Agent automatically updates at startup
© Logistra AS 2014 All rights reserved
Install Cargonizer Agent
Go to www.logistra.no. Under products you will find Cargonizer Agent
Select Download Cargonizer Agent
Java 8
Cargonizer Agent requires Java Runtime 8.
If you do not have Java 8, you will be prompted with a
Java download. Download and follow the java installation guide.
For extended java support, visit www.oracle.com/support
2
2
Meet agent
www.logistra.no/
First time startup: Sign in
The first time Cargonizer Agent is started, you will need to sign in with your API key and sender ID.
Your API key and sender ID is found under settings on www.cargonizer.no
Default language is English. Norwegian is supported
Agent: Main menu
Language settings
Support
Configure and
manage mapping
Create orders, open
orders from file or
postprocess orders
Monitor and
manage
background jobs
3
Agent mapping
www.logistra.no/
Agent: Mapping
Set up mapping file for all senders you administer. If you administer multiple senders, select wanted sender
from drop down list.
Settings
Mapping fields
Mapping: Settings
Required settings
•
•
Select type of datasource, XML , CSV-file or database
Set file location
Optional settings
•
•
Select Autostart batch job, if you want the Agent to automatically start looking for order files at
startup
Select Print service and select printer if you want automatic label printing
Mapping: XML settings
Required settings
•
File location for order files
Optional settings
•
Print service: Select printer for automatic label printing
Mapping: CSV – settings
Required settings
•
•
Select charset for file. Default is ISO-8859-1
Select or set custom «split by» for data source. Default is semicolon separated
Optional settings
•
•
•
•
•
Order number: If you want to be able to lookup an order manually trough order management
Interchange ref
Freight calculation: Freight estimation in the XML response file
Auto transfer EDI: Automatically transfer EDI to the carrier
Booking: Booking for consignment with the carrier
CVS mapping: How to map values
Mapping is divided into: Target, source, converted rules and default values
•
•
Target: Name of value in file
Source: Location of target in file
Target
Simple source definition
e.g: Name in source 0 – value of name is in place 0 in the file
Advanced source definitions
Name, address 1, address 2, zip code, city and country code in same source, 0. Separated by colon, file split by
e.g: semicolon. e.g: Name:address 1: address2:6300:Åndalsnes;
First 0 is the position of the value in the file. (:) indicates the split by inside given position. (3) the position of
the value inside the given value
CVS mapping: How to map values
Converted rules
Convert a value from file to a new valid value. Requires source value
Convert value to manually value
•
Rules are separate with ;
◦ e.g: convert zip code 777 to a valid zip code
Convert value to preset value
• e.g: 46 = Sweden
CVS mapping: How to map values
Default values
•
•
•
Values to be used if there is no value from data source
Do not require that source value
Choose from dropdown or set value manually
CVS mapping: Values to map
Required values
•
•
•
•
Consignee
Carrier
Product
Parcel
Optional values
•
•
•
•
•
•
•
•
•
•
Reference values
Other freight-payer
Abroad prepayment
Messages
Dangerous goods
Delivery point
Printer
Services
Order number
Interchange reference
Mapping: Database– settings
Required settings
•
•
Database setup
Mapping according to CVS mapping rules
Optional settings
•
•
•
•
Interchange ref
Freight calculation: Freight estimation in the XML response file
Auto transfer EDI: Automatically transfer EDI to the carrier
Booking: Booking for consignment with the carrier
Mapping: Database setup
Required settings
•
•
•
•
•
•
•
Databse driver
Host
Port
Databse
user name
password
Test connection
Optional settings
•
Instance
Mapping: Database setup - SQL
SQL settings
1.
2.
3.
4.
Add/remove SQL
Test SQL - replace where clause for
View result
OK to close SQL settings
4
Order management
www.logistra.no/
Order managemnt: Overview
Lookup order by order number or manually register an order
•
•
•
•
Look up an order by order number
Post process your order before saving
Edit parcel values directly in the table
All Required field are highlighted with orange
Required values
Consignee values
Product
Transport agreement – carrier
Product
Packages
Weight
Number for packages (default 1)
Optional values
References
Consignor
Consignee
Interchange
Message to carrier
Message to consignee
Freight payer
Product dependency
Booking
Carrier dependency
Auto transfer EDI
Freight calculation
Print service
Services
Product dependency
OM: Order lookup
•
Enter order number and click search
•
The form autocompletes with information from the consignment
OM: Manual registration
•
•
•
•
•
Select sender
Enter consignee info
Select transport agreement
Select product
Enter package details – add packages
Services
•
•
Product dependant
Required fields highlighted with orange
OM: Customer lookup
Customer lookup
•
•
Customer number lookup
◦ Enter customer number and information will auto fill part values
Customer name lookup
◦ Enter search criterias, press enter/press icon to search for customers and select
OM: Delivery points
MyPack delivery point lookup
•
•
Product dependant (PostNord MyPack)
Automatically selects the nearest delivery point
◦ Requires consignee zip code
•
Options to manually search and select delivery point
MyPack Delivery Point
OM: Freight Calculation and
packages
Freight calculation
•
Manual and automatic freight calculation
◦ Require packages details (weight or volume)
◦ Automatic freight calculation when updating a package information
Edit Packages details
•
•
Edit package details directly in the table
Freight price will automatically be updated
OM: Dangerous goods
Adding DGS
•
•
Option to add DGS is product dependant.
To add DGS, press DGS button before adding a package
•
UN Number is required field
•
Possible to use preloaded DGS (if pre-stored in Cargonizer)
Add dangerous goods
OM: Dangerous goods
Editing DGS
•
To edit DGS, press DGS-button on selected row
•
•
Edit DGS details directly in the table.
Options to add and remove DGS
Edit dangerous goods
5
Activity monitor
www.logistra.no/
Activity Monitor
Batch job controls
•
•
•
•
Manually start and stop batch jobs
Monitor batch activity through the batch job log console
Options to send logfile to Logistra
Option to clear the log