I

Especificação Funcional
Interface - Outbound
Informações Gerais

A especificação funcional é criada para documentar e especificar o “O QUE” uma determinada funcionalidade
deve ter para ser executada, ao contrário de uma especificação técnica, que deve documentar e especificar o
“COMO” essa determinada funcionalidade deve ser construída para que seja executada.

Cenário (nível 3 da cadeia)

ID do GAP I16_042_Interface_Softise_Envio_Preço_Vendas
Módulo do R/3 SD
Autor
Data 21/08/2013

Página 2 - Data: 22/1/2024

 SUMÁRIO

INFORMAÇÕES GERAIS ................................................................................................................................................... 2

RESUMO DO DESENVOLVIMENTO ............................................................................................................................... 4
DETALHAMENTO DA ESPECIFICAÇÃO FUNCIONAL ............................................................................................. 5
2.1 PROCESSOS RELACIONADOS (TRANSAÇÕES DO SISTEMA R/3) ........................................................................................ 5
2.2 SUMÁRIO ........................................................................................................................................................................ 5
2.3 OBJETIVO ....................................................................................................................................................................... 5
2.4 PRÉ-CONDIÇÕES PARA QUE O DESENVOLVIMENTO SEJA EXECUTADO ............................................................................. 5
2.5 CONDIÇÕES QUE OCORREM QUANDO O DESENVOLVIMENTO É EXECUTADO .................................................................... 5
2.6 PÓS-CONDIÇÕES RESULTADO ESPERADO......................................................................................................................... 7
2.7 MATERIAL ADICIONAL.................................................................................................................................................... 7
2.8 AUTORIZAÇÃO E SEGURANÇA ........................................................................................................................................ 7
INFORMAÇÕES QUANDO DESENVOLVIMENTO FOR PARA INTERFACES DE SAÍDA (OUTBOUND
INTERFACES) ....................................................................................................................................................................... 7
1. DEFINIÇÃO DO LAYOUT DA TELA DE SELEÇÃO ............................................................................................................ 7
2. DEFINIÇÃO DOS PARÂMETROS DE SELEÇÃO ................................................................................................................ 7
3. ARQUIVOS DE SAÍDA – INFORMAÇÕES GERAIS ........................................................................................................... 7
4. ARQUIVOS DE SAÍDA – LAYOUT .................................................................................................................................. 7
5. MAPEAMENTO DE SAÍDA E REGRAS DE CONVERSÃO ................................................................................................. 11
6. INDICADORES DE CONTROLE DA INTERFACE: ............................................................................................................ 11
SCRIPT DE TESTES........................................................................................................................................................... 11
1. DESCRIÇÃO FUNCIONAL DO PROCEDIMENTO DE TESTES ........................................................................................... 11
2. DESCRIÇÃO FUNCIONAL DOS RESULTADOS ESPERADOS APÓS O TESTE ...................................................................... 12
3. MATERIAL ADICIONAL PARA OS TESTES.................................................................................................................... 12

Página 3 - Data: 22/1/2024

Resumo do Desenvolvimento

Página 4 - Data: 22/1/2024

Detalhamento da Especificação funcional

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

VA21 – Criar Cotação / VK11 – Criar Registro de Condições / VK12 – Modificar Registro de Condição

2.2 Sumário

1) Envio do Preço de Vendas Mercado e Posto do SAP para o SOFTISE.

Atualização da tabela interna de conhecimentos

2.3 Objetivo

Enviar os preços de vendas e as alíquotas de ICMS determinado anteriormente pelo Desenvolvimento

2.4 Pré-condições para que o desenvolvimento seja executado

Para que a interface “rode” com sucesso, primeiramente é necessário que os dados estejam organizados de
forma estruturada na origem e no recebimento.

Os registros de preços e alíquotas foram organizados por tipo de condições específicas e guardados em
tabelas Standard criadas como Sequência de acesso no SAP.

Abaixo a estrutura de Tabelas no SAP onde os registros foram gravados.

