Skip to Content

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:

 

Em caso de dúvidas, entrem em contato.

 

Abraços,

Ailane Kuhn

Time de desenvolvimento do TDF

 

To report this post you need to login first.

3 Comments

You must be Logged on to comment or reply to a post.

  1. César Augusto Scheck

    Oi Ailane,

    Obrigado pela atitude de compartilhar! 

    Estou gostando de trabalhar com o TDF, mas ainda confuso em relação a algumas peculiaridades do framework.

    Umas dela é sobre no TOM. Tenho a seguinte situação: após a geração de um Draft Run, o /TMF/PCO sugere a abertura do TOM. Na aba ‘Details’ consigo ver dados gerais da ultima execução e até baixar o arquivo. No entanto, na aba ‘Reports’ o contador do EFD Contribuições está sempre zerado. Na aba ‘Summary’ o grid está sempre vazio.

    Há alguma implementação de código que deva ser feita para que essa visualização seja possível no TOM? Para que os dados de detail fossem exibidos nenhuma linha foi implementada; penso então que pudesse ser alguma configuração ausente.

    Procurei por notas para o SP10 mas nenhuma tratava sobre isso.

    Meu contexto de execução: Geração de SPED EFD PCO no TDF SP09 integrado com SAP ECC.

    Grato,

    P.S.: A qualidade do código está excelente. Parabéns ao time!

    (1) 
    1. Jonas Guimaraes

      Bom dia César,

      Na aba de “Reports”, os campos “Initial Date” e “Final Date” correspondem às datas do período que o relatório foi rodado.

      Normalmente, quando entra nessa aba, os campos são preenchidos com os dados do Ano e Mês atual. Então é necessário alterar as datas, de forma que sejam correspondentes com o período executado (e não com a data da execução).

      Por exemplo, se você executou o PCO para o Mês 06 de 2017, na aba de ‘Reports’ a sua execução deverá aparecer quando alterar as datas para Jun 1, 2017 e Jun 30, 2017. (Sugiro utilizar o “match code” ao invés de digitar a data).

      Ao clicar então no Report desejado, ele navega automaticamente para a aba “Summary”. Nesta aba, é possível criar filtros, ou trocar a ordenação do relatórios clicando no título das colunas.

      Veja se alterando as datas conforme mencionado acima o problema é resolvido.

       

      Um Abraço,

      Jonas Guimarães

      Time de desenvolvimento do TDF

       

      (2) 
      1. César Augusto Scheck

        Oi Jonas,

        Sensacional! Tua dica foi certeira. O mais importante aqui foi diferenciar data de apuração de data de geração da apuração, que no meu caso era respectivamente Janeiro de 2016 e Julho de 2017.

        Muito obrigado!

        Um abraço,

        César Scheck

        (2) 

Leave a Reply