Skip to content
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
lib
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

API da Fatura Simples em PHP

Build Status

Registre-se para começar a usar em https://www.faturasimples.com.br

Requerimentos

PHP 5.6+

Instalação com Composer

Depois de instalado o Composer execute:

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

Utilize o Composer Autoloader:

require_once('vendor/autoload.php');

Ou carregue manualmente:

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

Instalação Manual

Obtenha a última versão disponível com:

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

Para usar essa versão, adicione a seguinte linha na sua aplicação:

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

Iniciando o uso

Um caso de uso extremamente simples:

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;

Para registrar uma venda com emissão de 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;

Documentação

Acesse https://docs.faturasimples.com.br/api/ para a documentação completa da nossa API

Testes

Para executar os testes você precisa instalar o PHPUnit, usando composer execute:

composer update --dev

Para executar os testes:

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