Este documento tem por objetivo a documentar as API's disponíveis no projeto Integração Protheus FIEC.


Orientações gerais, autenticação e exemplos de consumo das API's.


<div class="post">POST</div>
<div class="endereco">/rm/api/TOTVSCustomizacao/IntegracaoSALESFORCE/AtualizarServicoCRM</div>


Inclui ou altera um Serviço originado do CRM no cadastro customizado de Serviços do SGE, vinculando o serviço aos cursos informados.

Ao executar a chamada do webservice, se for inclusão de um serviço novo, o método irá:

  • Incluir o Serviço CRM no SGE (cadastro customizado).
  • Preencher todos os dados do serviço: 
    • Código do Serviço/Produto
    • Descrição do Serviço/Produto
    • Código do produto do Protheus (obrigatório), 
    • Código da Natureza Financeira do Protheus
    • Status
  • Vincular o Serviço CRM no anexo customizado dos Cursos informados

Ao executar a chamada do webservice, se for atualização de um serviço existente será permitido alterar o status e o processo deverá identificar o serviço CRM no SGE através do código e atualizar seu status no cadastro customizado.

Authorization - Basic Auth

Username <username>

Password <password>

Body

[
    {
		"CodColigada: 3,
		"Codigo: "10",
		"Descricao: "Mensalidade - Curso Técnico Mecânica",
		"ProdutoProtheus": "121551",
  		"Natureza": "1100103",
  		"Ativo": true,
        "CodCursos": [ "APT.00011", "TEC.00011" ] 
  }
]

Content

  • CodColigada: Código da Coligada no SGE. Enviar 2 para SESI e 3 para SENAI (primary key).
  • Codigo: Código do Serviço CRM (primary key);
  • Descricao: Nome do Serviço CRM;
  • Produto Protheus: Código do Produto no Protheus, associado ao serviço/curso. Utilizado no envio do Pedido de Venda do SGE para o Protheus (obrigatório);
  • Natureza: Código da Natureza Financeira, associado ao serviço/curso. Utilizado no envio do Pedido de Venda do SGE para o Protheus;
  • Ativo: true ou false, indica se o serviço está ativo ou não;
  • CodCurso: Lista de códigos de curso no SGE que serão vinculados, através do anexo customizado do Curso SGE,  ao serviço que está sendo criado.


Retorno

{
   "Message": "Serviço incluído com sucesso!\r\n",
   "Status": "Sucesso",
   "StatusCode": 200
}

Content

  • Message: Mensagem de retorno do consumo da requisição;
  • Status: Situação do processamento da requisição;
  • StatusCode: Código de status do processamento da requisição;
<div class="post">POST</div>
<div class="endereco">/rm/api/TOTVSCustomizacao/IntegracaoSALESFORCE/GravarResponsavelFinanceiro</div>

Realiza a gravação do Responsável Financeiro (Cliente/Fornecedor) no SGE, conforme dados enviados pela API.

Tabela Afetada: FCFO

Interface RM: TOTVS BackOffice | Gestão Financeira | Cadastros | Cliente/Fornecedor


Authorization - Basic Auth

Username <username>

Password <password>

Body

{
 "CodCFO": "7604288600001",
 "Nome": "responsaveltesteapi",
 "Cpf": "42302908023",
 "Email": "[email protected]",
 "Cep": "31810365",
 "Logradouro": "Logradouro",
 "Numero": 20,
 "Complemento": "101",
 "Bairro": "Bairro",
 "Estado": "MG",
 "Cidade": "Belo Horizonte",
 "Pais": "Brasil",
 "Telefone": "03189898989",
 "Celular": "77777777777",
 "Tel_Comercial": "0314545454545",
 "Fax": "0314545454545",
 "CodColigada": 3,
 "Global": true
}

Content

  • CodCFO: Código identificador do cliente RM/Salesforce/Protheus.

Deve ser enviado no seguinte formato: 9 primeiros dígitos do CPF ou 8 primeiros  primeiros dígitos do CNPJ + código da loja. Exemplo: 0101251250001

  • Nome: Nome do responsável financeiro no SGE (Campo Obrigatório);

  • Cpf: CPF do responsável financeiro no SGE (Campo Obrigatório);
  • Email: E-mail do responsável financeiro no SGE (Campo Obrigatório);
  • Cep: CEP do endereço do aluno no SGE (Campo Obrigatório);
  • Logradouro: Nome da rua (Campo Obrigatório);

  • Numero: Numero da residencia (Enviar apenas números)(Campo Obrigatório);

  • Complemento: Complemento se houver (Campo Obrigatório);
  • Bairro: Nome do bairro (Campo Obrigatório);
  • Estado: Enviar Sigla do Estado (Campo Obrigatório);
  • Cidade: Enviar Nome da Cidade (Campo Obrigatório);

  • Pais: Enviar Nome do país (Campo Obrigatório);

  • Telefone: Número telefone fixo (Enviar apenas números com DDD)(Campo Obrigatório);

  • Celular: Número telefone celular (Enviar apenas números com DDD) (Campo Obrigatório);

  • Tel_Comercial: Numero telefone comercial(Enviar apenas números com DDD);
  • Fax: Número fax (Enviar apenas números com DDD);

  • CodColigada: Código da Coligada no SGE. Enviar 2 para SESI e 3 para SENAI (Campo obrigatório).
  • Global: informar se o registro do cliente será compartilhado entre as coligadas. Enviar true para Global e false para registro por coligada. 

Retorno

{
   "Message": "Responsavel: 00000005, criado com Sucesso!\r\n",
   "Status": "Sucesso",
   "StatusCode": 200
}

Content

  • Message: Mensagem de retorno do consumo da requisição;
  • Status: Situação do processamento da requisição;
  • StatusCode: Código de status do processamento da requisição;
<div class="post">POST</div>
<div class="endereco">/rm/api/TOTVSCustomizacao/IntegracaoSALESFORCE/GravarAluno</div>

Realiza a gravação do aluno no SGE, conforme dados enviados pela API.

Tabela Afetada: SALUNO

Interface RM: TOTVS Educacional | Educacional | Currículo e Oferta | Alunos

Authorization - Basic Auth

Username <username>

Password <password>

Body

{
  "Nome": "Teste Api 2 ",
  "EstadoNatal": "MG",
  "Naturalidade": "Belo Horizonte",
  "DataNascimento": "05/07/1978",
  "Cpf": "85763425022",
  "Cep": "38700412",
  "Rua": "Pascoal Soares",
  "Numero": 10,
  "Complemento": "102",
  "Bairro": "Savassi",
  "Estado": "SP",
  "Cidade": "São Paulo",
  "Pais": "Brasil",
  "Tel_Residencial": "3333333333333",
  "Tel_Celular": "2312321312",
  "Tel_3": "13123132313",
  "Fax": "312321313131",
  "SitOcupacional": 1,
  "TipoEscola": 3,
  "CodColigada": 3,
  "IdMatrizAplicada": 4,
  "Email": "[email protected]",
  "NomeMae": "Nome da mãe do Aluno"
}

Content

  • Nome: Nome do Aluno no SGE (Campo Obrigatório);

  • EstadoNatal: Estado Natal do Aluno no SGE (Campo Obrigatório);

  • Naturalidade: Naturalidade do Aluno no SGE (Campo Obrigatório);
  • DataNascimento: Data de Nascimento do Aluno no SGE (Campo Obrigatório);
  • Cpf: CPF do Aluno no SGE (Campo Obrigatório);
  • Cep: CEP do Aluno no SGE;
  • Rua: Rua do Aluno no SGE;
  • Numero: Número do Aluno no SGE;
  • Complemento: Complemento do Aluno no SGE;
  • Bairro: Nome do bairro do Aluno;
  • Estado: Sigla do Estado do Aluno;
  • Cidade: Nome da Cidade do Aluno;
  • Pais: Nome do País do Aluno;
  • Tel_Residencial: Telefone Residencial do Aluno no SGE;
  • Tel_Celular: Telefone Celular do Aluno no SGE;
  • Tel_3: Telefone 3 do Aluno no SGE;
  • Fax: Fax do Aluno no SGE;
  • SitOcupacional: Situação ocupacional do Aluno no SGE;

       Valores possíveis:
               1 = Empregado
               2 = Desempregado
               3 = Empregador
               4 = Autônomo/Conta Própria
               5 = Profissional Liberal
               6 = 1º Emprego
               7 = Aposentado
               8 = Microempreendedor Individual - MEI
               9 = Aprendiz com contrato   

  • TipoEscola: Tipo de escola de Origem do Aluno no SGE;

             Valores possíveis:
               1 = Particular
               2 = Pública - Municipal
               3 = Pública - Estadual
               4 = Pública - Federal
               9 = Não Declarado

  • CodColigada: Código da Coligada no SGE (Campo Obrigatório);
  • IdMatrizAplicada: Identificador da Matriz Aplicada (Curso/Habilitação e Período Letivo) (Campo Obrigatório);
  • NomeMae:  Nome da mãe do aluno, que será gravado em campo complementar do cadastro do aluno (não obrigatório na API).
  • Email: Endereço de e-mail do Aluno, que será gravado no campo do cadastro da Pessoa.

