Book Contents

Book Index

Commercial Consignments

The Commercial Consignments module is used to record consignments, letters and collections that are executed by public carriers (e. g. PPL, DHL), eventually by a different way, e.g. internally. Further it is possible to execute a check of collections, and eventually to print labels for individual carriers.

Book Contents

Book Index

Services of Consignment

The book of Services of Consignment is used for setting your own numbering of consignments or parcels. Numbering stands for a number that is defined by a carrier for the combination of Country - Method of Transport - Payment Method. In most cases, carriers provide these numbering intervals for this combination. In situations where the numbering interval is not assigned for a particular country, method of transport, or payment method (it is general or reflects only some of the elements), you can set the services of a consignment in a way that the respective element is not taken into consideration during the search for optimal service of numbering consignments. It is done in the following way:

This number consists of a fixed part (a so-called prefix) and a changeable part that increases in value with every next consignment.

The record that is created in this book must be assigned to a specific Book of Consignment Services, where the records of consignments will be executed. Assign the created service to a specific defined book in the tab 3 - Definition of Services. Upon the creation of codes for a consignment (parcel), the right service for numbering will be searched for among the services assigned to the particular book (for more information, see the rule of combination Country - Method of Transport - Payment method stated above).

If you do not wish to continue using the service, you can confirm a particular record, or delete it from the Book of Consignment Services.

pic_2096

Picture: Mail services - book

Book Contents

Book Index

Basic Data (page 1)

On the 1st page of Consignment services there are all necessary data for correct setting of consignment numbering or package numbering. The user always works with information and values assigned by a particular carrier.

pic_2097

Picture: Consignment Services - basic data

Fields' Description:

Type

Type of service. According to the type, determine whether the numbering of consignments or packets should occur. The settings depends on the methodology of numbering at a specific carrier company - for more information, see the sub-chapters of Carriers - Settings Specifications.

No.

An ordinal number of a service in the book.

Method of Transport

The transport method of a consignment. The service for numbering will be searched for according to the method of transport. If you do not wish to take the method of transport into consideration, fill in " - " (a dash).

Payment Method

The payment method of a consignment. The service for numbering will be searched for according to the payment method. If you do not wish to take the payment method into consideration, fill in " - " (a dash).

Country

The country of a consignment (according to the address of the consignment's recipient). The service for numbering will be searched for according to the country. If you do not wish to take the country into consideration, leave the field empty.

Carrier

The field for the selection of a consignment's carrier. The user selects one from the book of Partners.

Expiration Date

Time validity for numbering consignments or packets. This date is linked to the notification of numbering depleting possibility.

URL for Following

A web address for monitoring the current status and movement of a consignment.

From

A floating part of a number for consignment numbering. It is the beginning of the time interval and it is added after the fixed part of number.

Current

The current number of a consignment in the time interval set in the From To fields.

To

A floating part of a number for consignment numbering. It is the end of the time interval and it is added after the fixed part of number.

Prefix

Prefix is the fixed part of a number for consignment numbering. Prefix is a number which expresses the interval in the From To fields. A created consignment thus always obtains a number code in the form of Prefix + number in the From To interval.

Notice

A field for setting notifications for depleting numbering interval. The entered value determines how many numbers before the end of the interval should be notified of the approaching expiration of the interval. To enable this function, you have to activate notifications and the option Expiration of Consignment Numbering.

Example: End of the interval is 100. Current number is 90. If the alert value is = 10, then when the code for package 91 is generated, the user receives a notification. In other words, the notification is activated when the difference between the end of the interval and the current number is less than the value entered in the Notification field.

Maximum Measures

No more than the maximum possible value of a consignment. These values are connected with the check during consignments creating and there is no possibility to create a consignment, which exceeds these values.

E-mail Contents

Contents of an e-mail for the customer whom the packet is delivered to. Text entered in this field is filled into the confirming e-mail automatically. E-mail is created for a customer e.g. via the Send E-mail from Collection script. You can edit the text, or set that the values from particular consignment fields can be filled into the created e-mail automatically.

If the user wants the value from the consignment field to appear in the text of an e-mail, they must enter the correct name of the corresponding field into brackets when entering their own text in the field E-mail Contents.

If you need to get to a service within a definition of service to package to a field from a consignment, you must use e.g. the link [ShipmentId;ParcelCode2].

Text entered e.g.: "Your number packet [ParcelCode2] has been sent.", will be filled into email as: "Your packet number 128562 has been sent." The value from the Consignment Code 2 field is always filled into the text.

It is also possible to make us of the continuity of these fields. If e.g. the following is entered in the URL for Following field: "www.ppl.cz/[ParcelCode2]", an URL address with a specific number of a consignment sent will be completed into the text. In this case it is necessary to insert [Service;URL] into the prepared text. This is way you can say that the value from Consignment Services from the URL for Following field should be filled into text.

Example

Entered text: "You can follow the consignment on [Service;URL] address." In a sent e-mail, it will manifest as the following: "You can follow the consignment on address www.ppl.cz/128562, if "www.ppl.cz/[ParcelCode2]" is entered in the URL for Following.

Created

Name of the user who created a record.

Changed

Name of the user who changed a record.

For You can add any types of notes toConsignment Services; you can also use Header Text or Footer Text. Further work description with The notes is listed in chapter Basic Code Lists and Supporting Modules K2 – Notes.

Book Contents

Book Index

Consignments

The book of Consignments is important for recording all consignments and packets sent. The list of all consignments is mentioned on page 0  in this book. Individual packets are the items of consignments. One consignment can obtain several packets (articles that belong to each other are wrapped individually, but they are sent as one consignment).

pic_2098

Picture: Consignments - book

Creating Consignments

You can create consignments via the Ins key manually without any default link to Sale documents.

You can also create consignments and packets directly from Sales Orders or subordinate documents via the Create Consignments script ("ParcelCreate.pas"). The description of the script is in a document called Catalogue of Scripts.

Consignments and packets may be created directly from page 0 from the book of Delivery Notes by means of the Ctrl+B keys. A consignment and a packet is created either to a Delivery Note that is currently selected by the cursor, to documents in a container, or to documents marked by an asterisk. Values from a consignment heading will be taken from the first document in case they are run over more delivery notes. A consignment is automatically created in the Book of Consignment Services according to the assignment of Consignment Services in this book. A created consignment will be saved automatically. If the user uses the Shift+B key combination on a Delivery Note that is already assigned to a consignment, they will be switched to this consignment.

In the book of Delivery Notes, the columns 'CFIDParcel' and 'CBParcel' are available for the user. There the user can add columns to page 0 of the book of Delivery Notes. Two bitmaps are connected with the "CBParcel" column. If there is an  Icon pic_366i in this column for a specific delivery note, this delivery note is part of a package that has already been confirmed at least once. The icon pic_367i means that this delivery note is part of an unconfirmed package and the icon pic_561i means that the delivery note is part of a free package. In the "CFIDParcel" column, a number of a packet to which a respective Delivery Note is assigned to is written. There is also the 'BFRepackedParcel' column available in the book of Delivery Notes. This column is important for an identification of a "repacked" packet. If a Delivery Note is a part of repacked packet, the column will display the icon pic_541i A Delivery Note marked this way is a part of more than one packet, and these packets are in the status of Cancelled or Unpacked.

Confirming Consignments

Double confirmation is available for the records in this book. First confirmation generates codes for packets and consignments. Userwise, the first confirmation means that a consignment is closed, i.e. a packet is packed and ready for e.g. label sticking. After the first confirmation, you cannot insert any other packets into a consignment and you can only edit some fields. The first confirmation always automatically confirms all packets (or Delivery Notes). You cannot undo the confirmation of Delivery Notes to an already confirmed consignment. The user can assign a confirmed consignment to a requested Collection. After the first confirmation, a consignment will be marked with the icon pic_740i

Second confirmation can only be made after assigning the consignment to a Collection. The second confirmation of a consignment is also done automatically by confirming the Collection for a second time. After the second confirmation, a consignment will be marked with the icon pic_741i

Note: Only users with the Administrator - General - Service Operations right can undo the confirmation of a packet after the second confirmation. The user should not make any changes that would change the contents of packet. Any change made to a Delivery Note would not be transferred to either consignments or packets, and the user must do so manually. This service right is important for additional editing of invoices.

Book Contents

Book Index

Basic Data (page 1)

The 1st page of Consignments provides data about the whole consignment. There you can find information about the sender of the consignment, its addressee, information about the payment method and the method of transport, and also the sums of some values and prices from individual packets of the consignment are stated there.

pic_2108

Picture: Consignments - basic data

Fields' Description:

Document Number

Number, business year and book of a document.

Description

An arbitrary description for distinguishing individual consignments.

Consignor

The name of the employee who sent the consignment. The field is a reference to the list of Contact persons. In this field a contact person is set by default upon a consignment creation. It is set in parameters as a Own contact person.

Sent

Date of mail sending.

Status

Mail status. The user chooses from a code list of defined statuses. You can add more records to this code list any time.

Carrier

The field for a selection of a consignment's carrier. The user selects one from the book of Partners. In The Mode of Transport book, the filter will be created after selecting a carrier (partner).

Method of Transport

The transport method of a consignment. The offer is limited by carrier selection.

Payment Method

The method of payment.

Service

Consignment service, which gives number to a consignment and which refers to it. The filed cannot be edited.

Cash on Delivery

COD will be calculated by the activation of this option. In the case of COD, there must be an Invoice added to the consignment. The value of COD will be completed by the Remaining Amount from this Invoice. It is not possible to confirm the consignment if an Invoice is not added.

The option is automatically activated according to the payment method (the option Cash on Delivery in the record of the Payment Method) when you create a consignment by means of the Create Consignment script, or by using the Ctrl+B keys from the book of Delivery Notes.

Cash on Delivery in Currency

In this field, the currency and COD will be calculated in the currency of the added Invoice.

Cash on Delivery

A fee for the COD service.

Category

Category of mail. You can choose from a pre-defined code list that contains basic carrier services for a specification of a consignment. You can add more records to this code list any time. The offer of consignment services is filtered according to the settings in the consignment configuration.

Generate Code

After the first confirmation of a consignment, numbers will be generated in the fields Consignment Code 1 to Consignment Code 4, depending on the specific carrier that is supported by standard. The Generate Code field is active by default.

When you confirm a consignment, the program is trying to find a service which meets the requirements of the Method of Transport, Payment Method and the Country written on the consignment. If there is no concordance, the consignment will not be confirmed.

If the user wants to confirm a consignment without generating the codes, the field Generate Code should not be checked.

Generated codes cannot be changed afterwards.

Addressee, Consignor

The user enters a Consignor and an Addressee here. It is possible to select them from the book of Partners, Suppl/Cust., or Contact Persons. The Partner and Suppl./Cust. Fields are interlinked. You can create a contact person regardless of any links to a partner. When creating a consignment from the documents of Sale, a contact person will be filled in from a respective Sales Order.

Address (in Addressee part)

A contact address of a consignment's addressee will be completed from an address entered in the document when creating a consignment from Delivery Notes (Ctrl+B), and if there is no such address entered, it will be completed with the address of the carrier in the Delivery Note. The rules for loading an address when creating consignments from Sales Orders via the Create Consignments script are described in the Catalogue of Scripts.

The address can be also selected from the list of addresses according to the entered addressee via the Known Addresses button (in the Change mode). The address may be entered manually as well. You can delete an address with the Deletion button (in the Change mode).

Attention: If you change an addressee, then the address will not be changed automatically. Required address is necessary to select exactly by means of Famous Addresses button.

Telephone, E-mail (section Addressee)

Contact data of a consignment's addressee.

When creating consignments from Delivery Notes via the Ctrl+B keys, a telephone / e-mail will be transferred only if it is set in the free delivery address in a Delivery Note.

When creating consignments via the Create Consignments script, it will be completed according to the set parameters of the script (a detailed description is provided in the Catalogue of Scripts).

Consignor

The function of button is to display the consignor address.

Consignor address

Consignor address is displayed by means of Consignor button. This address is loaded from a Branch set in the Book of Consignment Services by default. A Branch Office Name will be filled into the field Name in the address.

The address can also be selected from the list of addresses according to the entered addressee by means of the Known Addresses button (in the Change mode). The address may be entered manually as well. You can delete an address with the Deletion button (in the Change mode). Attention: If you change an addressee, the address will not be changed automatically. Required address is necessary to select exactly by means of Famous Addresses button.

Known Addresses

Button for selection of an address. After pressing it, a list of all addresses of a selected Partner, Contact Person and a Suppl./Cust. will be displayed. The button is available only in the Change mode.

Telephone, E-mail (section Consignor)

Contact data about a consignment's consignor.

When creating a consignment via the Create Consignment script, it will be filled in according to the settings of parameters of the "EAddressTypeAbbrEmail" and the "EAddressTypeAbbrPhone" scripts from the contact data of a Branch Office (set in the Book of Consignment Services).

Bank Connection

The button for field displaying, for bank account assigning, for invoices, or for numbering of some values of a consignment.

Invoice

The field for selecting an Invoice to be added to a consignment. If a consignment is sent as COD, i.e. COD field is checked, then it is a compulsory field.

Variable Symbol

Variable symbol It is filled from an Invoice connected with a consignment.

Service Price

The price of a service used (e.g. a price for traffic). By default, the field is filled only during mail order communication with PPL and an active request for automatic filling of this field. Detailed description in the Script Catalog for the script Setting parameters for communication with PPL (MyApi).

Consignment Value

Total value of a consignment. The field represents the sum of the Gross price in the Client's currency of all consignment's packets. This field is default e.g. for the calculation of additional insurance of a consignment, and it can be rounded.

Price

The price of a consignment. The field represents the sum of the Gross price in the Client's currency of all consignment's packets.

Additional Insurance

This field is used to calculate the price of an additional insurance to a consignment.

Currency

A currency in which services are evaluated (i.e. applies to fields Service Price, Consignment Value, Price, Additional Insurance). It is filled in with a currency that is set in the Client parameter.

Bank account

A bank account. This field is a link to the Bank Account book, where you can find a list of all your accounts in all banks.

Codes

A button for the display of consignment codes (Code 1, Code 2, Officer, Cost Centre, Consignment Code) - enables user differentiation of a consignment.

Dimensions

Consignment parameters (Weight, Length, Width, Height, Number of Pallets). The Handling Unit field is also available in universal forms. Used for pallet transport.

Created

The name of the employee who created the document.

Changed

The date and name of the employee who made the last change of the document.

It It is possible to add tasks and any type of notes to Consignments. You can also use Header Text or Footer Text. Further work description with The notes is listed in chapter Basic Code Lists and Supporting Modules K2 – Notes.

Book Contents

Book Index

Items (page 2)

On the 2nd page there are all items of a consignment, i.e. its particular packets.

pic_2117

Picture: Consignments - Items

The heading of the page contains all information about a whole consignment.

In the middle there is a list of all Packets which belong to this consignment. The lower part of the Articles in Packet form states the articles which belong to the consignment's packet. There is always a list of articles of this packet on which the light indicator is positioned. This part of the form is used only for display. The items of the packet cannot be changed. Each packet represents one Delivery Note, i.e. the list of articles in the packet equals the items of a specific Delivery Note. If the user wants to change the packet in some way, e.g. to add some items, they must change the Delivery Note.

Add the already existing packets into the consignment from the book of Packets via the F7 key. You can detach a packet from the consignment via the Shift+Delete keys in the Change mode.

Packet Statuses

Each packet is usually in a specific status. This state is available in the column Status on the 2nd page of a consignment, or after clicking on a particular packet in the Status field. The value of this field changes automatically after individual tasks during the work with consignments. Besides statuses that are set automatically, you can add other statuses to packets by means of a standard script called Change Packet Status.

Packet Statuses:

Open

The default state for a newly created packet.

Wrapped

Confirming a consignment will automatically confirm its Delivery Note and the packet status will change to Wrapped.

Ready to Send

The status after the packet is added to a collection.

Checked

The packet was checked before sending. This status is adjusted by a standard script Check Packets in Collection.

Sent

The packet is added to a double confirmed collection.

Following statuses can be adjusted according to the script Change Packet Status.

Delivery Attempt

Information from a carrier. Unsuccessful attempt to deliver the consignment to a customer.

Ready for Pickup

Delivered to a delivery point.

Cancelled

A cancelled packet (cannot be added to any collection). In this situation the packet is separated from its Delivery Note and then you can create a new packet from that Delivery Note (and add it e.g. to another consignment).

Send Back

The customer has not picked the consignment up.

On the Way Back

The packet has been sent back.

Refused to Take Over

The addressee refused to accept the packet (e.g. a damaged packet).

Returned

Information from a carrier. Delivered back.

Undelivered

The packet was not delivered successfully.

Delivered

Information from a carrier. The customer accepted the consignment.

Unpacked

The packet is was unpacked after it has been delivered back. In this situation the packet is separated from its Delivery Note and then you can create a new packet from that Delivery Note (and add it e.g. to another consignment).

pic_2267

Picture: Packet Statuses

Book Contents

Book Index

Documents (page 9)

On the 9 th document page Bulk posting form is possible same as in other documents in IS K2 inserting documents or processes. Further work description with This page is listed in the chapter Basic Code Lists and Supporting Modules K2 – 9th Page.)

Book Contents

Book Index

Functions over Consignments

F7

Insert a consignment into a Collection (page 0). Only consignments with the first confirmation may be added to a Collection.

Ctrl+F7

Services for a consignment. Opening them in the Change mode over the page 1 allows you to define / edit the services for a consignment. When in the Change mode over the page 0 or 1, you can only display the services saved for a consignment.

Book Contents

Book Index

Collections

Collections represent a list of packets that are ready to be collected by a carrier. The list of all executed Collections is in the book of Collections.

pic_2120

Picture: Collections - book

Packets are the items of Collections. Individual parcels added to Collections via Sales Orders. When creating an Order for a Collection, the staff will use the information from these created Collections. Double confirmation of records is also available in the book of Collections. To collection after first confirmation (pic_740i),other packaging cannot be add, you can only enter some of the fields in the document's header. The first confirmation means that the packets are prepared to be sent in the expedition, and a requested check may take place. The staff will perform a physical check, making sure that the articles in the expedition correspond to the articles in the Collection. For the purposes of the check, a warehouseman may use a report that will display and print a list of all packets located in the Collection. To further check the Collections, the user may use the Collection Check script.

Second confirmation of collection(pic_741i) means that the packet has been taken by the carrier. If all packets of a consignment have been completed, i.e. all Collections have left or have been cancelled, the second confirmation of a Collection will automatically confirm its consignment as well. After the second confirmation, you may also run scripts for the export of data sentences for carriers over the Collections.

