01. DADOS GERAIS

Produto:

Linha de Produto:

Segmento:

Módulo:

Oficina (SIGAOFI)

Auto-Peças (SIGAPEC)

Veículos (SIGAVEI)

Função:

Cadastro do DEF (OFIXA050)

Itens do DEF (OFIXA051)

Geração do DEF (OFIXA052)

Cons/Alteração DEF (OFIXA053)

Envio DFS Contábil AGCO (OFIA200)

Cad. DEF Contábil De/Para (OFIA205)

País:Brasil
Ticket:12813254
Requisito/Story/Issue (informe o requisito relacionado) :MMIL-7535


02. SITUAÇÃO/REQUISITO

A montadora AGCO solicitou a TOTVS a disponibilização da integração do sistema Protheus com o D-In. O programa D-In da AGCO é a integração do DEF do concessionário com a montadora. A integração visa atender as informações contábeis que a AGCO precisa. O Protheus é responsável pela geração e exportação dos dados no formato exigido pela AGCO para que esta possa recebê-las e interpretá-las corretamente. O envio destas informações é através do consumo de uma API em REST (JSON).

03. SOLUÇÃO

A integração com o D-In da AGCO foi desenvolvido e disponibilizado no sistema Protheus conforme solicitado.

De forma geral, o concessionário informará através de um conjunto de cadastros no Protheus, denominado DEF, a forma de obtenção dos valores para cada linha do plano de contas exigido pela AGCO. No Protheus, o processo consiste em cadastrar o cabeçalho do DEF com informações referentes a ele. Nesse cadastro o usuário deve indicar quais filiais poderão gerar o DEF. Em seguida criam-se os itens do DEF representando cada linha do plano de contas disponibilizado pela AGCO.

A criação dos itens é a parte mais importante e complexa do processo. Após o cadastramento completo dos itens do DEF, o usuário deve gerá-lo indicando o período a ser levantado. Após a geração o usuário pode imprimir relatórios ou realizar consultas/alteração de valores. Uma vez que os valores estejam validados o passo final consiste em realizar a transmissão dos dados gerados para a montadora.

Para detalhes sobre o passo a passo da implantação e operação do D-In, consulte a documentação a seguir: D-In Contábil AGCO - Linha Microsiga Protheus - TDN (totvs.com)

Pata detalhes sobre a configuração e utilização do DEF do Protheus, consulte a documentação a seguir: DEF Protheus - Linha Microsiga Protheus - TDN (totvs.com)



Criação de Tabela no arquivo SX2 – Tabelas:


Chave

Nome

Modo

PYME

VFF

Cabeçalho DFS Gerencial AGCO

C

S

VFG

Itens DFS Gerencial AGCO

C

S





Criação de Campo no arquivo SX3 – Campos:


  • Tabela VFF - Cabeçalho DFS Gerencial AGCO:


Campo

VFF_FILIAL

VFF_TIPREGVFF_CODCAB
Tipo

Caracter

CaracterCaracter
Grupo de Campos033

Ordem

01

0203
Tamanho

2

16
Decimal

0

00
Formato@!@!@!
Contexto1 - Real1 - Real1 - Real
Propriedade1 - Alterar2 - Visualizar1 - Alterar
Título

Filial

Tipo do Reg.Cód. Cabec.
Descrição

Filial

Tipo do RegistroCódigo do Cabeçalho
Val. Sistema


Pertence("12")NaoVazio() .And. ExistChav("VFF")
Opções
1=Colaborador;2=Máquina
Inic. Padrão



Inic. Browse


Cons. Padrão




Nível

1

11
Usado

Não

SimSim
Obrigatório

Não

SimSim
Browse

Sim

NãoSim
When




Pasta




Help

Informe a Filial.






Campo

VFF_DESCAB

VFF_CODGRFVFF_DESGRF
Tipo

Caracter

CaracterCaracter
Grupo de Campos


Ordem

04

0506
Tamanho

60

430
Decimal

0

00
Formato@!@!@!
Contexto1 - Real1 - Real2 - Virtual
Propriedade1 - Alterar1 - Alterar2 - Visualizar
Título

Desc. Cabec.

Cód Ger RefDes Ger Ref
Descrição

Descrição do Cabeçalho

Cód Gerencial ReferencialDes Gerencial Referencial
Val. Sistema


ExistCpo("VX5","078"+FwFldGet("VFF_CODGRF"))
Opções


Inic. Padrão


IIf(!INCLUI,Posicione("VX5",1,xFilial("VX5")+"078"+VFF->VFF_CODGRF,"VX5_DESCRI"),"")
Inic. Browse

Posicione("VX5",1,xFilial("VX5")+"078"+VFF->VFF_CODGRF,"VX5_DESCRI")
Cons. Padrão


VX5
Nível

1

11
Usado

Sim

SimSim
Obrigatório

Sim

SimNão
Browse

Sim

SimSim
When




Pasta




Help







Campo

VFF_CODDRF

VFF_DESDRF
Tipo

Caracter

Caracter
Grupo de Campos

Ordem

07

08
Tamanho

4

30
Decimal

0

0
Formato@!@!
Contexto1 - Real2 - Virtual
Propriedade1 - Alterar2 - Visualizar
Título

Cód Dep Ref

Des Dep Ref
Descrição

Código Depart. Referencia

Descri Depart. Referencial
Val. Sistema

ExistCpo("VX5","079"+FwFldGet("VFF_CODDRF"))


Opções

Inic. Padrão

IIf(!INCLUI,Posicione("VX5",1,xFilial("VX5")+"079"+VFF->VFF_CODDRF,"VX5_DESCRI"),"")

Inic. Browse
Posicione("VX5",1,xFilial("VX5")+"079"+VFF->VFF_CODDRF,"VX5_DESCRI")
Cons. Padrão

VX5


Nível

1

1
Usado

Sim

Sim
Obrigatório

Não

Não
Browse

Sim

Sim
When



Pasta



Help






  • Tabela VFG - Itens DFS Gerencial AGCO:


Campo

VFG_FILIAL

VFG_CODCABVFG_DESCAB
Tipo

Caracter

CaracterCaracter
Grupo de Campos033

Ordem

01

0203
Tamanho

2

660
Decimal

0

00
Formato@!@!@!
Contexto1 - Real1 - Real2 - Virtual
Propriedade1 - Alterar2 - Visualizar2 - Visualizar
Título

Filial

Cód. Cabec.Desc. Cabec.
Descrição

Filial

Código do CabeçalhoDescrição do Cabeçalho
Val. Sistema


ExistCpo("VFF")
Opções


Inic. Padrão


IIf(!INCLUI,Posicione("VFF",1,xFilial("VFF")+VFG->VFG_CODCAB,"VFF_DESCAB"),"")
Inic. Browse

Posicione("VFF",1,xFilial("VFF")+VFG->VFG_CODCAB,"VFF_DESCAB")
Cons. Padrão


VFF
Nível

1

11
Usado

Não

SimSim
Obrigatório

Não

NãoNão
Browse

Sim

SimSim
When




Pasta




Help






Campo

VFG_TIPREG

VFG_CODSEQVFG_CC
Tipo

Caracter

CaracterCaracter
Grupo de Campos

004
Ordem

04

0506
Tamanho

1

69
Decimal

0

00
Formato@!@!@!
Contexto1 - Real1 - Real1 - Real
Propriedade2 - Visualizar2 - Visualizar1 - Alterar
Título

Tipo do Reg.

Cód SequencCentro Custo
Descrição

Tipo do Registro

Código SequencialCentro de Custo Técnico
Val. Sistema

Pertence("12")

NaoVazio()Vazio() .Or. Ctb105CC()
Opções1=Colaborador;2=Máquina

Inic. Padrão

If(Inclui,GetSXENum("VFG","VFG_CODSEQ"),VFG->VFG_CODSEQ)


Inic. Browse


Cons. Padrão



CTT
Nível

1

11
Usado

Sim

SimSim
Obrigatório

Não

SimNão
Browse

Sim

SimSim
When




Pasta




Help







Campo

VFG_DESCC

VFG_CODTECVFG_NOMTEC
Tipo

Caracter

CaracterCaracter
Grupo de Campos


Ordem

07

0809
Tamanho

40

630
Decimal

0

00
Formato@!@!@!
Contexto2 - Virtual1 - Real2 - Virtual
Propriedade2 - Visualizar1 - Alterar2 - Visualizar
Título

Descrição CC

TécnicoNome Técnico
Descrição

Descrição Centro Custo

Código Técnico Equipe TécNome do Técnico
Val. Sistema


Vazio() .Or. ExistCpo("VAI",FwFldGet("VFG_CODTEC"))
Opções


Inic. PadrãoIf(!Inclui,Posicione("CTT",1,xFilial("CTT")+VFG->VFG_CC,"CTT_DESC01"),"")


If(!Inclui,Posicione("VAI",1,xFilial("VAI")+VFG->VFG_CODTEC,"VAI_NOMTEC"),"")
Inic. BrowsePosicione("CTT",1,xFilial("CTT")+VFG->VFG_CC,"CTT_DESC01")
Posicione("VAI",1,xFilial("VAI")+VFG->VFG_CODTEC,"VAI_NOMTEC")
Cons. Padrão


VAI
Nível

1

11
Usado

Sim

SimSim
Obrigatório

Não

NãoNão
Browse

Sim

SimSim
When




Pasta




Help






Campo

VFG_FILTEC

VFG_NOMFILVFG_CODMAR
Tipo

Caracter

CaracterCaracter
Grupo de Campos


Ordem

10

1112
Tamanho

2

403
Decimal

0

00
Formato@!@!@!S3
Contexto1 - Real2 - Virtual1 - Real
Propriedade2 - Visualizar2 - Visualizar1 - Alterar
Título

Fil. Técnico

Nome FilialMarca
Descrição

Filial do Técnico

Nome da FilialCódigo da Marca
Val. Sistema



ExistCpo("VE1",FwFldGet("VFG_CODMAR"))
Opções


Inic. Padrão

If(!Inclui,FWFilialName(,VFG->VFG_FILTEC),"")


Inic. Browse
FWFilialName(,VFG->VFG_FILTEC)
Cons. Padrão



VE1
Nível

1

11
Usado

Sim

SimSim
Obrigatório

Não

NãoNão
Browse

Sim

SimSim
When




Pasta




Help







Campo

VFG_DESMAR

VFG_GRUMODVFG_DESGRU
Tipo

Caracter

CaracterCaracter
Grupo de Campos


Ordem

13

1415
Tamanho

30

620
Decimal

0

00
Formato@!@!S6@!
Contexto2 - Virtual1 - Real2 - Virtual
Propriedade2 - Visualizar1 - Alterar2 - Visualizar
Título

Descr. Marca

Grupo ModeloDescr Gr Mod
Descrição

Descrição da Marca

Grupo do ModeloDescrição do Grupo Modelo
Val. Sistema


ExistCpo("VVR",FwFldGet("VFG_CODMAR")+FwFldGet("VFG_GRUMOD"))
Opções


Inic. PadrãoIf(!Inclui,Posicione("VE1",1,xFilial("VE1")+VFG->VFG_CODMAR,"VE1_DESMAR"),"")


If(!Inclui,Posicione("VVR",2,xFilial("VVR")+VFG->VFG_CODMAR+VFG->VFG_GRUMOD,"VVR_DESCRI"),"")
Inic. BrowsePosicione("VE1",1,xFilial("VE1")+VFG->VFG_CODMAR,"VE1_DESMAR")
Posicione("VVR",2,xFilial("VVR")+VFG->VFG_CODMAR+VFG->VFG_GRUMOD,"VVR_DESCRI")
Cons. Padrão


VVR
Nível

1

11
Usado

Sim

SimSim
Obrigatório

Não

NãoNão
Browse

Sim

SimSim
When




Pasta




Help








Campo

VFG_MODVEI

VFG_DESMOD
Tipo

Caracter

Caracter
Grupo de Campos

Ordem

16

17
Tamanho

30

30
Decimal

0

0
Formato@!@!S30
Contexto1 - Real2 - Virtual
Propriedade1 - Alterar2 - Visualizar
Título

Modelo

Descr Modelo
Descrição

Código do Modelo

Descrição do Modelo
Val. Sistema

ExistCpo("VV2",FwFldGet("VFG_CODMAR")+FwFldGet("VFG_MODVEI"))


Opções

Inic. Padrão

If(!Inclui,Posicione("VV2",1,xFilial("VV2")+VFG->VFG_CODMAR+VFG->VFG_MODVEI,"VV2_DESMOD"),"")

Inic. Browse
Posicione("VV2",1,xFilial("VV2")+VFG->VFG_CODMAR+VFG->VFG_MODVEI,"VV2_DESMOD")
Cons. Padrão

VV2


Nível

1

1
Usado

Sim

Sim
Obrigatório

Não

Não
Browse

Sim

Sim
When



Pasta



Help








Criação de Índices no arquivo SIX – Índices:



  • Tabela VFF - Cabeçalho DFS Gerencial AGCO:


Índice

VFF

Ordem

1

Chave

VFF_FILIAL+VFF_CODCAB+VFF_CODGRF+VFF_CODDRF

Descrição

Cód. Cabec.+Cód Ger Ref+Cód Dep Ref

Proprietário

S




  • Tabela VFG - Itens DFS Gerencial AGCO:


Índice

VFG

Ordem

1

Chave

VFG_FILIAL+VFG_CODCAB+VFG_TIPREG+VFG_CODSEQ

Descrição

Tipo do Reg.+Cód Sequenc+Cód Ger Ref

Proprietário

S







Criação de Pergunte no arquivo SX1 – Pergunta: 


  • Grupo: OFIA200


Grupo

OFIA200

OFIA200OFIA200OFIA200

Ordem

01

020304

Pergunta

Filial Matriz?

Data?Filial?

Tipo

Caracter

DataCaracterCaracter
Tamanho28699
Decimal0000
Var01MV_PAR01MV_PAR02MV_PAR03MV_PAR04
Formato



ValidaçãoExistCpo("SM0",cEmpAnt+mv_par01,1)NaoVazio()
!Vazio().or.(MV_PAR04:=cGetFile("Diretório","",,,,176))
ObjetoGet (Edit)Get (Edit)Get (Edit)Get (Edit)
Consulta PadrãoSM0
VD7
Conteúdo



Pré-Seleção (Combo)



Item 1



Item 2



Item 3



Item 4





Item 5



Grupo de Campos033


Help








  • GRUPO: OFIA202


Grupo

OFIA202

Ordem

01

Pergunta

Status Outros Negócios?

Tipo

Caracter

Tamanho2
Decimal0
Var01MV_PAR01
Formato
ValidaçãoExistCpo("VAE",mv_par01)
ObjetoGet (Edit)
Consulta PadrãoVAE
Conteúdo
Pré-Seleção (Combo)
Item 1
Item 2
Item 3
Item 4


Item 5
Grupo de Campos
Help




  • Grupo: OFIA204


Grupo

OFIA204

OFIA204OFIA204OFIA204

Ordem

01

020304

Pergunta

Filial Matriz?

Data?Gera para qual filial?Diretório gravação Arq JSON?

Tipo

Caracter

DataCaracterCaracter
Tamanho28299
Decimal0000
Var01MV_PAR01MV_PAR02MV_PAR03MV_PAR04
Formato



ValidaçãoExistCpo("SM0",cEmpAnt+mv_par01,1)NaoVazio()Vazio() .Or. ExistCpo("SM0",cEmpAnt+mv_par03,1)!Vazio().or.(MV_PAR04:=cGetFile("Diretório","",,,,176))
ObjetoGet (Edit)Get (Edit)Get (Edit)Get (Edit)
Consulta PadrãoSM0
SM0
Conteúdo



Pré-Seleção (Combo)



Item 1



Item 2



Item 3



Item 4





Item 5



Grupo de Campos033
033
Help







  • Grupo: OFIA205


Grupo

OFIA204

OFIA204OFIA204OFIA204

Ordem

01

020304

Pergunta

Código DEF?

