1. INFORMAÇÕES PROPRIETÁRIA

Este documento é de propriedade da Wealth Systems Informática Ltda. Todas as informações contidas aqui são confidenciais e não devem ser copiadas ou divulgadas para quaisquer terceiros sem antes um consentimento formal, por escrito, da Wealth Systems, podendo somente ser divulgada dentro do Cliente para os seus funcionários que estiverem diretamente envolvidos no projeto, o qual este documento relata.
A empresa Cliente será solenemente responsável por assegurar que todos seus funcionários envolvidos estejam de acordo e acatem estas condições e ainda, está intitulado para usar as informações contidas neste documento, somente para propósitos de avaliação. Este documento é versionado e sua estrutura não poderá ser alterada sem o consentimento do Gerente de Projetos da Wealth Systems.

2. HISTÓRICO DE REVISÃO

DATA	VERSÃO	MODIFICADO POR	DESCRIÇÃO DA MUDANÇA
31/01/2020	8.0.2	Fábio Ancioto	Fechamento de versão.

Protheus

3. INTEGRAÇÃO DE DADOS

A integração de dados entre TOTVS CRM | SFA e Protheus se dá através de uma API (Application Programming Interface) que utiliza web services com arquitetura REST (Representation State Transfer) para importação de dados (Protheus → TOTVS CRM | SFA) e SOAP (Simple Object Access Protocol) para a exportação de pedidos (TOTVS CRM | SFA → Protheus).

3.1 Horários de execução padrões

Todas as rotinas de integração são executadas conforme um agendamento, que determina os horários em que as rotinas serão executadas. Em servidores Windows, o agendamento é feito através da ferramenta Agendador de Tarefas, que é nativa do sistema operacional, enquanto em servidores Linux o agendamento é feito através de um arquivo Cron, que é o equivalente do agendador de tarefas para sistemas Unix.
Por padrão, os agendamentos de execução das rotinas standard são feitos da seguinte forma: Importação Geral (BLOCO_ALL): Inicia a execução às 6h, repete a cada intervalo de 1h, encerrando as execuções as 20h (expressão cron: 0 4-20 * * *);
Exportação Pedido: Inicia a execução às 6h, repete a cada intervalo de 5min, encerrando as execuções as 20h (expressão cron: */5 4-20 * * *);
Exportação Clientes: Inicia a execução às 6h, repete a cada intervalo de 5min, encerrando as execuções as 20h (expressão cron: */5 4-20 * * *).
Ao ser feito o agendamento, deve ser levado em consideração os recursos de cada servidor, para entender se o agendamento padrão é ou não aderente, e ajustar conforme as necessidades.

3.2 Execuções fora do agendamento:

É possível executar os serviços de integração manualmente, caso necessário, tanto em servidores windows como em servidores linux.
Windows: Como todos os agendamentos são feitos através do Agendador de Tarefas do Windows (Task Scheduler), é possível executá-los a partir do mesmo. É possível também executar o arquivo .bat da integração desejada diretamente da pasta da integração;
Linux: É necessário executar o arquivo .sh da rotina desejada na pasta da integração.

3.3 Importação de dados

A importação de dados do Protheus para o TOTVS CRM | SFA é realizada através de requisições ao método getgenerico presente na API de integração REST.
Este método retorna os registros de uma única tabela do banco de dados do Protheus de forma genérica através de parâmetros enviados na sua requisição.
Método de requisição: GET
URL base: IP e Porta
Nome do método: GETGENERICO
Autenticação: BASIC (se habilitada) ou NO AUTH (se não habilitada)
Exemplo: http://10.50.100.1:8036/rest/wssim3g/getgenerico
Header: 

CHAVE	VALOR	OBSERVAÇÃO
Content-Type	application/json	Formato do conteúdo: JSON
TenantId	EMP,FIL	Código da empresa e filial do Protheus
Authorization	Basic <usuario:senha>	Usuário e senha do ERP criptografado em Base64

Body (Request): Vazio

Result: Objeto JSON contendo os dados do retorno da consulta

Parâmetros (Querystring): 

NOME	TIPO	OBRIGATÓRIO	DESCRIÇÃO
TABLE	Texto	Sim	"Alias" ou "nome" da tabela do Protheus (obrigatório). Se informar o "Alias", retornará a tabela conforme a "Empresa" configurada na instância do web service
FIELD	Texto	Não	Lista de campos da tabela para retornar. Se não informado, retornará todos.
FILTER	Texto	Não	Expressão de filtro sobre os campos da tabela em sintaxe SQL.
ORDER	Texto	Não	Lista de campos da tabela para ordenar os registros em sintaxe SQL. Se não informado, será ordenado pelo campo R_E_C_N_O_.
LIMIT	Inteiro	Não	Quantidade de registros para retornar a cada chamada do método.
PAGE	Inteiro	Não	Número da página para retornar se informado o parâmetro LIMIT.

Exemplo de requisição:

http://10.50.100.1:8036/rest/WSSIM3G/getgenerico?table=CC2&field=CC2_CODMU
N,CC2_MUN&limit=100&page=1&order=CC2_EST,CC2_MUN&filter=CC2_EST='PR'

Exemplo de retorno:

{
"result":

{"CC2_EST": "PR","CC2_CODMUN": "00608","CC2_MUN": "ALTO PARANA"},
{"CC2_EST": "PR","CC2_CODMUN": "00905","CC2_MUN": "AMAPORA"},
{"CC2_EST": "PR","CC2_CODMUN": "06704","CC2_MUN": "CRUZEIRO DO SUL"},
{"CC2_EST": "PR","CC2_CODMUN": "07108","CC2_MUN": "DIAMANTE DO NORTE"},
{"CC2_EST": "PR","CC2_CODMUN": "08908","CC2_MUN": "GUAIRACA"},
{"CC2_EST": "PR","CC2_CODMUN": "10300","CC2_MUN": "INAJA"},
{"CC2_EST": "PR","CC2_CODMUN": "11308","CC2_MUN": "ITAUNA DO SUL"},
{"CC2_EST": "PR","CC2_CODMUN": "12603","CC2_MUN": "JARDIM OLINDA"},
{"CC2_EST": "PR","CC2_CODMUN": "13502","CC2_MUN": "LOANDA"},
{"CC2_EST": "PR","CC2_CODMUN": "15002","CC2_MUN": "MARILENA"}
],
"count": 10,
"page": 1
} 

3.4 Blocos de execução

A importação de dados é dividida em blocos, cada blocos contendo uma série de rotinas que giram em torno do mesmo módulo ou tipo de informação, e todos estes blocos por sua vez são contidos em um bloco geral, chamado de BLOCO_ALL, que é executado periodicamente como uma carga geral de informações.

Blocos:

Bloco Commons: Composto de rotina que importam informações mais estáticas, que não dependem de muitos vínculos e não tendem a mudar com frequência, sendo de certa forma informações generalistas no sistema. Exemplo: entidade país, unidade federativa, cidade, tipo parceiro etc.

Bloco Filial: Possui apenas a rotina GETFILIAL, que faz a importação de filiais para o TOTVS CRM | SFA;

Bloco TES: Realiza a importação das informações de TES, com base no tipo de TES utilizado (inteligente ou padrão);

Bloco Vendedor: Importa as informações pertinentes aos usuários e seus vínculos (usuário filia, usuário e-mail etc.);

Bloco Parceiro: É composto das rotinas de integração de transportadoras e de clientes, assim como seus vínculos;

Bloco Produto: Integra todas as informações com relação aos produtos e seus vínculos, assim como informações de tipo de produto, grupo de produto, unidade de medida e embalagem;

Bloco Estoque: Realiza a integração de informações de estoque por produto;

Bloco Preço: Importa as informações de tabelas de preços e as vincula com produtos e locais de clientes.

3.5 Entidades da importação de dados

Abaixo estão descritas todas as entidades que são importadas na integração standard entre Protheus e TOTVS CRM | SFA.

PAIS (Tablea PAIS)

Retorna todos os países cadastrados no Protheus na tabela SYA. 

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	PAIS.DESCRICAO	YA_DESCR	CARACTERE(80)	SIM
2	PAIS.NACIONALIDADE	YA_IDIOMA	CARACTERE(80)	NÃO
3	PAIS.CODIGO	YA_CODGI	CARACTERE(20)	SIM
4	PAIS.SIGLA	YA_SIGLA	CARACTERE(10)	NÃO
5	PAIS.IDNPADRAO	SE YA_DESCR = 'BRASIL' ENTÃO 1 SENÃO 0	INTEIRO(1)	SIM
6	PAIS.IDNATIVO	SE RECDEL <> 0 ENTÃO 0 SENÃO 1	INTEIRO(1)	SIM
7	PAIS.CODIGOERP	YA_CODGI	CARACTERE(80)	SIM

UNIDADE FEDERATIVA (Tabela UNIDADEFEDERATIVA)

Retorna todas as unidades federativas cadastradas no Protheus na tabela SX5 quando X5_TABELA = '12'. 

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	UNIDADEFEDERATIVA.IDPAIS	FIXO 105 (BRASIL)	INTEIRO(19)	SIM
2	UNIDADEFEDERATIVA.SIGLA	X5_CHAVE	CARACTERE(10)	SIM
3	UNIDADEFEDERATIVA.CODIGO	X5_CHAVE	CARACTERE(20)	NÃO
4	UNIDADEFEDERATIVA.DESCRICAO	X5_DESCRI	CARACTERE(20)	SIM
5	UNIDADEFEDERATIVA.IDNATIVO	SE RECDEL <> 0 ENTÃO 0 SENÃO 1	INTEIRO(1)	SIM
6	UNIDADEFEDERATIVA.CODIGOERP	X5_CHAVE	CARACTERE(80)	SIM

CIDADE (Tabela CIDADE)

Retorna todas as cidades cadastradas no Protheus na tabela CC2.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	CIDADE.IDUNIDADEFEDERATIVA	CC2_EST	INTEIRO(19)	SIM
2	CIDADE.DESCRICAO	CC2_MUN	CARACTERE(80)	SIM
3	CIDADE.CODIGO	CC2_CODMUN	CARACTERE(20)	NÃO
4	CIDADE.IDNATIVO	SE RECDEL <> 0 ENTÃO 0 SENÃO 1	INTEIRO(1)	SIM
5	CIDADE.CODIGOERP	CC2_CODMUN#CC2_EST	CARACTERE(80)	SIM

TIPO DE FRETE (Tabela TIPOFRETE)

Retorna todos os tipos de frete cadastrados no Protheus na tabela C0X.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	TIPOFRETE.DESCRICAO	C0X_DESCRI	CARACTERE(80)	SIM
2	TIPOFRETE.IDNPADRAO	SE C0X_CODIGO = '2' ENTÃO 1 SENÃO 0	INTEIRO(1)	SIM
3	TIPOFRETE.IDNSOMARFRETE	SE C0X_CODIGO = '2' ENTÃO 1 SENÃO 0	INTEIRO(1)	SIM
4	TIPOFRETE.IDNATIVO	FIXO 1	INTEIRO(1)	SIM
5	TIPOFRETE.SGLTIPOFRETE	SE C0X_CODIGO = '2' ENTÃO 'FOB' SE C0X_CODIGO = '1' ENTÃO 'CIF' SENÃO C0X_CODIGO	CARACTERE(100)	SIM
6	TIPOFRETE.CODIGOERP	C0X_CODIGO	CARACTERE(80)	SIM

CONDIÇÃO DE PAGAMENTO (Tabela CONDICAOPAGAMENTO)

Retorna todas as condições de pagamento cadastradas no Protheus na tabela SE4.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	CONDICAOPAGAMENTO.PERCENTUALACRESCIMO	E4_ACRSFIN	NUMÉRICO(18,6)	NÃO
2	CONDICAOPAGAMENTO.DESCRICAO	E4_DESCRI	CARACTERE(80)	SIM
3	CONDICAOPAGAMENTO.IDNATIVO	SE RECDEL <> 0 ENTÃO 0 SENÃO 1	INTEIRO(1)	SIM
4	CONDICAOPAGAMENTO.SGLTIPOCONDICAO	E4_TIPO	CARACTERE(10)	SIM
5	CONDICAOPAGAMENTO.IDNREQUERDATAENTREGA	FIXO 0	INTEIRO(1)	SIM
6	CONDICAOPAGAMENTO.IDNDISPPRIMEIROPEDIDO	FIXO 1	INTEIRO(1)	SIM
7	CONDICAOPAGAMENTO.IDNPADRAO	FIXO 0	INTEIRO(1)	SIM
8	CONDICAOPAGAMENTO.CODIGOERP	E4_CODIGO	CARACTERE(80)	SIM

TIPO DE COBRANÇA (Tabela TIPOCOBRANCA)

Retorna todos os tipos de cobrança cadastrados no Protheus na tabela SX5 quando X5_TABELA = '24'.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	TIPOCOBRANCA.DESCRICAO	X5_DESCRI	CARACTERE(80)	SIM
2	TIPOCOBRANCA.IDNATIVO	FIXO 1	INTEIRO(1)	SIM
3	TIPOCOBRANCA.IDNDISPPRIMEIROPEDIDO	FIXO 1	INTEIRO(1)	SIM
4	TIPOCOBRANCA.IDNREEMBOLSAVEL	FIXO 0		SIM
5	TIPOCOBRANCA.IDNVALIDAVALORLIMITE	FIXO 0	INTEIRO(1)	SIM
6	TIPOCOBRANCA.IDNPERMITEALTERARREEMBOLSO	FIXO 0	INTEIRO(1)	SIM
7	TIPOCOBRANCA.IDNPADRAO	FIXO 0	INTEIRO(1)	SIM
8	TIPOCOBRANCA.CODIGOERP	X5_CHAVE	CARACTERE(80)	SIM

REGIÃO (Tabela REGIAO)

Retorna todas as regiões cadastradas no Protheus na tabela SX5 quando X5_TABELA = 'A2'.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	REGIAO.DESCRICAO	X5_DESCRI	CARACTERE(80)	SIM
2	REGIAO.IDNATIVO	FIXO 1	INTEIRO(1)	SIM
3	REGIAO.CODIGO	X5_CHAVE	CARACTERE(20)	NÃO
4	REGIAO.CODIGOERP	X5_CHAVE	CARACTERE(80)	SIM

SEGMENTO (Tabela SEGMENTO)

Retorna todos os segmentos cadastrados no Protheus na tabela SX5 quando X5_TABELA = 'T3'.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	SEGMENTO.DESCRICAO	X5_DESCRI	CARACTERE(80)	SIM
2	SEGMENTO.IDNATIVO	FIXO 1	INTEIRO(1)	SIM
3	SEGMENTO.CODIGO	X5_CHAVE	CARACTERE(20)	NÃO
4	SEGMENTO.CODIGOERP	X5_CHAVE	CARACTERE(80)	SIM

TIPO DE ESTOQUE (Tabela TIPOESTOQUE)

Entidade existente apenas no TOTVS CRM | SFA, fazendo-se necessária para que o estoque tenha pelo menos um tipo.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	TIPOESTOQUE.DESCRICAO	FIXO 'ESTOQUE DISP.'	CARACTERE(80)	SIM
2	TIPOESTOQUE.SGLTIPOESTOQUE	FIXO 'EDI'	CARACTERE(10)	NÃO
3	TIPOESTOQUE.IDNATIVO	FIXO 1	INTEIRO(1)	SIM
4	TIPOESTOQUE.IDNDISPONIVELPARAPEDIDO	FIXO 1	INTEIRO(1)	SIM
5	TIPOESTOQUE.ORDEM	FIXO 1	INTEIRO(19)	NÃO
6	TIPOESTOQUE.CODIGOERP	FIXO 'EDI'	CARACTERE(80)	SIM

CLASSIFICAÇÃO DO CLIENTE (Tabela CLASSIFICACAOPARCEIRO)

Entidade existente apenas no TOTVS CRM | SFA, fazendo-se necessária para que o cliente tenha sua respectiva classificação.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	CLASSIFICACAOPARCEIRO.DESCRICAO	Valores fixos abaixo: 'Produtor Rural' 'Consumidor Final' 'Revendedor' 'ICMS Solidario sem IPI na base' 'Exportacao'	CARACTERE(80)	SIM
2	2 CLASSIFICACAOPARCEIRO.SGLCLASSIFICACAO	Valores fixos abaixo:  'L' 'F' 'R' 'S' 'X'	CARACTERE(10)	NÃO
3	CLASSIFICACAOPARCEIRO.IDNATIVO	FIXO 1	INTEIRO(1)	SIM
4	CLASSIFICACAOPARCEIRO.ORDEM	Valores fixos abaixo: 1 2 3 4 5	INTEIRO(19)	NÃO
5	CLASSIFICACAOPARCEIRO.CODIGOERP	Valores fixos abaixo: 'L' 'F' 'R' 'S' 'X'	CARACTERE(80)	SIM

PERFIL DE ACESSO (Tabela PERFILACESSO)

Entidade existente apenas no TOTVS CRM | SFA, fazendo-se necessária para que os usuários tenham seu respectivos perfis de acesso.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	PERFILACESSO.IDNADMINISTRADOR	FIXO 0	INTEIRO(1)	SIM
2	PERFILACESSO.IDNATIVO	FIXO 1	INTEIRO(1)	SIM
3	PERFILACESSO.SGLPERFILACESSO	FIXO 'PV'	CARACTERE(10)	SIM
4	PERFILACESSO.DESCRICAO	FIXO 'PERFIL VENDEDOR'	CARACTERE(80)	SIM
5	PERFILACESSO.IDNPONTOOBRIGATORI	FIXO 0	INTEIRO(1)	SIM
6	PERFILACESSO.CODIGOERP	FIXO 0	INTEIRO(1)	SIM
7	PERFILACESSO.CODIGOERP	FIXO 'XML#PV'	CARACTERE(80)	SIM

SITUAÇÃO DO PEDIDO (Tabela TIPOSITUACAOPEDIDO)

Entidade existente apenas no TOTVS CRM | SFA, fazendo-se necessária para que os pedido tenham sua respectiva situação.
Existem três situações que são imprescindíveis para o TOTVS CRM | SFA: NF (não finalizado), PP (pedido pendente) e PA (pedido aberto).
A descrição poderá sofrer alterações, porém a sigla deverá manter-se sempre estas listadas acima.
Existem duas situações que também são comuns à todos os clientes: PF (pedido faturado) e PC (pedido cancelado).
Estas podem sofrer alterações tanto na descrição quanto na sua sigla. 

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	TIPOSITUACAOPEDIDO.DESCRICAO	Valores fixos abaixo: 'PENDENTE'  'NAO FINALIZADO' 'PEDIDO FATURADO' 'PEDIDO CANCELADO' 'PEDIDO ABERTO'	CARACTERE(80)	SIM
2	TIPOSITUACAOPEDIDO.IDNATIVO	FIXO 1	INTEIRO(1)	SIM
3	TIPOSITUACAOPEDIDO.SGLTIPOSITUACAOPEDIDO	Valores fixos abaixo: 'PP' 'NF' 'PF' 'PC' 'PA'	CARACTERE(10)	SIM
4	TIPOSITUACAOPEDIDO.CODIGOERP	Valores fixos abaixo: 'PP' 'NF' 'PF' 'PC' 'PA'	CARACTERE(80)	SIM

TIPO DE NOTA FISCAL (Tabela TIPONOTAFISCAL)

Retorna todos os tipos de notas fiscais cadastrados no Protheus na tabela SX5 quando X5_TABELA = 'MQ'.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	TIPONOTAFISCAL.DESCRICAO	X5_DESCRI	CARACTERE(80)	SIM
2	TIPONOTAFISCAL.IDNATIVO	FIXO 1	INTEIRO(1)	SIM
3	TIPONOTAFISCAL.SGLTIPONOTAFISCAL	X5_CHAVE	CARACTERE(10)	NÃO
4	TIPONOTAFISCAL.CODIGOERP	X5_CHAVE	CARACTERE(80)	SIM

TES - PADRÃO E INTELIGENTE (Tabela TESPROTHEUS)

O cadastro Tipo de Entrada e Saída (TES) é responsável pela correta classificação dos documentos fiscais de entrada e saída registrados no Protheus.
Seu preenchimento deve ser efetuado com muito cuidado, pois através dele é possível:
● Calcular os tributos pertinentes ao documento registrado (entrada ou saída), bem como, definir sua escrituração nos Livros Fiscais de ISS, ICMS e IPI (integração com Livros Fiscais);
● Controlar a entrada e saída de produtos/valores no estoque (integração com Estoque e Custos, Faturamento e Compras) e atualizar os custos de entrada e saída;
● Incluir automaticamente títulos na carteira a receber (vendas/saída) e na carteira a pagar (compras/entradas) (integração com os ambientes Faturamento e Compras);
● Registrar automaticamente os ativos imobilizados, a partir dos documentos de entrada referentes à compra de ativo fixo (integração com o Ativo Fixo);
● Registrar a relação "Cliente X Produto/Equipamentos" quando há saída de um documento fiscal (integração com o Field Service);
● Agregar despesas ao custo do projeto ou as receitas recebidas (integração com Gestão de Projetos);
● Calcular os tributos relacionados aos documentos de transporte e, quando necessário, calcular os impostos pertinentes ao frete do autônomo (integração com Gestão de Transportes);
● Calcular impostos variáveis relativos à tributação específica, como por exemplo, impostos localizados

Para o TOTVS CRM | SFA, o cliente deverá informar qual tipo de TES utiliza: INTELIGENTE ou PADRÃO.

Dependendo do tipo da TES, a integração irá direcionar sua importação dos dados para a tabela correta.

TES PADRÃO: retorna todas as TES padrões cadastradas no Protheus na tabela SF4.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	TESPROTHEUS.CODIGO	F4_CODIGO	CARACTERE(20)	SIM
2	TESPROTHEUS.DESCRICAOABREVIADA	F4_TEXTO	CARACTERE(80)	SIM
3	TESPROTHEUS.DESCRICAOCOMPLETA	F4_FINALID	CARACTERE(200)	NÃO
4	TESPROTHEUS.IDLOCALFILIAL	F4_FILIAL	INTEIRO(19)	NÃO
5	TESPROTHEUS.IDNATIVO	SE F4_MSBLQL = '1' ENTÃO 0 SENÃO 1	INTEIRO(1)	SIM
6	TESPROTHEUS.TIPO	F4_TIPO	CARACTERE(80)	NÃO
7	TESPROTHEUS.CFOP	F4_CF	CARACTERE(80)	NÃO
8	TESPROTHEUS.CODIGOERP	'PAD'#F4_CODIGO#F4_FILIAL	CARACTERE(80)	SIM

TES INTELIGENTE: retorna todas as TES inteligentes cadastradas no Protheus na tabela SX5 quando X5_TABELA = 'DJ'.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	TESPROTHEUS.CODIGO	X5_CHAVE	CARACTERE(20	SIM
2	TESPROTHEUS.DESCRICAOABREVIADA	X5_DESCRI	CARACTERE(80)	SIM
3	TESPROTHEUS.DESCRICAOCOMPLETA	X5_DESCRI	CARACTERE(200)	NÃO
4	TESPROTHEUS.IDLOCALFILIAL	X5_FILIAL	INTEIRO(19)	NÃO
5	TESPROTHEUS.IDNATIVO	FIXO 1	INTEIRO(1)	SIM
6	TESPROTHEUS.CODIGOERP	PAD'#F4_CODIGO#F4_FILIAL	CARACTERE(80)	SIM

CADASTRO DE EMPRESAS/FILIAIS (Tabela LOCAL/PARCEIRO/LOCALTELEFONE)

Retorna todas as empresas/filiais do cliente cadastradas no Protheus no arquivo de configuração SM0.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	LOCAL.CNPJ LOCAL.DOCUMENTOIDENTIFICACAO	M0_CGC	CARACTERE(20)	NÃO
2	LOCAL.IDCIDADE	M0_CIDCOB	INTEIRO(19)	NÃO
3	LOCAL.IDCIDADE	M0_CIDENTvvv	INTEIRO(19)	NÃO
4		M0_CNAE
5	PARCEIRO.NUMEROMATRICULA LOCAL.NUMEROMATRICULA	M0_CODFIL	INTEIRO(1)	SIM
6	LOCAL.OBSERVACAO	M0_CODIGO	INTEIRO(1)	SIM
7	LOCAL.IDCIDADE	M0_CODMUN	INTEIRO(19)	SIM
8	LOCALTELEFONE.TELEFONE	M0_FAX	CARACTERE(40)	NÃO
9	LOCAL.INSCRICAOESTADUAL	M0_INSC	CARACTERE(40)	NÃO
10	LOCAL.INSCRICAOMUNICIPAL	M0_INSCM	CARACTERE(40)	NÃO
11	PARCEIRO.NOMEPARCEIRO LOCAL.DESCRICAO	M0_NOME	CARACTERE(80)	SIM
12	PARCEIRO.NOMEPARCEIROFANTASIA	M0_NOMECOM	CARACTERE(80)	NÃO
13	LOCALTELEFONE.TELEFONE	M0_TEL	CARACTERE(40)	NÃO

CADASTRO DE USUÁRIOS E/OU REPRESENTANTES (Tabela USUARIO)

Retorna todos os usuários e/ou representantes cadastrados no Protheus na tabela SA3.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	USUARIO.LOGIN	A3_COD	CARACTERE(30)	SIM
2	USUARIO.NOME	A3_COD - A3_NOME	CARACTERE(80)	SIM
3	USUARIO.EMAIL	A3_EMAIL	CARACTERE(80)	NÃO
4	USUARIO.DATACADASTRO	SE A3_ADMISS = NULL ENTÃO '1900-01- 01' SENÃO A3_ADMISS	DATA(YYYY-MMDD)	SIM
5	USUARIO.IDNATIVO	SE A3_MSBLQL = 1 OU A3_X_SIM3G = 'N' OU D_E_L_E_T_ <> " ENTÃO 0 SENÃO 1	INTEIRO(1)	SIM
6	USUARIO.ENDERECO	A3_END	CARACTERE(80)	NÃO
7	USUARIO.CEP	A3_CEP	CARACTERE(10)	NÃO
8	USUARIO.IDNEXIGEALFANUMERICO	FIXO 0	INTEIRO(1)	SIM
9	USUARIO.IDNEXPORTADOERP	FIXO 1	INTEIRO(1)	SIM
10	USUARIO.IDNPERMITIRINTEGRACAO	FIXO 1	INTEIRO(1)	SIM
11	USUARIO.IDPERFILACESSO	FIXO 'PV'	INTEIRO(19)	SIM
12	USUARIO.IDNHABILITARLDAP	FIXO 0	INTEIRO(1)	SIM
13	USUARIO.SENHA	A3_COD (CRIPTOGRAFADO)	CARACTERE(80)	SIM
14	USUARIO.CODIGOERP	A3_COD	CARACTERE(80)	SIM

CADASTRO DE EMAILS DOS USUÁRIOS E/OU REPRESENTANTES (Tabela USUARIOEMAIL)

Retorna todos os emails cadastrados para os usuários e/ou representantes no Protheus na tabela SA3.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	USUARIOEMAIL.EMAIL	A3_EMAIL	CARACTERE(80)	SIM
2	USUARIOEMAIL.IDNPADRAO	FIXO 1	INTEIRO(1)	SIM
3	USUARIOEMAIL.IDUSUARIO	A3_COD	CARACTERE(10)	SIM
4	USUARIOEMAIL.CODIGOERP	A3_COD	CARACTERE(80)	SIM

CADASTRO DE TELEFONES DOS USUÁRIOS E/OU REPRESENTANTES (Tabela USUARIOTELEFONE)

Retorna todos os telefones cadastrados para os usuários e/ou representantes no Protheus na tabela SA3.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	USUARIOTELEFONE.TELEFONE	A3_TEL, A3_TELEX, A3_CEL, A3_FAX	CARACTERE(40)	SIM
2	USUARIOTELEFONE.IDNPADRAO	SE A3_TEL ENTÃO 1 SENÃO 0	INTEIRO(1)	SIM
3	USUARIOTELEFONE.IDUSUARIO	A3_COD	CARACTERE(10)	SIM
4	USUARIOTELEFONE.CODIGOERP	A3_COD	CARACTERE(80)	SIM

CADASTRO DE HIERARQUIAS DOS USUÁRIOS E/OU REPRESENTANTES (Tabela USUARIOHIERARQUIA)

Retorna as hierarquias cadastrados para os usuários e/ou representantes no Protheus na tabela SA3.

Pode-se utilizar para a hierarquia os campos A3_SUPER ou A3_GEREN.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	USUARIOHIERARQUIA.IDUSUARIO	A3_COD	CARACTERE(40)	SIM
2	USUARIOHIERARQUIA.IDUSUARIOSUPERIOR	A3_SUPER ou A3_GEREN	INTEIRO(19)	SIM
3	USUARIOHIERARQUIA.IDNENVIACLIENT	FIXO 1	INTEIRO(1)	SIM
4	USUARIOHIERARQUIA.IDNPADRAO	FIXO 0	INTEIRO(1)	SIM
5	USUARIOHIERARQUIA.IDNUSUARIORESPONSAVEL	FIXO 1	INTEIRO(1)	SIM
6	USUARIOHIERARQUIA.CODIGOERP	A3_COD#A3_SUPER	CARACTERE(80)	SIM

CADASTRO DE VÍNCULOS DOS USUÁRIOS E/OU REPRESENTANTES COM SUA FILIAL/EMPRESA (Tabela USUARIOFILIAL)

Retorna a filial/empresa cadastrada para o usuário e/ou representante no Protheus na tabela SA3.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	USUARIOFILIAL.IDNPADRAO	FIXO 0	INTEIRO(1)	SIM
2	USUARIOFILIAL.IDLOCALFILIAL	A3_FILIAL	INTEIRO(19)	SIM
3	USUARIOFILIAL.IDUSUARIO	A3_COD	INTEIRO(19)	SIM
4	USUARIOFILIAL.CODIGOERP	A3_FILIAL#A3_COD	CARACTERE(80)	SIM

CADASTRO DA TRANSPORTADORA (Tabela LOCAL/PARCEIRO/LOCALTELEFONE/LOCALEMAIL/LOCALFILIAL)

Retorna o cadastro da transportadora no Protheus na tabela SA4.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	LOCAL.BAIRRO	A4_BAIRRO	CARACTERE(20)	NÃO
2	LOCAL.CEP	A4_CEP	CARACTERE(10)	NÃO
3	PARCEIRO.NUMEROMATRICULA LOCAL.CNPJ	A4_CGC	CARACTERE(20)	NÃO
4	LOCAL.NUMEROMATRICULA	A4_COD	CARACTERE(80)	NÃO
5	LOCAL.IDCIDADE	A4_COD_MUN	INTEIRO(19)	SIM
6	LOCAL.COMPLEMENTO	A4_COMPLEM	CARACTERE(80)	NÃO
7	LOCALTELEFONE.TELEFONE	A4_DDD
8	PARCEIRO.EMAIL LOCALEMAIL.EMAIL	A4_EMAIL	CARACTERE(80)	NÃO
9	LOCAL.LOGRADOURO LOCAL.DESCRICAO	A4_END	CARACTERE(80)	SIM
10	LOCALFILIAL.IDFILIAL	A4_FILIAL	INTEIRO(19)	NÃO
11	PARCEIRO.HOMEPAGE	A4_HPAGE	CARACTERE(80)	NÃO
12	LOCAL.INSCRICAOESTADUAL	A4_INSEST	CARACTERE(40)
13	PARCEIRO.IDNATIVO LOCAL.IDNATIVO	A4_MSBLQL	INTEIRO(1)	SIM
14	PARCEIRO.NOMEPARCEIRO	A4_NOME	CARACTERE(80)	SIM
15	PARCEIRO.NOMEFANTASIA	A4_NREDUZ	CARACTERE(80)	NÃO
16	LOCALTELEFONE.TELEFONE	A4_TEL	CARACTERE(40)	NÃO

CADASTRO DO TIPO DO LOCAL DA TRANSPORTADORA (Tabela LOCALTIPOLOCAL)

Retorna o cadastro do tipo do local da transportadora no Protheus na tabela SA4.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	LOCALTIPOLOCAL.CODIGOERP	A4_COD + ‘#’ + ‘TRA	CARACTERE(80)	SIM
2	LOCALTIPOLOCAL.IDLOCAL	A4_COD + ‘#’ + ‘TRA	INTEIRO(8)	NÃO
3	LOCALTIPOLOCAL.IDNATIVO	FIXO 1	INTEIRO(2)	NÃO
4	LOCALTIPOLOCAL.IDNEXPORTADOERP	FIXO 1	INTEIRO(2)	SIM
5	LOCALTIPOLOCAL.IDNPADRAO	FIXO 1	INTEIRO(2)	NÃO
6	LOCALTIPOLOCAL.IDTIPOLOCAL	FIXO "PRI";	INTEIRO(8)	NÃO

CADASTRO DO EMAIL DA TRANSPORTADORA (Tabela LOCALEMAIL)

Retorna o cadastro do e-mail vinculado ao local da transportadora no Protheus na tabela SA4.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	LOCALEMAIL.CODIGOERP	A4_COD + ‘#’ + ‘TRA’	CARACTERE(80)	SIM
2	LOCALEMAIL.EMAIL	A4_EMAIL	CARACTERE(80)	NÃO
3	LOCALEMAIL.IDLOCAL	A4_COD + ‘#’ + ‘TRA’	INTEIRO(8)	NÃO
4	LOCALEMAIL.IDNEXPORTADOERP	FIXO 1	INTEIRO(2)	SIM
5	LOCALEMAIL.IDNPADRAO	FIXO 1	INTEIRO(2)	SIM
6	LOCALEMAIL.IDPARCEIRO	A4_COD + ‘#’ + ‘TRA’	INTEIRO(8)	NÃO

CADASTRO DO TELEFONE DA TRANSPORTADORA (Tabela LOCALTELEFONE)

Retorna o cadastro do telefone vinculado ao local da transportadora no Protheus na tabela SA4.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	LOCALTELEFONE.CODIGOERP	A4_COD + ‘#’ + ‘TRA’	CARACTERE(80)	SIM
2	LOCALTELEFONE.IDLOCAL	A4_COD + ‘#’ + ‘TRA’	INTEIRO(8)	NÃO
3	LOCALTELEFONE.IDNEXPORTADO ERP	FIXO 1	INTEIRO(2)	SIM
4	LOCALTELEFONE.IDNPADRAO	FIXO 1	INTEIRO(2)	SIM
5	LOCALTELEFONE.IDPARCEIRO	A4_COD + ‘#’ + ‘TRA’	INTEIRO(8)	NÃO
6	LOCALTELEFONE.TELEFONE	SUBSTR(TRIM(GETDIGITSONLY(A4_TEL.LENG TH <= 9 && A4_TEL.LENGTH > 5 && A4_TEL != "" && A4_TEL != NULL ? A4_DDD + A4_TEL : A4_TEL)),0,80)	CARACTERE(40)	NÃO

CADASTRO DO LOCAL DA FILIAL DA TRANSPORTADORA (Tabela LOCALFILIAL)

Retorna o cadastro do local da filial da transportadora no Protheus na tabela SA4.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	LOCALFILIAL.CODIGOERP	A4_COD + ‘#’ + ‘TRA’ + ‘#’ + "EMP#" + A4_FILIAL	CARACTERE(80)	SIM
2	LOCALFILIAL.IDFILIAL	A4_FILIAL	INTEIRO(8)	NÃO
3	LOCALFILIAL.IDLOCAL	A4_COD + ‘#’ + ‘TRA’	INTEIRO(8)	NÃO
4	LOCALFILIAL.IDNPADRAO	FIXO 1	INTEIRO(2)	SIM
5	LOCALFILIAL.SGLTIPOFILIAL	FIXO "PRI"	CARACTERE(10)	NÃO
6	LOCALFILIAL.IDLOCALFILIAL	"EMP#" + A4_FILIAL;	INTEIRO(8)	NÃO

CADASTRO DE PESSOA JURÍDICA DA TRANSPORTADORA (Tabela PESSOAJURIDICA)

Retorna o cadastro dos dados da pessoa jurídica da transportadora no Protheus na tabela SA4.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	PESSOAJURIDICA.CNPJPRINCIPAL	A4_CGC	CARACTERE(20)	NÃO
2	PESSOAJURIDICA.CODIGOERP	A4_COD + ‘#’ + ‘TRA’	CARACTERE(80)	SIM
3	PESSOAJURIDICA.DOCUMENTOIDENTIFICACAO	A4_CGC	CARACTERE(80)	NÃO
4	PESSOAJURIDICA.IDNEXPORTADOERP	FIXO 1	INTEIRO(2)	SIM
5	PESSOAJURIDICA.IDTIPOIDENTIFICACAO	FIXO ‘CNPJ’	INTEIRO(8)	NÃO

CADASTRO DO TIPO DE PARCEIRO DA TRANSPORTADORA (Tabela PARCEIROTIPOPARCEIRO)

Retorna o cadastro do tipo do parceiro da transportadora no Protheus na tabela SA4.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	PARCEIROLOCAL.CODIGOERP	A4_COD + ‘#’ + ‘TRA’	CARACTERE(80)	SIM
2	PARCEIROLOCAL.IDLOCAL	A4_COD + ‘#’ + ‘TRA’	INTEIRO(8)	NÃO
3	PARCEIROLOCAL.IDNEXPORTADOERP	FIXO 1	INTEIRO(2)	NÃO
4	PARCEIROLOCAL.IDPARCEIRO	A4_COD + ‘#’ + ‘TRA’	INTEIRO(8)	NÃO

CADASTRO DE PARCEIRO (Tabela PARCEIRO)

Retorna o cadastro do parceiro no Protheus na tabela SA1.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM |SFA	Obrigatório
1	PARCEIRO.CODIGOERP	A1_COD + ‘#’ + A1_LOJA	CARACTERE(80)	SIM
2	PARCEIRO.DATACADASTRO	A1_DTCAD	DATE	SIM
3	PARCEIRO.DATAULTIMAATUALIZACAO	CURRENT_DATE	DATE	SIM
4	PARCEIRO.EMAIL	A1_EMAIL	CARACTERE(80)	NÃO
5	PARCEIRO.HOMEPAGE	A1_HPAGE	CARACTERE(80)	NÃO
6	PARCEIRO.IDCLASSIFICACAOPARCEIRO	A1_TIPO	INTEIRO(8)	NÃO
7	PARCEIRO.IDNATIVO	CASE WHEN A1_MSBLQL = '1' THEN 0 ELSE 1 END	INTEIRO(2)	SIM
8	PARCEIRO.IDNCONTRIBUINTE	FIXO 0	INTEIRO(2)	NÃO
9	PARCEIRO.IDNEXPORTADOERP	FIXO 1	INTEIRO(2)	NÃO
10	PARCEIRO.NOMEPARCEIRO	A1_COD + ‘ – ‘ + A1_LOJA + ‘ – ‘ + A1_NOME	CARACTERE(80)	SIM
11	PARCEIRO.NOMEPARCEIROFANTASIA	A1_NREDUZ	CARACTERE(80)	NÃO
12	PARCEIRO.NUMEROMATRICULA	A1_COD	CARACTERE(20)	NÃO
13	PARCEIRO.OBSERVACAO	A1_OBSERV	CARACTERE(4000)	NÃO
14	PARCEIRO.SGLTIPOPESSOA	A1_PESSOA + ‘#’ + ‘P’	CARACTERE(10)	SIM

CADASTRO DO LOCAL PRINCIPAL DO PARCEIRO (Tabela LOCAL)

Retorna o cadastro do local principal do parceiro no Protheus na tabela SA1.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM |SFA	Obrigatório
1	LOCAL.BAIRRO	A1_BAIRRO	CARACTERE(80)	NÃO
2	LOCAL.CEP	A1_CEP	CARACTERE(10)	NÃO
3	LOCAL.CNPJ	A1_CGC	CARACTERE(20)	NÃO
4	LOCAL.CODIGOERP	A1_COD + ‘#’ + A1_LOJA + '#' + 'PRI'	CARACTERE(80)	SIM
5	LOCAL.COMPLEMENTO	A1_COMPLEM	CARACTERE(80)	NÃO
6	LOCAL.DATACADASTRO	CURRENT_DATE	DATE	SIM
7	LOCAL.DATAULTIMAATUALIZACAO	CURRENT_DATE	DATE	SIM
8	LOCAL.DESCRICAO	A1_LOJA + ’ - ’ + A1_END + ’ - ’ + A1_BAIRRO + ’ - ’ + CIDADE.DESCRICAO	CARACTERE(200)	NÃO
9	LOCAL.DOCUMENTOIDENTIFICACAO	A1_RG	CARACTERE(80)	NÃO
10	LOCAL.IDCIDADE	A1_COD_MUN + ’–‘ + A1_EST	INTEIRO(8)	SIM
11	LOCAL.IDNATIVO	CASE WHEN A1_MSBLQL = '1' THEN 0 ELSE 1 END	INTEIRO(2)	SIM
12	LOCAL.IDNEXPORTADOERP	FIXO 1	INTEIRO(2)	SIM
13	LOCAL.IDNIPI	FIXO 0	INTEIRO(2)	NÃO
14	LOCAL.IDNREQUERDATAENTREGA	FIXO 0	INTEIRO(2)	NÃO
15	LOCAL.IDNREQUERNUMEROPEDIDOCLIENTE	FIXO 0	INTEIRO(2)	NÃO
16	LOCAL.IDUNIDADEFEDERATIVAFISCAL	A1_EST	INTEIRO(8)	NÃO
17	LOCAL.INSCRICAOESTADUAL	A1_INSCR	CARACTERE(40)	NÃO
18	LOCAL.INSCRICAOMUNICIPAL	SE A1_INSCRM END A1_INSCRM OR SE A1_PFISICA END A1_INSCRM OR SE A1_INSCRUR END A1_INSCRUR OR SE A1_RG END A1_RG	CARACTERE(40)	NÃO
19	LOCAL.LIMITESUGERIDO	A1_LC	NUMERIC	NÃO
20	LOCAL.LOGRADOURO	A1_END	CARACTERE(80)	NÃO
21	LOCAL.NUMEROMATRICULA	A1_COD	CARACTERE(20)	NÃO
22	LOCAL.OBSERVACAO	A1_OBSERV	CARACTERE(4000)	NÃO

CADASTRO DO LOCAL DE COBRANÇA DO PARCEIRO (Tabela LOCAL)

Retorna o cadastro do local de cobrança do parceiro no Protheus na tabela SA1.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	LOCAL.BAIRRO	A1_BAIRROC	CARACTERE(80)	NÃO
2	LOCAL.CEP	A1_CEPC	CARACTERE(10)	NÃO
3	LOCAL.CNPJ	A1_CGC	CARACTERE(20)	NÃO
4	LOCAL.CODIGOERP	A1_COD + ‘#’ + A1_LOJA + '#' + 'COB'	CARACTERE(80)	SIM
5	LOCAL.COMPLEMENTO	A1_COMPLEM	CARACTERE(80)	NÃO
6	LOCAL.DATACADASTRO	CURRENT_DATE	DATE	SIM
7	LOCAL.DATAULTIMAATUALIZACAO	CURRENT_DATE	DATE	SIM
8	LOCAL.DESCRICAO	A1_LOJA + ’ - ’ + A1_ENDCOB + ’ - ’ + A1_BAIRROC + ’ - ’ + CIDADE.DESCRICAO	CARACTERE(200)	NÃO
9	LOCAL.DOCUMENTOIDENTIFICACAO	A1_RG	CARACTERE(80)	NÃO
10	LOCAL.IDCIDADE	A1_COD_MUN + ’#‘ + A1_EST	INTEIRO(8)	SIM
11	LOCAL.IDNATIVO	CASE WHEN A1_MSBLQL = '1' THEN 0 ELSE 1 END	INTEIRO(2)	SIM
12	LOCAL.IDNEXPORTADOERP	FIXO 1	INTEIRO(2)	SIM
13	LOCAL.IDNIPI	FIXO 0	INTEIRO(2)	NÃO
14	LOCAL.IDNREQUERDATAENTREGA	FIXO 0	INTEIRO(2)	NÃO
15	LOCAL.IDNREQUERNUMEROPEDIDOCLIENTE	FIXO 0	INTEIRO(2)	NÃO
16	LOCAL.IDUNIDADEFEDERATIVAFISCAL	A1_EST	INTEIRO(8)	NÃO
17	LOCAL.INSCRICAOESTADUAL	A1_INSCR	CARACTERE(40)	NÃO
18	LOCAL.INSCRICAOMUNICIPAL	SE A1_INSCRM END A1_INSCRM OR SE A1_PFISICA END A1_INSCRM OR SE A1_INSCRUR END A1_INSCRUR OR SE A1_RG END A1_RG	CARACTERE(40)	NÃO
19	LOCAL.LIMITESUGERIDO	A1_LC	NUMERIC	NÃO
20	LOCAL.LOGRADOURO	A1_ENDCOB	CARACTERE(80)	NÃO
21	LOCAL.NUMEROMATRICULA	A1_COD	CARACTERE(20)	NÃO
22	LOCAL.OBSERVACAO	A1_OBSERV	CARACTERE(4000)	NÃO

CADASTRO DO LOCAL DE ENTREGA DO PARCEIRO (Tabela LOCAL)

Retorna o cadastro do local de entrega do parceiro no Protheus na tabela SA1.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	LOCAL.BAIRRO	A1_BAIRROE	CARACTERE(80)	NÃO
2	LOCAL.CEP	A1_CEPE	CARACTERE(10)	NÃO
3	LOCAL.CNPJ	A1_CGC	CARACTERE(20)	NÃO
4	LOCAL.CODIGOERP	A1_COD + ‘#’ + A1_LOJA + '#' + 'ENT'	CARACTERE(80)	SIM
5	LOCAL.COMPLEMENTO	A1_COMPLEM	CARACTERE(80)	NÃO
6	LOCAL.DATACADASTRO	CURRENT_DATE	DATE	SIM
7	LOCAL.DATAULTIMAATUALIZACAO	CURRENT_DATE	DATE	SIM
8	LOCAL.DESCRICAO	A1_LOJA + ’ - ’ + A1_ENDENT + ’ - ’ + A1_BAIRROE + ’ - ’ + CIDADE.DESCRICAO	CARACTERE(200)	NÃO
9	LOCAL.DOCUMENTOIDENTIFICACAO	A1_RG	CARACTERE(80)	NÃO
10	LOCAL.IDCIDADE	A1_COD_MUN + ’#‘ + A1_EST	INTEIRO(8)	SIM
11	LOCAL.IDNATIVO	CASE WHEN A1_MSBLQL = '1' THEN 0 ELSE 1 END	INTEIRO(2)	SIM
12	LOCAL.IDNEXPORTADOERP	FIXO 0	INTEIRO(2)	SIM
13	LOCAL.IDNIPI	FIXO 0	INTEIRO(2)	NÃO
14	LOCAL.IDNREQUERDATAENTREGA	FIXO 0	INTEIRO(2)	NÃO
15	LOCAL.IDNREQUERNUMEROPEDIDOCLIENTE	FIXO 0	INTEIRO(2)	NÃO
16	LOCAL.IDUNIDADEFEDERATIVAFISCAL	A1_EST	INTEIRO(8)	NÃO
17	LOCAL.INSCRICAOESTADUAL	A1_INSCR	CARACTERE(40)	NÃO
18	LOCAL.INSCRICAOMUNICIPAL	SE A1_INSCRM END A1_INSCRM OR SE A1_PFISICA END A1_INSCRM OR SE A1_INSCRUR END A1_INSCRUR OR SE A1_RG END A1_RG	CARACTERE(40)	NÃO
19	LOCAL.LIMITESUGERIDO	A1_LC	NUMERIC	NÃO
20	LOCAL.LOGRADOURO	A1_ENDENT	CARACTERE(80)	NÃO
21	LOCAL.NUMEROMATRICULA	A1_COD	CARACTERE(20)	NÃO
22	LOCAL.OBSERVACAO	A1_OBSERV	CARACTERE(4000)	NÃO

CADASTRO DO TIPO DO LOCAL DE COBRANÇA DO PARCEIRO (Tabela LOCALTIPOLOCAL)

Retorna o cadastro do tipo do local de cobrança do parceiro no Protheus na tabela SA1.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	LOCALTIPOLOCAL.CODIGOERP	A1_COD + ’#’ + A1_LOJA + ’#’ + ‘COB’	CARACTERE(80)	SIM
2	LOCALTIPOLOCAL.IDLOCAL	A1_COD + ’#’ + A1_LOJA + ’#’ + ‘COB’	INTEIRO(8)	NÃO
3	LOCALTIPOLOCAL.IDNATIVO	CASE WHEN A1_MSBLQL = '1' THEN 0 ELSE 1 END	INTEIRO(2)	NÃO
4	LOCALTIPOLOCAL.IDNEXPORTADOERP	FIXO 1	INTEIRO(2)	SIM
5	LOCALTIPOLOCAL.IDNPADRAO	FIXO 0	INTEIRO(2)	NÃO
6	LOCALTIPOLOCAL.IDNPADRAO	FIXO ‘COB’	INTEIRO(8)	NÃO

CADASTRO DO LOCAL DE COBRANÇA DO PARCEIRO (Tabela PARCEIROLOCAL/LOCALTIPOLOCAL)

Retorna o cadastro do local de cobrança do parceiro no Protheus na tabela SA1.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	PARCEIROLOCAL.CODIGOERP	A1_COD + ’#’ + A1_LOJA + ’#’ + ‘COB’	CARACTERE(80)	SIM
2	PARCEIROLOCAL.IDLOCAL	A1_COD + ’#’ + A1_LOJA + ’#’ + ‘COB’	INTEIRO(8)	NÃO
3	PARCEIROLOCAL.IDNEXPORTADOERP	FIXO 1	INTEIRO(2)	SIM
4	PARCEIROLOCAL.IDPARCEIRO	A1_COD + ’#’ + A1_LOJA	INTEIRO(8)	NÃO
5	LOCALTIPOLOCAL.IDTIPOLOCAL	FIXO ‘COB’	INTEIRO(8)	NÃO
6	LOCALTIPOLOCAL.IDTIPOLOCAL	FIXO ‘COB’	INTEIRO(8)	NÃO

CADASTRO DO TIPO DO LOCAL DE ENTREGA DO PARCEIRO (Tabela LOCALTIPOLOCAL)

Retorna o cadastro do tipo do local de entrega do parceiro no Protheus na tabela SA1.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM |SFA	Obrigatório
1	LOCALTIPOLOCAL.CODIGOERP	A1_COD + ‘#’ + A1_LOJA + ‘#’ + ‘ENT’	CARACTERE(80)	SIM
2	LOCALTIPOLOCAL.IDLOCAL	A1_COD + ‘#’ + A1_LOJA + ‘#’ + ‘ENT’	INTEIRO(8)	NÃO
3	3 LOCALTIPOLOCAL.IDNATIVO	CASE WHEN A1_MSBLQL = '1' THEN 0 ELSE 1 END	INTEIRO(2)	NÃO
4	LOCALTIPOLOCAL.IDNEXPORTADOERP	FIXO 1	INTEIRO(2)	SIM
5	LOCALTIPOLOCAL.IDNPADRAO	FIXO 0	INTEIRO(2)	NÃO
6	LOCALTIPOLOCAL.IDTIPOLOCAL	FIXO ‘ENT’	INTEIRO(8)	NÃO

CADASTRO DO LOCAL DE ENTREGA DO PARCEIRO (Tabela PARCEIROLOCAL/LOCALTIPOLOCAL)

Retorna o cadastro do local de entrega do parceiro no Protheus na tabela SA1. 

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM |SFA	Obrigatório
1	PARCEIROLOCAL.CODIGOERP	A1_COD + ‘#’ + A1_LOJA + ‘#’ + ‘ENT’	CARACTERE(80) S	SIM
2	PARCEIROLOCAL.IDLOCAL	A1_COD + ‘#’ + A1_LOJA + ‘#’ + ‘ENT’	INTEIRO(8)	NÃO
3	PARCEIROLOCAL.IDNEXPORTADOERP	FIXO 1	INTEIRO(2)	SIM
4	PARCEIROLOCAL.IDPARCEIRO	A1_COD + ’#’ + A1_LOJA I	INTEIRO(8)	NÃO
5	LOCALTIPOLOCAL.IDTIPOLOCAL	FIXO ‘ENT’	INTEIRO(8)	NÃO
6	LOCALTIPOLOCAL.IDTIPOLOCAL	FIXO ‘ENT’	INTEIRO(8)	NÃO

CADASTRO DO TIPO DO LOCAL PRINCIPAL DO PARCEIRO (Tabela LOCALTIPOLOCAL)

Retorna o cadastro do tipo do local principal do parceiro no Protheus na tabela SA1. 

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM |SFA	Obrigatório
1	LOCALTIPOLOCAL.CODIGOERP	A1_COD + ’#’ + A1_LOJA + ’#’ + PRI	CARACTERE(80)	SIM
2	LOCALTIPOLOCAL.IDLOCAL	A1_COD + ’#’ + A1_LOJA + ’#’ + PRI	INTEIRO(8)	NÃO
3	LOCALTIPOLOCAL.IDNATIVO	CASE WHEN A1_MSBLQL = '1' THEN 0 ELSE 1 END	INTEIRO(2)	NÃO
4	LOCALTIPOLOCAL.IDNEXPORTADOERP	FIXO 1	INTEIRO(2)	SIM
5	LOCALTIPOLOCAL.IDNPADRAO	FIXO 1	INTEIRO(2)	NÃO
6	LOCALTIPOLOCAL.IDTIPOLOCAL	FIXO ‘PRI’	INTEIRO(8)	NÃO

CADASTRO DO LOCAL PRINCIPAL DO PARCEIRO (Tabela PARCEIROLOCAL)

Retorna o cadastro do local principal do parceiro no Protheus na tabela SA1.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	PARCEIROLOCAL.CODIGOERP	A1_COD + ’#’ + A1_LOJA + ’#’ + PRI	CARACTERE(80)	SIM
2	PARCEIROLOCAL.IDLOCAL	A1_COD + ’#’ + A1_LOJA + ’#’ + PRI	INTEIRO(8)	NÃO
3	PARCEIROLOCAL.IDNEXPORTADOERP	FIXO 1	INTEIRO(2)	SIM
4	PARCEIROLOCAL.IDPARCEIRO	A1_COD + ’#’ + A1_LOJA	INTEIRO(8)	NÃO

CADASTRO DE PESSOA FÍSICA DO PARCEIRO (Tabela PESSOAFISICA)

Retorna o cadastro de pessoa física do parceiro do Protheus na tabela SA1.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	PESSOAFISICA.ANONASCIMENTO	A1_DTNASC	INTEIRO(8)	NÃO
2	PESSOAFISICA.CODIGOERP	A1_COD + ’#’ + A1_LOJA	CARACTERE(80)	SIM
3	PESSOAFISICA.CPF	A1_CGC	CARACTERE(14)	NÃO
4	PESSOAFISICA.DIANASCIMENTO	A1_DTNASC	INTEIRO(8)	NÃO
5	PESSOAFISICA.DOCUMENTOIDENTIFICACAO	A1_CGC	CARACTERE(80)	NÃO
6	PESSOAFISICA.IDNEXPORTADOERP	FIXO 1	INTEIRO(2)	NÃO
7	PESSOAFISICA.IDPAISNACIONALIDADE	A1_PAIS	INTEIRO(8)	NÃO
8	PESSOAFISICA.IDTIPOIDENTIFICACAO	FIXO ‘CPF’	INTEIRO(8)	NÃO
9	PESSOAFISICA.MESNASCIMENTO	A1_DTNASC	INTEIRO(2)	NÃO
10	PESSOAFISICA.ISPESSOAFISICA	A1_COD + ’#’ + A1_LOJA	INTEIRO(8)	NÃO

CADASTRO DE PESSOA JURÍDICA DO PARCEIRO (Tabela PESSOAJURIDICA)

Retorna o cadastro de pessoa jurídica do parceiro do Protheus na tabela SA1.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	PESSOAJURIDICA.CNPJPRINCIPAL	A1_CGC	CARACTERE(20)	NÃO
2	PESSOAJURIDICA.CODIGOERP	A1_COD + ’#’ + A1_LOJA	CARACTERE(80)	NÃO
3	PESSOAJURIDICA.DATAFUNDACAO	A1_DTNASC	DATE	NÃO
4	PESSOAJURIDICA.DOCUMENTOIDENTIFICACAO	A1_CGC	CARACTERE(80)	NÃO
5	PESSOAJURIDICA.IDNEXPORTADOERP	FIXO 1	INTEIRO(2)	SIM
6	PESSOAJURIDICA.IDPESSOAJURIDICA	A1_COD + ’#’ + A1_LOJA	INTEIRO(8)	NÃO
7	PESSOAJURIDICA.IDTIPOIDENTIFICACAO	FIXO ‘CNPJ’	INTEIRO(8)	NÃO

CADASTRO DO EMAIL DO PARCEIRO (Tabela LOCALEMAIL)

Retorna o cadastro do e-mail do parceiro vinculado ao local no Protheus na tabela SA1. 

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	LOCALEMAIL.CODIGOERP	A1_COD + ’#’ + A1_LOJA	CARACTERE(80)	SIM
2	LOCALEMAIL.EMAIL	A1_EMAIL	CARACTERE(80)	NÃO
3	LOCALEMAIL.IDLOCAL	A1_COD + ’#’ + A1_LOJA + ’#’ + PRI	INTEIRO(8)	NÃO
4	LOCALEMAIL.IDNEXPORTADOERP	FIXO 1	INTEIRO(2)	SIM
5	LOCALEMAIL.IDNPADRAO	FIXO 1	INTEIRO(2)	SIM
6	LOCALEMAIL.IDPARCEIRO	A1_COD + ’#’ + A1_LOJA	INTEIRO(8)	NÃO

CADASTRO DO TELEFONE DO PARCEIRO (Tabela LOCALTELEFONE)

Retorna o cadastro do telefone do parceiro vinculado ao local do Protheus na tabela SA1.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM |SFA	Obrigatório
1	LOCALTELEFONE.CODIGOERP	A1_COD + ’#’ + A1_LOJA + ’#’ + ‘TEL’ OR ‘FAX’ OR ‘LEX’	CARACTERE(80)	SIM
2	LOCALTELEFONE.IDLOCAL	A1_COD + ’#’ + A1_LOJA + ’#’ + PRI	INTEIRO(8)	NÃO
3	LOCALTELEFONE.IDNEXPORTADOERP	FIXO 1	INTEIRO(2)	SIM
4	LOCALTELEFONE.IDNPADRAO	1 OR 0	INTEIRO(2)	SIM
5	LOCALTELEFONE.IDPARCEIRO	A1_COD + ’#’ + A1_LOJA	INTEIRO(8)	NÃO
6	LOCALTELEFONE.TELEFONE	A1_TEL OR A1_FAX OR A1_TELEX	CARACTERE(40)	NÃO

CADASTRO DA FILIAL DO PARCEIRO (Tabela LOCALFILIAL)

Retorna o cadastro da filial do parceiro vinculado ao local no Protheus na tabela SA1.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	LOCALFILIAL.CODIGOERP	A1_COD + ’#’ + A1_LOJA	CARACTERE(80)	SIM
2	LOCALFILIAL.IDFILIAL	A1_FILIAL + ’#’ + ’PRI’	INTEIRO(8)	NÃO
3	LOCALFILIAL.IDLOCAL	A1_COD + ’#’ + A1_LOJA + ’#’ + PRI	INTEIRO(8)	NÃO
4	LOCALFILIAL.IDNPADRAO	FIXO 1	INTEIRO(2)	SIM
5	LOCALFILIAL.SGLTIPOFILIAL	FIXO ‘PRI’	CARACTERE(20)	NÃO

CADASTRO DE LIMITE DE CRÉDITO DO PARCEIRO (Tabela LIMITECREDITO)

Retorna o cadastro de limite de crédito do parceiro do Protheus na tabela SA1.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	1 LIMITECREDITO.CODIGOERP	A1_COD + ’#’ + A1_LOJA	CARACTERE(80)	SIM
2	LIMITECREDITO.DATAFIMVIGENCIA	A1_VENCLC	DATE	SIM
3	LIMITECREDITO.DATAINICIOVIGENCIA	FIXO ‘1900-12-31’	DATE	SIM
4	LIMITECREDITO.IDLOCAL	A1_COD + ’#’ + A1_LOJA + ’#’ + PRI	INTEIRO(8)	NÃO
5	LIMITECREDITO.IDPARCEIRO	A1_COD + ’#’ + A1_LOJA	INTEIRO(8)	SIM
6	LIMITECREDITO.IDTIPOLIMITECREDITO	FIXO 'LCP’	INTEIRO(8)	NÃO
7	LIMITECREDITO.SALDODISPONIVEL	A1_LC	NUMERIC	NÃO
8	LIMITECREDITO.SALDOLIMITE	A1_LC	NUMERIC	NÃO

CADASTRO DO TIPO DE PARCEIRO (Tabela PARCEIROTIPOPARCEIRO)

Retorna o cadastro do tipo do parceiro do Protheus na tabela SA1.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	PARCEIROTIPOPARCEIRO.CODIGOERP	A1_COD + ’#’ + A1_LOJA	CARACTERE(80)	SIM
2	PARCEIROTIPOPARCEIRO.IDPARCEIRO	A1_COD + ’#’ + A1_LOJA	INTEIRO(8)	SIM
3	PARCEIROTIPOPARCEIRO.IDTIPOPARCEIRO	FIXO ‘CLI’	INTEIRO(8)	SIM

CADASTRO DA CONDIÇÃO DE PAGAMENTO DO PARCEIRO (Tabela LOCALCONDICAOPAGAMENTO)

Retorna o cadastro da condição de pagamento do parceiro vinculado ao local do Protheus na tabela SA1.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM |SFA	Obrigatório
1	LOCALCONDICAOPAGAMENTO.CODIGOERP	A1_COD + ’#’ + A1_LOJA	CARACTERE(80)	SIM
2	LOCALCONDICAOPAGAMENTO.IDCONDICAOPAGAMENTO	A1_COND	INTEIRO(8)	SIM
3	LOCALCONDICAOPAGAMENTO.IDLOCAL	A1_COD + ’#’ + A1_LOJA’ + PRI	INTEIRO(8)	NÃO
4	LOCALCONDICAOPAGAMENTO.IDNPADRAO	FIXO 1	INTEIRO(2)	SIM
5	LOCALCONDICAOPAGAMENTO.IDNREGRAESPECIAL	FIXO 0	INTEIRO(2)	NÃO
6	LOCALCONDICAOPAGAMENTO.IDPARCEIRO	A1_COD + ’#’ + A1_LOJA	INTEIRO(8)	NÃO

CADASTRO DO USUÁRIO DO PARCEIRO (Tabela USUARIOLOCAL)

Retorna o cadastro do usuário do parceiro vinculado ao local do Protheus na tabela SA1.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	USUARIOLOCAL.CODIGOERP	A1_COD + ’#’ + A1_LOJA	CARACTERE(80)	SIM
2	USUARIOLOCAL.IDLOCAL	A1_COD + ’#’ + A1_LOJA + ’#’ + PRI I	INTEIRO(8)	SIM
3	USUARIOLOCAL.IDPARCEIRO	A1_COD + ’#’ + A1_LOJA	INTEIRO(8)	NÃO
4	USUARIOLOCAL.IDUSUARIO	A1_VEND	INTEIRO(8)	SIM

CADASTRO DA IDENTIFICAÇÃO DO LOCAL DO PARCEIRO (Tabela LOCALIDENTIFICACAO)

Retorna o cadastro da identificação do local do parceiro no Protheus na tabela SA1.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	LOCALIDENTIFICACAO.CODIGOERP	LOCAL.CODIGOERP	CARACTERE(80)	SIM
2	LOCALIDENTIFICACAO.DOCUMENTOIDENTIFICACAO	PESSOAJURIDICA.CNPJPRINCIPAL	CARACTERE(80)	NÃO
3	LOCALIDENTIFICACAO.IDLOCAL	LOCAL.IDLOCAL	INTEIRO(8)	SIM
4	LOCALIDENTIFICACAO.IDNEXPORTADOERP	PARCEIRO.IDNEXPORTADOERP	INTEIRO(2)	SIM
5	LOCALIDENTIFICACAO.IDTIPOIDENTIFICACAO	FIXO ‘CNPJ’	INTEIRO(8)	SIM

CADASTRO DO LOCAL DO TIPO DE COBRANÇA DO PARCEIRO (Tabela LOCALTIPOCOBRANCA)

Retorna o cadastro do tipo de cobrança do parceiro vinculado ao local do Protheus na tabela SA1.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	LOCALTIPOCOBRANCA.CODIGOERP	A1_COD + ’#’ + A1_LOJA	CARACTERE(80)	SIM
2	LOCALTIPOCOBRANCA.IDLOCAL	A1_COD + ’#’ + A1_LOJA + ’#’ + PRI	INTEIRO(8)	NÃO
3	LOCALTIPOCOBRANCA.IDNPADRAO	FIXO 1	INTEIRO(2)	SIM
4	LOCALTIPOCOBRANCA.IDTIPOCOBRANCA	A1_TFORMPG	INTEIRO(8)	SIM

CADASTRO DO PARCEIRO TRANSPORTADOR (Tabela PARCEIROTRANSPORTADOR)

Retorna o cadastro do parceiro transportador do Protheus na tabela SA1.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM |SFA	Obrigatório
1	PARCEIROTRANSPORTADOR.CODIGOERP	A1_COD + ’#’ + A1_TRANSP + ‘#’ + A1_TRANSP + ’#’ + ‘TRA’	CARACTERE(80)	SIM
2	PARCEIROTRANSPORTADOR.IDNPADRAO	FIXO '1’	INTEIRO(2)	SIM
3	PARCEIROTRANSPORTADOR.IDPARCEIRO	A1_COD + ’#’ + A1_LOJA	INTEIRO(8)	SIM
4	PARCEIROTRANSPORTADOR.IDTRANSPORTADOR	A1_TRANSP + ‘#’ + ‘TRA’	INTEIRO(8)	SIM

CADASTRO DO LOCAL DA REGIÃO DO PARCEIRO (Tabela LOCALREGIAO)

Retorna o cadastro da região do parceiro vinculado ao local do Protheus na tabela SA1. 

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	LOCALREGIAO.CODIGOERP	A1_COD + ’#’ + A1_LOJA	CARACTERE(80)	SIM
2	LOCALREGIAO.IDLOCAL	A1_COD + ’#’ + A1_LOJA + ’#’ + PRI	INTEIRO(8)	SIM
3	LOCALREGIAO.IDREGIAO	A1_REGIAO	INTEIRO(8)	SIM

CADASTRO DO LOCAL SEGMENTO DO PARCEIRO (Tabela LOCALSEGMENTO)

Retorna o cadastro do segmento do parceiro vinculado ao local do Protheus na tabela SA1.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM |SFA	Obrigatório
1	LOCALSEGMENTO.CODIGOERP	A1_COD + ’#’ + A1_LOJA + ’#’ + PRI + ’#’ + ‘ID_SEGMENTO’ + ’#’ + ORDEM	CARACTERE(80)	SIM
2	LOCALSEGMENTO.IDLOCAL	A1_COD + ’#’ + A1_LOJA + ’#’ + PRI	INTEIRO(8)	NÃO
3	LOCALSEGMENTO.IDNPADRAO	0 OR 1	INTEIRO(2)	SIM
4	LOCALSEGMENTO.IDPARCEIRO	A1_COD + ’#’ + A1_LOJA	INTEIRO(8)	NÃO
5	LOCALSEGMENTO.IDSEGMENTO	A1_SATIV1 OR A1_SATIV2 OR A1_SATIV3 OR A1_SATIV4 OR A1_SATIV5 OR A1_SATIV6 OR A1_SATIV7 OR A1_SATIV8	INTEIRO(8)	NÃO

CADASTRO DO TIPO DO PRODUTO (Tabela TIPOPRODUTO)

Retorna o cadastro do tipo do produto do Protheus na tabela SX5 quando X5_TABELA = '02'.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	TIPOPRODUTO.CODIGOERP	X5_CHAVE	CARACTERE(80)	SIM
2	TIPOPRODUTO.DESCRICAO	X5_DESCR	CARACTERE(80)	SIM
3	TIPOPRODUTO.IDNATIVO	FIXO 1	INTEIRO(2)	SIM
4	TIPOPRODUTO.SGLTIPOPRODUTO	X5_CHAVE	CARACTERE(10)	NÃO

CADASTRO DO GRUPO DO PRODUTO (Tabela GRUPOPRODUTO)

Retorna o cadastro do grupo do produto do Protheus na tabela SBM. 

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	GRUPOPRODUTO.CODIGO	BM_GRUPO	CARACTERE(80)	NÃO
2	GRUPOPRODUTO.CODIGOERP	BM_GRUPO	CARACTERE(80)	SIM
3	GRUPOPRODUTO.DESCRICAO	BM_DESC	CARACTERE(80)	SIM
4	GRUPOPRODUTO.IDNATIVO	FIXO 1	INTEIRO(2)	SIM

CADASTRO DA UNIDADE DE MEDIDA (Tabela UNIDADEMEDIDA)

Retorna o cadastro da unidade de medida do Protheus na tabela SAH.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	UNIDADEMEDIDA.CODIGO	AH_UNIMED	CARACTERE(20)	NÃO
2	UNIDADEMEDIDA.CODIGOERP	AH_UNIMED	CARACTERE(80)	SIM
3	UNIDADEMEDIDA.DESCRICAO	AH_DESCPO	CARACTERE(80)	SIM
4	UNIDADEMEDIDA.IDNATIVO	FIXO 1	INTEIRO(2)	SIM
5	UNIDADEMEDIDA.IDNDISPONIVELPARACOTA	FIXO 0	INTEIRO(2)	SIM
6	UNIDADEMEDIDA.SGLTIPOUNIDADEMEDIDA	AH_UNIMED	CARACTERE(10)	SIM
7	UNIDADEMEDIDA.SGLUNIDADEMEDIDA	AH_UNIMED	CARACTERE(10)	SIM

CADASTRO DA EMBALAGEM (Tabela EMBALAGEM)

Retorna o cadastro da embalagem do Protheus na tabela SAH.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	EMBALAGEM.CODIGO	AH_UNIMED	CARACTERE(20)	NÃO
2	EMBALAGEM.CODIGOERP	AH_UNIMED	CARACTERE(80)	SIM
3	EMBALAGEM.DESCRICAO	AH_DESCPO	CARACTERE(80)	NÃO
4	EMBALAGEM.IDNATIVO	FIXO 1	INTEIRO(2)	NÃO
5	EMBALAGEM.IDUNIDADEMEDIDA	AH_UNIMED	INTEIRO(8)	NÃO
6	EMBALAGEM.SGLEMBALAGEM	AH_UNIMED	CARACTERE(10)	NÃO

CADASTRO DO PRODUTO (Tabela PRODUTO)

Retorna o cadastro do produto do Protheus na tabela SB1. 

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	PRODUTO.CODIGO	B1_COD	CARACTERE(20)	NÃO
2	PRODUTO.CODIGOADICIONAL	MAX(B1_ALTER)	CARACTERE(20)	NÃO
3	PRODUTO.CODIGODEBARRA	MAX(B1_CODBAR)	CARACTERE(40)	NÃO
4	PRODUTO.CODIGOERP	B1_COD	CARACTERE(80)	SIM
5	PRODUTO.DESCRICAO	MAX(B1_DESC)	CARACTERE(80)	SIM
6	PRODUTO.IDGRUPOPRODUTO	MAX(B1_GRUPO)	INTEIRO(8)	NÃO
7	PRODUTO.IDNATIVO	B1_MSBLQL	INTEIRO(2)	SIM
8	PRODUTO.IDNLANCAMENTO	FIXO 0	INTEIRO(2)	NÃO
9	PRODUTO.IDNPERMITEDEVOLUCAO	FIXO 0	INTEIRO(2)	NÃO
10	PRODUTO.IDNPERMITEVENDAFRACIONADA	FIXO 0	INTEIRO(2)	NÃO
11	PRODUTO.IDNREQUERQTDMULTIPLA	FIXO 0	INTEIRO(2)	NÃO
12	PRODUTO.IDNSERVICO	FIXO 0	INTEIRO(2)	SIM
13	PRODUTO.IDNUTILIZACOTA	FIXO 0	INTEIRO(2)	NÃO
14	PRODUTO.IDUNIDADEMEDIDAPADRAO	MAX(B1_UM)	INTEIRO(8)	NÃO
15	PRODUTO.IDUNIDADEMEDIDAVENDA	MAX(B1_UM)	INTEIRO(8)	NÃO
16	PRODUTO.PESOMAXIMO	MAX(B1_PESBRU)	NUMERIC	NÃO
17	PRODUTO.PESOMEDIO	MAX(B1_PESO)	NUMERIC	NÃO
18	PRODUTO.PESOMINIMO	MAX(B1_PESO)	NUMERIC	NÃO
19	PRODUTO.PRECOCUSTO	B1_CUSTD	NUMERIC	NÃO
20	PRODUTO.QTDEMAXIMAVENDA	FIXO 999999999	NUMERIC	NÃO
21	PRODUTO.QUANTIDADEAPRESENTACAO	MAX(B1_QE)	NUMERIC	NÃO

CADASTRO DA EMBALAGEM PADRÃO DO PRODUTO (Tabela PRODUTOEMBALAGEM)

Retorna o cadastro da embalagem padrão do produto do Protheus na tabela SB1.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	PRODUTOEMBALAGEM.CODIGOERP	B1_COD + ‘#’ + B1_UM + ‘#’ + 1	CARACTERE(80)	SIM
2	PRODUTOEMBALAGEM.FATOREMBALAGEM	MAX(B1_CONV)	NUMERIC	NÃO
3	PRODUTOEMBALAGEM.FATOREMBALAGEMPADRAO	MAX(B1_CONV)	NUMERIC	NÃO
4	PRODUTOEMBALAGEM.IDEMBALAGEM	B1_UM	INTEIRO(8)	NÃO
5	PRODUTOEMBALAGEM.IDNATIVO	FIXO 1	INTEIRO(2)	SIM
6	PRODUTOEMBALAGEM.IDNEXIBEEMBALAGEM		INTEIRO(2)	NÃO
7	PRODUTOEMBALAGEM.IDNPADRAO	FIXO 0	INTEIRO(2)	NÃO
8	PRODUTOEMBALAGEM.IDPRODUTO	B1_COD	INTEIRO(8)	NÃO

CADASTRO DA EMBALAGEM SECUNDÁRIA DO PRODUTO (Tabela PRODUTOEMBALAGEM)

Retorna o cadastro da embalagem secundária do produto do Protheus na tabela SB1. 

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	PRODUTOEMBALAGEM.CODIGOERP	B1_COD + ‘#’ + B1_SEGUM + ‘#’ + 0	CARACTERE(80)	SIM
2	PRODUTOEMBALAGEM.FATOREMBALAGEM	MAX(CASE WHEN B1_TIPCONV = 'D' THEN 0 ELSE 1 END)	NUMERIC	NÃO
3	PRODUTOEMBALAGEM.FATOREMBALAGEMPADRAO	MAX(CASE WHEN B1_CONV IS NULL OR B1_CONV = 0 THEN 1 ELSE B1_CONV END)	NUMERIC	NÃO
4	PRODUTOEMBALAGEM.IDEMBALAGEM	B1_SEGUM	INTEIRO(8)	NÃO
5	PRODUTOEMBALAGEM.IDNATIVO	FIXO 1	INTEIRO(2)	SIM
6	PRODUTOEMBALAGEM.IDNEXIBEEMBALAGEM		INTEIRO(2)	NÃO
7	PRODUTOEMBALAGEM.IDNPADRAO	FIXO 0	INTEIRO(2)	NÃO
8	PRODUTOEMBALAGEM.IDPRODUTO	B1_COD	INTEIRO(8)	NÃO

CADASTRO DA FILIAL DO PRODUTO (Tabela PRODUTOFILIAL)

Retorna o cadastro do produto vinculado a filial no Protheus na tabela SB1.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	PRODUTOFILIAL.CODIGOERP	B1_COD + ‘#’ + B1_FILIAL	CARACTERE(80)	SIM
2	PRODUTOFILIAL.IDLOCALFILIAL	B1_FILIAL + ‘#’ + ‘EMP’	INTEIRO(8)	NÃO
3	PRODUTOFILIAL.IDNPADRAO	FIXO 0	INTEIRO(2)	SIM
4	PRODUTOFILIAL.IDPRODUTO	B1_COD	INTEIRO(8)	NÃO

CADASTRO DO TIPO DO PRODUTO (Tabela PRODUTOTIPOPRODUTO)

Retorna o cadastro do tipo do produto do Protheus na tabela SB1.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	PRODUTOTIPOPRODUTO.CODIGOERP	B1_COD + ‘#’ + B1_TIPO	CARACTERE(80)	SIM
2	PRODUTOTIPOPRODUTO.IDPRODUTO	B1_COD	INTEIRO(8)	NÃO
3	PRODUTOTIPOPRODUTO.IDTIPOPRODUTO	B1_TIPO	INTEIRO(8)	SIM

CADASTRO DO ESTOQUE (Tabela ESTOQUE)

Retorna o cadastro do estoque do Protheus na tabela SB2.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	ESTOQUE.CODIGOERP	B2_COD + ‘#’ + B2_FILIAL	CARACTERE(80)	SIM
2	ESTOQUE.DATAPOSICAO	CURRENT_DATE	DATE	NÃO
3	ESTOQUE.HORAPOSICAO	CURRENT_DATE	CARACTERE(8)	SIM
4	ESTOQUE.IDLOCALFILIAL	B1_FILIAL + ‘#’ + ‘EMP’	INTEIRO(8)	NÃO
5	ESTOQUE.IDPRODUTO	B2_COD	INTEIRO(8)	NÃO
6	ESTOQUE.IDTIPOESTOQUE	FIXO EDI	INTEIRO(8)	SIM
7	ESTOQUE.PESOMEDIO	B2_QTSEGUM	NUMERIC	NÃO
8	ESTOQUE.QUANTIDADE	B2_QATU - (B2_QEMP + B2_RESERVA + B2_QPEDVEN)	NUMERIC	SIM

CADASTRO DA TABELA DE PREÇO (Tabela TABELAPRECO)

Retorna o cadastro da tabela de preço do Protheus na tabela DA0. 

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	TABELAPRECO.CODIGO	DA0_CODTAB	CARACTERE(20)	NÃO
2	TABELAPRECO.CODIGOERP	DA0_CODTAB	CARACTERE(80)	SIM
3	TABELAPRECO.DATAFIMVIGENCIA	DA0_DATATE	DATE	NÃO
4	TABELAPRECO.DATAINICIOVIGENCIA	DA0_DATDE	DATE	NÃO
5	TABELAPRECO.DESCRICAO	DA0_DESCRI	CARACTERE(80)	SIM
6	TABELAPRECO.IDNATIVO	FIXO 1	INTEIRO(2)	SIM
7	TABELAPRECO.IDNCALCULOANTECIPACAO	FIXO 0	INTEIRO(2)	SIM
8	TABELAPRECO.IDNDISPPRIMEIROPEDIDO	FIXO 0	INTEIRO(2)	SIM

CADASTRO DA TABELA DE PREÇO DO PRODUTO (Tablea TABELAPRECOPRODUTO)

Retorna o cadastro da tabela de preço do produto do Protheus na tabela DA1.

	TOTVS CRM |SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	TABELAPRECOPRODUTO.CODIGOERP	DA1_CODTAB + ‘#’ + DA1_CODPRO + ‘#’ + DA1_FILIAL + ‘#’ + DA1_GRUPO + ‘#’ + DA1_ITEM	CARACTERE(80)	SIM
2	TABELAPRECOPRODUTO.DATAFIMVIGENCIA	FIXO '2099-01-01'	DATE	NÃO
3	TABELAPRECOPRODUTO.DATAINICIOVIGENCIA	MAX(DA1_DATVIG)	DATE	NÃO
4	TABELAPRECOPRODUTO.DESCONTO	DA1_VLRDES	NUMERIC	NÃO
5	TABELAPRECOPRODUTO.IDGRUPOPRODUTO	DA1_GRUPO	INTEIRO(8)	NÃO
6	TABELAPRECOPRODUTO.IDLOCALFILIAL	DA1_FILIAL + ‘’#’ + ‘EMP	INTEIRO(8)	NÃO
7	TABELAPRECOPRODUTO.IDNCALCULOANTECIPACAO	FIXO 0	INTEIRO(2)	NÃO
8	TABELAPRECOPRODUTO.IDNPRECOFIXO	FIXO 0	INTEIRO(2)	SIM
9	TABELAPRECOPRODUTO.IDNUTILIZALOTE	FIXO 0	INTEIRO(2)	SIM
10	TABELAPRECOPRODUTO.IDPRODUTO	DA1_CODPRO	INTEIRO(8)	NÃO
11	TABELAPRECOPRODUTO.IDTABELAPRECO	DA1_CODTAB	INTEIRO(8)	NÃO
12	TABELAPRECOPRODUTO.IDUNIDADEFEDERATIVA	DA1_ESTADO	INTEIRO(8)	NÃO
13	TABELAPRECOPRODUTO.PRECO	DA1_PRCVEN	NUMERIC	NÃO
14	TABELAPRECOPRODUTO.PRECOMAXIMO	CASE WHEN DA1_PRCMAX = 0 THEN 999999 ELSE DA1_PRCMAX END	NUMERIC	NÃO
15	TABELAPRECOPRODUTO.PRECOMINIMO	FIXO 0	NUMERIC	NÃO
16	TABELAPRECOPRODUTO.PRECOCUSTO	B1_CUSTD	NUMERIC	NÃO

CADASTRO DO LOCAL DA TABELA DE PREÇO (Tabela LOCALTABELAPRECO)

RETORNA O CADASTRO DA TABELA DE PREÇO VINCULADO AO LOCAL NO PROTHEUS NA TABELA SA1.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM |SFA	Obrigatório
1	LOCALTABELAPRECO.CODIGOERP	A1_COD + ‘#’ + A1_LOJA + ‘#’ + A1_TABELA	CARACTERE(80)	SIM
2	LOCALTABELAPRECO.IDNPADRAO	FIXO 1	INTEIRO(2)	SIM
3	LOCALTABELAPRECO.IDNPADRAO	A1_COD + ‘#’ + A1_LOJA	INTEIRO(8)	NÃO
4	LOCALTABELAPRECO.IDTABELAPRECO	A1_TABELA	INTEIRO(8)	SIM
5	TABELAPRECO.IDNDISPPRIMEIROPEDIDO	FIXO 0	INTEIRO(2)	SIM

CADASTRO DO PEDIDO (Tabela PEDIDO)

Retorna o cadastro do pedido do Protheus na tabela SC5.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM| SFA	Obrigatório
1	PEDIDO.CODIGOERP	C5_FILIAL + ‘#’ + C5_NUM	CARACTERE(80)	SIM
2	PEDIDO.DATAPEDIDO	CAST(CONVERT(DATE,C5_EMISSAO,120) AS VARCHAR)	DATE	SIM
3	PEDIDO.DATATRANSMISSAO	CURRENT_DATE	DATE	NÃO
4	PEDIDO.HORATRANSMISSAO	CURRENT_DATE	CARACTERE(8)	NÃO
5	PEDIDO.IDCONDICAOPAGAMENTO	C5_CONDPAG	INTEIRO(8)	NÃO
6	PEDIDO.IDLOCAL	C5_CLIENTE + ‘#’ + C5_LOJACLI + ‘#’ + ‘PRI’	INTEIRO(8)	SIM
7	PEDIDO.IDLOCALFILIALFATURAMENTO	'EMP’ + ‘#’ + C5_FILIAL	INTEIRO(8)	NÃO
8	PEDIDO.IDLOCALFILIALVENDA	'EMP’ + ‘#’ + C5_FILIAL	INTEIRO(8)	NÃO
9	PEDIDO.IDNEXPORTADOERP	FIXO 1	INTEIRO(2)	SIM
10	PEDIDO.IDNPEDIDOLIDO	FIXO 1	INTEIRO(2)	NÃO
11	PEDIDO.IDPARCEIRO	C5_CLIENTE + ‘#’ + C5_LOJACLI	INTEIRO(8)	SIM
12	PEDIDO.IDTABELAPRECO	C5_TABELA	INTEIRO(8)	NÃO
13	PEDIDO.IDTIPOSITUACAOPEDIDO	CASE WHEN LTRIM(RTRIM(C5_NOTA)) != '' THEN 'PF' ELSE 'PA' END	INTEIRO(8)	SIM
14	PEDIDO.IDUSUARIO	SE (C5_VEND1 != "" && C5_VEND1 != null)ENTAO C5_VEND1 SENAO “UNC”	INTEIRO(8)	SIM
15	PEDIDO.IDUSUARIOPROFISSIONAL	SE (C5_VEND1 != "" && C5_VEND1 != null)ENTAO C5_VEND1 SENAO “UNC”	INTEIRO(8)	SIM
16	PEDIDO.NUMEROPEDIDO	C5_NUM	CARACTERE(80)	SIM
17	PEDIDO.NUMEROPEDIDOERP	C5_NUM	CARACTERE(80)	NÃO
18	PEDIDO.OBSERVACAONOTAFISCAL	C5_MENNOTA	CARACTERE(4000)	NÃO
19	PEDIDO.SGLORIGEMPEDIDO	FIXO ‘ERP’	CARACTERE(10)	SIM

CADASTRO DO PEDIDO DO PRODUTO (Tabela PEDIDOPRODUTO)

Retorna o cadastro do pedido do produto no Protheus na tabela SC6.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	PEDIDOPRODUTO.CODIGOERP	C6_FILIAL + ’#’ + C6_NUM + ’#’ + C6_PRODUTO + ’#’ + C6_ITEM	CARACTERE(80)	SIM
2	PEDIDOPRODUTO.DATAFATURAMENTO	C6_DATFAT	DATE	NÃO
3	PEDIDOPRODUTO.DATASITUACAO	C6_ENTREG	DATE	NÃO
4	PEDIDOPRODUTO.IDPEDIDO	C6_FILIAL + ’#’ + C6_NUM	INTEIRO(8)	SIM
5	PEDIDOPRODUTO.IDPRODUTO	C6_PRODUTO	INTEIRO(8)	SIM
6	PEDIDOPRODUTO.IDTABELAPRECO	PEDIDO.IDTABELAPRECO	INTEIRO(8)	NÃO
7	PEDIDOPRODUTO.IDTESPROTHEUS	CASO TRIM(C6_CF).SUBSTRING(0,3)=="59 1" || TRIM(C6_CF).SUBSTRING(0,3)=="69 1" ENTAO “EMP##10” SENAO “EMP##01” FIM		NÃO
8	PEDIDOPRODUTO.IDTIPOSITPEDIDOPRODUTO	FIXO "ITPEN"	INTEIRO(8)	NÃO
9	PEDIDOPRODUTO.ORDEM	C6_ITEM	INTEIRO(8)	NÃO
10	PEDIDOPRODUTO.PRECOCUSTO	PRODUTO.PRECOCUSTO	NUMERIC	NÃO
11	PEDIDOPRODUTO.PRECOFATURADO	C6_PRCVEN	NUMERIC	NÃO
12	PEDIDOPRODUTO.PRECOORIGINAL	C6_PRUNIT	NUMERIC	NÃO
13	PEDIDOPRODUTO.PRECOSUGERIDO	C6_PRUNIT	NUMERIC	NÃO
14	PEDIDOPRODUTO.PRECOVENDA	C6_PRCVEN	NUMERIC	NÃO
15	PEDIDOPRODUTO.QUANTIDADE	C6_QTDVEN	NUMERIC	NÃO
16	PEDIDOPRODUTO.QUANTIDADEFATURADA	C6_QTDENT	NUMERIC	NÃO
17	PEDIDOPRODUTO.QUANTIDADEPENDENTE	C6_QTDENT	NUMERIC	NÃO
18	PEDIDOPRODUTO.VALORTOTALBRUTO	C6_VALOR	NUMERIC	NÃO
19	PEDIDOPRODUTO.VALORTOTALLIQUIDO	C6_VALOR	NUMERIC	NÃO

CADASTRO DA ENTREGA DO PEDIDO (Tabela PEDIDOENTREGA)

Retorna o cadastro da entrega do pedido no Protheus na tabela SC5 e na tabela SC6.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	PEDIDOENTREGA.CODIGOERP	C6_FILIAL + ’#’ + C6_NUM	CARACTERE(80)	SIM
2	PEDIDOENTREGA.IDNENTREGAFUTURA	FIXO 0	INTEIRO(2)	SIM
3	PEDIDOENTREGA.IDNEXPORTADOERP	FIXO 1	INTEIRO(2)	SIM
4	PEDIDOENTREGA.IDPARCEIROREDESPACHO	C5_REDESP + ‘#’ + ‘TRA’	INTEIRO(8)	NÃO
5	PEDIDOENTREGA.IDPARCEIROTRANSPORTADOR	C5_REDESP + ‘#’ + ‘TRA’	INTEIRO(8)	NÃO
6	PEDIDOENTREGA.IDPEDIDO	C6_FILIAL + ’#’ + C6_NUM	INTEIRO(8)	SIM
7	PEDIDOENTREGA.IDTIPOFRETE	C5_TPFRETE	INTEIRO(8)	NÃO
8	PEDIDOENTREGA.SGLPEDIDOENTREGA	FIXO ‘PRINCIPAL’	CARACTERE(10)	NÃO
9	PEDIDOENTREGA.VALORFRETE	C5_FRETE	NUMERIC	NÃO
10	PEDIDOENTREGA.VALORSEGURO	C5_SEGURO	NUMERIC	NÃO

CADASTRO DA NOTA FISCAL (Tabela NOTAFISCAL)

Retorna o cadastro da nota fiscal do Protheus na tabela SF2. 

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	NOTAFISCAL.CODIGOERP	F2_FILIAL + ‘#’ + F2_DOC + ‘#’ + F2_SERIE + ‘#’ + F2_EMISSAO	CARACTERE(80)
2	NOTAFISCAL.DATAEMISSAO	F2_EMISSAO	DATE
3	NOTAFISCAL.HORAATUALIZACAO	F2_HORA	CARACTERE(8)
4	NOTAFISCAL.IDCONDICAOPAGAMENTO	F2_COND	INTEIRO(8)
5	NOTAFISCAL.IDLOCAL	'EMP’ + ‘#’ + F2_FILIAL + ‘#’ + F2_CLIENTE + ‘#’ + F2_LOJA I	INTEIRO(8)
6	NOTAFISCAL.IDLOCALFILIALFATURAMENTO	'EMP’ + ‘#’ + F2_FILIAL	INTEIRO(8)
7	NOTAFISCAL.IDLOCALFILIALRETIRADA	'EMP’ + ‘#’ + F2_FILIAL	INTEIRO(8)
8	NOTAFISCAL.IDLOCALFILIALVENDA	'EMP’ + ‘#’ + F2_FILIAL	INTEIRO(8)
9	NOTAFISCAL.IDNCANCELADA	FIXO 0	INTEIRO(2)
10	NOTAFISCAL.IDPARCEIRO	F2_CLIENTE + ‘#’ + F2_LOJA	INTEIRO(8)
11	NOTAFISCAL.IDTIPONOTAFISCAL	F2_TIPO	INTEIRO(8)
12	NOTAFISCAL.IDUSUARIO	SE (F2_VEND1 != "" && F2_VEND1 != null) ENTAO F2_VEND1 SENAO ‘UNC’	INTEIRO(8)
13	NOTAFISCAL.NUMERONOTAFISCAL		CARACTERE(80)
14	NOTAFISCAL.OBSERVACAO	F2_MENNOTA	CARACTERE(4000)
15	NOTAFISCAL.SERIE	F2_SERIE	CARACTERE(20)
16	NOTAFISCAL.VALORFATURADO	F2_VALBRUT	NUMERIC
17	NOTAFISCAL.VALORFRETE	F2_FRETE	NUMERIC
18	NOTAFISCAL.VALORSEGURO	F2_SEGURO	NUMERIC

CADASTRO DA NOTA FISCAL DO PRODUTO (Tabela NOTAFISCALPRODUTO)

Retorna o cadastro da nota fiscal do produto no Protheus na tabela SF2 e na tabela SD2.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	NOTAFISCALPRODUTO.CODIGOERP	D2_DOC + ‘#’ + F2_FILIAL + ‘#’ + F2_SERIE + ‘#’ + F2_EMISSAO + ‘#’ + D2_ITEM + ‘#’ + D2_FILIAL + ‘#’ + D2_SERIE	CARACTERE(80)	SIM
2	NOTAFISCALPRODUTO.IDCFOP	D2_CF	INTEIRO(8)	NÃO
3	NOTAFISCALPRODUTO.IDNOTAFISCAL	F2_FILIAL + ‘#’ + D2_DOC + ‘#’ + F2_SERIE + ‘#’ + F2_EMISSAO	INTEIRO(8)	NÃO
4	NOTAFISCALPRODUTO.IDPEDIDO	D2_FILIAL + ‘#’ + D2_PEDIDO	INTEIRO(8)	NÃO
5	NOTAFISCALPRODUTO.IDPRODUTO	D2_COD	INTEIRO(8)	NÃO
6	NOTAFISCALPRODUTO.IDTESPROTHEUS	'PAD’ + ‘#’ + ‘EMP’ + ‘#’ + D2_FILIAL + ‘#’ + D2_TES		NÃO
7	NOTAFISCALPRODUTO.PRECOFATURADO	D2_VALBRUT / (D2_QUANT == 0 ? 1 : D2_QUANT)	NUMERIC	NÃO
8	NOTAFISCALPRODUTO.PRECOORIGINAL	D2_PRCVEN	NUMERIC	NÃO
9	NOTAFISCALPRODUTO.QUANTIDADEFATURADA	D2_QUANT	NUMERIC	NÃO
10	NOTAFISCALPRODUTO.VALORTOTALBRUTO	D2_VALBRUT	NUMERIC	NÃO
11	NOTAFISCALPRODUTO.VALORTOTALLIQUIDO	D2_TOTAL	NUMERIC	NÃO

CADASTRO DA SCFOP (Tabela CFOP)

Retorna o cadastro da scfop do Protheus na tabela SD2. 

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	CFOP.CODIGOERP	D2_CF	CARACTERE(80)	SIM
2	CFOP.DESCRICAO	D2_CF	CARACTERE(4000)	NÃO
3	CFOP.IDNATIVO	FIXO 1	INTEIRO(2)	SIM

CADASTRO DA NOTA FISCAL DEVOLUÇÃO (Tabela NOTAFISCAL)

Retorna o cadastro da nota fiscal de devolução do Protheus na tabela SF1.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	NOTAFISCAL.CODIGOERP	'DEV’ + ‘#’ + F1_FILIAL + ‘#’ + F1_DOC + ‘#’ + F1_SERIE + ‘#’ + F1_FORNECE + ‘#’ + F1_DTDIGIT + ‘#’ + F1_TIPO	CARACTERE(80)	SIM
2	NOTAFISCAL.DATAATUALIZACAO	F1_EMISSAO	DATE	NÃO
3	NOTAFISCAL.DATAEMISSAO	F1_DTDIGIT	DATE	NÃO
4	NOTAFISCAL.HORAATUALIZACAO	F1_HORA	CARACTERE(8)	NÃO
5	NOTAFISCAL.IDCONDICAOPAGAMENTO	F1_COND	INTEIRO(8)	NÃO
6	NOTAFISCAL.IDLOCAL	F1_FORNECE + ‘#’ + F1_LOJA + ‘#’ + ‘PRI’	INTEIRO(8)	SIM
7	NOTAFISCAL.IDLOCALFILIALFATURAMENTO	'EMP’ + ‘#’ + F2_FILIAL	INTEIRO(8)	NÃO
8	NOTAFISCAL.IDLOCALFILIALRETIRADA	'EMP’ + ‘#’ + F2_FILIAL	INTEIRO(8)	NÃO
9	NOTAFISCAL.IDLOCALFILIALVENDA	'EMP’ + ‘#’ + F2_FILIAL	INTEIRO(8)	NÃO
10	NOTAFISCAL.IDNCANCELADA	FIXO 0	INTEIRO(2)	NÃO
11	NOTAFISCAL.IDPARCEIRO	F1_FORNECE + ‘#’ + F1_LOJA	INTEIRO(8)	SIM
12	NOTAFISCAL.IDTIPONOTAFISCAL	F1_TIPO	INTEIRO(8)	NÃO
13	NOTAFISCAL.NUMERONOTAFISCAL	F1_DOC	CARACTERE(80)	NÃO
14	NOTAFISCAL.SERIE	F1_SERIE	CARACTERE(20)	NÃO
15	NOTAFISCAL.VALORFATURADO	F1_VALMERC	NUMERIC	NÃO
16	NOTAFISCAL.VALORFRETE	F1_FRETEVVVV	NUMERIC	NÃO
17	NOTAFISCAL.VALORSEGURO	F1_SEGURO	NUMERIC	NÃO

CADASTRO DA NOTA FISCAL DO PRODUTO DEVOLUÇÃO (Tabela NOTAFISCALPRODUTO)

Retorna o cadastro da nota fiscal de devolução do produto no Protheus na tabela SD1.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	NOTAFISCALPRODUTO.CODIGOERP	'DEV’ + ‘#’ + D1_FILIAL + ‘#’ + D1_DOC + ‘#’ + D1_SERIE + ‘#’ + D1_ITEM + ‘#’ + D1_FORNECE + ‘#’ + D1_DTDIGIT + ‘#’ + D1_TIPO	CARACTERE(80)	SIM
2	NOTAFISCALPRODUTO.IDCFOP	D1_CF	INTEIRO(8)	NÃO
3	NOTAFISCALPRODUTO.IDNOTAFISCAL	'DEV’ + ‘#’ + D1_FILIAL + ‘#’ + D1_DOC + ‘#’ + D1_SERIE + ‘#’ + D1_FORNECE + ‘#’ + D1_DTDIGIT + ‘#’ + D1_TIPO	INTEIRO(8)	NÃO
4	NOTAFISCALPRODUTO.IDNOTAFISCALORIGEM	D1_SERIORI + ‘#’ + D1_NFORI + ‘#’ +	INTEIRO(8)	NÃO
5	NOTAFISCALPRODUTO.IDPEDIDO	D1_FILIAL + ‘#’ + D1_PEDIDO + ‘#’ + ‘EMP’ + ‘#’ + D1_FILIAL	INTEIRO(8)	NÃO
6	NOTAFISCALPRODUTO.IDPRODUTO	D1_COD	INTEIRO(8)	NÃO
7	NOTAFISCALPRODUTO.IDTESPROTHEUS	'PAD’ + ‘#’ + ‘EMP’ + ‘#’ + D1_FILIAL + ‘#’ + D1_TES		NÃO
8	NOTAFISCALPRODUTO.PRECOFATURADO	D1_VUNIT	NUMERIC	NÃO
9	NOTAFISCALPRODUTO.QUANTIDADEFATURADA	D1_QUANT	NUMERIC	NÃO
10	NOTAFISCALPRODUTO.VALORTOTALBRUTO	D1_TOTAL	NUMERIC	NÃO
11	NOTAFISCALPRODUTO.VALORTOTALLIQUIDO	D1_TOTAL	NUMERIC	NÃO

CADASTRO DO FINANCEIRO (Tabela FINANCEIROTITULO)

Retorna o cadastro do financeiro do Protheus na tabela SE1.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	FINANCEIROTITULO.CODIGOERP	E1_CLIENTE + "#" + E1_TIPO + "#" + E1_NUM + "#" + E1_PARCELA + "#" + E1_PREFIXO	CARACTERE(80)	SIM
2	FINANCEIROTITULO.DATAMOVIMENTO	E1_EMISSAO	DATE	NÃO
3	FINANCEIROTITULO.DATAPAGAMENTO	NULL OR E1_BAIXA	DATE	NÃO
4	FINANCEIROTITULO.DATAVENCIMENTO	E1_VENCTO	DATE	SIM
5	FINANCEIROTITULO.DESCRICAO	E1_TIPO	CARACTERE(80)	NÃO
6	FINANCEIROTITULO.IDLOCAL	E1_CLIENTE + "#" + E1_LOJA + ‘#’ + ‘PRI	INTEIRO(8)	NÃO
7	FINANCEIROTITULO.IDNPAGO	FIXO 0	INTEIRO(2)	NÃO
8	FINANCEIROTITULO.IDNPAGO	SE (E1_SALDO == 0) ENTAO 1 SENAO 0	INTEIRO(2)	NÃO
9	FINANCEIROTITULO.IDPARCEIRO	E1_CLIENTE + "#" + E1_LOJA	INTEIRO(8)	SIM
10	FINANCEIROTITULO.IDUSUARIO	E1_VEND1	INTEIRO(8)	NÃO
11	FINANCEIROTITULO.NUMERODOCUMENTO	SE (E1_NUM == null || trim(E1_NUM) == "") ENTAO E1_NUMBCO SENAO E1_NUM	CARACTERE(40)	NÃO
12	FINANCEIROTITULO.NUMEROPARCELA	E1_PARCELA	CARACTERE(20)	NÃO
13	FINANCEIROTITULO.OBSERVACAO	E1_HIST	CARACTERE(4000)	NÃO
14	FINANCEIROTITULO.PORTADOR	E1_PORTADO	CARACTERE(80)	NÃO
15	FINANCEIROTITULO.SGLTIPOTITULO	SE (E1_TIPO == 'NCC' || E1_TIPO == 'RA') ENTAO ‘TC’ SENAO ‘TD’	CARACTERE(80)	SIM
16	FINANCEIROTITULO.VALORDESCONTO	E1_VALOR * (E1_DESCFIN / 100)	NUMERIC	SIM
17	FINANCEIROTITULO.VALORJUROS	E1_JUROS	NUMERIC	SIM
18	FINANCEIROTITULO.VALORORIGINAL	E1_VALOR	NUMERIC	SIM
19	FINANCEIROTITULO.VALORPAGOPARCIAL	(E1_VALOR - E1_SALDO)	NUMERIC	SIM

3.6 Entidades da exportação de dados

Diferentemente da importação de dados, a exportação é feita através de um webservice SOAP.

Método de Requisição: XML SOAP

URL base: http://IP:PORTA/wssim3g/WSSIM3G_INPEDIDO.apw?WSDL

Os únicos parâmetros passados para o webservice são o XML de envio e o campo INLOGIN.

Exemplo de envio de pedido:

XML Pedido

   

Exemplo de envio de cliente:

PEDIDO

Retorna a exportação da entidade pedido das tabelas PEDIDO, PARCEIRO, CONDICAOPAGAMENTO, PEDIDOENTREGA, LOCAL, PRODUTO, TABELAPRECO, CLASSIFICACAOPARCEIRO, TIPOCOBRANCA, TIPOFRETE, USUARIO. 

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	PEDIDO.VALORACRESCIMO	C5_ACRSFIN	NUMERIC
2	PARCEIRO.CODIGOERP + ‘#’ + 1	C5_CLIENTE	CARACTERE(80)	SIM
3	CONDICAOPAGAMENTO.CODIGOERP	C5_CONDPAG	CARACTERE(80)	SIM
4	PEDIDO.VALORDESCONTO	C5_DESC1	NUMERIC	NÃO
5	0	C5_DESCFI		NÃO
6	PEDIDOENTREGA.VALORDESPESA	C5_DESPESA	NUMERIC	NÃO
7	PEDIDO.DATAPEDIDO	C5_EMISSAO	DATE	SIM
8	PENDIDOENTREGA.DATAENTREGA	C5_FECENT	DATE	NÃO
9	LOCAL.CODIGOERP + ‘#’ + 2	C5_FILIAL	CARACTERE(80)	SIM
10	0	C5_FRETAUT		NÃO
11	PEDIDOENTREGA.VALORFRETE	C5_FRETE	NUMERIC	NÃO
12	LOCAL.CODIGOERP + ‘#’ + 2	C5_LOJACLI	CARACTERE(80)	SIM
13	PEDIDO.OBSERVACAONOTAFISCAL	C5_MENNOTA	CARACTERE(4000)	NÃO
14		C5_NUM		NÃO
15	PRODUTO.PESOMEDIO	C5_PESOL	NUMERIC	NÃO
16		C5_REDESP		NÃO
17	PEDIDOENTREGA.VALORSEGURO	C5_SEGURO	NUMERIC	NÃO
18	TABELAPRECO.CODIGOERP	C5_TABELA	CARACTERE(80)	SIM
19	‘N’	C5_TIPO		NÃO
20	CLASSIFICACAOPARCEIRO.CODIGOERP	C5_TIPOCLI	CARACTERE(80)	SIM
22	TIPOCOBRANCA.DESCRICAO	DESC_TPCOBRANCA	CARACTERE(80)	SIM
23	TIPOFRETE.DESCRICAO	C5_TPFRETE	CARACTERE(80)	SIM
24	USUARIO.CODIGOERP	C5_VEND1	CARACTERE(80)	SIM
25	PARCEIRO.CODIGOERP + ‘#’ + 1	C5_TRANSP	CARACTERE(80)	SIM
26	PEDIDO.NUMEROPEDIDO	C5_X_PVSIM	CARACTERE(80)	SIM
27		AITENS		NÃO
28	PEDIDO.OBSERVACAOSITUACAO	ESTE CAMPO RECEBE O RETORNO DO PLUGIN APÓS A EXPORTAÇÃO

Um pedido só é enviado pela integração se atender as seguintes condições:

● Não tenha sido exportado (pedido.idnexportadoerp = 0);
● Esteja pendente (tiposituacaopedido.sgltiposituacaopedido = ‘PP’);
● Não seja de origem ERP (pedido.sglorigempedido <> ‘ERP’);
● Caso possua aprovações, verifica se a aprovação mais recente está aprovada
(tiposituacaoaprovacao.sgltiposituacaoaprovacao = ‘AP’).

Após uma exportação bem-sucedida, duas colunas do pedido serão atualizadas, uma senda a coluna dataSituacao, que recebe a data de exportação, e a outra sendo a coluna observacaoSituacao, que recebe a data de exportação e também armazena o retorno do plugin, no padrão abaixo:

DATA/HORA: DD/MM/YYYY HH24:MI:SS
Pedido incluído com sucesso! Número ERP: XXXXXX

Caso a inclusão de um pedido não seja bem-sucedida, a rotina altera a situação do pedido para “Não Finalizado” novamente, para que ele seja revisado pelo vendedor.

ITENS DO PEDIDO

Retorna a exportação da entidade itens do pedido das tabelas PEDIDOENTREGA, PEDIDOPRODUTO, TIPOPEDIDO, PEDIDO, PRODUTO, TABELAPRECOPRODUTO.

	TOTVS CRM | SFA	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	PEDIDOPRODUTO.PERCENTUALDESCONTO	C6_DESCONT
2	PEDIDOENTREGA.DATAENTREGA	C6_ENTREG	DATE	NÃO
3	TIPOPEDIDO.CODIGO	C6_OPER	CARACTERE(20)	NÃO
4	PEDIDO.NUMEROPEDIDOCLIENTE	C6_PEDCLI	CARACTERE(80)	NÃO
5	PEDIDOPRODUTO.PRECOVENDA	C6_PRCVEN	NUMERIC	NÃO
6	PRODUTO,CODIGOERP	C6_PRODUTO	CARACTERE(80)	SIM
7	PEDIDOPRODUTO.QUANTIDADE	C6_QTDVEN	NUMERIC	NÃO
8	VAZIO OU TIPOPEDIDO.CODIGO	C6_TES	CARACTERE(20)	NÃO
9	TABELAPRECOPRODUTO.PRECO + PEDIDOPRODUTO.PRECOVENDA	C6_PRUNIT	NUMERIC	NÃO
10		C6_UNSVEN		NÃO
11	PEDIDOPRODUTO.VALORDESCONTO * PEDIDOPRODUTO.QUANTIDADE	C6_VALDESC	NUMERIC	NÃO
12	0	C6_QTDLIB		NÃO

Antes de realizar a consulta de itens do pedido, é validado o tipo de TES utilizado pelo cliente. No caso de TES inteligente, a tag C6_OPER recebe o valor tipopedido.codigo, enquanto a tag C6_TES é enviada vazia. Para TES padrao é feito o oposto, enviando o campo tipopedido.codigo na tag C6_TES e enviando a tag C6_OPER vazia.

CLIENTE

Retorna a exportação da entidade cliente das tabelas PARCEIRO, LOCAL, USUARIOFILIAL, CLASSIFICACAOPARCEIRO, UNIDADEFEDERATIVA, CIDADE, LOCALTELEFONE, CONTATOPESSOA, PESSOAFISICA, PESSOAJURIDICA, LOCALEMAIL, CONDICAOPAGAMENTO, TABELAPRECO.

	MarterSALES	Protheus	Tipo TOTVS CRM | SFA	Obrigatório
1	USUARIOFILIAL.CDIGOERP OU VALOR FIXO '1'	A1_FILIAL	varchar(80)
2	PARCEIRO.NUMEROMATRICULA	A1_COD	varchar(20)
3	VALOR FIXO '1'	A1_LOJA
4	PARCEIRO.NOMEPARCEIRO	A1_NOME	varchar(80)
5	PARCEIRO.NOMEPARCEIROFANTASIA OU PARCEIRO.NOMEPARCEIRO	A1_NREDUZ v	varchar(80)
6	VALOR FIXO ‘F' OU 'J’	A1_PESSOA
7	LOCAL.LOGRADOURO (tipolocal ‘PRI’)	A1_END	varchar(80)
8	LOCAL.LOGRADOURO (tipolocal ‘COB’)	A1_ENDCOB	varchar(80)
9	LOCAL.LOGRADOURO (tipolocal ‘ENT’)	A1_ENDENT	varchar(80)
10	LOCAL.BAIRRO (tipolocal ‘PRI’)	A1_BAIRRO	varchar(80)
11	LOCAL.BAIRRO (tipolocal ‘COB’)	A1_BAIRROC	varchar(80)
12	LOCAL.BAIRRO (tipolocal ‘ENT’)	A1_BAIRROE	varchar(80)
13	LOCAL.COMPLEMENTO (tipolocal ‘PRI’)	A1_COMPLEM	varchar(80)
14	LOCAL.COMPLEMENTO (tipolocal ‘ENT’)	A1_COMPENT	varchar(80)
15	CLASSIFICACAOPARCEIRO.SGLCLASSIFICACAO	A1_TIPO	varchar(10)
16	UNIDADEFEDERATIVA.CODIGO (tipolocal ‘PRI’)	A1_EST	varchar(20)
17	UNIDADEFEDERATIVA.CODIGO (tipolocal ‘COB’)	A1_ESTC	varchar(20)
18	UNIDADEFEDERATIVA.CODIGO (tipolocal ‘ENT’)	A1_ESTE	varchar(20)
19	LOCAL.CEP (tipolocal ‘PRI’)	A1_CEP	varchar(10)
20	LOCAL.CEP (tipolocal ‘COB’)	A1_CEPC	varchar(10)
21	LOCAL.CEP (tipolocal ‘ENT’)	A1_CEPE	varchar(10)
22	CIDADE.CODIGO (tipolocal ‘PRI’)	A1_COD_MUN	varchar(20)
23	CIDADE.CODIGO (tipolocal ‘ENT’)	A1_CODMUNE	varchar(20)
24	CIDADE.DESCRICAO (tipolocal ‘PRI’)	A1_MUN	varchar(80)
25	5 CIDADE.DESCRICAO (tipolocal ‘COB’)	A1_MUNC	varchar(80)
26	CIDADE.DESCRICAO (tipolocal ‘ENT’)	A1_MUNE	varchar(80)
27		A1_REGIAO
28	LOCALTELEFONE.TELEFONE	A1_DDD	varchar(40)
29		A1_DDI
30		A1_TEL
31		A1_FAX
32		A1_TELEX
33	CONTATOPESSOA.NOME	A1_CONTATO	varchar(80)
34	PESSOAFISICA.DOCUMENTOIDENTIFICACAO OU PESSOAJURIDICA.DOCUMENTOIDENTIFICACAO	A1_CGC	varchar(80)
35		A1_RG	varchar(80)
36	PESSOAFISICA.DOCUMENTOIDENTIFICACAO OU VAZIO	A1_PFISICA
37	LOCAL.INSCRICAOESTADUAL	A1_INSCR	varchar(40)
38	LOCAL.INSCRICAOESTADUAL	A1_INSCRM	varchar(40)
39		A1_INSCRUR
40		A1_PAIS
41	pessoafisica.anonascimento + pessoafisica.mesnascimento + pessoafisica.dianascimento	A1_DTNASC
42	LOCALEMAIL.EMAIL	A1_EMAIL	varchar(80)
43	PARCEIRO.HOMEPAGE	A1_HPAGE	varchar(80)
44		A1_CNAE
45	VALOR FIXO '1'	A1_MSBLQL
46	USUARIO.CODIGOERP	A1_VEND	varchar(80)
47	VALOR FIXO 'F'	A1_TPFRET	varchar(80)
48		A1_TRANSP
49	CONDICAOPAGAMENTO.CODIGOERP	A1_COND	varchar(80)
50		A1_RISCO
51	LOCAL.LIMITESUGERIDO	A1_LC	numeric(18)
52	VALOR FIXO 0	A1_LCFIN
53		A1_GRPVEN
54	TABELAPRECO.CODIGO	A1-TABELA	varchar(20)
55	0	A1_VENCLC
56	VALOR FIXO 'I'	OPERACAO

A rotina standard realiza o envio apenas de clientes que atendam as seguintes condições:
● Local seja do tipo Principal (tipolocal.sgltipolocal = ‘PRI’);
● Local seja ativo (local.idnativo = 1);
● Parceiro não tenha sido exportado (parceiro.idnexportadoerp = 0).
Visto que o campo A1_LOJA é enviado com o valor fixo '1', não se pode enviar mais de um local para cada cliente utilizando a exportação standard, apesar de ser possível realizar o cadastro de multiplos locais através da aplicação.

Por padrão, a rotina envia os clientes como Ativos e sem bloqueios, pois a tag A1_MSBLQL, responsável por determinar se um cliente está ou não bloqueado (1 = sem bloqueios 2 = bloqueado), é enviada com valor fixo '1'.
Após uma exportação de cliente bem-sucedida, é inserido um registro na tabela mensagem, com o usuário admin como remetente e o usuário gerador do cadastro como destinatário, informando do sucesso do envio. Esta mensagem pode ser acessada pelo usuário através do módulo Mensagem nas aplicações web e mobile. É alterada também a coluna observacaoIntegracao, para que contenha a mensagem de sucesso da exportação. Assim que um cliente exportado for inserido no Protheus, o mesmo estará sujeito a importação pelas rotinas de importação.
Uma vez que um cliente foi cadastrado ele pode ser sujeito a alterações feitas pelo usuário através da aplicação TOTVS CRM | SFA, porém estas alterações posteriores não são enviadas para o Protheus através da exportação, pois a integração standard contempla apenas o primeiro envio de um cadastro novo.

CAMPOS ESPECÍFICOS

Nas rotinas de exportação, tanto de pedidos quanto de clientes, é possível realizar a inclusão de campos adicionais para o envio, que não façam parte dos campos padrões do Protheus, sendo campos específicos de cada cliente. Estes campos devem ser inseridos nas consultas SQL que fazem a busca dos demais campos que serão enviados. Por serem campos não contemplados dentro da rotina standard, estes campos adicionais devem ser tratados como customizações e alinhados da forma devida, antes de serem parametrizados como campos específicos.

Após a inclusão dos campos através da consulta SQL, é necessário realizar o mapeamento dos mesmos no XML que será enviado. O mapeamento de campos específicos é feito através da sintaxe abaixo, dentro do step Campos Espec. A estrutura deve ser repetida para cada campo novo.

IF (trim(A1_NOMETAG != "" && A1_NOMETAG != null) { //Verifica se o campo está nulo ou vazio

CAMPO_ESPEC = "";

//Inicia a variável vazia, para que não receba os valores de campos anteriores

CAMPO_ESPEC += "";

//Inicia a estrutura que será levada para o XML final CAMPO_ESPEC += "A1_NOMETAG ";

//Especifica o nome do campo em questão CAMPO_ESPEC += "" + A1_NOMETAG + "";

//Passa o valor do campo em questão CAMPO_ESPEC += "";

//Encerra a estrutura arrayCampoEspec.push(CAMPO_ESPEC); //Passa a estrutura para um array que agrega todos os campos específicos adicionados

}

Após a inclusão de cada campo específico, é feito um laço FOR para inserir as estruturas geradas dentro da tag , utilizando o array que foi montado anteriormente.

Exemplo de estrutura final: 

Esta estrutura é valida tanto para o mapeamento de campos específicos do envio de clientes quanto para o envio de pedidos.

Exemplo prático:

Durante as parametrizações de exportação de pedidos para o cliente X, foi levantada a necessidade do envio de uma tag chamada C6_LOCAL no envio de itens do pedido, que representa o armazém do produto. No TOTVS CRM | SFA, esta informação é persistida no campo produto.complemento, portanto a seguinte linha é adicionada na consulta de pedidoProduto:
CAST(PRODUTO.COMPLEMENTO AS VARCHAR) AS C6_LOCAL

Após a adição do campo na consulta, é criada a sintaxe que irá gerar a estrutura XML do campo, dentro do step CAMPO_ESPEC_ITENS: 

if (trim(c6_local) != "" && c6_local != null) {

CAMPO_ESPEC = "";

CAMPO_ESPEC += "";

CAMPO_ESPEC += "C6_LOCAL";

CAMPO_ESPEC += "" + c6_local + "";

CAMPO_ESPEC += ""; arrayCampoEspec.push(CAMPO_ESPEC); }

Com isso feito, o XML de envio será gerado contendo este novo campo, assim como qualquer outro adicionado desta forma.

TRATAMENTO DE ERROS

As rotinas de exportação são suscetíveis primariamente a dois tipos de erros, um sendo por conta de indisponibilidades por parte do Plugin, e outro sendo por conta de informações errôneas ou faltantes no XML de envio.
A integração valida a existência de um retorno do plugin através do campo de output (INCLUIRCLIENTERESULT ou INCLUIRPEDIDODRESULT ), que recebe o output da requisição de envio. Se este campo estiver nulo, entende-se que o plugin encontrava-se indisponível, e é gravada uma mensagem conforme o exemplo abaixo:

DATA/HORA: 23/03/2020 17:00:00
Webservice do Protheus Indisponível
Código do Cliente:001

Se o campo de output não estiver nulo, é validado se a mensagem de retorno foi de sucesso através da tag C01TPMENSAGEM (se o valor da tag for S, o cliente/pedido foi inserido com sucesso), e se o cliente/pedido não tiver sido inserido com sucesso é utilizada a tag N03MENSAGEM, que contém a mensagem de retorno do plugin, para gravar o registro em nosso banco. Esta tag contém o detalhamento do motivo do XML não ter integrado no Protheus, sendo por falta de informação ou por valores inválidos, conforme exemplo abaixo: 

DATA/HORA: 23/03/2020 17:00:00

AJUDA:OBRIGAT
Um ou mais campos obrigatórios não foram preenchidos. xxxxxxxxxxxxxxxxxx -> xxxxxxxxxx
Endereço
Código do Cliente:001

No caso da exportação de pedidos, estas informações são gravadas na coluna observacaosituacao da tabela pedido, enquanto para a exportação de cliente é criado um registro na tabela mensagem utilizando por padrão o usuário admin como remetente e o usuário gerador do cadastro como destinatário, sendo possível a visualização pelo módulo de mensagem das aplicações web e mobile.