01. DADOS GERAIS
Produto: |
TOTVS DMS |
---|---|
Linha de Produto: | Linha Protheus |
Segmento: | Varejo |
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_TIPREG | VFF_CODCAB |
Tipo | Caracter | Caracter | Caracter |
Grupo de Campos | 033 | ||
Ordem | 01 | 02 | 03 |
Tamanho | 2 | 1 | 6 |
Decimal | 0 | 0 | 0 |
Formato | @! | @! | @! |
Contexto | 1 - Real | 1 - Real | 1 - Real |
Propriedade | 1 - Alterar | 2 - Visualizar | 1 - Alterar |
Título | Filial | Tipo do Reg. | Cód. Cabec. |
Descrição | Filial | Tipo do Registro | Có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 | 1 | 1 |
Usado | Não | Sim | Sim |
Obrigatório | Não | Sim | Sim |
Browse | Sim | Não | Sim |
When | |||
Pasta | |||
Help | Informe a Filial. |
Campo | VFF_DESCAB | VFF_CODGRF | VFF_DESGRF |
Tipo | Caracter | Caracter | Caracter |
Grupo de Campos | |||
Ordem | 04 | 05 | 06 |
Tamanho | 60 | 4 | 30 |
Decimal | 0 | 0 | 0 |
Formato | @! | @! | @! |
Contexto | 1 - Real | 1 - Real | 2 - Virtual |
Propriedade | 1 - Alterar | 1 - Alterar | 2 - Visualizar |
Título | Desc. Cabec. | Cód Ger Ref | Des Ger Ref |
Descrição | Descrição do Cabeçalho | Cód Gerencial Referencial | Des 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 | 1 | 1 |
Usado | Sim | Sim | Sim |
Obrigatório | Sim | Sim | Não |
Browse | Sim | Sim | Sim |
When | |||
Pasta | |||
Help |
Campo | VFF_CODDRF | VFF_DESDRF |
Tipo | Caracter | Caracter |
Grupo de Campos | ||
Ordem | 07 | 08 |
Tamanho | 4 | 30 |
Decimal | 0 | 0 |
Formato | @! | @! |
Contexto | 1 - Real | 2 - Virtual |
Propriedade | 1 - Alterar | 2 - 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_CODCAB | VFG_DESCAB |
Tipo | Caracter | Caracter | Caracter |
Grupo de Campos | 033 | ||
Ordem | 01 | 02 | 03 |
Tamanho | 2 | 6 | 60 |
Decimal | 0 | 0 | 0 |
Formato | @! | @! | @! |
Contexto | 1 - Real | 1 - Real | 2 - Virtual |
Propriedade | 1 - Alterar | 2 - Visualizar | 2 - Visualizar |
Título | Filial | Cód. Cabec. | Desc. Cabec. |
Descrição | Filial | Código do Cabeçalho | Descriçã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 | 1 | 1 |
Usado | Não | Sim | Sim |
Obrigatório | Não | Não | Não |
Browse | Sim | Sim | Sim |
When | |||
Pasta | |||
Help |
Campo | VFG_TIPREG | VFG_CODSEQ | VFG_CC |
Tipo | Caracter | Caracter | Caracter |
Grupo de Campos | 004 | ||
Ordem | 04 | 05 | 06 |
Tamanho | 1 | 6 | 9 |
Decimal | 0 | 0 | 0 |
Formato | @! | @! | @! |
Contexto | 1 - Real | 1 - Real | 1 - Real |
Propriedade | 2 - Visualizar | 2 - Visualizar | 1 - Alterar |
Título | Tipo do Reg. | Cód Sequenc | Centro Custo |
Descrição | Tipo do Registro | Código Sequencial | Centro de Custo Técnico |
Val. Sistema | Pertence("12") | NaoVazio() | Vazio() .Or. Ctb105CC() |
Opções | 1=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 | 1 | 1 |
Usado | Sim | Sim | Sim |
Obrigatório | Não | Sim | Não |
Browse | Sim | Sim | Sim |
When | |||
Pasta | |||
Help |
Campo | VFG_DESCC | VFG_CODTEC | VFG_NOMTEC |
Tipo | Caracter | Caracter | Caracter |
Grupo de Campos | |||
Ordem | 07 | 08 | 09 |
Tamanho | 40 | 6 | 30 |
Decimal | 0 | 0 | 0 |
Formato | @! | @! | @! |
Contexto | 2 - Virtual | 1 - Real | 2 - Virtual |
Propriedade | 2 - Visualizar | 1 - Alterar | 2 - Visualizar |
Título | Descrição CC | Técnico | Nome Técnico |
Descrição | Descrição Centro Custo | Código Técnico Equipe Téc | Nome do Técnico |
Val. Sistema | Vazio() .Or. ExistCpo("VAI",FwFldGet("VFG_CODTEC")) | ||
Opções | |||
Inic. Padrão | If(!Inclui,Posicione("CTT",1,xFilial("CTT")+VFG->VFG_CC,"CTT_DESC01"),"") | If(!Inclui,Posicione("VAI",1,xFilial("VAI")+VFG->VFG_CODTEC,"VAI_NOMTEC"),"") | |
Inic. Browse | Posicione("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 | 1 | 1 |
Usado | Sim | Sim | Sim |
Obrigatório | Não | Não | Não |
Browse | Sim | Sim | Sim |
When | |||
Pasta | |||
Help |
Campo | VFG_FILTEC | VFG_NOMFIL | VFG_CODMAR |
Tipo | Caracter | Caracter | Caracter |
Grupo de Campos | |||
Ordem | 10 | 11 | 12 |
Tamanho | 2 | 40 | 3 |
Decimal | 0 | 0 | 0 |
Formato | @! | @! | @!S3 |
Contexto | 1 - Real | 2 - Virtual | 1 - Real |
Propriedade | 2 - Visualizar | 2 - Visualizar | 1 - Alterar |
Título | Fil. Técnico | Nome Filial | Marca |
Descrição | Filial do Técnico | Nome da Filial | Có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 | 1 | 1 |
Usado | Sim | Sim | Sim |
Obrigatório | Não | Não | Não |
Browse | Sim | Sim | Sim |
When | |||
Pasta | |||
Help |
Campo | VFG_DESMAR | VFG_GRUMOD | VFG_DESGRU |
Tipo | Caracter | Caracter | Caracter |
Grupo de Campos | |||
Ordem | 13 | 14 | 15 |
Tamanho | 30 | 6 | 20 |
Decimal | 0 | 0 | 0 |
Formato | @! | @!S6 | @! |
Contexto | 2 - Virtual | 1 - Real | 2 - Virtual |
Propriedade | 2 - Visualizar | 1 - Alterar | 2 - Visualizar |
Título | Descr. Marca | Grupo Modelo | Descr Gr Mod |
Descrição | Descrição da Marca | Grupo do Modelo | Descrição do Grupo Modelo |
Val. Sistema | ExistCpo("VVR",FwFldGet("VFG_CODMAR")+FwFldGet("VFG_GRUMOD")) | ||
Opções | |||
Inic. Padrão | If(!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. Browse | Posicione("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 | 1 | 1 |
Usado | Sim | Sim | Sim |
Obrigatório | Não | Não | Não |
Browse | Sim | Sim | Sim |
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 |
Contexto | 1 - Real | 2 - Virtual |
Propriedade | 1 - Alterar | 2 - 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 | OFIA200 | OFIA200 | OFIA200 |
Ordem | 01 | 02 | 03 | 04 |
Pergunta | Filial Matriz? | Data? | Filial? | |
Tipo | Caracter | Data | Caracter | Caracter |
Tamanho | 2 | 8 | 6 | 99 |
Decimal | 0 | 0 | 0 | 0 |
Var01 | MV_PAR01 | MV_PAR02 | MV_PAR03 | MV_PAR04 |
Formato | ||||
Validação | ExistCpo("SM0",cEmpAnt+mv_par01,1) | NaoVazio() | !Vazio().or.(MV_PAR04:=cGetFile("Diretório","",,,,176)) | |
Objeto | Get (Edit) | Get (Edit) | Get (Edit) | Get (Edit) |
Consulta Padrão | SM0 | VD7 | ||
Conteúdo | ||||
Pré-Seleção (Combo) | ||||
Item 1 | ||||
Item 2 | ||||
Item 3 | ||||
Item 4 | ||||
Item 5 | ||||
Grupo de Campos | 033 | |||
Help |
- GRUPO: OFIA202
Grupo | OFIA202 |
Ordem | 01 |
Pergunta | Status Outros Negócios? |
Tipo | Caracter |
Tamanho | 2 |
Decimal | 0 |
Var01 | MV_PAR01 |
Formato | |
Validação | ExistCpo("VAE",mv_par01) |
Objeto | Get (Edit) |
Consulta Padrão | VAE |
Conteúdo | |
Pré-Seleção (Combo) | |
Item 1 | |
Item 2 | |
Item 3 | |
Item 4 | |
Item 5 | |
Grupo de Campos | |
Help |
- Grupo: OFIA204
Grupo | OFIA204 | OFIA204 | OFIA204 | OFIA204 |
Ordem | 01 | 02 | 03 | 04 |
Pergunta | Filial Matriz? | Data? | Gera para qual filial? | Diretório gravação Arq JSON? |
Tipo | Caracter | Data | Caracter | Caracter |
Tamanho | 2 | 8 | 2 | 99 |
Decimal | 0 | 0 | 0 | 0 |
Var01 | MV_PAR01 | MV_PAR02 | MV_PAR03 | MV_PAR04 |
Formato | ||||
Validação | ExistCpo("SM0",cEmpAnt+mv_par01,1) | NaoVazio() | Vazio() .Or. ExistCpo("SM0",cEmpAnt+mv_par03,1) | !Vazio().or.(MV_PAR04:=cGetFile("Diretório","",,,,176)) |
Objeto | Get (Edit) | Get (Edit) | Get (Edit) | Get (Edit) |
Consulta Padrão | SM0 | SM0 | ||
Conteúdo | ||||
Pré-Seleção (Combo) | ||||
Item 1 | ||||
Item 2 | ||||
Item 3 | ||||
Item 4 | ||||
Item 5 | ||||
Grupo de Campos | 033 | 033 | ||
Help |
- Grupo: OFIA205
Grupo | OFIA205 | OFIA205 | OFIA205 | OFIA205 |
Ordem | 01 | 02 | 03 | 04 |
Pergunta | Código DEF? | De/Para Plano Contábil? | De/Para Centro de Custo? | Filial Matriz? |
Tipo | Caracter | Caracter | Caracter | Caracter |
Tamanho | 6 | 99 | 99 | 2 |
Decimal | 0 | 0 | 0 | 0 |
Var01 | MV_PAR01 | MV_PAR02 | MV_PAR03 | MV_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) | |
Objeto | Get (Edit) | Get (Edit) | Get (Edit) | Get (Edit) |
Consulta Padrão | VD7 | 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 | VFF | VFF |
E. Domínio | VX5_CODIGO | VX5_CODIGO |
E. C. Domínio | VFF_CODGRF | VFF_CODDRF |
Propriedade | S | S |
L. Domínio | 1 | 1 |
L. C. Domínio | N | N |
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ínio | 1 |
L. C. Domínio | N |
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ínio | 1 |
L. C. Domínio | N |
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ínio | 1 |
L. C. Domínio | N |
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ínio | 1 |
L. C. Domínio | N |
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ínio | 1 |
L. C. Domínio | N |
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ínio | 1 |
L. C. Domínio | N |
Condição SQL |
Criação de Consulta Padrão no arquivo SXB – Consulta Padrão:
Alias | VFF | VFF | VFF |
Tipo | 1 | 2 | 4 |
Sequência | 01 | 01 | 01 |
Coluna | DB | 01 | 01 |
Descrição | Cabeç. AGCO Ger. DFS | Cód. Cabec.+Cód Ger Ref+Cód Dep Ref | Cód. Cabec |
Contém | VFF | VFF_CODCAB |
Alias | VFF | VFF | VFF |
Tipo | 4 | 4 | 5 |
Sequência | 01 | 01 | 01 |
Coluna | 02 | 03 | |
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 |
---|
Esta atualização de dicionários estará disponível na próxima release (12.1.2210).IMPORTANTE!
05. ASSUNTOS RELACIONADOS
- Não há.