Integrando a API da Zucchetti POS
A API da Zucchetti POS segue o padrão RPC. E o tráfego de dados é através de JSON.
Ambientes
Existem dois ambiente servindo a API. O ambiente de homologação e de produção.
- Produção: https://api.clippfacil.com.br
- Homologação: https://app.homolog.clippfacil.com.br
Nas demais demonstrações vamos usar a variável AMBIENTE para demonstrar o ambiente.
export AMBIENTE=https://app.homolog.clippfacil.com.br
Padrão dos serviços
Todos os serviços seguem a seguinte nomenclatura:
$AMBIENTE/rpc/v1/$MODULO.$SERVICO
Módulo e serviço variam de acordo com o que parte do sistema está sendo utilizada.
Exemplo:
#listar nfe's
https://app.homolog.clippfacil.com.br/rpc/v1/fiscal.get-nfe
#criar nfe
https://app.homolog.clippfacil.com.br/rpc/v1/fiscal.post-nfe
#atualizar nfe
https://app.homolog.clippfacil.com.br/rpc/v1/fiscal.put-nfe
#deletar nfe
https://app.homolog.clippfacil.com.br/rpc/v1/fiscal.delete-nfe
Autenticação
A autenticação se dá através do seguinte serviço:
curl "$AMBIENTE/rpc/v1/application.authenticate" \
-H 'Content-Type: application/json' \
--data '
{
"login": "teste@gmail.com",
"password": "teste"
}
'
Na resposta de uma autenticação com sucesso conterá o token que dever ser trafegado nas requisições autenticadas.
{
"status": 1,
"access_token": "1be2b89c92aff78f9ffae8b408d80b2c2d8bcf0a",
"default_lang": "pt_BR",
"is_admin": true
}
Usaremos a variável token para demonstrações daqui em diante.
export TOKEN=1be2b89c92aff78f9ffae8b408d80b2c2d8bcf0a
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.
Veja mais como utilizar nossa api no menu Exemplos.
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.
Contato
Qualquer dúvida sobre a API entre em contato com nosso time técnico. Através do e-mail contato@clippfacil.com.br.