Especificação Funcional

Projeto:
Projeto Passaporte – Vigor
Frente/Módulo: Título:
SAP BP Tela do CISP no BP
Elaborado Por:
Arieta Povidaiko
Usuário-Chave: Produto: Página:
Thamires Carvalho GAP’s: BP08-02 GAP_I-79 - Versão 02 1 de 6

Sumário

A - OBJETIVO....................................................................................................................................2

B - DETALHAMENTO DA ESPECIFICAÇÃO FUNCIONAL..............................................................2

1. Processos relacionados (transações do sistema R/3)................................................................................2

2. Descrição.................................................................................................................................................... 2
3. Documentação das API’s........................................................................................................................... 3
4. Exemplo das API’s no Postman................................................................................................................. 4
5. Material adicional........................................................................................................................................ 4

H - OUTROS DESENVOLVIMENTOS...............................................................................................4

1. Modificação de objeto standard SAP.......................................................................................................... 4

I - PLANO DE TESTES......................................................................................................................6

1. Descrição funcional do procedimento de testes......................................................................................... 6

2. Descrição funcional dos resultados esperados após o teste......................................................................6
3. Material adicional para os testes................................................................................................................ 6

J - APROVAÇÃO DA ESPECIFICAÇÃO FUNCIONAL.....................................................................6

Última alteração: 20/3/2024 Página 1 de 6

 Especificação Funcional
Projeto:
Projeto Passaporte – Vigor
Frente/Módulo: Título:
SAP BP Tela do CISP no BP
Elaborado Por:
Arieta Povidaiko
Usuário-Chave: Produto: Página:
Thamires Carvalho GAP’s: BP08-02 GAP_I-79 - Versão 02 2 de 6

A - Objetivo
Descrição Tela para receber os dados da API do CISP no BP
Tipo de ( ) Conversão ( ) Batch Interface ( X ) Online Interface ( ) Relatório
programa ( ) Formulário ( X ) Enhancement ( X ) Modificação SAP standard
( X ) Programa online ( ) Outros – Especificar: _______________________
Prioridade ( X ) Alta / Obrigatório ( ) Média / Recomendável ( ) Baixa / Desejável
Aprovação

Aprovação do Aprovação do
Usuário Chave ___/___/____ Consultor Funcional ___/___/____

O Objetivo dessa EF é dar uma visão do processo de Enriquecimento dos dados via CISP, como um todo.
Desde a alteração da tela no BP com a inclusão do botão que consultará os dados no CISP, até a
atualização dos campos em tela do SAP com os dados recebidos.
 GAP_I-79 - Consulta de informações cadastrais de clientes no CISP - S4 para CISP
 BP08-02 - Criar uma tela adicional na role principal do BP, para que sejam populados dados do
CISP

B - Detalhamento da Especificação Funcional

1. Processos relacionados (transações do sistema R/3)

No processo atual o cadastro dos clientes no Oracle, tem seus dados validados pela empresa CISP.
A CISP faz uma análise em APIs públicas e privadas, onde devolve para a VIGOR os dados dos
clientes/fornecedores enriquecidos por: Receita Federal, Simples e Sintegra.

2. Descrição

Cenário atual:
 O cadastro do cliente é feito no Oracle, onde há um botão chamado CISP, que ao ser clicado traz
informações da Receita Federal, Simples e Sintegra.

Última alteração: 20/3/2024 Página 2 de 6

 Especificação Funcional
Projeto:
Projeto Passaporte – Vigor
Frente/Módulo: Título:
SAP BP Tela do CISP no BP
Elaborado Por:
Arieta Povidaiko
Usuário-Chave: Produto: Página:
Thamires Carvalho GAP’s: BP08-02 GAP_I-79 - Versão 02 3 de 6

Tela do Oracle

Cenário proposto:

 Ao criar o cadastro do BP(cliente/fornecedor) e após imputar o CNPJ, ele terá um botão chamado CISP,
que irá nas API’s deles, efetuará a consulta, e retornará com os dados enriquecidos. Haverá também a
opção de transferir esses dados para os campos do SAP, atualizando-os dados em tela.

3. Documentação das API’s

 A API a ser usada será a da solução MAXXI da empresa CISP

o API Receita Federal: https://developers.maxxi.cisp.com.br/reference/consulta-cnpj-na-receita-
federal
o API Simples: https://developers.maxxi.cisp.com.br/reference/consulta-cnpj-no-simples-nacional
o API Sintegra: https://developers.maxxi.cisp.com.br/reference/sintegra
A API do Sintegra é uma das consultas mais demoradas pois depende do resultado vindo dos
estados. Dentro da CISP essa API tem um timeout de consulta de 30 segundos. Caso retorne