De/Para Plano Contábil?De/Para Centro de Custo?Filial Matriz?

Tipo

Caracter

CaracterCaracterCaracter
Tamanho699992
Decimal0000
Var01MV_PAR01MV_PAR02MV_PAR03MV_PAR04
Formato



Validação
!Vazio().or.(MV_PAR02:=cGetFile("Arquivos |*.csv","",,,,48))!Vazio().or.(MV_PAR03:=cGetFile("Arquivos |*.csv","",,,,48))ExistCpo("SM0",cEmpAnt+mv_par04,1)
ObjetoGet (Edit)Get (Edit)Get (Edit)Get (Edit)
Consulta PadrãoVD7

SM0
Conteúdo



Pré-Seleção (Combo)



Item 1



Item 2



Item 3



Item 4





Item 5



Grupo de Campos


033
Help








Criação de Relacionamento no arquivo SX9 – Relacionamento:


Domínio

VX5

VX5

Identificação

Última ordem referente a tabela VX5

C. Domínio

VFFVFF

E. Domínio

VX5_CODIGO

VX5_CODIGO

E. C. Domínio

VFF_CODGRF

VFF_CODDRF

Propriedade

S

S
L. Domínio11
L. C. DomínioNN
Condição SQL



Domínio

CTT

Identificação

Última ordem referente a tabela CTT

C. Domínio

VFG

E. Domínio

CTT_CUSTO

E. C. Domínio

VFG_CC

Propriedade

S

L. Domínio1
L. C. DomínioN
Condição SQL



Domínio

VAI

Identificação

Última ordem referente a tabela VAI

C. Domínio

VFG

E. Domínio

VAI_CODTEC

E. C. Domínio

VFG_CODTEC

Propriedade

S

L. Domínio1
L. C. DomínioN
Condição SQL



Domínio

VE1

Identificação

Última ordem referente a tabela VE1

C. Domínio

VFG

E. Domínio

VE1_CODMAR

E. C. Domínio

VFG_CODMAR

Propriedade

S

L. Domínio1
L. C. DomínioN
Condição SQL



Domínio

VVR

Identificação

Última ordem referente a tabela VVR

C. Domínio

VFG

E. Domínio

VVR_GRUMOD

E. C. Domínio

VFG_GRUMOD

Propriedade

S

L. Domínio1
L. C. DomínioN
Condição SQL



Domínio

VV2

Identificação

Última ordem referente a tabela VV2

C. Domínio

VFG

E. Domínio

VV2_MODVEI

E. C. Domínio

VFG_MODVEI

Propriedade

S

L. Domínio1
L. C. DomínioN
Condição SQL



Domínio

VFF

Identificação

Última ordem referente a tabela VFF

C. Domínio

VFG

E. Domínio

VFF_CODCAB

E. C. Domínio

VFG_CODCAB

Propriedade

S

L. Domínio1
L. C. DomínioN
Condição SQL




Criação de Consulta Padrão no arquivo SXB – Consulta Padrão:


AliasVFFVFFVFF
Tipo124
Sequência010101
ColunaDB0101
Descrição

Cabeç. AGCO Ger. DFS

Cód. Cabec.+Cód Ger Ref+Cód Dep Ref

Cód. Cabec

ContémVFF

VFF_CODCAB



AliasVFFVFFVFF
Tipo445
Sequência010101
Coluna0203
Descrição

Cód Ger Ref

Cód Dep Ref

Cód. Cabec

Contém

VFF_CODGRF

VFF_CODDRF

VFF->VFF_CODCAB



Criação de Parâmetro no arquivo SX6 – Parâmetros:

Nome da Variável

MV_MIL0142

Tipo

Caracter

Descrição

Informe o Endpoint para a API da AGCO responsável pelo serviço DEF Contabil e Gerencial (DFS D-In).

Valor Padrão





04. DEMAIS INFORMAÇÕES


Pacotes Gerados:

12.1.25: https://r.totvs.io/p/1048410

12.1.27: https://r.totvs.io/p/1048411

12.1.33: https://r.totvs.io/p/1048412



05. ASSUNTOS RELACIONADOS