Integracao Touch Comp ERP Terceiros (API/Endpoints)/API Smart Component
Integracao_Touch_Comp_ERP_Terceiros_(API/Endpoints) / Modulo_Business_Intelligence_Smart_Component
Smart Components são componentes modulares de integração e serviços, utilizados pela Touch Comp, para dinamizar e acelerar a liberação de novas funcionalidades on demand.
Nesta Wiki iremos abordar os componentes de integração, de recebimento de dados de parceiros integradores.
Smart Component
Para começar, a URL de recebimento de dados será sempre (POST):
http://servidor:porta/touch-erp/auth/business-intelligence/smart-component/iniciar-smart-component/import-data/codigo_smart_component
O que irá mudar será o payload dos dados e o codigo_smart_component. Este código será informado pela Touch Comp ou cliente, ao integrador, conforme os dados a serem processados e integrados pelo Smart Component.
O payload de dados será:
{"input":"dados_json_base_64","params":parametros_map}
Os dados devem ser enviados normalmente no formato json, codificados em Base 64, dentro do campo input. Parâmetros adicionais, serão enviados em chave e valor, em parametros_map. O envio em Base64 se deve para preservar os dados, especialmente por corrupção de caracteres.
{"input":"W3sicHJvZHV0b0lkZW50aWZpY2Fkb3IiOm51bGwsInByb2R1dG9Db2RpZ29BdXhpbGlhciI6IkFCQzEwMSIsInJldmlzYW8iOiIxIiwiaXRlbnMiOlt7ImNlbHVsYVByb2R1dGl2YUlkZW50aWZpY2Fkb3IiOjEsIml0ZW5zIjpbeyJwcm9kdXRvSWRlbnRpZmljYWRvciI6MjgsInByb2R1dG9Db2RpZ29BdXhpbGlhciI6bnVsbCwiY29tcHJpbWVudG8iOjEuMCwibGFyZ3VyYSI6MS4wLCJhbHR1cmEiOjEuMCwiZXNwZXNzdXJhIjoxLjAsInF1YW50aWRhZGUiOjAuNTQ2OTU0LCJxdWFudGlkYWRlUmVmZXJlbmNpYSI6NS4wLCJjb2RSZWZlcmVuY2lhIjpudWxsLCJvYnNlcnZhY2FvIjpudWxsLCJ2b2x1bWUiOm51bGx9XX1dfV0K","params":null}
Os dados em si, bem como layout e parâmetros irão variar conforme cada Smart Component criado. Consulte a wiki de cada Smart Component, para mais detalhes.
Em caso de sucesso, será retornado:
{
"@type": "WebDTOResult",
"status": "SUCESSO",
"messages": [],
"result": null,
"countOf": 0,
"name": null,
"message": null,
"detailMessage": null
}