...
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:
Desc | Descrição Campo | Campo Protheus | Descrição campo CRM | Campo |
Mensagem Única| CRM | Obrigatório | Observação Protheus | Observação CRM |
| Internal_Id | GrupoEmpresa + Filial + A1_COD + A1_LOJA + "C" | ExternalId |
Content/InternalId| externalId | Sim | Montado pelo Protheus no momento da integração |
CodigoContent/Code | Sim | | 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 |
Content/StoreId | Sim | | 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 |
Content/Name| name | Sim |
|
|
| N Fantasia | A1_NREDUZ |
Content/ShortName | Nome fantasia | tradingName | Sim |
|
|
| Fisica/Jurid | A1_PESSOA |
Content/EntityType| Tipo de pessoa | customerPersonType.id | Sim |
|
|
| Tipo | A1_TIPO |
Content/StrategicCustomerType
| - | 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 |
Content/Adress/Adress | Sim | | 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 |
Content/Adress/District | Bairro | addresses[].neighborhood | Sim |
|
|
| Pais | A1_PAIS |
Content/Adress/Country/Description| País | addresses[].countryId; addresses[].countryName | Sim |
|
|
| Estado | A1_EST |
Content/Adress/State/StateDescription| Estado | addresses[].stateId; addresses[].stateName | Sim |
|
|
| CEP | A1_CEP | CEP |
Content/Adress/ZipCode| addresses[].postalCode | Sim |
|
|
| Cd. Municipio | A1_COD_MUN |
Content/Adress/City/CityCode| 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 |
Content/Adress/City/CityDescription| addresses[].cityName | Sim |
|
|
| DDD | A1_DDD |
Content/ListofCommunicationInformation/PhoneNumber| Número |
phones[].number | Sim |
| O telefone suporta mais de um registro e está representado como lista |
| DDI | A1_DDI |
Content/ListofCommunicationInformation/PhoneNumber | SimContent/ListofCommunicationInformation/PhoneNumber | Sim | Content/ListofCommunicationInformation/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 |
Content/ListofCommunicationInformation/HomePage | Website | website | Não |
|
|
| CNPJ/CPF | A1_CGC |
Content/GovernmentalCommunicationInformationName(/CNPJ) | customerIdentificationDocuments[].documentNumber ; customerIdentificationDocuments[].identificationDocumentAcronym |
Content/GovernmentalCommunicationInformation/IdContent/GovernmentalCommunicationInformation/Name(INSCRICAO ESTADUAL)
| IE | customerIdentificationDocuments[].documentNumber ; customerIdentificationDocuments[].identificationDocumentAcronym |
Content/GovernmentalCommunicationInformation/IdContent/GovernmentalCommunicationInformation/Name(RG)
| RG | customerIdentificationDocuments[].documentNumber ; customerIdentificationDocuments[].identificationDocumentAcronym | Não |
Content/GovernmentalCommunicationInformation/IdContent/GovernmentalCommunicationInformation/Name(INSCRICAO MUNICIPAL)
| IM | customerIdentificationDocuments[].documentNumber ; customerIdentificationDocuments[].identificationDocumentAcronym |
Content/GovernmentalCommunicationInformation/IdContent/GovernmentalCommunicationInformation/Name(SUFRAMA)
| Suframa | customerIdentificationDocuments[].documentNumber ; customerIdentificationDocuments[].identificationDocumentAcronym |
Content/GovernmentalCommunicationInformation/IdContent/RegisterDate| Data de nascimento/Data de fundação | birthday | Não |
|
|
| Cond. Pagto. | A1_COND |
Content/PaymentConditionInternalId| 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 |
Content/VendorInformation/VendorInformationInternalId | 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 |
Content/CreditInformation/CreditLimit | 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 |
Content/RegisterSituation
Cadastro Protheus:
Cadastro CRM:
Image Added
Detalhe do endereço:
Image Added
Limite de crédito:
Image Added
Condição de pagamento x cliente:
Image Added
