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.