README

比利时CODA银行文件的PHP解析器

安装

您可以使用Composer安装Codelicious/Coda。您可以在Packagist主页上阅读有关Composer及其主要仓库的更多信息。首先，按照Packagist主页上的说明为您的项目安装Composer，然后在您的composer.json文件中定义对Codelicious/Coda的依赖。

    {
        "require": {
            "codelicious/php-coda-parser": "^1.0"
        }
    }

或者您可以在项目根目录中执行以下命令来安装此库

composer require codelicious/php-coda-parser:^1.0

演示 / API

您可以在https://eenvoudigfactureren.be/coda尝试解析器。如果您不想自己托管代码，该页面上也提供了一个公开的API。

用法

<?php

use Codelicious\Coda\Parser;

$parser = new Parser();
$statements = $parser->parseFile('coda-file.cod', 'simple');

foreach ($statements as $statement) {
    echo $statement->date . "\n";

    foreach ($statement->transactions as $transaction) {
        echo $transaction->account->name . ": " . $transaction->amount . "\n";
    }

    echo $statement->new_balance . "\n";
}

报表结构

有2种结构可供选择。'raw'类似于原始文件结构，包含所有信息，而'simple'是一个简化的版本，只包含最重要的信息。如果您不确定使用哪种，应该使用'simple'。未提供属性的值将为null。

• Codelicious\Coda\Data\Simple\Statement
  • date 提供的文件日期（格式 YYYY-MM-DD）
  • account 为其创建报表的账户。一个实现Codelicious\Coda\Data\Simple\Account的对象
  • original_balance 处理交易之前的账户余额。最多3位小数。
  • new_balance 处理交易之后的账户余额。最多3位小数。
  • free_messages 包含附加信息的文本消息列表
  • transaction 交易列表，实现为Codelicious\Coda\Data\Simple\Transaction
• Codelicious\Coda\Data\Simple\Account
  • name 账户持有者的姓名
  • bic 账户的银行代码
  • company_id 账户持有者的官方比利时公司编号
  • number 账户的银行账号
  • currency 账户的货币
  • country 账户的国家
• Codelicious\Coda\Data\Simple\Transaction
  • account 交易另一方账户。一个实现Codelicious\Coda\Data\Simple\Account的对象
  • transaction_date 请求交易日期
  • valuta_date 银行执行交易的日期
  • amount 交易金额。最多3位小数。信用交易的金额为负数。
  • message 交易信息
  • structured_message 交易的格式化信息（如果可用）