Page tree
Skip to end of metadata
Go to start of metadata

Cadastro Nacional de Obras

Características do Requisito

Linha de Produto:

Microsiga Protheus ®

Segmento:

Serviços

Módulo:

Gestão de Projetos

Rotina:

Rotina

Nome Técnico

MATA322

Cadastro Nacional de Obras

Rotina(s) envolvida(s)

Nome Técnico

MATA410

Pedido de Venda

MATA461

Documento de Saída

PMSA200

Gerenciamento de Projetos

PMSA600

Medição de Venda e Remessa

PMSI200

Adapter da Mensagem Única de Projeto/Contrato

PMSXSOLUM

Integração PMS

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ávelA322PPes(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ãoSON

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ãoSON

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ãoSON

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

Exemplo de XML - Projeto
<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"

Exemplo de XML - Pedido
<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:

  1.        No Gestão de Projetos (SIGAPMS), acesse Atualizações / Cadastros / Cadastro Nacional de Obra.
    O sistema apresenta a janela de CNOs cadastrados.

  2.        Inclua um registro e confirme.


Exemplo 2:

  1.        No Gestão de Projetos (SIGAPMS), acesse Atualizações / Projetos / Projetos (modelo 2).

  2.        Inclua um projeto com CNO (AF8_CNO), uma tarefa faturável (AF9_FATURA = 1) e um produto apontado.

  3.        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.

  4.        Selecione o projeto clique em Faturar.
    Será apresentada a tela de faturamento do projeto.

  5.        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.

  6.        Confirme a inclusão do pedido de venda.


Exemplo 3:

  1.        No Faturamento (SIGAFAT), acesse Atualizações / Pedidos / Pedidos de Venda.
    O sistema apresenta a janela de pedidos cadastrados.

  2.        Inclua um pedido informando um CNO (C5_CNO).

  3.        Acesse Atualizações / Pedidos / Liberação de Pedido de Venda e libere o pedido.

  4.        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).

  5. Acesse Atualizações / Faturamento / Documento de Saída.
    Será apresentada a relação de pedidos.

  6.        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.