Sales Invoice

From UG

(Difference between revisions)
Jump to: navigation, search
(SOW 6)
(Unit)
 
(13 intermediate revisions not shown)
Line 1: Line 1:
-
[[Category: AccSI&II]]
+
[[Category: Acc]]
== Info ==
== Info ==
Line 10: Line 10:
== Business Needs and Requirements ==
== Business Needs and Requirements ==
-
== Fields ==
+
== Component Description ==
=== Invoice Number ===
=== Invoice Number ===
Line 144: Line 144:
==== CC ====
==== CC ====
-
:* [http://mantis.jaguarfreight.com/wiki/Charge_Code_Admin Charge Code].
+
:* [http://wiki.jaguarfreight.com/wiki/Charge_Code_Admin Charge Code].
 +
 
 +
==== Unit ====
 +
 
 +
* Full list of the Units (in ''Quantity (Unit Type)'' format) contains:
 +
:* '''1 (FLAT)''' (default Quantity (Qty) = '''1'''). Note: ''per Marc,'' farely vague description which basically means "no accurate unit available to describe this charge" -> very useful in our industry)
 +
:* '''1 (MIN)''' (Minimum Charge, default Qty = '''1''')
 +
:* '''1 (MAX)''' (Maximum Charge, default Qty = '''1''')
 +
:* '''Total Gross Weight (KG)''' (default Qty = [http://wiki.jaguarfreight.com/wiki/Commodity#Grand_Total:_Gross_Kg Grand Total: Gross Kg])
 +
:* '''Total Gross Weight (LB)''' (default Qty = [http://wiki.jaguarfreight.com/wiki/Commodity#Grand_Total:_Gross_Lb Grand Total: Gross Lb])
 +
:* '''Total Cubic Meters (CBM)''' (default Qty = [http://wiki.jaguarfreight.com/wiki/Commodity#Grand_Total:_cbm Grand Total: cbm])
 +
:* '''Total Cubic Feet (CFT)''' (default Qty = conversion of [http://wiki.jaguarfreight.com/wiki/Commodity#Grand_Total:_cbm Grand Total: cbm])
 +
:* '''Chargeable Weight (CWT KG)''' (default Qty = [http://wiki.jaguarfreight.com/wiki/Chargeable_weight Chargeable weight] (AIR))
 +
:* '''Containers Count (CNTR)''' (For FCL charges, default Qty = '''Containers Count''', including Distribution by Containers)
 +
:* '''Pallets Count (PLTS)''' (default Qty = [http://wiki.jaguarfreight.com/wiki/Commodity#Grand_Total:_Plts Grand Total: Plts])
 +
:* '''Total Packages Count (CARTONS)''' (default Qty = '''Grand Total: AMS''' = [http://wiki.jaguarfreight.com/wiki/Commodity#Grand_Total:_Pkgs_On_Plts Grand Total: Pkgs On Plts] + [http://wiki.jaguarfreight.com/wiki/Commodity#Grand_Total:_Loose_Pkgs Grand Total: Loose Pkgs])
 +
:* '''CT Count (SHPT)''' (Shipment, default Qty = '''CT Count''')
 +
:* '''Documents Count (DOCS)''' (CT Count, default Qty = '''CT Count''')
 +
:* '''Customs Clearance (CUSTOMS)''' (Customs Formalities / Customs Declaration, default Qty = '''1''')
 +
:* '''0 (%)''' - (Percentage, default Qty = '''0''' and user must specify QTY)
 +
 
 +
For Group case, default Qty is a sum of appropriate values from:
 +
:1) CTs that were selected for invoicing - '''Inv tab'''.
 +
:2) all grouped CTs - '''Est tab'''.
 +
 
 +
==== DC ====
==== CC Description ====
==== CC Description ====
Line 224: Line 249:
=== Group Generate ===
=== Group Generate ===
 +
[[File:InvoiceGroupGenerate.gif|thumb|Figure:Invoice Group Generate]]
[[File:InvoiceGroupGenerate.gif|thumb|Figure:Invoice Group Generate]]
In case of [[group generate]] ''(when Invoice is generated from CT which is a part of group)'' the user gets the ability to include an info of each grouped CT to Invoice. System shows the selection window that works exactly the same as in [[group generate]] case for any [http://mantis.jaguarfreight.com/wiki/Category:OpsPdfs PDF]. After user's choice ''(in checkboxes)'' the Invoice template should contain an aggregate info from one or multiple CTs.
In case of [[group generate]] ''(when Invoice is generated from CT which is a part of group)'' the user gets the ability to include an info of each grouped CT to Invoice. System shows the selection window that works exactly the same as in [[group generate]] case for any [http://mantis.jaguarfreight.com/wiki/Category:OpsPdfs PDF]. After user's choice ''(in checkboxes)'' the Invoice template should contain an aggregate info from one or multiple CTs.
Line 444: Line 470:
=== SOW 6 ===
=== SOW 6 ===
 +
 +
'''SPEC UPDATED'''
 +
Mantis '''[http://ct.jaguarfreight.com/mantis/view.php?id=4343 0004343]: ''' (Sales Invoice) Unit related redesign for Table Of Charges
Mantis '''[http://ct.jaguarfreight.com/mantis/view.php?id=4343 0004343]: ''' (Sales Invoice) Unit related redesign for Table Of Charges
Line 456: Line 485:
==== Solution ====
==== Solution ====
-
* Full list of the Units contains:
+
See [[#Unit]]
-
:* 1 Flat
+
-
::* Definition - Flat (''per Marc,'' farely vague description which basically means "no accurate unit available to describe this charge" -> very useful in our industry)
+
-
::* label - "FLAT", default Quantity (Qty) = 1
+
-
:* 1 Min - (Minimum Charge, label - "MIN", default Qty = 1)
+
-
:* 1 Max - (Maximum Charge, label - "MAX", default Qty = 1)
+
-
:* Total Gross Weight (Kg) - (mapped to [http://wiki.jaguarfreight.com/wiki/Commodity#Grand_Total:_Gross_Kg Grand Total: Gross Kg], label - "KG", default Qty = 1)
+
-
:* Total Gross Weight (Lb) - (mapped to [http://wiki.jaguarfreight.com/wiki/Commodity#Grand_Total:_Gross_Lb Grand Total: Gross Lb], label - "LB", default Qty = 1)
+
-
:* Total Cubic Meters - (mapped to [http://wiki.jaguarfreight.com/wiki/Commodity#Grand_Total:_cbm Grand Total: cbm], label - "CBM", default Qty = 1)
+
-
:* Total Cubic Feet - (converted from [http://wiki.jaguarfreight.com/wiki/Commodity#Grand_Total:_cbm Grand Total: cbm], label - "CFT", default Qty = 1)
+
-
:* Chargeable Weight (Kg) - (mapped to [http://wiki.jaguarfreight.com/wiki/Chargeable_weight Chargeable weight], label - "CWT KG", default Qty = 1)
+
-
:* Containers Count - (Containers, label - "CONT", default Qty = 1)
+
-
:* Pallets Count - (mapped to [http://wiki.jaguarfreight.com/wiki/Commodity#Grand_Total:_Plts Grand Total: Plts], label - "PLTS", default Qty = 1)
+
-
:* Total Packages Count - (mapped to [http://wiki.jaguarfreight.com/wiki/Commodity#Grand_Total:_Pkgs_On_Plts Grand Total: Pkgs On Plts], label - "CARTON", default Qty = 1)
+
-
:* CT Count - (CT Count, label - "SHPT", default Qty = 1)
+
-
:* Documents Count - (Definition - [[TBD]], label - "DOC", default Qty = 1)
+
-
:* Customs Clearance - (Definition - [[TBD]], label - "CUSTOMS", default Qty = 1)
+
-
:* %0 - (Percentage, label - "%", default Qty = 0)
+
-
 
+
-
For Group case, default Qty is a sum of appropriate values from CTs that were selected for invoicing.
+
== Related wikis ==
== Related wikis ==

Current revision as of 16:26, 18 November 2013


Contents

[edit] Info

Scope:

This covers all issues related to "Sales Invoice" in CyberTrax.

[edit] Business Needs and Requirements

[edit] Component Description

[edit] Invoice Number

  • automatically generated inv# and assigned after user selects "Generate Invoice"
  • label on pdf: "Invoice No"

[edit] Issuing Date

  • meaning: Date Invoice was issued
  • read only
  • system assigns today's date
  • UI: label "Date"
  • DB: IssueDate

[edit] Total Invoice

Total amount of the invoice.

[edit] Total Invoice Currency

Currency of #Total Invoice.

[edit] Bill To

Have to select Bill To Party Company from dropdown list.
  • Dropdown list should be mapped to Admin > Address Book > Bill To Parties.
  • Bill To Parties in dropdown list should be displayed as Unique Id: Company Name - City - Remark. Example: "Elizabeth Arden - Roanoke".

[edit] Bill To Address

Editable textarea with Address of Bill To Party:

[Company name]
[Address line 1]
[Address line 2]
[Address line 3]
[City], [State] [Postcode]
[Country]

[edit] Date

Text label. Set to current date (date of Invoice generating).

[edit] Invoice Comments

Blank editable textarea.

[edit] File ref#

Dropdown list with 2 values from GenTab of CT:

[edit] CT fields

[edit] Template Section A. MOT Air

Figure:Invoice Air Section A

[edit] Template Section A. MOT LCL/FCL

Section "A" (top section) on the template of Sales Invoice is identical for both Ocean's MOT: LCL and FCL. Here is used the same fields without any differences in mapping.

Figure:Invoice Ocean-LCL Section A
Figure:Invoice Ocean-FCL Section A
  • Bill To:. Have to select Bill To Party Company from dropdown list.
  • Dropdown list should be mapped to Admin > Address Book > Bill To Parties.
  • Bill To Parties in dropdown list should be displayed as Unique Id: Company Name - City - Remark. Example: "Allstar Marketing Group, LLC - Hawthorne".
  • Bill To Address:. Editable textarea with Address of Bill To Party:
[Company name]
[Address line 1]
[Address line 2]
[Address line 3]
[City], [State] [Postcode]
[Country]
Example: AAAA-223344-1 20 ft / 1. HQ (Container # Size / Type).

[edit] Template Section A. MOT Truck

TBD

Now: Section "A" on the template of Sales Invoice for MOT Truck (all kinds) is the same as for Ocean's MOT.--Andrei 09:34, 17 August 2010 (EDT)

[edit] TOC (sec B)

Section "B" (bottom section) on the template of Sales Invoice looks the same for all MOT.

Figure:Invoice Air Section B
  • Table of Charges (TOC):
Each line of table contains information that related to current Charge Code. This info divided by follows columns:

[edit] CC

[edit] Unit

  • Full list of the Units (in Quantity (Unit Type) format) contains:
  • 1 (FLAT) (default Quantity (Qty) = 1). Note: per Marc, farely vague description which basically means "no accurate unit available to describe this charge" -> very useful in our industry)
  • 1 (MIN) (Minimum Charge, default Qty = 1)
  • 1 (MAX) (Maximum Charge, default Qty = 1)
  • Total Gross Weight (KG) (default Qty = Grand Total: Gross Kg)
  • Total Gross Weight (LB) (default Qty = Grand Total: Gross Lb)
  • Total Cubic Meters (CBM) (default Qty = Grand Total: cbm)
  • Total Cubic Feet (CFT) (default Qty = conversion of Grand Total: cbm)
  • Chargeable Weight (CWT KG) (default Qty = Chargeable weight (AIR))
  • Containers Count (CNTR) (For FCL charges, default Qty = Containers Count, including Distribution by Containers)
  • Pallets Count (PLTS) (default Qty = Grand Total: Plts)
  • Total Packages Count (CARTONS) (default Qty = Grand Total: AMS = Grand Total: Pkgs On Plts + Grand Total: Loose Pkgs)
  • CT Count (SHPT) (Shipment, default Qty = CT Count)
  • Documents Count (DOCS) (CT Count, default Qty = CT Count)
  • Customs Clearance (CUSTOMS) (Customs Formalities / Customs Declaration, default Qty = 1)
  • 0 (%) - (Percentage, default Qty = 0 and user must specify QTY)

For Group case, default Qty is a sum of appropriate values from:

1) CTs that were selected for invoicing - Inv tab.
2) all grouped CTs - Est tab.

[edit] DC

[edit] CC Description

[edit] CC Quantity

[edit] CC Rate

Rate field in TOC.

[edit] CC Amount

Is a function of CC Quantity and CC Rate as defined in CC Admin.

[edit] CC Currency

[edit] TOC misc

  • Action buttons
All these buttons placed above the TOC in the next order from the left to the right:
  • Maximize table.
  • Add. Also has dropdown list with range [1-10] and label "lines to the table".
  • Delete.
  • Copy TOC from ImpTab.
  • Total section:
All total values placed on the template below the TOC in the next order:
  • Sub-Total for each currency.
  • Total Subject to VAT.
  • Total Non Subject to VAT.
  • VAT Amount.
  • Grand Total (and Total Currency dropdown list).
  • NOTE: Sub-Total and Grand Total fields should not be editable.

[edit] Pdf

Figure:Sales Invoice PDF

Printed form of Sales Invoice should be in compliance with the Common specs for pdfs.

System generates 3-page PDF of Sales Invoice. The content of each page are identical, except the grey bolded "Copy label" at bottom of each page: Original, File Copy and Accounts Copy.

  • Header
  • Jaguar Office address based on login user.
font: standard Jaguar font (AGRevueCyr Roman Medium).
aligned: to right.
  • Bill To + Bill To Address
Label: TO:.
aligned: to left.
  • Invoice's number and date of its creating
Labels: Invoice No: and Date:.
aligned: to right.
NOTE: Header of Sales Invoice doesn't contain Jaguar logo.
  • Body
  • Top Section - reflects Template Section A, except:
- "Bill To", "Date" (should be print on Header).
- "Invoice Comments" (should be print on Footer).
Figure:Clause for Paris Office
  • Commodity Section - reflects Template Section B (Table of Charge).
  • Table. List of columns:
- CC#.
- Description.
- Currency.
- Amount.
  • Totals. List of totals:
- sub-total for each used currency.
- total non-subject to VAT.
- total subject to VAT.
- VAT Amount.
- Total Invoice.
  • For Paris Office only! Sales Invoices that issued in Paris Office without VAT charges (VAT enable dropdown is set to No), remove VAT information & replace with a clause "Exoneration selon art. 262 / I / 1 du C.G.I.".
  • Footer
  • Comments section. Reflects Template Invoice Comments. Takes 2 lines.
Label: COMMENTS:.
  • Textline "Terms - Net upon receive Invoice".
  • Login user's first name and last name.
Label: PREPARED BY:.
  • Page X of Y.
  • Copy label.

[edit] Group Generate

Figure:Invoice Group Generate

In case of group generate (when Invoice is generated from CT which is a part of group) the user gets the ability to include an info of each grouped CT to Invoice. System shows the selection window that works exactly the same as in group generate case for any PDF. After user's choice (in checkboxes) the Invoice template should contain an aggregate info from one or multiple CTs.

In case of group generate some fields on template should filled as follows:

  • CT ref#: should included all CT Numbers of the selected CTs separated by comma.
  • P.O. Numbers: should included all PO's of the selected CTs separated by comma.
  • CONTAINER No(s) (only for MOT = Ocean): should aggregate into list all Containers of the selected CTs.
  • Packages should aggregate (sum up) all of the following values of the selected CTs:
    Pallets,
    Cartons on Pallets,
    Cartons (loose).
  • Weight/Volume should aggregate (sum up) all of the following values of the selected CTs:
    Weight,
    Volume.

All others fields on the template filled from current CT.

[edit] In Database

mysql> describe tblShipmentInvoices;
+-----------------------+---------------+------+-----+---------+----------------+
| Field                 | Type          | Null | Key | Default | Extra          |
+-----------------------+---------------+------+-----+---------+----------------+
| Id                    | int(10)       | NO   | PRI | NULL    | auto_increment |
| ShipmentId            | int(10)       | NO   | MUL | NULL    |                |
| IssueDate             | datetime      | NO   |     | NULL    |                |
| UserId                | int(10)       | NO   | MUL | NULL    |                |
| Amount                | double        | NO   |     | 0       |                |
| BillToCompany         | varchar(255)  | YES  |     | NULL    |                |
| BillToAddress         | varchar(512)  | YES  |     | NULL    |                |
| CurrencyId            | int(10)       | NO   | MUL | NULL    |                |
| OfficeId              | int(10)       | NO   | MUL | NULL    |                |
| DateOfDeparture       | date          | YES  |     | NULL    |                |
| DateOfArrival         | date          | YES  |     | NULL    |                |
| PortOfDeparture       | varchar(128)  | YES  |     | NULL    |                |
| PortOfArrival         | varchar(128)  | YES  |     | NULL    |                |
| Vesselname            | varchar(128)  | YES  |     | NULL    |                |
| Shipper               | varchar(512)  | YES  |     | NULL    |                |
| Consignee             | varchar(512)  | YES  |     | NULL    |                |
| NotifyParty           | varchar(512)  | YES  |     | NULL    |                |
| FileRef               | varchar(512)  | YES  |     | NULL    |                |
| InvoiceType           | int(10)       | NO   | MUL | 0       |                |
| CreditNoteOnInvoiceId | int(10)       | YES  | MUL | NULL    |                |
| VoyageNumber          | varchar(20)   | YES  |     | NULL    |                |
| TotalOfPallets        | int(10)       | YES  |     | NULL    |                |
| TotalPkgsOnPlts       | int(10)       | YES  |     | NULL    |                |
| TotalLoosePkgsOnPlts  | int(10)       | YES  |     | NULL    |                |
| BillToOfficeId        | int(10)       | YES  | MUL | NULL    |                |
| BillToCompanyId       | int(10)       | YES  | MUL | NULL    |                |
| WeightInKg            | double        | YES  |     | NULL    |                |
| VolumeInCbm           | double        | YES  |     | NULL    |                |
| Comments              | varchar(1024) | YES  |     | NULL    |                |
| PONumbers             | varchar(1024) | YES  |     | NULL    |                |
| CTRef                 | varchar(512)  | YES  |     | NULL    |                |
| VATAmount             | double        | YES  |     | NULL    |                |
| TotalWithVAT          | double        | YES  |     | NULL    |                |
| TotalNonVAT           | double        | YES  |     | NULL    |                |
| CustomerRef           | varchar(512)  | YES  |     | NULL    |                |
| ChargeableWeight      | double        | YES  |     | NULL    |                |
| TableOfChargesId      | int(10)       | YES  | MUL | NULL    |                |
| ShowToClient          | tinyint(1)    | NO   |     | 0       |                |
| InvoiceNumber         | int(10)       | NO   | MUL | 0       |                |
| MainOfficeId          | int(10)       | YES  | MUL | NULL    |                |
+-----------------------+---------------+------+-----+---------+----------------+
40 rows in set

mysql> describe tblTableOfCharges;
+--------------+---------+------+-----+---------+----------------+
| Field        | Type    | Null | Key | Default | Extra          |
+--------------+---------+------+-----+---------+----------------+
| Id           | int(10) | NO   | PRI | NULL    | auto_increment |
| Amount       | double  | YES  |     | NULL    |                |
| AmountVAT    | double  | YES  |     | NULL    |                |
| TotalWithVAT | double  | YES  |     | NULL    |                |
| TotalNonVAT  | double  | YES  |     | NULL    |                |
| CurrencyId   | int(10) | YES  | MUL | NULL    |                |
+--------------+---------+------+-----+---------+----------------+
6 rows in set

[edit] Change Requests

[edit] SOW 0

See #Technical Specification and next.

[edit] SOW 1

Mantis 0003610: Sales Invoices with VAT charges, add VAT Rate % in PDF Body next to VAT Amount for ALL UK and FR sales invoices generated

Figure: Sales Invoice VAT Amount example

[edit] Core Requirements

Request is to add the VAT percentage rate onto the BODY of the Sales Invoice PDF for any Jag Europe offices (UK & Paris) sales invoices that have VAT amount.

[edit] Solution

  • Requested update is related to Sales Invoices (SI) and Credit Notes (CN) which:
1) were issued from Paris and London offices only.
2) have VAT Amount > 0.
  • In PDF form of SI (or CN) should be reflected current VAT rate for the issuing office.
    • The VAT rate should be displayed next to the words "VAT Amount" label in total section of PDF.
    • The VAT rate is listed under each office’s profile in CT2 Admin and should be pulled from there.
    • Example: use VAT Amount 20% instead previously printed VAT Amount.

[edit] Related Functionality

All invoices with VAT = 0 should stay as is, in present form.

[edit] Post-Implementation Notes

Non-zero VAT rate will be reported to SI/CN issued from any "VAT enabled" office. --Andrei 09:03, 21 June 2012 (EDT)

[edit] SOW 2

Mantis 0003384: Change Mapping of Port of Loading & Port of Discharge on Sales Invoice

[edit] Core Requirements

Sales Invoice PDF form. Ports fields to update

Request is to show the actual information (Original Terminal/Destination Terminal) on the invoice.

[edit] Solution

  • Requested update is related to Sales Invoices (SI) for OCEAN shipments.
  • All used fields taken from ExpTab of CT.

We need use new:

[edit] SOW 3

Mantis 0003738: [SOW3] EA needs to see the full addresses for both the shipper and consignee in all Jaguar invoices

[edit] Core Requirements

  • Add Shipper & Consignee information to Sales Invoice and Credit Notes.

[edit] Solution

  • Show the actual street address, city and country of both the Shipper and Consignee.
  • The feature to include Shipper/Consignee information should be controlled from the Client Company Admin area.
  • For grouped shipments:
    • a. showing the address for the record from which the invoice is created
    • b. 2nd page attachment providing group information for grouped records

[edit] Implementation Notes

  • SOW3 was not implemented.
    (Business has decided not to proceed with this request)

[edit] SOW 4

N/A

[edit] SOW 5 Sales Invoice v2

mantis: 4149

spec:

Changes to Sales Invoice component logic:

[edit] Entering container related charges

Add the following logic to TOC on Sales Invoice: Est Module#SOW 3 Automate entering container related charges into TOC.

[edit] Copy TOC from Est Tab

Idea is to re-use Sales Charges entered on Est Tab while creating sales invoices.

Now there is identical functionality but for copying from TOC on Imp Tab. This TOC is to be removed. So instead we should copy from Est Tab.

When user clicks "Copy TOC from Est tab" TOC lines that are linked to selected on Sales Invoice Bill To Party will be copied into TOC on Sales Invoice.

If there are some records already on Sales TOC then system will prompt the user: " Delete existing Charge Codes ?" providing a choice to overwrite or append.

[edit] Changes to pdf

  • Add Q and R columns
  • Add unit of measurement
  • increase space between lines
  • make font in Header smaller

[edit] SOW 5 UAT feedbacks

  • Unit of measurement:
    • Remove Unit column from pdf.
    • Add unit value to the right of Quantity value.
    • Name unit of measurements accordingly to the following mapping CBV type -> Unit
[edit] Unit abbrevs
Count		-> Flat
Gross KG	-> KG
Chargeable KG	-> CWT KG
CBM		-> CBM
  • Add VAT column to Est tab (as on Sales Inv now)

[edit] SOW 5 feedbacks round 2

Sales pdf:

  • add space btw lines or make font smaller
  • re-name quantity to QTY and center it
  • rate - right allign it

Inv Tab:

[edit] SOW 5 feedbacks round 3

[edit] SOW 6

SPEC UPDATED

Mantis 0004343: (Sales Invoice) Unit related redesign for Table Of Charges

[edit] Core Requirements

  • Change "Unit" column from read only to editable.
  • Expand the list of Charge Code Units.
  • Objects for implementation:
  • Charge Code Admin - "Quantity Field default to:" dropdown.
  • Table of Charges on Inv/Est tab.
  • Related PDF documents.

[edit] Solution

See #Unit

[edit] Related wikis

Personal tools