...
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 ÚnicaCRM | Obrigatório | Observação Protheus | Observação CRM |
Internal_Id | GrupoEmpresa + Filial + A1_COD + A1_LOJA + "C" | ExternalId |
Content/InternalIdexternalId | Sim | Montado pelo Protheus no momento da integração |
CodigoContent/Code | 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 |
SimContent/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/Namename | Sim |
|
|
N Fantasia | A1_NREDUZ |
Content/ShortName | Nome fantasia | tradingName | Sim |
|
|
Fisica/Jurid | A1_PESSOA |
Content/EntityTypeTipo 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. |
NãoContent/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/DescriptionPaís | addresses[].countryId; addresses[].countryName | Sim |
|
|
Estado | A1_EST |
Content/Adress/State/StateDescription | Estado | addresses[].stateId; addresses[].stateName | Sim |
|
|
CEP | A1_CEP |
Content/Adress/ZipCodeCEP | addresses[].postalCode | Sim |
|
|
Cd. Municipio | A1_COD_MUN |
Content/Adress/City/CityCodeCidade | 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/CityDescriptionaddresses[].cityName | Sim |
|
|
DDD | A1_DDD |
Content/ListofCommunicationInformation/PhoneNumberNúmero | phones[].number | Sim |
| O telefone suporta mais de um registro e está representado como lista |
DDI | A1_ |
PAISContent/ListofCommunicationInformation/PhoneNumber | SimContent/ListofCommunicationInformation/PhoneNumber | Sim | PAISContent/ListofCommunicationInformation/EmailEMAIL | 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_ |
PAISContent/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/RegisterDateData de nascimento/Data de fundação | birthday | Não |
|
|
Cond. Pagto. | A1_COND |
Content/PaymentConditionInternalIdVí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