| Passo a Passo: As compras via e-commerce do Vtex possuem uma integração com a rotina de Cadastro de Clientes (MATA030) do Protheus, assim, ao realizar uma compra pelo site, é incluído um cadastro para o cliente da compra na tabela de Clientes do Protheus (SA1). | O Importador XML é uma opção de integração do XMl via Schedule do Configurador, sem a necessidade de se contratar os serviços da Neogrid, porém o cliente será responsável por realizar o download de um XML válido e o inserir manualmente na pasta INN do Importador XML para que seja lido e integrado ao Protheus. A funcionalidade foi disponibilizada a partir da release 12.1.25, releases anteriores não tem acesso a funcionalidade:  Image Added
O documentos atendidos pelo Importador Xml no módulo Faturamento são:  Image Added
Premissas para o funcionamento da integração: - É necessário a configuração do parâmetro MV_TCNEW, conforme as informações abaixo no item CONFIGURAÇÕES;
- O ambiente precisa conter a licença 3100 (TOTVS_COLAB_ONDEMAND) - Obrigatório (DI_Integração_TOTVS_Colaboração_2_0_EDI_de_Vendas);
- A existências das tabelas do Totvs Colaboração é obrigatória: CKQ (Monitor Doc. TOTVS Colaboração), CKO (Controle de Arq.TOTVS Colaboração.), CKP (Parâmetros TOTVS Colaboração) e CKOCOL (Realacionada a tabela "CKO");
Com todos os itens acima, a integração será feita normalmente. Observação: O parâmetro MV_SPEDCOL não terá efeito sobre a integração.Neste processo, algumas particularidades precisam ser avaliadas:
| Deck of Cards |
|---|
| startHidden | false |
|---|
| effectDuration | 0.5 |
|---|
| id | Inclusão / Edição do Cadastro de ClienteImportador XML - Faturamento |
|---|
| effectType | horizontal |
|---|
| loopCards | true |
|---|
| | Card |
|---|
| default | true |
|---|
| id | Custo MédioImportador XML - Faturamento |
|---|
| label | Edição de um cadastro já existente | | Configurações |
|---|
| 1. Configurar o parâmetro MV_IMPXML (SX6) que informa se utiliza importador XML, o default é F | Expandir |
|---|
|  Image Added
|
2. Configurar os parâmetro abaixo que são requisitados no processo: MV_TCNEW - Tipos de documentos transmitidos via Importador XML (0=TODOS;1=NFe;2-CTe;3=NFSe;4=MDe;5=MDfe;6=Recebimento). Exemplo: 6 MV_COLEDI - Informa qual ou quais códigos dos arquivos que serão importados. MV_CROSFAT - Define se utiliza a Prog. Entrega ou o Ped. Venda no CrossDocking. 1-Não utiliza, 2-Prog.de Entrega, 3-Pedido Vendas (Valor default: 1) | Expandir |
|---|
| title | Configuração de parâmetros |
|---|
|  Image Added
 Image Added
 Image Added
|
3. Renomeie o nome da tabela CKO (X2_ARQUIVO) para CKOCOL. Salve a tabela e atualize o dicionário de dados. | Expandir |
|---|
| title | CKOCOL - Ajuste do nome da tabela |
|---|
|  Image Added
 Image Added
 Image Added
|
4. Configurar o agent Schedul e os jobs COLAUTOREAD e MA411JOB para que a integração ocorra: | Expandir |
|---|
| title | Inclusão e Leitura do XML da Pasta Inn para a Pasta Lidos |
|---|
| 1. Criação do Agent Schedul Acesse o Configurador (SIGACFG) e vá nas opções do menu Ambiente -> Schedule -> Schedule: Clique em Agent/Cadastro e clique no ícone conforme imagem para criação do agent: Obs: Deve incluir um "Agent" e ativá-lo.  Image Added
2. Em Agendamento/Cadastro, inclua os Jobs COLAUTOREAD e MA411JOB:  Image Added
 Image Added
| Aviso |
|---|
| O Job SCHEDCOMCOL é para tratar apenas a importação da nota de entrada , se somente ele estiver configurado com o Job COLAUTOREAD , o XML do pedido de venda não será lido. Para que o XML do pedido seja lido e importado para geração do pedido de vendas no módulo faturamento, é imprescindível que o Job MA411JOB esteja configurado nos agendamentos do Schedule em conjunto com o Job COLAUTOREAD. |
| Informações |
|---|
| Em caso de necessidade de acionamento do JOB MA411Job via StartJob será necessário informar o "parm1".
Este sendo um array contendo os dados de empresa, filial e usuário. | Variável | Tipo | Descrição |
|---|
| aParam | array | Vetor contendo informações para inicialização do ambiente para o Job:
aParam[1] = Empresa (Exemplo: "T1") aParam[2] = Filial (Exemplo: "D SP 01") aParam[3] = Usuário (Exemplo: "admin") |
Exemplo de uso: User Function USAJOB()
Local aParam := {}
aAdd(aParam,"T1")
aAdd(aParam,"D MG 01")
aAdd(aParam,"admin")
StartJob( "MA411JOB", GetEnvServer(),.T., aParam)
Return |
|---|
|
|
5. Criar dentro da Pasta System , a pasta XML , pois caso ocorra erros de integração, o sistema irá gerar um arquivo chamado "Order" que passará as informações que precisam ser corrigidas. Eventualmente também pode criar o arquivo "deliveryschedule_salesorder, caso haja inconsistência no pedido no momento da integração, por exemplo, não ter encontrado a condição de pagamento no Protheus que está sendo informada no XML. | Expandir |
|---|
|  Image Added
|
6.Informar o mesmo CNPJ do XML no cadastro de Filial para que não gere erro na integração de não encontrar o pedidos no servidor: | Expandir |
|---|
| title | Preenchimento do CNPJ na Filial de Importação |
|---|
| 1. Informações do XML:  Image Added
2.Informação do CNPJ na Filial:  Image Added
|
7. Criação da estrutura de pastas do Importador XML - Inn, Lidos e Out, e informar o caminho das pastas nos parâmetros MV_NGINN, MV_NGLIDOS e MV_NGOUT. | Expandir |
|---|
| title | Inclusão e Leitura do XML da Pasta Inn para a Pasta Lidos |
|---|
| 1. Criação da estrutura de Pastas:  Image Added
 Image Added
