Integração BLU¶
Conhecer o Processo¶
Envio de Cobranças
O envio de cobranças que estão na fila, será executado automaticamente de acordo o tempo definido no parâmetro “4 - Intervalo De Tempo Para Envio De Cobranças (Em Minutos)” dos Parâmetros Gerais da Integração BLU. Também será possível solicitar a integração manualmente através do botão sincronizar da Console de Cobranças BLU (FAPG0200).
Para adicionar as cobranças que devem ser enviadas na fila de integração com a administradora de pagamentos, temos três opções:
1 - Botão Envia p/ BLU no Cadastro de Pedidos de Venda (FPDV0200 PDV)
Este botão ficará visível e habilitado para pedidos de venda do tipo “PDV” e que possuam o portador informado vinculado a um tipo de cobrança com tipo “Cobrança BLU” ou à uma condição de pagamento com o indicador “Cobrança BLU” marcado.
Ao clicar neste botão o sistema exibirá a seguinte mensagem para confirmação: “Confirma o envio da cobrança para aprovação do lojista no portal da Administradora de Pagamentos?”.
2 – Botão Enviar da Console de Cobranças BLU (FAPG0200) na aba de Pedidos de Venda
Pedidos de venda criados que devem ser enviados para o Administrador de Pagamentos, pedidos com portador com tipo de cobrança “Cobrança BLU” ou condição de pagamento com o indicador “Cobrança BLU” marcado, ficarão disponíveis para consulta na Console de Cobranças BLU.”
Nesta será possível selecionar os pedidos desejados e enviá-los para cobrança através do botão “Enviar”. Ao clicar neste botão será exibida uma mensagem solicitando a confirmação do envio.
Nos dois casos, ao confirmar, o pedido será adicionado à fila de envio onde posteriormente será enviado para a administradora de pagamentos, conforme periodicidade configurada, desde que o mesmo já não se encontre enviado ou aguardando envio. O pedido de venda poderá ser enviado novamente caso tenha ocorrido uma falha no envio, caso tenha sido rejeitado na administradora de pagamentos ou a cobrança tenha sido cancelada.
Após envio da cobrança para a BLU com sucesso, será possível acompanhar a situação da cobrança não só pela própria console como também pelo Cadastro de Pedidos de Venda (FPDV0200 PDV) através do campo Status no canto superior esquerdo da tela.
3 – Botão enviar Console de Cobranças BLU (FAPG0200) na aba de Enviar Títulos do CR.
Este botão permite realizar envio de Títulos do Contas a Receber (CR) para cobrança através da plataforma Blu.
O envio de Títulos do CR para cobrança na Blu só poderá ser realizado para títulos que não estiverem em cobrança escritural e que ainda não possuam registro de envio para a plataforma BLU.
Somente serão considerados para envio para a BLU títulos que possuírem o tipo de documento conforme o parametrizado no parâmetro "1 - Tipos de documento do CR que podem ser enviados para Cobrança na BLU" nos Parâmetros da Integração BLU (FUTL0125 ADM_PGTOS ADM_PGTOS).
O envio de Títulos do CR para a BLU sempre será feito de forma manual.
Após envio do título para cobrança na BLU com sucesso, será possível acompanhar a situação da cobrança não só pela própria console, na aba “Consulta Títulos Contas Receber”, como também pelo Cadastro de Títulos do Contas a Receber (FCTR0200) através do campo Status no canto superior esquerdo da tela.
Consulta de Aprovações/Rejeições de Pagamentos
A consulta de aprovações e rejeições de pagamentos será executada de forma automática de acordo com o intervalo de tempo definido no parâmetro “5 - Intervalo De Tempo Para Consulta De Cobranças (Em Minutos)” dos Parâmetros Gerais da Integração BLU.
Também será possível solicitar a integração manualmente através do botão sincronizar da Console de Cobranças BLU (FAPG0200), onde serão consultadas as cobranças selecionadas.
Processamento de Aprovação
O processamento de aprovação será executado automaticamente ao final do processo de consulta de cobranças, caso a cobrança retorne como “Aprovada”.
Atualmente existem três fluxos dentro do FoccoERP:
1) Antecipado (À Vista) – Processo que consiste na geração de adiantamento financeiro na aprovação da cobrança e encontro de contas no faturamento.
2) Boleto – Processo que consiste no faturamento de pedidos aprovados e conciliação das duplicatas correspondentes.
3) Garantido (Antecipação ZERO) – Processo que consiste na substituição de duplicatas no faturamento (Geração de Títulos BLU) e conciliação financeira de títulos BLU. Caso a condição de pagamento do pedido estiver marcada como "Pagamento no faturamento" os títulos serão gerados apenas quando o pedido for faturado, caso esteja desmarcado, os títulos BLU serão gerados no momento que for recebida a aprovação da cobrança.
Observação: Para identificação do tipo de pagamento e momento do pagamento deverão ser considerados os campos “kind” e “charger_kind” da API de consulta de Cobranças. https://integracao.useblu.com.br/sobre-apis#consultar-cobranca
A definição e controle para execução de cada um deles será conforme as regras abaixo:
Seguindo o fluxo do FoccoERP previamente definido, este processamento consiste de:
1 – Atualização da Condição de Pagamento do Pedido de Venda:
A condição de pagamento do pedido de venda é atualizada para a condição de pagamento correspondente à selecionada pelo lojista/cliente no portal da Administradora de Pagamentos.
Boleto BLU: quando a cobrança for aprovada com esta forma de pagamento, não será atualizada a condição de pagamento do pedido de venda, pois considera-se que o pedido é criado por padrão com a condição de pagamento correspondente ao Boleto BLU.
Antecipado (À Vista): quando a cobrança for aprovada com esta forma de pagamento, a condição de pagamento do pedido será atualizada para a informada no parâmetro “1 - Condição De Pagamento Para Antecipado (À Vista)” da seção “2 - PARÂMETROS DE COBRANÇA BLU”.
Garantido (Antecipação Zero): quando a cobrança for aprovada com esta forma de pagamento, a condição de pagamento do pedido será atualizada para a informada no parâmetro "2 - Condição De Pagamento Para Garantido (Antecipação Zero)" da seção “2 - PARÂMETROS DE COBRANÇA BLU”. No caso de cobranças com antecipação zero que a condição de pagamento do pedido não estiver marcada para realizar o pagamento no faturamento, será utilizado o parâmetro "22 - CONDIÇÃO DE PAGAMENTO PARA OTIMIZADO/GARANTIDO "BILLING LATER" FALSE." da seção “2 - PARÂMETROS DE COBRANÇA BLU”.
2 – Geração de Acréscimos/Descontos e Recálculo do Pedido de Venda:
Após finalizar a atualização da condição de pagamento, será executada a geração de possíveis descontos fornecidos pela BLU conforme a forma de pagamento selecionada e o recálculo do pedido de venda, isto ocorre pois no momento da seleção da forma de pagamento no portal da BLU poderá ser fornecido um desconto à cobrança/pedido, assim podendo haver alteração no valor total do mesmo.
Ao final dos recálculos, caso houver diferença entre o valor enviado para cobrança originalmente e o valor recalculado, será enviada automaticamente solicitação para cancelamento da cobrança seguida de um reenvio da cobrança com os valores atualizados.
Quando ocorrer o cancelamento e reenvio, a cobrança em questão não seguirá com a execução dos itens 3 e 4 abaixo, pois a mesma ficará pendente de aprovação no portal da Administradora de Pagamentos novamente e assim que aprovada executará o processo por completo.
3 – Liberação do Pedido de Venda no Financeiro:
É realizada a liberação financeira do pedido de venda, permitindo assim que o mesmo seja faturado.
Caso ocorra algum erro ou exista algo que impeça a liberação do pedido de venda, o processo seguirá mesmo sem esta etapa e o usuário deverá liberar o pedido de venda no financeiro manualmente através do programa Liberação Financeira de Pedidos de Venda (FPDV0203 FIN) ou do programa Liberação Comercial/Financeira de Pedidos de Venda (FPDV0203 AMB).
4 – Geração de Adiantamento para o Cliente:
Quando a aprovação ocorrer com o tipo de pagamento "Antecipado (À Vista)", será gerado automaticamente um título de adiantamento no Contas a Receber (CR), correspondente ao valor da cobrança aprovado na Administradora de Pagamentos.
Para a geração deste título de adiantamento serão utilizados os seguintes dados:
-
Tipo de Documento, parâmetro “14 - Tipo De Documento Utilizado Para Adiantamentos” dos Parâmetros do Contas a Receber;
-
Tipo de Movimento, parâmetro “7 - Tipo De Movimento Para Emissão De Adiantamentos BLU” dos Parâmetros de Cobrança BLU;
-
Portador, o mesmo informado no pedido de venda;
-
Número do Título, será utilizado o número do pedido de venda caso ainda não exista um título com este número, caso contrário seguirá o padrão do FoccoERP buscando o próximo número de título disponível.
-
Data de Emissão/Vencimento, será utilizada a data atual do sistema.
Além disso, é possível a configuração do valor para geração do título de adiantamento, sendo possível gerar o adiantamento de forma “Normal”, considerando o valor final da cobrança considerando o valor de desconto fornecido na BLU ou então a geração com o valor “Total”, onde é gerado o adiantamento com o valor total da cobrança/pedido de venda desconsiderando desconto. Neste ultimo caso, o valor de desconto é incluído no título de adiantamento como um movimento de baixa, para possibilitar a contabilização em separado.
Esse processo é configurado nos parâmetros 13, 14 e 15 nos “2 - PARÂMETROS DE COBRANÇA BLU” (FUTL0125 ADM_PGTOS ADM_PGTOS).
Se no momento da geração do adiantamento algum dos parâmetros não estiver preenchido ou ocorrer alguma outra divergência, será apresentado erro no processamento da aprovação e será possível solicitar um novo processamento da aprovação da cobrança manualmente pela “Console de Cobranças BLU” (FAPG0200).
Cancelamento de Cobranças
O processo de cancelamento de cobranças será executado automaticamente, junto do processo de envio de cobranças, para as cobranças que tiveram seu cancelamento incluído na fila de envio para a BLU.
O cancelamento de uma cobrança pode ser solicitado através da Console de Cobranças BLU (FAPG0200), ao selecionar uma cobrança e clicar no botão “Cancelar”.
Será exibida uma mensagem pedindo confirmação para o cancelamento das cobranças selecionadas, ao confirmar o cancelamento das mesmas será incluído na fila de envio para BLU.
Também serão solicitados cancelamentos automaticamente quando ocorrer divergência entre o valor enviado e o valor recalculado do pedido no processo de “Processamento de Aprovação”.
Devolução de Cobranças
O processo de devolução consiste em retornar o valor “em aberto” de uma cobrança para o cliente/lojista.
A devolução de uma cobrança pode ser solicitada através da Console de Cobranças BLU (FAPG0200), ao selecionar uma cobrança e clicar no botão “Devolver”.
Será exibida uma mensagem pedindo confirmação para a devolução das cobranças selecionadas, ao confirmar a devolução das mesmas será solicitada.
Envio de Dados de Faturamento
Ao final do processo de faturamento do FoccoERP, caso o pedido de venda tenha vínculo com a Administradora de Pagamentos, automaticamente os dados de faturamento da cobrança serão colocados na fila para envio.
O envio destas informações será executado de acordo com o tempo definido no parâmetro “6 - Intervalo De Tempo Para Envio De Faturamento (Em Minutos)” dos Parâmetros Gerais da Integração BLU quando a nota fiscal estiver “autorizada” no SEFAZ.
Se cancelada uma nota fiscal, cujos dados de faturamento foram enviados para a Administradora de Pagamentos, será adicionada a fila de integração uma solicitação de cancelamento do faturamento da cobrança em questão.
Caso ocorra algum problema na execução destes processos, o mesmo registrará um histórico de falha e adicionará novamente a fila de integração para que seja realizada uma nova tentativa.
O envio de faturamento só será feito para as cobranças aprovadas com o tipo de pagamento “Garantido/Otimizado” e que tiverem pagamento no faturamento.
Conciliação Financeira
O processo de conciliação financeira consiste na baixa de títulos de cobranças enviadas para a BLU, conforme o pagamento realizado pela administradora de pagamentos. A conciliação financeira ocorre para pagamentos dos tipos Boleto BLU e Garantido (Antecipação ZERO), os quais após o faturamento ficam com títulos em aberto para pagamento futuro.
A consulta de pagamentos/conciliação financeira é realizada de forma automática conforme tempo definido no parâmetro “7 - Intervalo De Tempo Para Consulta De Conciliação De Pagamentos (Em Minutos)” dos Parâmetros Gerais da Integração BLU.
Os registros de pagamentos são disponibilizados na aba “Conciliação Financeira” da Console de Cobranças BLU (FAPG0200) para processamento manual, ou ainda, pode ser executada a baixa de títulos automaticamente através da configuração disponível no parâmetro “8 - Realizar Conciliação De Pagamentos Automaticamente” dos Parâmetros Gerais da Integração BLU.
Um registro de pagamento pode gerar até 3 (três) movimentos no título correspondente sendo eles: Movimento de Pagamento, Movimento de Taxa de Antecipação e Movimento de Taxa de Seguro Inadimplência. Os tipos de movimento para cada um dos valores devem ser configurados nos “2 - PARÂMETROS DE COBRANÇA BLU” (FUTL0125 ADM_PGTOS ADM_PGTOS) destacados abaixo:
“8 - Tipo De Movimento Para Pagamento De Títulos Blu”
“9 - Tipo De Movimento Para Baixa De Taxa De Antecipação”
“10 - Tipo De Movimento Para Baixa De Taxa De Seguro Inadimplência”
Observações
Efetuado tratamento no programa Negociação de Pedidos x Títulos (FCTR0203) para que não seja possível negociar pedidos de venda que foram enviados para cobrança pela administradora de pagamentos. Desta forma os pedidos de venda não são exibidos nas buscas e consultas efetuadas pelo programa.”
Efetuado tratamento no programa Cadastro de Pedidos de Venda (FPDV0200 PDV) para que não seja possível alterar pedidos de venda que foram enviados para cobrança pela administradora de pagamentos. Sendo assim apenas é possível alterar os pedidos quando a cobrança não tiver sido enviada, estiver com falha e sem tipo de pagamento definido, estiver rejeitada ou cancelada.
Renegociação de Títulos do CR
Este processo visa realizar, por parte do fornecedor, a renegociação de títulos com os lojistas, ou seja, permite consultar títulos do CR e enviá-los para a BLU.
Deve ser parametrizado na seção “3 - Parâmetros da renegociação da BLU (Envio de títulos do CR)” dos Parâmetros da Administradora de Pagamentos (FUTL0125 ADM_PGTOS ADM_PGTOS).
A consulta/sincronismo das cobranças pode ser executada de forma automática ou manual. Para automatizar, basta configurar o tempo de consulta de cobranças nos parâmetros da integração com administradora de pagamentos.
Segue lista de status disponíveis para uma cobrança BLU originada de um título CR:
-
Não enviado;
-
Enviado;
-
Falha;
-
Aguardando aprovação;
-
Aprovado;
-
Aprovação processada;
-
Pago;
-
Rejeitado;
-
Cancelado;
-
Devolvido;
-
Processando aprovação;
Para que um título esteja apto a ser enviado, precisará respeitar as seguintes condições:
-
Ter valor em aberto;
- <