Book Contents

Book Index

Basic Data (page 1)

The 1st page of Collections states the basic data. This information forms the heading of a document and relates to the whole Collection.

pic_2123

Picture: Collections - basic data

Fields' Description:

Document Number

Number, business year and book of a document.

Carrier

The field for a selection of a consignment's carrier. The user selects one from the book of Partners. After choosing a carrier, a Selection in the book of Contact Persons will be created, where only the contact persons of this partner will be located.

Driver

A carrier's driver who picks up a consignment. The field is a link into the Contact Persons book. The partner of a specific person will be automatically filled into the Carrier field after you select an appropriate contact person.

Date From

The date is a start from when the staff can prepare a Collection and add packets to it.

Date To

The date is a limit till when the staff can prepare a Collection and add packets to it.

Description

Any description used to distinguish particular consignments.

Created

The date and the name of an employee who created the order.

Changed

The date and name of the employee who made the last change of the document.

It is possible to add any notes to Collections, and you can also use Header Text or Footer Text. Further work description with The notes is listed in chapter Basic Code Lists and Supporting Modules K2 – Notes.

Book Contents

Book Index

Items (page 2)

On the 2nd page, all items of the Collections are displayed. This represents a physical list of all assigned packets.

pic_2124

Picture: Collections - items

Assign packets to a Collection via consignments from the book of Consignments, using F7. The already existing packets may be removed from a Collection in the Change mode with the key combination Shift+Delete.

Book Contents

Book Index

Documents (page 9)

On the 9 th document page Collection is possible same as in other documents in IS K2 inserting documents or processes. Further work description with This page is listed in the chapter Basic Code Lists and Supporting Modules K2 – 9th Page.)

Book Contents

Book Index

Packets

The Packets book is a list of all created packets.

pic_2264

Picture: Packets - book

The user can use this book for a better overview and for easier search for packets by their codes within all consignments.

The user can create and change the so-called free packets (i.e. packets without a consignment), and then connect them individually or in bulk to a consignment via the F7 function. The moment the packet is added to second time confirmed consignment, it cannot changed anymore.

A free packet may be created with the Insert key and then added to a Delivery Note. Free packets may be inserted directly from the book of Delivery Notes via the Shift+B keys. The function is launched on page 0 and the packet is created for a Delivery Note where the cursor is currently set on. The user can adjust and save the field of a packet afterwards. If the user uses the Shift+B key combination on a Delivery Note that is already added to some free packets, they will just be switched to this packet.

If a packet already has a matched numbering service, the consignment codes can no longer be changed. To change the code or the Delivery Note, the user must CANCEL the packet, create a new one, and generate or enter new codes.

In the book of Delivery Notes, the columns 'CFIDParcel' and 'CBParcel' are available for the user. There the user can add columns to page 0 of the book of Delivery Notes. Two bitmaps are connected with the "CBParcel" column. If there is an Icon pic_366i in this column for a specific delivery note, this delivery note is part of a package that has already been confirmed at least once. The icon pic_367i means that this delivery note is part of an unconfirmed package and the icon pic_561i means that the delivery note is part of a free package. In the "CFIDParcel" column, a number of a packet to which a respective Delivery Note is assigned to is written. There is also the 'BFRepackedParcel' column available in the book of Delivery Notes. This column is important for an identification of a "repacked" packet. If a Delivery Note is a part of repacked packet, the column will display the icon pic_541i A Delivery Note marked this way is a part of more than one packet, and these packets are in the status of Cancelled or Unpacked.

Book Contents

Book Index

Basic Data (page 1)

On the 1st page of the book of Packets there is basic information about a particular packet.

pic_2266

Picture: Packets - basic data

In the upper part of the form on the 1st page of the book of Packets, basic information about a particular packet is stated.

Fields' Description:

Consignment

Consignment number where the packet is added to.

Delivery Note

Package number of receipt card.

Method of Transport

Method of Transport automatically filled from receipt card.

Payment Method

Payment method automatically filled from receipt card.

Customer

Customer automatically filled from receipt card.

Customer Address

Customer Address automatically filled from receipt card.

Collection

Collections number where the packet is added to.

Value

Packet value (usually used for an insurance of packets). This amount may differ from the actual price of packet.

Price

Packet price for a price determination of COD.

Weight

Weight of a packet.

Length, Width, Height

Basic dimensions of a packet.

Handling unit

Used for pallet transport. Field is available for user only in Universal forms.

Status

Current status of a packet. This field will be automatically filled with a value from the previously defined code number of statuses during the work with the consignment system.

Service

A service according to which the packet codes are generated will be filled into this field.

Packet Codes

Fields where the packet codes are generated after consignment confirmation according to the service settings.

Status for monitoring

Only in Universal Forms. The last state of the package, in which it is located according to the information from the carrier. It is filled in using the Balíkobot - consignment status script and further on the basis of the user definition of status abbreviations in the Balíkobot - carrier settings script. The status of the first package of the consignment is also displayed in the consignment - in the right preview panel. The status of the package is also displayed in the right preview panel on the bound delivery note.

Address for monitoring

Only in Universal Forms. After sending the shipment data to the Balíkobot (first confirmation of the shipment), the tracking address of the package is stored in each package - a link to the page of the relevant carrier. It is also available in the right preview pannel. The address from the first package of the shipment is also displayed in the Consignments, and only in the right preview panel. The data is also displayed for the bound delivery note, again in the right preview panel.

The lower part of the Articles in Packet form displays a list of all articles belonging to the given packet. Pressing Enter on any article will open the Sale Item form with detailed information about the articles in the packet.

Book Contents

Book Index

Ext. Documents (9th Page) - Packets

On the 9 th document page Packaging is possible same as in other documents in IS K2 inserting documents or processes. Further work description with This page is listed in the chapter Basic Code Lists and Supporting Modules K2 – 9th Page.)

Book Contents

