;examples: invoicing: new invoice script example
This commit is contained in:
Simon Michael
parent
7c4f5dc2bf
commit
7edcf77eae
79
examples/invoicing/invoice-script/README.md
Normal file
79
examples/invoicing/invoice-script/README.md
Normal file
@ -0,0 +1,79 @@
|
|||||||
|
Scripts adapted from a real-world setup, not guaranteed to be current or working.
|
||||||
|
|
||||||
|
Example:
|
||||||
|
|
||||||
|
Show invoice preview:
|
||||||
|
```
|
||||||
|
$ ./invoice abinvoice.tmpl.md client.ab.dev 200
|
||||||
|
---
|
||||||
|
papersize: letter
|
||||||
|
margin-left: 20mm
|
||||||
|
margin-right: 25mm
|
||||||
|
margin-top: 20mm
|
||||||
|
margin-bottom: 20mm
|
||||||
|
...
|
||||||
|
|
||||||
|
{ width=100mm }\
|
||||||
|
Joe Consultant | +1 (111) 111 1111 | joe@example.com | 500 Done Dr. #1, Work Ville, CA 10000, USA
|
||||||
|
|
||||||
|
Carl Client\
|
||||||
|
AB Inc.\
|
||||||
|
PO Box 11111\
|
||||||
|
CA 20000\
|
||||||
|
|
||||||
|
December 4, 2021
|
||||||
|
|
||||||
|
# Invoice 202111cw
|
||||||
|
|
||||||
|
| Description | Rate | Qty | Total |
|
||||||
|
|:--------------------------------------------|-------:|-------:|--------:|
|
||||||
|
| Systems reliability engineering | $ 1111 | | $ 1111 |
|
||||||
|
| On-call monitoring & tech support | $ 2222 | | $ 2222 |
|
||||||
|
| Contractor/vendor management | $ 333 | | $ 333 |
|
||||||
|
| Custom SW development & maintenance (Nov) | $ 444 | 2.00 | $ 888 |
|
||||||
|
| Reimbursable expenses (Nov) | | | $ 200 |
|
||||||
|
| | | | |
|
||||||
|
| Total due | | | $ 4754 |
|
||||||
|
| | | | |
|
||||||
|
|
||||||
|
|
||||||
|
Terms: Now due. Your business is appreciated, thank you!
|
||||||
|
```
|
||||||
|
|
||||||
|
Generate markdown and PDF invoices and sample journal entries:
|
||||||
|
```
|
||||||
|
$ ./invoice abinvoice.tmpl.md client.ab.dev 200 --md --pdf --txn
|
||||||
|
wrote abinvoice202111.md
|
||||||
|
Loading pages (1/6)
|
||||||
|
Counting pages (2/6)
|
||||||
|
Resolving links (4/6)
|
||||||
|
Loading headers and footers (5/6)
|
||||||
|
Printing pages (6/6)
|
||||||
|
Done
|
||||||
|
wrote abinvoice202111.pdf
|
||||||
|
|
||||||
|
--------------------------------------------------------------------------------
|
||||||
|
|
||||||
|
2021-12-04 (202111) abinvoice | invoice $ 4754
|
||||||
|
(assets:receivable:abinvoice:consulting) $ 4554 ; Nov hourly & Dec fixed fees
|
||||||
|
;(assets:receivable:abinvoice:reimbursement) $ 200 ; Nov reimbursable expenses
|
||||||
|
|
||||||
|
; 2021-12-04 (202111) abinvoice | payment
|
||||||
|
; ; receive full amount of invoice
|
||||||
|
; assets:bank:checking $ 4754
|
||||||
|
; assets:receivable:abinvoice:reimbursement $- 200
|
||||||
|
; assets:receivable:abinvoice:consulting $- 4554 = ./invoice
|
||||||
|
; ; recognise revenue (cash accounting)
|
||||||
|
; (revenues:abinvoice) $- 4554
|
||||||
|
; ; estimate tax due, tax-saved-on: ?, TODO:
|
||||||
|
; (liabilities:tax:us:2021) $-1275 ; 28%
|
||||||
|
; (liabilities:tax:st:2021) $-364 ; 8%
|
||||||
|
; ; Total tax: $1639 ; 36%
|
||||||
|
; ; Post-tax income: $2915
|
||||||
|
|
||||||
|
; 2021-12-04 save estimated tax from abinvoice 202111, received 2021-12-04
|
||||||
|
; assets:bank:checking $-1639
|
||||||
|
; assets:bank:savings:tax:us:2021 $1275
|
||||||
|
; assets:bank:savings:tax:st:2021 $364
|
||||||
|
|
||||||
|
```
|
||||||
117
examples/invoicing/invoice-script/abinvoice.css
Normal file
117
examples/invoicing/invoice-script/abinvoice.css
Normal file
@ -0,0 +1,117 @@
|
|||||||
|
/* https://martinbetz.eu/articles/pandoc-invoices */
|
||||||
|
|
||||||
|
@charset "utf-8";
|
||||||
|
|
||||||
|
body {
|
||||||
|
/* font-size: 10.5pt; */
|
||||||
|
/* font-family: */
|
||||||
|
/* "Avenir Next", -apple-system, BlinkMacSystemFont, "Segoe UI", "Roboto", */
|
||||||
|
/* "Oxygen", "Ubuntu", "Cantarell", "Fira Sans", "Droid Sans", "Helvetica Neue", sans-serif; */
|
||||||
|
hyphens: auto;
|
||||||
|
height: 250mm; /* 280 - 10 (top) - 20 (bottom) */
|
||||||
|
line-height: 140%;
|
||||||
|
margin: 0;
|
||||||
|
padding: 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
code {
|
||||||
|
font-family: "Source Sans Code", Courier New, Courier, monospace;
|
||||||
|
margin-left: 1pt;
|
||||||
|
/* font-size:12pt; */
|
||||||
|
}
|
||||||
|
|
||||||
|
a {
|
||||||
|
color: black;
|
||||||
|
margin-left: 1pt;
|
||||||
|
}
|
||||||
|
|
||||||
|
h1 {
|
||||||
|
font-size: 20pt;
|
||||||
|
margin-top: 10mm;
|
||||||
|
padding-top:0;
|
||||||
|
/* margin-top: 6pt; */
|
||||||
|
/* margin-bottom: 0; */
|
||||||
|
}
|
||||||
|
|
||||||
|
h2 {
|
||||||
|
font-size: 16pt;
|
||||||
|
/* margin-top: 20pt; */
|
||||||
|
margin-top: 10mm;
|
||||||
|
/* font-weight: normal; */
|
||||||
|
/* margin-top: 0; */
|
||||||
|
/* margin-bottom: 20pt; */
|
||||||
|
}
|
||||||
|
|
||||||
|
p {
|
||||||
|
width: 100%;
|
||||||
|
}
|
||||||
|
|
||||||
|
p:first-of-type {
|
||||||
|
text-align: center;
|
||||||
|
font-size: 9pt;
|
||||||
|
word-spacing: 1pt;
|
||||||
|
}
|
||||||
|
|
||||||
|
p:nth-of-type(2) {
|
||||||
|
margin-top: 10mm;
|
||||||
|
}
|
||||||
|
|
||||||
|
p:nth-of-type(3) {
|
||||||
|
text-align: center;
|
||||||
|
font-weight:bold;
|
||||||
|
font-size:12pt;
|
||||||
|
|
||||||
|
}
|
||||||
|
|
||||||
|
/* p:nth-last-of-type(3) { */
|
||||||
|
/* margin-top: 10mm; */
|
||||||
|
/* } */
|
||||||
|
|
||||||
|
/* p:last-of-type { */
|
||||||
|
/* text-align: center; */
|
||||||
|
/* font-size: 9pt; */
|
||||||
|
/* position: absolute; */
|
||||||
|
/* bottom: 2mm; */
|
||||||
|
/* margin-bottom: 0; */
|
||||||
|
/* padding-bottom: 0; */
|
||||||
|
/* color: #444; */
|
||||||
|
/* } */
|
||||||
|
|
||||||
|
table {
|
||||||
|
width: 100%;
|
||||||
|
}
|
||||||
|
|
||||||
|
table:nth-of-type(1) {
|
||||||
|
border: 1px solid black;
|
||||||
|
padding: 5pt;
|
||||||
|
}
|
||||||
|
|
||||||
|
table:nth-of-type(1) td {
|
||||||
|
border-top: 1px solid #eee;
|
||||||
|
}
|
||||||
|
|
||||||
|
table:nth-of-type(1) tr:nth-last-of-type(1) {
|
||||||
|
font-weight: bold;
|
||||||
|
}
|
||||||
|
table:nth-of-type(1) tr:nth-last-of-type(1) td {
|
||||||
|
/* border-top: 1px solid black; */
|
||||||
|
padding-top: 1em;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* table:nth-of-type(1) td:nth-of-type(2) { */
|
||||||
|
/* text-align: center; */
|
||||||
|
/* } */
|
||||||
|
|
||||||
|
hr {
|
||||||
|
border: 1px solid #eee;
|
||||||
|
}
|
||||||
|
|
||||||
|
hr:last-of-type {
|
||||||
|
position: absolute;
|
||||||
|
bottom: 14mm;
|
||||||
|
width: 100%;
|
||||||
|
}
|
||||||
|
|
||||||
|
figure {
|
||||||
|
margin: 0;
|
||||||
|
}
|
||||||
33
examples/invoicing/invoice-script/abinvoice.tmpl.md
Normal file
33
examples/invoicing/invoice-script/abinvoice.tmpl.md
Normal file
@ -0,0 +1,33 @@
|
|||||||
|
---
|
||||||
|
papersize: letter
|
||||||
|
margin-left: 20mm
|
||||||
|
margin-right: 25mm
|
||||||
|
margin-top: 20mm
|
||||||
|
margin-bottom: 20mm
|
||||||
|
...
|
||||||
|
|
||||||
|
{ width=100mm }\
|
||||||
|
Joe Consultant | +1 (111) 111 1111 | joe@example.com | 500 Done Dr. #1, Work Ville, CA 10000, USA
|
||||||
|
|
||||||
|
Carl Client\
|
||||||
|
AB Inc.\
|
||||||
|
PO Box 11111\
|
||||||
|
CA 20000\
|
||||||
|
|
||||||
|
$MONTH $DAY, $YEAR
|
||||||
|
|
||||||
|
# Invoice ${YEAR}${LMM}cw
|
||||||
|
|
||||||
|
| Description | Rate | Qty | Total |
|
||||||
|
|:--------------------------------------------|-------:|-------:|--------:|
|
||||||
|
| Systems reliability engineering | $ 1111 | | $ 1111 |
|
||||||
|
| On-call monitoring & tech support | $ 2222 | | $ 2222 |
|
||||||
|
| Contractor/vendor management | $ 333 | | $ 333 |
|
||||||
|
| Custom SW development & maintenance ($LM) | $ 444 | $HRS | $ $AMT |
|
||||||
|
| Reimbursable expenses ($LM) | | | $ $EXP |
|
||||||
|
| | | | |
|
||||||
|
| Total due | | | $ $TOT |
|
||||||
|
| | | | |
|
||||||
|
|
||||||
|
|
||||||
|
Terms: Now due. Your business is appreciated, thank you!
|
||||||
180
examples/invoicing/invoice-script/invoice
Executable file
180
examples/invoicing/invoice-script/invoice
Executable file
@ -0,0 +1,180 @@
|
|||||||
|
#!/usr/bin/env bash
|
||||||
|
# shellcheck disable=SC2016
|
||||||
|
# Create invoices with hledger and pandoc.
|
||||||
|
# cf hledger/examples/invoicing, https://hledger.org/invoicing.html, https://martinbetz.eu/articles/pandoc-invoices
|
||||||
|
set -e
|
||||||
|
|
||||||
|
#PROG=$(basename "$0")
|
||||||
|
function usage() {
|
||||||
|
cat <<EOF
|
||||||
|
--------------------------------------------------------------------------------
|
||||||
|
invoice:
|
||||||
|
Make markdown or pdf invoices, optionally including last month's time
|
||||||
|
and expenses, from a markdown template and similarly-named .css file.
|
||||||
|
Requires hledger, pandoc, awk, GNU date, envsubst, python3, sed, tail.
|
||||||
|
|
||||||
|
$ invoice
|
||||||
|
Show this help.
|
||||||
|
|
||||||
|
$ invoice TEMPLATEFILE [TIMEACCTORAMT [EXPACCTORAMT]] [FLAGS]
|
||||||
|
Print a markdown invoice on stdout.
|
||||||
|
TIMEACCTORAMT and EXPACCTORAMT are time and expense accounts to query
|
||||||
|
with hledger, or if numeric, the hours and expense amounts directly.
|
||||||
|
With --md and/or --pdf, save it as markdown / PDF in current directory.
|
||||||
|
With --txn, print sample hledger journal entries on stdout.
|
||||||
|
|
||||||
|
EOF
|
||||||
|
}
|
||||||
|
|
||||||
|
ARGS=()
|
||||||
|
while [[ $# -gt 0 ]]; do
|
||||||
|
key="$1"
|
||||||
|
case $key in
|
||||||
|
-h|--help)
|
||||||
|
HELP=1
|
||||||
|
shift
|
||||||
|
;;
|
||||||
|
--md)
|
||||||
|
MD=1
|
||||||
|
shift
|
||||||
|
;;
|
||||||
|
--pdf)
|
||||||
|
PDF=1
|
||||||
|
shift
|
||||||
|
;;
|
||||||
|
--txn)
|
||||||
|
TXN=1
|
||||||
|
shift
|
||||||
|
;;
|
||||||
|
*)
|
||||||
|
if [[ "$1" != -* ]]
|
||||||
|
then
|
||||||
|
ARGS+=("$1")
|
||||||
|
shift
|
||||||
|
else
|
||||||
|
echo "Error: unknown option $1"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
done
|
||||||
|
if [[ $HELP = 1 || ${#ARGS} -eq 0 ]]; then usage; exit; fi
|
||||||
|
|
||||||
|
DEFTIMEACCT=0
|
||||||
|
DEFEXPACCT=0
|
||||||
|
TEMPLATE="${ARGS[0]}"
|
||||||
|
TIMEACCT="${ARGS[1]:-$DEFTIMEACCT}"
|
||||||
|
EXPACCT="${ARGS[2]:-$DEFEXPACCT}"
|
||||||
|
|
||||||
|
# XXX FIXEDEXPS and RATE here, and printf widths below, must be kept synced with TEMPLATE
|
||||||
|
FIXEDEXPS=$(python3 -c "print(sum([ 1111, 2222, 333 ]))")
|
||||||
|
RATE=444
|
||||||
|
TIMELOG=./time.timedot
|
||||||
|
#
|
||||||
|
|
||||||
|
# if changing this period, hledger and date may need different values
|
||||||
|
HLEDGERPERIOD='last month'
|
||||||
|
DATECMDPERIOD='last month'
|
||||||
|
|
||||||
|
NUMRE="^[0-9]+([.][0-9]+)?$"
|
||||||
|
if [[ $TIMEACCT =~ $NUMRE ]]
|
||||||
|
then
|
||||||
|
HRS=$TIMEACCT
|
||||||
|
else
|
||||||
|
HRS=$(hledger -f "$TIMELOG" bal "$TIMEACCT" -1 "date:$HLEDGERPERIOD" -N | tail -1 | awk '{print $1}')
|
||||||
|
fi
|
||||||
|
if [[ $EXPACCT =~ $NUMRE ]]
|
||||||
|
then
|
||||||
|
EXP=$EXPACCT
|
||||||
|
else
|
||||||
|
EXP=$(hledger bal "$EXPACCT" "date:$HLEDGERPERIOD" amt:'>0' -N --layout=bare | tail -1 | awk '{print $1}')
|
||||||
|
fi
|
||||||
|
|
||||||
|
# on mac, use homebrew-installed GNU date
|
||||||
|
if [ "$(builtin type -p gdate)" ]; then export date=gdate; else export date=date; fi
|
||||||
|
|
||||||
|
YEAR=$($date +%Y)
|
||||||
|
MONTH=$($date +%B)
|
||||||
|
MON=$($date +%b)
|
||||||
|
MM=$($date +%m)
|
||||||
|
DD=$($date +%d)
|
||||||
|
DAY=$($date +%-d)
|
||||||
|
LM=$($date +%b --date "$DATECMDPERIOD")
|
||||||
|
LMM=$($date +%m --date "$DATECMDPERIOD")
|
||||||
|
|
||||||
|
# shellcheck disable=SC2001
|
||||||
|
INVOICEBASE=$(basename "$TEMPLATE" | sed -e 's/\..*//')
|
||||||
|
INVOICEDATED=$INVOICEBASE$YEAR$LMM
|
||||||
|
INVOICEMD=$INVOICEDATED".md"
|
||||||
|
INVOICEPDF=$INVOICEDATED".pdf"
|
||||||
|
CSS=$INVOICEBASE".css"
|
||||||
|
|
||||||
|
HRS="${HRS:-0}"
|
||||||
|
HRS=$(printf %4s "$HRS")
|
||||||
|
EXP=$(printf %5.0f "$EXP")
|
||||||
|
AMT=$(python3 -c "print(round( $HRS * $RATE ))")
|
||||||
|
AMT=$(printf %5s "$AMT")
|
||||||
|
REV=$(python3 -c "print(sum([ $FIXEDEXPS, $AMT ]))")
|
||||||
|
REV=$(printf %5s "$REV")
|
||||||
|
TOT=$(python3 -c "print(sum([ $FIXEDEXPS, $AMT, $EXP ]))")
|
||||||
|
TOT=$(printf %5s "$TOT")
|
||||||
|
export YEAR MONTH DAY LMM LM HRS AMT REV EXP TOT
|
||||||
|
|
||||||
|
if [[ $MD != 1 && $PDF != 1 ]]; then
|
||||||
|
# print markdown invoice
|
||||||
|
envsubst '$YEAR:$MONTH:$DAY:$LMM:$LM:$HRS:$EXP:$AMT:$TOT' <"$TEMPLATE"
|
||||||
|
|
||||||
|
else
|
||||||
|
if [[ $MD = 1 ]]; then
|
||||||
|
# save markdown invoice
|
||||||
|
envsubst '$YEAR:$MONTH:$DAY:$LMM:$LM:$HRS:$EXP:$AMT:$TOT' <"$TEMPLATE" >"$INVOICEMD"
|
||||||
|
echo "wrote $INVOICEMD"
|
||||||
|
fi
|
||||||
|
if [[ $PDF = 1 ]]; then
|
||||||
|
# save pdf invoice
|
||||||
|
envsubst '$YEAR:$MONTH:$DAY:$LMM:$LM:$HRS:$EXP:$AMT:$TOT' <"$TEMPLATE" \
|
||||||
|
| pandoc -t html5 --metadata title=" " --css "$CSS" -o "$INVOICEPDF"
|
||||||
|
echo "wrote $INVOICEPDF"
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
|
||||||
|
if [[ $TXN = 1 ]]; then
|
||||||
|
# generate sample journal entries
|
||||||
|
printf "\n--------------------------------------------------------------------------------\n\n"
|
||||||
|
USTAXRATE=0.28
|
||||||
|
STTAXRATE=0.08
|
||||||
|
CLIENT=$INVOICEBASE
|
||||||
|
USTAX=$(python3 -c "print(round( $REV * $USTAXRATE))")
|
||||||
|
#USTAX=$(printf %5s "$USTAX")
|
||||||
|
STTAX=$(python3 -c "print(round( $REV * $STTAXRATE))")
|
||||||
|
#STTAX=$(printf %5s "$STTAX")
|
||||||
|
TOTTAX=$(python3 -c "print($USTAX + $STTAX)")
|
||||||
|
#TOTTAX=$(printf %5s "$TOTTAX")
|
||||||
|
PTINC=$(python3 -c "print($REV - $TOTTAX)")
|
||||||
|
#PTINC=$(printf %5s "$PTINC")
|
||||||
|
|
||||||
|
envsubst '$CLIENT:$YEAR:$MM:$DD:$MON:$LMM:$LM:$REV:$EXP:$TOT:$USTAX:$STTAX:$TOTTAX:$PTINC' <<EOF
|
||||||
|
$YEAR-$MM-$DD (${YEAR}${LMM}) $CLIENT | invoice \$$TOT
|
||||||
|
(assets:receivable:$CLIENT:consulting) \$$REV ; $LM hourly & $MON fixed fees
|
||||||
|
;(assets:receivable:$CLIENT:reimbursement) \$$EXP ; $LM reimbursable expenses
|
||||||
|
|
||||||
|
; $YEAR-$MM-$DD (${YEAR}${LMM}) $CLIENT | payment
|
||||||
|
; ; receive full amount of invoice
|
||||||
|
; assets:bank:checking \$$TOT
|
||||||
|
; assets:receivable:$CLIENT:reimbursement \$-$EXP
|
||||||
|
; assets:receivable:$CLIENT:consulting \$-$REV = $0
|
||||||
|
; ; recognise revenue (cash accounting)
|
||||||
|
; (revenues:$CLIENT) \$-$REV
|
||||||
|
; ; estimate tax due, tax-saved-on: ?, TODO:
|
||||||
|
; (liabilities:tax:us:2021) \$-$USTAX ; 28%
|
||||||
|
; (liabilities:tax:st:2021) \$-$STTAX ; 8%
|
||||||
|
; ; Total tax: \$$TOTTAX ; 36%
|
||||||
|
; ; Post-tax income: \$$PTINC
|
||||||
|
|
||||||
|
; $YEAR-$MM-$DD save estimated tax from $CLIENT ${YEAR}${LMM}, received $YEAR-$MM-$DD
|
||||||
|
; assets:bank:checking \$-$TOTTAX
|
||||||
|
; assets:bank:savings:tax:us:2021 \$$USTAX
|
||||||
|
; assets:bank:savings:tax:st:2021 \$$STTAX
|
||||||
|
|
||||||
|
EOF
|
||||||
|
fi
|
||||||
0
examples/invoicing/invoice-script/logo.jpg
Normal file
0
examples/invoicing/invoice-script/logo.jpg
Normal file
2
examples/invoicing/invoice-script/time.timedot
Normal file
2
examples/invoicing/invoice-script/time.timedot
Normal file
@ -0,0 +1,2 @@
|
|||||||
|
2021-11-15
|
||||||
|
client.ab.dev .... ....
|
||||||
Loading…
Reference in New Issue
Block a user