Histórico da Página

...

Expandir

title	Consulta de Pedidos VTEX

O processo de consulta de pagamentos VTEX, identifica os dados associados aos pagamentos das vendas realizadas e/ou canceladas. Os dados de Pedidos VTEX, enviados para o PROTHEUS, serão consultados por este processo (Maiores detalhes sobre o processo, cliquei aqui), mas será acrescentados a consulta dos campos abaixo:

CNAE;
Inscrição Municipal;
Aderiu ao Simples;
Inscrição Estadual.

Para pedidos Cancelados na VTEX:

Caso o pedido com status cancelado na VTEX, já possuir registro no Monitor de Vendas (já exportado para o PROTHEUS) será enviado os dados para inclusão de Pagamento no PROTHEUS.
Caso o pedido cancelado ainda não possua registro no Monitor de Vendas, primeiramente será feito a Exportação de Cliente para o PROTHEUS (descrito no próximo item) e posteriormente o envio dos dados para inclusão de Pagamento no Protheus.

Expandir

title	Exportação de Clientes para PROTHEUS

Após consulta dos Pedidos (conforme citado no item anterior), a realizada a exportação de para o PROTHEUS. Esse processo exporta todos os dados consultados, realizando primeiramente uma identificação de cadastro de cliente pré-existente no PROTHEUS.

Para clientes que já possuem cadastro no PROTHEUS, seu cadastro será atualizada caso necessário.
Para clientes que ainda não possuem cadastro, seu cadastro será criado no PROTHEUS.

Esse processo pode ser agendado ou executado de forma manual através do Menu: TOTVS Educacional l Customização l Orquestrador VTEX l Exportação de Dados para o PROTHEUS.

As informações associadas ao cadastro de cliente enviadas ao PROTHEUS são:

Empresa: Código da empresa PROTHEUS - Valor fixo 01;
Filial: Código da filial - Valor fixo: 03DN0001;
CPF/CNPJ;
Tipo Pessoa: F - Pessoa física / J: Pessoa jurídica;
Nome Pessoa: Nome do responsável financeiro;
Inscrição Estadual: Pessoa física: Isento / Pessoa jurídica: Código de cadastro informado pelo cliente. Quando não preenchido: Isento;
Inscrição Municipal: Pessoa física: Isento / Pessoa jurídica: Código de cadastro informado pelo cliente. Quando não preenchido: Isento;
Endereço/Telefone: Inclui Logradouro, complemento, CEP, bairro, estado, código e nome da cidade, DDI/DDD, telefone;
País: Valor fixo 105;
E-mail;
Simples Nacional: Pessoa física: Valor fixo 2 / Pessoa jurídica: 1 para optante e 2 para não optante;
Contribuinte ICMS: Pessoa física: Valor fixo 2 / Pessoa jurídica: Se possuir inscrição estadual - valor fixo 2, se não possuir inscrição estadual - envia vazio;
País: Valor fixo 01058;
Código CNAE: Quando informado pelo cliente, enviado conforme a máscara/formato: 9999-9/99. Quando não localizado no PROTHEUS, será apresentado erro, registrado no monitor de LOG da integração.

Expandir

title	Cliente Seller

A identificação de um cliente Seller (Pessoa jurídica) é realizada a partir da verificação do campo: Nome do Seller no cadastro do Item do pedido no Monitor de Vendas.

Cliente Não Seller: Corresponde a Loja Principal DN.
Cliente Seller: Corresponde às Lojas DR's e Parceiros.

Para cliente do tipo: Seller cujo CNPJ já se encontra cadastrado no PROTHEUS, não será aplicada nenhuma atualização ao PROTHEUS. Já para um cliente do tipo: Seller que não tenha o CNPJ localizado/cadastrado no PROTHEUS, será apresentada uma mensagem de erro, gravado no monitor de LOG da integração.

Quando identificado mais de um cadastro de cliente associado a um mesmo CPF/CNPJ o processos executará as validações:

Identificação do código de cliente;
Venda realizada na Loja DN;
Venda realizada na Loja dos Sellers (DR's/Parceiros).

Informações
A customização verifica os itens do pedido, visto que, podem existir clientes diferentes para cada item de um mesmo pedido. O item do pedido não tem relação somente com o produto comprado, mas também com o cliente tipo: Seller.

...

Expandir

title	Movimentação do Pedido VTEX

Sempre que a exportação de contas a receber é enviada com Sucesso para o PROTHEUS; é enviado automaticamente para plataforma VTEX, uma atualização para que o Pedido passe do status: Pronto para manuseio para Faturado.

Através da consulta ao Monitor de Log, será possível consultar o status da movimentação do pedido.

Essa atualização pode ser visualizada na tela do Monitor de Vendas, no campo Status Pedido:

Image Added

O campo Status Protheus, também exibido na tela do Monitor de Vendas, a cada tentativa de Integração do Pedido com o PROTHEUS, terá seu valor atualizando, considerando:

Não Integrado - indicando que o Pedido será exportando na próxima execução do processo de Integração
Integrado com Sucesso: Indicando que o pedido foi exportado com Sucesso para o PROTHEUS.
Integração com erro - Indicando que o podido não foi exportado, por algum erro/validação.

Caso ocorra algum erro durante esse envio para plataforma VTEX, o usuário poderá consultar para que os ajustes necessários sejam providenciados.Image Removed

Expandir

title	Monitor de Log

O Monitor de Log, disponível em: TOTVS Educacional | Sistema Indústria | Orquestrador VTEX | Monitor de Log, armazena os dados exportados dos registros relacionados à Integração VTEX, possibilitando o acompanhamento e identificação dos registros exportados e importados com sucesso ou que necessitam ser reenviados.

A funcionalidade é baseada em duas visões, sendo a primeira o valor de registro principal e a segunda (Item Log) representando os detalhes de cada situação do registro princiapal.

Ao clicar sobre um registro de log, o usuário poderá consultar as demais informações complementares associadas ao registro, tais como:

Id Log: Identificador sequencial de Log;
Campos Chave: Descrição dos campos utilizados para gerar o registro integrado;
Valores Chave: Chave primária do registro integrado;
Status: Situação da Integração (Sucesso ou Erro);
Funcionalidade: Tipo de Processo que está sendo feito (Por exemplo: Exportação de Dados);
Data de Criação: Data de Criação do registro;
Data da última alteração: Data da última alteração do registro;
Número de tentativas de Reenvio: Quantidade de vezes que um registro já foi reenviado;
Criador por: Usuário responsável pela inclusão do registro;
Alterado Por: Usuário responsável pela alteração do registro;
Módulo: Orquestrador VTEX.

Image Modified

No item de log terá disponível para consulta os seguintes campos:

Id. Item Log: Identificador sequencial de log.;
Id. Log: Identificador sequencial de log;
Mensagem: Mensagem com o status da integração do item;
Status: Situação da integração do item selecionado;
Dados Enviados: Relação dos dados enviados para integração;
Dados Recebidos: Relação dos dados recebidos;
Data de Criação: Data de criação do registro;
Data da Última Alteração: Data da última alteração do registro.

Image Modified

Aviso

title	Observação:

Os registros apresentados no monitor de log leitura não poderão ser manipulados, ou seja, não será permitido ao usuário realizar alterações como inclusão, edição e exclusão.

Expandir

title	Monitor de Log - Processo de Reenvio de Dados

Através do Monitor de Log, o usuário poderá processar o reenvio ao PROTHEUS dos registros que apresentam status de erro ou pendente, ou seja, que não foram exportados corretamente.
O processo de reenvio está disponível para execução em: TOTVS Educacional | Sistema Indústria | Orquestrador VTEX | Monitor de Log | Processos | Reenvio de DadosLog.

Image Modified

O reenvio poderá ser executado de duas formas, a saber:

Manualmente: Quando executado de forma manual, ao acessar o monitor de log, será permitido o usuário selecionar apenas um único registro com o status de erro ou pendente por vez. Após selecionar o registro a ser reenviado, o usuário deverá clicar em: Processos l Reenvio de Log.
Automático: O envio automático, ou seja, via agendamento, se aplica a todos os registros gravados no monitor de log que apresentem status de erro ou pendente, conforme o número máximo de tentativas parametrizadas.

Ao processar o reenvio de log, a customização tentará realizar novamente o envio das informações ao PROTHEUS. Uma vez reenviado, o registro terá o seu status alterado para: Sucesso.

Aviso

title	Observações:

Caso o parâmetro (Número Máximo de tentativas) esteja vazio, a customização não realizará nenhuma tentativa de reenvio automaticamente;
Quando o número máximo de tentativas de reenvio for atingido e em nenhuma das tentativas tenha retornado sucesso, a customização passará o status do registro para Cancelado e, desta forma, não integrado ao PROTHEUS. Dependendo do erro ocorrido, o usuário precisará acessar o Monitor de log e analisar os logs, corrigir os registros (caso necessário) e então acionar o processo de reenvio.

Expandir

title	Atualização do Processo para Consulta de Pagamentos VTEX

A partir da necessidade de atualização do processo de consulta de pagamentos VTEX é possível identificar pedidos com status: Cancelado.

Image RemovedUma vez identificado, será verificado se este pedido foi exportado ao PROTHEUS em algum momento com status: Integrado com sucesso.
Para registros que já tenham sido exportados com status: Integrado com sucesso, a API Pagamentos Incluir PROTHEUS será acionada, enviando as seguintes informações:

Empresa: Código da empresa PROTHEUS - Valor fixo 01;
Filial: Código da filial - Valor fixo: 03DN0001;
Data de Cancelamento do Pedido VTEX: A data de cancelamento será enviada no formato AAAAMMDD;
Forma de Pagamento: CC - Cartão de Crédito / CD - Cartão de Débito / BOL - Boleto / PIX - Pagamento via PIX;
Código da Ordem: Número do pedido;
Código do Fornecedor: CPF/CNPJ vinculado ao pedido;
Código do Banco: Banco vinculado a conta bancária do cliente para depósito/devolução;
Código do Dígito Verificador da Agência: Agência correspondente à conta bancária do cliente para depósito/devolução;
Código da Conta Bancária: Conta bancária correspondente à agência e banco do cliente para depósito/devolução;
Código do Dígito Verificador da Conta Bancária: Dígito verificador correspondente à conta bancária do cliente para depósito/devolução;
Valor: Valor de cada parcela do pedido.

Aviso

title	Observação:

Para registros não localizados com status: Integrado com sucesso, ou seja, que não foram exportados com status, a API Pagamentos Incluir PROTHEUS será acionada, realizando a exportação do cliente e contas a receber, aplicando um registro ao monitor de vendas e, em seguida, acionando a API para inclusão de pagamento

.

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 18

Nova versão 19

Chave