Book Index

Consignment Configuration

Consignment Configuration is a part of Business Consignments in the K2 IS. This configuration is determined for the settings of services of individual carriers, the settings of methods of transport, or the method of numbering consignments. You can also set there the path to databases provided by carriers. When activating the configuration, the List of Consignment Configurations form is displayed.

pic_2147.png

Picture: The List of Consignment Configurations form

The list of carriers that are used by the company is stated in the form, i.e. a list of all configurations for these carriers. Insert a new item with the Ins key. After pressing this key, a form with several items is displayed. It is possible to execute the configuration of services of the carrier in the form. The same form is also displayed after pressing the Enter key on an already created record.

Book Contents

Book Index

Configuration

The first folder of Configuration serves for a determination of a particular carrier that the user makes a configuration for.

pic_2156

Picture: The Configuration tab

Fields' Description:

Carrier

The field for selection of a consignment's carrier. The user chooses from the Partners code list, where an appropriate carrier must be added.

Carrier Abbreviation

Carrier abbreviation.

Customer Id in Carrier

A number assigned by the carrier. It is usually used for access to web services.

Customer Code

Customer code for an export.

Depot

Enter the number of a carrier's depot into this field (if required).

Book Contents

Book Index

Services

The next tab - Services - is used for setting the services that are provided by a carrier and that are to be used.

pic_2157

Picture: The Services tab

A new item (service) is entered here with the Ins key. A form for the specification of the service will appear.

pic_2158

Picture: The List of Consignment Configurations form

Fields' Description:

Method of Transport

This field is meant for a method of transport within this service.

Service Code

An abbreviation or a code of the service.

Numbering Method

A numbering method of the service. The settings of a numbering method determine the generating of consignment codes that will be transported by this service. This concerns particularly Consignment Code 3 and Consignment Code 4. It defines the algorithm according to which the codes will be generated, or, as the case may be, which database table will be used upon the creation of these codes. This field is a reference to the Numbering Method code list.

Book Contents

Book Index

Consignment Category

The Consignment Category tab is used to select carrier services through which you can specify a consignment category. The selection is made from a pre-defined code list, which contains basic services of a given carrier. It is possible to enter next records to  this code list whenever. A consignment category set here may then be assigned to a specific consignment of a specific carrier (the field Category on the 1st page of the consignment).

Examples of Consignment Categories: The Czech Post - DE (Parcel Delivery To Hand + guaranteed delivery time)

Book Contents

Book Index

Code List

This tab is used for setting files with auxiliary information. Auxiliary files are used by scripts that generate individual consignment codes in the K2 IS. It deals e. g. with determination of whether Depots are set. Every item is defined by a Type of and a Path to the file. Insert a new item with the Ins key.

pic_2246

Picture: The Code List tab

Book Contents

Book Index

Save Consignment Configuration

Process No.: CRM013

Script Id: FCRM046

File: ShipCfgSave.pas

Script description: This script is used to export the consignment configuration into a "*.xml" file.

Address in the tree structure:

Parameters of script:

OutputPath

Parameter for defining the repository of exported target files.

With the use of this script, the user may export all settings of individual consignments for individual carries made in Consignment Configuration into a "*.xml" file. Always one "*xml" file is created to each record in Consignment Configuration, i.e. to each carrier, by means of this function. The consignment configuration may be exported to any repository, which must be defined by the OutputPath parameter. If not defined otherwise by the parameter, the files will be saved into K2\SupportFiles\Parcel.

The script for saving the consignment configuration may be run from every K2 book, but not directly in Consignment Configuration!

Book Contents

Book Index

Reports over Consignments

Book Contents

Book Index

DPD Label

Process No.: CRM013

Report ID: SCRM057

File: ParcelDPDLabel.am

Report description: Label printing for DPD service.

Address in the tree structure:

Report parameters:

FragileList - ' '

List of defined methods of transport for fragile packets.

ParcelId - 0

Packet number for print.

PayMeCard_DSC1 - ' '

A defined payment method for card payment. If the payment method is the same as the one on the consignment, the label will be printed with the payment method = 'Card Payment'.

PayMeCash_DSC1 - ' '

A defined payment method for payment in cash. If the payment method is the same as the one on the consignment, the label will be printed with the payment method = 'In Cash'.

ShowPayMet_DSC1 - No

Yes - payment method from a consignment will be displayed in the record.

ShowPrice_DSC1 - No

Yes - price will be displayed in the record (from a COD field).

ShowWarSym_DSC1 - No

Yes - variable symbol from a consignment will be displayed in a record.

ParcelDPDLabel

Book Contents

Book Index

PPL Label

Process No.: CRM013

Report ID: SCRM058

File: ParcellPPLLabel.am

Report description: Label printing for PPL service.

Address in the tree structure:

Report parameters:

FragileList

List of defined methods of transport for fragile packets.

NoteType_DSC1

A note type from whose text will appear in the report.

Parcelld

Packet number for print.

PPLDepoName_DSC1

A parameter for entering the name of a PPL depot from which the packet has been sent.

PPLDepoStreet_DSC1

A parameter for entering the address of a depot from which the packet has been sent.

PPLDepoTelFax_DSC1

A parameter for entering the phone number and fax of a depot from which the consignment has been sent.

PPLDepoWeb_DSC1

A parameter for entering the website address and e-mail of a depot from which the consignment has been sent.

PPLDepoZIP_DSC1

A parameter for entering the postal code and location of a depot from which the consignment has been sent.

ServiceName_DSC1

Name of a service.

ParcellPPLLabel

Book Contents

Book Index

Process No.:

Process No.: CRM013

Report ID: SCRM059

File: ParcellPPLSprintLabel.am

Report description: Label printing for the PPL Sprint service (New DHL freight). Reference no. (Sender's reference) on the label is the number of the package's Delivery Note.

Address in the tree structure:

Report parameters:

ParcelId - 0

Packet number for print. Enables to print a label for only one selected package from a consignment containing multiple packages. Enter the package's internal number (the 'Id' field).

ParcellPPLSprintLabel

Book Contents

Book Index

Czech Post Label

Process No.: CRM013

Report ID: SCRM063

File: ParcelCPLabel.am

Report description: Label printing for the Czech Post.

Address in the tree structure:

Report parameters:

PostingPost_DSC1

Parameter for assigning postal service code. The code assigned in this parameter is displayed over the bar code.

Parcelld

Packet number for print.

FragileList

List of defined methods of transport for fragile packets.

ParcelCPLabel

Book Contents

Book Index

List of Consignments

Process No.: CRM013

Report ID: SCRM060

File: ItemsList.am

Report description: The report shows a list of consignments with the possibility to display individual packages and their items. The report can be run in the Consignments book.

Address in the tree structure:

Report parameters:

ShowItems - No

Yes - the items of the consignment's packages are displayed in the report.

ShowPackage - No

Yes - the packages are displayed at individual consignments in the report.

Book Contents

Book Index

List of Packages

Process No.: CRM013

Report ID: SCRM061

File: PackageList.am

Report description: The report shows the list of packages with the possibility to display the items of these packages. You can run this report in the Packets book.

Address in the tree structure:

Report parameters:

ShowItems - No

Yes - the items of individual packages are displayed in the report.

GroupByShipment - No

Yes - sorting of packages according to their consignments.

PackageList

Book Contents

Book Index

List of Packages in Collection

Process No.: CRM013

Report ID: SCRM062

File: ListPackagesToCollection.am

Report description: The report displays a list of packages that are sorted by the Collection they are classified to. The packages of collections may be further sorted according to their consignments. With the use of this parameter, you can display also the items of packages. The report can be run in the Collections book.

Address in the tree structure:

Report parameters:

ShowItems - No

Yes - the items of individual packages of Collection are displayed in the report.

GroupByShipment - No

Yes - sorting of packages by consignments within individual Collections.

ListPackagesToCollection

Book Contents

Book Index

Czech post label 1

Process No.: CRM013

Report ID: SCRM069

File: ParcelCPLabel1.am

Report description: Label printing for the Czech Post.

Address in the tree structure:

Report parameters:

PostingLogo_DSC1 - 1

A logo displayed on the label.

1 - to hand, 2 - to post office, 2 - oversized , 3 - express.

Parcelld

Packet number for print.

FragileList

List of defined methods of transport for fragile packets.

MultiPieceShipmentService - Yes

This parameter defines how to print labels for multi-piece parcels. Yes - multi-piece parcels are respected, the label carries information about the consignment's main package. No - a separate label is printed for each package even in the case of multi-piece parcels (the label does not carry information stating that this is a multi-piece parcel). This does not apply to Cash on Delivery consignments.

Note: The same parameter is also in the script for creating a data sentence (Export file of the Czech Post type N) and must be set to the same value as in the label.

PostOfficeZipCode_DSC1 - ' '

Postal service code of the service post if it is different than the postal code of the sender's address.

ParcelCPLabel1

Book Contents

Book Index

List of Packages of Collection Without Bar Code

Process No.: CRM013

Report ID: SCRM064

File: ListOfPackagesWithoutBarCode.am

Report description: The report displays a list of packages that are sorted by the Collection they are classified to. The packages of collections may be further sorted according to their consignments. With the use of this parameter, you can display also the items of packages. It is not possible to display bar codes of Collection in this report. The report can be run in the Collectionsbook.

Address in the tree structure:

Report parameters:

ShowItems - No

Yes - the items of individual packages of Collection are displayed in the report.

GroupByShipment - No

Yes - sorting of packages by consignments within individual Collections.

Book Contents

Book Index

Packets - Bulk Posting Form

Process No.: CRM013

Report ID: SCRM065

File: ParcelFilingSheetNew.am

Report description: The print of Bulk Posting Form report for packages with pre-filled data. You can print this report in the books of bulk pick up, parcels and shipments. The "Cash on Delivery" column shows value from the Cash on Delivery field from the package, the "Value Stated" column shows value from the Consignment Value field.

Address in the tree structure:

Report parameters:

Code - 1

By means of this parameter, you can define the fields of packages (Package code 1 - 4) which the Posting Marks are pre-filled in from. 1 - Package code 1, 2 - Package code 2, 3 - Package code 3, 4 - Package code 4.

Submitter

Parameter for entering any text in the Submitter field.

OrderNumbers - No

Yes - the ordinal number will be added into the report.

ParcelFilingSheetNew

Book Contents

Book Index

Scripts, functions

Book Contents

Book Index

Export file of the Czech post of the N type

Process No.: CRM013

Script Id: FCRM050

File: ParcelCPExportN.pas

Script description: The script is important for the text file for consignment posting at the Czech post.

Address in the tree structure:

Parameters of script:

CashOnDeliveryServices - ' '

A parameter for services posting when you want to send a consignment with Cash on Delivery. It should be set equally as it should be printed on the package (e.g. 34+41). These services are written into data sentences for all consignments with Cash on Delivery.

Email_send - No

Sending an email with export file to a carrier. Yes - when you create an export file and close the protocol about its creation after, a query asking whether you wish to send the export file via an e-mail will appear.

Email_Address - ' '

Email address of a recipient.

Email_Subject - ' '

Email subject. In a default setting, the text “Data file + file name” will be filled into the subject of the message. If you enter your own text in the parameter and you want to display the name of the file, just use the alternative signs “%s”.

Email_Body - ' '

Text of the body of a message.

Email_CopyTo - ' '

Email address of the copy of a message.

Email_BCopyTo - ' '

Email address of the hidden copy of a message.

Email_EditMail - No

Yes - a message is not sent immediately, but the option for edit will appear.

MultiPieceShipmentService - Yes

Multi-piece Consignment Service. Yes - the service no. 70 is automatically added to multi-piece consignments in the data sentence. No - the service of a multi-piece consignment is not set, each consignment is considered as an individual one. This does not apply to consignments with Cash on Delivery - they are always treated as multi-piece consignments automatically by the service.

Note: The same parameter is also present in the reports of labels and must be set to the same value as in the script.

OutputPath - ' '

A parameter for setting the path to the searched text file repository location.

RequiredServices - ' '

Parameter for assigning of required services. It should be set equally as it should be printed on the package (e.g. 54+62). These services are written into data sentences for all consignments. The service no. 70 (multi-piece consignment) is assigned to multi-piece consignments by default. The service is further directed by the "MultiPieceShipmentService" parameter.

ShowLog - Yes

Yes - after you create a file, you will be informed about its creation and successful sending. No - no message or protocol will appear after creating a file.

The Czech Post supports data processing required for posting business consignments in an electronic way. Nowadays, it is possible to pass data on consignments in three different types of data files. These are I, K , N types of files, IS K2 supports the export into data file of N type. It enables posting of all products (even the newest ones).

This script always runs over a particular collection in the book of Collections and it creates the file for submission of business consignments. Final data file is a text file (ASCII) with fixed length of a data sentence.

This exported data file must be handed over to a data medium along with posted consignments at last.

Book Contents

Book Index

Carriers - Settings Specifications

Some settings, and sometimes even the program's behaviour, may differ during the creation of packets based on individual carriers for whom you prepare consignments. That is why we are going to bring attention to the specifications and differences of the program's settings for individual carriers in the following chapters.

Book Contents

Book Index

In Time

The settings and the behaviour of the Consignment module for carriers In Time differs from the standard settings in these points:

Communication with Server - Settings

Using the Set Parameters for Communication with IN TIME script (ParcelExportIntimeParams.pas) you can set parameters for the communication with the In Time company's server. The script can also pre-set the filling in of services to individual consignments for individual books of consignments. The description of the script is provided in the chapter Set Parameters for Communication with IN TIME.

Consignment Services

For the In Time company, set the Type field to "Consignment". Range of numbering (fields From - To) may be set arbitrary; however, the range must be sufficient for the amount of issued consignments and packets. This numbering range is not used for generating of the main code (main identification) of a consignment for the In Time company, but for the internal numbering within K2 (for more information, see field Consignment / Packet Code 1).

Consignment Numbering

The K2 program does not assign an identification code to an In Time consignment - this is done by the AZ application of a carrier. The same as with consignments for other carriers, the code will be assigned upon the confirmation of the consignment - in that moment, the K2 program will generate an XML file with information about the consignment, and will send it to the carrier's server. The server will generate a corresponding code and will return it to the K2 program. The consignment is saved into the AZ application (section "My Consignments", the status of the consignment is "Sent" = "No") and it is ready to be sent for further processing. If there are any problems with the communication, an error report will be sent back.

Consignment Code 1: This is an internal order number within the K2; it is set in the From / To interval defined in Consignment Services.

Consignment Code 2: This is the main identification code of a consignment and it is generated by a carrier; it is defined by the identification code of the customer and the order number assigned from the interval.

Consignment Code 3: This represents the number of packets that have already been processed in a consignment upon the request for a code generation being sent; these packets have already been assigned with a code.

Consignment Code 4: Not used.

Packet Code 1: This is an internal order number within the K2; it is set in the From / To interval defined in Consignment Services.

Packet Code 2: This is the main identification of a packet code, generated by a carrier; it is defined by the identification code of the customer + a service's letter + an order number from the assigned interval; the information about the number and order of colli within the consignment may be found behind the asterisk (example: 4V0S00000008*001003).

Packet Code 3 and 4: Not used.

Confirmation / Undo-Confirmation of Consignments

The confirmation of consignments has the same meaning as for consignments for other carriers - the document will be locked and a unique code will be generated for the consignment. The code, however, is not created by the K2 program - this is done by the server of a carrier (see the section Consignment Numbering above).

You can undo the confirmation of a consignment only if a consignment is saved in the InTime AZ application, and its status is "Sent" = "No". A consignment is always in this status after being confirmed (after its code has been generated). After a reconfirmation, any changes made will not reflect in the record of the "AZ InTime" application!

Sending Data from Collection

Consignments in the "AZ InTime" app must be assigned to batches. This defines them to be processed by a carrier. The batches may be created from loaded consignments directly in the "AZ InTime" app, or via the script Send Consignments to IN TIME (ParcelExportInTimeCompleteArticle.pas) in the K2 program, which may be run over a specific Collection to which the consignments are assigned. Script consignemts in “AZ InTime” will be moved to batches (status “Send” = “Pending, consignments are in section “My consignments batches”). After transferring the consignments to batched, you cannot undo the confirmation of Collection in the K2 program.

Book Contents

Book Index

Set Parameters for Communication with IN TIME

Process No.: CRM013

Script Id: FCRM

File: ParcelExportInTimeParams.pas

Script description: The script is used for saving the configuration for communication with servers of the In Time company. Enter the parameters in the initial form. The script may also be used to pre-set service performance for consignments.

Address in the tree structure: Logistics / Shipment Services / Settings and Configuration / Parameter Settings for Communication with IN TIME

Parameters of script:

URL Address of the AZ InTime app

An internet address for an application server that uses the XML protocol to communicate with the core of the "Consingments" app. Provided by the carrier.

Username for Accessing AZ InTime - ' '

A username for login to the AZ app; provided by the carrier.

Password for Accessing AZ InTime - ' '

A password provided by the carrier, the customer may change it later.

Import Successful Only If Successful For All Consignments - No

Yes - the import to AZ InTime will be successfully done only if it is successful for all consignments. No - the import will be done for each individual consignment.

Enter Consignment Weight - No

Yes - confirming a consignment will open a form for entering / correcting the weight of the consignment. The weight will be saved to the package. If a consignment contains multiple packages, the entered value will be divided by the number of packages; the average weight will be saved to each package. Based on the weight, an InTime product will be defined for the consignment (it is displayed on labels and transferred in the data sentence).

Enter Information to Additional Services - No

Yes - if a consignment has set additional services which enable adding additional notes (text), then after its saving a form for entering the additional information to these services will appear. The information will be added to a xml file sent to the carrier's server.

Using the Services button allows you to pre-set the services performance for consignments. Pre-set the services for individual Books of Consignments. Saving them in the K2 directory (K2\SupportFiles\Parcel\InTime) will create a file "InTimeAdditionalServices.xml".

Book Contents

Book Index

Send Consignments to IN TIME

Process No.: CRM013

Script Id: FCRM

File: ParcelExportInTimeCompleteArticle.pas

Script description: The script is run over a Collection and transfers the Collection's consignments to batches in the "AZ InTime" app. This defines the consignments for processing on the part of the carrier. (The script changes the consignment status in the app from "Sent" = "No" to "Sent" = "Waiting"; the consignments are transferred from the "My Consignments" section to the "My Consignment Batches").

Address in the tree structure:

Parameters of script:

Without parameters.

Book Contents

Book Index

DPD

Specifications and necessary settings for the DPD company.

Consignment Services

For the DPD company, set the Type field to "Packet".

Configuration

For a correct and complete print of information about the services of a consignment on a label, you must enter the DPD services in the configuration of the DPD carrier in Consignment Categories. This is done the same way as in the DEMO Client (texts and descriptions stated there are then used on the label). A label's print report supports only the services that are set in the DEMO Client.

Settings of Consignment Numbering

The number of a consignment is a 14-character + check numbers: DDDD x y LLLLLLLL p.

A carrier should assign their customer a 10-character number created by characters in the example "x y LLLLLLLL". However, if a carrier assigns the customer a whole 14-character number, the first four numbers must be ignored when entering the number string to the K2 program. The first four letters DDDD are a number identification of a collection depot. This information is ascertained by the K2 program itself, you do not need to enter it anywhere.) Split the rest of the 10-character number between the prefix and the numbering range in Consignment Services.

