Mudanças entre as edições de "2- Koncili"

De Tek-System Wiki
Ir para navegação Ir para pesquisar
 
(12 revisões intermediárias pelo mesmo usuário não estão sendo mostradas)
Linha 1: Linha 1:
== Integração Financeira ==
Integração financeira para a baixa de repasses realizados pela Koncili, bem como a conciliação desses repasses com os movimentos financeiros gerados no sistema ERP da Tek-System. A integração visa garantir precisão e eficiência na gestão financeira, proporcionando uma visão consolidada e atualizada das transações.
Integração financeira para a baixa de repasses realizados pela Koncili, bem como a conciliação desses repasses com os movimentos financeiros gerados no sistema ERP da Tek-System. A integração visa garantir precisão e eficiência na gestão financeira, proporcionando uma visão consolidada e atualizada das transações.


Linha 10: Linha 12:
*MAGALU (Magazine Luiza)
*MAGALU (Magazine Luiza)
*AMAZON
*AMAZON
'''Durante a implantação da integração em clientes é IMPORTANTE a homologação de todos os canais disponíveis!'''
== Requisitos Tek-System ==
  Liberar funcionalidade na licença para utilização da integração: '''INTEGRACAO_KONCILI'''
  Liberar processamentos específicos para utilização pelo usuário:
  => INTEGRAÇÕES: Notificar Liquidação de Duplicatas
  => INTEGRAÇÕES: Liquidação de Duplicatas


== Configuração da Tek Store ==
== Configuração da Tek Store ==


Configurar na Tek Store, na unti de configuração da TEK INTEGRAÇÕES o canal KONCILI, os grupos de resultado, contas e financeiras para cada marketplace que serão utilizados.
Configurar na Tek Store, na unit de configuração da TEK INTEGRAÇÕES o canal KONCILI, os grupos de resultado, contas e financeiras para cada marketplace que serão utilizados.


   ...
   ...
Linha 77: Linha 89:
   }
   }
   ...
   ...


   '''Integracao_CodOrgao''': Código do órgão dentro do ERP correspondente a Koncili
   '''Integracao_CodOrgao''': Código do órgão dentro do ERP correspondente a Koncili
Linha 89: Linha 100:
   '''gr_taxas''': Grupo de resultado onde serão lançados os valores referente as taxas ou diferenças na liquidação das duplicatas.
   '''gr_taxas''': Grupo de resultado onde serão lançados os valores referente as taxas ou diferenças na liquidação das duplicatas.
   '''gr_comissao''': Grupo de resultado para a comissão descontada pelo marketplace
   '''gr_comissao''': Grupo de resultado para a comissão descontada pelo marketplace
== Processamentos Específicos ==
=== INTEGRAÇÕES: Liquidação de Duplicatas ===
Processamento específico para ser executado no Borderô de Recebimento com tipo de acerto por Financeira.
Realizar a inclusão de um borderô de recebimento já informando a Financeira correspondente ao marketplace na data do movimento, e com o borderô em edição executar o processamento.
A identificação do título será através da Ordem de Compra referente ao Documento importado no sistema ERP.
Ao final do processamento, será apresentado e gravado no borderô um resumo dos processos interpretados, resumo dos dados da API, e um log de registros que não foram localizados, registros cancelados, ou não baixados por alguma divergência de valor (Vlr Pago na Koncili maior que o Valor em Aberto no ERP por exemplo).
Serão atribuídos as duplicatas baixadas duas tags com informações de status (Baixa Pendente) e id do registro na Koncili. As tags serão utilizadas para baixa dos repasses na Koncili.
=> KONCILI: Status
=> KONCILI: Id de Registro
=== INTEGRAÇÕES: Notificar Liquidação de Duplicatas ===
Processamento específico para notificar a integração os repasses baixados pelo sistema ERP.
Ao executar, o processamento irá baixar os repasses na Koncili e atualizar o status(Baixa Realizada) da Tag (KONCILI: Status) na Duplicata.
== Indicador de Chave de Desempenho ==
=== INTEGRAÇÕES: Qtd. de Duplicatas Pendentes de Envio ===
Indicador para exibir quantidade de Duplicatas liquidadas e que estão pendentes de envio para baixa do repasse na Koncili.
Além da exibição da quantidade, será possível detalhar as duplicatas pendentes para baixa do repasse na Koncili.
Utilizar configuração de Parâmetro no Indicador:
{
  "canal": "KONCILI"
}

Edição atual tal como às 21h50min de 2 de julho de 2025

Integração Financeira

Integração financeira para a baixa de repasses realizados pela Koncili, bem como a conciliação desses repasses com os movimentos financeiros gerados no sistema ERP da Tek-System. A integração visa garantir precisão e eficiência na gestão financeira, proporcionando uma visão consolidada e atualizada das transações.

Disponível utilização para os canais:

  • B2W
  • NETSHOES
  • MERCADOLIVRE
  • CNOVA (Via Varejo)
  • WALMART
  • MAGALU (Magazine Luiza)
  • AMAZON
Durante a implantação da integração em clientes é IMPORTANTE a homologação de todos os canais disponíveis!

Requisitos Tek-System

 Liberar funcionalidade na licença para utilização da integração: INTEGRACAO_KONCILI
 Liberar processamentos específicos para utilização pelo usuário:
 => INTEGRAÇÕES: Notificar Liquidação de Duplicatas
 => INTEGRAÇÕES: Liquidação de Duplicatas

Configuração da Tek Store

Configurar na Tek Store, na unit de configuração da TEK INTEGRAÇÕES o canal KONCILI, os grupos de resultado, contas e financeiras para cada marketplace que serão utilizados.

 ...
 {
 	"canal": "KONCILI",
 	"Integracao_CodOrgao": 0,
 	"Integracao_Ambiente": 0,
 	"Integracao_Email": "",
 	"Integracao_Senha": "",
 	"Integracao_Token": "",
 	"Integracao_Financeiras": [
 		{
 			"marketplace": "B2W",
 			"financeira": 0,
 			"conta": 0,
 			"gr_taxas": 0,
 			"gr_comissao": 0
 		},
 		{
 			"marketplace": "NETSHOES",
 			"financeira": 0,
 			"conta": 0,
 			"gr_taxas": 0,
 			"gr_comissao": 0
 		},
 		{
 			"marketplace": "MERCADOLIVRE",
 			"financeira": 0,
 			"conta": 0,
 			"gr_taxas": 0,
 			"gr_comissao": 0
 		},
 		{
 			"marketplace": "CNOVA",
 			"financeira": 0,
 			"conta": 0,
 			"taxa_pedido": 0,
 			"gr_taxas": 0,
 			"gr_comissao": 0
 		},
 		{
 			"marketplace": "WALMART",
 			"financeira": 0,
 			"conta": 0,
 			"gr_taxas": 0,
 			"gr_comissao": 0
 		},
 		{
 			"marketplace": "MAGALU",
 			"financeira": 0,
 			"conta": 0,
 			"gr_taxas": 0,
 			"gr_comissao": 0
 		},
 		{
 			"marketplace": "AMAZON",
 			"financeira": 0,
 			"conta": 0,
 			"gr_taxas": 0,
 			"gr_comissao": 0
 		}
 	]
 }
 ...
 Integracao_CodOrgao: Código do órgão dentro do ERP correspondente a Koncili
 Integracao_Ambiente: Indicar se ambiente de 0-homologação ou 1-produção
 Integracao_Email: Indicar o e-mail de usuário para acesso as informações na Koncili
 Integracao_Senha: Indicar a senha para autenticação na Koncili
 Integracao_Token: Indicar o token de acesso a Koncili
 marketplace: Identificação do marketplace pela Koncili. Disponível documentação da Koncili
 financeira: Código da Financeira correspondente ao Marketplace dentro do ERP
 conta: Código da Conta no ERP em que foi realizado o repasse dos valores pelo Marketplace
 gr_taxas: Grupo de resultado onde serão lançados os valores referente as taxas ou diferenças na liquidação das duplicatas.
 gr_comissao: Grupo de resultado para a comissão descontada pelo marketplace

Processamentos Específicos

INTEGRAÇÕES: Liquidação de Duplicatas

Processamento específico para ser executado no Borderô de Recebimento com tipo de acerto por Financeira.

Realizar a inclusão de um borderô de recebimento já informando a Financeira correspondente ao marketplace na data do movimento, e com o borderô em edição executar o processamento.
A identificação do título será através da Ordem de Compra referente ao Documento importado no sistema ERP.
Ao final do processamento, será apresentado e gravado no borderô um resumo dos processos interpretados, resumo dos dados da API, e um log de registros que não foram localizados, registros cancelados, ou não baixados por alguma divergência de valor (Vlr Pago na Koncili maior que o Valor em Aberto no ERP por exemplo).
Serão atribuídos as duplicatas baixadas duas tags com informações de status (Baixa Pendente) e id do registro na Koncili. As tags serão utilizadas para baixa dos repasses na Koncili.
=> KONCILI: Status
=> KONCILI: Id de Registro

INTEGRAÇÕES: Notificar Liquidação de Duplicatas

Processamento específico para notificar a integração os repasses baixados pelo sistema ERP.

Ao executar, o processamento irá baixar os repasses na Koncili e atualizar o status(Baixa Realizada) da Tag (KONCILI: Status) na Duplicata.

Indicador de Chave de Desempenho

INTEGRAÇÕES: Qtd. de Duplicatas Pendentes de Envio

Indicador para exibir quantidade de Duplicatas liquidadas e que estão pendentes de envio para baixa do repasse na Koncili.

Além da exibição da quantidade, será possível detalhar as duplicatas pendentes para baixa do repasse na Koncili.

Utilizar configuração de Parâmetro no Indicador:

{
  "canal": "KONCILI"
}