cvtrust/nacha-file-generator

Easy to use NACHA file generation for PPD/CCD transactions. Modeled using NACHA documentation.

1.9.1 2018-01-11 18:18 UTC

This package is not auto-updated.

Last update: 2024-11-09 04:09:23 UTC


README

Build Status

NACHA File Generator

Based on documentation from NACHA: https://www.nacha.org/system/files/resources/AAP201%20-%20ACH%20File%20Formatting.pdf

Install With Composer

{
	"require" : {
		"nacha/file-generator" : "1.9.*"
	}
}

Usage

<?php
use Nacha\File;
use Nacha\Batch;
use Nacha\Record\DebitEntry;
use Nacha\Record\CcdEntry;

// Create the file and set the proper header info
$file = new File();
$file->setImmediateDestination('051000033')
	...
	->setReferenceCode('MYCODE');

// Create a batch and add some entries
$batch = new Batch();
$batch->getHeader()
	...
	->setOriginatingDFiId('01021234');

$batch->addDebitEntry((new DebitEntry)
	...
	->setTraceNumber('99936340', 1));

$file->addBatch($batch);

// completed file ready for output
$output = (string)$file;

For complete examples see test/Nacha/FileTest.php

Tests

$ ./vendor/bin/phpunit -c test/ci.xml

Todos

There is limited validation for field inputs. Strings that are too long will be truncated. Required/mandatory fields are currently not enforced.

Other missing elements:

  • Addenda support added in v1.9+
  • BOC, ARC, POP Entry records
  • Corporate Trade Exchange Entries
  • Point of Sale Entries
  • Notification of Change Entry (COR)
  • Return entries

Support for the above elements should be rather easy to implement, as the models were built with them in mind. Put in a pull request if you have an immediate need for one of the above features.