2. Informar o path nos parâmetros MV_NGINN, MV_NGLIDOS e MV_NGOUT:  Image Added
 Image Added
 Image Added
|
Na inclusão de uma venda no e-commerce, o Vtex envia para o Protheus um arquivo Json com as informações do cliente que devem ser incluídas na tabela de Clientes (SA1), como neste exemplo:  Image Removed
O sistema irá verificar dentro deste arquivo Json, o código do "InternalId" como verificamos abaixo:  Image Removed
Avaliando pela tabela de “De/Para” (XXF), o sistema irá verificar se o cliente já existe na tabela de cadastro (SA1), caso ele já exista, o sistema irá editar o cadastro já existente com as informações enviadas no arquivo Json, caso não exista, o sistema irá cadastrar um novo cliente. |
| Card |
|---|
| default | true |
|---|
| id | 060720201Importador XML - Faturamento |
|---|
| label | Processo |
|---|
| 1. Para importar o XML deve ser inserido na pasta IN manualmente, visto que o processo não possui integração com a Neogrid para carregar na pasta automaticamente: | de um novo cadastroAlgumas empresas têm necessidade de que o sistema realize um novo cadastro de cliente sempre que no e-commerce for realizada uma alteração de endereço. Ou seja, caso seja realizada uma alteração no endereço de um cliente na compra pelo site, o sistema não deve alterar os dados do cadastro já existente, ele precisa criar um novo cadastro. No release 12.1.33 do Protheus, foi criado o parâmetro “MV_INTVTX” (https://tdn.totvs.com/x/-JCjJ), ao habilitar o parâmetro (.T.), o sistema ignora a validação do “InternalId” e realiza a criação de um novo cadastro sempre que alterados os dados do endereço do cliente no e-commerce. | Aviso |
|---|
| Clientes em Releases anteriores à 12.1.33 necessitam utilizar o ponto de entrada: Para que o sistema possa realizar o cadastro de dois ou mais clientes com o mesmo código de CPF/CNPJ, porém com endereço diferente, é necessário configurar os parâmetros “MV_VALCPF” e “MV_VALCNPJ” como 1 |
|
| Pode lhe interessar:| e Leitura do XML da Pasta Inn para a Pasta Lidos |
| 1. Xml inserido manualmente na pasta INN:  Image Added
2. Start do Console do Server.Ini para execução dos Jobs de tarefas do Importador XML  Image Added
3. Xml lido pelos Jobs , transferido da pasta Inn pra Lidos.  Image Added
|
2.Verificar o arquivo Order se possui alguma inconsistência a ser corrigida. Geralmente para que a integração funcione é preciso ter cadastrado no Protheus: Cliente, Produto, Condição de Pagamento, TES de acordo com o que o XML apresenta, pois a falta dos itens que o pedido precisa para ser gerado irão gerar inconsistências no arquivo Order e poderá gerar também o arquivo "deliveryschedule_salesorder". | Expandir |
|---|
| title | Exemplo de configuração |
|---|
| Cliente O cadastro precisa conter o cnpj enviado no Xml:  Image Added
 Image Added
Produto O cadastro precisa conter o código de barras contido no XML:  Image Added
 Image Added
Condição de Pagamento O cadastro precisa conter o código de barras contido no XML:  Image Added
 Image Added
Obs.: Não utilize a condição de pagamento de tipo 09, pois esta condição depende de interface para inserção das parcelas e datas, por se tratar de rotina automática, tal processo não é possível.
TES TES: É obtido por meio do campo B1_TS, caso não encontre, busca no parâmetro MV_FATTSPD.  Image Added
|
3.A informação de que o processo foi devidamente executado pelo Schedule pode ser visto no Console do Server.ini e também no retorno do arquivo Order. | Expandir |
|---|
| title | Exemplo de configuração |
|---|
| Console  Image Added
Order  Image Added
|
4. Na tabela CKOCOL, também demonstrará que o XML foi lido ou não, basta consultar o campo de CKO_FLAG. Se estiver como 1 , significa que foi gerado com sucesso.  Image Added
O sistema também informa qual foi o xml lido e integrado no campo CKO_ARQXML:  Image Added
5. Pedido gerado no Protheus:  Image Added
 Image Added
 Image Added
Demonstração em vídeo: Vídeo de uso do Importador XML.7z |
| Card |
|---|
| default | true |
|---|
| id | Importador XML - Faturamento |
|---|
| label | Possíveis Inconsistências |
|---|
|
|
|
|
