TDF: Nova funcionalidade da API do TOM

[AilaneKuhn]

Olá pessoal,

Está disponível uma nova funcionalidade da API do Tax Obligation Monitor, que torna possível transformar uma execução que era rascunho (Draft) em oficial (Official) através de um botão na tela de detalhes, conforme a imagem abaixo:

 



 

Após clicar no botão Promote Run, o status do relatório será alterado para Promoting. Neste momento, o sistema começará a mover o arquivo do filesystem para a tabela /TMF/D_FILE_CONT, criando também uma entrada na tabela /TMF/D_REP_FILE. Por fim, o status do relatório será alterado para Created.

Com essa funcionalidade, não será necessário fazer uma nova execução do relatório do SPED se um Draft já atender as suas necessidades.

Um ponto importante é que só é possível fazer essa promoção se ainda não existir uma rodada oficial para esse mesmo report key.

 

Abaixo você encontrará algumas informações técnicas sobre a nova funcionalidade:

Request

URI: https://<tdfhost>/sap/opu/odata/TMF/TOM_API_SRV/report_run({Run ID})

Operation Type: CRUD

HTTP Method: PUT

Request Parameters

Parameter	Required	Data Type	Description/Values	Parameter Type
run_id	Yes	String[32]	Run ID	oData Unique Key
run_type_text	Yes	String[30]	Promote as value.	oData Unique Key

Request Example

[PUT]https://<uri>/report_runs('5CF3FCDD605A1ED788EE33C4FE48FDBF') {

"run_id":"5CF3FCDD605A1ED788EE33C4FE48FDBF",

"run_type_text":"Promote"

}

Response

Response Status and Error Codes

Code	Reason	Description
204	Success	No content.
400	Error	Examples of possible error messages related to Tax Obligation Monitor API: ·         If the current report status is Promoting, you get the following message: “This report is already being promoted. Enter a different report key.” ·         If the report status is different from Created and the run type is different from Draft, you get the following message: “You can only promote report runs from Draft to Official.”
500	General Error	Payload containing an error message.

Response Payload Example

Nothing is returned.

 

Para mais informações sobre a API do TOM, acesse:

• o guia do desenvolvedor em: http://help.sap.com/tdf_br_10 > Additional Information > Developer’s Guide;


• o blog post que fala sobre a API do TOM Versão 2.0: https://blogs.sap.com/2016/08/12/tdf-tom-api-versao-20/.

 

Em caso de dúvidas, entrem em contato.

 

Abraços,

Ailane Kuhn

Time de desenvolvimento do TDF