Guia de Integração SAP - Do Zero ao IDoc

1

A Origem (Payload JSON)

Tudo começa no sistema externo (Site, CRM, App). Hoje em dia, o mundo fala JSON via API REST.

    {
      "cliente": "Empresa X",
      "cnpj": "12.345.678/0001-90",
      "email": "contato@x.com"
    }
                        

2

O Tradutor (Middleware)

O dado sai da origem e chega no Middleware SAP. Aqui temos dois caminhos possíveis, dependendo da tecnologia da sua empresa:

🚀 CPI (Nuvem / Moderno)

Cloud Platform Integration.
Mantém a agilidade. Ele recebe o JSON e continua trafegando JSON. A conversão é mínima e mapeada diretamente para a API do SAP.

🏢 PI/PO (On-Premise / Legado)

Process Orchestration.
Sistema mais antigo. Ele pega o JSON e obrigatoriamente converte para XML (IDoc clássico) para conseguir falar com o SAP ECC.

3

A Entrega (JSON vs XML)

Veja a diferença do que chega tecnicamente no SAP. O conteúdo é o mesmo (mapeado), mas o formato muda drasticamente.

Via CPI (JSON Mapeado)

    {
      "NAME1": "Empresa X",        // Mapeado de 'cliente'
      "STCD1": "12345678000190",   // Limpo (sem pontos)
      "SMTP_ADDR": "contato@x.com"
    }
                            

Via PI/PO (XML IDoc)

    <E1KNA1M>
      <NAME1>Empresa X</NAME1>
      <STCD1>12345678000190</STCD1>
      <SMTP_ADDR>contato@x.com</SMTP_ADDR>
    </E1KNA1M>
                            

4

Processamento no SAP

O SAP recebe o pacote. Se for XML, entra via porta IDoc (WE02). Se for JSON (CPI), entra via Proxy ou API OData.

Independente do formato, se o dado estiver "sujo" (ex: CEP errado), o SAP rejeita e gera erro.

💡 Dica: É por isso que você deve consultar nosso Glossário para entender o que cada campo técnico (NAME1, STCD1) espera.

🚀

O Atalho Inteligente (4MDG)

Cansado de configurar De-Para no CPI ou mapear XML no PI?

A plataforma 4MDG entrega o dado pronto, validado e saneado. Você não precisa se preocupar se é JSON ou XML, nós garantimos que o SAP vai aceitar de primeira.

Conhecer a Automação 4MDG

Como funciona a Integração SAP?