Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Info

A plataforma BDC também é conhecida internamente como Pegasus ou Plataforma Santillana.

Sobre a plataforma

A forma de integração se dá principalmente pela comunicação com o webservice.

Durante o processo de pagamento dos alunos o ERP recebe as informações da plataforma via webservice nosso e para envio das informações a partir do ERP é requisitado o webservice da plataforma BDC.

Tópicos

Table of Contents
minLevel2
maxLevel4
outlinetrue
styledisc
typelist
printablefalse

...

Processos

BDC (Base de Dados Central) é uma plataforma que se conecta com o ERP TOTVS via webservice e é utilizada apenas para realizar pagamentos dos alunos. Nela se concentra os contratos de escolas com a Moderna e seus respectivos alunos e pagamentos.

Abaixo você pode conferir todos os processos relacionados a plataforma.:

...

Inicialmente é feito o contrato de alunos no ERP e enviado via webservice para a BDC. Na plataforma ocorre a validação (aprovação ou cancelamento) do contrato por parte da escola para então integrar a informação validada ao ERP e dar prosseguimento ao processo.

Expand
titleComo parametrizar um contrato
  1. Cadastre o selo

    1. MOCG005 - Cadastro do selo

      image-20240222-011940.pngImage Removed

      Importante:

      • O selo sempre será vinculado ao canal de venda.

      • Sua origem sempre será o estabelecimento:

        1. Moderna

        2. UNO

    2. CD00602 - Cadastro do estabelecimento

      image-20240222-012044.pngImage Removed
    3. CD1517 - Cadastro do canal de venda

      image-20240222-012259.pngImage Removed
    4. MOUN363A - Cadastre o Selo

      image-20240222-012505.pngImage Removed

      O campo “Empresa BDC” é o código usado para enviar os dados para a plataforma.

  2. Cadastre a escola

    1. MOUN110 - Cliente BDC

      image-20240222-012600.pngImage Removed
    2. MOUN112 - Unidades Cliente

      image-20240222-012622.pngImage Removed

  3. Parametrize os programas

    1. MOUN115

      image-20240222-012706.pngImage Removed

    2. MOUN117 (subprograma)

      1. Requisito anterior ao subprograma é parametrizar a grade:

        1. MOUN256 - Parametrização da grade

          image-20240222-013314.pngImage Removed

          ou

        2. MOUN257 - Imp. Parametrização da grade

          image-20240222-013334.pngImage Removed

          Necessário estar cadastrado informações de peso, altura, largura e comprimento.

      2. MOUN117

        image-20240222-013657.pngImage Removed

    3. MOUN118 Kit/Item (subprograma)

      image-20240222-013830.pngImage Removed

Após isso o programa BDC0012R irá validar os cadastros e enviar uma solicitação de integração via webservice para o BDC. Após isso a plataforma irá integrar os dados do contrato e login e retornar ao ERP os contratos que estão pendentes de integração e irá gerar a escola e sua unidade.

image-20240222-014015.pngImage Removed

Esse processo é feito de forma automática via RPW.

Info

É possível consultar os contratos no programa MOUN355 - Cons. Acuerdos e acompanhar a integração pelo programa WAD001.

Note

É necessário que o ano letivo esteja ativo. É possível verificar e dar manutenção nessa informação no programa MOUN114.

image-20240222-014213.pngImage Removed
Expand
titleComo transformar um Acuerdo em Anexo/Contrato

O programa roda automaticamente a funcionalidade de transformar o acuerdo em anexo/contrato, porém também é possível fazer de acordo On Request.

  1. Acesse o programa MOUN355

    1. Abra o acuerdo e clique no botão Atualiza001 localizado no cabeçalho:

      image-20240222-014329.pngImage Removedimage-20240222-014431.pngImage Removed

O anexo sempre será gerado, um por segmento, no MOUN111 com a seguinte composição:

  • Selo + Contrato Escola + Ano + Unidade

Expand
titleComo consultar um contrato validado

Uma vez que o contrato volte validado do BDC ele ficará disponível no programa MOUN001.

image-20240222-014822.pngImage Removed
Expand
titleComo consultar dados do aluno

Acesse o programa MOUN150

image-20240222-015327.pngImage Removed

Grades Personalizadas

Nos contratos para o ensino médio sob o selo UNO é possível gerar grades personalizadas: oferta de diferentes materiais para turmas diferentes de uma mesma série. Essa informação vem junto com a integração do contrato.
Nesse processo antes de criar o contrato no ERP é feito o cadastro dos respectivos itens do contrato no TOTVS, integrados a partir da plataforma WEB SAPE.

⚠️ O programa que recebe as grades personalizadas do ensino médio é o MOUN523

Info

A equipe na Moderna na BDC faz o envio do contrato para a escola e ela valida com aceite.

Validado o contrato é possível enviar o material de remessa, gerar o pedido e a nota fiscal para a escola.

Pagamento do aluno

Uma vez com a NF gerada, o pai ou responsável do aluno irá acessar a plataforma BDC e efetuar o pagamento do material, uma vez confirmado é enviado os dados de pagamento para o ERP.

Após gerado a NF o ERP realiza as seguintes ações:

  1. Cadastro do pai do aluno (emitente/cliente)

    1. Esse processo é feito automaticamente via RPW.

  2. Faturamento do aluno

    1. Para realizar essa etapa é necessário o cadastro do pai do aluno.

  3. Processo de crédito financeiro

    1. Esse processo é feito automaticamente via RPW, mas para realizá-lo é necessário o cadastro do pai do aluno e o retorno do faturamento via AudTax (plataforma de integração bancária) com seu código de sequência.

Note

Caso ocorra algum erro nos cadastros ou integrações, após as devidas alterações é necessário realizar a integração novamente para corrigir o status de erro.

Sobre a AudTax

AudTax é uma plataforma de integração bancária.
A BDC integra o pagamento do pai do aluno com a AudTax e para que ela envie ao ERP a numeração sequêncial do pagamento.
Então é feita uma concilização onde se cruza o pagamento da AudTax com o pagamento feito na plataforma para gerar o crédito para o pai.

Após a integração dos dados acima é dado início ao faturamento.

Faturamento do aluno

O pai ou responsável do aluno irá acessar a plataforma BDC e realizar o pagamento do material do aluno.

Expand
titleComo acompanhar o pagamento do aluno

Para acompanhar basta acessar o programa MOUN226. Esse programa é atualizado periodicamente via RPW retornando via integração a situação e forma de pagamento realizada no BDC.

image-20240222-015801.pngImage Removed

O tipo de faturamento irá variar de acordo com o material:

  1. Material Impresso

    1. Nesse tipo de material o faturamento só ocorre quando ele estiver na escola. Para esse caso é necessário dar início ao processo de Saldo em Terceiros, onde o ERP irá debitar a quantia do material solicitado na NF de remessa da escola e gera a NF de venda. Após isso se cria um débito (título financeiro) contra o pai e é enviado ao ACR.

Info

Essa nota não tem movimentação física, pois já foi feita pela escola ao gerar a NF de remessa.

  1. Material Digital

    1. Verfica-se todos os alunos que estão com materiais digitais pendentes e gera uma NF de venda. O valor se torna um débito (título financeiro) contra o pai e é enviado ao ACR.

  2. Serviço

    1. Gera uma NF de serviço apenas. (Esse processo é raro. Um exemplo são chaves de rede codificada para aluno)

Após o faturamento são atualizadas todas as notas de aluno no SEFAZ e então é gerado sua DANFE.

Processo ACR

No pagamento é gerado um crédito para o pai do aluno (que vem das integrações com a AudTax) e a nota gera um débito contra esse pai.

Note

Só entra o pagamento no ACR se houver confirmação do AudTax.

Refaturamento do Aluno

Quando ocorre a desistência do aluno no período letivo ou ocorreu algum erro durante alguma etapa do processo de cadastro ou envio é realizado o refaturamento do aluno.

Para dar início ao processo é necessário a devolução do material do aluno, que pode ser feita de duas formas:

  • Nota Física - Quando a devolução ocorre na Moderna.

  • Nota Fiscal - Quando é feita a devolução na escola do aluno. Após isso é gerado um crédito ao pai do aluno no ACR.

Após a validação das notas é feito o refaturamento.

...

Programas envolvidos

Programa

Função

Executa em RPW?

Responsável

MOUN110

Cadastro da escola no ERP

Não

Usuário

MOUN117

Subprograma do cadastro da escola

Não

Usuário

MOUN118

Subprograma do cadastro da escola

Não

Usuário

MOUN256

Grade de material

Não

Usuário

MOUN523

Programa que recebe as grades personalizadas do Ensino Médio do selo UNO

WAD001

Monitor de integração dos contratos

MOPD1039

Relatório de remessa dos envios para as escolas

MOUN542

Geração do pedido do material para a escola

MOUN001

Consulta do contrato validado

MOUN541

Geração do pedido físico utilizando o relatório gerado no MOPD1039

MOUN226

Processo de pagamento do aluno

MOCR070

Cadastro do pai do aluno

Sim

TI

MOCR066

Integração do crédito financeiro do pai com o ACR

Sim

Usuário

MOUN284

Monitor de alunos com erro

MOUN283

Monitor de pagamentos com erro

MOUN285

Monitor de contratos com erro

MOUN703

Gera o faturamento de material impresso

MOUN374

Gera o faturamento de material digital

MOUN274

Gera o faturamento de serviço

MOUN316

Atualiza as notas do Aluno no SEFAZ

Sim

Usuário

MOUN316NFE

Atualiza as notas eletrônicas

Sim

TIMOUN210

Refaturamento do aluno

MOUN317

Identifica alunos inativos ou com mudança de série

MOUN210Informa o material que está sendo devolvido

Refaturamento do aluno

Não

Usuário

MOUN314F

Realiza o refaturamento

Não

Usuário

MOUN176

Relatório de alunos pendentes de faturamento ou devoluções

Usuário Operações

Detalhamento técnico

...

Consulta de integrações

Exemplo:

...

Integração de Pagamento BDC

Serviço Busca Token

...

Busca do Token:
Code Block
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:tempuri-org-homolog:integrmodernahomolog">
  <soapenv:Header/>
  <soapenv:Body>
    <urn:wsToken>
      <urn:UserName>paHomolog</urn:UserName>
      <urn:Password>Homolog123</urn:Password>
      <urn:Origin>PA</urn:Origin>
    </urn:wsToken>
  </soapenv:Body>
</soapenv:Envelope>
Retorno do Serviço:
Code Block
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <SOAP-ENV:Body>
    <wsTokenResponse xmlns="urn:tempuri-org-homolog:integrmodernahomolog">
      <result xsi:nil="true"/>
      <xmlReturn><![CDATA[<?xml version="1.0" encoding="ISO-8859-1"?><ttToken xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><ttTokenRow><token>F9A58E855BA5DF9D3AEF6679FB60BBCEAA2625D6</token><expires_in>14400</expires_in></ttTokenRow></ttToken>]]></xmlReturn>
    </wsTokenResponse>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

...

Serviço de Envio dos Pagamentos

linha 5

Code Block
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:tempuri-org-homolog:integrmodernahomolog">
  <soapenv:Header/>
  <soapenv:Body>
    <urn:ws0001>
      <urn:pOp>Payment</urn:pOp>
      <urn:pId>F9A58E855BA5DF9D3AEF6679FB60BBCEAA2625D6</urn:pId>
      <urn:pInp>XML Pagos</urn:pInp>
    </urn:ws0001>
  </soapenv:Body>
</soapenv:Envelope>

XML Pagos

Expand
titleXML pagos
Code Block
<?xml version="1.0" encoding="utf-8"?>
<documentos>
<documento>
<total_bruto>230.0000</total_bruto>
<total_neto>230.0000</total_neto>
<cantidad_parc>1</cantidad_parc>
<transacion_id>26750743</transacion_id>
<Transaction_ID>100005</Transaction_ID>
<Transaction_Amount>220.12</Transaction_Amount>
<documento_id>19818397</documento_id>
<Order_ID>215</Order_ID> 
<Order_Amount>111.13</Order_Amount>
<Empresa_Id>1</Empresa_Id>  
<id_mensaje>aaabbb001</id_mensaje>  
<referencia>0019818397</referencia>
<fecha>2023-05-20 11:47:41</fecha>
<fecha_vencimiento>2023-06-19 11:45:24</fecha_vencimiento>
<fecha_facturacion></fecha_facturacion>
<forma_pago_id>353</forma_pago_id>
<forma_pago_clave>191</forma_pago_clave>
<forma_pago_parametro></forma_pago_parametro>
<bruto>230</bruto>
<flete>0.0000</flete>
<neto>230.0000</neto>
<descuento>0</descuento>
<cancelado>0</cancelado>
<ano_refer>2023</ano_refer>
<testem></testem>
<renegociado>0</renegociado>
<cod_motivo_situacion></cod_motivo_situacion>
<desc_motivo_situacion></desc_motivo_situacion>
<fecha_situacion></fecha_situacion>
<enderecos>
<endereco>
<documento_id>19818397</documento_id>
<tipo_endereco>2</tipo_endereco>
<persona_pago_id>15952444</persona_pago_id>
<persona>Flavia Fausto Sirio</persona>
<apellido_paterno>Fausto Sirio</apellido_paterno>
<apellido_materno></apellido_materno>
<nombre_completo>Flavia Fausto Sirio Fausto Sirio</nombre_completo>
<sexo_o_moral></sexo_o_moral>
<tp_persona></tp_persona>
<id_fiscal>30812588800</id_fiscal>
<id_oficial></id_oficial>
<calle>Avenida Ultramarino</calle>
<numero_exterior>561</numero_exterior>
<numero_interior>125</numero_interior>
<colonia>Lauzane Paulista</colonia>
<poblacion></poblacion>
<ciudad></ciudad>
<pais_id>44</pais_id>
<pais_clave>BR</pais_clave>
<pais>Brasil</pais>
<codigo_postal>02441000</codigo_postal>
<estado_id>125</estado_id>
<estado_clave>SP</estado_clave>
<estado>SÃO PAULO</estado>
<municipio_id>16585</municipio_id>
<municipio_clave>SPSÃO PAULOBrasil</municipio_clave>
<municipio>SÃO PAULO</municipio>
<referencia_dom></referencia_dom>
<telefono_1></telefono_1>
<telefono_2>11974716582</telefono_2>
<email>fla.fausto@hotmail.com</email>
<contacto>Flavia Fausto Sirio Fausto Sirio</contacto>
</endereco>
</enderecos>
<transacao>
<documento_id>19818397</documento_id>
<fecha_actualizacion>2023-05-20 14:47:44</fecha_actualizacion>
<autorizacao>474361</autorizacao>
<codigoFormaPagamento>191</codigoFormaPagamento>
<codigoTransacaoOperadora>0</codigoTransacaoOperadora>
<dataAprovacaoOperadora>2023-05-20 14:47:44</dataAprovacaoOperadora>
<mensagemVenda></mensagemVenda>
<numeroComprovanteVenda>11182305201140037370</numeroComprovanteVenda>
<nsu>628762413</nsu>
<codigoEstabelecimento>1626097511001</codigoEstabelecimento>
<numeroTransacao>19818397</numeroTransacao>
<parcelas>2</parcelas>
<statusTransacao>1</statusTransacao>
<taxaEmbarque>0.0000</taxaEmbarque>
<urlPagamento></urlPagamento>
<valor>230.0000</valor>
<valorDesconto>0.0000</valorDesconto>
<documento_id_original>19818397</documento_id_original>
<qtde_parcela>2</qtde_parcela>
<nr_parcela>2</nr_parcela>
<data_vencimento>2023-06-19 11:45:24</data_vencimento>
<data_credito>2023-05-20</data_credito>
<data_atualiz_pagto>2023-05-20 14:47:44</data_atualiz_pagto>
<preco_original>230</preco_original>
<desconto_concedido>0</desconto_concedido>
<desconto_plataforma>0.0000</desconto_plataforma>
<desconto_periodo>0</desconto_periodo>
<cod_periodo></cod_periodo>
<juros_plataforma>0</juros_plataforma>
<valor_despesa>0</valor_despesa>
<valor_frete>0.0000</valor_frete>
<valor_nominal>230</valor_nominal>
<juros_pagto_boleto>0.0000</juros_pagto_boleto>
<desconto_pagto_boleto>0.0000</desconto_pagto_boleto>
<valor_a_menor>0</valor_a_menor>
<valor_a_maior>0</valor_a_maior>
<valor_pago>230</valor_pago>
<tipo_frete></tipo_frete>
<gateway>bempaggo</gateway>
</transacao>
<documento_lineas>
<documento_linea>
<documento_id>19818397</documento_id>
<alumno_id>19571435</alumno_id>
<alumno>Heloisa Fausto S¡rio</alumno>
<total_precio>230.0000</total_precio>
<contrato>50160</contrato>
<articulo_id>117724</articulo_id>
<articulo_erp_id>CRES 3EF1 23</articulo_erp_id>
<descripcion>CRES 3EF1 23</descripcion>
<cantidad>1</cantidad>
<precio>230.0000</precio>
<descuento_porcentaje>0.0000</descuento_porcentaje>
<razon_descuento></razon_descuento>
<descuento_porcentaje_2>0.0000</descuento_porcentaje_2>
<razon_descuento_2></razon_descuento_2>
<descuento_porcentaje_3>0.0000</descuento_porcentaje_3>
<razon_descuento_3></razon_descuento_3>
<impuesto_porcentaje>0.0000</impuesto_porcentaje>
<cargo>0.0000</cargo>
<impuesto_cargo_porcentaje>0.0000</impuesto_cargo_porcentaje>
<tipo_venta_id>397</tipo_venta_id>
<tipo_venta_clave>VND</tipo_venta_clave>
<tipo_venta_parametro>VENTA</tipo_venta_parametro>
<canal_venta_id>198</canal_venta_id>
<canal_venta_clave>ALU</canal_venta_clave>
<canal_venta_parametro>ALU</canal_venta_parametro>
<plazo_id>545</plazo_id>
<plazo_clave>1</plazo_clave>
<plazo_parametro>CON</plazo_parametro>
<preco_original>230.0000</preco_original>
<desconto_concedido>0.00</desconto_concedido>
<desconto_plataforma>0.0000</desconto_plataforma>
<desconto_periodo>0</desconto_periodo>
<cod_periodo></cod_periodo>
<juros_plataforma>0.0000</juros_plataforma>
<valor_despesa>0</valor_despesa>
<valor_frete>0</valor_frete>
<valor_nominal>230</valor_nominal>
<desconto_pagto_boleto>0</desconto_pagto_boleto>
<juros_pagto_boleto>0</juros_pagto_boleto>
<valor_a_menor>0</valor_a_menor>
<valor_a_maior>0</valor_a_maior>
<valor_pago>230</valor_pago>
</documento_linea>
</documento_lineas>
</documento>
</documentos>

Diagrama de Sequência

...

XML de Retorno

Code Block
<?xml version="1.0" encoding="UTF-8"?>
<respuesta>
  <transacciones>
    <transaccion>
      <id_mensaje>uuid</id_mensaje>
      <documento_id>17766779</documento_id>
      <situacion>OK</situacion>
      <mensaje>Documento: 17766779 -Documento Recebido com sucesso</mensaje>
    </transaccion>
  </transacciones>
</respuesta>

Tabelas de acesso

Tabela

Campo

Descrição

Programas afetados

...