Histórico da Página
Descrição
O cadastro de Clientes é realizado cadastro de Cliente é possui os dois Fluxos, o cadastro pode ser realizado no sistema Protheus, e será integrado com o sistema TOTVS CRM através de 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, caso queira verificar abaixo os campos que compõem a mensagem de Produto basta acessar: https://api.totvs.com.br/legado Clique no Link: Mensagem Padronizada, depois em Lista de Serviços e busque a mensagem Customer.
...
Produto
...
Fluxo
...
Tipo da Mensagem
...
Versão MSU
...
Formato
...
Pré-requisitos:
...
Inclusão de Produto
...
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 | 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:
Registro do envio da mensagem no EAI Protheus e "Visualizar Mensagem Original"
Acesse o ambiente Configurador (SIGACFG) em Ambiente/Schedule/Schedule, opção EAI:
Mensagem única do ITEM
Selecionar a mensagem desejada, clicar na Lupa e clique na opção Visualizar Mensagem Original.
Código da Função: ITEM
Descrição da Mensagem: PRODUTO
Tipo da Transação: Envio
Tipo da Mensagem: Business Message
Url Enviada: https://api.homolog.fluig.io/connector/api/v1/integrations/execute/{integration-id}
Evento: UpSert
Json:
- TOTVS CRM - Recebimento
Visualizando o produto no TOTVS CRM:
- Na tela principal do TOTVS CRM acesse Produtos e Serviço > Produtos.
Protheus – Recebimento da Response Message (Mensagens assíncronas)
Recebimento de respostas
- Sucesso: Indica que a mensagem foi processada com sucesso pelo TOTVS CRM e já esta no presente no TOTVS CRM.
- Erro: Indica que a mensagem teve erro ao ser processada, e o motivo do erro esta descrito na mensagem de resposta do TOTVS CRM.
Mensagem única do ITEM
Selecionar a mensagem desejada, clicar na Lupa e clique na opção Visualizar Mensagem Original:
Código da Função: Item
Descrição da Mensagem: TotvsMessage ITEM Response Message
Tipo da Trasação: Recebimento
Tipo da Mensagem: Response Message
UUID da Mensagem Original: 51f3a62a-4765-3fcf-1b33-142f2167bb65
Json:
...
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas