Histórico da Página
...
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 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:
...
Produto
...
Fluxo
...
Tipo da Mensagem
...
Versão MSU
...
Formato
...
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 | 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 | |||||
A1_EMAIL | 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.totalValue ; 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 |
Venc. Limite de Crédito | A1_VENCLC | Vencimento Limite de crédito | creditLimit.endDate | 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: