Contratos Scania (OFIA600)

1. Identificação da Rotina

Nome da Rotina	Contratos Scania
Programa	OFIA600
Módulo ERP	Oficina (SIGAOFI)
Acesso à Rotina	Atualizações/Contratos Scania (OFIA600)
Data da Documentação (Ultima Atualização)	14/01/2026

2. Descrição Funcional

A rotina Contratos Scania (OFIA600) tem como objetivo centralizar o gerenciamento dos contratos importados pela API ARMS, permitindo sua visualização, alteração e exclusão.

O usuário poderá consultar contratos a partir de um chassi específico, bem como atualizar, quando necessário, os campos Código do Cliente no Protheus e Loja do Cliente no Protheus.

As informações complementares de cada contrato serão organizadas em abas: Descontos, E-mail Gestores e Local Dealers, proporcionando melhor estruturação e visualização dos dados.

A rotina contará ainda com a funcionalidade “Consultar Contrato por Chassi”, que permitirá a consulta direta à API e a exibição detalhada dos dados do contrato na tela, possibilitando a atualização manual em casos de divergência ou necessidade de atualização imediata.

Através da rotina Contratos Scania(OFIA600), o usuário poderá:

Visualizar contratos importados pela API ARMS;
Atualizar a vinculação do cliente ao Protheus;
Excluir contratos, quando necessário.

3. Pré-requisitos e Configurações

Para o correto funcionamento da rotina Contratos Scania (OFIA600), é necessário garantir algumas condições que asseguram a integração com a API ARMS:

- A rotina Configurações Scania (OFIA541), aba Integração Arms deve ser preenchida com as credenciais válidas para a integração correta com a API ARMS.

4. Fluxo de Utilização

Acesse o Módulo 14 (Oficina).
Acesse o menu Atualizações → Contratos Scania (OFIA600).
No botão Consultar Contrato Chassi, preencha o campo com o número do chassi e clique no botão Ok.
No botão Alterar, altere os campos Cliente e Loja se necessário e clique no botão Confirmar.
No botão Visualizar. a tela com os dados gerais do Contrato e as abas: Desconto, E-mail Gestores e Local Dealers são exibidas.
No menu Outras Ações, para excluir um registro, clique na opção Excluir e em seguida no botão Confirmar.

Linha Microsiga Protheus > Contratos Scania PRO ARMS (OFIA600) > Consultar Contratos Scania.gif

Linha Microsiga Protheus > Contratos Scania PRO ARMS (OFIA600) > Alterar.gif

Linha Microsiga Protheus > Contratos Scania PRO ARMS (OFIA600) > Visualizar.gif

Linha Microsiga Protheus > Contratos Scania PRO ARMS (OFIA600) > Excluir.gif

5. Integrações e Dependências

Para a execução da rotina Contratos Scania(OFIA600), é necessário que a aba Integração ARMS da rotina Configurações Scania (OFIA541) esteja devidamente configurada com as credenciais válidas para a integração com a API ARMS.

É obrigatório o preenchimento dos campos das seções Token e Consulta Contrato (ARMS) com credenciais válidas, assegurando o funcionamento da integração.

Configurações Scania (OFIA541)

1. Identificação da Rotina

Nome da Rotina	Configurações Scania (OFIA541)
Programa	OFIA541
Módulo ERP	Oficina (SIGAOFI)
Acesso à Rotina	Atualizações/Configurações Scania (OFIA541)
Data da Documentação (Ultima Atualização)	14/01/2026

2. Descrição Funcional

A rotina Configurações Scania(OFIA541) tem como objetivo a inclusão de novas configurações relacionadas às integrações com a montadora na rotina Configurações Scania (OFIA541), especificamente na segunda aba denominada Integração ARMS.

A tela permitirá o cadastro dos parâmetros necessários para o consumo da API, incluindo URL base, credenciais de acesso, chaves de autenticação e demais configurações exigidas para a comunicação com o serviço.

O usuário acessará a rotina para cadastrar os dados nos campos das seções Token e Consulta Contrato(ARMS ) para a comunicação com a API de Contrato ARMS, cujas informações serão fornecidas pela plataforma WSO2 API Manager.

Caso os parâmetros já estejam previamente cadastrados, o sistema permitirá a consulta, validação e atualização dessas informações, assegurando que a integração permaneça configurada para o consumo da API.

3. Pré-requisitos e Configurações

Para o correto funcionamento da rotina Configurações Scania (OFIA541), é necessário garantir algumas pré-condições que asseguram a integração com a API ARMS:

É necessário incluir manualmente a rotina Configurações Scania (OFIA541) ao menu do Protheus DMS.

4. Fluxo de Utilização

Configuração Inicial – Configurações Scania (OFIA541)

Acesse o Módulo 14 (Oficina).
Acesse o menu Atualizações → Configurações Scania (OFIA541).
Clique na aba Integração Arms
Preencha as credenciais na sessão Token.
Preencha as credenciais da sessão Consulta Contrato e confirme.

Linha Microsiga Protheus > Contratos Scania PRO ARMS (OFIA600) > Configurações Scania.gif

5. Integrações e Dependências

Durante a execução da rotina ...

No Configurador (SIGACFG), acesse Ambientes/Cadastros/Menu (CFGX013) e informe as novas opções de menu do módulo de Oficina (SIGAOFI) conforme instruções a seguir:

Menu	Atualizações
Nome da Rotina	Contratos Scania
Programa	OFIA600
Módulo	Oficina (SIGAOFI)
Tipo	Função Protheus

Criação de campos no arquivo VW4 - Contratos Scania:

Campo	VW4_FILIAL	VW4_SEQUEN	VW4_CHASSI	VW4_NUMCTR	VW4_STATUS	VW4_TIPO
Tipo	Caractere	Caractere	Caractere	Caractere	Caractere	Caractere
Grupo de Campos	033
Ordem	01	02	03	04	05	06
Tamanho	2	10	25	12	25	2
Decimal	0	0	0	0	0	0
Formato	@!	@!	@!	@!	@!	@!
Contexto	1-Real	1-Real	1-Real	1-Real	1-Real	1-Real
Propriedade	2-Visualizar	2-Visualizar	2-Visualizar	2-Visualizar	2-Visualizar	2-Visualizar
Título	Filial	Sequencial	Chassi	Núm Contrato	Status	Tp. Contrato
Descrição	Filial	Código Sequencial Interno	Chassi do Veiculo	Número do Contrato	Status do Contrato	Código Tipo de Contrato
Val. Sistema
Opções
Inic. Padrão		GETSX8NUM("VW4","VW4_SEQUEN")
Inic. Browse
Cons. Padrão
Nível	1	1	1	1	1	1
Usado	Não	Sim	Sim	Sim	Sim	Sim
Obrigatório	Não	Não	Não	Não	Não	Não
Browse	Não	Sim	Sim	Sim	Sim	Sim
When
Pasta
Help	Filial	Código Sequencial Interno	Chassi do Veiculo	Número do Contrato	Status do Contrato	Código Tipo de Contrato.

Campo	VW4_DESTIP	VW4_CLISCN	VW4_CLIENT	VW4_LOJA	VW4_NOMCLI	VW4_NOMRD
Tipo	Caractere	Caractere	Caractere	Caractere	Caractere	Caractere
Grupo de Campos			001	002	175
Ordem	07	08	09	10	11	12
Tamanho	30	4	6	2	50	20
Decimal	0	0	0	0	0	0
Formato	@!	@!	@!	@!	@!	@!
Contexto	1-Real	1-Real	1-Real	1-Real	1-Real	1-Real
Propriedade	2-Visualizar	2-Visualizar	1-Alterar	1-Alterar	2-Visualizar	2-Visualizar
Título	Desc. Tipo	Cli. Scania	Cliente	Loja	Nome/Razão	Nome Reduz.
Descrição	Descrição Tipo Contrato	Código Cliente Scania	Código Cliente Protheus	Loja do Cliente	Nome/Razão Social	Nome Reduzido
Val. Sistema
Opções
Inic. Padrão
Inic. Browse
Cons. Padrão
Nível	1	1	1	1	1	1
Usado	Sim	Sim	Sim	Sim	Sim	Sim
Obrigatório	Não	Não	Não	Não	Não	Não
Browse	Sim	Sim	Sim	Sim	Sim	Sim
When
Pasta
Help	Descrição Tipo Contrato	Código Cliente Scania	Código Cliente Protheus	Loja do Cliente	Nome/Razão Social	Nome Reduzido

Campo	VW4_CDEAL	VW4_NMDEA	VW4_RNMDEA	VW4_DTINI	VW4_DTFIM	VW4_KMINI
Tipo	Caractere	Caractere	Caractere	Data	Data	Numérico
Grupo de Campos
Ordem	13	14	15	16	17	18
Tamanho	6	50	20	8	8	8
Decimal	0	0	0	0	0	0
Formato	@!	@!	@!			@E 99,999,999
Contexto	1-Real	1-Real	1-Real	1-Real	1-Real	1-Real
Propriedade	2-Visualizar	2-Visualizar	2-Visualizar	2-Visualizar	2-Visualizar	2-Visualizar
Título	Cód. Dealer	Nome Dealer	Dealer Reduz	Ini Vigência	Fim Vigência	KM Inicial
Descrição	Código do Dealer	Nome/Razão Social Dealer	Nome Reduzido do Dealer	Inicio Vigencia Contrato	Data do Fim da Vigência	Quilometragem Inicial
Val. Sistema
Opções
Inic. Padrão
Inic. Browse
Cons. Padrão
Nível	1	1	1	1	1	1
Usado	Sim	Sim	Sim	Sim	Sim	Sim
Obrigatório	Não	Não	Não	Não	Não	Não
Browse	Sim	Sim	Não	Sim	Sim	Sim
When
Pasta
Help	Código do Dealer	Nome/Razão Social Dealer	Nome Reduzido do Dealer	Inicio Vigência Contrato	Data do Fim da Vigência	Quilometragem Inicial

Campo	VW4_KMFIM	VW4_COBER	VW4_MODCHA	VW4_TPCOBR	VW4_DSTPCB	VW4_TPMANU	VW4_DSMANU
Tipo	Numérico	Caractere	Caractere	Caractere	Caractere	Caractere	Caractere
Grupo de Campos
Ordem	19	20	21	22	23	24	25
Tamanho	8	12	30	1	12	5	40
Decimal	0	0	0	0	0	0	0
Formato	@E 99,999,999	@!	@!	@!	@!	@!	@!
Contexto	1-Real	1-Real	1-Real	1-Real	1-Real	1-Real	1-Real
Propriedade	2-Visualizar	2-Visualizar	2-Visualizar	2-Visualizar	2-Visualizar	2-Visualizar	2-Visualizar
Título	KM Final	Cobertura	Modelo Chas.	Tipo Cobran.	Desc. Cobr.	Tip. Manut.	Desc. Manut.
Descrição	Quilometragem Final	Cobertura	Modelo do Chassi	Tipo de Cobrança	Descrição Tipo Cobrança	Tipo de Manutenção	Descrição Manutenção
Val. Sistema
Opções
Inic. Padrão
Inic. Browse
Cons. Padrão
Nível	1	1	1	1	1	1	1
Usado	Sim	Sim	Sim	Sim	Sim	Sim	Sim
Obrigatório	Não	Não	Não	Não	Não	Não	Não
Browse	Sim	Sim	Sim	Sim	Sim	Sim	Não
When
Pasta
Help	Quilometragem Final	Cobertura	Modelo do Chassi	Tipo de Cobrança	Descrição Tipo Cobrança	Tipo de Manutenção	Descrição Manutenção

Criação de campos no arquivo VW5 - Itens do Contratos Scania:

Campo	VW5_FILIAL	VW5_SEQVW4	VW5_SEQUEN	VW5_IDDESC	VW5_DSID	VW5_TPDESC
Tipo	Caractere	Caractere	Caractere	Caractere	Caractere	Caractere
Grupo de Campos	033
Ordem	01	02	03	04	05	06
Tamanho	2	10	10	1	15	1
Decimal	0	0	0	0	0	0
Formato	@!		@!	@!	@!	@!
Contexto	1-Real	1-Real	1-Real	1-Real	1-Real	1-Real
Propriedade	2-Visualizar	2-Visualizar	2-Visualizar	2-Visualizar	2-Visualizar	2-Visualizar
Título	Filial	Seq. VW4	Sequencial	ID Desconto	Descrição ID	Tp Desconto
Descrição	Filial	Sequencial Unico VW4	Código Sequencial Interno	ID do Desconto	Descrição ID Desconto	Tipo de Desconto
Val. Sistema
Opções
Inic. Padrão
Inic. Browse
Cons. Padrão
Nível	1	1	1	1	1	1
Usado	Sim	Sim	Sim	Sim	Sim	Sim
Obrigatório	Não	Não	Não	Não	Não	Não
Browse	Não	Não	Sim	Sim	Sim	Sim
When
Pasta
Help	Filial	Código Sequencial Interno	Código Sequencial Interno	ID do Desconto	Descrição ID Desconto	Tipo de Desconto

Campo	VW5_DSTP	VW5_VLDESC	VW5_EMAILG	VW5_DEALID	VW5_NMDEAL	VW5_RNMDEA
Tipo	Caractere	Numérico	Caractere	Caractere	Caractere	Caractere
Grupo de Campos
Ordem	07	08	09	10	11	12
Tamanho	15	9	80	6	50	20
Decimal	0	2	0	0	0	0
Formato	@!	@E 999,999.99	@!	@!	@!	@!
Contexto	1-Real	1-Real	1-Real	1-Real	1-Real	1-Real
Propriedade	2-Visualizar	2-Visualizar	2-Visualizar	2-Visualizar	2-Visualizar	2-Visualizar
Título	Descr. Tipo	Valor Desc.	E-Mail	Dealer ID	Nome Dealer	Nome Reduz.
Descrição	Descrição Tipo Desconto	Valor do Desconto	E-Mail do Gestor	Dealer ID	Nome/Razão Dealer	Nome Reduzido Dealer
Val. Sistema
Opções
Inic. Padrão
Inic. Browse
Cons. Padrão
Nível	1	1	1	1	1	1
Usado	Sim	Sim	Sim	Sim	Sim	Sim
Obrigatório	Não	Não	Não	Não	Não	Não
Browse	Sim	Sim	Sim	Sim	Sim	Sim
When
Pasta
Help	Descrição Tipo Desconto	Valor do Desconto	E-Mail do Gestor	Dealer ID	Nome/Razão Dealer	Nome Reduzido Dealer

No Configurador (SIGACFG), acesse Ambientes/Cadastros/Menu (CFGX013) e informe as novas opções de menu do módulo de Oficina (SIGAOFI) conforme instruções a seguir:

Menu	Atualizações
Nome da Rotina	Configurações Scania
Programa	OFIA541
Módulo	Oficina (SIGAOFI)
Tipo	Função Protheus

6. Assuntos Relacionados

<style>
  .link_container {
    display: flex;
    flex-direction: column;
    align-items: flex-start; /* Alinhado à esquerda */
    width: 100%;
    gap: 8px; /* Espaçamento entre os itens */
  }

  .btn-doc,
  .btn-doc:link,
  .btn-doc:visited {
    display: inline-block;
    padding: 12px 24px;
    font-size: 16px;
    font-weight: 600;
    color: #FFFFFF !important; /* Força o texto branco */
    background-color: #08244C; /* Fundo azul escuro */
    border: none;
    border-radius: 8px;
    text-decoration: none;
    text-align: left;
    transition: background-color 0.3s ease, transform 0.2s ease, color 0.3s ease;
  }

  .btn-doc:hover {
    background-color: #FFFFFF; /* Azul mais claro no hover */
    color: #08244C !important; /* Mantém texto branco */
    transform: scale(1.03);
  }

  .btn-doc:active {
    background-color: #061B3B; /* Azul ainda mais escuro no clique */
    color: #FFFFFF !important; /* Mantém texto branco */
    transform: scale(0.98);
  }
</style>

<div class="link_container">
  <a href="https://tdn.totvs.com/pages/viewpage.action?pageId=1032853563" target="_blank" class="btn-doc">     		
	📄Contratos Scania (OFIA600) 
  </a>
  <a href="https://tdn.totvs.com/pages/viewpage.action?pageId=1032147018" target="_blank" class="btn-doc">     		
	📄Configurações Scania (OFIA541) 
  </a>