Envio de PDF via DRC – Análise – Parte 1

No dia 24 de janeiro de 2025 saiu a SAP Note 3532295 comunicando sobre a disponibilidade de envio de PDF pelo DRC NF-e Outbound. Recomendo o blog feito pelo time da SAP para mostrar a nova funcionalidade: Blog da SAP – PDF no DRC

No blog da SAP eles mostram um overview das funcionalidades e da implementação, mas eu resolvi dar uma olhada com mais detalhes pensando do ponto de vista do consultor que vai precisar implementar a funcionalidade.

Como funciona a solução?

1- Mapeamento dos dados do XML para a DANFE

Uma coisa muito interessante do mapeamento é que agora ele é 100% baseado no XML, então não está mais lendo os dados das tabelas e o jeito certo de fazer o PDF sair certo é enfiando todas as informações nas respectivas tags do bendito XML, não dá mais pra buscar textos que não estão no XML.

Abri o Adobe Livecycle Designer e dei uma olhada no mapping dos campos, ali na direita da imagem vocês podem ver o “data binding” que é a “amarração” entre o campo do formulário e os dados do XML:

Os campos de InfCpl e InfAdFisco tem um mapping um pouquinho diferente, o data binding está em branco:

Os dados vem de um código que busca os dados a partir de um nodo do XML:

Olhando aqui nas variáveis é possível escolher de onde saem os dados do XML e o Binding obviamente só pode usar dados do XML:

2- Preview do DANFE a partir de XML de Exemplo

Outra coisa interessante é que durante o desenvolvimento e ajustes do Form dentro do LiveCycle é possível usar o data preview do Adobe para botar um XML de exemplo e simular o resultado com dados de uma NFe real:

Aqui tem um exemplo com dados de uma NFe antiga minha, por exemplo dá pra notar que no form entregue os dados de data e hora da emissão estão formatados de maneira levemente estranha:

A grade dos dados de produto por exemplo também não é lá muito clara nos textos adicionais e tal, esses são pontos que eu recomendaria fazer um ajuste assim como remover as caixinhas do ISSQN caso não existe cenário de NFe conjugada:

Claro que esse data preview é para o desenvolvedor que vai criar/ajustar o form durante o projeto ou na manutenção, isso não é algo disponível para o consultor funcional ou para o usuário-final.

Dica: Antes de salvar um arquivo no Adobe recomendo deletar o arquivo de exemplo usado para testes de preview, se não o XML a ser salvo com os dados do formulário vai conter o nome do arquivo. Em geral isso não vai ser um problema, mas se você utilizar um arquivo de NFe que tem a chave no nome essa é uma informação que em geral não deve ser compartilhada.

3- Análise da solução em si

• A arquitetura em si é a mesma do envio de email pelo DRC, ou seja, junto com o e-mail com o XML o DRC no BTP irá disparar o envio do PDF montado com o form ADOBE. As limitações de customização do email são as mesmas de antes (domínio @sap.com e textos fixos no assunto e corpo).

• O formulário entregue pela SAP é um excelente acelerador para projetos, mas não é algo 100% pronto, precisa, além do logo, fazer ajustes no layout e adaptações para mostrar/excluir informações que são relevantes para o cenário da empresa.

• Além disso, para quem está migrando do GRC para o DRC e já tem formulário Smartform ou Adobe no ERP pronto então a troca para o DRC é uma mudança bem maior e que precisa ser avaliada e testada, com certeza vai ser um esforço menor adaptar o formato Smartform/Adobe que já está funcionando para ser enviado via SOST do que usar o modelo novo proposta pela SAP. Para quem vai implementar DRC do ZERO o modelo novo faz total sentido.

• O re-envio de emails é cobrado porque é uma ação extra e faz parte dos contadores de bilhetagem da solução da SAP, então re-envio do email e DANFE tem um custo de processamento.

• O botão de display PDF na J1BNFE ainda não mostra esse PDF do cloud, apenas PDF’s gerados via Novo Output Management com formulário Adobe então o PDF do DRC ainda não está disponível em todos os lugares no ERP, acho que isso deve ser ajustado em breve.

Publicando o desenvolvimento no BTP

1- Analisando e implementando a API

Aqui vou ter que dizer, na minha opinião, que esse parece ser um ponto fraco da solução até agora, a publicação e administração dos formulários precisa criar uma implementação da API num client de HTTP. Isso é meio várzea, mas imagino que faça parte de um MVP, penso eu que vai ser temporário e que a SAP no futuro vai entregar uma UI para administrar isso de uma maneira mais usual. Essa API do PDF não é do DRC especificamente, é uma API genérica da SAP reutilizada pelo DRC BR.

A API do PDF está no portal de APIs da SAP:

Para analisar a API eu peguei como exemplo o “SOAP UI” porque já tinha ele instalado no PC.

Baixei o arquivo de configuração da API e importei no SOAP UI:

Esse é o exemplo do payload no portal de API da SAP:

Não consegui tempo pra me aprofundar nesse assunto ainda e não cheguei no ponto ainda de testar o PDF com uma nota autorizada no DRC, isso vai ficar para outro blog no futuro.

Valeu Gurizada,

Renan Correa

Quer ficar ligado nas novidades de localização? Entra no grupo da S4CN no Telegram e segue a gente no canal do Youtube

Mais infos sobre a localização Brasil no ERP, direto da sap, vocês podem conferir no SAP community na tag de S/4HANA logistics for Brazil

Outros posts sobre Localização você pode conferir filtrando pela categoria NFE/CTE ou Localização BR Geral.