MBBC4000
MBB SWT Varejo e Sales Card Capture
ATENÇÃO
- O programa está desabilitado, pois estará aprovado para utilização a partir do dia 08/04/2019.
- Qualquer necessidade de liberação antecipada, será preciso efetuar alteração do campo "Descr. Servidor" do programa ("CADA9000"). Importante ressaltar, que qualquer ajuste anterior ao período "08/04/2019", é de responsabilidade do concessionário.
MBBC4000
MBB SWT Varejo e Sales Card Capture
Geração Arquivo Controle de Venda SWT - MBB
O SWT (SAP Wholesale Template) é o novo sistema de vendas para Automóveis e Vans da Mercedes Benz do Brasil e o MBBC4000 realiza a integração entre ele e o DMS (Sisdia).
O MBBC4000 busca, a partir da tabela de Notas Fiscais CNNFCAPA, todas as notas de venda de veículos novos (passeio e utilitários (Vans), baseada no tipo de veículo ('CADV0170'), e gera um arquivo magnético a ser transmitido para a MBB.
O envio do arquivo é feito via FTP e pode ser realizado várias vezes ao dia e a qualquer momento. Além disso, não há limite de veículos por arquivo.
Campos
- Período: informe a data inicial e data final desejadas de faturamento das notas fiscais de vendas de veículos
Wiki Markup *Nome do Arquivo{*}: o nome do arquivo será "MBBR_\[CódigoDoConcessionário\]_\[Timestamp\].csv" onde, *MBBR* é um código fixo; *CódigoDoConcessionário* é o número do concessionário no SWT; e *Timestamp* é a data/hora da criação do arquivo no formato "AAAAMMDD_HHmmss".
Requisitos/Parametrização
- Uma cópia do arquivo "sftp_m
Âncora _Hlt535842543 _Hlt535842543
bÂncora _Hlt535842544 _Hlt535842544 Âncora _Hlt535921582 _Hlt535921582
b.sh", disponibilizado pela Linx, deve estar no diretório "/usr/bin" do servidor, com total permissão de acesso.Âncora _Hlt535921583 _Hlt535921583 - Incluir os parâmetros para cada filial no programa MBBN0200, conforme orientação dos dados enviados pela MBB. Atenção: verifique a documentação do MBBN0200 para tratamento da chave de acesso.
- Parametrizar o diretório que deseja gerar o arquivo no programa COPE0100.
- Cadastrar o MBBC4000 no programa COPE0300
- Campos:
- Programa: MBBC4000
- Descrição: Geração Arquivo Controle de Venda – SWT
- Nome DLL: deixar em branco
- Col.Relat:0
- Opções: deixar em branco
- Sig (Bandeira): MBA ou MBB
- Módulos: não alterar
- Campos:
- Cadastrar o MBBC4000 no programa COPE0700
- Campos:
- Programa: MBBC4000
- Sistema: pode ser parametrizado de acordo com o menu já existente.
- Rotina: pode ser parametrizado de acordo com o menu já existente.
- Item: 0
- Programa: MBBC4000
- Campos:
- Cadastrar o MBBC no programa COPE0800
Deve-se cadastrar autorização para o usuário que irá acessar o programa MBBC4000, de acordo com o "Sistema", "Rotina" e "Item", já parametrizados anteriormente no (COPE0700).
- Cadastrar a correlação do agente e gerente de vendas no programa CADA0144:
É necessário que seja efetuado a correlação dos campos "Gerente de Vendas" e "Vendedor", onde deverá ser informado o código do agente (CADA0310) no campo "DE" e o código SAP que represente essa pessoa no campo "PARA". Gerente de Vendas/Vendedor, e o código SAP devem ser disponibilizados pela MBB mediante solicitação dos concessionários.
- Campos:
- Sistema: SISDIA
- Entidade: coagente
- Atributo: id_agente
- Descrição: Agente SWT
- Campos:
Após confirmação, será exibida uma tela para cadastro da correlação:
- Campos para Vendedor:
- Sistema de Destino: deve ser fixo "SWT_FILIAL".
- De 1: informar o id do agente
- De 2: deixar em branco
- Para: código do vendedor na MBB
- Obs.: opcional
- Campos para Gerente de Vendas:
- Sistema de Destino: deve ser fixo "SWT_FILIAL".
- De 1: informar o id do agente que é o gerente de vendas do departamento
- De 2: deixar fixo "gerente"
- Para: código do gerente de vendas na MBB
- Obs.: opcional
- Campos para Vendedor:
- Incluir um registro no programa CADA0900 com os seguintes dados, para cada filial que fará o envio das informações:
- Campos:
- Filial: Filial onde a integração irá ocorrer
- Código de Integração: SWT_FILIAL
- Empresa Integração = Código do Concessionário da Empresa
- Filial da Integração: Código do Concessionário da Filial.
- Campos:
Não é necessário informar os demais campos não são necessários.
- Configurar permissão para o FTP:
- Acesse o servidor através do putty, logando com o usuário de acesso do Sisdia (normalmente o usuário root para o Sisdia Evolution e para o Sisdia BDS é necessário realizar esses procedimentos para todos os usuários que utilizam o MBBC4000). (Somente com usuário root?)
- Em seguida, digite o comando:
sftp -oIdentityfile=/sisdia/DMS_Brazil.key [email protected] 22
obs.: seguir orientações do MBBN0200, para criar arquivo DMS_Brazil.key
- Ao executar o comando acima, será solicitado uma confirmação de acesso, conforme imagem abaixo, informe "yes" e tecle "enter":
- Após informar "yes", será acessado o servidor da MBB, através do FTP:
- Em seguida digite "bye" e tecle "enter", para fechar a conexão:
- Com isso o FTP está configurado para o usuário do Sisdia Evolution e Sisdia BDS. Será necessário realizar o procedimento apenas uma vez por usuário, pois é criado o arquivo "known_hosts", utilizado na transferência via FTP.
Layout do arquivo gerado (.csv)
O arquivo gerado pelo MBBC4000 e enviado ao SWT, possui o seguinte layout:
Coluna
Limite de Caracteres
Mandatório (M)/ Opcional (O)
Valores possíveis/ Comentários
Exemplo
VIN
17
M
WDC0G4GW6JF422280
Categoria do Cliente
1
M
1 - Pessoa Física2 - Empresa
1
Tratamento
4
O
0002 - Sr.0003 - Empresa0006 - Sra.
0002
Nome da Empresa
35
M, caso Categoria do Cliente for 2
Nome
35
M, caso Categoria do Cliente for 1
Sobrenome
35
M, caso Categoria do Cliente for 1
CPF/ CNPJ
14
M
Sem pontos ou hífen
12345636522
Endereço
35
M
Av. Paulista
Número
10
M
23
Complemento 1
35
O
Apto. 10
Complemento 2
35
O
Cidade
40
M
São Paulo
Bairro
40
O
Centro
Estado
3
M
SP
CEP
10
M
Sem hífen
04623560
Telefone
16
M
Sem parênteses ou hífen
11912345699
Gênero
1
M, caso Categoria do Cliente for 1
M - MasculinoF - Feminino
M
E-mail
8
O
Data Nota Fiscal
100
M
DD.MM.AAAA
23.08.2018
Chave de Acesso
44
M
Chave de acesso da NF
11112222333344445555666677778888999911112222
Gerente de Vendas
10
M
Código SAP que representa essa pessoa
0000000004
Vendedor
10
M
Código SAP que representa essa pessoa
0000000005
Processo (passo a passo)
As informações do varejo de cada veículo só podem ser enviadas uma única vez. Caso a venda seja cancelada e o veículo seja vendido a outra pessoa, o concessionário deve entrar em contato com a Mercedes-Benz para solicitar o cancelamento das informações enviadas, permitindo que a nova informação seja enviada para o SWT ou inserida no DFE.
A geração e transmissão do arquivo pode ser realizada de forma manual ou automática.Geração Manual
Para realizar o envio manualmente o usuário deve acessar o MBBC4000 na filial desejada, informar o período desejado de seleção das notas fiscais e confirmar a geração. Após a geração do arquivo CSV, o envio do arquivo via FTP será acionado automaticamente.
Ao final do envio do arquivo para a MBB, o programa emite um relatório, com algumas informações do arquivo, como: Chassis, Data da Nota, CNPJ, Nome Cliente, Gerente e Vendedor.Geração Automática
Na geração automática o processo é realizado através do Crontab, no horário parametrizado e sem interação com o usuário. Ao ser acionado, a geração do arquivo no MBBC4000 é realizada utilizando a filial configurada e a data do dia. Ao final da execução o arquivo é transmitido para MBB.
IMPORTANTE: o usuário deve parametrizar o Crontab para o melhor horário de execução e envio.
Para configurar o Crontab será necessário executar os seguintes passos:- Ativação o Crontab para DMS Sisidia Desktop:
1. Conecte-se ao servidor SISDIA com o usuário root, através de uma ferramenta de transferência de arquivos entre Windows e Linux (ex: WinSCP);
2. Obtenha o shell (clicando Âncora _Hlt536102168 _Hlt536102168
aqui) e transfira o arquivo Run_Progs.sh da estação Windows para o servidor SISDIA no diretório /root/bin; Âncora _Hlt536102169 _Hlt536102169
3. Entre no servidor SISDIA via putty usando o usuário root;
4. Vá até o diretório /root/bin usando o comando:
cd /root/bin
5. Edite o arquivo Run_Progs.sh usando um editor de textos Linux;
IMPORTANTE: somente edite o arquivo pelo ambiente Linux, pois a edição em ambiente Windows insere caracteres não aceitos pelo Linux, o que causará problemas de execução.
Exemplos:
vi Run_Progs.sh <enter>
vim Run_Progs.sh <enter>
5.1. Localize o texto INFORMIXSERVER=ol_standard, caso necessário substitua a variável ol_standard pelo nome da sua instância de produção.
5.2. Localize o texto export FGLGUI=0. Algumas linhas abaixo, você encontrará o comando: cd /sisdia, caso necessário deverá substituir por:
cd "caminho do diretório de produção do SISDIA".
5.3. Localize o texto export PATH=$PATH:/sisdia, caso necessário alterar pelo diretório de produção do SISDIA.
5.4. Localize o texto fglrun. Caso esse arquivo Run_Progs.sh for utilizado por outros programas insira uma nova linha, caso contrário substitua:
fglrun mbbc4000.42r 0 'AUTO'
Obs.: o número 0 (zero) após o nome do programa indica que será executado para todas as filiais que utilizam o processo SWT. Caso queira executar apenas uma filial, informe o número correspondente a mesma no lugar do 0 (zero).
5.5. Salve as alterações realizadas no arquivo Run_Progs.sh e o feche.
Para sair e salvar digite:
<ESC> e em seguida ":x" (dois pontos + X)
Ou
<ESC> e em seguida ":wq" (dois pontos + w + q).
6. Execute no prompt do Linux o comando crontab –e
7. Será exibida uma lista com comandos de crontab. Vá até o final do arquivo e acrescente a linha abaixo:
0 22 * * * /root/bin/Run_Progs.sh 1> /root/tmp/Run_Progs1.log 2> /root/tmp/Run_Progs2.log
Obs.: No diretório /tmp serão gerados dois logs.
Run_Progs1.log esse é o log para quando a execução ocorrer normalmente.
Run_Progs2.log esse é o log que contém os erros de execução do Crontab.
8. Salve o arquivo de crontab e saia do mesmo, lembrando que para sair e salvar digite: <ESC> + :x ou <ESC> + :wq.
Após a configuração o MBBC4000 estará pronto para ser executado todos os dias às 22 horas. Modifique este tempo conforme desejar.
Mais informações sobre configuração do Crontab em http://pt.wikipedia.org/wiki/Crontab.
- Ativação de Crontab para DMS Sisidia Evolution:
1. Conecte-se ao servidor SISDIA com o usuário root, através de uma ferramenta de transferência de arquivos entre Windows e Linux (ex: WinSCP);
2. Obtenha o shell (clicando aqui) e transfira o arquivo Run_Progs_Evolution.sh da estação Windows para o servidor SISDIA no diretório /root/bin;
3. Entre no servidor SISDIA via putty usando o usuário root;
4. Vá até o diretório /root/bin usando o comando:
cd /root/bin
5. Edite o arquivo Run_Progs_Evolution.sh usando um editor de textos Linux;
IMPORTANTE: somente edite o arquivo pelo ambiente Linux, pois a edição em ambiente Windows insere caracteres não aceitos pelo Linux, o que causará problemas de execução.
Exemplos:
vi Run_Progs_Evolution.sh
vim Run_Progs_Evolution.sh
5.1. Localize o texto INFORMIXSERVER=ol_standard, caso necessário substitua a variável ol_standard pelo nome da sua instância de produção.
5.2. Localize o texto unset FGLGUI. Algumas linhas abaixo, você encontrará o comando: cd /sisdia/SisdiaEvolution, caso necessário substitua por:
cd "caminho do diretório de produção do SISDIA Evolution).
5.3. Localize o texto export PATH=$PATH:/sisdia/SisdiaEvolution, caso necessário altere pelo diretório de produção do SISDIA Evolution.
5.4. Localize o texto fglrun. Caso esse arquivo Run_Progs_Evolution.sh for utilizado por outros programas insira uma nova linha, caso contrário substitua:
fglrun mbbc4000.42r 0 'AUTO'
Obs.: o número 0 (zero) após o nome do programa indica que será executado para todas as filiais que utilizam o processo SWT. Caso queira executar apenas uma filial, informe o número correspondente a mesma no lugar do 0 (zero).
5.5. Salve as alterações realizadas no arquivo Run_Progs_Evolution.sh e o feche. Para sair e salvar digite:
Para sair e salvar digite:
<ESC> e em seguida ":x" (dois pontos + X)
Ou
<ESC> e em seguida ":wq" (dois pontos + w + q).
6. Execute no prompt do Linux o comando crontab –e
7. Será exibida uma lista com comandos de crontab. Vá até o final do arquivo e acrescente a linha abaixo:
0 22 * * * /root/bin/Run_Progs_Evolution.sh 1> /root/tmp/Run_Progs1.log 2> /root/tmp/Run_Progs2.log
Obs.: No diretório /tmp serão gerados dois logs.
Run_Progs1.log esse é o log para quando a execução ocorrer normalmente.
Run_Progs2.log esse é o log que contém os erros de execução do Crontab.
8. Salve o arquivo de crontab e saia do mesmo, lembrando que para sair e salvar digite: <ESC> + :x ou <ESC> + :wq.
Após a configuração o MBBC4000 estará pronto para ser executado todos os dias às 22 horas. Modifique este tempo conforme desejar.
Mais informações sobre configuração do Crontab em http://pt.wikipedia.org/wiki/Crontab.