Histórico da Página
Informações Gerais
| Atributo | Detalhe |
| Produto | Datasul |
| Ocorrência | Documentação de API |
| Nome Físico | finapi/apiCostCenterIntegraMePublic.p |
...
Objetivo
Esta API tem como propósito realizar a integração de Centros de Custo entre o ERP Datasul e a plataforma Mercado Eletrônico. Ela permite a consulta individual (GET) ou em lote (Query) de centros de custo, controlando o status de integração e sinalizando inclusões, alterações ou exclusões através de uma tabela de controle de integração (fgl_integr_ccusto_merc).
...
Descrição: Retorna os detalhes de um Centro de Custo específico baseado no ID de integração. O método verifica se o registro está ativo na data atual (validade) e atualiza a tabela de controle de integração para o status "Em Processamento". Caso o Centro de Custo não exista mais na tabela principal (ccusto), o retorno é montado com status desativado e tipo de transação de exclusão.
Parâmetros
| Parâmetro: | Tipo: | Input/Output: | Descrição: |
|---|---|---|---|
| oInput | JsonObject | INPUT | Objeto JSON contendo os parâmetros da requisição (ID do registro). |
| oOutput | JsonObject | OUTPUT | Objeto JSON contendo os dados do Centro de Custo e sua respectiva empresa. |
| RowErrors | Temp-table | OUTPUT | Tabela contendo erros de negócio ou infraestrutura encontrados durante a execução. |
Detalhamento dos parâmetros de entrada
...
Descrição: Realiza a listagem de Centros de Custo vinculados ao plano de centro de custo da empresa do usuário. O método permite filtragem por descrição através do parâmetro search ou filter. Para cada registro encontrado, a API verifica a necessidade de integração (se houve alteração de descrição ou validade) e gera a estrutura JSON necessária para o Integra.Me.
Parâmetros
| Parâmetro: | Tipo: | Input/Output: | Descrição: |
|---|---|---|---|
| oInput | JsonObject | INPUT | Filtros de pesquisa, ordenação e paginação. |
| aOutput | JsonArray | OUTPUT | Lista de objetos JSON representando os Centros de Custo encontrados. |
| lHasNext | Logical | OUTPUT | Indica se existe uma próxima página de dados a ser consultada. |
| RowErrors | Temp-table | OUTPUT | Tabela de erros retornada em caso de falha na consulta. |
Detalhamento dos parâmetros de entrada
...
Utilizada internamente para mapear os dados que serão convertidos para o formato JSON do Mercado Eletrônico.
| Campo | Tipo | Serialize-name | Descrição |
| ttv_cod_id | character | clientCostCenterId | ID único de integração (Ex: CC-Empresa-Plano) |
| ttv_des_tit_ctbl | character | description | Descrição do Centro de Custo |
| ttv_log_desativado | logical | isDeactivated | Indica se o CC está fora da validade |
| ttv_log_status | logical | status | Status da integração |
| ttv_num_transaction | integer | transaction | Tipo da transação (1-Inclusão, 2-Alteração, 3-Exclusão) |
| ttv_cod_empresa | character | - | Código da empresa (interno) |
| ttv_cod_plano_ccusto | character | - | Código do plano de |
| Centro de Custo (interno) | |||
| ttv_cod_ccusto | character | - | Código do Centro de Custo (interno) |
RowErrors
Tabela padrão do framework UT-API para retorno de mensagens de erro.
| Campo | Tipo | Descrição |
| ErrorNumber | integer | Número da mensagem de erro no ERP |
| ErrorDescription | character | Descrição amigável do erro ocorrido |
| ErrorField | character | Campo que originou o erro (se aplicável) |
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas