-
Notifications
You must be signed in to change notification settings - Fork 4
ABA File Writer for Golang - compatible with Australian banking standards - WIP
License
17twenty/aba
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
PACKAGE DOCUMENTATION
package aba
import "."
CONSTANTS
const (
Debit = "13" // Externally initiated debit item
Credit = "50" // Initiated externally
AGSI = "51" // Australian Govt Security Interest
FamilyAllowance = "52" // Family allowance
Pay = "53" // Pay
Pension = "54" // Pension
Allotment = "55" // Allotment
Dividend = "56" // Dividend
NoteInterest = "57" // Debenture/Note Interest
)
VARIABLES
var (
ErrInsufficientRecords = errors.New("aba: Not enough records (minimum 2 required)")
ErrMustSpecifyUsersBank = errors.New("aba: Didn't specify the users bank")
ErrMustSpecifyUsersID = errors.New("aba: Didn't specify the users ID")
ErrMustSpecifyAPCAUserID = errors.New("aba: Didn't specify the APCA ID")
ErrInvalidRecord = errors.New("aba: Invalid Record can't be written")
ErrBadHeader = errors.New("aba: Bad Header prevented reading")
ErrBadRecord = errors.New("aba: Bad Record prevented reading")
ErrBadTrailer = errors.New("aba: Bad Trailer prevented reading")
ErrUnexpectedRecordType = errors.New("aba: Unexpected record type, can decode 0,1 and 7 only")
)
TYPES
type Reader struct {
Header header
Trailer trailer
// contains filtered or unexported fields
}
A Reader reads records from an ABA file.
As returned by NewReader, a Reader expects input conforming to spec. The
Header and Trailer fields expose details about the underlying item
func NewReader(r io.Reader) *Reader
NewReader returns a new Reader that reads from r.
func (r *Reader) Read() (record Record, err error)
Read reads one record (a slice of fields) from r First read may not
return a record, instead Header will likely be populated. You may also
get Trailer as the last
func (r *Reader) ReadAll() (records []Record, err error)
ReadAll reads all the remaining records from r.
type Record struct {
BSBNumber string // pos 2-8 - in the format 999-999
AccountNumber string // pos 9-17
// Indicator should be one of the following
// W - Dividend paid to a resident of a country where double tax agreement is in force
// X - Dividend paid to a resident of any other country
// Y - Interest paid to all non-residents -- tax withholding is to appear at 113-120
// N - New or varied BSB/account number or name
// Blank otherwise
Indicator string // pos 18
TransactionCode string // pos 19-20 - Either 13, debit or 50, credit.
Amount uint64 // pos 21-30 - in cents, Right justified in cents e,g, $100.00 == 10000
Title string // pos 31-62 - must not be blank,. Left justified and blank filled. Title of account
LodgementReference string // pos 63-80 - e.g invoice number/payroll etc
TraceBSB string // pos 81-87 - BSB number of user supplying the file in format 999-999
TraceAccount string // pos 88-96 - account number of user supplying file
NameOfRemitter string // pos 97-112 - name of originator which may differ from username
AmountOfWithholdingTax uint64 // pos 113-120 - Shown in cents without punctuation
}
Record is the type we care about for writing to file
func (r *Record) IsValid() bool
IsValid performs some basic checks on records
func (r *Record) Read(l string) error
func (r *Record) Write(w io.Writer)
type Writer struct {
// OmitBatchTotals can be used for banks that don't summarise
// the credit/debit transactions
OmitBatchTotals bool
// CRLFLineEndings allows you to toggle whether to use Windows/DOS style
// line endings vs the default unix style
CRLFLineEndings bool
// contains filtered or unexported fields
}
Writer implements buffering for an io.Writer object. If an error occurs
writing to a Writer, no more data will be accepted and all subsequent
writes, and Flush, will return the error. After all data has been
written, the client should call the Flush method to guarantee all data
has been forwarded to the underlying io.Writer.
func NewWriter(w io.Writer) *Writer
NewWriter returns a new Writer whose buffer has the default size.
func (w *Writer) Error() error
Error reports any error that has occurred during a previous Write or
Flush.
func (w *Writer) Flush()
Flush can be called to ensure all data has been written
func (w *Writer) Write(records []Record) (err error)
Write writes the provided []Records into the buffer. It returns an error
if something is wrong with the records.
About
ABA File Writer for Golang - compatible with Australian banking standards - WIP
Resources
License
Stars
Watchers
Forks
Releases
No releases published
Packages 0
No packages published