Tutorial - Conciliação Marketplace - Monitor de Conciliação

1. Visão Geral
2. Cadastros envolvidos
   1. Layout Genérico (UTB060AA)
   2. Cadastro de Marketpalce (html.registerMarketplace)
3. Monitor Conciliação Marketplace
   
   1. Importar Arquivo
   2. Consultar as informações importadas da conciliação e seus movimentos
   3. Processar conciliação
   4. Estornar a conciliação e/ou movimentos
   5. Ajustar situação da conciliação e/ou dos movimentos
   6. Eliminar a conciliação e/ou movimentos
   7. Conciliação Manual
4. Lote Marketplace
5. Tabelas envolvidas
6. Documentações úteis

01. VISÃO GERAL

No comércio eletrônico intermediado por Marketplaces, o risco de crédito é assumido pelos mesmos. Ou seja, a empresa vendedora não receberá os valores do consumidor final e sim receberá os repasses do Marketplace de acordo com taxas e prazos estabelecidos entre as partes.

A funcionalidade Conciliação Repasses Marketplace permite receber os arquivos de conciliação, conferir, buscar os títulos a receber relativos ao pedidos de venda, liquidá-los, lançar as comissões e os fretes cobrados, além de outros lançamentos avulsos.

É necessário importar o menu atualizado do Contas a Receber (univdata/men_acr.d) para utilizar as funcionalidades.

Versões: A partir da 12.1.2301, com refrofit para 12.1.34.15, 12.1.2205.10 e 12.1.2209.5.

02. CADASTROS ENVOLVIDOS

a. LAYOUT GENÉRICO (UTB060AA)

O cadastro de layout genérico será usado para parametrizar as interfaces de entrada para diferentes transações. No momento, a transação disponível é a Pagto Marketplace, operação de Importação, Tipo arquivo: TXT com delimitador.

Cada Marketplace poderá ter um layout específico, pois cada informação estará em uma coluna diferente.

Basta indicar qual é a coluna do arquivo delimitado em que estará cada informação:

Os campos de um layout parametrizado ficará semelhante ao demonstrado abaixo.

Restrições:

O arquivo de conciliação deverá ser do tipo texto com separador. Ponto-e-vírgula, por exemplo.

O separador de decimais dos campos de valor deverá ser vírgula.

Os campos de valor não deverão ter os símbolos das moedas (R$).

Os valores de repasse líquido e comissão de um pedido de venda deverá estar na mesma linha.

Observação: se não for possível parametrizar o layout genérico em função das características da interface do Marketplace, foi desenvolvida a API ACR563ZA - Importar conciliação Marketplace para importação dos movimentos através de customização.

b.  CADASTRO DE MARKETPLACE

Cada marketplace com que a empresa tenha relacionamento deverá ser cadastrado no programa html.registerMarketplace com suas respectivas transações e tratamentos.

.

Para maiores informações, consulte Tutorial - Conciliação Marketplace - Cadastro Marketplace

03. MONITOR CONCILIAÇÃO MARKETPLACE

O monitor Marketplace é o principal agregador de funções da Conciliação Marketplace.

Nele será possível:

• Importar arquivo de conciliação (planilhas texto).
• Consultar as informações importadas da conciliação e seus movimentos (linhas do arquivo).
• Processar a conciliação inteira ou movimento a movimento.
• Apresentar eventuais erros de processamento. Por exemplo, quando não se consegue localizar o título a receber vinculado ao pedido de venda do movimento de conciliação.
• Conciliar manualmente os movimentos que não têm processo tratado.
• Fazer o download do arquivo de conciliação original.
• Consultar as informações originais da linha importada.
• Consultar os lotes Marketplace gerados no processamento da conciliação (acr068aa).
• Consultar os títulos a receber vinculados a um movimento.
• Consultar os movimentos gerados (liquidação e acerto de valor a menor nos títulos a receber) de cada movimento da conciliação.
• Eliminar a conciliação e/ou movimentos.
• Estornar os movimentos de liquidação e avulsos gerados no processamento da conciliação.
• Ajustar situação da conciliação e dos movimentos quando ocorrer erro no estorno.
• Conciliar manualmente movimentos.

