1. Identificação do aplicativo
| Nome | KGS Integrador de Pedidos |
|---|---|
| Tipo | Aplicação desktop para Microsoft Windows |
| Responsável técnico | KGS Informática |
| Site oficial | https://kgsinformatica.com/integradorKGS/ |
| Finalidade | Integração de pedidos autorizados de marketplaces com o ERP do vendedor |
2. Finalidade
O KGS Integrador de Pedidos foi desenvolvido para uso operacional do vendedor. A aplicação consulta pedidos e atualizações das contas de marketplace que foram expressamente autorizadas pelo titular da conta, registra esses dados em um banco de integração e os disponibiliza ao ERP utilizado pelo cliente.
A aplicação não se apresenta como marketplace, não realiza vendas em nome próprio e não solicita a senha da conta do vendedor para consultar a API.
3. Arquitetura
O sistema é distribuído como um executável Windows Forms separado dos demais módulos da KGS. Cada cliente executa sua própria instalação, enquanto o servidor MySQL pode ser configurado para atender várias instalações.
Marketplace autorizado
↓
KGS Integrador de Pedidos (Windows)
↓
Banco de integração MySQL
↓
ERP do vendedor
Cada cliente é identificado por CNPJ. As contas são separadas por marketplace e número lógico da conta, permitindo evolução futura para múltiplas contas por plataforma.
4. Processo de autorização
Quando a plataforma utiliza OAuth ou fluxo equivalente, o operador inicia a autorização no aplicativo. O navegador é direcionado à página oficial do marketplace, onde o titular entra na própria conta e concede as permissões apresentadas.
- O operador seleciona a plataforma e inicia a autorização.
- O navegador abre o endereço oficial do marketplace.
- O titular da conta confirma o acesso solicitado.
- A plataforma retorna um código temporário ao endereço de retorno cadastrado.
- O integrador troca o código por tokens e passa a consultar apenas os recursos autorizados.
5. Dados processados
Conforme a disponibilidade e a permissão da plataforma, o integrador pode processar:
- identificador, status e datas do pedido;
- itens, SKU, variação, quantidade e valores;
- informações de pagamento e descontos necessárias à conciliação;
- nome e dados de contato disponibilizados para atendimento e entrega;
- endereço e informações logísticas necessárias ao cumprimento do pedido;
- transportadora, modalidade de envio e rastreamento;
- resposta original da API para auditoria e suporte técnico.
O aplicativo deve solicitar somente permissões relacionadas às funções efetivamente utilizadas.
6. Armazenamento e retenção
Os dados são gravados no banco MySQL configurado pelo cliente. O servidor, usuário, senha, porta e nome do banco são definidos na instalação. A KGS não publica credenciais, tokens ou conteúdo dos pedidos nesta página.
O período de retenção é definido pelo responsável pelo ambiente do cliente, considerando obrigações operacionais, fiscais e legais aplicáveis.
7. Integração com o ERP
O banco utiliza tabelas genéricas para pedidos de diferentes marketplaces. O ERP consulta pedidos pendentes, importa os dados necessários e informa o resultado diretamente no registro do pedido.
Campos de controle permitem registrar a situação da importação, data, identificador interno do ERP, quantidade de tentativas e última mensagem de erro. O conteúdo original recebido da API permanece preservado para auditoria.
8. Práticas de segurança
- uso de HTTPS nos fluxos públicos de autorização;
- assinatura de requisições conforme as regras de cada API;
- proteção local de segredos e tokens sensíveis;
- restrição de acesso ao banco por usuário e senha configuráveis;
- registro técnico de sincronizações e falhas;
- não inclusão de chaves, tokens ou senhas em páginas públicas;
- atualização dos tokens dentro dos prazos definidos pela plataforma.
9. Revogação e exclusão
O vendedor pode revogar a autorização utilizando os recursos disponibilizados pelo marketplace. Após a revogação, o integrador deixa de obter novos dados daquela conta.
Solicitações de remoção de credenciais ou dados armazenados devem ser feitas pelo responsável autorizado do cliente. A exclusão é executada no ambiente de banco configurado para a instalação, observando eventuais obrigações legais de retenção.
10. Suporte
O atendimento é realizado pela KGS Informática pelos canais oficiais informados na página de suporte. Por segurança, solicitações envolvendo acesso, revogação ou exclusão podem exigir confirmação da identidade do responsável pelo cliente.
Documento atualizado em 16 de julho de 2026.