Cadastro de Cliente – Protheus-CRM

Descrição

O cadastro de Cliente é possui os dois Fluxos, o cadastro pode ser realizado no sistema Protheus, e será integrado com o sistema TOTVS CRM assim como pode ser realizado alterações e cadastros novos no TOTVS CRM para ser enviado para o Protheus, para os dois fluxos será utilizado comunicação de Mensagem Única, abaixo os campos que são integrados por padrão.

FLUXO: PROTHEUS → TOTVS CRM

TOTVS CRM → PROTHEUS

Campos Integrados:

Descrição Campo	Campo Protheus	Descrição campo CRM	Campo CRM	Obrigatório	Observação Protheus	Observação CRM
Internal_Id	GrupoEmpresa + Filial + A1_COD + A1_LOJA + "C"	ExternalId	externalId	Sim	Montado pelo Protheus no momento da integração
Código	A1_COD	Código	code (Enviado Código + Loja para o campo)	Sim		O campo code é usado para a simulação de impostos usando a API salesTaxes. O valor do campo code é enviado para a tag "customerId" e "customerIdDelivery" conforme a entrega
Loja	A1_LOJA	Código	code (Enviado Código + Loja para o campo) addresses[].code	Sim		O campo code é usado para a simulação de impostos usando a API salesTaxes. O valor do campo code é enviado para a tag "customerUnit" e customerUnitDelivery" conforme o local selecionado na entrega do pedido
Nome	A1_NOME	Nome	name	Sim
N Fantasia	A1_NREDUZ	Nome fantasia	tradingName	Sim
Fisica/Jurid	A1_PESSOA	Tipo de pessoa	customerPersonType.id	Sim
Tipo	A1_TIPO		-	Não		Necessário criar o campo customizado no CRM para receber a informação. Verificar com o CRM o padrão de criação do mesmo.
Endereco	A1_END	Endereço; Número	addresses[].address; addresses[].number	Sim	Endereço e Número deve estar separado por vírgula, qualquer outro separador não será considerado para separar as informações.	O endereço suporta mais de um registro e está representado como lista
Bairro	A1_BAIRRO	Bairro	addresses[].neighborhood	Sim
Pais	A1_PAIS	País	addresses[].countryId; addresses[].countryName	Sim
Estado	A1_EST	Estado	addresses[].stateId; addresses[].stateName	Sim
CEP	A1_CEP	CEP	addresses[].postalCode	Sim
Cd. Municipio	A1_COD_MUN	Cidade	addresses[].cityId	Sim	Campo precisa estar preenchido para integração, caso seja País Estrangeiro informar Estado = EX e Código do Município = 99999
Municipio	A1_MUN	Cidade	addresses[].cityName	Sim
DDD	A1_DDD	Número	phones[].number	Sim		O telefone suporta mais de um registro e está representado como lista
DDI	A1_DDI
Telefone	A1_TEL
E-Mail	A1_EMAIL	E-mail	emails[].email	Não	Campo e-mail não é obrigatório, mas caso seja preenchido precisa ser um e-mail valido senão o cadastro não integra
Home-Page	A1_HPAGE	Website	website	Não
CNPJ/CPF	A1_CGC	CNPJ / CPF	customerIdentificationDocuments[].documentNumber ; customerIdentificationDocuments[].identificationDocumentAcronym	Não
Ins. Estad.	A1_INSCR	IE	customerIdentificationDocuments[].documentNumber ; customerIdentificationDocuments[].identificationDocumentAcronym	Não
RG/Ced.Estr	A1_PFISICA	RG	customerIdentificationDocuments[].documentNumber ; customerIdentificationDocuments[].identificationDocumentAcronym	Não
Ins. Municip.	A1_INSCRM	IM	customerIdentificationDocuments[].documentNumber ; customerIdentificationDocuments[].identificationDocumentAcronym	Não
Suframa	A1_SUFRAMA	Suframa	customerIdentificationDocuments[].documentNumber ; customerIdentificationDocuments[].identificationDocumentAcronym	Não
Dt.Aber/Nasc	A1_DTNASC	Data de nascimento/Data de fundação	birthday	Não
Cond. Pagto.	A1_COND	Vínculo de condição de pagamento e cliente	paymentTermCustomerPermission.customerId	Não	Durante a integração de Cliente cria no CRM vinculo entre Condição de Pagamento e Cliente	O conteúdo é enviado para a API payment-term-customer-permission-integration
Tabela Preco	A1_TABELA	Vinculo de tabela e cliente. Ver integração de tabela de preço.	Content/PriceListHeaderItemInternalId	Não	Durante a integração de Cliente cria no CRM vinculo entre Tabela de Preço e Cliente	O conteúdo é enviado para a API price-list-customer-permission-integration
Vendedor	A1_VEND	Responsável	professionalName ; professionalId	Não	Durante a integração de Cliente cria no CRM vinculo entre Vendedor e Cliente	A integração de responsável está presente no ambiente https://totvscrm.app. Para o ambiente do APP2 https://app2.mastercrm.ws o está presente na aba Responsável
Lim. Crédito	A1_LC	Limite de crédito	creditLimit.customerId ; creditLimit.customerName	Não	Durante a integração de Cliente cria no CRM vinculo entre Limite de Crédito e Cliente	O conteúdo é enviado para a API credit-limits-integration
Status	A1_MSBLQL	Ativo	active	Sim

Cadastro Protheus:

Cadastro CRM:

Detalhe do endereço:

Limite de crédito:

Condição de pagamento x cliente:

Páginas filhas

Cadastro de Cliente – Protheus-CRM