a. Importar Arquivo

Ao clicar no botão Importar Arquivo será solicitado o código do Marketplace, o arquivo a ser importado e o Servidor RPW para processamento.

Como já mencionado, o arquivo deve ser do tipo texto com separador de campos. A posição de cada informação será importada de acordo com o layout genérico cadastro no programa utb060aa e vinculado ao Marketplace no Cadastro de Marketplace.

Se ocorrerem quaisquer erros de importação, o status da conciliação será “Erro Importação” e os erros poderão ser consultados no botão “Erros”

b. Consultar as informações importadas da conciliação e seus movimentos

Depois de importado, as informações do arquivo podem ser consultadas no monitor.

A data da conciliação será a data de importação,  cada linha do arquivo corresponderá a um movimento e a situação inicial da conciliação será Pendente Processamento.

Filtros das Conciliações

No filtro rápido é possível buscar por Marketplace; código ou nome abreviado; e por data de conciliação.

Na busca avançada, é possível filtrar por Marketplace de forma múltipla, por situação (Aguardando importação, Importando, Erro Importação, Pendente Processamento, Processando, Erro Processamento, Sucesso Datasul e Erro Estorno) e por faixa de data de conciliação.

Expansão da Conciliação e totalizadores

Na conciliação será possível consultar o total de créditos, total de débitos e o repasse líquido; que é igual ao total de crédito menos o total de débitos.

Clicando na expansão do registro, será possível, consultar outras informações da conciliação, como a identificação da mesma que é um número sequencial criado automaticamente, por exemplo.

Depois da conciliação ser processada, será possível visualizar os Lotes Marketplace criados no botão Visualizar Lotes (será detalhada adiante).

No botão Arquivo Conciliação, será possível fazer o download do arquivo importado.

Quando acionado o botão Exportar, será exportado os dados da conciliação, dos movimentos, dos títulos relacionados aos movimentos e os movimentos gerados no ACR e CMG de cada conciliação separado por pastas de uma mesma planilha e este arquivo será disponibilizado na Central de Documentos.

Consultar movimentos da conciliação

Nas ações da Conciliação, clicando em Movimentos, serão apresentados os movimentos da conciliação. Cada movimento equivale a uma linha do arquivo de importação.

Filtros dos movimentos da conciliação

No filtro rápido é possível buscar por pedido de venda.

Na busca avançada, é possível filtrar por faixa de pedido de venda, por movimento (Liquidação, Avulso, Devolução ou Não tratado), por situação do movimento (Pendente Processamento, Processando, Erro Processamento, Sucesso Datasul, Erro Estorno e Manual) e por tipo movimento (Crédito ou Débito).

Expansão do movimento da conciliação

Na expansão do registro é possível consultar as informações de cada movimento.

Ao clicar no botão “Consulta Origem – Visualizar” serão apresentadas as informações originais da linha importada que corresponde ao movimento.

Ao clicar no botão Detalhar Títulos do Movimento serão apresentados os títulos a receber vinculados ao movimento Marketplace através do pedido do venda ou diretamente do título a receber indicado na importação. Se houver título vinculado, estas informações sempre são apresentadas, independentemente do processamento da conciliação.

Ao clicar no botão Detalhar Movimentos ACR – Origem serão apresentadas as movimentações do módulo de Contas a Receber geradas pelo processamento do movimento. Este botão será detalhado adiante.

Ao clicar no botão Detalhar Movimento Conta Corrente serão apresentadas as movimentações do módulo de Caixa e Bancos geradas pelo processamento do movimento. Este botão será detalhado adiante.

c. Processar conciliação

Após importar a conciliação e conferir os movimentos, será possível executar a ação “Processar”.

A ação de processar poderá ser realizada para Conciliações ou Movimentos com situação Pendente Processamento ou Erro Processamento.

Processar Conciliação

Processar movimento da conciliação

A ação de processar tem dois tratamentos específicos de acordo com o tipo da transação vinculada: Liquidação ou Avulso.

