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á.
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas