Histórico da Página

...

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

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

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 , tais comode 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: 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.

contasReceber

debitoCartão de Débito

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

Campo Protheus	Campo	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_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
E1_XQPARDR
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	Campo	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_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
E1_XQPARDR
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	Campo	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_PEDIDO	Pedido de Venda	Pedido de Venda
E1_XIDTRAN
E1_XVLRDR
E1_XQPARDR
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	Campo	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_PEDIDO	Pedido de Venda	Pedido de Venda
E1_XIDTRAN
E1_XDTHRPX
E1_XVLRDR
E1_XQPARDR
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

...

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 29

Nova versão 30

Chave