A migração de dados geralmente envolve coletar dados em um repositório/arquivos e carregá-los no sistema SAP de uma só vez.
Não tenho certeza se é isso que você está se referindo. Se for, a SAP fornece o cockpit de migração de dados Hana, onde você pode carregar arquivos e migrar os dados para o SAP. Se houver erros nos dados, o passo de validação irá indicar e você poderá voltar à fonte e produzir um arquivo melhor.
Os IDOCs são mensagens (cada uma contendo 1 objeto) destinadas à comunicação automatizada (quase) em tempo real entre sistemas. Os IDOCs passam por uma interface que é parte da infraestrutura que geralmente é executada por muitos anos.
Em conclusão, para a migração de dados, não usaria nem IDOCs nem APIs.