# TaaS - Recursos e Funcionalidades # Introdução Este documento tem por objetivo explicar a forma de funcionamento da solução Systax TaaS, bem como exemplifica a forma de de-para dos dados utilizados na integração SAP-S4/HANA e Motor de Cálculos Systax. # Informações Gerais # Sobre a ferramenta. TaaS - significa TAX AS A SERVICE e é a solução da Systax de integração do Systax Tax Engine para que os cálculos dos tributos sejam feitos em um serviço externo ao SAP. O Taas recebe a chamada em formato oficial estabelecido pela SAP, converte no formato do Systax Tax Engine, que faz o cálculo e responde ao TaaS, que traduz também o resultado na linguagem SAP e retorna para o ERP. A imagem abaixo elucida, de forma macro, o workflow da solução: ![](https://documentacao.systax.com.br/upload/20230522-16055026-1299391233-243-image-20230522134754-1.png) Sempre que solicitado um cálculo tributário: 1\) os dados dos envolvidos (ex.: fornecedor e comprador), da operação (ex.: compra para uso e consumo) e do produto ou serviço serão extraídos do SAP, convertidos e enviados ao TaaS; 2\) o TaaS enviará a requisição de cálculo ao Tax Engine (Motor de Cálculo Systax); 3\) o Tax Engine buscará uma regra no Cockpit ou no banco de regras integrado ao ERP que atenda os parâmetros da solicitação e utilizará os dados da regra encontrada como insumo para produzir o cálculo tributário e responder ao TaaS. Obs.: caso não seja encontrada regra aderente a chamada, o Tax Engine acionará o recurso On Demand para que este produza uma regra on line apenas para responder a esta requisição. 4\) o Tax Engine responderá ao TaaS, entregando o resultado do cálculo solicitado. 5\) o TaaS responderá e entregará o resultado do cálculo ao SAP. # Configurações, URL e autenticação # Dados para acesso Para utilizar o serviço de cálculo externo direto do SAP, siga este procedimento: 1. Crie um destino HTTP para Partner Service Framework. Para criar o destino HTTP, você deve fornecer dados que obtém da SAP e da Systax. Veja abaixo quais são esses dados: **Dados determinados pela SAP** No campo *Name*, use o nome de destino do serviço de parceiro que você obtém ao enviar um HTTP GET. Esta solicitação deve ser para a URL: https://<TaxConfigurationURL>/AvailableConfiguration.svc/ Destinations(‘<countryISO>’) **Dados determinados pela Systax**
**Campo** **Dado**
*Type* Escolher ***HTTP***
*URL* [http://wscockpit.systax.com.br/TaaSPD/api/tax/calculation](http://wscockpit.systax.com.br/TaaSPD/api/tax/calculation)
*Proxy Type* Escolher ***Internet***
*Authentication* Utilizar usuário e senha fornecidos pela Systax
2. Configure o Partner Service Framework # Exemplo de chamada e resposta TaaS # Exemplo de payload
De acordo com a transação realizada (exemplo: compra, venda, transferência, etc.) e os dados mestres do cadastro de fornecedor, planta recebedora ou vendedora, filiais e dados mestres de materiais será feita a conversão para que o Motor Systax entenda para qual produto e operação está sendo requisitado o cálculo. Abaixo exemplo de requisição e retorno onde os dados definem uma operação de compra de um varejista, para revenda, de SP para SP, de um fornecedor industrial que produziu a mercadoria. **Cenário Systax: SP-SP-120-1-140–569 Compra para revenda\_Indústria\_Varejo** Na chamada exemplo abaixo:
- A operação de compra é identificada pelos campos “operationNatureCode” e “saleorPurchase” igual a “P”; - Para determinar a UFs (SP-SP)– consideramos os campos “state” do Ship From e Ship To, do bloco “Locations”; - Para determinar a operação e perfil do fornecedor/remetente (120-Venda de Produção do Estabelecimento e 1-Indústria) – consideramos os campos “materialOrigin” e “cnae” do Ship From. - Para determinar o perfil do destinatário (140-Varejista) – consideramos o campo “cnae” do Ship To.
**Chamada** **Retorno**
{ "id": "02E7B3F979971EED93E6ACEAC7A51EB9", "date": "2022-10-18T19:37:10.000Z", "companyId": "1410", "saleorPurchase": "P", "operationNatureCode": "P", "grossOrNet": "g", "currency": "BRL", "Items": \[ { "id": "000010", "itemCode": "TBD", "itemType": "M", "quantity": "1.000", "unitPrice": "50.2000", "itemClassifications": \[ { "itemStandardClassificationSystemCode": "cest", "itemStandardClassificationCode": "" }, { "itemStandardClassificationSystemCode": "ncm", "itemStandardClassificationCode": "12060010" } \], "additionalItemInformation": \[ { "type": "materialOrigin", "information": "0" }, { "type": "usage", "information": "R" } \] } \], "Locations": \[ { "type": "SHIP\_FROM", "addressLine1": "Rua Pamplona 145, 11 andar", "zipCode": "01405000", "city": "São Paulo", "state": "SP", "country": "BR" }, { "type": "SHIP\_TO", "addressLine1": "Av. Ipanema 165", "zipCode": "03015000", "city": "São Paulo", "state": "SP", "country": "BR" } \], "Party": \[ { "id": "1", "role": "SHIP\_FROM", "taxRegistration": \[ { "locationType": "SHIP\_FROM", "taxNumber": "112240", "taxNumberTypeCode": "CNAE" }, { "locationType": "SHIP\_FROM", "taxNumber": "0000000000100", "taxNumberTypeCode": "CNPJ" }, { "locationType": "SHIP\_FROM", "taxNumber": "Y", "taxNumberTypeCode": "COFINSContributor" }, { "locationType": "SHIP\_FROM", "taxNumber": "3304557", "taxNumberTypeCode": "IBGECode" }, { "locationType": "SHIP\_FROM", "taxNumber": "Y", "taxNumberTypeCode": "ICMSContributor" }, { "locationType": "SHIP\_FROM", "taxNumber": "Y", "taxNumberTypeCode": "ICMSSTContributor" }, { "locationType": "SHIP\_FROM", "taxNumber": "Y", "taxNumberTypeCode": "IPIContributor" }, { "locationType": "SHIP\_FROM", "taxNumber": "N", "taxNumberTypeCode": "ISSContributor" }, { "locationType": "SHIP\_FROM", "taxNumber": "Presumed Profit", "taxNumberTypeCode": "taxDeclarationType" }, { "locationType": "SHIP\_FROM", "taxNumber": "Y", "taxNumberTypeCode": "PISContributor" }, { "locationType": "SHIP\_FROM", "taxNumber": "", "taxNumberTypeCode": "taxRegimenCode" } \] }, { "id": "2", "role": "SHIP\_TO", "taxRegistration": \[ { "locationType": "SHIP\_TO", "taxNumber": "4711302", "taxNumberTypeCode": "CNAE" }, { "locationType": "SHIP\_TO", "taxNumber": "74544297000192", "taxNumberTypeCode": "CNPJ" }, { "locationType": "SHIP\_TO", "taxNumber": "Y", "taxNumberTypeCode": "COFINSContributor" }, { "locationType": "SHIP\_TO", "taxNumber": "3304557", "taxNumberTypeCode": "IBGECode" }, { "locationType": "SHIP\_TO", "taxNumber": "Y", "taxNumberTypeCode": "ICMSContributor" }, { "locationType": "SHIP\_TO", "taxNumber": "Y", "taxNumberTypeCode": "ICMSSTContributor" }, { "locationType": "SHIP\_TO", "taxNumber": "956224310481", "taxNumberTypeCode": "IE" }, { "locationType": "SHIP\_TO", "taxNumber": "N", "taxNumberTypeCode": "IPIContributor" }, { "locationType": "SHIP\_TO", "taxNumber": "Y", "taxNumberTypeCode": "ISSContributor" }, { "locationType": "SHIP\_TO", "taxNumber": "2062", "taxNumberTypeCode": "legalNature" }, { "locationType": "SHIP\_TO", "taxNumber": "Y", "taxNumberTypeCode": "PISContributor" }, { "locationType": "SHIP\_TO", "taxNumber": "Real Profit", "taxNumberTypeCode": "taxDeclarationType" } \] } \] } { "total": "50.200000000000", "subTotal": "50.200000000000", "totalTax": "50.200000000000", "taxLines": \[ { "id": "000010", "totalTax": "15.511800000000", "taxcode": "1102", "taxValues": \[ { "rate": "0.0000", "taxable": "0.000000000000", "name": "Imposto sobre Produtos Industrializados", "value": "0.000000000000", "exemptedBasePercent": "0.0000", "exemptedBaseAmount": "50.200000000000", "otherBaseAmount": "0.000000000000", "taxTypeCode": "IPI", "taxAttributes": \[ { "attributeType": "CENQ", "attributeValue": "999" }, { "attributeType": "CST", "attributeValue": "03" }, { "attributeType": "legalProvision1", "attributeValue": "Art. 226 do RIPI/2010" }, { "attributeType": "legalPCode1", "attributeValue": "210059" } \] }, { "rate": "18.0000", "taxable": "50.200000000000", "name": "Imposto sobre Comercialização de Mercadorias e Serviços", "value": "9.036000000000", "exemptedBasePercent": "0.0000", "exemptedBaseAmount": "0.000000000000", "otherBaseAmount": "0.000000000000", "taxTypeCode": "ICMS", "taxAttributes": \[ { "attributeType": "CST", "attributeValue": "00" }, { "attributeType": "baseDetermination", "attributeValue": "3" } \] }, { "rate": "1.6500", "taxable": "50.200000000000", "name": "Programa de Integração Social", "value": "0.828300000000", "exemptedBasePercent": "0.0000", "exemptedBaseAmount": "0.000000000000", "otherBaseAmount": "0.000000000000", "taxTypeCode": "PIS", "taxAttributes": \[ { "attributeType": "CST", "attributeValue": "50" } \] }, { "rate": "0.6500", "taxable": "50.200000000000", "name": "PIS from supplier", "value": "0.326300000000", "exemptedBasePercent": "0.0000", "exemptedBaseAmount": "0.000000000000", "otherBaseAmount": "0.000000000000", "taxTypeCode": "PIS-SUP", "taxAttributes": \[ { "attributeType": "CST", "attributeValue": "01" } \] }, { "rate": "7.6000", "taxable": "50.200000000000", "name": "Contribuição para o Financiamento da Seguridade Social", "value": "3.815200000000", "exemptedBasePercent": "0.0000", "exemptedBaseAmount": "0.000000000000", "otherBaseAmount": "0.000000000000", "taxTypeCode": "COFINS", "taxAttributes": \[ { "attributeType": "CST", "attributeValue": "50" } \] }, { "rate": "3.0000", "taxable": "50.200000000000", "name": "COFINS from supplier", "value": "1.506000000000", "exemptedBasePercent": "0.0000", "exemptedBaseAmount": "0.000000000000", "otherBaseAmount": "0.000000000000", "taxTypeCode": "COFINS-SUP", "taxAttributes": \[ { "attributeType": "CST", "attributeValue": "01" } \] } \] } \], "date": "2023-05-19T18:02:59.26442-03:00", "genericInfo": "busca=NCMD|codProd=NCM\_12060010-0|orig=1|CFOP\_ENTRADA=1102|UFO=sp|UFD=sp|natOp=120| perfilorig=1|perfildest=140|finalidade=569 |versao=6.07|", "partnerName": "Systax versao=6.07" }
---
# Detalhamento do campos # Detalhamentos dos novos blocos da reforma O objetivo deste documento é apresentar os novos tipos de atributos criados especificamente para contemplar as demandas da Reforma Tributária, detalhando sua descrição.
**IBSUF**
**“attributeType”** **Descrição**
“CST” Código de Situação Tributária do IBS e CBS
“cClassTrib” Código de Classificação Tributária do IBS e CBS
“deferralPercentage” Percentual do diferimento
“deferralAmount” Valor do Diferimento
“reductionPercentage” Percentual da redução de alíquota
“taxRefundAmoun” Valor do tributo devolvido
“govEntityType” Tipo de ente governamental
“govReductPercentage” Percentual de redução de alíquota em compra governamental
“regularCST” Código de Situação Tributária do IBS e CBS.
“regularcClassTrib” Código de Classificação Tributária do IBS e CBS
“regularRate” Valor da alíquota do IBSUF sem as condições especiais
“regularAmount” Valor do Tributo do IBSUF sem as condições especiais
“presumedCreditCode” Código de Classificação do Crédito Presumido
“presumedCreditPercentage” Percentual do Crédito Presumido
“presumedCreditAmount” Valor do Crédito Presumido
“presumedCreditSuspendedAmount” Valor do Crédito Presumido em condição suspensiva
“govPurRate” Alíquota do IBS de competência do Estado
“govPurAmount” Valor do Tributo do IBS da UF calculado
**IBSMUN**
**“attributeType”** **Descrição**
“CST” Código de Situação Tributária do IBS e CBS
“cClassTrib” Código de Classificação Tributária do IBS e CBS
“deferralPercentage” Percentual do diferimento
“deferralAmount” Valor do Diferimento
“reductionPercentage” Percentual da redução de alíquota
“taxRefundAmoun” Valor do tributo devolvido
“govEntityType” Tipo de ente governamental
“govReductPercentage” Percentual de redução de alíquota em compra governamental
“regularCST” Código de Situação Tributária do IBS e CBS.
“regularcClassTrib” Código de Classificação Tributária do IBS e CBS
“regularRate” Valor da alíquota do IBSUF sem as condições especiais
“regularAmount” Valor do Tributo do IBSUF sem as condições especiais
“presumedCreditCode” Código de Classificação do Crédito Presumido
“presumedCreditPercentage” Percentual do Crédito Presumido
“presumedCreditAmount” Valor do Crédito Presumido
“presumedCreditSuspendedAmount” Valor do Crédito Presumido em condição suspensiva
“govPurRate” Alíquota do IBS de competência do Município
“govPurAmount” Valor do Tributo do IBS do Município calculado
**CBS**
**“attributeType”** **Descrição**
“CST” Código de Situação Tributária do IBS e CBS
“cClassTrib” Código de Classificação Tributária do IBS e CBS
“deferralPercentage” Percentual do diferimento
“deferralAmount” Valor do Diferimento
“reductionPercentage” Percentual da redução de alíquota
“taxRefundAmoun” Valor do tributo devolvido
“govEntityType” Tipo de ente governamental
“govReductPercentage” Percentual de redução de alíquota em compra governamental
“regularCST” Código de Situação Tributária do IBS e CBS.
“regularcClassTrib” Código de Classificação Tributária do IBS e CBS
“regularRate” Valor da alíquota do CBS sem as condições especiais
“regularAmount” Valor do Tributo do CBS sem as condições especiais
“presumedCreditCode” Código de Classificação do Crédito Presumido
“presumedCreditPercentage” Percentual do Crédito Presumido
“presumedCreditAmount” Valor do Crédito Presumido
“presumedCreditSuspendedAmount” Valor do Crédito Presumido em condição suspensiva
“govPurRate” Alíquota da CBS
“govPurAmount” Valor do Tributo da CBS calculado