Histórico da Página

...

Expandir

title	Premissas

Liberação dos anexos customizados na árvore de perfil:
Os anexos da customização - Integração VTEX devem ser liberados nas permissões de perfil dos usuários para aparecerem nos seus respectivos lugares. Para mais detalhes de como liberar no perfil dos usuários acesse o Manual de Instalação de Customizações na seção: Liberando Acesso aos Menus.

Expandir

title	Parâmetros da Customização

Parametrização

A parametrização da customização da API PROTHEUS deverá ser realizada de modo que sejam configurados os parâmetros customizados para informação do endereço e dados de acesso para as API's do PROTHEUS, disponível em: TOTVS Educacional | Customização l Orquestrador VTEX l Parâmetros.

Na interface, os parâmetros processam a autenticação BASIC nas API's de exportação do PROTHEUS, para os quais o usuário deverá efetuar as seguintes parametrizações:

Endereço Webservice PROTHEUS: Endereço do webservice utilizado para exportação de clientes, contas a receber e cancelamentos do PROTHEUS;
Token: Token de autenticação do webservice PROTHEUS;
Número máximo de tentativas de reenvio: Quantidade de vezes que um registro deve ser reenviado, em caso de erro.

...

Expandir

title	Exportação de Clientes para PROTHEUS

Exportação Cliente para PROTHEUS

A exportação de clientes que realizaram compras/pedidos através da plataforma VTEX para o PROTHEUS, é realizada a partir da interface customizada, que realiza a verificação de um cadastro do cliente pré-existente no PROTHEUS.
Identificado o cadastro de cliente, será aplicada a atualização a partir da mesma API (PUT). Já para um novo cliente, será criado um novo cadastro no PROTHEUS (POST).
A interface está disponível em: 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: 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 na API PROTHEUS, será apresentado erro, registrado no monitor de LOG da integração.

Expandir

title	Cliente Seller

Cliente Seller

A identificação de um cliente Seller (Pessoa jurídica) é realizada a partir da verificação do campo: Items->Seller no método de consulta pedido VTEX, considerando os tipos:

Cliente Não Seller: Campo items preenchido valor: 1, corresponde a Loja DN.
Cliente Seller: Campo items preenchido valor diferente de: 1, corresponde às Lojas DR's e Parceiros.

Tela VTEX com destaque do campo ITEMS
Assim, 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.
No entanto, 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: Será utilizado para consulta o método Clientes, com o verbo HTTP GET, e considerado o campo A1_CGC para análise do código do cliente (conforme documentação de API disponibilizada pelo SENAI DN);
Venda realizada na Loja DN: Será considerado o cadastro que NÃO contém letras no seu código de cliente;
Venda realizada na Loja dos Sellers (DR's/Parceiros): Será considerado o cadastro que contém letras no seu código de cliente.

Observação: A customização irá verificar 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	Exportação de Contas a Receber para PROTHEUS

Exportação de Contas a Receber para PROTHEUS

O processo de exportação de contas a receber para o PROTHEUS envia as informações financeiras associadas aos pedidos realizados na plataforma VTEX, com status: "ready-for-handling (Pronto para manuseio)".

Image Modified

A partir da verificação do Item de Pedido, a customização irá identificar os itens pagos no mesmo para envio a API, através do método de recebimentos (HTTP POST), onde serão enviados os dados da transação, valores e parcelas que compõem o pedido, tais como:

Empresa: Código da empresa PROTHEUS - Valor fixo 01;
Filial: Código da filial - Valor fixo: 03DN0001;
Data da Venda do Pedido;
Forma de Pagamento: CC - Cartão de Crédito / CD - Cartão de Débito / BOL - Boleto / PIX - Pagamento via PIX;
ID VTEX: Código OrderID do pedido;
Código do Cliente;
Loja do Cliente;
Pedido de Venda: Vazio;
Número do Cartão: Quando utilizado os métodos de pagamento CC - Cartão de Crédito ou CD - Cartão de Débito;
Código da Autorização: Quando utilizado os métodos de pagamento CC - Cartão de Crédito ou CD - Cartão de Débito;
NSU: Quando utilizado os métodos de pagamento CC - Cartão de Crédito ou CD - Cartão de Débito;
Nosso Número: Quando utilizado o método de pagamento BOL - Boleto Bancário;
Código da Linha Digitável do Boleto Gerado: Quando utilizado o método de pagamento BOL - Boleto Bancário;
Código TXID Transação PIX: Quando utilizado o método de pagamento PIX - Pagamento via PIX;
Valor: Valor de cada parcela do pedido.

Expandir

title	Contas a Receber Seller

Contas a Receber Seller

A identificação de contas a receber provenientes de vendas/pedidos de clientes tipo Seller, é realizada a partir da verificação do código apropriado no campo Items, no método de consulta pedido VTEX.

Cliente Seller: Campo items preenchido valor diferente de: 1, corresponde às Lojas DR's e Parceiros.

Observação: Clientes do tipo Não Seller terão o campo items preenchido valor: 1, correspondente a Loja DN, não sendo portanto considerados na relação de conta a receber seller.
Desta forma, quando identificado um pedido/venda associada a um cliente do tipo seller, os mesmos serão agrupados por cliente e será verificado o código do cliente (A1_COD) registrado na API do PROTHEUS a partir do envio do CNPJ registrado no campo: CSCIdentification da plataforma VTEX e consultado através da API Get Seller by ID.
A seguir, apresentamos os exemplos:
Exemplo 1:
Pedido Id: 122550
Valor: R$ 300,00
Itens do Pedido:

Curso A: Valor R$ 100,00 - Comissão: R$ 10,00 - Seller: SENAI Bahia
Curso B: Valor R$ 100,00 - Loja Principal DN
Curso C: Valor R$ 100,00 - Comissão: R$ 10,00 - Seller: SENAI Bahia

Verificados os itens do pedido, serão enviadas ao PROTHEUS duas contas a receber, conforme:

Conta a receber 01: Correspondente ao cliente SENAI Bahia - Valor R$ 20,00
Conta a receber 02: Com cliente Loja Principal DN - Valor R$ 100,00

Exemplo 2:
Pedido Id: 122551
Valor: R$ 400,00
Itens do Pedido:

Curso A: Valor R$ 100,00 - Comissão: R$ 10,00 - Seller: SENAI Bahia
Curso B: Valor R$ 100,00 - Loja Principal DN
Curso C: Valor R$ 100,00 - Comissão: R$ 10,00 - Seller: SENAI Bahia
Curso D: Valor R$ 100,00 - Comissão: R$ 10,00 - Seller : SENAI Acre
Curso C: Valor R$ 100,00 - Comissão: R$ 10,00 - Seller: SENAI Bahia

Verificados os itens do pedido, serão enviadas ao PROTHEUS três contas a receber, conforme:

Conta a receber 01: Correspondente ao cliente SENAI Bahia - Valor: R$ 20,00
Conta a receber 02: Correspondente ao cliente SENAI Acre - Valor: R$ 10,00
Conta a receber 03: Correspondente ao cliente Loja Principal DN - Valor: R$ 100,00

Contas a Receber Seller - Cálculo da Comissão
O cálculo do valor correspondente a comissão a partir das vendas/pedidos de clientes do tipo Seller, é realizado considerando:
Valor do percentual da comissão (Campo items: Commission) x o Valor do Item (Campo items: sellingPrice).
Assim, conforme o exemplo, temos:
Pedido Id: 122552
Valor: R$ 100,00
Comissão: 10%
Itens do Pedido:

Curso A: Valor R$ 100,00

Total Comissão Seller SENAI Bahia: R$ 10,00
Importante: Este será o valor enviado apenas para itens vendidos por Seller no campo: E1_VALOR dividido pelo número de parcelas.
Caso o pagamento tenha sido parcelado, os valores serão enviados divididos pelo número de parcelas do pagamento do Pedido.
Pedido Id: 122552
Valor: R$ 300,00
Parcelamento: 02 Parcelas
Itens do Pedido:

Curso A: Valor R$ 100,00 - Comissão: R$ 10,00 - Seller: SENAI Bahia
Curso B: Valor R$ 100,00 - Loja Principal DN
Curso C: Valor R$ 100,00 - Comissão: R$ 10,00 - Seller: SENAI Bahia

Verificados os itens do pedido dividido em 2X, serão enviadas ao PROTHEUS duas contas a receber, conforme:

Conta a receber 01: Correspondente ao cliente SENAI Bahia - Valor R$ 20,00

02 parcelas de R$10,00 (cada).

Conta a receber 02: Correspondente ao cliente Loja Principal DN - Valor R$ 100,00

02 parcelas de R$50,00 (cada).

Expandir

title	Movimentação do Pedido VTEX

Movimentação do Pedido VTEX

Através da consulta ao Monitor de Log, será possível consultar o status da movimentação do pedido.
Verificado o envio com sucesso de contas a receber dos pedidos/vendas realizados na plataforma VTEX à API PROTHEUS, a customização retornará uma atualização à plataforma VTEX para que o pedido seja movimentado. A partir desta atualização, o pedido terá o status: Pronto para Manuseio alterado para: Faturado.

Image Modified

Expandir

title	Monitor de Log

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.

Image Modified

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 Added

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:

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

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 Dados.

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:

Observações:

Caso o parâmetro 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

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 Modified

Uma 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:

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 9

Nova versão 10

Chave