Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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:

Rotina

Nome Técnico

MATA410

Pedido de Venda

MATA322

Cadastro Nacional de Obras

MATA030

Clientes

Rotina(s) envolvida(s)

Nome Técnico

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

MATA030AComplemento de Cliente

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_CNOF2_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

  1. Criação de tabela no arquivo SX2– Tabelas:

Chave

Nome

Ac. Filial

Ac. Unidade

Ac. Empresa

PYME

AI0

COMPLEMENTOS DE CLIENTES

C

CC

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


  • 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 Campos033

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 Browse001

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 Browse002

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

<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


  • Tipo de Repasse:

Exemplo:

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

  2.        Inclua um pedido informando o campo tipo de repasse (C6_TPREPAS) no item.

  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.


  • Cliente Pertence ao Programa de Aquisição de Alimentos

Exemplo:

  1.        No Faturamento (SIGAFAT), acesse Atualizações / Cadastros / Clientes.
    O sistema apresenta a janela de clientes cadastrados.

  2.        Inclua um cliente.

  3.        Selecione o cliente cadastrado e clique em Alterar.

  4.        Acesse Outras Ações / Complemento de Cliente.

  5.        Acesse Atualizações / Faturamento / Documento de Saída.
    Será apresentado o cadastro de complemento de cliente.

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

  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.