Documento de API

Produto:

Datasul

Ocorrência:

Documentação de API

Nome Físicocdp/cdapi997.p

Considerações Gerais

 

Objetivo

Manter e fornecer integrações sobre depósitos do Datasul 12 com soluções externas.

 

Funcionamento

Na forma padrão, realiza-se a chamada através de um comando RUN normal, passando-se as temp-tables carregadas com as informações necessárias.

A sintaxe para a chamada da API é:

run xxx/xxapinnn.p (input-output table tt-...,

                    input        table tt-...,

                    ...,

                    ...).

 

A sintaxe para executar a API em modo persistente é:

run xxx/xxapinnn.p persistent set h-handle (input-output table tt-...,

                                            input        table tt-...,

                                            ...,

                                            ...).

A variável denominada h-handle irá receber o “handle” do programa, permitindo o acesso aos “métodos” internos da API.

 

Método Básico

 

Quando a API for executada em modo persistente, os seguintes métodos estarão disponíveis para execução:

 

pi-SendUpsert

Requisito

Cria e envia XML de criação/alteração de registros (EAI2)

Sintaxe

run pi-SendUpsert in h-handle (input rRowid,

                                                  output table RowErrors).

Descrição

Cria e envia XML de criação/alteração de registros

Parâmetros

Descrição

rRowid

Rowid do depósito que deve ser integrado.

Retorno

RowErrors – Indica erros ocorridos durante a integração.

pi-SendDirectUpsertWarehouse

Requisito

Cria e envia XML de criação/alteração de registros (MES)

Sintaxe

run pi-SendDirectUpsertWarehouse in h-handle (input rRowid,

                                                                              output pcXML,

                                                                              output cChave,

                                                                              output table RowErrors).

Descrição

Cria e envia XML diretamente para webservice MES indicado nos parâmetros da produção (CP0106) de criação/alteração de registros

Parâmetros

Descrição

rRowid

Rowid do depósito que deve ser integrado.

Retorno

pcXML – LONGCHAR com XML criado para envio.

cChave – Chave da mensagem de integração.

RowErrors – Indica erros ocorridos durante a integração.