Integrações

Páginas filhas
  • 7 - Campos customizados

Versões comparadas

Versão antiga 3

changes.mady.by.user William Rodrigues de Mello

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user William Rodrigues de Mello

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Existem dois tipos de variáveis na integração entre Protheus e CRM: totvs_crm_exportation_totvscrmexportation* e totvs_crm_importation_totvscrmimportation*

Abaixo a tabela explicando:

VariávelTipoExplicação
totvs_crm_importation_customer_custom_fieldstotvscrmimportationcustomercustomfieldsImportaçãovariável que contém os campos customizados a serem importados para o cadastro de cliente do CRM
totvs_crm_exportation_customer_custom_fieldstotvscrmexportationcustomercustomfieldsExportaçãovariável que contém os campos customizados a serem exportados para o cadastro de cliente do Protheus
totvs_crm_importation_product_custom_fieldstotvscrmimportationproductcustomfieldsImportaçãovariável que contém os campos customizados a serem importados para o cadastro de produto do CRM
totvs_crm_exportation_order_item_custom_fieldstotvscrmexportationorderitemcustomfieldsExportaçãovariável que contém os campos customizados dos itens do pedido a ser exportados para o cadastro de cliente do Protheustotvs_crm_exportation_order_header_custom_fields
totvscrmexportationorderheadercustomfieldsExportaçãovariável Exportaçãovariável que contém os campos customizados do cabeçalho do pedido a ser exportados para o cadastro de cliente do Protheus
totvscrmimportationstockwarehouseexcludesImportação8 - Estoques por Armazéns
totvscrmimportationsharinglevelImportação9 - Parâmetro de Nível de compartilhamento de filiais do Protheus
totvscrmtenantidImportação/exportaçãoEmpresa/filial caso o cliente não tenha um ambiente REST específico para o TOTVS CRM.


7.2 - Localização das variáveis

Após você publicar pacote, elas estarão localizadas nas variáveis do iPaaS, segue uma imagem de exemplo:você deverá criá-las no componente Data Storage, como mostram as imagens abaixo:

Image Added

Image AddedImage Removed


7.3 - Definição/esqueleto do modelo

...

Importante: para campos do tipo option-list é removido o caractere _ (underline) do nome da tag, isso foi um pedido do time de serviços, pois o CRM não permite adicionar valor numérico em um campo de lista de opções. Exemplo: _00152, caso o valor da lista for esse, é deixado somente 00152 para envio ao Protheus.


7.5 - Cenários atendidos

Essa entrega atende os seguintes cenários:

...

Abaixo está um exemplo completo com todas as propriedades e tipos de cada entidade:


Ordem de Venda (cabeçalho)Ordem de Venda (items)ClienteProduto
IMPORTAÇÃONão PossuiiNão Possui
[
    {
        "CRM": "_codigobacen",
        "DEFAULT": "000999",
        "ERP": "Content.AddFields.A1_CODBACEN",
        "HUB": "extraText6",
        "SIZE": "100",
        "TYPE": "option-list"
    },
    {
        "CRM": "_quantidadedefilhos",
        "DEFAULT": 0,
        "ERP": "Content.QuantidadeFilhos",
        "HUB": "extraNumber1",
        "SIZE": "100",
        "TYPE": "integer"
    },
    {
        "CRM": "_nome",
        "DEFAULT": "SEM NOME",
        "ERP": "Content.Nome",
        "HUB": "extraText1",
        "SIZE": "100",
        "TYPE": "string"
    },
    {
        "CRM": "_pagaimposto",
        "DEFAULT": false,
        "ERP": "Content.PagaImposto",
        "HUB": "extraBoolean1",
        "SIZE": "100",
        "TYPE": "boolean"
    },
    {
        "CRM": "_valormaquinas",
        "DEFAULT": 0,
        "ERP": "Content.ValorMaquinas",
        "HUB": "extraText4",
        "SIZE": "100",
        "TYPE": "numeric"
    },
    {
        "CRM": "_quantidadefazendas",
        "DEFAULT": 0,
        "ERP": "Content.AddFields.A1_QTFAZENDAS",
        "HUB": "extraNumber2",
        "SIZE": "100",
        "TYPE": "integer"
    },
    {
        "CRM": "_faturamento",
        "DEFAULT": 0,
        "ERP": "Content.AddFields.A1_FATURAMENTO",
        "HUB": "extraText5",
        "SIZE": "100",
        "TYPE": "numeric"
    },
    {
        "CRM": "_temanimal",
        "DEFAULT": false,
        "ERP": "Content.AddFields.A1_TEMANIMAL",
        "HUB": "extraBoolean2",
        "SIZE": "100",
        "TYPE": "boolean"
    },
    {
        "CRM": "_sobrinho",
        "DEFAULT": "SEM NOME",
        "ERP": "Content.AddFields.A1_NOMESOBRINHO",
        "HUB": "extraText2",
        "SIZE": "100",
        "TYPE": "string"
    },
    {
        "CRM": "_telefone",
        "DEFAULT": "",
        "ERP": "Content.ListOfCommunicationInformation.0.PhoneNumber",
        "HUB": "extraText3",
        "SIZE": "100",
        "TYPE": "string"
    }
]
[
    {
        "CRM": "_codigoAdicional",
        "DEFAULT": 0,
        "ERP": "Content.ManufacturerCode",
        "HUB": "extraText1",
        "SIZE": "100",
        "TYPE": "string"
    },
    {
        "CRM": "_status",
        "DEFAULT": false,
        "ERP": "Content.Active",
        "HUB": "extraBoolean1",
        "SIZE": "100",
        "TYPE": "boolean"
    },
    {
        "CRM": "_precoVenda",
        "DEFAULT": 0,
        "ERP": "Content.Values.SalesPrice",
        "HUB": "extraText2",
        "SIZE": "100",
        "TYPE": "numeric"
    },
    {
        "CRM": "_loteMinimo",
        "DEFAULT": 0,
        "ERP": "Content.MinimumLot",
        "HUB": "extraNumber1",
        "SIZE": "100",
        "TYPE": "integer"
    },
    {
        "CRM": "_codigoBarra",
        "DEFAULT": "000999",
        "ERP": "Content.AddFields.B1_CODBAR",
        "HUB": "extraText3",
        "SIZE": "100",
        "TYPE": "option-list"
    }
]
EXPORTAÇÃO[
    {
        "CRM": "_codigobacen",
        "DEFAULT": "000999",
        "ERP": "AddFields.C5_CODBACEN",
        "HUB": "extraText6",
        "SIZE": "100",
        "TYPE": "option-list"
    },
    {
        "CRM": "_quantidadevendedores",
        "DEFAULT": 0,
        "ERP": "QuantidadeVendedores",
        "HUB": "extraNumber1",
        "SIZE": "100",
        "TYPE": "integer"
    },
    {
        "CRM": "_numeroPedidoCRM",
        "DEFAULT": "000000",
        "ERP": "C5_NUMEROCRM",
        "HUB": "extraText1",
        "SIZE": "100",
        "TYPE": "string"
    },
    {
        "CRM": "_tementrega",
        "DEFAULT": false,
        "ERP": "TemEntrega",
        "HUB": "extraBoolean1",
        "SIZE": "100",
        "TYPE": "boolean"
    },
    {
        "CRM": "_valorcomissao",
        "DEFAULT": 0,
        "ERP": "ValorComissao",
        "HUB": "extraText4",
        "SIZE": "100",
        "TYPE": "numeric"
    },
    {
        "CRM": "_quantidadereservada",
        "DEFAULT": 0,
        "ERP": "AddFields.C5_QTDERESERV",
        "HUB": "extraNumber2",
        "SIZE": "100",
        "TYPE": "integer"
    },
    {
        "CRM": "_valorbonificado",
        "DEFAULT": 0,
        "ERP": "AddFields.C5_VALORBONIF",
        "HUB": "extraText5",
        "SIZE": "100",
        "TYPE": "numeric"
    },
    {
        "CRM": "_combinado",
        "DEFAULT": false,
        "ERP": "AddFields.C5_COMBINADO",
        "HUB": "extraBoolean2",
        "SIZE": "100",
        "TYPE": "boolean"
    },
    {
        "CRM": "_orientacao",
        "DEFAULT": "SEM NOME",
        "ERP": "AddFields.C5_ORIENTACAO",
        "HUB": "extraText2",
        "SIZE": "100",
        "TYPE": "string"
    }
]		[
    {
        "CRM": "_codigobacen",
        "DEFAULT": "000999",
        "ERP": "AddFields.C6_CODBACEN",
        "HUB": "extraText6",
        "SIZE": "100",
        "TYPE": "option-list"
    },
    {
        "CRM": "_quantidadevendedores",
        "DEFAULT": 0,
        "ERP": "QuantidadeVendedores",
        "HUB": "extraNumber1",
        "SIZE": "100",
        "TYPE": "integer"
    },
    {
        "CRM": "_codigoProdutoCRM",
        "DEFAULT": "000000",
        "ERP": "AddFields.C6_CODPRODCRM",
        "HUB": "extraText1",
        "SIZE": "100",
        "TYPE": "string"
    },
    {
        "CRM": "_tementrega",
        "DEFAULT": false,
        "ERP": "TemEntrega",
        "HUB": "extraBoolean1",
        "SIZE": "100",
        "TYPE": "boolean"
    },
    {
        "CRM": "_valorcomissao",
        "DEFAULT": 0,
        "ERP": "ValorComissao",
        "HUB": "extraText4",
        "SIZE": "100",
        "TYPE": "numeric"
    },
    {
        "CRM": "_quantidadereservada",
        "DEFAULT": 0,
        "ERP": "AddFields.C6_QTDERESERV",
        "HUB": "extraNumber2",
        "SIZE": "100",
        "TYPE": "integer"
    },
    {
        "CRM": "_valorbonificado",
        "DEFAULT": 0,
        "ERP": "AddFields.C6_VALORBONIF",
        "HUB": "extraText5",
        "SIZE": "100",
        "TYPE": "numeric"
    },
    {
        "CRM": "_combinado",
        "DEFAULT": false,
        "ERP": "AddFields.C6_COMBINADO",
        "HUB": "extraBoolean2",
        "SIZE": "100",
        "TYPE": "boolean"
    },
    {
        "CRM": "_orientacao",
        "DEFAULT": "SEM NOME",
        "ERP": "AddFields.C6_ORIENTACAO",
        "HUB": "extraText2",
        "SIZE": "100",
        "TYPE": "string"
    }
]
[
    {
        "CRM": "_codigobacen",
        "DEFAULT": "000999",
        "ERP": "AddFields.A1_CODBACEN",
        "HUB": "extraText6",
        "SIZE": "100",
        "TYPE": "option-list"
    },
    {
        "CRM": "_quantidadedefilhos",
        "DEFAULT": 0,
        "ERP": "QuantidadeFilhos",
        "HUB": "extraNumber1",
        "SIZE": "100",
        "TYPE": "integer"
    },
    {
        "CRM": "_nome",
        "DEFAULT": "SEM NOME",
        "ERP": "Nome",
        "HUB": "extraText1",
        "SIZE": "100",
        "TYPE": "string"
    },
    {
        "CRM": "_pagaimposto",
        "DEFAULT": false,
        "ERP": "PagaImposto",
        "HUB": "extraBoolean1",
        "SIZE": "100",
        "TYPE": "boolean"
    },
    {
        "CRM": "_valormaquinas",
        "DEFAULT": 0,
        "ERP": "ValorMaquinas",
        "HUB": "extraText4",
        "SIZE": "100",
        "TYPE": "numeric"
    },
    {
        "CRM": "_quantidadefazendas",
        "DEFAULT": 0,
        "ERP": "AddFields.A1_QTFAZENDAS",
        "HUB": "extraNumber2",
        "SIZE": "100",
        "TYPE": "integer"
    },
    {
        "CRM": "_faturamento",
        "DEFAULT": 0,
        "ERP": "AddFields.A1_FATURAMENTO",
        "HUB": "extraText5",
        "SIZE": "100",
        "TYPE": "numeric"
    },
    {
        "CRM": "_temanimal",
        "DEFAULT": false,
        "ERP": "AddFields.A1_TEMANIMAL",
        "HUB": "extraBoolean2",
        "SIZE": "100",
        "TYPE": "boolean"
    },
    {
        "CRM": "_sobrinho",
        "DEFAULT": "SEM NOME",
        "ERP": "AddFields.A1_NOMESOBRINHO",
        "HUB": "extraText2",
        "SIZE": "100",
        "TYPE": "string"
    }
]
Não Possui