| Atributo | Detalhe |
| Produto | Datasul |
| Ocorrência | Documentação de API |
| Nome Físico | finapi/apiCostCenterStatusIntegrMePublic.p |
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 Mercado Eletrônico) 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.
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.
Requisito: É necessário enviar o payload contendo o identificador orderCostCenterME válido e existente na tabela fgl_integr_ccusto_merc.
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: |
|---|---|---|---|
| oInput | JsonObject | INPUT | Objeto JSON contendo o payload com os dados de atualização. |
| oOutput | JsonObject | OUTPUT | Objeto JSON de retorno (vazio em caso de sucesso). |
| RowErrors | Temp-table | OUTPUT | Tabela contendo erros de validação (ex: registro não encontrado). |
Detalhamento dos parâmetros de entrada
payload
orderCostCenterME: Identificador da integração no Datasul.
status: Código numérico da nova situação da integração.
lastUpdateDatetime: Data da atualização (formato Date).
processMessage: Texto descritivo do processamento ou erro ocorrido no destino.
Exemplo de entrada
JSON
{
"payload": {
"orderCostCenterME": "CC-001-EMP01",
"status": 2,
"lastUpdateDatetime": "2025-07-21",
"processMessage": "Integrado com sucesso no portal."
}
}
Tabela padrão utilizada para retornar mensagens de erro quando o identificador de integração não é localizado no sistema.
| Campo | Tipo | Descrição |
| ErrorNumber | integer | Código do erro (Ex: 10467 quando o registro não existe). |
| ErrorDescription | character | Descrição da mensagem de erro. |
| ErrorField | character | Campo que gerou o erro. |