README

SDK PHP para ajudar na integração com o Software de Facturação Grátis www.facturalusa.pt

Visualize a API em https://facturalusa.pt/documentacao/api

Requisitos

1. PHP >= 7.0
2. Composer

Instalação

$ composer require infolusa/php-facturalusa

Endpoints

Todos os endpoints listados na documentação oficial estão disponíveis para utilizar neste SDK. Os parâmetros a serem preenchidos no $array devem ser consultados na API.

Exemplo prático

$facturalusa = new \Facturalusa\FacturalusaClient('api_token');
$customer = new \Facturalusa\Customer\Customer($facturalusa);
$customer->create([...]);

print_r($facturalusa->response());

// Outro endpoint chamado
$customer->create(['param1' => 'value1']);
print_r($facturalusa->response());

// Outra forma de chamar
(new \Facturalusa\Customer\Customer($facturalusa))->create(['param1' => 'value1']);

// Também pode ser atribuída a resposta à variável
$response = $customer->create();

Respostas & status

Três funções são disponibilizadas:

1. $facturalusa->fail() - devolve se o pedido falhou
2. $facturalusa->success() - devolve se o pedido foi bem executado
3. $facturalusa->response() - devolve a resposta do pedido, tenha ou não falhado

As respostas diferem de endpoint para endpoint, pelo que deve consultar a documentação em https://facturalusa.pt/documentacao/api para saber que conteúdo é devolvido. Para aceder, por exemplo, ao ID criado basta $facturalusa->response()->id.

Clientes endpoints

Artigos endpoints

Vendas endpoints

Recibos endpoints

Administração endpoints

Ajuda

Se tiver alguma dúvida ou questão, envie-nos uma mensagem através do formulário de contacto, via Suporte Ticket (dentro da sua subscrição) ou via email para geral@facturalusa.pt

Licença

MIT