Histórico da Página

...

Objetivo
Este documento foi elaborado para orientar aos usuários - chave do SENAI DN sobre os requisitos e funcionalidades do Orquestrador, customização aplicada ao TOTVS Educacional (SGE) que atua na integração entre a API do Protheus (que é de gestão do SENAI DN) e a Plataforma VTEX. A partir da leitura dos dados das vendas/pedidos realizados pela plataforma VTEX, o Orquestrador envia as informações para as API 's do PROTHEUS SENAI DN retornando o status da integração à plataforma VTEX.

Público Alvo
Este manual é destinado aos colaboradores selecionados como usuários - chave para o Template Digital, SENAI DN.

...

Aviso
Esse projeto não trata exportação exportações para o PROTHEUS (integração nativa), mas sim, para uma API do PROTHEUS que é exclusiva e de gestão do SENAI DN.

expand

Informações

icon

title

false

Toggle Cloak

Premissas

Cloak

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

o Manual de Instalação de

Customizações na

Customizações na seção: Liberando Acesso aos Menus.

Image Removedexpand

Informações

icon

title

false

Toggle Cloak

Parâmetros da Customização

Cloak

A parametrização da customização da API do PROTHEUS deverá ser realizada de modo que sejam configurados as informações do endereço e dados de acesso para as API's do PROTHEUS (SENAI DN).

Essa parametrização está disponível em: TOTVS Educacional | Customização l Orquestrador VTEX l Parâmetros.

Image Removed

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.

Image Removed

Informaçõesexpand

icon

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 a API PROTHEUS DN, 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.

false

Toggle Cloak

Anexo Dados Bancários - Monitor de Vendas [Novo!]

Cloak

Foi disponibilizado um novo anexo para informar os dados bancários do cliente, a fim de facilitar o cadastramento deste como fornecedor no Protheus para a realização do estorno.

Ao acessar a interface, será possível inserir os Dados Bancários do Fornecedor.

Os campos não serão de preenchimento obrigatório, porém, a partir do momento em que o usuário preencher um dos campos, eles se tornam de preenchimento obrigatório, exceto o Dígito da Agência.

Ao clicar no botão Salvar, uma mensagem aparecerá informando que o envio do Fornecedor ao Protheus foi iniciado.

Informações

icon	false

Toggle Cloak

Consulta de Pedidos VTEX

Cloak

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 a API PROTHEUS DN, 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.

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.

Image Removed

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

icon	false

Toggle Cloak

Exportação de Clientes

Cloak

Após consulta dos Pedidos (conforme citado no item anterior), é realizada a exportação para a API PROTHEUS DN. 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

Expandir

title	Exportação de Clientes

Após consulta dos Pedidos (conforme citado no item anterior), é realizada a exportação para a API PROTHEUS DN. 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.

Image Removed

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

Campo Protheus	Campo	Observações
Empresa	Empresa

:

Código da empresa PROTHEUS - Valor fixo 01

;


Filial	Filial

:

Código da filial - Valor fixo: 03DN0001

;


CPFCNPJ	CPF/CNPJ	CPF/CNPJ

;

do cliente
A1_PESSOA	Tipo Pessoa

:

F - Pessoa física / J: Pessoa jurídica

;


A1_NOME	Nome Pessoa

:

Nome do responsável financeiro

;


A1_INSCR	Inscrição Estadual

:

Pessoa física: Isento / Pessoa jurídica: Código de cadastro informado pelo cliente. Quando não preenchido: Isento

;


A1_INSCRM	Inscrição Municipal

:

	Pessoa física: Isento / Pessoa jurídica: Código de cadastro informado pelo cliente. Quando não preenchido: Isento;
A1_END	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

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.

	Logradouro do residência do cliente
A1_COMPLEM	Complemento	Complemento do residência do cliente
A1_CEP	CEP	CEP do cliente
A1_BAIRRO	Bairro	Bairro do cliente
A1_EST	Estado	Estado do cliente
A1_COD_MUN	Código do Município	Código do Município do cliente
A1_MUN	Município	Município do cliente
A1_DDI	DDI	DDI do cliente
A1_DDD	DDD	DDD do cliente
A1_TEL	Telefone	Telefone do cliente
A1_PAIS	Código do País	Código do país do cliente - Valor fixo 105
A1_EMAIL	E-mail	E-mail do cliente
A1_SIMPNAC	Simples Nacional	Pessoa física: Valor fixo 2 / Pessoa jurídica: 1 para optante e 2 para não optante;
A1_CONTRIB	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;
A1_CNAE	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.

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

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.

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, conforme citado anteriormente.

Informações

icon	false

Toggle Cloak

Exportação de Contas a Receber

Cloak

O processo de exportação de contas a receber envia os valores pagos no VTEX para API do PROTHEUS (SENAI DN). Enviando as informações financeiras associadas aos pedidos realizados na plataforma VTEX, que estejam com status: Pronto para manuseio.

O usuário deve utilizar o mesmo processo de exportação de cliente, uma vez que não será possível enviar clientes e contas a receber separadamente.

Neste processo serão enviados os dados da transação, valores e parcelas que compõem o pedido de acordo com a forma de pagamento:

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

Expandir

title	Exportação de Contas a Receber

O processo de exportação de contas a receber envia os valores pagos no VTEX para API do PROTHEUS (SENAI DN). Enviando as informações financeiras associadas aos pedidos realizados na plataforma VTEX, que estejam com status: Pronto para manuseio.

O usuário deve utilizar o mesmo processo de exportação de cliente, uma vez que não será possível enviar clientes e contas a receber separadamente.

Image RemovedNeste processo 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:

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

NSU: Quando utilizado

o

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

Estado

colour	Green
title	Exemplo

Pedido Id: 122550
Valor Total do Pedido: R$ 300,00
Itens do Pedido:

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

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

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

EstadocolourYellowtitle*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 x o Valor do Item .

Este será o valor enviado apenas para itens vendidos por Seller, 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.

Image Removed

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

Informações

title	Pagamentos por PIX ou Boleto

Durante o processo de envio de Contas a receber, quando identificado que um pedido é da modalidade de pagamento pix ou boleto, a customização consultará o valor do repasse do Monitor de Vendas. Não será realizada a soma do repasse de cada item

contasReceber

debitoCartão de Débito

Dados utilizados pela integração quando a forma de pagamento é por cartão de débito:

Campo Protheus	O que envia?	Observações
Empresa	Empresa	Código da empresa PROTHEUS - Valor fixo 01
Filial	Filial	Código da filial - Valor fixo: 03DN0001
Data_Venda	Data da Venda do Pedido	Data da Venda do Pedido
E1_XFORMPG	Forma de Pagamento	CC - Cartão de Crédito / CD - Cartão de Débito / BOL - Boleto / PIX - Pagamento via PIX
E1_XIDVTEX	OrderID VTEX	Código do pedido no VTEX
E1_CLIENTE	Código do Cliente	Código do Cliente
E1_LOJA	Loja do Cliente	Loja do Cliente
E1_XCLIORI	Código do Seller no Protheus	Código cliente DR ou Parceiro - Para DN envia vazio
E1_XLJORIG	Loja do Seller no Protheus	Loja DR ou Parceiro - Para DN envia vazio
E1_XCOMIS	Valor da Comissão (repasse)	Valor da Comissão (repasse) - Para DN envia 0.00
E1_PEDIDO	Pedido de Venda	Pedido de Venda
E1_CARTAO	Número do Cartão	Numero do cartão de crédito ou cartão de débito
E1_CARTAUT	Código da Autorização	Código de autorização do cartão
E1_NSUETF	NSU	NSU do cartão
E1_XVLRDR	Valor total da Venda Seller	Valor total da Venda Seller - Caso seja DN envia 0.00
E1_XQPARDR	Quantidade de Parcelas Venda DR	Quantidade de Parcelas Venda DR - Caso seja DN envia 0
parcelas (E1_VALOR)	Parcelas	Valor de cada parcela do pedido

creditoCartão de Crédito

Dados utilizados pela integração quando a forma de pagamento é por cartão de crédito:

Campo Protheus	O que envia?	Observações
Empresa	Empresa	Código da empresa PROTHEUS - Valor fixo 01
Filial	Filial	Código da filial - Valor fixo: 03DN0001
Data_Venda	Data da Venda do Pedido	Data da Venda do Pedido
E1_XFORMPG	Forma de Pagamento	CC - Cartão de Crédito / CD - Cartão de Débito / BOL - Boleto / PIX - Pagamento via PIX
E1_XIDVTEX	OrderID VTEX	Código do pedido no VTEX
E1_CLIENTE	Código do Cliente	Código do Cliente
E1_LOJA	Loja do Cliente	Loja do Cliente
E1_XCLIORI	Código do Seller no Protheus	Código cliente DR ou Parceiro - Para DN envia vazio
E1_XLJORIG	Loja do Seller no Protheus	Loja DR ou Parceiro - Para DN envia vazio
E1_XCOMIS	Valor da Comissão (repasse)	Valor da Comissão (repasse) - Para DN envia 0.00
E1_PEDIDO	Pedido de Venda	Pedido de Venda
E1_CARTAO	Número do Cartão	Numero do cartão de crédito ou cartão de débito
E1_XVLRDR	Valor total da Venda Seller	Valor total da Venda Seller - Caso seja DN envia 0.00
E1_XQPARDR	Quantidade de Parcelas Venda DR	Quantidade de Parcelas Venda DR - Caso seja DN envia 0
parcelas (E1_VALOR)	Parcelas	Valor de cada parcela do pedido

boletoBoleto

Dados utilizados pela integração quando a forma de pagamento é por boleto:

Campo Protheus	O que envia?	Observações
Empresa	Empresa	Código da empresa PROTHEUS - Valor fixo 01
Filial	Filial	Código da filial - Valor fixo: 03DN0001
Data_Venda	Data da Venda do Pedido	Data da Venda do Pedido
E1_XFORMPG	Forma de Pagamento	CC - Cartão de Crédito / CD - Cartão de Débito / BOL - Boleto / PIX - Pagamento via PIX
E1_XIDVTEX	OrderID VTEX	Código do pedido no VTEX
E1_CLIENTE	Código do Cliente	Código do Cliente
E1_LOJA	Loja do Cliente	Loja do Cliente
E1_XCLIORI	Código do Seller no Protheus	Código cliente DR ou Parceiro - Para DN envia vazio
E1_XLJORIG	Loja do Seller no Protheus	Loja DR ou Parceiro - Para DN envia vazio
E1_XCOMIS	Valor da Comissão (repasse)	Valor da Comissão (repasse) - Para DN envia 0.00
E1_PEDIDO	Pedido de Venda	Pedido de Venda
E1_XIDTRAN	Código da Transação	Código da Transação
E1_NUMBCO	Nosso Número Boleto	Nosso Número Boleto
E1_CODDIG	Código da Linha Digitável do Boleto Gerado	Código da Linha Digitável do Boleto Gerado
E1_XVLRDR	Valor total da Venda Seller	Valor total da Venda Seller - Caso seja DN envia 0.00
E1_XQPARDR	Quantidade de Parcelas Venda DR	Quantidade de Parcelas Venda DR - Caso seja DN envia 0
parcelas (E1_VALOR)	Parcelas	Valor de cada parcela do pedido

pixPix

Dados utilizados pela integração quando a forma de pagamento é por PIX:

Campo Protheus	O que envia?	Observações
Empresa	Empresa	Código da empresa PROTHEUS - Valor fixo 01
Filial	Filial	Código da filial - Valor fixo: 03DN0001
Data_Venda	Data da Venda do Pedido	Data da Venda do Pedido
E1_XFORMPG	Forma de Pagamento	CC - Cartão de Crédito / CD - Cartão de Débito / BOL - Boleto / PIX - Pagamento via PIX
E1_XIDVTEX	OrderID VTEX	Código do pedido no VTEX
E1_CLIENTE	Código do Cliente	Código do Cliente
E1_LOJA	Loja do Cliente	Loja do Cliente
E1_XCLIORI	Código do Seller no Protheus	Código cliente DR ou Parceiro - Para DN envia vazio
E1_XLJORIG	Loja do Seller no Protheus	Loja DR ou Parceiro - Para DN envia vazio
E1_XCOMIS	Valor da Comissão (repasse)	Valor da Comissão (repasse) - Para DN envia 0.00
E1_PEDIDO	Pedido de Venda	Pedido de Venda
E1_XIDTRAN	Código da Transação	Código da Transação
E1_XTXID	Código TXID Transação PIX	Código TXID Transação PIX
E1_XDTHRPX	Data Venda	Data Hora do Pix
E1_XVLRDR	Valor total da Venda Seller	Valor total da Venda Seller - Caso seja DN envia 0.00
E1_XQPARDR	Quantidade de Parcelas Venda DR	Quantidade de Parcelas Venda DR - Caso seja DN envia 0
parcelas (E1_VALOR)	Parcelas	Valor de cada parcela do pedido

Informações

icon	false

Toggle Cloak

Exportação de Contas a Receber Seller

Cloak

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, conforme citado anteriormente.

GreenExemplo

Pedido Id: 122550
Valor Total do Pedido: R$ 300,00
Itens do Pedido:

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

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

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

Yellow*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 x o Valor do Item .

Este será o valor enviado apenas para itens vendidos por Seller, 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$ 100,00
Comissão: 10%
Itens do Pedido:

Curso A: Valor R$ 100,00

Total Comissão Seller SENAI Bahia: R$ 10,00
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).

Pagamentos por PIX ou Boleto

Durante o processo de envio de Contas a receber, quando identificado que um pedido é da modalidade de pagamento pix ou boleto, a customização consultará o valor do repasse do Monitor de Vendas. Não será realizada a soma do repasse de cada item

Informações

icon	false

Toggle Cloak

Exportação de Fornecedor [Novo!]

Cloak

O processo de Exportação ao Protheus

Após salvar os dados do anexo Dados Bancários, é realizada a exportação do Fornecedor para a API PROTHEUS DN. Esse processo exporta todos os dados consultados, realizando primeiramente uma identificação de cadastro de fornecedor pré-existente no PROTHEUS.

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

Assim que os dados forem salvos, será gerado um Job para realizar a exportação para a API PROTHEUS DN.

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

Campo Protheus	Campo	Observações
Empresa	Empresa	Código da empresa PROTHEUS - Valor fixo 01
Filial	Filial	Código da filial - Valor fixo: 03DN0001
CPFCNPJ	CPF/CNPJ	CPF/CNPJ do Fornecedor
A2_TIPO	Tipo Pessoa	F - Pessoa física / J: Pessoa jurídica
A2_NOME	Nome Pessoa	Nome do Fornecedor
A2_INSCR	Inscrição Estadual	Pessoa física: Isento / Pessoa jurídica: Código de cadastro informado pelo fornecedor. Quando não preenchido: Isento
A2_INSCRM	Inscrição Municipal	Pessoa física: vazio / Pessoa jurídica: Código de cadastro informado pelo fornecedor.
A2_END	Endereço	Logradouro do residência do fornecedor
A2_COMP	Complemento	Complemento do residência do fornecedor
A2_CEP	CEP	CEP do fornecedor
A2_BAIRRO	Bairro	Bairro do fornecedor
A2_EST	Estado	Estado do fornecedor
A2_COD_MUN	Código do Município	Código do Município do fornecedor
A2_MUN	Município	Município do fornecedor
A2_DDI	DDI	DDI do fornecedor
A2_DDD	DDD	DDD do fornecedor
A2_TEL	Telefone	Telefone do fornecedor
A2_PAIS	Código do País	Código do país do fornecedor - Valor fixo 105
A2_EMAIL	E-mail	E-mail do cliente
A2_BANCO	Banco	Banco informado nos Dados Bancários
A2_AGENCIA	Agência	Agencia informada nos Dados Bancários
A2_XDVAGE	Dígito da Agencia	Dígito da Agencia informado nos Dados Bancários
A2_NUMCON	Conta	Conta informada nos Dados Bancários
A2_XDVCTA	Dígito da Conta	Dígito da Conta informado nos Dados Bancários
A2_CNAE	Código CNAE	Quando informado pelo fornecedor, 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.

Exportação de Contas a Pagar

Informações

icon	false

Toggle Cloak

Exportação de Contas a Pagar

Cloak

Expandir

title

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

Sempre que o processo de consulta de pagamentos VTEX, identificar vendas com status cancelado é gerado um 'contas a pagar', conforme detalhado abaixo:

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 menu acima) e posteriormente o envio dos dados para inclusão de Pagamento no Protheus.

titleinfo

Aviso

PIX e Boleto

Para pedidos cancelados e que a forma de pagamento seja PIX ou Boleto, caso os dados bancários do Cliente não estejam preenchidos, não ocorrerá a exportação de contas a pagar.

A exportação de contas a pagar, considera a devolução total do valor do cancelamento.
Serão considerados tanto cancelamento feito diretamente na VTEX, quanto os realizados via SGE.
As regras de cancelamento, também se aplicam para os pedidos identificados como Cancelado Chargeback. (Para maiores informações Clique aqui).

expand

Informações

icon

title

false

Toggle Cloak

Movimentação do Pedido VTEX

Cloak

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

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

Image Removed

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.

expand

Informações

icon

title

false

Toggle Cloak

Monitor de Log

Cloak

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

principal.

Image Removed

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 Removed

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 Removedtitle

Aviso

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.

Para informações sobre Alteração Status Logs com Erro e o processo de Exclusão de Logs no monitor, acesse o Manual Operacional da Customização - LIB DN

title

Informações

icon	false

Toggle Cloak

Expandir

Monitor de Log - Processo de Reenvio de Dados

Cloak
Através do Monitor de Log, o usuário poderá processar o reenvio a API 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 Log.

Image Removed

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.

title

Aviso

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 (SENAI DN). 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.

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 25

Nova versão Atual

Chave