RN Integracao Magis5

Regra de negócio do tipo habilitadora que pode ser acoplada ao DataPlus ERP e tem o objetivo configurar e manipular a integração entre API Magis5 e o DataPlusERP, podendo ser acessada pela tela de integração do sistema.

Acoplamento

Essa regra de negócio só poder acoplada à entidade Comum.IntegracaoDadosExternos ou Infra.ControleAvisos(). Ela está preparada para funcionar com o elemento ExecutaOperacao, sendo seu designador por Execução e tempo de execução Depois.

Essa regra de negócio foi adaptada para também funcionar no dpServer. Quando executada pelo dpServer, seu comportamento é restrito à consulta e integração de pedidos, não abrangendo outras operações disponíveis.

Além disso, algumas propriedades são exclusivas do dpServer e devem ser configuradas apenas quando a execução ocorrer nesse ambiente, como PeriodoExecucao, GerarLog e UsuariosParaNotificacao. Esses parâmetros controlam o agendamento, e notificações das execuções automáticas realizadas.

Parâmetros

UrlEcommerce: Url do e-commerce;

StatusPedido: Status do pedido (do e-commerce) a ser considerado na busca de dados: ready_to_print é o status que a Magis garante que está pronto para ser criado o pedido no ERP e faturado

Token: Token recebido pela Magis após contratar o serviço de API (Sem esse token a integração não funciona).

StatusCliente: Código do status de pessoa para clientes trazidos do e-commerce;

RamoAtividadeCodigo: Código do ramo de atividade padrão para a gravação dos clientes;

DefinirEnqFiscal: Define o enquadramento fiscal do cliente ao integrá-lo;

EnqFiscalPessoaFisica: Código do enquadramento fiscal padrão para Pessoa Fisica ao integrar o cliente;

EnqFiscalPessoaJuridica: Código do enquadramento fiscal padrão para Pessoa Jurídica ao integrar o cliente;

NumeroListaPrecoProdutos: Lista de Preços para realizar o envio dos produtos para o web service;

QtdeEstoque: Quantidade de estoque fixa a ser enviada;

IntegracaoMagalu : Possui integração com a Magalu (se marcada esta opção, é removido os pontos do código do produto;

EmpresaReceptora: Empresa em que a regra será executada.;

DiasPrazoEntrega: Prazo de entrega padrão, a partir da emissão, para pedidos (quantidade de dias);

SituacaoCodigo: Código da situação padrão para a gravação dos pedidos;

PortadorCodigo: Código do portador padrão para a gravação dos pedidos;

TransportadoraCodigo: Código da transportadora padrão para a gravação dos pedidos;

OpSaidaCodigo: Código da operação de saída padrão para a gravação dos pedidos;

RepresentanteCodigo: Código do representante padrão para a gravação dos pedidos;

TelevendasCodigo: Código do televendas padrão para a gravação dos pedidos;

CaracteristicaCodigo: Código da característica de venda padrão para a gravação dos pedidos;

TipoFrete: Tipo de frete;

DescontoPessoaFisica: Desconto para cliente pessoa física.

CanalConfigurado: Informe o nome dos canais separados por vírgula. Exemplo: Shopee, Mercado Livre, Magazine Luiza. Cada nome de canal está associado à configuração de parcela única.

ValorCanalConfigurado: Informe U para parcela única ou N para não parcela única, separados por vírgula e mantendo a sequência da propriedade CanalPagaParcelaUnica. Exemplo: U, N, U.

IdsLojas: ID das lojas (separadas por ponto e vírgula), que são utilizadas para coleta de pedidos.

NomeImpressoraEtiquetas: Nome da impressora para impressão de etiquetas.

Propriedades de filtro de pedidos:

É possível informar os níveis da família nas listas.

AnaliseParaInclusao : Código das famílias dos produtos presentes nos pedidos que serão integrados na empresa. Informar separados por ponto e vírgula (Ex.: 10; 11.01);

AnaliseParaExclusao: Código das famílias dos produtos presentes nos pedidos que serão excluídos na empresa. Informar separados por ponto e vírgula (Ex.: 10; 11.01).

Obs: O critério adotado é que, caso um produto atenda ao filtro, o pedido inteiro é integrado ou ignorado.

Para o seu funcionamento adequado, é necessário configurar duas regras na empresa responsável pelo faturamento dos pedidos que devem ser ignorados nas demais:

• 1ª Regra: Deve conter apenas o(s) ID(s) da(s) loja(s) referente(s) à empresa configurada.
• 2ª Regra: Deve conter o(s) ID(s) das demais lojas, excluindo aquelas presentes na primeira regra. Esta regra deve ser preenchida com a lista de inclusão (família incluída na lista de exclusão da regra das outras empresas).

Observação: As regras das demais empresas devem estar configuradas utilizando a lista de exclusão.

Propriedades exclusivas para o dpServer:

PeriodoExecucao: Período que a regra será executada. Informar em minutos ex.: 60 (dpServer).

GerarLog: Gera uma log dos pedidos retornados com o mesmo nome da regra (dpServer).

UsuariosParaNotificacao: Código dos usuários que receberão a notificação (Separar por vírgula Ex: 1,2,3) (dpServer)

OBSERVAÇÃO IMPORTANTE

É necessário cadastrar todas as formas de parcelamento possíveis que podem ser recebidas de cada marketplace. Para que o sistema identifique que essa condição de pagamento está vinculada à integração da Magis, a descrição deve conter o nome "magis", seguido de um traço e a quantidade de parcelas correspondentes. Por exemplo: magis-1x, magis-2x, magis-3x. Certifique-se de cadastrar todas as opções necessárias para garantir o correto funcionamento da integração. Caso não for configurado o CanalConfigurado e ValorCanalConfigurado ele vai pegar por padrao a configuração magis-1x.