@ach/ach 中文文档教程

Question

NACHA ACH CCD+/PPD+ Formatter/Parser

解析和格式化 NACHA ACH 标准 CCD+/PPD+ 银行交易文件。

Install Options

Install CLI

npm install -g @ach/ach

Install Library

npm install @ach/ach --save

Table of Contents

1. Install Options
   1. Install CLI
   2. Install Library
2. Use CLI
3. Use API
   1. create()
   2. wrap()
   3. Using from().edit().to()
   4. from()
   5. edit()
   6. to()
   7. Examples
4. Future Plans
   1. Additional Output Formats
   2. Additional Bank Formats

Use CLI

• Provide input to stdin and get output from stdout.
• Both input and output formats default to 'ACH' when not provided.
• Provide one or more transform scripts use in between parsing and formatting

# these are all the same
# ach is both the CLI name and the default format
ach from ach to ach and edit with some.js
ach from ach to ach edit with some.js      # no 'and'
ach from ach to ach edit some.js           # no 'with'
ach from ach to ach some.js                # no 'edit'
ach to ach some.js                         # no 'from ach'
ach from ach some.js                       # or, no 'to ach'
ach some.js                                # only the edit script

# short options
ach -i ach -o ach -e some.js

# long options
ach --input ach --output ach --edit some.js

# can input or output an ach file object in JSON
# read an ACH file and output it as JSON
ach to json
# read a JSON file and output it as ACH
ach from json

# read a file as ACH, send it thru another transform, and output as ACH
ach edit some-transform.js

# provide the content with OS specific commands to pipe it in and out
cat file.ach | ach to json > file.json
cat file.json | ach from json > file.ach

注意：当添加更多格式时，所有这些看起来都会更好:)

返回：目录

Use API

ach 具有三个主要功能从

1. create() - used to generate an ACH file object with a series of calls
2. wrap() - wraps an already built ACH file object to be used with create()'s API
3. from() - used to start specifying a stream pipeline to parse/format

返回：目录

API: create()

ach = require('@ach/ach')

# this shows chained functions, but, you can hold the returns in a variable to reuse
achFile = ach.create
  from: # the company generating the ACH file
    name: 'Your Company'
    # company tax ID. If the "predetermined char" isn't in front then
    # a space is prepended
    fein: '123456789'

  for: # the bank the ACH file is being sent to
    name: 'Our Bank' # they receive the file
    routing: '123456789' # the routing number for the bank, with check digit

  .ccd # a batch using CCD format
    effectiveDate: '991231' # format: YYMMDD
    description: 'Payment'  # or, Payroll, or whatever
    # optional values
    note: 'the "discretionary data"'
    date: 'Mar 30'

  .credit # send money to another company
    name: 'Target Company'    # company receiving the money
    account:                  # their bank account info
      num: '135792468'
      type: 'C'               # C - checking (default), S - Savings
    routing: '987654321'      # their bank's routing number
    amount: 12345             # amount in cents
    # optional. CCD/PPD allows a single 'addenda' with an 80 character block
    addenda: 'some addenda 80 chars long'

  .credit # send money to another company
    name: 'Another Company'   # company receiving the money
    account:                  # their bank account info
      num: '159260'
      type: 'C'               # C - checking (default), S - Savings
    routing: '987654321'      # their bank's routing number
    amount: 13579             # amount in cents

  .debit # take that money from your company
    name: 'Your Company'      # your company sending the money
    account:                  # your bank account info
      num: '135792468'
      type: 'C'               # C - checking (default), S - Savings
    routing: '987654321'      # their bank's routing number
    amount: 25924             # amount in cents
    # optional. CCD/PPD allows a single 80 character 'addenda'
    addenda: 'some addenda 80 chars long'

  # same with a PPD batch.
  # .ppd # a batch using PPD format
  #   effectiveDate: '991231' # format: YYMMDD
  #   description: 'Payroll'
  #   # optional values
  #   note: 'Some Employee'
  #   date: 'Mar 30'

# then you can send it to a stream or get it as a string.
# 1. stream
ach.from(achFile).to process.stdout
ach.from(achFile).to someFileStream

# 2. string
ach.from(achFile).to (string) -> console.log 'ACH File:\n', string

返回：目录

API: wrap()

ach = require '@ach/ach'
achObject = getSomeAchObjectSomehow()

ach.wrap achObject
  # then use the same API functions provided by ach.create()
  .ccd {}
  .credit {}
  .debit {}

# the `achObject` has all changes made by function calls

返回：目录

Using from().edit().to()

目标是设置流转换管道，解析输入流，可选择编辑解析的对象，然后将对象格式化回字符串并输出。

有使用对象作为源以及将结果作为字符串或对象提供的变体。

这些由 ach CLI 使用。

管道示例：

1. a file reader as the 'source' stream
2. 'ach' format stream parser (transform) which converts the file to an ACH object
3. optionally, some editing transform provided by user which receives the object, edits it, and passes it on
4. 'ach' format stream formatter (writer) which converts the object to a string
5. the final writer, maybe a file writer

返回：目录

API: from()

有效参数：

1. a string representing the input format
2. a string as the source of content
3. a Readable stream as the source of content
4. an object with two optional properties

对象 (#4) 可以具有：

• format - the name of the input format. currently only 'ach' and 'json' are available
• source - the input source may be:
  • stream - any Readable object, or process.stdin (the default)
  • string - string content must be in a format compatible with a known parser
  • object - an ACH object to send into the pipeline

返回：目录

API: edit()

edit() 的有效参数是一个数组。 数组元素必须是：

1. string - a path, relative to the current working directory, to a JavaScript or CoffeeScript file
2. a Transform class
3. an instance of a Transform
4. an object with implementation functions for Transform constructor

返回：目录

API: to()

有效参数：

1. a string representing the output format
2. a writable stream
3. an object with two optional properties

对象 (#3) 可以有：

• format - the name of the output format. currently only 'ach' and 'json' are available
• target - the output target may be:
  • stream - a Writable object, or process.stdout (the default)
  • function - a listener to receive either the object or string. If a format is specified then the listener receives a string in that format. Without a specified format it receives the ACH object.

返回：目录

API Examples

# specify everything, the longest style:
input  = source: process.stdin, format: 'ach'
output = target: process.stdout, format: 'ach'
ach.from(input).to output
# Note: the above are all defaults and can be left out.

# the `source` and `target` properties can be: streams, strings, an ACH object
# specify only a format by specifying it as a string
ach.from('json').to()
ach.from().to 'json'

# specify the source content as a string:
someString = getAchObjectAsString()
ach.from(someString).to 'json'
# Note: it knows to do this because someString isn't a valid format

# input from a file reader
inputFile = fs.createReadStream 'some-file.ach', encoding:'utf8'
ach.from(inputFile).to(whatever)


# basic trio  
ach.from('ach').edit(updateFileHeader).to 'json'

返回：目录

Future Plans

Additional Output Formats

返回至：目录

1. 'english' - a human readable format
2. JSON
3. YAML
4. XML

Additional Bank Formats

返回：目录

NACHA ACH 标准中还有更多格式。

1. CTX - This is very similar to CCD/PPD. It allows many addendas using EDI X12 820 format.
2. IAT - International
3. … there's more

返回：目录

MIT License