Histórico da Página
Cadastro Nacional de Obras, Tipo de Repasse e Complemento de Cliente para Programa de Aquisição de Alimentos
Características do Requisito
Linha de Produto: | Protheus® | ||||||||||||||||||||||
Segmento: | Serviços | ||||||||||||||||||||||
Módulo: | Faturamento | ||||||||||||||||||||||
Rotina: |
| ||||||||||||||||||||||
Requisito/Story/Issue (informe o requisito relacionado): | DSERFAT-4394 | ||||||||||||||||||||||
País(es): | Brasil | ||||||||||||||||||||||
Banco(s) de Dados: | Todos homologados | ||||||||||||||||||||||
Tabelas Utilizadas: | AF8 - Projetos AI0 - Complementos de Clientes SA1 - Clientes SC5 - Pedidos de Venda SC6 - Itens dos Pedidos de Venda SD2 - Itens de Venda da NF SF2 - Cabeçalho das NF de Saída SON - Cadastro Nacional de Obras | ||||||||||||||||||||||
Sistema(s) Operacional(is): | Todos homologados |
Descrição
Disponibilizadas atualizações para contemplação do Reinf, sendo estas:
1° - Criados campos C6_TPREPAS e D2_TPREPAS para que seja informado se o item é destinado a uma associação desportiva conforme exigência do evento R-2030 do Reinf.
2° - Criado o Complemento de Cliente com o campo AIO_INDPAA para que seja indicado se o cliente pertence ao Programa de Aquisição de Alimentos conforme exigência do evento R-2050 do Reinf.
- Esta opção esta vinculada ao cadastro do cliente, sendo necessário o acesso do registro como alteração, neste modo dentro de Ações Relacionadas estará disponível a opção Complemento de Cliente.
3° - Ajustado Cadastro Nacional de Obras do Protheus para atendimento ao Reinf.
Este cadastro é registrado no tabela SON com os dados exigidos no layout Reinf para o cadastro nacional de obras.
Este registro por sua vez pode é vinculado a demais processos como Pedido de Venda, Notas Fiscais e Projetos através de seus campo de CNO (C5_CNO, F2_CNO e AF8_CNO), o que pode ser feito manualmente ou através dos relacionamentos entre estes.
Por exemplo: Um pedido gerado através da medição de venda de um projeto que tenha seu campo AF8_CNO preenchido ira receber o valor em seu campo C5_CNO, e caso posteriormente este pedido for faturado o mesmo conteúdo do campo CNO será levado ao F2_CNO.
Foram tratadas também as integrações via mensagem única e procedure do projeto, de forma com que ao realizada se a informação do CNO for encaminhada será gerado registro SON.
Abaixo segue relação de comportamento das integrações em caso de envio do CNO.
Inclusão:
- Envio de um novo projeto com CNO inexistente na tabela SON → Incluso novo registro SON de forma automática e gravado valor do ON_CODIGO no campo AF8_CNO;
- Envio de um novo projeto com CNO existente na tabela SON → Identificamos que registro já existe e apenas gravamos o valor do ON_CODIGO no campo AF8_CNO.
Alteração:
- Envio de um projeto já existente na AF8 com CNO inexistente na tabela SON → Incluso novo registro SON de forma automática e gravado valor do ON_CODIGO no campo AF8_CNO / Excluído CNO antigo, caso não fira os relacionamentos, mantendo a integridade dos registros;
- Envio de um projeto já existente na AF8 com CNO em branco → Apagado conteúdo do campo AF8_CNO / Excluído CNO antigo, caso não fira os relacionamentos, mantendo a integridade dos registros.
Exclusão:
- Envio da exclusão de um projeto da AF8 com CNO informado → Excluído CNO, caso não fira os relacionamentos, mantendo a integridade dos registros.
Obs1.: A mensagem única do pedido apenas consulta o CNO enviado na tabela SON, logo para que este fique vinculado ao pedido é necessário que já exista na tabela do Protheus.
Obs.2: Relacionamentos = Vínculo com demais registros, exemplo, ON_CODIGO esteja informado no C5_CNO.
Atualizações do Compatibilizador
- Criação de tabela no arquivo SX2– Tabelas:
Chave | Nome | Ac. Filial | Ac. Unidade | Ac. Empresa | PYME |
AI0 | COMPLEMENTOS DE CLIENTES | C | C | C | S |
2. Criação e Alteração de Campos no arquivo SX3 – Campos:
- Tabela SON - Cadastro Nacional de Obras
Campo | ON_CODIGO |
Tipo | Caracter |
Tamanho | 6 |
Decimal | 0 |
Título | Código |
Descrição | Código do CNO |
Usado | Sim |
Obrigatório | Sim |
Browse | Sim |
When | INCLUI |
Relação | GetSXENum("SON","ON_CODIGO") |
Val. Sistema | ExistChav("SON") |
Help | Código que identifica o CNO. |
Campo | ON_DESC |
Tipo | Caracter |
Tamanho | 90 |
Decimal | 0 |
Título | Descrição |
Descrição | Descrição do CNO |
Usado | Sim |
Obrigatório | Sim |
Browse | Sim |
Val. Sistema | Texto() |
Help | Descrição do CNO. |
Campo | ON_IDOBRA |
Tipo | Caracter |
Tamanho | 1 |
Decimal | 0 |
Título | Ind.Obra |
Descrição | Identificação da Obra |
Usado | Sim |
Obrigatório | Sim |
Browse | Não |
Opções | 0=Nao Obra Constr. Civil / Matricula;1=Empreitada Total;2=Empreitada Parcial |
Relação | "0" |
Val. Sistema | Pertence('012') |
Help | Indicativo de Prestação de Serviços em Obra de Construção Civil: 0 - Não é obra de construção civil ou não está sujeita a matrícula de obra; 1 - Obra de Construção Civil - Empreitada Total; 2 - Obra de Construção Civil - Empreitada Parcial. |
Campo | ON_CNO |
Tipo | Caracter |
Tamanho | 14 |
Decimal | 0 |
Título | Número CNO |
Descrição | Número do CNO |
Usado | Sim |
Obrigatório | Sim |
Browse | Não |
Val. Sistema | ExistChav("SON",M->ON_CNO,3) |
Help | Número do CNO. |
Campo | ON_TPINSCR |
Tipo | Caracter |
Tamanho | 1 |
Decimal | 0 |
Formato | @! |
Título | Tp Inscrição |
Descrição | Tipo de inscrição |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Opções | 1=CNPJ;4=CNO |
Val. Sistema | Pertence("14") |
Help | Indica se o valor do campo ON_CNO é o CNPJ ou CNO. |
Campo | ON_TIPO |
Tipo | Caracter |
Tamanho | 1 |
Decimal | 0 |
Título | Tipo Prop |
Descrição | Tipo do Proprietário CNO |
Usado | Sim |
Obrigatório | Sim |
Browse | Não |
Opções | 1=Juridico;2=Fisico |
Relação | "1" |
Val. Sistema | Pertence('12') |
Help | Informe o proprietário do CNO. |
Campo | ON_CGC |
Tipo | Caracter |
Tamanho | 14 |
Decimal | 0 |
Formato | @R 99.999.999/9999-99 |
Formato Variável | A322PPes(M->ON_TIPO) |
Título | CNPJ/CPF Pro |
Descrição | CNPJ/CPF Proprietário |
Usado | Sim |
Obrigatório | Sim |
Browse | Não |
Val. Sistema | Vazio() .Or. CGC(M->ON_CGC) |
Help | Informe o CNPJ ou CPF do proprietário do CNO. |
Campo | ON_TPOBRA |
Tipo | Caracter |
Tamanho | 1 |
Decimal | 0 |
Formato | @! |
Título | Tipo da Obra |
Descrição | Obra própria ou terceiro |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Opções | 1=Própria;2=Terceiro |
Val. Sistema | Vazio() .OR. Pertence("12") |
Help | Indica se a obra é propria ou pertence a terceiros. |
- Tabela AF8 - Projetos
Campo | AF8_CNO |
Tipo | Caracter |
Tamanho | 6 |
Decimal | 0 |
Título | Cod Obra |
Descrição | Código da Obra |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Val. Sistema | Vazio() .Or. ExistCpo("SON",M->AF8_CNO) |
Consulta Padrão | SON |
Help | Indica o Código da Obra relacionado ao projeto. |
- Tabela SC5 - Pedidos de Venda
Campo | C5_CNO |
Tipo | Caracter |
Tamanho | 6 |
Decimal | 0 |
Título | Cod CNO |
Descrição | Código CNO |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Val. Sistema | Vazio() .Or.(ExistCpo('SON',M->C5_CNO ) .And. a410VldPMS()) |
Consulta Padrão | SON |
Help | Informe o código referente ao cadastro nacional de obra (CNO). |
- Tabela SF2 - Cabeçalho das NF de Saída
Campo | F2_CNO |
Tipo | Caracter |
Tamanho | 6 |
Decimal | 0 |
Título | Cod CNO |
Descrição | Código CNO |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Val. Sistema | Vazio() .Or. ExistCpo('SON',M->F2_CNO ) |
Consulta Padrão | SON |
Help | Informe o código referente ao cadastro nacional de obra (CNO). |
- Tabela SC6 - Itens dos Pedidos de Venda
Campo | C6_TPREPAS |
Tipo | Caracter |
Tamanho | 6 |
Decimal | 0 |
Formato | @! |
Título | Tipo Repasse |
Descrição | Tipo de Repasse |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Val. Sistema | Vazio() .OR. ExistCpo("SX5","0G"+M->C6_TPREPAS) |
Consulta Padrão (SX5) | 0G |
Help | Tipo de repasse, conforme tabela do REINF. |
- Tabela SD2 - Itens de Venda da NF
Campo | D2_TPREPAS |
Tipo | Caracter |
Tamanho | 6 |
Decimal | 0 |
Formato | @! |
Título | Tipo Repasse |
Descrição | Tipo de Repasse |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Val. Sistema | Vazio() .OR. ExistCpo("SX5","0G"+M->D2_TPREPAS) |
Consulta Padrão (SX5) | 0G |
Help | Tipo de repasse, conforme tabela REINF. |
Tabela AI0 - Complementos de Clientes
Campo | AI0_FILIAL |
Tipo | Caracter |
Tamanho | 2 |
Decimal | 0 |
Título | Filial |
Descrição | Filial do Sistema |
Usado | Não |
Obrigatório | Não |
Browse | Não |
Grupo de Campos | 033 |
Help | Código que identifica a filial da empresa usuária do sistema. |
Campo | AI0_CODCLI |
Tipo | Caracter |
Tamanho | 6 |
Decimal | 0 |
Formato | @! |
Título | Cod. Cliente |
Descrição | Código do Cliente |
Inicializador Browse | 001 |
Usado | Sim |
Obrigatório | Sim |
Browse | Não |
Help | Código que individualiza cada um dos clientes da empresa. É complementado pelo código da loja. |
Campo | AI0_LOJA |
Tipo | Caracter |
Tamanho | 2 |
Decimal | 0 |
Formato | @! |
Título | Loja |
Descrição | Loja do Cliente |
Inicializador Browse | 002 |
Usado | Sim |
Obrigatório | Sim |
Browse | Não |
Help | Código que identifica a loja do Cliente. Permite que haja um controle das operações por loja. |
Campo | AI0_INDPAA |
Tipo | Caracter |
Tamanho | 1 |
Decimal | 0 |
Formato | @! |
Título | Pert PAA? |
Descrição | Aquisição de Alimentos? |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Opções | 1=Sim;2=Não |
Val. Sistema | Vazio() .OR. Pertence("12") |
Help | Pertence ao Programa de Aquisição de Alimentos? |
Importante:
O tamanho dos campos que possuem grupo pode variar conforme ambiente em uso.
3. Criação de Consulta Padrão no arquivo SXB – Consulta Padrão:
- Pesquisa SON:
Alias | SON |
Tipo | 1 |
Sequência | 01 |
Coluna | DB |
Descrição | Cad.Nacional Obras |
Contém | SON |
Alias | SON |
Tipo | 2 |
Sequência | 01 |
Coluna | 01 |
Descrição | Filial + Codigo |
Contém |
Alias | SON |
Tipo | 2 |
Sequência | 02 |
Coluna | 02 |
Descrição | Filial + descricao |
Contém |
Alias | SON |
Tipo | 3 |
Sequência | 01 |
Coluna | 01 |
Descrição | Cadastra Novo |
Contém | 01 |
Alias | SON |
Tipo | 4 |
Sequência | 01 |
Coluna | 01 |
Descrição | Codigo |
Contém | ON_CODIGO |
Alias | SON |
Tipo | 4 |
Sequência | 01 |
Coluna | 02 |
Descrição | Descrição |
Contém | ON_DESC |
Alias | SON |
Tipo | 4 |
Sequência | 02 |
Coluna | 01 |
Descrição | Codigo |
Contém | ON_CODIGO |
Alias | SON |
Tipo | 4 |
Sequência | 02 |
Coluna | 02 |
Descrição | Descrição |
Contém | ON_DESC |
Alias | SON |
Tipo | 5 |
Sequência | 01 |
Coluna | |
Descrição | |
Contém | SON->ON_CODIGO |
4. Criação de Índices no arquivo SIX – Índices:
Índice | SON |
Ordem | 3 |
Chave | ON_FILIAL+ON_CNO |
Descrição | Filial + Numero CNO |
Proprietário | S |
Procedimento para Configuração
Necessário apenas para as integrações:
Mensagem Única:
Links de documentação da integração TOP X Protheus via Mensagem Única:
Novas tags obrigatórias para o envio do CNO:
Projetos:
- WorkCode - Numeração do CNO
- WorkId - Identificação da Obra (0 = Não Obra Constr. Civil/Matricula,1 = Empreitada Total e 2=Empreitada Parcial)
- WorkGovernmentalId - CNPJ do Proprietário da Obra
Exemplo de XML - Projeto
|
Pedido:
- WorkCode - Numeração do CNO
Obs.: Versão a ser informada no XML da Mensagem Única para o Pedido: "4.003"
Exemplo de XML - Pedido
|
Procedure:
Links de documentação da integração TOP X Protheus via Procedure:
Procedimento para Utilização
- Tipo de Repasse:
Exemplo:
- No Faturamento (SIGAFAT), acesse Atualizações / Pedidos / Pedidos de Venda.
O sistema apresenta a janela de pedidos cadastrados. - Inclua um pedido informando o campo tipo de repasse (C6_TPREPAS) no item.
- Acesse Atualizações / Pedidos / Liberação de Pedido de Venda e libere o pedido.
- Caso haja bloqueio de estoque ou de crédito realize as liberações através da rotina Liberação de Crédito e Estoque (Atualizações / Pedidos / Liberação de Crédito e Estoque).
- Acesse Atualizações / Faturamento / Documento de Saída.
Será apresentada a relação de pedidos. - Selecione o pedido e clique em Prep. Doc's.
Será apresentada a janela de numeração de notas e séries, selecione uma e confirme.
- Cliente Pertence ao Programa de Aquisição de Alimentos
Exemplo:
- No Faturamento (SIGAFAT), acesse Atualizações / Cadastros / Clientes.
O sistema apresenta a janela de clientes cadastrados. - Inclua um cliente.
- Selecione o cliente cadastrado e clique em Alterar.
- Acesse Outras Ações / Complemento de Cliente.
- Acesse Atualizações / Faturamento / Documento de Saída.
Será apresentado o cadastro de complemento de cliente. - Informe o campo "Pert PAA?".
Para indicar se o cliente pertence (1=Sim) ou não pertence (2=Não) ao programa de aquisição de alimentos
- Cadastro Nacional de Obras
Exemplo 1:
Obs.: Este cadastro é feito através da rotina MATA322, a qual deve ser configurada no menu de preferência, neste caso usamos o módulo PMS.
- No Gestão de Projetos (SIGAPMS), acesse Atualizações / Cadastros / Cadastro Nacional de Obra.
O sistema apresenta a janela de CNOs cadastrados. - Inclua um registro e confirme.
Exemplo 2:
- No Gestão de Projetos (SIGAPMS), acesse Atualizações / Projetos / Projetos (modelo 2).
- Inclua um projeto com CNO (AF8_CNO), uma tarefa faturável (AF9_FATURA = 1) e um produto apontado.
- No Gestão de Projetos (SIGAPMS), acesse Atualizações / Projetos / Medição de Venda e Remessa.
O sistema apresenta a relação de projetos cadastrados. - Selecione o projeto clique em Faturar.
Será apresentada a tela de faturamento do projeto. - Expanda o projeto e selecione a tarefa, no campo % Faturar informe "100"% e clique em Adicionar e Confirma.
Será apresentado a tela do pedido de venda. - Confirme a inclusão do pedido de venda.
Exemplo 3:
- No Faturamento (SIGAFAT), acesse Atualizações / Pedidos / Pedidos de Venda.
O sistema apresenta a janela de pedidos cadastrados. - Inclua um pedido informando um CNO (C5_CNO).
- Acesse Atualizações / Pedidos / Liberação de Pedido de Venda e libere o pedido.
- Caso haja bloqueio de estoque ou de crédito realize as liberações através da rotina Liberação de Crédito e Estoque (Atualizações / Pedidos / Liberação de Crédito e Estoque).
- Acesse Atualizações / Faturamento / Documento de Saída.
Será apresentada a relação de pedidos. - Selecione o pedido e clique em Prep. Doc's.
Será apresentada a janela de numeração de notas e séries, selecione uma e confirme.
Obs.: Nos casos das integração tanto via Mensagem Única e Procedure as atualizações dos dados são automáticas, logo não há necessidade de realizar qualquer procedimento, desde que configurada corretamente.