Retorno

{
   "Message": "Aluno: 205, existente em base, atualizado com Sucesso!\r\n",
   "Status": "Sucesso",
   "StatusCode": 200
}

Content

  • Message: Mensagem de retorno do consumo da requisição;
  • Status: Situação do processamento da requisição;
  • StatusCode: Código de status do processamento da requisição;
<div class="post">POST</div>
<div class="endereco">/rm/api/TOTVSCustomizacao/IntegracaoSALESFORCE/RealizarMatricula</div>

Realiza a matrícula do aluno no SGE, conforme dados enviados pela API.

Tabelas Afetadas: SMATRICPL, SMATRICULA, SHABILITACAOALUNO

Interface RM: TOTVS Educacional | Educacional | Currículo e Oferta | Alunos | Matrículas no Período Letivo

Authorization - Basic Auth

Username <username>

Password <password>

Body

{
    "IdMatrizAplicada": 5,
    "RA": "00000018",
    "Turma": "123|TEC.001.006",
    "DataMatricula": "20/12/2021",
    "DataPrevSaida": "01/01/2022",
    "CondicaoAluno": 0,
    "CodFinSCAE": 1,
    "Articulacao": 2,
    "CodColigada": 3,        
    "Contrato": {
        "NomeRespFin": "Responsavel Rafaela",
        "CodColCfo": 2,
        "CodCFO": "9989098600001",
        "ValorTotal": 600.0,
        "QuantidadeParc": 5,
        "DataVencimento": "12/02/2022",
        "DiaVencimento": 12,
        "DescontoInstitucional": 8.0,
        "DescontoAdicional": 1.0,
        "MotivoDesconto": "Desconto funcionário da indústria",
        "DataVenda": "30/12/2021",
        "IdOportunidade": 1,
        "FormaPagtoPrimeiraParc": "CACCAR",
        "FormaPagtoDemaisParc": "BOL",
        "ReceberBoletoEmail": "Sim",
        "PedidoFiscal": null,
        "Ecommerce": "SIM",
        "DadosCartao": {
            "Cod_Loja": 0,
            "Agencia": "TESTE",
            "Cod_Banco": "158",
            "Conta": "000001",
            "AdquirenteCartao": null,
            "MeioPagamento": "Crédito",
            "BandeiraCartao": "Elo",
            "NSU": "123",
            "ValorTotalCartao": 120.0,
            "ParcelasCartao": 1
        }
    },
    "Disciplinas": [],
    "CodColigada": 2,
    "CamposValoresChaveGrupo": null
}

Content

  • IdMatrizAplicada: Identificador da Matriz Aplicada (Curso/Habilitação e Período Letivo) (Campo Obrigatório);
  • RA: Registro acadêmico do aluno no SGE (Campo Obrigatório);
  • Turma: Código da Turma do SGE onde o aluno será matriculado (Campo Obrigatório). O código da turma enviado contém o identificador do período letivo seguido do código da turma do SGE, concatenados por '|'. 
  • DataMatricula: Data da Matrícula do aluno (Campo Obrigatório);
  • DataPrevSaida: Data final do Curso;
  • CondicaoAluno: Condição do Aluno (SENAI);

      Valores possíveis:
        0 = Não Gratuita.
        1 = Gratuidade regimental
        2 = Bolsa de estudos
        3 = Convênio

  • CodFinSCAE: Código Financiamento SCAE;
    • Valores possíveis:

          0 = Não Gratuita
          2 = Gratuidade Regulamentar
          3 = Gratuidade Não Regulamentar

  • Articulacao: Código de Articulação.
    • Valores possíveis:
           1 = Há Articulação Sesi/Senai
           2 = Não há Articulação Sesi/Senai
           3 = Há Articulação entre outras instituições


  • CodColigada: Código da Coligada no SGE (Campo Obrigatório);
  • Contrato:  
    • CodCFO: Código identificador do cliente no RM/Salesforce/Protheus (Campo Obrigatório);
    • CodColCfo: Código da Coligada do cliente Fornecedor. Se for global, enviar 0 - zero (Campo obrigatório);
    • NomeRespFin: Nome do responsável financeiro no SGE (Campo Obrigatório);
    • ValorTotal: Valor total da venda (sem descontos de bolsas);
    • QuantidadeParc: Quantidade de parcelas do contrato de venda;
    • DataVencimento: Data do vencimento da primeira parcela do contrato;
    • DiaVencimento: Dia fixo do vencimento que será utilizado na geração da segunda parcela em diante. A data será gerada com o dia fixo informado do mês subsequente do início da turma, até atingir a quantidade de parcelas;
    • DescontoInstitucional: Valor do desconto institucional, com base no valor total do contrato. Quando informado, será criada uma bolsa Institucional ao contrato (conforme código de bolsa informado nos parâmetros da customização).
    • DescontoAdicional: Valor do desconto adicional, com base no valor total do contrato. Quando informado, será criada uma bolsa Adicional ao contrato (conforme código de bolsa informado nos parâmetros da customização).
    • MotivoDesconto: Descrição do Motivo do desconto adicional ou institucional (obrigatório no caso de desconto concedido);
    • DataVenda: Data corrente do recebimento da matrícula;
    • IdOportunidade: Identificador da oportunidade fechada no SALESFORCE ;
    • FormaPagtoPrimeiraParc: Forma De pagamento - Primeira parcela (Campo Obrigatório);

                                  Valores possíveis:;

                                    BOLETO: BOL (Mensalidade Boleto)
                                    Cartão crédito: CAC (Mensalidade Cartão de crédito)
                                    Cartão débito: CAR (Mensalidade Cartão de débito)
                                    Dinheiro: ESP (Mensalidade dinheiro)

    • FormaPagtoDemaisParc: Forma De pagamento - Demais parcelas (Campo Obrigatório);
    •              Valores possíveis:
                     BOLETO: BOL (Mensalidade Boleto)
                     Cartão crédito: CAC (Mensalidade Cartão de crédito)
                     Cartão débito: CAR (Mensalidade Cartão de débito)
                     Dinheiro: ESP (Mensalidade dinheiro)
    • ReceberBoletoEmail: Recebe Boleto por E-mail (Campo Obrigatório);
    •             Valores possíveis: Sim ou Não - se o boleto foi enviado por e-mail
    • ECommerce: Identificação de E-Commerce

                                 Valores possíveis: Sim ou Não


    • Dados Cartão:  
      • Esse bloco só deve ser enviado para pagamento com cartão através do E-commerce. Só é permitido enviar dados de um cartão de crédito. Essas informações são enviadas no complemento do pedido de venda do Protheus.  
      • ParcelasCartao: Quantidade de Parcelas junto a operadora do cartão. Informação enviada para Protheus para geração de títulos a receber para operadora do cartão. 
  • Disciplinas: Lista de códigos da Disciplinas onde o aluno deverá ser matriculado no SGE. Caso este campo não seja informado, o aluno será matriculado em todas as disciplinas da turma/matriz aplicada.


Retorno

{
   "Message": "Matrícula realizada com sucesso!\r\n",
   "Status": "Sucesso",
   "StatusCode": 200
}

Content

  • Message: Mensagem de retorno do consumo da requisição;
  • Status: Situação do processamento da requisição;
  • StatusCode: Código de status do processamento da requisição;
<div class="post">POST</div>
<div class="endereco">/rm/api/TOTVSCustomizacao/CstIntegracaoProtheus/ItemContabil</div>

Insere e/ou atualiza itens contábeis no RM, para uso no projeto Integração Protheus FIEC.

Tabela Afetada: ZINTPROTHEUSITEMCONTABILPROTHEUS

Interface RM: TOTVS Educacional | Educacional | Customização | Integração Protheus | Cadastros | Item contábil

Authorization - Basic Auth

Username <username>

Password <password>

Body

[
    {
		"codColigada": "3",
		"itemContabil": "0001253",
        "codFilial": null,
		"descricao": "teste Exemplo 0",
		"status": "T"
	}
]

Content

  • codColigada: Código da Coligada (obrigatório).
  • itemContabil: Código do Item Contábil Protheus (obrigatório). Para alterações, o SGE irá localizar o registro através deste código e do número da coligada. 
  • codFilial: Código da Filial.
  • descricao: Descrição do item contábil.
  • status: Status do item contábil.
    • T = Ativo
    • F = Inativo

Retorno

{
"Message": "Sucesso ao criar o item 123\r\n",
"Status": "Sucesso"
"StatusCode": 200
}

Content

  • Message: Mensagem de retorno do consumo da requisição;
  • Status: Situação do processamento da requisição;
  • StatusCode: Código de status do processamento da requisição;


<div class="post">POST</div>
<div class="endereco">/rm/api/TOTVSCustomizacao/CstIntegracaoProtheus/InclusaoLancamento</div>

Realiza a inclusão dos lançamentos no Contrato Educacional do SGE para uso no projeto Integração Protheus FIEC.

A API efetua a execução do processo de "Geração de Lançamentos".

Tabela Afetada: FLAN, SLAN

Interface RM: TOTVS Educacional | Educacional | Financeiro/Contábil | Contratos | Parcelas | Lançamentos Financeiros

Authorization - Basic Auth

Username <username>

Password <password>

Body

[
    {
        "codColigada": "3",
        "xnumpro": "TESTE1",
        "contaCaixaBanco": "001",
        "contaCaixaAgencia": "01",
        "contaCaixaContaCorrente": "111111",
        "parcela": 
            {   "pedidoVendaGerencial": "TESTE2",
                "nossoNumero": "TESTE2",
                "dataEmissao": "01/01/2000",
                "dataVencimento": "05/01/2000"
            }       
    }
]

Content

  • codColigada: Código da Coligada (obrigatório).
  • xnumpro: Utilizado para identificar o contrato/parcela referente ao lançamento (obrigatório).
  • contaCaixaBanco: Código do Banco da Conta Caixa/Convênio.
  • contaCaixaAgencia: Agência da Conta Caixa/Convênio.
  • contaCaixaContaCorrente: Conta Corrente da Conta Caixa/Convênio, com o dígito.
  • parcela: Dados da Parcela do SGE
    • pedidoVendaGerencial: Número do Pedido de Venda Gerencial gerado no Protheus referente à parcela (obrigatório).
    • nossoNumero: Nosso número do boleto.
    • dataEmissao: Data de Emissão do lançamento (obrigatório).
    • dataVencimento: Data de vencimento do lançamento (obrigatório).


Retorno

{
"Message": "Sucesso ao incluir o Id. Lançamento 142.\r\n",
"Status": "Sucesso",
"StatusCode": 200,
"IdLan": 142
}

Content

  • Message: Mensagem de retorno do consumo da requisição;
  • Status: Situação do processamento da requisição;
  • StatusCode: Código de status do processamento da requisição;
  • IdLan: Identificador do lançamento gerado pelo SGE.
<div class="post">POST</div>
<div class="endereco">/rm/api/TOTVSCustomizacao/CstIntegracaoProtheus/CancelamentoLancamento</div>

Cancela os lançamentos no RM, para uso no projeto Integração Protheus FIEC.

Tabela Afetada: FLAN

Interface RM: TOTVS Educacional | Educacional | Financeiro/Contábil | Contratos | Parcelas | Lançamentos Financeiros

Authorization - Basic Auth

Username <username>

Password <password>

Body

[
    {
		"codColigada": "3",
  		"idLan": "142",
  		"DataCancelamento": "01/01/2000"
	}
]

Content

  • codColigada: Código da Coligada (primary key);
  • idLan: Id do Lançamento (primary key);
  • DataCancelamento: Data do Cancelamento do Lançamento (primary key);


Retorno

{
"Message": "Sucesso ao excluir o Id. Lançamento 142\r\n",
"Status": "Sucesso",
"StatusCode": 200
}

Content

  • Message: Mensagem de retorno do consumo da requisição;
  • Status: Situação do processamento da requisição;
  • StatusCode: Código de status do processamento da requisição;
<div class="post">POST</div>
<div class="endereco">/rm/api/TOTVSCustomizacao/CstIntegracaoProtheus/CancelamentoBaixa</div>

