Integração com SAP

A ForSign tem um kit de integração para SAP que envia documentos do S/4HANA, do ECC ou do SuccessFactors para assinatura e devolve o PDF assinado ao SAP. O kit roda no SAP Integration Suite (Cloud Integration) e usa a mesma API e os mesmos webhooks de qualquer integração ForSign.

Quando usar

• Contratos de compra e venda e aditivos gerados no S/4HANA ou no ECC.
• Documentos de RH, como contrato de trabalho e admissão digital no SuccessFactors.
• Qualquer documento que nasce no SAP e precisa voltar assinado para o mesmo registro.

O que vem no kit

Segundo a documentação do kit:

• Fluxos de integração (iFlows) para criar a operação, consultar a situação, baixar o documento assinado e receber o webhook.
• Cliente ABAP para ECC 7.40 ou mais novo e S/4HANA, instalável pelo abapGit, com um programa de demonstração.
• App Fiori para acompanhar as operações e baixar o PDF no Launchpad.
• Coleção Postman e especificação do contrato para testar.

Como o fluxo funciona

1. O SAP chama o iFlow com um pedido simplificado: o PDF, os participantes e um externalId, como o número do pedido ou do colaborador.
2. O iFlow sobe o PDF e cria a operação na ForSign. Ele devolve ao SAP o id da operação e os links de assinatura.
3. Os participantes assinam pelo link da ForSign.
4. Quando o PDF final fica pronto, a ForSign envia o webhook Documento Pronto para Download ao iFlow. O iFlow confere a assinatura do webhook e avisa o SAP com o externalId.
5. O SAP baixa o PDF assinado e guarda no registro de origem.

O que o seu time SAP precisa

• SAP Integration Suite (Cloud Integration) contratado.
• A chave de API da empresa na ForSign. Veja Onde pegar a chave de API.
• Um webhook do tipo Documento Pronto para Download apontando para o iFlow receptor. Veja Configurar um webhook.
• No Integration Suite, a chave e o secret do webhook cadastrados como parâmetros seguros.

O guia de instalação passo a passo está na seção Integrações de docs.forsign.digital.

Limites e detalhes

• O kit usa só recursos que a API já oferece. Tudo o que vale para a API vale para o kit, inclusive o envio só de PDF.
• Use o externalId com a opção de juntar com a operação existente para não criar operação repetida quando o SAP reenviar o pedido.
• O kit não consome crédito. As operações criadas por ele consomem como qualquer operação.

Perguntas comuns

Preciso de ajuda da ForSign para instalar? O kit foi feito para o time SAP instalar sozinho. Se travar, fale com o suporte pelo [email protected].

Funciona sem o Integration Suite? O caminho documentado passa pelo Integration Suite. Sem ele, o seu sistema pode chamar a API da ForSign direto. Veja Primeiros passos com a API v2.

O documento assinado volta para o SAP sozinho? Volta. O webhook avisa o SAP, e o SAP baixa o PDF e guarda no registro de origem.