Última alteração: 20/3/2024 Página 3 de 6

 Especificação Funcional
Projeto:
Projeto Passaporte – Vigor
Frente/Módulo: Título:
SAP BP Tela do CISP no BP
Elaborado Por:
Arieta Povidaiko
Usuário-Chave: Produto: Página:
Thamires Carvalho GAP’s: BP08-02 GAP_I-79 - Versão 02 4 de 6

erro na consulta dessa API, não reconsultar dentro do CI e exibir como retorno um erro de
consulta nessa API
A consulta na API do Sintegra, deve ser feita com a UF retornada na API da Receita Federal.

4. Exemplo das API’s no Postman

Todas as API’s a serem consultadas, estão com exemplos preenchidos no Postman

Para abrir a collection do Postman, use este arquivo do Sharepoint da Vigor: VIGOR - CISP.postman_collection.json

5. Material adicional

Usar o Excel anexo como guia tanto para trabalhar com os dados do json, quanto para trabalhar com a tela

no SAP
Leias as anotações feitas nos campos do Excel, elas são de supra importância para entendimento da EF.

H - Outros Desenvolvimentos

1. Modificação de objeto standard SAP

No BP será criado uma screen exit onde colocaremos um botão que irá chamar um tela pop-up.
Ao clicar no Botão “CISP” serão chamados as 3 API’s da CISP.
Essa tela que contém o botão “CISP” somente será chamada se estivermos no modo de ampliação do BP
para Cliente ou Fornecedor. O que isto quer dizer? Quer dizer que o BP deverá estar com as roles de
cliente (FLCU00 e/ou FLCU01) ou role de fornecedor (FLVN01)
Pois essas roles são importantes para fazer a transferência dos enriquecidos para a tela do SAP

Última alteração: 20/3/2024 Página 4 de 6

 Especificação Funcional
Projeto:
Projeto Passaporte – Vigor
Frente/Módulo: Título:
SAP BP Tela do CISP no BP
Elaborado Por:
Arieta Povidaiko
Usuário-Chave: Produto: Página:
Thamires Carvalho GAP’s: BP08-02 GAP_I-79 - Versão 02 5 de 6

Tela Pop-UP ***Tela Ilustrativa, Olhar os campos e a tela detalhados no Excel

Os dados dessa subtela só serão transferidos para os respectivos campos na tela do SAP, se e somente
se uma das opções de flag de transferência, estiver selecionada.

Figura 1 e 2 - Tela desenhada no Excel em anexo

Última alteração: 20/3/2024 Página 5 de 6

 Especificação Funcional
Projeto:
Projeto Passaporte – Vigor
Frente/Módulo: Título:
SAP BP Tela do CISP no BP
Elaborado Por:
Arieta Povidaiko
Usuário-Chave: Produto: Página:
Thamires Carvalho GAP’s: BP08-02 GAP_I-79 - Versão 02 6 de 6

Foi colocada a opção de se usar o endereço do Sintegra, pois produtores rurais e/ou propriedades com
CNPJ, podem precisar usar os dados do Sintegra, ao invés dos da Receita.

I - Plano de Testes

1. Descrição funcional do procedimento de testes

Efetuar novos cadastros de BP e ou alterar cadastros já existentes via transação BP ou sua opção
Fiorizada.
Comparar os dados enriquecidos na subtela, com os órgãos oficiais do Governo via consulta manual.
 Receita Federal:
https://solucoes.receita.fazenda.gov.br/servicos/cnpjreva/cnpjreva_solicitacao.asp
 Simples: http://www8.receita.fazenda.gov.br/SIMPLESNACIONAL/aplicacoes.aspx?id=21
 Sintegra: http://www.sintegra.gov.br/

Alguns exemplos de CNPJ para se trabalhar:

52502507000309
75315333033384
89305239000183

2. Descrição funcional dos resultados esperados após o teste

O BP deverá ser criado no SAP com os dados transferidos via tela enriquecida com os dados da CISP

3. Material adicional para os testes

Responsável pelos testes na frente funcional Arieta Povidaiko

Aprovação dos testes 17/10/2022

J - Aprovação da Especificação Funcional

Consultor Funcional Arieta Povidaiko

Usuário Chave Thamires Carvalho

Data 17/10/2022

Última alteração: 20/3/2024 Página 6 de 6