Cancela as baixas dos lançamento no RM, para uso no projeto Integração Protheus FIEC.

Tabela Afetada: FLAN, FLANBAIXA

Interface RM: TOTVS Educacional | Educacional | Financeiro/Contábil | Contratos | Parcelas | Lançamentos Financeiros (editar o lançamento e acessar o anexo "Baixas do Lançamento")

Authorization - Basic Auth

Username <username>

Password <password>

Body

[
    {
		"codColigada": "3",
  		"idLan": "142",
  		"DataCancelamento": "01/01/2000"
	}
]

Content

  • codColigada: Código da Coligada (primary key);
  • idLan: Id do Lançamento (primary key);
  • DataCancelamento: Data do Cancelamento do Lançamento (primary key);


Retorno

{
"Message": "Sucesso ao cancelar baixa do Id. Lançamento 142\r\n",
"Status": "Sucesso",
"StatusCode": 200
}

Content

  • Message: Mensagem de retorno do consumo da requisição;
  • Status: Situação do processamento da requisição;
  • StatusCode: Código de status do processamento da requisição;
<div class="post">POST</div>
<div class="endereco">/rm/api/TOTVSCustomizacao/CstIntegracaoProtheus/BaixaTitulo</div>

Efetua a baixa do lançamento financeiro do SGE.

Tabela Afetada: FLAN, FLANBAIXA

Interface RM: TOTVS Educacional | Educacional | Financeiro/Contábil | Contratos | Parcelas | Lançamentos Financeiros (editar o lançamento e acessar o anexo "Baixas do Lançamento")

Authorization - Basic Auth

Username <username>

Password <password>

Body

[{
    "codColigada": "3",
    "idLan": "143",
    "ValorBaixa": 311.26,
    "DataBaixa": "16/12/2021",
    "ContaCaixa_Banco": "002",
    "ContaCaixa_AG": "9598",
    "ContaCaixa_CC": "1234",
    em análise pela FIEC: "ContaCaixa_SEMMOVIMENTACAO": "00001", 
    "Juros": 30.76,
    "Multa": 5.50,
    "Desconto": 0.0
}]

Content

  • codColigada: Código da Coligada. Enviar 2 para SESI e 3 para SENAI (primary key).
  • idLan: Id do Lançamento (primary key);
  • ValorBaixa: Valor da Baixa do Título (primary key);
  • DataBaixa: Data da Baixa do Título (primary key);
  • Baixas com movimentação bancária:
    • ContaCaixa_Banco: Código do banco da Conta para realização da Baixa;
    • ContaCaixa_AG: Código da agencia do banco da Conta para realização da Baixa;
    • ContaCaixa_CC: Codigo da Conta corrente para rea\lização da Baixa;Baixas com movimentação bancária:
  • Baixas sem movimentação bancária:
    • ContaCaixa_SemMovimentação: Código da Conta caixa do SGE utilizada para baixas de cartão e NCC que não efetuam movimentação bancária. 
  • Juros: Taxa de Juros da Baixa;
  • Multa: Valor da Multa da Baixa;
  • Desconto: Valor de Desconto da Baixa;

Retorno

{
    "Message": "Sucesso ao baixar o titulo do Id. Lançamento 143\r\n",
    "Status": "Sucesso",
    "StatusCode": 200
}

Content

  • Message: Mensagem de retorno do consumo da requisição;
  • Status: Situação do processamento da requisição;
  • StatusCode: Código de status do processamento da requisição;


<div class="post">POST</div>
<div class="endereco">/rm/api/TOTVSCustomizacao/CstIntegracaoProtheus/AlteracaoNossoNumero</div>

Insere e/ou atualiza o NossoNumero do lançamento financeiro do SGE.

Tabela Afetada: FLAN

Interface RM: TOTVS Educacional | Educacional | Financeiro/Contábil | Contratos | Parcelas | Lançamentos Financeiros

Authorization - Basic Auth

Username <username>

Password <password>

Body

{
  "codColigada" : "1",
  "NossoNumero" : "123", 
  "IDLan" : 123,
  "NumeroPedido" : null,
  "CodFilial" : null
}

Content

  • codColigada: Código da Coligada. Enviar 2 para SESI e 3 para SENAI (primary key).
  • NossoNumero: Numero do NossoNumero (obrigatório).
  • IDLan: Id do Lançamento (opcional) (Caso não seja possível preencher o campo IdLan, deverão ser enviados os parâmetros NumeroPedido e CodFilial).
  • NumeroPedido: Numero do Pedido Gerencial (opcional).
  • CodFilial: Código da Filial (opcional).

Retorno

{
    "Message": "Sucesso ao fazer a Alteração do Nosso Numero (IDLan/Numero Pedido : 172, NossoNumero: 123).\r\n\r\n",
    "Status": "Sucesso",
    "StatusCode": 200
}

Content

  • Message: Mensagem de retorno do consumo da requisição;
  • Status: Situação do processamento da requisição;
  • StatusCode: Código de status do processamento da requisição;
<style>
	.expand-control {
    	cursor: pointer;
    	text-decoration: none;
	    margin-bottom: 10px;
	    background-color: #ededed;
	    height: 30px;
	    font-size: 20px;
	    padding: 5px;
	}
	.expand-control-text {
    	vertical-align: top;
	    font-weight: bold;
		color: #242424;
	}
	.post {
    	background-color: #378000;
	    color: #ffffff;
	    display: inline-block;
	    padding: 5px;
	    border-radius: 5px;
		font-weight: bold;
	}
	.get {
    	background-color: #004fd6;
	    color: #ffffff;
	    display: inline-block;
	    padding: 5px;
	    border-radius: 5px;
		font-weight: bold;
	}
	.put {
    	background-color: #ffa200;
	    color: #ffffff;
	    display: inline-block;
	    padding: 5px;
	    border-radius: 5px;
		font-weight: bold;
	}
	.delete {
    	background-color: #cf0000;
	    color: #ffffff;
	    display: inline-block;
	    padding: 5px;
	    border-radius: 5px;
		font-weight: bold;
	}
	.endereco{
		display: inline-block;
		padding: 5px;
		font-weight: bold;
	}
</style>
<!-- 
EXEMPLO DE MARCAÇÃO PARA TIPO DE REQUEST:
<div class="post">POST</div>
<div class="get">GET</div>
<div class="put">PUT</div>
<div class="delete">DELETE</div>

O ENDEREÇO DEVE SER INSERIDO COM A SEGUINTE MARCAÇÃO:
<div class="endereco">/rm/api/TOTVSCustomizacao/CstIntegracaoProtheus/ItemContabil</div>
-->
<div class="post">POST</div>
<div class="endereco">/rm/api/TOTVSCustomizacao/CstIntegracaoProtheus/Acordo/Inclusao</div>

Efetiva no SGE os acordos efetuados no Protheus. 

A API efetua a criação do acordo, a baixa dos lançamentos originais e a criação dos novos lançamentos gerados pelo acordo, conforme negociação gerada no Protheus.

Tabela Afetada: FLAN, FLANBAIXA, FACORDO, FACORDOREL

Interface RM: TOTVS Educacional | Educacional | Financeiro/Contábil | Contratos | Parcelas | Lançamentos Financeiros (editar o lançamento e acessar o anexo "Acordo")

Authorization - Basic Auth

Username <username>

Password <password>

Body

