Portal de Documentação

Appearance

Home Portal Cloud

Tag-icone-mini.png Totali Middleware

  1. Arquitetura do Totali Middleware

Conceito ​

O Middleware permite que outros aplicativos acessem suas APIs utilizando WebServices.

  1. Alguns desses WebServices são REST passando dados no formato JSON e outros são SOAP passando dados no formato XML.
  2. As APIs estão disponíveis no Middleware conforme sua Arquitetura Local, Filial e Matriz havendo uma herança dos métodos conforme nivel da Arquitetura.
    1. Local - Disponibiliza métodos sem dependências de comunicação com Banco de Dados seja da "Guarda" ou "Commerce" como por exemplo: Impressão de Boleto.
    2. Filial - Disponibiliza métodos de Autenticação de documentos eletrônicos e outros processos com uso da "Guarda" como por exemplo: Autenticação da NFCe/NFe/SAT-CFe.
    3. Matriz - Disponibiliza métodos que tem dependência de acesso a base do "Totali Commerce" como por exemplo: Devolução, Emissão Nota de Transferência, Registro de DAV, Cadastro de Parceiro.

Autenticação e troca de informações ​

Na API REST é necessário enviar os parâmetros da requisição em formato JSON padrão com exceção dos métodos que não validam sessão.
Exemplo:

{ "Parametros": { "Id":<id_de_conexao>, "Dados":<parametros_do_serviço> }, "Assinatura":"<assinatura_do_parametro>" }

"Id" É o ID retornado pelo método Conecta Middleware.
"Dados" será o JSON conforme definido no "Parâmetros de Entrada" do método utilizado.
"Assinatura" será o MD5 de todo o bloco "Parametros" (apenas letras e número, sem caracteres especiais) + (Chave da Empresa que deve ser Solicitada a Totali).
Dessa forma, não precisamos nos preocupar se o parâmetro "Dados" é um texto, um número, um outro objeto JSON, ou qualquer outro tipo, uma vez que o bloco como um todo será assinado.

Parâmetros da Requisição ​

ContentType : application/json;charset=UTF-8
Tipo : rest
API : Nome da API do Método
Metodo : Nome do Método

Tipo de Autenticação da Requisição ​

Authorization : Basic
Username : "Solicitar a TOTALI"
Password : "Solicitar a TOTALI"

URL ​

IP : 127.0.0.1
Porta : 8080
Resource : /middleware/rest/

Exemplo:
http://127.0.0.1:8080/middleware/rest/ + Parâmetros da Requisição

Segurança ​

Para acesso externo a API deve-se solicitar para o Administrador de rede a liberação da Porta configurada para o "Totali Middleware" no Firewall controlando a entrada de requisição apenas da rede interna e do IP externo desejado.

APIs Totali Middleware ​