Histórico da Página
Índice
01. VISÃO GERAL
A classe TCAdditionalData (Tax Configurator Additional Data) foi desenvolvida para viabilizar o acesso aos dados adicionais que vão estar vinculados a rotinas do Configurador de Tributos (FISA170).
...
Para entender como inserir/manipular esses dados adicionais nas suas devidas rotinas dentro do Protheus, siga a seguinte documentação: https://tdn.totvs.com.br/pages/viewpage.action?pageId=945397604
02. COMO USAR
A Classe TCAdditionalData possibilita obter os Dados Adicionais, tanto em documentos em processamento (Matxfis em tempo de execução), quanto para documentos persistidos em banco de dados. Sendo assim, para o funcionamento correto é imprescindível passar a classe qual o modo em que ela está sendo instanciada.
03. MÉTODOS
new()
Método construtor da classe TCAdditionalData.
| Bloco de código | ||||||
|---|---|---|---|---|---|---|
| ||||||
using totvs.protheus.backoffice.fiscal.additionalData Function Exemplo() Local oDados as Json oDados := TCAdditionalData():new() Return |
destroy()
O método destroy() encerra toda a operação da classe.
| Bloco de código | ||||||
|---|---|---|---|---|---|---|
| ||||||
using totvs.protheus.backoffice.fiscal.additionalData Function Exemplo() Local oDados as Json oDados := TCAdditionalData():new() oDados:destroy() Return |
setDataMode( mode : String )
O Método setDataMode() serve para informar a classe em qual contexto ela está sendo instanciada. Ele sempre deve receber uma string com uma das opções abaixo:
...
| Bloco de código | ||||||
|---|---|---|---|---|---|---|
| ||||||
using totvs.protheus.backoffice.fiscal.additionalData
Function Exemplo()
Local oDados as Json
oDados := TCAdditionalData():new()
oDados:setDataMode('PROCESSING') // 'WRITTEN' ou 'PROCESSING'
Return |
setId( aIds : Array )
O Método setId() serve para informar para a classe os IDs (F2D_IDREL ou D1_IDTRIB/D2_TRIB) dos tributos dos documentos fiscais que já foram persistidos no banco de dados, então deve ser utilizada sempre com setDataMode() no modo WRITTEN.
| Bloco de código | ||||||
|---|---|---|---|---|---|---|
| ||||||
using totvs.protheus.backoffice.fiscal.additionalData
Function Exemplo()
Local oDados as Json
Local aIDs := {}
aIDs := {"8CF162BB6ABF5415-F73A1642-4011-BE59A261-D8CB8AD280E5005056ACF625"} // D1_IDTRIB = F2D_IDREL ou D2_IDTRIB = F2D_IDREL
oDados := TCAdditionalData():new()
oDados:setDataMode('WRITTEN') // Os documentos já foram persistidos no banco de dados
oDados:SetId(aIDs) // Informa os IDs do tributo que deseja consultar
Return |
getAdditionalData()
O Método getAdditionalData() serve para receber os dados adicionais de acordo com o que foi informado nos métodos setDataMode e setId (Para dados já persistidos).
| Bloco de código | ||||||
|---|---|---|---|---|---|---|
| ||||||
using totvs.protheus.backoffice.fiscal.additionalData
Function Exemplo()
Local oDados as Json oDados := TCAdditionalData():new()
Local cResponse := ""
aIDs := {"8CF162BB6ABF5415-F73A1642-4011-BE59A261-D8CB8AD280E5005056ACF625"} // D1_IDTRIB = F2D_IDREL ou D2_IDTRIB = F2D_IDREL
oDados:setDataMode('WRITTEN') // Os documentos já foram persistidos no banco de dados
oDados:SetId(aIDs) // Informa os IDs do tributo que deseja consultar
cResponse := oDados:getAdditionalData() // Recebe os dados adicionais do tributo
Return |
Exemplo de retorno getAdditionalData()
*Até o momento de publicação dessa documentação, apenas os dados adicionais referentes a regra escrituração estão sendo retornados, pois os dados adicionais do Perfil de Operação e Regra de Cálculo estão em desenvolvimento.
| Bloco de código | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"8CF162BB6ABF5415-F73A1642-4011-BE59A261-D8CB8AD280E5005056ACF625":{
"TG_001RGCOF1":{
"regra escrituracao":{
"id":"e118b1673269a74f-a462077a-0bb0e782-1a119775-08991d2ff2c2d7806aa371c7",
"dados adicionais":{
"AGCREDPRESMOTDESICMS":{
"conteudo":"13"
}
}
},
"perfil de operacao":{
"id":"000030",
"dados adicionais":{
"BASEIPICALICMSSTNFSA":{
"conteudo":"O1"
},
"ENQIPICODEINDNATFRET":{
"conteudo":"1130"
},
"TRIBPREFREGIMESPEC":{
"conteudo":"991"
}
}
},
"perfilregra de operacaocalculo":{
"id":"200003d88f0d0c-8d5e-4f86-d181-7514b99b1ff2",
"dados adicionais":{}
"CCREDPRES":{
"conteudo":"10"
},
"regra de calculo "CONDSUSPRE":{
"idconteudo":"ff583f18-d972-1646-4985-f2b19e03e586",S"
"dados adicionais":{ }
}
}
}
}
} |
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas