README

注册以开始使用 https://www.faturasimples.com.br

需求

PHP 5.6+

使用Composer安装

安装Composer后，执行以下操作

composer require eramo-software/fatura-simples-php
composer install

使用 Composer自动加载器

require_once('vendor/autoload.php');

或者手动加载

require_once('/path/to/vendor/eramo-software/fatura-simples-php/lib/FaturaSimples.php');

手动安装

使用以下命令获取最新版本

git clone https://github.com/eramo-software/fatura-simples-php

要使用此版本，请在您的应用程序中添加以下行

require_once("/path/to/fatura-simples-php/lib/FaturaSimples.php");

开始使用

一个极其简单的使用案例

FaturaSimples::configure("https://suaempresa.faturasimples.com.br", "SUA_CHAVE_API");
$dados = array(
    'data' => '2015-02-11',
    'cliente' => 'NOME DO CLIENTE',
    'servico' => 'Consultoria em TI',
    'valor_venda' => 100.22,
    'emissao_nfse' => FaturaSimples_Venda::EMISSAO_NFSE_NAO_EMITIR_NFSE,
    'meio_pagamento' => 'Espécie'
);
$venda = FaturaSimples_Venda::criar( $dados );
echo $venda;

为了注册带有NFS-e开具的销售

FaturaSimples::configure("https://suaempresa.faturasimples.com.br", "SUA_CHAVE_API");
$dados = array(
    "data" => "2015-02-11",
    "cliente" => "ERAMO SOFTWARE",
    "cliente_cnpj" => "17737572000150",
    "servico" => "Consultoria em TI",
    "discriminacao" => "10 horas de serviço de consultoria",
    "valor_venda" => 2500,
    "emissao_nfse" => FaturaSimples_Venda::EMISSAO_NFSE_EMITIR_AGORA,
    "meio_pagamento" => "Depósito",
    "nfse_municipio_emissao" => 2611606,
    "nfse_item_servico" => 103,
    "nfse_cnae" => 6311900,
    "nfse_inscricao_municipal" => 123456,
    "nfse_optante_simples_nacional" => FaturaSimples_Venda::SIM,
    "nfse_incentivador_cultural" => FaturaSimples_Venda::NAO
);
$venda = FaturaSimples_Venda::criar( $dados );
echo $venda;

文档

访问 https://docs.faturasimples.com.br/api/ 以获取我们API的完整文档

测试

要执行测试，您需要安装PHPUnit，使用composer执行

composer update --dev

执行测试

php ./vendor/bin/phpunit test/FaturaSimples/