Cadastro Nacional de Obras
Características do Requisito
Linha de Produto: | Microsiga Protheus ® | ||||||||||||||||||
Segmento: | Serviços | ||||||||||||||||||
Módulo: | Gestão de Projetos | ||||||||||||||||||
Rotina: |
| ||||||||||||||||||
Requisito/Story/Issue (informe o requisito relacionado): | DSERFINP-12147 | ||||||||||||||||||
País(es): | Brasil | ||||||||||||||||||
Banco(s) de Dados: | Todos homologados | ||||||||||||||||||
Tabelas Utilizadas: | SON - Cadastro Nacional de Obras SC5 - Pedidos de Venda SF2 - Cabeçalho das NF de Saída AF8 - Projetos | ||||||||||||||||||
Sistema(s) Operacional(is): | Todos homologados |
Descrição
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 de Dicionário
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). |
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
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tot="http://www.totvs.com/"> <soapenv:Header/> <soapenv:Body> <tot:RECEIVEMESSAGE> <tot:INMSG><![CDATA[ <?xml version="1.0" encoding="UTF-8"?> <TOTVSMessage> <MessageInformation version="2.000"> <UUID>3712c13b-8a5x-d2b1-6594-r396f0859399</UUID> <Type>BusinessMessage</Type> <Transaction>PROJECT</Transaction> <StandardVersion>1.000</StandardVersion> <SourceApplication>RM</SourceApplication> <CompanyId>18</CompanyId> <BranchId>5</BranchId> <Product name="RM" version="12.1.17.0" /> <GeneratedOn>2018-02-22T21:10:31</GeneratedOn> <DeliveryType>Sync</DeliveryType> </MessageInformation>ad <BusinessMessage> <BusinessEvent> <Entity>PROJECT</Entity> <Event>upsert</Event> </BusinessEvent> <BusinessContent> <CompanyId>18</CompanyId> <BranchId>5</BranchId> <CompanyInternalId>18|5</CompanyInternalId> <ShortCode>302</ShortCode> <Code>046</Code> <InternalId>38|308</InternalId> <Description>Projeto 46</Description> <CostCenterCode>13106</CostCenterCode> <CostCenterInternalId>18|13106</CostCenterInternalId> <RegisterDate>2018-02-22T21:10:31.54</RegisterDate> <StatusProject>4</StatusProject> <WorkCode>333333</WorkCode> <WorkId>1</WorkId> <WorkGovernmentalId>02787291422</WorkGovernmentalId> </BusinessContent> </BusinessMessage> </TOTVSMessage> ]]> </tot:INMSG> </tot:RECEIVEMESSAGE> </soapenv:Body> </soapenv:Envelope>
Pedido:
- WorkCode - Numeração do CNO
Obs.: Versão a ser informada no XML da Mensagem Única para o Pedido: "4.003"
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tot="http://www.totvs.com/"> <soapenv:Header/> <soapenv:Body> <tot:RECEIVEMESSAGE> <tot:INMSG><![CDATA[ <?xml version="1.0" encoding="UTF-8"?> <TOTVSMessage> <MessageInformation version="2.000"> <UUID>3712c13b-8a5x-d2b1-6594-r496f1859588</UUID> <Type>BusinessMessage</Type> <Transaction>PROJECT</Transaction> <StandardVersion>1.000</StandardVersion> <SourceApplication>RM</SourceApplication> <CompanyId>18</CompanyId> <BranchId>5</BranchId> <Product name="RM" version="12.1.17.0" /> <GeneratedOn>2018-03-05T21:10:31</GeneratedOn> <DeliveryType>Sync</DeliveryType> </MessageInformation> <BusinessMessage> <BusinessEvent> <Entity>PROJECT</Entity> <Event>upsert</Event> </BusinessEvent> <BusinessContent> <CompanyId>18</CompanyId> <BranchId>5</BranchId> <CompanyInternalId>18|5</CompanyInternalId> <ShortCode>302</ShortCode> <Code>046</Code> <InternalId>38|308</InternalId> <Description>Projeto 46</Description> <CostCenterCode>13106</CostCenterCode> <CostCenterInternalId>18|13106</CostCenterInternalId> <RegisterDate>2018-02-22T21:10:31.54</RegisterDate> <StatusProject>4</StatusProject> <WorkCode>333333</WorkCode> <WorkId>1</WorkId> <WorkGovernmentalId>02787291422</WorkGovernmentalId> </BusinessContent> </BusinessMessage> </TOTVSMessage> ]]> </tot:INMSG> </tot:RECEIVEMESSAGE> </soapenv:Body> </soapenv:Envelope>
Procedure:
Links de documentação da integração TOP X Protheus via Procedure:
Procedimento para Utilização
Exemplo 1:
- 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.