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

...

Informações
iconfalse

Toggle Cloak
Exportação de Contas a PagarFornecedor [Novo!]

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

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

Informações
iconfalse

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:

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

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

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.

Informações
iconfalse

Toggle Cloak
Exportação de Fornecedor [Novo!]

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

.

Cloak

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 CNAE



Informações
iconfalse

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

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.

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.


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

...