Avançar para o conteúdo
Início » Blog » API ConectorGate – Personalização de Campos

API ConectorGate – Personalização de Campos

  • por

A API ConectorGate permite a utilização de dois métodos para personalização dos campos da API padrão:

  • Cadastramento de campos de usuário específicos no Setup da API (campos reservados)
  • Cadastramento de campos de usuário na tabela CUSTOM

Personalização via Setup da API

A API ConectorGate prevê alguns campos de usuário padrão que podem ser definidos no Setup da API. São eles:

CAMPO DE USUÁRIOCampo na APIGlobal Property
(SAPB1 – SAP B1If)
Parâmetro
(PROTHEUS – SX6)
ID externo do pedidocustomOrderKeyUdfOrderKeyIG_UDFSOKY
Status do pedidocustomOrderStatusUdfOrderStatusIG_UDFSOST
Status Notificado do pedidocustomOrderStatusNotifyUdfOrderStatusNotifyIG_UDFSOSN
Tipo de Transporte do pedidocustomShippingTypeUdfShippingTypeIG_UDFSHTY
Método de Transporte do pedidocustomShippingMethodUdfShippingMethodIG_UDFSHMT
Tracking Key do pedidocustomTrackingKeyUdfTrackingKeyIG_UDFTKKY
Tracking Url do pedidocustomTrackingUrlUdfTrackingUrlIG_UDFTKUR
Chave de acesso da NFecustomNfeAccessKeyUdfNfeAccessKeyIG_UDFNFAK
Codigo de autorização da NFecustomNfeAuthCodeUdfNfeAuthCodeIG_UDFNFAC
Protocolo de autorização da NFecustomNfeProtocolUdfNfeProtocolIG_UDFNFPT
Campos personalizados reservados

Personalização via Tabela CUSTOM

Para a utilização de campos customizados (campos de usuário), ou de campos padrão não previstos na API, a API prevê a criação e utilização de uma (1) tabela auxiliar no banco de dados do ERP.

Tabela de campos Custom = [@IGT_CUSTOM]

Nesta tabela devem ser cadastrados os campos customizados no ERP, ou campos padrão do ERP não previstos na API, e sua relação com campos obtidos no request/response ou valores fixos.

Nesta tabela temos 2 campos importantes:

  • IPO: indica se o campo será utilizado no Inbound (PUT/POST) ou no Outbound (GET). Opções: I=inbound, P=processing, O=outbound
  • DATATYPE: indica a origem/destino do valor do campo no processamento, se algum campo do request/response (API field), se terá valor fixo, ou ainda se terá a data ou a hora ou a origem do acesso à API. Opções: A=API field, F=Fixed value, D=date, T=time, S=source

Os campos que forem cadastrados na tabela Custom da API, para incrementar os requests ou responses de sua API, podem ser consultados no Portal de Monitoramento. Acesse a seção de usuário > My Custom.

Portal ConectorGate - My Custom
Visualização de campos customizados definidos na API salesAPI ERP SAP Business One TOTVS Protheus
Portal ConectorGate – My Custom

Os registros podem ser incluídos na tabela CUSTOM: [1] pelo banco de dados (INSERT INTO), [2] pelo Postman (usando a API ConectorGate).

Deixe um comentário

O seu endereço de email não será publicado. Campos obrigatórios marcados com *