Histórico da Página
CFDI 3.3 - Alteração do Leiaute da FE México 3.3 / DTS 12.1.
2026 - Antecipações
Características do Requisito
Linha de Produto: | Datasul | |||
Segmento: | Manufatura | |||
Módulo: | MFT - Faturamento | |||
Rotina:
| ||||
Rotina(s) envolvida(s) | Nome Técnico | |||
Informe a(s) rotina(s) envolvidas. | Informe o nome técnico da(s) rotina(s) envolvidas. |
| ||
Cadastros Iniciais: | Relacione os cadastros necessários que precisam ser preenchidos antes da utilização desse requisito. | |||
Parâmetro(s): | Informe os parâmetros utilizados. | |||
Tickets relacionados | Informe o(s) chamado(s) relacionado(s). As rotinas serão detalhados no decorrer do documento | |||
Requisito/Story/Issue (informe o requisito relacionado): Informe o requisito relacionado (Issue). | DMANMI02-3609, DMANMI03-2320, DMANMI03-3080 | |||
País(es): | México. | |||
Banco(s) de Dados: | Informe o(s) Banco(s) de Dados utilizado(s). | |||
Tabelas Utilizadas: | Informe as tabelas utilizadas. | |||
Sistema(s) Operacional(is): | Informe o(s) sistema(s) operacional(is) utilizados. |
Descrição
Escreva aqui a descrição da nova implementação ou melhoria.
Importante
(Apenas para Microsiga Protheus, versões anteriores à versão 12)
Antes de executar o compatibilizador informe o nome do compatibilizador é imprescindível:
- Realizar o backup da base de dados do produto que será executado o compatibilizador (diretório PROTHEUS_DATA\DATA, se versão 10, ou \PROTHEUS11_DATA\DATA, se versão 11) e dos dicionários de dados SXs (diretório PROTHEUS_DATA_SYSTEM, se versão 10, ou \PROTHEUS11_DATA\SYSTEM, se versão 11).
- Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa.
- Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.
- Se os dicionários de dados possuírem índices personalizados (criados pelo usuário), antes de executar o compatibilizador, certifique-se de que estão identificados pelo nickname. Caso o compatibilizador necessite criar índices, irá adicioná-los a partir da ordem original instalada pelo Protheus, o que poderá sobrescrever índices personalizados, caso não estejam identificados pelo nickname.
- O compatibilizador deve ser executado com a Integridade Referencial desativada*.
Atenção
O procedimento a seguir deve ser realizado por um profissional qualificado como Administrador de Banco de Dados (DBA) ou equivalente!
A ativação indevida da Integridade Referencial pode alterar drasticamente o relacionamento entre tabelas no banco de dados. Portanto, antes de utilizá-la, observe atentamente os procedimentos a seguir:
- No Configurador (SIGACFG), veja se a empresa utiliza Integridade Referencial, selecionando a opção Integridade/Verificação (APCFG60A).
- Se não há Integridade Referencial ativa, são relacionadas em uma nova janela todas as empresas e filiais cadastradas para o sistema e nenhuma delas estará selecionada. Neste caso, E SOMENTE NESTE, não é necessário qualquer outro procedimento de ativação ou desativação de integridade, basta finalizar a verificação e aplicar normalmente o compatibilizador, conforme instruções.
- Se há Integridade Referencial ativa em todas as empresas e filiais, é exibida uma mensagem na janela Verificação de relacionamento entre tabelas. Confirme a mensagem para que a verificação seja concluída, ou;
- Se há Integridade Referencial ativa em uma ou mais empresas, que não na sua totalidade, são relacionadas em uma nova janela todas as empresas e filiais cadastradas para o sistema e, somente, a(s) que possui(em) integridade está(arão) selecionada(s). Anote qual(is) empresa(s) e/ou filial(is) possui(em) a integridade ativada e reserve esta anotação para posterior consulta na reativação (ou ainda, contate nosso Help Desk Framework para informações quanto a um arquivo que contém essa informação).
- Nestes casos descritos nos itens “iii” ou “iv”, E SOMENTE NESTES CASOS, é necessário desativar tal integridade, selecionando a opção Integridade/ Desativar (APCFG60D).
- Quando desativada a Integridade Referencial, execute o compatibilizador, conforme instruções.
- Aplicado o compatibilizador, a Integridade Referencial deve ser reativada, SE E SOMENTE SE tiver sido desativada, através da opção Integridade/Ativar (APCFG60). Para isso, tenha em mãos as informações da(s) empresa(s) e/ou filial(is) que possuía(m) ativação da integridade, selecione-a(s) novamente e confirme a ativação.
Contate o Help Desk Framework EM CASO DE DÚVIDAS!
- Em Microsiga Protheus TOTVS Smart Client (se versão 10), digite o nome do compatibilizador no campo Programa Inicial. Descreva se o compatibilizador deve ter uma data específica ou superior para que a atualização nos dicionários seja efetuada corretamente. Importante: Para a correta atualização do dicionário de dados, certifique-se que a data do compatibilizador seja igual ou superior a ___/___/____.
- Clique em OK para continuar.
- Após a confirmação é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado ou é apresentada a janela para seleção do compatibilizador. Selecione o programa xxxx().
- Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
- Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
É apresentada uma mensagem explicativa na tela. - Em seguida, é exibida a janela Atualização concluída com o histórico (log) de todas as atualizações processadas. Nesse log de atualização são apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos que ainda não existem no dicionário de dados.
- Clique em Gravar para salvar o histórico (log) apresentado.
- Clique em OK para encerrar o processamento.
- Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
Descreva se há algum procedimento necessário após a aplicação do compatibilizador.
Procedimento para Implantação
O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste chamado.
- Aplique o patch do chamado e execute uma vez a rotina Informe o nome da rotina.
- No módulo informe o nome do módulo acesse informe o caminho e verifique que o parâmetro informe o nome do parâmetro é criado conforme especificações abaixo:
Nome da Variável: | Informe o Nome da Variável |
Tipo: | Informe o Tipo |
Descrição: | Informe a Descrição |
Valor Padrão: | Informe o Valor Padrão |
Atualizações do Compatibilizador
(Apenas para Microsiga Protheus, versões anteriores à versão 12)
- Criação ou Alteração de Perguntas no arquivo SX1 – Cadastro de Perguntes:
Pergunte | (X1_PERGUNT) |
Nome |
|
Grupo | (X1_GRUPO) |
Ordem | (X1_ORDEM) |
Tipo | (X1_TIPO) |
Tamanho | (X1_TAMANHO) |
2. Criação ou Alteração de tabela no arquivo SX2– Tabelas:
Chave | Nome | Modo | PYME |
B04 (X2_CHAVE) | Dente/Região (X2_NOME) | C (X2_MODO) | N (X2_PYME) |
3. Criação ou Alteração de Tabelas Genéricas no arquivo SX5 – Tabelas Genéricas:
Chave | Ex.: AR |
Descrição | Ex.: Tabela de IR de Aplicações Financeiras |
4. Criação ou Alteração (mantenha somente a instrução correspondente) de Campos no arquivo SX3 – Campos:
- Tabela BGD - Prod x Cob x Proc x Co-Part:
Campo
(X3_CAMPO)
Tipo
(X3_TIPO)
Tamanho
(X3_TAMANHO)
Decimal
(X3_DECIMAL)
Formato
(X3_PICTURE)
Título
(X3_TITULO)
Descrição
(X3_DESCRIC)
Nível
(X3_NÍVEL)
Usado
(X3_USADO) Informe Sim ou Não
Obrigatório
(X3_OBRIGAT) Informe Sim ou Não
Browse
(X3_BROWSE) Informe Sim ou Não
Opções
(X3_CBOX)
When
(X3_WHEN)
Relação
(X3_RELACAO)
Val. Sistema
(X3_VALID)
Help
Descreva o conteúdo informado para Help de Campo no ATUSX
Importante:
O tamanho dos campos que possuem grupo pode variar conforme ambiente em uso.
5. Criação ou Alteração de Consulta Padrão no arquivo SXB – Consulta Padrão:
- Pesquisa B05PLS:
Alias | (XB_ALIAS) |
Tipo | (XB_TIPO) |
Sequência | (XB_SEQ) |
Coluna | (XB_COLUNA) |
Descrição | (XB_DESCRI) |
Contém | (XB_CONTEM) |
6. Criação ou Alteração de Índices no arquivo SIX – Índices:
Índice | AA1 |
Ordem | 6 |
Chave | AA1_FILIAL+AA1_CODVEN |
Descrição | Cod. Vendedor |
Proprietário | S |
7. Criação ou Alteração de Parâmetros no arquivo SX6 – Parâmetros:
Nome da Variável | (X6_VAR) |
Tipo | (X6_TIPO) |
Descrição | (X6_DESCRIC + X6_DESC1 + X6_DESC2) |
Valor Padrão | (X6_CONTEUD) |
8. Criação ou Alteração (mantenha somente a instrução correspondente) de Gatilhos no arquivo SX7 – Gatilhos:
- Tabela BD5 – Contas Médicas:
Campo | Informe o conteúdo do (X7_CAMPO) |
Sequência | Informe o conteúdo do (X7_SEQUENC) |
Campo Domínio | Informe o conteúdo do (X7_CDOMIN) |
Tipo | Informe o conteúdo do (X7_TIPO) |
Regra | Informe o conteúdo do (X7_REGRA) |
Posiciona? | Informe o conteúdo do (X7_SEEK) |
Chave | Informe o conteúdo do (X7_CHAVE) |
Condição | Informe o conteúdo do (X7_CONDIC) |
Proprietário | Informe o conteúdo do (X7_PROPRI) |
Procedimento para Configuração
(Estes procedimentos devem ser feitos quando for necessário configurar parâmetros e/ou rotinas no menu).
CONFIGURAÇÃO DE PARÂMETROS
- No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Crie/configure (mantenha somente a instrução correspondente) o(s) parâmetro(s) a seguir:
(É necessário criar uma tabela para cada parâmetro descrito no item Parâmetro(s), da tabela Características do Requisito)
Itens/Pastas
Descrição
Nome:
Tipo:
Informe o Tipo do parâmetro
Cont. Por.:
Informe o Conteúdo padrão
Descrição:
CONFIGURAÇÃO DE MENUS
2. No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do informe o nome do módulo, conforme instruções a seguir:
Menu | Informe o Menu em que estará localizada a rotina |
Submenu | Informe o Submenu em que estará localizada a rotina |
Nome da Rotina | Informe o Título da rotina |
Programa | Informe o Fonte da rotina |
Módulo | Informe o Nome do(s) produto(s) a ser utilizado ou “Todos” |
Tipo | Informe a Função |
Procedimento para Utilização
Quando o cliente possuir antecipações, ele terá a opção de as selecionar através do programa MEX0047 - Seleção de Antecipações, que poderá ser acessado através de botões nos programas de criação de nota fiscal:Vídeo
- Vídeo hospedado no youtube e inserido no template por meio da macro Widget Connector.
** Canal do youtube e software de vídeoem definição.
Título do Vídeo:
Disponibilizado pelo Marketing.
Introdução:
Disponibilizado pelo Marketing.
Passo a Passo:
Capturar diretamente do sistema.
Finalização:
Disponibilizado pelo Marketing.
Ponto de Entrada
Descrição:
Informe o Menu em que estará localizada a rotina
Localização:
Informe o Submenu em que estará localizada a rotina
Eventos:
Informe o Título da rotina
Programa Fonte:
Informe o Fonte da rotina
Função:
Informe o Nome do(s) produto(s) a ser utilizado ou “Todos”
Retorno:
Nome
Tipo
Descrição
Obrigatório
Exemplo:
#Include 'Protheus.ch'
User Function CN120ALT()
Local aCab:= PARAMIXB[1]
Local cTipo:= PARAMIXB[2]
If cTipo == '1'
aCab[4][2]:= 'NF' //Validações do usuário
EndIf
Progress |
Descrição
Foi realizado o desenvolvimento para atender o regime de Antecipações.
Procedimento para Utilização
- Alterado o programa Manutenção Natureza Operação - CD0609 para que seja possível incluir uma natureza com classe do título do tipo 'Antecipação'.
- Quando o cliente possuir antecipações, ele terá a opção de as selecionar através do programa MEX0047 - Seleção de Antecipações, que poderá ser acessado através de botões nos programas de criação de nota fiscal:
Neste programa será possível informar o valor de antecipação que será vinculada à fatura, bem como os erros existentes no título de antecipação, caso existam. Em vermelho serão apresentadas as antecipações com erro, e os erros serão acionados através do botão direito do mouse, no botão "inconsistências". Em azul estarão as antecipações com algum valor vinculado à fatura. Para inserir um valor de antecipação, basta clicar na linha desejada, sobre o campo "Val Relac Mo Fat (valor relacionado na moeda da fatura), ou então clicar no botão modificar e informar o valor de vinculação, limitado ao saldo da antecipação.
A vinculação deve ser sempre feita na moeda da fatura digitada. - Foi criado um botão no programa FT4040 para poder informar as "Antecipações". Este botão deve chamar a uma nova tela (MEX0047) onde terá um browse com as Antecipações em aberto para esse emitente que está sendo gerada a nota fiscal:
- Foi criado um botão no programa FT4060 para poder informar as "Antecipações". Este botão deve chamar a uma nova tela (MEX0047) onde terá um browse com as Antecipações em aberto para esse emitente que está sendo gerada a nota fiscal. Também foi alterado para poder cadastrar um documento do tipo antecipação e foi incluso o campo "Antecipação" para informar se a nota fiscal posicionada é uma antecipação. Para as notas fiscais do tipo "Antecipação", somente será possível utilizar a condição de pagamento do tipo "À Vista" ou "Antecipado" na inclusão do documento e na inclusão manual na aba 'Duplicatas':
- Foi criado um botão no programa FT4030 para poder informar as "Antecipações". Este botão deve chamar a uma nova tela (MEX0047) onde terá um browse com as Antecipações em aberto para esse emitente que está sendo gerada a nota-fiscal:
- Quando a fatura não tiver antecipações vinculadas, mas tiver antecipações disponíveis, o sistema perguntará se deseja vincular as antecipações disponíveis.
- Quando o valor da antecipação ou a somatória das antecipações fora maior ao valor da fatura, o sistema não ira deixar atualizar o documento informando da situação.
- Foi alterado o layout do XML para que seja impressa as informações referentes as antecipações, conforme layout do SAT.
Para o XML de uma fatura normal que possui antecipações vinculadas, foi alterada a tag 'CfdiRelacionados' para que imprima o atributo 'UUID' das antecipações vinculadas e o atributo 'TipoRelacion' terá o valor '07'.
Para o XML de uma antecipação, foi alterado para que o atributo 'Descripcion' da tag 'Conceptos' seja 'Anticipo del bien o servicio'. - Foi alterado o programa FT0603 - Integração Faturamento x Contas a Receber para que permita integrar a nota do tipo 'Antecipação', criando as duplicatas para pagamento no Contas a Receber. Também foi alterado para que as notas fiscais que tenham antecipações vinculadas sejam integradas e que seja feita a baixa do saldo dos títulos no Contas a Receber.
- Foram alterados os programas FT1018 - Eliminação Notas Manuais e FT0510 - Eliminação Notas Fiscais para que eliminem as tabelas de antecipação relacionadas a nota fiscal. Para as notas fiscais com antecipações vinculadas, o saldo das antecipações ficará disponível para nova vinculação com outra fatura.
- Foi criado o arquivo layout local/mex/java/recursos/FacturaCFDI.jasper e alterada a app java local/mex/java/mexjar0001c.jar para permitir gerar do PDF. Isto será expedido na release 12.1.27, documento técnico DMANMI03-4231 DT FE México - Antecipações CFDI 3.3 Geração de PDF MEX