Versions Compared

Version Old Version 2 New Version Current
Changes made by

Julia Tavares Omori

Julia Tavares Omori

Saved on

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.

Contrato

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.

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.

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 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.

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

...

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

TIUsuá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

TI

MOUN210

Refaturamento do alunoUsuário

MOUN316NFE

Atualiza as notas eletrônicas

Sim

TI

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

URL: Ambiente homologação SIEDUC.

http://app-homolog.netmoderna.com.br:8080/hml-adapSEU/wsa1/wsdl?targetURI=urn:tempuri-org-homolog

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

...