Sales Invoice

From UG

(Difference between revisions)
Jump to: navigation, search
(→Fields)
(→Number)
Line 12: Line 12:
== Fields ==
== Fields ==
-
=== Number ===
+
=== Invoice No ===
* automatically generated inv# and assigned after user selects "Generate Invoice"
* automatically generated inv# and assigned after user selects "Generate Invoice"

Revision as of 03:41, 31 August 2013


Contents

Info

Scope:

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

Business Needs and Requirements

Fields

Invoice No

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

Issuing Date

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

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".

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]

Date

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

Invoice Comments 

Blank editable textarea.

File ref#

Dropdown list with 2 values from GenTab of CT:

CT fields

Template Section A. MOT Air

Figure:Invoice Air Section A

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).

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)

Template Section B (TOC)

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:
  • Charge Code.
  • Description.
  • Quantity.
  • R (rate).
  • A (amount).
  • Currency.
  • VAT.
  • 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.

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.

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.

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

Change Requests

SOW 0

See #Technical Specification and next.

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

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.

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.

Related Functionality

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

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)

SOW 2

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

Core Requirements

Sales Invoice PDF form. Ports fields to update

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

Solution

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

We need use new:

SOW 3

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

Core Requirements

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

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

Implementation Notes

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

SOW 4

N/A

SOW 5 Sales Invoice v2

mantis: 4149

spec:

Changes to Sales Invoice component logic:

Entering container related charges

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

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.

Changes to pdf

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

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
Unit abbrevs 
Count		-> Flat
Gross KG	-> KG
Chargeable KG	-> CWT KG
CBM		-> CBM
  • Add VAT column to Est tab (as on Sales Inv now)

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:

SOW 5 feedbacks round 3

Related wikis

Retrieved from "https://wiki.jaguarfreight.com/Sales_Invoice"
Personal tools