...

Como funcionam as requisições de importação e exportação de dados?

A IMPORTAÇÃO de dados do Protheus para o TOTVS CRM | SFA é realizada através de requisições ao método genericRecords genericQuerypresente no seguinte endereço da API de integração REST:

http://IP_SERVIDOR_PROTHEUS:PORTA/AMBIENTE_REST/api/framework/v1/

...

genericQuery

Documentação da API: https://tdn.totvs.com.br/display/public/framework/GenericQuery

Este método retorna os registros das consultas

...

parametrizadas conforme json de configuração na tabela wsconfigintegração do TOTVS SFA.

Método de requisição: GET

URL base: IP e Porta

Nome do método:

...

genericQuery

Autenticação: 

...

usuário e senha criado no Protheus, com

...

permissões totais aos módulos

Header: Authorization | Basic <usuario:senha> Usuário e senha do ERP criptografado em Base64

Result: Objeto JSON contendo os dados do retorno da consulta

A EXPORTAÇÃO de dados do TOTVS CRM | SFA para SFA para o Protheus é realizada através do TOTVS EAI Mensagem Padronizada no seguinte endereço da API de integração REST:

http://IP_SERVIDOR_PROTHEUS:PORTA/AMBIENTE_REST/totvseai/standardmessage/v1/transactions

Este método envia os pedidos e clientes cadastrados no SFA para o Protheus.

A documentação das rotas EAI estão aqui: Documentação de Order e CustomerVendor

Método de requisição: POST/PUT

URL base: IP e Porta

Nome do método: order | customerVendor

Autenticação: usuario e senha criado no Protheus, com permissoes totais aos módulos

Header: Authorization | Basic <usuario:senha> Usuário e senha do ERP criptografado em Base64

Body: Objeto JSON contendo o registro a ser inputado no Protheus

Documentações adicionais de configuração de importação/exportação de dados:

• PROTHEUS - Como configurar campos específicos na exportação de pedido e cliente
• PROTHEUS - Como usar o parâmetro IGNORAR_ENTIDADES
• PROTHEUS - Como usar os parâmetros de tratamentos de casa decimais

Múltiplos ambientes REST

A integração pode possuir mais de um ambiente REST, caso isso ocorra, em cada ambiente do Protheus deverá ser configurado os parâmetros através do manual de configuração.

...

Isso serve para diferir a origem de cada registro do Protheus.

Agendamentos das rotinasrotinas 

Todas as rotinas de integração são executadas conforme um agendamento, que determina os horários em que as rotinas serão executadas.

...

exportation_job_all.bat | exportation_job_all.sh: responsável por executar as rotinas de exportação de pedido e cliente.

Modos de agendamento FULL | DELTA

Para auxiliá-los nisso, foi feita uma vídeo aula explicando o funcionamento e a parametrização, segue:

https://drive.google.com/file/d/13P-T9uauVZAGLXZUDU6JrofgLs8b587x/view?usp=sharing

Entidades da Integração

0. ENTIDADES FIXAS

...