A liquidação consiste em gerar o lote marketplace de acordo com a data de pagamento que fará a liquidação do título a receber no valor do repasse líquido e os acertos de valor a menor relativos a comissão retido e ao frete cobrado pelo Marketplace.

O lançamento avulso pode gerar acertos de valor a menor ou a maior no título a receber ou lançamentos diretamente no Caixa e Bancos.

Liquidação e Movimento Avulso com Acerto no Título

Para Liquidação e lançamento avulso com acerto no título, a localização do título pode ocorrer de duas formas:

1. 1. Através do código do pedido de venda indicado no movimento.
   2. Através do próprio título a receber indicado no movimento no momento da importação.

Critérios para encontrar títulos a receber do movimento de conciliação:

• • Títulos com indicador econômico compatível com o indicador econômico corrente do estabelecimento (na prática, títulos em Reais).
  • Títulos com tipo de cobrança Normal (não Especial).
  • Títulos de espécie Normal.
  • Com saldo disponível na totalidade do valor de repasse líquido, comissão e frete do movimento Marketplace de liquidação e no valor do movimento para Avulso.
  • Que não estejam em borderô de desconto bancário.
  • Títulos com data de transação menor ou igual a data de pagamento do movimento.

A liquidação do título e o acertos de valor a menor serão realizados através da função Lote Marketplace (acr068aa). Para mais detalhes da função acesse Tutorial - Conciliação Repasses Marketplace - Lote Marketplace.

Avulso com Lançamento CMG (Caixa e Bancos)

Para movimentos do tipo Avulso com lançamento no CMG, não será necessário encontrar título a receber, sendo que o movimento é gerado diretamente no caixa e bancos na conta corrente e tipo de transação caixa indicados no cadastro de transação do Cadastro de Marketplace. Este tipo de movimentação pode ser usada para lançamento de tarifas, multas, etc.

Ao acionar a ação Processar na Conciliação serão solicitados os seguintes parâmetros, caso ainda não tenham sido informados:

Liquidar títulos a receber: se marcado, para movimentos Liquidação, os títulos encontrados no processamento serão agrupados em Lotes Marketplace (acr068aa) por data de pagamento e este lote Marketplace será automaticamente atualizado, gerando as liquidações e acertos de valor a menor (comissão e frete) nos títulos a receber. A situação do lote Marketplace e seus itens será “Atualizado” ao final do processo.

 Validar percentual de comissão:

• •  Se marcado, validará o percentual de comissão cobrado pelo Marketplace no movimento; Valor Comissão / (Valor Repasse Líquido +
    Valor Comissão + Valor Frete); em comparação ao percentual parametrizado no Cadastro de Marketplace. Se o percentual cobrado no movimento for maior, será apresentado erro e a liquidação não será realizada.
  • Se não marcado, será acatado o valor de comissão constante no movimento Marketplace sem qualquer validação.

Gerar Lançamentos Avulsos Caixa e Bancos: se marcado, para movimentos Avulso com ação "Lançamento CMG",  serão gerados os movimentos no módulo de Caixa e Bancos na conta corrente e com o tipo de transação caixa parametrizados para a transação do movimento conforme Cadastro de Marketplace.

Gerar Lançamentos Avulsos Títulos a Receber: se marcado, para movimentos Avulso com ação "Acerto Título",  serão gerados os movimentos de acerto de valor a maior ou a menor nos títulos a receber usando as contas contábeis parametrizadas para a transação do movimento conforme Cadastro de Marketplace.

Servidor RPW: o processamento de uma conciliação será sempre feito em servidor RPW previamente configurado.

Para alterar os parâmetros de processamento, basta clicar no botão Parâmetros nas telas de Conciliação ou Movimentos.

Resultado do processamento:

• Erro Processamento: quando ocorrer algum erro no processamento da conciliação ou de um ou mais movimentos. Os erros podem ser visualizados no botão “Erro” no Monitor de Conciliação.
• Sucesso Datasul: quando a conciliação ou movimentos forem processados com sucesso, ou seja, que as movimentações nos módulos de contas a receber e/ou caixa e bancos tenham sido geradas em erro.

Situações da conciliação (pai) e movimentos (filhos) depois do processamento:

• Sempre que ocorrer erro em algum movimento da conciliação a situação deste movimento será Erro Processamento e a situação da Conciliação (pai) será Pendente Processamento).
• Sempre que ocorrer erro geral na Conciliação, por falta de parâmetro, por exemplo; a situação da Conciliação será Erro Processamento e a situação dos movimentos (filhos) será pendente processamento).
• Quando todos os movimentos forem processados sem erros, a situação da conciliação (pai) será Sucesso Datasul.

Atenção: Lotes Marketplace gerados a partir do processamento através do Monitor Marketplace não poderão ser desatualizados, desconciliados ou eliminados no programa ACR068AA. Se houver necessidade, deve ser usada a função Estornar do próprio Monitor Marketplace.

Exemplo do resultado de processamento de uma conciliação

Conciliação com movimentos de Liquidação, Avulso "Acerto Título" e "Lançamento CMG".

Liquidação

No botão “Visualizar Lotes”, localizado na expansão do grid de Conciliações, é possível visualizar os Lotes Marketplace gerados para o movimento de Liquidação (no caso, lote 171).

No programa ACR068AA, Lotes Marketplace, poderá ser consultado o lote gerado. Para mais detalhes da função, acesse Tutorial - Conciliação Repasses Marketplace - Lote Marketplace.

60

No botão Visualizar – Detalhes Movimento ACR, localizado na expansão do grid de movimentos, é possível consultar os movimentos dos títulos a receber gerados pelo processamento da conciliação da liquidação (liquidação e acertos de valor a menor do valor da comissão e do frete).

Avulso - "Acerto Título"

No botão Visualizar – Detalhar Movimento ACR, localizado na expansão do grid de movimentos, é possível consultar os movimentos dos títulos a receber gerados pelo processamento do movimento Avulso com "Acerto título". No caso, foram usados 2 títulos para gerar o acerto pois ambos estavam relacionados com o pedido de venda rat2.

Avulso - "Lançamento CMG"

No botão Visualizar – Detalhar Movimento Conta Corrente, localizado na expansão do grid de movimentos, é possível consultar os movimentos na conta corrente do Caixa e Bancos gerados pelo processamento do movimento Avulso com "Lançamento CMG". 

d. Estornar a conciliação e/ou movimentos

Todos as movimentações geradas nos módulos de Contas a Receber e Caixa e Bancos no processamento da conciliação poderão ser estornados diretamente no Monitor. O estorno pode ocorrer para toda a conciliação ou para um movimento específico da mesma.

Estornar movimentações nos módulos a partir da Conciliação

Ao acionar a ação Estornar no grid de conciliações, serão solicitadas as seguintes informações:

Estornar nas Datas das Movimentações: se marcado, os estornos serão executados nas datas em que as movimentações originais foram feitas, ou seja, na data de transação das liquidações e dos acertos de valor.

Data Estorno: será possível informar a data de estorno se o campo "Estornar nas Datas das Movimentações" não estiver marcado. Informar a data de estorno pode ser útil se já ocorreram movimentações posteriores nos títulos que impeçam o estorno na data dos movimentos gerados no processamento.

Estornar Liquidações Títulos a Receber: se marcado, se abrirá um grid com os Lotes Marketplace gerados no processamento da conciliação e será possível marcar quais deverão ser estornados.

Estornar Lançamentos Avulsos Títulos a Receber: se marcado, serão estornados os acertos de valor a menor ou a maior gerados nos títulos a receber a partir dos movimentos Marketplace do tipo Avulso "Acerto Título".

Eliminar Lançamentos Avulsos Caixa e Bancos: se marcado, serão eliminados os movimentos de conta corrente do caixa e bancos gerados a partir dos movimentos Marketplace do tipo Avulso "Lançamento CMG". Não é possível reverter os movimentos de Caixa e Bancos gerados (entrada por saída ou vice-versa); apenas eliminar os movimentos gerados no processamento.

Servidor RPW: o estorno de uma conciliação será sempre feito em servidor RPW previamente configurado.

Estornar movimentações nos módulos a partir do Movimento da Conciliação

Ao acionar a ação Estornar no grid de movimentos da conciliação, serão solicitadas as seguintes informações:

Data Estorno: será possível informar a Data de Estorno que virá preenchida com a data em que as movimentações ocorreram.

Servidor RPW: o estorno de uma conciliação será sempre feito em servidor RPW previamente configurado.

Atenção: o estorno a partir de um movimento da conciliação sempre tentará estornar sua respectiva movimentação: item do lote Marketplace para liquidação, acertos de valor nos títulos a receber para movimento Avulso "Acerto Título" ou eliminar movimentação de conta corrente do Caixa e Bancos para movimento Avulso "Lançamento CMG".

Situação da conciliação e dos movimentos após o estorno

Se os estornos ocorrerem com sucesso a situação da conciliação e/ou de seus movimentos será "Pendente Processamento" e será possível executar a ação "Processar" novamente.

Se ocorrer algum erro durante o estorno a situação da conciliação e/ou de seus movimentos será "Erro Estorno" e os erros serão apresentados no botão "Erros":

e. Ajustar situação da conciliação e/ou dos movimentos

A ação Ajustar situação na conciliação e nos movimentos está disponível para conciliações ou movimentos com situação Erro Estorno.

Ao acioná-la no grid de movimentos, a situação é alterada para "Sucesso Datasul" e os erros apontados no estorno são apagados.

Ao acioná-la no grid de conciliação, os erros apontados no estorno são apagados e a situação é alterada para "Sucesso Datasul" se todos os movimentos estão com situação "Sucesso Datasul" ou para "Pendente Processamento" se algum movimento tem situação diferente de "Sucesso Datasul".

f. Eliminar a conciliação e/ou movimentos

É possível eliminar Conciliações e seus movimentos com as seguintes situações:

• Erro Processamento
• Pendente Processamento
• Erro Importação
• Aguardando Importação

É possível eliminar um movimento de uma conciliação com as seguintes situações:

• Erro Processamento
• Pendente Processamento
• Manual

g. Conciliação Manual

Todos os movimentos dos tipos "Não tratado" e "Devolução" não são tratados automaticamente. Assim, sua situação será “Manual”.

Para controle do usuário existe a função “Conciliar Manualmente” disponível no Monitor Marketplace que o usuário pode usar para controlar os movimentos que ainda precisam ser analisados e tratados usando as funções padrão do produto Totvs Datasul.

• A função Conciliar Manualmente também está disponível para movimento com situação Erro Processamento.
• A função Conciliar Manualmente simplesmente altera a situação do movimento de Manual para Sucesso Datasul.

04. LOTE MARKETPLACE

A função Lote Marketplace (ACR068AA) agrupa os títulos a receber que serão liquidados a partir do processamento de uma conciliação ou de um movimento.

Um lote Marketplace executa duas ações:

• Liquida os títulos vinculados ao pedido de venda do movimento da conciliação no valor do repasse líquido.
• Gera acertos de valor a menor nos mesmos títulos no valor da comissão e no valor do frete do movimento da conciliação.

Para mais detalhes da funções Lote Marketplace (ACR068AA), consulte Tutorial - Conciliação Repasses Marketplace - Lote Marketplace.

05. TABELAS ENVOLVIDAS

• param_mktplace
• trans_mktplace
• concil_mktplace_arq
• movto_mktplace
• rastreab_movto_mktplace
• lote_mktplace
• item_lote_mktplace

06. DOCUMENTAÇÕES ÚTEIS

Manuais de referência

• Cadastro de Marketplace
• Manutenção Layout Genérico - UTB060AA
• Monitor Conciliação Marketplace
• Lote Marketplace - ACR068AA
• Relatório Lote Marketplace - ACR399AA

API

• ACR563ZA - Importar conciliação Marketplace

Tutoriais

• Tutoriais - Conciliação Marketplace