Instalação SDK

O Compufácil PHP SDK tem como dependência de instalação o composer. Execute o seguinte comando:, _(*1)

composer require compufacil/api-sdk

Integrando a API da CompuFácil via SDK PHP

A API da CompuFácil segue o padrão RPC. E o tráfego de dados é através de JSON., _(*2)

Ambientes

Existem dois ambiente servindo a API. O ambiente de homologação e de produção., _(*3)

Produção: https://app.compufacil.com.br
Homologação: https://homolog.compufacil.com.br

Padrão dos serviços

Todos os serviços seguem a seguinte nomenclatura:, _(*4)

$AMBIENTE/rpc/v1/$MODULO.$SERVICO

Módulo e serviço variam de acordo com o que parte do sistema está sendo utilizada., _(*5)

Exemplo:

#listar nfe's
https://homolog.compufacil.com.br/rpc/v1/fiscal.get-nfe
#criar nfe
https://homolog.compufacil.com.br/rpc/v1/fiscal.post-nfe
#atualizar nfe
https://homolog.compufacil.com.br/rpc/v1/fiscal.put-nfe
#deletar nfe
https://homolog.compufacil.com.br/rpc/v1/fiscal.delete-nfe

Autenticação

Primeiramente instanciamos a classe passando as configurações do ambiente e a versão, se caso não passarmos ela pegara os valores default que sempre será ambiente de homolog e a última versão estável da API., _(*6)

seguindo a autenticação se dá através da função signUp:, _(*7)

$cf = new Compufacil([
    'environment' => 'homolog',
    'version' => '1'
]);

$result = $cf->signIn('test@sdk.com', '123456');
print_r($result);

Na resposta de uma autenticação com sucesso conterá o token que dever ser trafegado nas requisições autenticadas., _(*8)

{
    "status": 1,
    "access_token": "1be2b89c92aff78f9ffae8b408d80b2c2d8bcf0a",
    "default_lang": "pt_BR",
    "is_admin": true
}

Enquanto mantivermos a classe o token ficara armazenado no estado da mesma, _(*9)

Serviços

Os demais serviços seguem o mesmo padrão da autenticação, com a única diferença que trafegam o token no header Authorization-Compufacil e utilizamos agora a função auxiliar rpcService, _(*10)

Exemplo fazendo o CRUD de receitas

Lista receitas, _(*11)

$revenues = $cf->rpcService('finance.get-revenue');
print_r($revenues); // []

Cria receita, _(*12)

$revenue = $cf->rpcService(
    'finance.post-revenue',
    [
        'description' => 'teste teste',
        'value' => 666
    ]
);
print_r($revenue); // ['id' => 152611]

Pega 1 receita detalhada, _(*13)

$revenue = $cf->rpcService(
    'finance.get-revenue',
    [
        'id' => $revenue['íd']
    ]
);
print_r($revenue); // ['id' => 152611, 'description' => 'test...]

Atualiza uma receita, _(*14)

$revenue = $cf->rpcService(
    'finance.put-revenue',
    [
        'id' => $revenue['id'],
        'description' => 'teste update',
        'value' => 999
    ]
);
print_r($revenue); // ['id' => 152611]

Deleta receita, _(*15)

$revenue = $cf->rpcService(
    'finance.delete-revenue',
    [
        'id' => $revenue['íd']
    ]
);
print_r($revenue); // ['id' => 152611]

Swagger

Para uma referência completa dos serviços você pode consultar o nosso swager . Lá também é possível executar os serviços diretamente contra homolog., _(*16)

Nosso blog, _(*17)