Histórico da Página

A parametrização da customização da API PROTHEUS 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.

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.

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

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

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

O processo de exportação de contas a receber envia os valores pagos no VTEX para o PROTHEUSAPI 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 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: 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.

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.

Sempre  que a exportação de contas a receber é enviada com Sucesso para o 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.

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

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.