Documentação Geral

Cockpit – Determinação de Perfil do TaaS


     

    Determinação de Perfil do TaaS
    Por Fernanda Almeida

    Para facilitar e desburocratizar o processo de determinação de perfil, implementamos no cockpit a tela de determinação de perfil onde o usuário poderá incluir, alterar ou desativar a determinação de perfil sem a necessidade de intervenção da equipe de TI.

     

    Além disso, as ações são refletidas imediatamente no TaaS.

     

    A determinação de perfil é um conversor que transforma a chamada SAP em uma chamada identificada pelo motor da Systax.

     

    O fluxo do TaaS é da seguinte forma:

    • Formato da chamada no TaaS:

    A determinação de perfil utiliza as informações da chamada do SAP e determina qual operação o motor deverá chamar de acordo com os parâmetros determinados:

     

     

     

    A condição dos parâmetros da chamada do remetente e do destinatário resultam na consequência que são os perfis do cenário conhecidos pelos sistemas da Systax.

     

    A determinação de Perfil está disponível no cockpit.

     

    • Determinação de Perfil no cockpit:

    A rotina está disponível no cockpit:

    • Documentos
      • Determinação de Perfil

     

     

     

    Na tela temos o menu do “filtro” e do “upload”.

    No menu “filtro”, temos os filtros por campo da chamada:

    De/Para da nomenclatura dos campos:

     

    Nomenclatura do Campo - Cockpit

    Nomenclatura do Campo - TaaS

    Preenchimento do Campo

    Código

    ID

    Número do ID sequencial

    Venda ou Compra

    saleOrPurchase

    S ou P

    Natura de Operação

    operationNatureCode

    Standard SAP ou definido pelo cliente

    Tipo de mercadoria

    Item Type

    M

    Origem do Produto

    Material Origin

    0 a 8

    Produção Própria

    ownProduction

    Y ou N ou vazio

    Finalidade

    Usage

    I - Industrialização
    R - Revenda
    C - Consumo
    A -Ativo

    Uso do Produto

    Usage Purpose

    Standard SAP ou definido pelo cliente

    Transação Comercial

    Business Transaction

    Standard SAP ou definido pelo cliente

    Origem -  País

    Ship_From_Country

    Sigla do País

    Origem -  UF

    Ship_From_UF

    Sigla da UF

    Destino -  UF

    Ship_To_UF

    Sigla da UF

    Origem - CNAE

    Ship_From_Cnae

    2 ou 4 primeiros dígitos do CNAE ou vazio

    Origem - CNPJ

    Ship_From_CNPJ

    CNPJ do remetente ou vazio

    Origem - IE

    Ship_From_IE

    4 dígitos da IE do remetente ou vazio

    Origem - Código IBGE

    Ship_From_IBGECode

    Código do municipio ou vazio

    Origem - Natureza Legal

    Ship_From_legalNature

    Código da natureza legal ou vazio

    Origem - Suframa

    Ship_From_Suframa

    Y ou N ou vazio

    Origem - Contribuinte do ICMS

    Ship_From_ICMSContributor

    Y ou N ou vazio

    Origem - Contribuinte do ICMS ST

    Ship_From_ICMSSTContributor

    Y ou N ou vazio

    Origem - Contribuinte IPI

    Ship_From_IPIContributor

    Y ou N ou vazio

    Origem - Tipo de Declaração Fiscal

    Ship_From_Tax_declarationType

    Real Profit
    Presumed Profit ou vazio

    Origem - Código do Regime Tributário

    Ship_From_taxRegimenCode

    1 – Simples Nacional

    2 – Simples Nacional com excesso de faturamento

    3 – RPA

    Destinatário - CNAE

    Ship_To_Cnae

     2 ou 4 primeiros dígitos do CNAE ou vazio

    Destinatário - CNPJ

    Ship_To_CNPJ

     CNPJ do destinatário ou vazio

    Destinatário - Natureza Legal

    Ship_To_legalNature

     Código da natureza legal ou vazio

    Destinatário - SUFRAMA

    Ship_To_SUFRAMA

    Y ou N ou vazio

    Destinatário - Código IBGE

    Ship_To_IBGECode

     Código do municipio ou vazio

    Destinatário - Contribuinte ICMS

    Ship_To_ICMSContributor

    Y ou N ou vazio

    Destinatário - Contribuinte ICMS ST

    Ship_To_ICMSSTContributor

    Y ou N ou vazio

    Destinatário - Contribuinte IPI

    Ship_To_IPIContributor

    Y ou N ou vazio

    Destinatário - Contribuinte ISS

    Ship_To_ISSContributor

    Y ou N ou vazio

    Destinatário - Tipo de Declaração Fiscal

    Ship_To_TaxDeclarationType

    Real Profit
    Presumed Profit

    Destinatário - Código do Regime Tributário

    Ship_To_TaxRegimenCode

    1 – Simples Nacional

    2 – Simples Nacional com excesso de faturamento

    3 – RPA

    ou vazio

    Systax - Natureza de Operação

    Natureza de Operação

    Natureza de Operação do cenário 

    Systax - Finalidade

    Finalidade

    Finalidade do cenário

    Systax - Ex-Origem

    Perfil Remetente

    Perfil ex-origem

    Systax - Ex-Destinação

    Perfil Destinatário

    Perfil destinação

    Systax - Tipo Entrada/Saída

    Entrada/Saída

    0 – Entrada

    1 – Saída

    Genérico do Cabeçalho

     

     

     

    Definições dos campos:

     

    • As determinações de perfil deverão ser feitas em comum acordo com o cliente, visto que as informações recebidas no payload são decorrentes do preenchimento da masterdata do cliente, isto é, cadastro de clientes e fornecedores no SAP.
    • Se houver mais de uma informação para o campo, as informações deverão ser separadas por vírgula.
    • No caso do campo do Ship_to_SUFRAMA, na chamada do TaaS é enviado o número da inscrição, porém a validação do campo é preenchido SIM ou Não ou vazio.
    • Cada determinação de Perfil inserida dentro do cockpit grava automaticamente a chave banco do cliente logado.
    • A ordem dos IDs é sequêncial, portanto não existe mais exclusão de registros. Caso alguma linha não seja mais utilizada, a mesma deverá ser desativada. O TaaS valida na tabela se a linha está ativa e a utiliza para o cálculo. Se a linha estiver desativada, o TaaS não considerará.

     

    Regras de Aplicação:

    1 - Todos os campos recebidos na chamada, filtrar com o valor recebido e vazio;

    2 - Se algum campo de condição não for recebido na chamada, filtrar vazio;

    3 - Se encontrada mais de 1 linha, prevalece a linha com mais condições preenchidas;

    4 - Quando for enviado a informação: "Ship_From // taxDeclarationType = presumed profit" na chamada, deverá ser incluído o perfil 134 no campo "perfil_rem" juntamente aos demais perfis de origem para a conversão das alíquotas de Pis e Cofins para lucro presumido (alíquotas 0,65% e 3%).

    No menu “upload”, temos a possibilidade de fazer o upload da determinação de perfil por arquivo CSV:

     

     

    Para fazer o upload da determinação de perfil, basta baixar o arquivo modelo e incluir as condições e a consequência:

     

     

    Caso o arquivo tenha alguma quebra de linha, espaços ou caracteres especiais, o sistema pula o registro e processa as linhas na sequência.

     

    No momento do upload, deve ser informado a tabela da determinação de perfil, sendo: homologação ou produção.

     

    • Funcionalidades na linha do registro:

    Na linha da linha há as seguintes opções:

     

     

    •  - Histórico da linha – guarda o registro anterior quando a linha é editada
    •  - Detalhes da linha – mostra em formato vertical a informações da linha
    •  - Cópia da linha – cria um novo registro partindo de uma linha existente
    •  - Edição da linha – altera informações de um registro existente
    •  - Semáforo do status da linha (verde – ativo // vermelho – desativado)

     

    Histórico da linha – mostra o histórico de edições que a linha foi submetida:

     

    Detalhe da linha – Informa as condições e consequência do registro:

      

     

       

     

    Cópia da linha – cria um novo registro editado partindo de uma linha existente:

     

    Edição da linha – permite a edição de uma linha existente:

     

    • Inativação das Linhas de determinação de Perfil:

    Nas hipóteses em que uma linha não deverá mais ser utilizada, a mesma deverá ser desativada. Isto é, indisponibilizada para a utilização.

     

    No momento em que é feito a requisição da chamada, o TaaS faz a validação se a linha está ativa ou não. Em caso da linha estar desativada o TaaS não utiliza a linha no momento da determinação de perfil.

     

    Para fazer a desativação da linha, basta assinalar a flag ao lado do menu de funcionalidades e clicar no botão .

     

     

    Após a flag, é solicitado a confirmação da ação e após confirmado, a linha é desativada:

     

     

     

    Para reverter a ação, basta assinalar a mesma flag e clicar no botão .

     

     

    Após a flag, é solicitado a confirmação da ação e após confirmado, a linha é reativada:

     

     

     

    • Exportação dos registros:

    Para a exportação dos registros em arquivo CSV, basta o usuário clicar na no ícone na tela da determinação de perfil:

     

     

     

     

    Para abrir o arquivo sem perder as configurações, descompactar o arquivo e abrir em formato TXT:

     

     

    Com essa rotina, os clientes que utilizam o TaaS, assim como as equipes internas responsáveis ganham em otimização do tempo além, assim como a facilitação do processo de determinação de perfil junto ao cliente.

     


     

    Determination of TaaS Profile
    By Fernanda Almeida

    In order to make the process of profile determination easier and less bureaucratic, we implemented on the Cockpit the profile determination screen, where the user can add, edit or deactivate the profile determination without the need of intervention by the IT Support team.

    Besides that, those actions are reflected immediately on TaaS.

    The profile determination is a converter that transforms the SAP request into a request that's identified by the Systax Engine.

    The TaaS flow is as following:

    • TaaS Request format:

    The profile determination uses information from the SAP request and determines which operation the Systax Engine will have to request according to the determined parameters:

     

     

     

    The parameters from the sender request and the receiver request result in the consequences that are the scenario profiles recognized by the Systax systems.

     

    The profile determination is available on the Cockpit.

     

    • Profile determination on the cockpit:

    The routine is available on the Cockpit:

    • Documentos (Documents)
      • Determinação de Perfil (Profile Determination)

     

     

     

    On the screen, we have the "filter" and "upload" menus.

    On the "filter" menu, we have filters by the request elements:

     

     

    From/To of element nomenclature:

     

    Element nomenclature - Cockpit

    Element nomenclature - TaaS

    Element fillment

    Código

    ID

    Sequential ID number

    Venda ou Compra

    saleOrPurchase

    S or P

    Natura de Operação

    operationNatureCode

    Standard SAP or defined by client

    Tipo de mercadoria

    Item Type

    M

    Origem do Produto

    Material Origin

    0 to 8

    Produção Própria

    ownProduction

    Y or N or null

    Finalidade

    Usage

    I - Industrialization
    R - Resell
    C - Consumption
    A -Active

    Uso do Produto

    Usage Purpose

    Standard SAP or defined by client

    Transação Comercial

    Business Transaction

    Standard SAP or defined by client

    Origem -  País

    Ship_From_Country

    Country acronym

    Origem -  UF

    Ship_From_UF

    UF acronym

    Destino -  UF

    Ship_To_UF

    UF acronym

    Origem - CNAE

    Ship_From_Cnae

    First 2 or 4 digits of CNAE or null

    Origem - CNPJ

    Ship_From_CNPJ

    Sender CNPJ or null

    Origem - IE

    Ship_From_IE

    4 digits from the sender's IE or null

    Origem - Código IBGE

    Ship_From_IBGECode

    City code or null

    Origem - Natureza Legal

    Ship_From_legalNature

    Legal nature code or null

    Origem - Suframa

    Ship_From_Suframa

    Y or N or null

    Origem - Contribuinte do ICMS

    Ship_From_ICMSContributor

    Y or N or null

    Origem - Contribuinte do ICMS ST

    Ship_From_ICMSSTContributor

    Y or N or null

    Origem - Contribuinte IPI

    Ship_From_IPIContributor

    Y or N or null

    Origem - Tipo de Declaração Fiscal

    Ship_From_Tax_declarationType

    Real Profit,
    Presumed Profit or null

    Origem - Código do Regime Tributário

    Ship_From_taxRegimenCode

    1 – Simples Nacional

    2 – Simples Nacional with excess invoice

    3 – RPA

    Destinatário - CNAE

    Ship_To_Cnae

    First 2 or 4 digits of CNAE or null

    Destinatário - CNPJ

    Ship_To_CNPJ

     Receiver's CNPJ or null

    Destinatário - Natureza Legal

    Ship_To_legalNature

     Legal nature code or null

    Destinatário - SUFRAMA

    Ship_To_SUFRAMA

    Y or N or null

    Destinatário - Código IBGE

    Ship_To_IBGECode

     City code or null

    Destinatário - Contribuinte ICMS

    Ship_To_ICMSContributor

    Y or N or null

    Destinatário - Contribuinte ICMS ST

    Ship_To_ICMSSTContributor

    Y or N or null

    Destinatário - Contribuinte IPI

    Ship_To_IPIContributor

    Y or N or null

    Destinatário - Contribuinte ISS

    Ship_To_ISSContributor

    Y or N or null

    Destinatário - Tipo de Declaração Fiscal

    Ship_To_TaxDeclarationType

    Real Profit,
    Presumed Profit

    Destinatário - Código do Regime Tributário

    Ship_To_TaxRegimenCode

    1 – Simples Nacional

    2 – Simples Nacional with excess invoice

    3 – RPA

    ou null

    Systax - Natureza de Operação

    Natureza de Operação

    Operation nature or null

    Systax - Finalidade

    Finalidade

    Scenario goal

    Systax - Ex-Origem

    Perfil Remetente

    Origin profile

    Systax - Ex-Destinação

    Perfil Destinatário

    Destination profile

    Systax - Tipo Entrada/Saída

    Entrada/Saída

    0 – Entry

    1 – Exit

    Genérico do Cabeçalho

     

     

     

    Element definition:

     

    • The profile determinations must be aligned and in accordance with the client, given that the information received on the payload is provided by the masterdata filled by the client, that being the client registration and SAP providers.
    • If there's more than one information to an element, the different information must be separated by commas (",").
    • In case of the Ship_to_SUFRAMA element, on the TaaS request a subscription number is sent, but the element validation is filled with Yes or No or null.
    • Each profile determination inserted in the Cockpit automatically records the bank key of te logged client.
    • The ID order is sequential, so the registry exclusion no longer exists. If a line is no longer utilized, it must be deactivated. The TaaS validates on the table if the line is active and uses it for the calculation. If the line is deactivated, the TaaS won't consider it.

     

    Application Rules:

    1 - All elements received on the request must be filtered with "received value" and "null";

    2 - If an conditional element isn't received on the request, filter is as "null";

    3 - If more than 1 line is found, the one with more conditions filled prevails;

    4 - When sending information: "Ship_From // taxDeclarationType = presumed profit" on the request, the profile ID 134 must be included on the "perfil_rem" element, alongside the other origin profiles for conversion of Pis and Cofins tax rates to presumed profit (0,65% and 3% tax rates).

     

    On the “upload” menu, we have the possibility of uploading profile determinations by CSV file:

     

     

    To upload the profile determination, simply download the model file and include the conditions and consequences:

     

     

    If the file has any line breaks, spaces or special characters, the system will skip that registry and proceed with the following lines.

     

    When uploading, the profile determination must be informed, them being: homologation or production.

     

    • Functions of the registry line:

    On the registry line, there are the following options:

     

     

    •  - Line History – records a log of previous versions when the line is edited
    •  - Line Details – shows the information in vertical format
    •  - Copy line – creates a new registry from the existing line
    •  - Line Edit – changes information of an existing registry
    •  - Line status traffic light (green – active // red– disabled)

     

    Line history – shows the edit history the line was submitted to:

     

    Line Detail – shows the conditions and consequences of the registry:

     

       

     

       

     

    Line Copy – creates a new edited registry from an existing line:

     

    Line Edit – allows the editing of an existing line:

     

    • Disabling the profile determination lines:

    On the cases in which a line shouldn't be used anymore, it must be disabled. That is, not available for utilization.

     

    The moment in which the request is made, the TaaS does the validation to see if the line is active or not. If it is disabled, the TaaS won't use it on the profile determination.

     

    To disable a line, simply mark the flag beside the function menu, and click the "Deactivate" button .

     

     

    After the flag, a confirmation message shows up and, after confirmation, the line is disabled:

     

     

     

    To reverse this action, simply mark the same flag, and click the "Activate" button .

     

     

    After the flag, a confirmation message shows up and, after confirmation, the line is reactivated:

     

     

     

    • Registry export:

    To export the registries on a CSV file, simply click the  button on screen:

     

     

     

     

    To open the file without losing its configuration, decompress the file and open it on the TXT format:

     

     

    With these routines, clients that utilize the TaaS, as well as internal teams responsible, get the optimization of their time, as well as making the process of determining profiles alongside clients easier.

    Voltar


Versão do documento: 59 Publicação: 4/19/2024