Mudanças entre as edições de "Totall Middleware"

De TotaliWiki
Ir para: navegação, pesquisa
 
(14 revisões intermediárias por 4 usuários não estão sendo mostradas)
Linha 1: Linha 1:
{{Tags|Totall Commerce}}
+
{{Tags|Totall Middleware}}
{{Referencias}}
+
{{MenuLateral|[[Instalação do Totall Middleware (Instalador)|Instalação do Totall Middleware]]|[[Configurações do Totall Middleware]]|[[Arquitetura do Totall Middleware]]|[[Atualização do Totall Middleware]]|[[Mensageria do Totall Middleware]]}}
 +
=Resumo=
 +
Esse artigo trata do Totall Middleware que é um software encarregado de mediar dados distintos, tendo como entrada diversos instrumentos de leitura e sensores com unidades variadas, o middleware se encarrega de filtrar e refinar toda a informação entre os softwares Totall POS, Totall CheckOutNF, Totall Commerce WEB e demais aplicações como SEFAZ por exemplo.<br/>
 +
<br/>
 +
O Totall Middleware possui um banco de dados PostgreSQL próprio que chamamos de (Guarda), utilizado para diversos fins, como por exemplo:
 +
* Guardar configurações;<br/>
 +
* Guardar documentos eletrônicos emitidos, de forma unificada.<br/>
 +
<br/>
 +
=Requisitos de Hardware e Software=
 +
Nessa seção apresentamos os requisitos mínimos de hardware e de software para instalação ou execução do Totall Middleware.<br/>
 +
==Mínimos==
 +
'''Sistema Operacional:''' Windows 10 64 bits<br/>
 +
'''Espaço em Disco:''' 10 GB SSD <br/>
 +
'''Memória RAM:''' 6 GB<br/>
 +
'''CPU:''' Processador Intel I3 ou superior<br/>
  
== Visão Geral ==
+
==Recomendados==
 +
'''Sistema Operacional:'''  Windows Server 2022 64 Bits<br/>
 +
'''Espaço em Disco:''' 20 GB SSD <br/>
 +
'''Memória RAM:''' 8 GB<br/>
 +
'''CPU:''' Processador Intel I5 ou superior<br/>
 +
<br/>
  
O Totall Middleware é um serviço do Windows que fornece a outros módulos acesso via WebServices às APIs da Totall.
+
=Arquitetura do Totall Middleware=
 
+
A arquitetura de software é descrição na forma de modelos, de diferentes visões do sistema em termos de unidade (partes) que interagem entre si. Veja no diagrama a relação do Totall Middleware com o CheckOutNF, SEFAZ, Banco do Totall Commerce, Banco do Middleware e SATs.<br/>
Atualmente ele abriga às seguintes APIs:
+
<br/>
 
+
[[Arquivo:Middleware01.jpg|900px]]<br/>
* Checkout API;
+
<br/>
* Middleware API;
+
=Papéis do Middleware=
* NFe API;
+
Conheça os papéis/funções do Totall Middleware que de acordo com as circunstâncias desempenha até 3 papéis:<br/>
* Commerce API;
+
*Middleware Matriz.<br/>
* Impostos API.
+
*Middleware Filial.<br/>
 
+
*Middleware Local.<br/>  
O Totall Middleware possui um banco de dados PostgreSQL próprio utilizado para diversos fins, como por exemplo:
+
<br/>
* Guardar configurações;
+
==Middleware da Matriz==
* Guardar documentos eletrônicos emitidos.
+
O Middleware da Matriz possui acesso ao banco de dados local do Middleware (guarda) e exclusivamente ao banco de dados do Totall Commerce.<br/>
 
+
* É permitido que exista apenas um Middleware Matriz para que a conexão com o banco de dados do Totall Commerce não tenha que trafegar por link de internet.<br/>
<gallery>
+
* Deve ser instalado na mesma rede local onde o banco de dados do Totall Commerce está.<br/>
Middleware-geral-1.png|Pasta do Middleware 1
+
[[Arquivo:Middleware02.jpg|500px]]<br/>
Middleware-geral-2.png|Pasta do Middleware 2
+
<br/>
Middleware-geral-3.png|Configurador do Middleware
+
==Middleware da Filial==
Middleware-geral-4.png|Serviço do Windows
+
O Middleware da Filial não tem acesso ao banco de dados do Totall Commerce, mas possui acesso ao banco de dados local.<br/>
Middleware-geral-5.png|Acesso por Navegador
+
* É permitido que exista apenas um por filial.<br/>
</gallery>
+
* Aconselhamos que o Middleware da Filial aponte a replicação para o Middleware Matriz para que sejam guardadas as notas de forma unificada e assim permitindo alguns processos que necessitam dos documentos eletrônicos emitidos pelas filiais. Veja o artigo [[Configurações do Totall Middleware]].<br/>
 
+
[[Arquivo:Middleware03.jpg|500px]]<br/>
== Arquitetura ==
+
<br/>
 
+
==Middleware Local==
No artigo [[Arquitetura do Totall Middleware]] você encontrará alguns diagramas feitos para explicar a relação do Middleware com o Checkout NF, SEFAZ, Banco do Totall Commerce, Banco do Middleware e SATs.
+
O Middleware Local é responsável pela comunicação entre o CheckOutNF e a impressora não fiscal e outros periféricos.<br/>
 
+
* É instalado automaticamente pelo instalador do CheckOutNF, portanto o serviço deve ser instalado nas máquinas que emitem CF-e (Caixas) e um por caixa.<br/>
== Manutenção ==
+
* O instalador do CheckOutNF não instala o PostgreSQL, portanto não possui banco de dados.<br/>
 
+
* O nome do serviço instalado é Totall Middleware Checkout.<br/>
* [[Instalação do Totall Middleware|Como Instalar (Manual)]]
+
[[Arquivo:Middleware04.jpg|200px]]<br/>
* [[Instalação do Totall Middleware (Instalador)|Como Instalar (Instalador)]]
+
<br/>
* [[Atualização do Totall Middleware|Como Atualizar]]
+
'''Considerações:'''
* [[Atualização do Totall Middleware#Atualização através do Instalador|Como Atualizar (Instalador)]]
+
* Se o Cupom Fiscal Eletrônico foi emitido e não impresso deve ser verificado:
* [[Backup do Totall Middleware|Como Fazer Backup do Banco Local]]
+
'''''' se a impressora não fiscal está conectada na porta COM correta. Veja a seção CheckoutNF Comunicando com o Middleware do artigo [[CF-e - Cupom Fiscal Eletrônico]].<br/>
 
+
'''''' se o serviço do Middleware Local está ativo. Acesse {{Tela|Painel de Controle|Ferramentas Administrativas|Serviços}} verifique o status do serviço Totall Middleware Checkout.<br/>
== Configurações ==
+
<br/>
 
+
=Versão=
* [[Configurações do Totall Middleware|Como Configurar]]
+
Para verificar a versão do Totall Middleware basta chamar o executável utilizando o parâmetro VERSION.<br/>
 
+
C:\TotallMiddleware\TotallMiddlewareService.exe VERSION<br/>
== Funcionalidades ==
+
[[Arquivo:Middleware_version.png]]<br/>
 
+
<br/>
O Totall Middleware é utilizado nas seguintes funcionalidades, que estão divididas por sistemas.
+
<br/>
 
+
<small>{{Referencias}}</small>
=== Checkout NF ===
+
 
+
* Utilização de impressora não fiscal;
+
* Emissão de NFC-e;
+
* Cancelamento de NFC-e;
+
* Impressão de DANFE de NFC-e;
+
* Impressão de cancelamento de NFC-e;
+
* Emissão de NFC-e em contingência;
+
* Serviço de envio de NFC-e em contingência após retorno do SEFAZ;
+
* Impressão de NFC-e em contingência;
+
* Extrair XMLs das NFC-es emitidas.
+
 
+
=== Checkout 4G ===
+
 
+
* Cálculo de impostos;
+
* Utilização de ECF para emissão de CF;
+
* Geração de XML de NF-e;
+
* Geração de XML de NFC-e;
+
* Emissão de NF-e e NFC-e;
+
* Cancelamento de NF-e e NFC-e;
+
* Impressão de DANFE de NF-e e NFC-e;
+
* Impressão de cancelamento de NF-e e NFC-e;
+
* Emissão de NFC-e em contingência;
+
* Impressão de NFC-e em contingência.
+
* Gravação das transações na retaguarda;
+
 
+
=== Commerce Web ===
+
 
+
* Separação de mercadorias;
+
* Impressão de cancelamento de seguro;
+
* Devolução de Notas na Web;
+
 
+
=== Gerais ===
+
 
+
* Autenticação para acesso às APIs do Middleware;
+
* Migração da base local;
+
* Serviço de importação de inventário [TI_INV];
+
* Serviço de importação de separações [TI_SEP];
+
* Serviço de envio de NFC-e em contingência após retorno do SEFAZ;
+
 
+
== APIs ==
+
 
+
O Middleware permite outros aplicativos acessem suas APIs utilizando WebServices.<br/>
+
Alguns desses WebServices são REST passando dados no formato '''JSON'''.<br/>
+
Outros são '''SOAP'''.
+
 
+
Algumas APIs estão disponíveis para o Middleware '''Local''', outras para o Middleware '''Filial''' e outras para Middleware '''Matriz'''.<br/>
+
Leia mais sobre papéis dos Middlewares em [[Arquitetura do Totall Middleware]].
+
 
+
=== Checkout API ===
+
 
+
:TImpressoraNaoFiscalAPI (JSON / Local)
+
:IImpressoraNaoFiscal (SOAP / Local)
+
:ITotallBALWS (SOAP / Local)
+
:ITotallECFWS (SOAP / Local)
+
 
+
=== Middleware API ===
+
 
+
:TConexaoAPI (JSON / Filial)
+
 
+
=== Commerce API ===
+
 
+
:TCommerceAPI (JSON / Matriz)
+
 
+
=== NFe API ===
+
 
+
:TNFeAPI (JSON / Filial)
+
:TNFeLocalAPI (JSON / Local)
+
:INFeWS (SOAP / Local)
+
 
+
=== Impostos API ===
+
 
+
:ITImpostosWS (SOAP / Local)
+

Edição atual tal como às 15h06min de 1 de março de 2023

Tag-icone-mini.png Totall Middleware

Resumo

Esse artigo trata do Totall Middleware que é um software encarregado de mediar dados distintos, tendo como entrada diversos instrumentos de leitura e sensores com unidades variadas, o middleware se encarrega de filtrar e refinar toda a informação entre os softwares Totall POS, Totall CheckOutNF, Totall Commerce WEB e demais aplicações como SEFAZ por exemplo.

O Totall Middleware possui um banco de dados PostgreSQL próprio que chamamos de (Guarda), utilizado para diversos fins, como por exemplo:

  • Guardar configurações;
  • Guardar documentos eletrônicos emitidos, de forma unificada.


Requisitos de Hardware e Software

Nessa seção apresentamos os requisitos mínimos de hardware e de software para instalação ou execução do Totall Middleware.

Mínimos

Sistema Operacional: Windows 10 64 bits
Espaço em Disco: 10 GB SSD
Memória RAM: 6 GB
CPU: Processador Intel I3 ou superior

Recomendados

Sistema Operacional: Windows Server 2022 64 Bits
Espaço em Disco: 20 GB SSD
Memória RAM: 8 GB
CPU: Processador Intel I5 ou superior

Arquitetura do Totall Middleware

A arquitetura de software é descrição na forma de modelos, de diferentes visões do sistema em termos de unidade (partes) que interagem entre si. Veja no diagrama a relação do Totall Middleware com o CheckOutNF, SEFAZ, Banco do Totall Commerce, Banco do Middleware e SATs.

Middleware01.jpg

Papéis do Middleware

Conheça os papéis/funções do Totall Middleware que de acordo com as circunstâncias desempenha até 3 papéis:

  • Middleware Matriz.
  • Middleware Filial.
  • Middleware Local.


Middleware da Matriz

O Middleware da Matriz possui acesso ao banco de dados local do Middleware (guarda) e exclusivamente ao banco de dados do Totall Commerce.

  • É permitido que exista apenas um Middleware Matriz para que a conexão com o banco de dados do Totall Commerce não tenha que trafegar por link de internet.
  • Deve ser instalado na mesma rede local onde o banco de dados do Totall Commerce está.

Middleware02.jpg

Middleware da Filial

O Middleware da Filial não tem acesso ao banco de dados do Totall Commerce, mas possui acesso ao banco de dados local.

  • É permitido que exista apenas um por filial.
  • Aconselhamos que o Middleware da Filial aponte a replicação para o Middleware Matriz para que sejam guardadas as notas de forma unificada e assim permitindo alguns processos que necessitam dos documentos eletrônicos emitidos pelas filiais. Veja o artigo Configurações do Totall Middleware.

Middleware03.jpg

Middleware Local

O Middleware Local é responsável pela comunicação entre o CheckOutNF e a impressora não fiscal e outros periféricos.

  • É instalado automaticamente pelo instalador do CheckOutNF, portanto o serviço deve ser instalado nas máquinas que emitem CF-e (Caixas) e um por caixa.
  • O instalador do CheckOutNF não instala o PostgreSQL, portanto não possui banco de dados.
  • O nome do serviço instalado é Totall Middleware Checkout.

Middleware04.jpg

Considerações:

  • Se o Cupom Fiscal Eletrônico foi emitido e não impresso deve ser verificado:

se a impressora não fiscal está conectada na porta COM correta. Veja a seção CheckoutNF Comunicando com o Middleware do artigo CF-e - Cupom Fiscal Eletrônico.
se o serviço do Middleware Local está ativo. Acesse Painel de Controle >>> Ferramentas Administrativas >>> Serviços verifique o status do serviço Totall Middleware Checkout.

Versão

Para verificar a versão do Totall Middleware basta chamar o executável utilizando o parâmetro VERSION.
C:\TotallMiddleware\TotallMiddlewareService.exe VERSION
Middleware version.png