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;

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.

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.