Book Contents

Book Index

The Czech Post
Marking Consignments By Time Zones (A, B)

K2 IS Settings:

According to the selected category, the label may be marked in the following ways:

The resulting service will be automatically written into the data file (created by the script Export File of The Czech Post Type N ("ParcelCPExportN.pas").

Book Contents

Book Index

Carriers - Implementation

Book Contents

Book Index

General Implementation of Consignment Services

Structure of Books

General steps to implement carriers:

Contract - agreement with a carrier

Data Settings in K2


Verification Process

When you finish with all settings, you may proceed to create data (consignments). Most carriers require a verification process before running the actual operation (communication), where they require the data and labels to be sent for all combinations that may occur (products, services, one-packet and multi-packet consignments, all payment methods).

Work with Consignments

1. Create Consignments

2 Confirmation of Consignments

3 st Label Printing

4 Assigning consignments to Collections and sending data to the carrier, alternatively ordering a Collection

Support of Supplementary Services

Services of carrier companies applied to particular consignments are saved into the XML field in the headers of consignments. This can be done via special scripts or by means of the Ctrl+F7 keys over the 1st page of consignments in the Change mode.

An overview of consignment services can be displayed on the form that is opened after pressing the Ctrl+F7 keys over page 0 or the 1st page in the Browse mode.

The is no support for services in Sale - this means that a Sales Order (e.g. from an e-shop) does not contain any information about its respective services. By default, services may be added after a Sales Order has been created.

Current versions support services for Geis Parcel, Geis Cargo, and In Time.

The solution for the COD - Cash on Delivery service is universal for all carrier companies. This service is handled by the Cash on Delivery option in a consignment's header - it is pre-set automatically based on the Cash on Delivery option in the Payment Method record.

Book Contents

Book Index

Implementation via DPD (through API)

Contract - Agreement - with a Carrier

Data Settings in K2

Abbreviation

Name

Description

101

D

 

109

D-COD

Cash on Delivery / C.O.D.

136

D

 

154

PARCELLetter

DPD PARCELLetter

155

PM2

DPD 18:00 / DPD GUARANTEE

161

PM2-COD

DPD 18:00 Cash on Delivery / DPD GUARANTEE C.O.D.

179

AM1

DPD 10:00

191

AM1-COD

DPD 10:00 Cash on Delivery / C.O.D.

225

AM2

DPD 12:00

237

AM2-COD

DPD 12:00 Cash on Delivery / C.O.D.

327

D-B2C

PRIVATE ADDRESS / B2C

329

D-B2C-COD

PRIVATE ADDRESS / B2C - C.O.D.

350

AM0

DPD 08:30

352

AM0-COD

DPD 08:30 Cash on Delivery / C.O.D.

839

D-EVE

EVENING DELIVERY 17:00-20:00

840

D-EVE

EVENING DELIVERY 17:00-20:00

841

D-COD-EVE

EVENING DELIVERY 17:00-20:00 CASH ON DELIVERY

842

D-COD-EVE

EVENING DELIVERY 17:00-20:00 CASH ON DELIVERY

Verification process and creating consignments

When you finish with all settings, you may proceed to create data (consignments). Most carriers require a verification process before running the actual operation (communication), where they require the data and labels to be sent for all combinations that may occur (products, services, one-packet and multi-packet consignments, all payment methods).

Book Contents

Book Index

PPL Sprint Label Implementation

Contract - Agreement - with a Carrier

Data Settings in K2

Verification process and creating consignments

When you finish with all settings, you may proceed to create data (consignments). Most carriers require a verification process before running the actual operation (communication), where they require the data and labels to be sent for all combinations that may occur (products, services, one-packet and multi-packet consignments, all payment methods).

Book Contents

Book Index

PPL Parcel Implementation

Contract - Agreement - with a Carrier

Data Settings in K2

  • PPL Parcel CZ Business
  • PPL Parcel CZ Private
  • PPL Export Package
  • PPL Parcel Connect
    • If the product is used in combination with the "Cash on Delivery" payment method, the "Cash On Delivery" text is automatically added behind the name of the product for the purpose of label printing.

Verification process and creating consignments

When you finish with all settings, you may proceed to create data (consignments). Most carriers require a verification process before running the actual operation (communication), where they require the data and labels to be sent for all combinations that may occur (products, services, one-packet and multi-packet consignments, all payment methods).

Book Contents

Book Index

Geis Cargo Implementation

Contract - Agreement - with a Carrier

Data Settings in K2

Verification process and creating consignments

When you finish with all settings, you may proceed to create data (consignments). Most carriers require a verification process before running the actual operation (communication), where they require the data and labels to be sent for all combinations that may occur (products, services, one-packet and multi-packet consignments, all payment methods).

Book Contents

Book Index

Geis Parcel Implementation

Contract - Agreement - with a Carrier

Data Settings in K2

Verification process and creating consignments

When you finish with all settings, you may proceed to create data (consignments). Most carriers require a verification process before running the actual operation (communication), where they require the data and labels to be sent for all combinations that may occur (products, services, one-packet and multi-packet consignments, all payment methods).

The number is then transferred from packages to the consignment.