Descrição Parâmetros Tabela Campos

VKORG / KSCHL/ WERKS /

Preço de Vendas por Loja Org.Vendas / Centro / Material A501
MATNR

VKORG / KSCHL/ WERKS /

Preço de Vendas por Loja/Hq. Prod. Org.Vds/Centro/Material/Hq. Prod. A624
MATNR / PRODH1

VKORG / KSCHL / PRODH1

Preço de Vendas por Hierq.Prod. A502
Org.Vendas / Hierarq.Produto/Material /MATNR

Preço de Vendas por Região Org.Vendas/Material A503 VKORG / KSCHL / MATNR

2.5 Condições que ocorrem quando o desenvolvimento é executado

A interface entre o SAP e o SOFTISE será feito via Webservice (Abap Proxy) executando comunicação sícrona
e assíncrona. O PI terá a função de tradutor entre o Legado e o ERP efetuando a “conversa” entre esses dois
sistemas, isto é, os registros terão saídas em linguagem ABAP e chegadas em linguagem Web.

Parâmetros de entrada:

Página 5 - Data: 22/1/2024

 Descrição Parâmetros Tabela Campos

VKORG / KSCHL / WERKS /

Preço de Vendas por Loja Org.Vendas / Centro / Material A501
MATNR

Exemplo: Preço por Loja (Sincrona e/ou Assincrona)

❖ Deverá rodar um JOB diariamente as 23:00 para atualizar os preços de vendas para o mercado e
posto de combustível;

O programa deverá ler os parâmetros de entrada da tabela A501 o tipo de condição ZPRE e ZPRM (criar um
“set” para administrar o tipo de condição dinamicamente) e encontrar o registro gravado no campo
“N.reg.cond.” (KNUMH), entrar na tabela KONP, informar o mesmo “N.reg.cond.” para encontrar o preço de
vendas e a alíquota de ICMS gravados nos tipos de condições ZPRS e ZCVA e todos os campos adicionais
dentro a VK11 e grava no banco de dados do SOFTISE disponibilizando os valores a partir até as 02:00 da
manha.

Exemplo: Tabela A501. ( A lógica será a mesma para as tabelas A624, A502 e A503, porem essas três
somente de forma Assíncrona, ou seja apenas envio.)

- No exemplo o programa encontrou o N.reg.cond 0000560545 na tabela A501

- Será utilizado como parâmetro na KONP para encontrar os valores das condições.
- Neste exemplo eu cadastrei a condição ZPRE como exemplo.

Tratamento para as condições ao enviar para o SOFTISE:

Algumas condições precisam ser divididas por 10 para gravar nas tabelas do SOFTISE no momento
no envio conforme abaixo:
Obs: o valor de algumas condições dever ser levados com 3 dígitos após a virgula como é o caso do
PIS, COFINS, Lei de Transparência.
Exemplo:

Página 6 - Data: 22/1/2024

 ✓ ZSBS: 1.000,00/10 = 100,000
✓ ZCVA: 180,000/10 = 18,000
✓ ZLEI: 23,34/ 10 = 2,345
✓ ZPIS: 16,50 /10 =1,65
✓ ZCOF:76,00/10 =7,60
✓ ZSVA: 50,00/10 = 5,000
✓ ZSVB: 90,00/10 = 9,000
✓ ZSVN: 70,00/10 = 7,000

2.6 Pós-condições resultado esperado

Deverão ser criadas no SOFTISE as mesmas estruturas das tabelas customizadas no SAP para que os
registros sejam enviados e recebidos de forma organizada.

2.7 Material adicional

N/A

2.8 Autorização e Segurança

Informações quando desenvolvimento for para interfaces de saída (outbound interfaces)

1. Definição do layout da tela de seleção

N/A

2. Definição dos parâmetros de seleção

Parâmetro Tipo Referencia Valor inicial Consistência

3. Arquivos de saída – Informações Gerais

Nome e caminho para o
arquivo de saída
(unix / local / ambos )
Caso o arquivo já exista:
N/A : O envio será via Webservice
( ) Sobrescrever (“overwrite”)
( ) Acrescentar no final (“append”)
( ) Mensagem de erro (“Abort”)
( ) Outros: __________________________________

4. Arquivos de saída – Layout

1. Caso: Preço por Loja - TABELA A501

Layout de saída
SAP - SOFTISE

Página 7 - Data: 22/1/2024

Sequência

Tamanho

Decimais
Tabela-Campo
Campo do SOFTISE Descrição Comentários gerais
SAP

1 Organização Vendas A501-VKORG Organização de Vendas 4 0 Organização de vendas

2 Tipo de condição A501-KSCHL Tipo condição 4 0 Tipo condição

3 Material A501-MATNR Número do material 18 0 Número do material

4 Centro A501-WERKS Centro 4 0 Centro

0 Início da validade do
5 Validade desde A501-DATAB Validade desde 8 registro de condição
0 Fim da validade do
6 Validade até A501-DATBI Validade até 8 registro de condição
7 N.reg.cond A501-KNUMH N.reg.cond 10 0 N.reg.cond
Unidade de preço da 0 Unidade de preço da
8 Quantidade KONP-KPEIN 5 condição
condição
9 Unidade de medida KONP-KMEIN Unidade de medida 3 0 Unidade de medida

10 Preço de venda KONP KBETR Preço de venda (ZPRS) 11 2 Preço de venda

11 Alíquota de ICMS KONP KBETR Alíquota de ICMS (ZCVA) 11 2 Alíquota de ICMS

12 Base ICMS KONP KBETR Base ICMS (ZCBS) 11 2 Base ICMS

Alíquota de COFINS 2
13 Alíquota de COFINS KONP KBETR 11 Alíquota de COFINS
(ZCOF)
14 Alíquota de PIS KONP KBETR Alíquota de PIS (ZPIS) 11 2 Alíquota de PIS
Alíquota de ISS Geral 2
15 Alíquota de ISS KONP KBETR 11 Alíquota de ISS GERAL
(ZSVA)
Alíquota de ISS Prov 2
14 Alíquota de ISS Prov KONP KBETR 11 Alíquota de ISS Prov.
(ZSVB)
Alíq.a de ISS Loc.Serv 2
15 Alíq. de ISS Loc.Serv KONP KBETR 11 Alíquota de ISS Loc.Serv
(ZSVN)
Lei de Transparencia 2
16 Lei de Transparencia KONP KBETR 11 Lei Transparência
(ZLEI)
17 CST ICMS taxlaw Situação Tributária ICMS 2 0 Situação Tributária ICMS

18 CST PIS taxlaw Situação Tributária PIS 2 0 Situação Tributária PIS

taxlaw Situação Tributária 0

19 CST COFINS 2 Situação Tributária COFINS
COFINS

2. Caso: Preço por Loja/Hierarquia de Produto - TABELA A624

Layout de saída
SAP - SOFTISE
Sequência

Tamanho

Decimais

Tabela-
Campo do SOFTISE Descrição Comentários gerais
Campo SAP

1 Organização Vendas A624-VKORG Organização de Vendas 4 0 Organização de vendas

2 Tipo de condição A501-KSCHL Tipo condição 4 0 Tipo condição

Página 8 - Data: 22/1/2024

3 Centro A624-WERKS Centro 4 0 Centro

4 Material A624-MATNR Número do material 18 0 Número do material

Código de A624- Elemento de dados
5 5 0 Hierarquia de Produto
amarração PRODH1 standard PRODH1
Início da validade do registro de
6 Validade desde A624-DATAB Validade desde 8 0 condição
Fim da validade do registro de
7 Validade até A624-DATBI Validade até 8 0 condição
8 N.reg.cond A624-KNUMH N.reg.cond 10 0 N.reg.cond
Unidade de preço da
9 Quantidade KONP-KPEIN 5 0 Unidade de preço da condição
condição
10 Unidade de medida KONP-KMEIN Unidade de medida 3 0 Unidade de medida

11 Preço de venda KONP KBETR Preço de venda (ZPRS) 11 2 Preço de venda

Alíquota de ICMS
12 Alíquota de ICMS KONP KBETR 11 2 Alíquota de ICMS
(ZCVA)
13 Base ICMS KONP KBETR Base ICMS (ZCBS) 11 2 Base ICMS
Alíquota de COFINS
14 Alíquota de COFINS KONP KBETR 11 2 Alíquota de COFINS
(ZCOF)
16 Alíquota de PIS KONP KBETR Alíquota de PIS (ZPIS) 11 2 Alíquota de PIS
Alíquota de ISS Geral
17 Alíquota de ISS KONP KBETR 11 2 Alíquota de ISS GERAL
(ZSVA)
Alíquota de ISS Prov
18 Alíquota de ISS Prov KONP KBETR 11 2 Alíquota de ISS Prov.
(ZSVB)
Alíq.a de ISS Loc.Serv
19 Alíq. de ISS Loc.Serv KONP KBETR 11 2 Alíquota de ISS Loc.Serv
(ZSVN)
Lei de Transparencia
20 Lei de Transparencia KONP KBETR 11 2 Lei Transparência
(ZLEI)
taxlaw Situação Tributária
21 CST ICMS 2 0 Situação Tributária ICMS
ICMS
22 CST PIS taxlaw Situação Tributária PIS 2 0 Situação Tributária PIS

taxlaw Situação Tributária

23 CST COFINS 2 0 Situação Tributária COFINS
COFINS

3. Caso: Preço por Hierarquia de Produto – TABELA A502

Layout de saída
SAP - SOFTISE
Sequência

Tamanho

Campo do Tabela-Campo
Descrição Comentários gerais
SOFTISE SAP

1 Regiao A502-VKORG Organização de Vendas 4 0 Organização de vendas

Tipo de 0
2 A501-KSCHL Tipo condição 4 Tipo condição
condição
3 Material A502-MATNR Número do material 18 0 Número do material
Código de Elemento de dados standard
4 A502-PRODH1 5 0 Hierarquia de Produto
amarração PRODH1
Validade
5 A502-DATAB Validade desde 8 0 Início da validade do registro de condição
desde
6 Validade até A502-DATBI Validade até 8 0 Fim da validade do registro de condição

Página 9 - Data: 22/1/2024

7 N.reg.cond A502-KNUMH N.reg.cond 10 0 N.reg.cond

8 Quantidade KONP-KPEIN Unidade de preço da condição 5 0 Unidade de preço da condição

Unidade de
9 KONP-KMEIN Unidade de medida 3 0 Unidade de medida
medida
Preço de
10 KONP KBETR Preço de venda (ZPRS) 11 2 Preço de venda
venda
Alíquota de
11 KONP KBETR Alíquota de ICMS (ZCVA) 11 2 Alíquota de ICMS
ICMS
12 Base ICMS KONP KBETR Base ICMS (ZCBS) 11 2 Base ICMS
Alíquota de
13 KONP KBETR Alíquota de COFINS (ZCOF) 11 2 Alíquota de COFINS
COFINS
Alíquota de
14 KONP KBETR Alíquota de PIS (ZPIS) 11 2 Alíquota de PIS
PIS
Alíquota de
15 KONP KBETR Alíquota de ISS Geral (ZSVA) 11 2 Alíquota de ISS GERAL
ISS
Alíquota de
16 KONP KBETR Alíquota de ISS Prov (ZSVB) 11 2 Alíquota de ISS Prov.
ISS Prov
Alíq. de ISS
17 KONP KBETR Alíq.a de ISS Loc.Serv (ZSVN) 11 2 Alíquota de ISS Loc.Serv
Loc.Serv
Lei de
18 KONP KBETR Lei de Transparencia (ZLEI) 11 2 Lei Transparência
Transparencia
19 CST ICMS taxlaw Situação Tributária ICMS 2 0 Situação Tributária ICMS
20 CST PIS taxlaw Situação Tributária PIS 2 0 Situação Tributária PIS
21 CST COFINS taxlaw Situação Tributária COFINS 2 0 Situação Tributária COFINS

4. Caso: Preço por Região. – TABELA A503

Layout de saída
SAP - SOFTISE
Sequência

Tamanho
Decimais

Campo do Tabela-
Descrição Comentários gerais
SOFTISE Campo SAP

1 Regiao A503-VKORG Organização de Vendas 4 0 Organização de vendas

2 Tipo de condição A501-KSCHL Tipo condição 4 0 Tipo condição

3 Material A503-MATNR Número do material 18 0 Número do material

Início da validade do registro de
4 Validade desde A503-DATAB Validade desde 8 0
condição
Fim da validade do registro de
5 Validade até A503-DATBI Validade até 8 0
condição
6 N.reg.cond A503-KNUMH N.reg.cond 10 0 N.reg.cond
Unidade de preço da
7 Quantidade KONP-KPEIN 5 0 Unidade de preço da condição
condição
8 Unidade de medida KONP-KMEIN Unidade de medida 3 0 Unidade de medida
9 Preço de venda KONP KBETR Preço de venda (ZPRS) 11 2 Preço de venda
10 Alíquota de ICMS KONP KBETR Alíquota de ICMS (ZCVA) 11 2 Alíquota de ICMS
11 Base ICMS KONP KBETR Base ICMS (ZCBS) 11 2 Base ICMS

Página 10 - Data: 22/1/2024

 Alíquota de Alíquota de COFINS
12 KONP KBETR 11 2 Alíquota de COFINS
COFINS (ZCOF)
13 Alíquota de PIS KONP KBETR Alíquota de PIS (ZPIS) 11 2 Alíquota de PIS
Alíquota de ISS Geral
14 Alíquota de ISS KONP KBETR 11 2 Alíquota de ISS GERAL
(ZSVA)
Alíquota de ISS Alíquota de ISS Prov
15 KONP KBETR 11 2 Alíquota de ISS Prov.
Prov (ZSVB)
Alíq. de ISS Alíq.a de ISS Loc.Serv
16 KONP KBETR 11 2 Alíquota de ISS Loc.Serv
Loc.Serv (ZSVN)
Lei de Lei de Transparencia 11
17 KONP KBETR 2 Lei Transparência
Transparencia (ZLEI)
18 CST ICMS taxlaw Situação Tributária ICMS 2 0 Situação Tributária ICMS
19 CST PIS taxlaw Situação Tributária PIS 2 0 Situação Tributária PIS
taxlaw Situação Tributária
20 CST COFINS 2 0 Situação Tributária COFINS
COFINS

5. Mapeamento de saída e regras de conversão

Arquivo de saída
Conversões: ( ) R/3 ( ) Legado ( x ) Outros:
_________________________________________
Campo do arquivo de saída Origem do dado no R/3 Regra de conversão / observações

Os registros serão gravados direto no

banco do SOFTISE via Webservice.

6. Indicadores de controle da interface:

Definir indicadores de controle para o relatório, por exemplo, um log de processamento.

.
Script de Testes

1. Descrição funcional do procedimento de testes

Foi criado alguns registros manualmente nas tabelas customizadas do SAP para efetuar os testes.
Existe registro para atender cada situação conforme sequência de acesso customizada.

Página 11 - Data: 22/1/2024

 2. Descrição funcional dos resultados esperados após o teste
3. Deve-se antecipar o horário para os testes do envio dos preços e verificar se as informações estão
corretamente gravadas no bando do SOFTISE

4. Material adicional para os testes

N/A

Responsável pelos testes na frente

funcional

Aprovação do testes ___/___/___

Página 12 - Data: 22/1/2024