Ecommerce¶

Documento de Integração FoccoERP - E-commerce - Relação de Webservices¶

1. Introdução¶

Esse documento identifica os webservices que são utilizados para a integração entre as aplicações de e-commerce e Focco. Estão definidos aqui os endereços dos webservices, bem como seus parâmetros de entrada e saída.

No endereço dos webservices abaixo descritos, há o trecho “<endereçoERP>” nos mesmos que deve ser alterado conforme o cliente em questão. Esse endereço será o link de acesso à aplicação web da Focco. Todos as requisições aos webservices devem ter, em seu cabeçalho a chave “Content-Type” como “application/json”.

Segue, abaixo, a relação de webservices.

2. Requisitar Acesso¶

Endereço:¶

URL: <endereçoERP>/api/authentication/requestaccess

Esse webservice irá realizar a requisição de autenticação com o sistema.

Entrada:¶

Parâmetros	Descrição
ClientID	Deve ser passado fixo como “ECOMMERCE”, que define o tipo de autenticação para essa aplicação em específico.
User	Deve ser um usuário de conexão ao FoccoERP, cadastrado pelo próprio cliente para o e-commerce.
Password	Deve ser a senha de conexão do usuário ao FoccoERP, cadastrado pelo próprio cliente para o e-commerce.
KillOthersSessions	Define se irá encerrar as sessões abertas do usuário informado ao realizar a autenticação. Como a aplicação de eCommerce permite várias conexões simultâneas, deve ser passado como “false”.

Exemplo:

{
    ClientID: "ECOMMERCE",
    User: "<usuário>",
    Password: "<senha>",
    KillOtherSessions: false
}

Saída:¶

O json de retorno da requisição de autenticação irá retornar um token que deverá ser utilizado no cabeçalho das outras chamadas de webservices, na chave “Authorization”, com a seguinte informação: “Bearer <token>”

Exemplo:

{
    "$id": "32282",
    "ErrorReason": 0,
    "CustomErrorMessage": null,
    "Token": "CfDJ8N9H4sMCRcZJj7vaStaDeKjUduS6BEpAXl6KimLfnZWDfD2GunFWISyFgqQasaSD77Q9jcqhAM3tOhSwiRj0vTr8UEhKjo1_E6DPa1nBqrD6AggY6fpdaTXIhRhFYp1ETjwst86Vddu3f3tqXSn0RlbwzlPH