[
  {
    "IdNegociacao": 100,
    "Codcoligada": 2,
    "NumParcelas": 10,
    "CodCCusto": null,
    "TipoJuros": 0,
    "TaxaJuros": 0,
    "ValorJurosDia": 0.0,
    "DataAcordo": "29/01/2022",
    "ValorLiquido": 1500.00,
    "ValorAcordo": 1500.00,
    "ValorDesconto": 0.0,
    "ValorAcrescimo": 0.0,
    "RA": "00000247",
    "LancamentosOriginais": 
     [{
        "idlan": 22
      }],
    "LancamentosAcordo": 
     [{
        "xnumpro": null,
        "nossoNumero": "898001212154",
        "dataVencimento": "2022-01-01",
        "valor": 1050.0
      }]
}

Content

  • codColigada: Código da Coligada. Enviar 2 para SESI e 3 para SENAI (primary key).
  • idLan: Id do Lançamento gerado no SGE (primary key);
  • idNegociacao: Chave da negociação do Protheus utilizada para identificar o registro no Log do Processo (pode concatenar vários valores neste campo). O valor enviado será gravado no campo "Observação" do Acordo gerado no SGE. 
  • NumParcelas: Número de Parcelas que devem ser geradas pelo Acordo no SGE.
  • CodCCusto: Código do Centro de Custo do Acordo
  • TipoJuros: Indica se será informado o percentual ou o valor dos juros. Enviar 0 para informar Taxa e 1 para informar Valor. De acordo com o preenchimento, apenas um campo abaixo deve ser informado:
    • TaxaJuros: Percentual de taxa de juros ao dia do Acordo
    • ValorJurosDia: Valor da taxa de juros ao dia do Acordo
  • ValorLiquido: Valor líquido do Acordo gerado.
  • ValorAcordo: Valor total do Acordo gerado.
  • ValorDesconto: Valor do desconto do Acordo.
  • ValorAcrescimo: Valor do acréscimo do Acordo.
  • RA: número do RA do aluno do Acordo.


  • LancamentosOriginais: lista de lançamentos que darão origem ao acordo. Os lançamentos enviados aqui serão baixados no SGE (tipo de baixa = Por Acordo). 
    • idlan: Identificador do lançamento original do acordo
  • LancamentosAcordo: lista de lançamentos que serão gerados pelo Acordo. O número de itens desta lista deve ser igual ao campo NumParcelas. Os lançamentos enviados aqui serão gerados no SGE com status Em Aberto (tabela FLAN).
    • xnumpro: Número do XNumPro gerado pelo Protheus, será armazenado no campo SEGUNDONUMERO do lançamento (FLAN).
    • nossoNumero: Nosso Número do boleto gerado no Protheus, é gravado no boleto associado ao lançamento no RM.
    • dataVencimento: Data de vencimento do lançamento/boleto.
    • valor: Valor total do boleto/lançamento.

Retorno

{
"Message": "Sucesso ao incluir o Acordo: 22\r\n",
"Status": "Sucesso",  
"StatusCode": 200,  
"IdAcordo": 20,   
"Data": "IdNegociacao": 100, "Codcoligada": 2, "NumParcelas": 10, "CodCCusto": null, "TipoJuros": 0, "TaxaJuros": 0, "ValorJurosDia": 0.0, "DataAcordo": "29/01/2022", "ValorLiquido": 1500.00, "ValorAcordo": 1500.00, "ValorDesconto": 0.0, "ValorAcrescimo": 0.0, "RA": "00000247", "LancamentosOriginais": 
}

Content

  • Message: Mensagem de retorno do consumo da requisição;
  • Status: Situação do processamento da requisição;
  • IdAcordo: Identificador do Acordo gerado no SGE;
  • StatusCode: Código de status do processamento da requisição;
  • Data: lista com informações do acordo gerado no SGE, juntamente com a lista 
<div class="post">POST</div>
<div class="endereco">/rm/api/TOTVSCustomizacao/CstIntegracaoProtheus/Acordo/Cancelamento</div>

Cancela o acordo financeiro gerado pelo Protheus importado para o SGE. Necessário enviar o identificador do acordo do SGE.

O cancelamento do acordo implica na reabertura dos títulos originais do acordo. 

Permitido apenas para acordos sem nenhuma parcela paga. Se necessário, deverá chamar antes a API de cancelamento de baixa para os títulos do acordo. 

Tabela Afetada: FLAN, FLANBAIXA, FACORDO, FACORDOREL

Interface RM: TOTVS Educacional | Educacional | Financeiro/Contábil | Contratos | Parcelas | Lançamentos Financeiros (editar o lançamento e acessar o anexo "Acordo")

Authorization - Basic Auth

Username <username>

Password <password>

Body

[
    {
		"codColigada": "3",
  		"idAcordo": "22",
  		"DataCancelamento": "01/01/2000"
	}
]

Content

  • codColigada: Código da Coligada. Enviar 2 para SESI e 3 para SENAI (primary key).
  • idAcordo: Id do acordo do SGE (obrigatório). Tal informação é devolvida para o Protheus pela API de inclusão de acordo. 
  • DataCancelamento: Data do Cancelamento do acordo (obrigatório).


Retorno

{
  "Message": "Acordo 21 (Negociação Protheus: 3|CSI|TESTE|CNO418Parc4&5), cancelado com sucesso.\r\n",
  "Status": "Sucesso",
  "StatusCode": 200,
 }

Content

  • Message: Mensagem de retorno do consumo da requisição;
  • Status: Situação do processamento da requisição;
  • StatusCode: Código de status do processamento da requisição;