Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Informações Gerais

AtributoDetalhe
ProdutoDatasul
OcorrênciaDocumentação de API
Nome Físicofinapi/apiCostCenterStatusIntegrMePublic.p

...

Objetivo

Esta API tem como objetivo atualizar o status do processamento de integração dos Centros de Custo na tabela de controle fgl_integr_ccusto_merc. Ela permite que sistemas externos (como o a plataforma Mercado Eletrônico (ME)**) reportem se o registro foi processado com sucesso, se houve erro ou se está em alguma etapa específica, além de registrar mensagens de retorno e a data da última atualização.

** O Mercado Eletrônico (ME) é uma plataforma especializada em comércio eletrônico B2B (Business to Business), voltada à negociação de produtos e serviços entre empresas. A solução possibilita transações comerciais em um ambiente de alta performance, no qual as informações são compartilhadas de forma estratégica e serviços diferenciados são disponibilizados aos parceiros envolvidos.

...

Funcionamento

  • Tipo de Execução: A API é executada de forma persistente e utiliza o parser padrão de requisições JSON do framework Datasul.

  • Persistência: As alterações são realizadas dentro de um bloco de transação (persistenceTransaction), garantindo a integridade dos dados na tabela fgl_integr_ccusto_merc.

  • Validação: Antes de qualquer alteração, a API valida se o identificador do centro de custo informado existe na tabela de integração através da procedure interna pi-valida-costcenter-integr.

  • Chamada Recomendada:

    RUN finapi/apiCostCenterStatusIntegrMePublic.p PERSISTENT SET h-api.
    

...

Descrição: Atualiza os campos de situação (num_sit_integr), data de alteração (dat_alter) e mensagem de processamento (num_msg_integr) de um registro de integração específico. O método centraliza a lógica na procedure pi-store-v1, que gerencia a transação de banco de dados.

Parâmetros

Parâmetro:Tipo:Input/Output:Descrição: 
oInputJsonObjectINPUTObjeto JSON contendo o payload com os dados de atualização.
oOutputJsonObjectOUTPUT Objeto JSON de retorno (vazio em caso de sucesso).
RowErrorsTemp-tableOUTPUTTabela contendo erros de validação (ex: registro não encontrado).


Detalhamento dos parâmetros de entrada

...

Tabela padrão utilizada para retornar mensagens de erro quando o identificador de integração não é localizado no sistema.

CampoTipoDescrição
ErrorNumberintegerCódigo do erro (
Ex
Exemplo: 10467 quando o registro não existe).
ErrorDescriptioncharacterDescrição da mensagem de erro.
ErrorFieldcharacterCampo que gerou o erro.

DEMAIS INFORMAÇÕES

Conteúdos relacionados:

Consulte mais informações através dos links abaixo: