Páginas filhas
  • Manual Operacional da Customização - Integração VTEX Orquestrador DN

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Informações
iconfalse

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.

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.

A Interface está disponível no menu: TOTVS Educacional | Sistema Indústria | Integração VTEX | Monitor de Vendas  | Anexo  | Dados bancários


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
Informações
iconfalse

Toggle Cloak
Exportação Consulta de ClientesPedidos VTEX

Cloak

Após consulta dos Pedidos (conforme citado no item anterior), é realizada a exportação 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. Esse processo exporta todos os dados consultados, realizando primeiramente uma identificação de cadastro de cliente pré-existente no 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.
Informações
iconfalse

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 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 CampoObservações
EmpresaEmpresaCódigo da empresa PROTHEUS - Valor fixo 01
FilialFilialCódigo da filial - Valor fixo: 03DN0001
CPFCNPJCPF/CNPJCPF/CNPJ do cliente
A1_PESSOATipo PessoaF - Pessoa física / J: Pessoa jurídica
A1_NOMENome PessoaNome do responsável financeiro
A1_INSCRInscrição EstadualPessoa física: Isento / Pessoa jurídica: Código de cadastro informado pelo cliente. Quando não preenchido: Isento
A1_INSCRMInscrição MunicipalPessoa física: Isento / Pessoa jurídica: Código de cadastro informado pelo cliente. Quando não preenchido: Isento;
A1_ENDEndereçoLogradouro do residência do cliente
A1_COMPLEMComplementoComplemento do residência do cliente
A1_CEPCEPCEP do cliente
A1_BAIRROBairroBairro do cliente
A1_ESTEstadoEstado do cliente
A1_COD_MUNCódigo do MunicípioCódigo do Município do cliente 
A1_MUNMunicípioMunicípio do cliente
A1_DDIDDIDDI do cliente
A1_DDDDDDDDD do cliente
A1_TELTelefoneTelefone do cliente
A1_PAISCódigo do PaísCódigo do país do cliente - Valor fixo 105
A1_EMAILE-mailE-mail do cliente
A1_SIMPNACSimples NacionalPessoa física: Valor fixo 2 / Pessoa jurídica: 1 para optante e 2 para não optante;
A1_CONTRIBContribuinte ICMSPessoa 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_CNAECódigo CNAEQuando 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
iconfalse

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 BoletoDurante 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
  • 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
iconfalse

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.

Esse processo pode ser executado de forma manual através do Menu: TOTVS Educacional | Sistema Indústria | Integração VTEX | Monitor de Vendas  | Anexo  | Dados bancários

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 CampoObservações
EmpresaEmpresaCódigo da empresa PROTHEUS - Valor fixo 01
FilialFilialCódigo da filial - Valor fixo: 03DN0001
CPFCNPJCPF/CNPJCPF/CNPJ do Fornecedor
A2_TIPOTipo PessoaF - Pessoa física / J: Pessoa jurídica
A2_NOMENome PessoaNome do Fornecedor
A2_INSCRInscrição EstadualPessoa física: Isento / Pessoa jurídica: Código de cadastro informado pelo fornecedor. Quando não preenchido: Isento
A2_INSCRMInscrição MunicipalPessoa física: vazio / Pessoa jurídica: Código de cadastro informado pelo fornecedor.
A2_ENDEndereçoLogradouro do residência do fornecedor
A2_COMPComplementoComplemento do residência do fornecedor
A2_CEPCEPCEP do fornecedor
A2_BAIRROBairroBairro do fornecedor
A2_ESTEstadoEstado do fornecedor
A2_COD_MUNCódigo do MunicípioCódigo do Município do fornecedor
A2_MUNMunicípioMunicípio do fornecedor
A2_DDIDDIDDI do fornecedor
A2_DDDDDDDDD do fornecedor
A2_TELTelefoneTelefone do fornecedor
A2_PAISCódigo do PaísCódigo do país do fornecedor - Valor fixo 105
A2_EMAILE-mailE-mail do cliente
A2_BANCOBancoBanco informado nos Dados Bancários
A2_AGENCIAAgênciaAgencia informada nos Dados Bancários
A2_XDVAGEDígito da AgenciaDígito da Agencia informado nos Dados Bancários
A2_NUMCONContaConta informada nos Dados Bancários
A2_XDVCTADígito da ContaDígito da Conta informado nos Dados Bancários
A2_CNAECódigo CNAEQuando 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.
Informações
iconfalse

Toggle Cloak
Exportação de Contas a Pagar

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


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

...