Histórico da Página
Descrição:
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 PROTHEUS → TOTVS CRM
TOTVS 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) | Sim |
O campo code é usado para a simulação de impostos usando a [API salesTaxes | https://api.totvs.com.br/apidetails/SalesTaxes_v1_000.json]. O valor do campo code é enviado para a tag "customerUnit" e customerUnitDelivery" conforme o local selecionado na entrega do pedido | ]]></ac:plain-text-body></ac:structured-macro> | ||
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. | ||||||||
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="8b43ecc3-c3b2-4f9b-b2b8-b8d7fb4dcb9e"><ac:plain-text-body><![CDATA[ | 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 | ]]></ac:plain-text-body></ac:structured-macro> |
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="54b60451-16ce-414e-83ad-c47c3ab20875"><ac:plain-text-body><![CDATA[ | Bairro | A1_BAIRRO | Bairro | addresses[].neighborhood | Sim |
]]></ac:plain-text-body></ac:structured-macro> | |||||
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="03366a90-7c17-4ca5-adc4-f1cc10d84929"><ac:plain-text-body><![CDATA[ | Pais | A1_PAIS | País | addresses[].countryId; addresses[].countryName | Sim |
]]></ac:plain-text-body></ac:structured-macro> | |||||
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="e72466ed-720f-4217-8cf4-7e63339b4a52"><ac:plain-text-body><![CDATA[ | Estado | A1_EST | Estado | addresses[].stateId; addresses[].stateName | Sim |
]]></ac:plain-text-body></ac:structured-macro> | |||||
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="0ba91072-9b84-4811-a6e8-f553e86ae620"><ac:plain-text-body><![CDATA[ | CEP | A1_CEP | CEP | addresses[].postalCode | Sim |
]]></ac:plain-text-body></ac:structured-macro> | ||||||
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="2856fdd0-b0ac-4b7e-998e-1aa72131e7f8"><ac:plain-text-body><![CDATA[ | 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 |
]]></ac:plain-text-body></ac:structured-macro> | ||
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="596007c6-d489-4302-8c8d-9ee2eed0c2f7"><ac:plain-text-body><![CDATA[ | Municipio | A1_MUN |
addresses[].cityName | Sim |
]]></ac:plain-text-body></ac:structured-macro> | |||||
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="d5786b93-9928-42f5-9ac5-99b9ce0cb00e"><ac:plain-text-body><![CDATA[ | DDD | A1_DDD | Número | phones[].number | Sim |
O telefone suporta mais de um registro e está representado como lista | ]]></ac:plain-text-body></ac:structured-macro> | ||
DDI | A1_DDI |
Telefone | A1_TEL |
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="3ce6d907-92ad-4d5a-b894-de54ddcf8888"><ac:plain-text-body><![CDATA[ | 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 |
]]></ac:plain-text-body></ac:structured-macro> | ||||
Home-Page | A1_HPAGE | Website | website | Não |
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="bc795d92-3148-4d87-a33a-fc2ca66e31c1"><ac:plain-text-body><![CDATA[ | CNPJ/CPF | A1_CGC | CNPJ / CPF | customerIdentificationDocuments[].documentNumber ; customerIdentificationDocuments[].identificationDocumentAcronym | Não |
]]></ac:plain-text-body></ac:structured-macro> | |||||
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="3ba195b2-707e-4126-ae7a-ddb9a9d9fbfb"><ac:plain-text-body><![CDATA[ | Ins. Estad. | A1_INSCR | IE | customerIdentificationDocuments[].documentNumber ; customerIdentificationDocuments[].identificationDocumentAcronym | Não |
]]></ac:plain-text-body></ac:structured-macro> | |||||
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="1f6b38d9-79bb-4d9f-b8bc-2d7a35b4876d"><ac:plain-text-body><![CDATA[ | RG/Ced.Estr | A1_PFISICA | RG | customerIdentificationDocuments[].documentNumber ; customerIdentificationDocuments[].identificationDocumentAcronym | Não |
]]></ac:plain-text-body></ac:structured-macro> | |||||
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="f2cdef37-59ff-4de7-aaac-3887cfba401f"><ac:plain-text-body><![CDATA[ | Ins. Municip. | A1_INSCRM | IM | customerIdentificationDocuments[].documentNumber ; customerIdentificationDocuments[].identificationDocumentAcronym | Não |
]]></ac:plain-text-body></ac:structured-macro> | |||||
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="9b7f006b-8073-4c0e-8823-7fb37d6abbdd"><ac:plain-text-body><![CDATA[ | Suframa | A1_SUFRAMA | Suframa | customerIdentificationDocuments[].documentNumber ; customerIdentificationDocuments[].identificationDocumentAcronym | Não |
]]></ac:plain-text-body></ac:structured-macro> | ||||
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.+ |
![](/images/icons/linkext7.gif)
|
![](/images/icons/linkext7.gif)
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: