Conector REST do SAP S/4HANA Cloud
Documentação da API
Seção intitulada “Documentação da API”A Trial Balance API (API_OPLACCTGDOCITEMCUBE_SRV) e a Journal Entry Item - Basic API (API_JOURNALENTRYITEMBASIC_SRV) do SAP S/4HANA Cloud, no SAP API Business Hub, documentam os endpoints OData usados por este conector, além do serviço SOAP de criação em massa de lançamentos contábeis, exposto por meio de um Communication Arrangement.
Como funciona a autenticação
Seção intitulada “Como funciona a autenticação”A conexão se autentica como um aplicativo usando credenciais de cliente OAuth2: o ID do cliente e o segredo de um Communication Arrangement são trocados por um token de acesso no endpoint de token OAuth2 do tenant. Não há login interativo.
Configuração
Seção intitulada “Configuração”| Campo | Tipo | Descrição |
|---|---|---|
| Nome | Texto | Nome de exibição desta conexão. |
| Host | Texto | O host do seu tenant do S/4HANA Cloud, por exemplo https://yourorg.s4hana.ondemand.com. |
| URL do token | Texto | O endpoint de token OAuth2 do Communication Arrangement. |
| ID do cliente | Texto | O ID do cliente OAuth2 do Communication Arrangement. |
| Segredo do cliente | Texto | O segredo do cliente OAuth2 do Communication Arrangement. Armazenado de forma criptografada. |
Entidades disponíveis para importação
Seção intitulada “Entidades disponíveis para importação”A etapa Import S/4HANA Entity cobre duas entidades: trial_balance (saldos agregados das contas do razão geral no fim do período, por API_OPLACCTGDOCITEMCUBE_SRV) e journal_entry_items (itens de linha de lançamentos contábeis lançados, por API_JOURNALENTRYITEMBASIC_SRV). Ambas oferecem filtros do lado do servidor em CompanyCode, GLAccount, CostCenter, ProfitCenter, FiscalYear, FiscalPeriod e Ledger, com PostingDate, FiscalYear e FiscalPeriod aceitando limites de intervalo ge/le. Consulte a etapa Import S/4HANA Entity para a referência completa dos campos.
Lançamento de lançamentos contábeis
Seção intitulada “Lançamento de lançamentos contábeis”A etapa S/4HANA: Post Journal Entry lança lançamentos contábeis do razão geral pelo pipeline de gravação de ERP compartilhado do PlaidCloud: envia pelo serviço SOAP JournalEntryBulkCreateRequest_In do S/4HANA Cloud, consulta a confirmação JournalEntryBulkCreateConfirmation_Out e confirma antes de informar que um lançamento foi efetuado. Uma correção lança um novo lançamento de estorno, com débito e crédito invertidos, em vez de editar o original. Consulte a etapa S/4HANA: Post Journal Entry para a referência dos campos e Conectar ao SAP S/4HANA Cloud para o passo a passo completo de lançamento.
Limitações conhecidas
Seção intitulada “Limitações conhecidas”| Limitação | O que significa |
|---|---|
| Latência de confirmação | O serviço SOAP de criação em massa processa as solicitações de forma assíncrona, o que é bem mais lento do que uma gravação OData síncrona do mesmo tamanho. |
| Os campos filtráveis dependem do seu Communication Scenario | Um objeto de custo ou uma dimensão que o seu Communication Scenario não expõe não pode ser filtrado no servidor; delimite-o no seu fluxo de trabalho depois da extração. |
Relacionados
Seção intitulada “Relacionados”- Conectar ao SAP S/4HANA Cloud (guia) — passo a passo: criar a conexão, testá-la, importar uma entidade e lançar um diário.
- Import S/4HANA Entity
- S/4HANA: Post Journal Entry
- Revisar o histórico de lançamentos de ERP
- Conector SAP ECC / S/4HANA — o conector separado, baseado em RFC/agente, para S/4HANA local ou em nuvem privada.