Histórico da Página
Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico. |
---|
Informações Gerais
Especificação | |||
Produto | Microsiga Protheus | Módulo | SIGAFIN |
Segmento Executor |
| ||
Projeto | PDR_SER_CTR011 | IRM | PCREQ-7939 |
Requisito | PCREQ-7940 | Subtarefa | PDR_SER_CTR011-124 |
Chamado | Não se aplica. | ||
Release de Entrega Planejada | 12.1.7 Abril/16 | Réplica | Não se aplica. |
País | ( ) Brasil ( ) Argentina ( ) Mexico ( ) Chile ( ) Paraguai ( ) Equador ( ) USA ( ) Colombia ( X ) Outro Todos. | ||
Outros | .Não se aplica. |
Objetivo
Ajustar e criar novas mensagens únicas, relacionadas a controladoria, em prol de atender as necessidades na integração do backoffice Protheus com o software de gestão de hotelaria da Bematech, CMNet.
Definição da Regra de NegócioNegócio
Rotinas Envolvidas | ||
Rotina | Tipo de Operação | Opção de Menu |
FINI040 | Alteração | Não se aplica. |
MATI020 | Alteração | Não se aplica. |
MATI030 | Alteração | Não se aplica. |
MATI040 | Alteração | Não se aplica. |
MATA490 | Alteração | SigaFIN > Atualizações > Comissoes > Manutenção das Comissões. |
MATI490 | Criação | Não se aplica. |
FINA440 | Alteração | SigaFIN > Miscelanea > Recalculos > Recálculo de Comissão. |
FINA791 | Criação | SigaFIN > Atualizações > Hotelaria > Fatura de Hotel |
FINI791 | Criação | Não se aplica. |
FINI100 | Alteração | Não se aplica. |
MATI010 | Alteração | Não se aplica. |
FINM060 | Criação | SIGAFIN > Miscelânea > Integrações > Análise de Crédito |
FINMI060 | Criação | Não se aplica. |
FINM061 | Criação | SIGAFIN > Miscelânea > Integrações > Envio de NFS-e transmitida |
FINMI061 | Criação | Não se aplica. |
FISA048 | Alteração | SIGAFIS > Atualizações > SPED > Demais documentos Pis e Cofins |
FISI048 | Criação | Não se aplica. |
FINI040CAN | Criação | Não se aplica. |
FINI791CAN | Criação | Não se aplica. |
LOJI701CAN | Criação | Não se aplica. |
O backoffice Protheus será responsável pelo controle financeiro, fiscal e contábil das operações de hotelaria realizadas através do software CMNet.
Para tais fins, os seguintes processos serão integrados com o uso de mensagem única:
- Cadastro de cliente (pessoa física e jurídica, nacional e internacional).
- Cadastro de fornecedor (para empresa comissionada, nacional e internacional)
- Cadastro de vendedor (para empresa comissionada)
- Inclusão de recebimento antecipado (RA)
- Inclusão de provisionamento de reserva (PR a receber)
- Inclusão de adiantamento com cartão (CC / CD + NCC)
- Cancelamento de adiantamento
- Devolução de adiantamento
- Cancelamento de devolução de adiantamentos
- Alteração de valores provisionados em prol da reserva (alteração de PR a receber)
- Análise de crédito de empresas (cliente pessoa jurídica)
- Inclusão de bloco F100
- Cadastro de Produtos
- Inclusão de cupom fiscal
- Cancelamento de cupom fiscal
- Inclusão de recibo provisório de serviço (RPS)
- Cancelamento de RPS
- Redução Z
- Geração de Danfe sobre cupom
- Sincronização de RPS transmitida (envio dos números eletrônicos após transmissão ao SEFAZ)
- Cadastro de Comissões
- Faturas de Hotelaria
- Cancelamento de Faturas de Hotel
- Verificação da possibilidade de cancelamento de um título a receber
- Verificação da possibilidade de cancelamento de uma venda de varejo
- Verificação da possibilidade de cancelamento de uma fatura de hotel
Os itens marcados em negrito são processos do loja e não serão tratados nessa especificação.
Para que todos esses processos sejam adequadamente integrados, serão necessárias algumas melhorias nas rotinas de Controladoria e Loja. Esta especificação tratará apenas as alterações necessárias voltadas a controladoria.
Cadastro de Clientes |
O cadastro de cliente terá origem no sistema de hotelaria, ou seja, o Protheus irá apenas receber as informações. Essa rotina será utilizada para a integração dos cadastros de clientes do hotel.
Será necessário realizar as seguintes alterações relacionadas ao cadastro de clientes:
- Adicionar um tratamento para gerar o código do cliente automaticamente de forma sequencial, caso a integração com hotelaria esteja ativa. Para saber se a integração com hotelaria está ativa, será criado um novo parâmetro MV_INTHTL.
- Para gravação de clientes estrangeiros, será necessário adicionar uma nova tag na mensagem única de cliente (CUSTOMERVENDOR). Essa tag será utilizada para informar o tipo de cliente (Cons. Final, Revendedor, Exportação, etc). Para isso será necessário criar uma nova versão do XSD dessa mensagem (CustomerVendor_2.005) e deverá haver um tratamento no adapter (MATI030) para considerar essa tag apenas à partir dessa versão da mensagem. A nova tag será definida conforme abaixo:
TAG SUPERIOR | TAG | Obrigatória | Observação |
BusinessContent | StrategicCustomerType | Não | Tipo do Cliente (Cons.Final / Produtor / Revendedor / Solidario / Exportação). |
- Atualmente o adapter de cliente não está gravando o código de país recebido corretamente. Isso deverá ser ajustado.
- Atualmente o adapter de cliente não está gravando o CPF/CNPJ recebido corretamente. Isso deverá ser ajustado.
Cadastro de fornecedor |
- Criação de dois novos campos (AI0_CTEVEN e AI0_CTADT) na tabela de complementos de cliente (AI0), para definição de contas contábeis diferentes, uma para adiantamentos e outra para adiantamentos de eventos de hotel. Assim, quando um adiantamento é lançado no software de hotelaria e chega no Protheus, a contabilização do mesmo poderá ser feita conforme o tipo do adiantamento (verificando se é ou não de evento) e conforme a conta definida em um desses dois novos campos no cliente (correspondente ao tipo de adiantamento recebido).
Cadastro de fornecedor |
O cadastro de fornecedor terá origem no sistema de hotelaria, ou seja, o Protheus irá apenas receber as informações. Essa rotina será utilizada para a integração dos cadastros de empresas comissionadas no hotel. O cadastro de fornecedor terá origem no sistema de hotelaria, ou seja, o Protheus irá apenas receber as informações. Essa rotina será utilizada para a integração dos cadastros de empresas comissionadas no hotel. Sempre que um cliente do tipo empresa comissionada for inserida no sistema de hotelaria, serão enviadas ao Protheus as mensagens de integração de Cliente, Fornecedor e Vendedor, exatamente nessa ordem. Isso se faz necessário para que seja possível, posteriormente, gerar o título de comissão a pagar para tal comissionado (vendedor).
Será necessário realizar as seguintes alterações relacionadas ao cadastro de fornecedores:
- Quando há o uso das integrações de Cliente de Fornecedor de forma simultânea em um ambiente, há um problema com as acentuações do cliente que será cadastrado. Esse problema está relacionado a codificação do XML que é passado do MATI020 (fornecedor) para o MATI030 (cliente). Por se tratar de duas rotinas utilizando uma mesma mensagem única (CUSTOMERVENDOR), nesse cenário descrito, o recebimento da mensagem sempre passará primeiro pelo adapter de fornecedor (mesmo sendo a mensagem de cliente). Portanto, ao chamar o adapter de cliente, através do adapter de fornecedor, deve-se decodificar o XML a ser passado para que não haja problema com a acentuação.
- Atualmente o adapter de fornecedor não está gravando o código de país recebido corretamente. Isso deverá ser ajustado.
- Adicionar um tratamento para gerar o código do fornecedor automaticamente de forma sequencial, caso a integração com hotelaria esteja ativa.
- Adicionar um tratamento no adapter para, caso seja integração com hotelaria, preencher o campo de natureza do cadastro de fornecedor, para uso nos títulos de comissão. A natureza a ser utilizada deverá ser lida em um dos seguintes novos parâmetros: MV_HTLNAPJ (para fornecedor pessoa jurídica) ou MV_HTLNAPJ (para fornecedor pessoa física).
Cadastro de vendedor |
O cadastro de vendedor terá origem no sistema de hotelaria, ou seja, o Protheus irá apenas receber as informações. Essa rotina será utilizada para a integração dos cadastros de empresas comissionadas no hotel. Um vendedor se faz necessário no Protheus para que seja possível gerar os títulos de comissão do mesmo.
Será necessário realizar a seguinte alteração relacionada ao cadastro de vendedores
- Incluir um tratamento para gravar as informações de comissão do vendedor (fornecedor associado e interface de comissão). Para isso será necessário criar uma nova versão do XSD dessa mensagem (Seller_2.000) e deverá haver um tratamento no adapter (MATI040) para considerar as duas novas tags. As novas tags serão definidas conforme abaixo:
TAG SUPERIOR | TAG | Obrigatória | Observação |
BusinessContent \ SalesChargeInformation | VendorInternalId | Não | InternalId do Fornecedor. |
BusinessContent \ SalesChargeInformation | SalesChargeInterface | Não | Interface a ser utilizada no fechamento da comissão (Contas a Pagar, Folha ou Sem Interface). |
Contas a Receber |
Será necessário realizar as seguintes alterações relacionadas ao cadastro de contas a receber:
- Incluir um tratamento no adapter (FINI040) para definir o prefixo do título através de um novo parâmetro, caso a integração com hotelaria esteja ativada. Para isso, será criado o novo parâmetro MV_HTLPREF.
- Incluir um tratamento no adapter (FINI040) para definir a natureza do título através de novos parâmetros que serão criados, caso a integração com hotelaria esteja ativada. Para isso serão criados os seguintes parâmetros:
- MV_HTLNARA – Natureza para títulos do tipo RA.
- MV_HTLNAPR – Natureza para títulos do tipo PR.
- MV_HTLNACC – Natureza para títulos do tipo CC.
- MV_HTLNACD – Natureza para títulos do tipo CD.
- MV_HTLNANC – Natureza para títulos do tipo NCC.
- MV_HTLNADH – Natureza para títulos do tipo R$.
Para saber qual parâmetro deverá ser lido para definição da natureza, ao receber a mensagem de contas a receber (ACCOUNTRECEIVABLEDOCUMENT), deverá ser lida a tag de tipo de título (DocumentTypeCode) e à partir do tipo definido nessa tag, deve-se ler o parâmetro correto para a natureza.Caso o parâmetro esteja vazio, retornar uma mensagem informando que a natureza não foi informada corretamente nos parâmetros correspondentes. Exemplo: Se o tipo de documento for “RA”, deve-se ler o parâmetro MV_HTLNARA para definir a natureza desse título.
- Corrigir o Adapter (FINI040) para tratar as tags <CustomerCode> e <StoreId> no recebimento da mensagem. Hoje essas tags não são consideradas. Isso será necessário para recebimento de um título em nome de uma administradora financeira, a qual será informada na mensagem com o código Protheus nas tags em questão, e não com o código interno na tag <CustomerInternalID>.
- Será necessário adicionar três quatro novas tags na mensagem única de contas a receber (ACCOUNTRECEIVABLEDOCUMENT), para os seguintes propósitos:
- Receber o valor real do título, para tratamento de taxa de administradora em caso de título de cartão (crédito ou débito).
- Receber a NSU (número único para identificação da transação de cartão), que será utilizado para conciliação de cartão.
- Receber e enviar o número de conta hoteleira (conta correntenumero da reserva). Essa conta é utilizada para amarrar todo o processo financeiro de uma reserva de hotel.
- Receber e enviar o tipo de conta hoteleira (avulsa, individual, grupo ou evento).
Para isso será necessário criar uma nova versão do Para isso será necessário criar uma nova versão do XSD dessa mensagem (AccountReceivableDocument_2.003006) e deverá haver um tratamento no adapter (FINI040) para considerar as três novas tags. As novas tags serão definidas conforme abaixo:
TAG SUPERIOR | TAG | Obrigatória | Observação |
BusinessContent | RealValue | Não | Valor Real do Título. |
BusinessContent | UniqueSerialNumber | Não | Número Sequêncial Único que identifica a transação de cartão. |
BusinessContent \ Other | CurrentAccountHotelAccountCode | Não | Número de Conta conta (reserva) a qual as movimentações hoteleiras estão associadas. |
BusinessContent \ Other | HotelAccountType | Não | Tipo da conta hoteleira. |
Análise de crédito |
Será necessário criar uma nova mensagem única para realizar a análise de crédito dos clientes pessoa jurídica integrados ao backoffice e informar tais dados ao software de gestão hoteleira, para que o mesmo possa saber se um cliente tem crédito e se pode faturar contra o mesmo.
O novo adapter Protheus para essa rotina (FINMI060) adotará o processo já existente no backoffice (função MaAvalCred), que se baseia no grau de risco do cliente, na sua classe de crédito (informados no cadastro do cliente) e nos títulos que estão em aberto com pagamento atrasado. Após a análise, é determinado se o cliente possui crédito ou não e, sendo este o caso, é indicado o motivo através de um código (status): 01 – limite de crédito ultrapassado; 04 – validade do crédito expirada.
O envio dessa mensagem partirá do Protheus, através de tela (SIGAFIN > Miscelânea > Integrações > Análise de Crédito) ou através de um job agendado. A rotina deve ser preparada para trabalhar de ambas as maneiras. A função a ser executada por job terá a seguinte nomenclatura: FM060JOB. A mensagem a ser enviada será do tipo Event e conterá uma lista com todos os clientes (PJ) integrados e seus respectivos saldos e status de crédito. Após recebimento de tais dados, o software de gestão hoteleira deverá responder com a lista de clientes cujas análises foram lidas e processadas com sucesso.
A nova mensagem única se chamará CreditRiskAnalysis e terá a seguinte estrutura:
TAG SUPERIOR | TAG | Obrigatória | Observação |
BusinessContent | CompanyId | Não | Código da Empresa. |
BusinessContent | BranchId | Não | Código da Filial. |
BusinessContent | CompanyInternalId | Não | InternalId das informações da empresa. |
BusinessContent | ListOfCreditRiskAnalysis | Não | Lista dos clientes e seus status de crédito. |
BusinessContent \ ListOfCreditRiskAnalysis \ CreditRiskAnalysis | CustomerInternalId | Não | Código interno do cliente. |
BusinessContent \ ListOfCreditRiskAnalysis \ CreditRiskAnalysis | Status | Não | Situação do crédito do cliente. |
BusinessContent \ ListOfCreditRiskAnalysis \ CreditRiskAnalysis | CreditBalance | Não | Saldo do limite de crédito. |
ReturnContent \ ListOfCustomerInternalID | CustomerInternalId | Não | Lista dos clientes processados. |
Definições técnicas do adapter para a análise de crédito
A lista a ser enviada deverá conter somente os clientes pessoa jurídica que tiveram alteração no seu status de crédito ou no seu saldo, desde a última execução de análise de crédito. Para controlar as modificações no status dos clientes deverá ser criada uma nova tabela (AI0) para registrar o status e o saldo de cada cliente no momento de uma execução.
A análise será feita pela MaAvalCred, baseada nos dados do cadastro do cliente e nos seus títulos no financeiro. Para essa função deverá ser enviado o valor a ser analisado, no caso de integração com hotelaria, esse valor é a soma dos valores das reservas (títulos a receber do tipo PR, que provisionam os valores das reservas) e dos títulos que estão em aberto no financeiro.
A MaAvalCred, após a análise, retorna se o crédito do cliente está liberado (.T.) ou bloqueado (.F.). Além disso, disponibiliza o motivo de estar bloqueado (deve-se passar um parâmetro “por referência”, veja o cabeçalho da função no fatxfun). Será adotado o código “00” quando o crédito estiver liberado, pois a MaAvalCred não possui um código para este caso.
Procedimentos da análise de crédito:
- Localizar na tabela “de – para” (XXF) os clientes cadastrados por integração, com o software de hotelaria, e obter seus códigos no backoffice
- Para cada cliente localizado:
- determinar o valor em aberto (A1_SALDUP)
- determinar o limite de crédito estabelecido no seu cadastro (A1_LC)
- Apurar o valor das reservas que o cliente possui no backoffice, ou seja, o valor total dos títulos provisórios (PR)
- Acrescentar o valor das reservas ao valor em aberto.
- Executar a MaAvalCred, passando o valor em aberto e o parâmetro “por referência” para obter o código do bloqueio do crédito.
Caso a integração com hotelaria esteja ativada, os pedidos de venda não deverão ser considerados na análise de crédito. Para isso, existe um parâmetro a ser informado na função MaAvalCred. - Calcular o saldo do cliente: saldo = limite de crédito – valor em aberto.
- Verificar os clientes cujas informações de crédito foram alteradas, ou seja, que tiveram o status de crédito ou saldo alterados. Para isso, seguir os seguintes passos:
- recuperar da tabela de controle (AI0) o saldo e o status de crédito anteriores;
- compará-los aos novos;
- caso haja alteração, registrá-la na tabela de controle (AI0), com status (AI0_INTEG) = “2” – não atualizado .
- Criar uma lista com os clientes, cujas informações de crédito foram alteradas, contendo o saldo e o status (código do bloqueio) do crédito. Os possíveis valores de status são:
- “00” – crédito liberado;
- “01” – ultrapassa o limite de crédito;
- “04” – data de vencimento do limite de crédito expirada.
- Enviar a lista de clientes. Caso a lista (xml) seja muito extensa, dividi-la em partes e realizar múltiplos envios. Um exemplo desse tratamento pode ser visto no fonte CTBA102.
Após receber a análise de crédito, o software de gestão de hotelaria deverá processar os valores recebidos e devolver ao backoffice uma lista com os clientes cujas análises foram lidas e processadas com sucesso. O adapter (FINMI060) deverá ser preparado para tratar a resposta recebida (response message). Para cada item da lista recebida, o backoffice deverá localizar o seu registro na tabela de controle (AI0) e marcar o seu status com “1” – integrado.
Considerações sobre o uso da MaAvalCred
- Para que a análise seja executada, é necessário ativá-la, configurando o parâmetro MV_BLOQUEI.
- O parâmetro MV_CREDCLI indica se a análise será feita considerando código do cliente / loja ou somente código do cliente.
- Caso o cliente seja classificado com risco A, não é feita a analise e o crédito é considerado liberado.
- Caso o cliente seja classificado com risco E, não é feita a analise e o crédito é considerado bloqueado.
Bloco F100 |
Será necessário criar uma nova mensagem única para integrar os cadastros para o bloco F100 (Outros Documentos Pis Cofins – FISA048). Essa mensagem partirá do Newhotel PMS e será enviada ao Protheus, no intuito de informar ao backoffice os valores em aberto (sem documento fiscal gerado) dos consumos (serviços) relacionados aos “hóspedes na casa” no último dia do mês, para composição do registro F100 no Protheus para o SPED EFD.
O Adapter no Protheus será o fonte FISI048. A nova mensagem única terá a seguinte nomenclatura: OtherDocumentsF100 e terá a seguinte estrutura:
TAG SUPERIOR | TAG | Obrigatória | Observação |
BusinessContent | CompanyId | Não | Código da Empresa |
BusinessContent | BranchId | Não | Código da Filial |
BusinessContent | CompanyInternalId | Não | InternalId da chave completa de empresa do produto |
BusinessContent | InternalId | Não | InternalId do Documento |
BusinessContent | Code | Não | Codigo da Movimentação |
BusinessContent | OperIndicator | Não | Indicador de operação |
BusinessContent | Regime | Não | Tipo do Regime |
BusinessContent | OperDate | Não | Data da Operação |
BusinessContent | PisTax | Não | Situação Tributaria do Pis |
BusinessContent | CofinsTax | Não | Situação Tributaria do Cofins |
BusinessContent | CliSuppInternalId | Não | InternalId do Cliente / Fornecedor |
BusinessContent | CliSupp | Não | Código do Cliente/Fornecedor |
BusinessContent | ItemCodeInternalId | Não | InternalId do Item |
BusinessContent | ItemCode | Não | Código do Item |
BusinessContent | OperValue | Não | Valor da Operação |
BusinessContent | Balance | Não | Saldo |
BusinessContent | PisBase | Não | Base de calculo PIS |
BusinessContent | PisAliquot | Não | Aliquota de PIS |
BusinessContent | PisValue | Não | Valor de contribuição do PIS |
BusinessContent | CofinsBase | Não | Base de calculo Cofins |
BusinessContent | CofinsAliquot | Não | Aliquota de Cofins |
BusinessContent | CofinsValue | Não | Valor de contribuição do Cofins |
BusinessContent | BCCode | Não | Codigo de base de calculo de credito |
BusinessContent | CredOrigin | Não | Indicador Origem Crédito |
BusinessContent | LedgerAccountInternalId | Não | InternalId da conta contabil |
BusinessContent | LedgerAccount | Não | Codigo da conta contabil |
BusinessContent | CostCenter | Não | Codigo do Centro de Custo |
BusinessContent | OperDescription | Não | Descrição da Operação |
BusinessContent | ClTable | Não | Tabela de Natureza de Receitas |
BusinessContent | Calculate | Não | Apura Pis/Cofins Orgão Publico |
BusinessContent | ProjectCode | Não | Codigo do Projeto |
BusinessContent | GrossIncome | Não | Considera Receita Bruta |
BusinessContent | Participator | Não | Participante |
ReturnContent \ ListOfInternalId \ InternalId | Name | Não | Nome da InternalId. |
ReturnContent \ ListOfInternalId \ InternalId | Origin | Não | InternalId da origem |
ReturnContent \ ListOfInternalId \ InternalId | Destination | Não | InternalId do destino |
Sincronização de RPS transmitida |
Quando um cliente efetua um pagamento, é gerado um recibo provisório de serviços (RPS). Posteriormente, esse RPS é transmitido ao SEFAZ e é gerada uma Nota Fiscal de Serviço Eletrônica (NFS-e), que possuí uma identificação numérica. Esse processo de transmissão é realizado através das rotinas padrões do backoffice Protheus, porém o software de gestão de hotelaria precisa ter conhecimento desse número da nota eletrônica gerada, afim de facilitar alguns processos gerenciais. Para maiores informações sobre a transmissão de RPS no Protheus, consulte o seguinte link:
Visto isso, será necessário desenvolver uma nova mensagem única para que essa informação trafegue do Protheus ao software de hotelaria. A mensagem terá a seguinte nomenclatura: InvoiceTransfer e terá a seguinte estrutura:
TAG SUPERIOR | TAG | Obrigatória | Observação |
BusinessContent | CompanyId | Não | Código da Empresa. |
BusinessContent | BranchId | Não | Código da Filial. |
BusinessContent | CompanyInternalId | Não | InternalId das informações da empresa. |
BusinessContent | ListOfProvisionalInvoices | Não | Lista de RPS com notas fiscais eletrônicas geradas. |
BusinessContent \ ListOfProvisionalInvoices \ ProvisionalInvoice | ProvisionalInvoiceInternalId | Não | InternalId do RPS. |
BusinessContent \ ListOfProvisionalInvoices \ ProvisionalInvoice | InvoiceNumber | Não | Número da Nota Fiscal Eletrônica. |
ReturnContent \ ListOfProcessedInvoices \ ProcessedInvoice | ProvisionalInvoiceInternalId | Não | InternalId do RPS |
O envio dessa mensagem partirá do Protheus, através de tela (SIGAFIN > Miscelânea > Integrações > Envio de NFS-e transmitida, FINM061) ou através de um job agendado. A rotina deve ser preparada para trabalhar de ambas as maneiras. A função que será chamada via job terá a seguinte nomenclatura: FM061JOB. A mensagem a ser enviada será do tipo Event e conterá uma lista com todos os recibos (RPS) que foram transmitidos e seus respectivos números de nota eletrônica. Após recebimento de tais dados, o software de gestão hoteleira deverá responder com a lista de recibos cujas identificações de notas eletrônicas foram lidas e processadas com sucesso.
Os números de notas fiscais serão obtidos do TAF – Totvs Automação Fiscal, que registrará os RPS juntamente com as notas correspondentes, em uma nova tabela (FLY) para que o backoffice Protheus os envie ao software de hotelaria.
A tabela FLY, além dos dados das notas fiscais e RPS, terá um status (campo FLY_TRANSM), que indicará se número de nota fiscal eletrônica foi integrado ao software de hotelaria com sucesso. 0 – aguardando envio; 1 – enviado / recebido.
Alterações no TAF
O TAF será alterado (pela equipe responsável pelo produto) para que, após a geração da nota fiscal (transmissão do RPS), ela e o RPS sejam registrados em uma tabela nova de controle desse processo (FLY). O registro será feito por uma rotina do módulo financeiro (a ser desenvolvida) que será executada pelo TAF.
No módulo financeiro deverá ser disponibilizada uma nova função – FinRegNFE – para registro do número da nota, através do TAF. Essa função deverá receber três parâmetros, sendo eles: série do RPS, número do RPS e o número da nota fiscal. No registro, a função verificará se o RPS existe ou não e fará a ação correspondente (incluir ou alterar), marcando o status como 0 (zero) – aguardando envio.
Considerações para o adapter da mensagem – FINMI061
Após receber a relação de RPS / Número de NFS-e, o software de hotelaria processará seus itens e devolverá ao backoffice uma lista RPS cujos números de nota eletrônica foram lidos e processados com sucesso. Portanto, o adapter (FINMI061) deverá ser preparado para tratar a resposta recebida (response message), sendo que, para cada item da lista de RPS recebida, deverá ser localizado o registro correspondente na tabela de controle (FLY) e marcado o seu status como 1 – enviado / recebido.
A tabela de controle (FLY) armazenará temporariamente os registros. Após serem integrados com sucesso, serão apagados “fisicamente” dessa tabela.
O fluxo da rotina deverá ser o seguinte:
- Apagar os registros já processados pelo Newhotel (status 1). Os registros deverão ser apagados “fisicamente”, não apenas marcados como apagados, como normalmente é feito.
- Enviar os registros existentes. Para isso, selecionar os registros que estejam com status em branco ou com 0.
Movimentos Bancários |
Será necessário fazer uma alteração no adapter de movimentos bancários (FINI100) para ler a natureza financeira de um novo parâmetro (MV_HTLNAMB), caso a integração com hotelaria esteja em uso.
Faturas de Hotelaria |
Na hotelaria existe a possibilidade de uma empresa ter um contrato com o hotel, de forma a permitir que seus funcionários fiquem hospedados em um período e, ao fazer checkout, as despesas da estadia desse hóspede podem ser faturadas contra a empresa em questão, gerando títulos para recebimentos futuros dos valores referentes aos serviços e produtos consumidos (RPS e Cupons Fiscais). Ou seja, nesse exemplo o hóspede não paga nada ao sair do hotel e a empresa é quem paga isso em um momento futuro, conforme regras estabelecidas em seu contrato.
Esse processo precisará ser integrado ao Protheus, pois o mesmo gera títulos financeiros que estão associados a determinados Recibos Provisórios de Serviços (RPS) e Cupons Fiscais. Para isso, serão necessários os seguintes pontos:
- Criação de novas tabelas: FO8 - Cabeçalho da Fatura ,FO9 - Amarração da Fatura x Notas (RPS/Cupom) e FOA - Amarração da Fatura x Títulos a Receber;
- Criação de uma nova mensagem única para recebimento das informações de Faturas de Hotel (HotelInvoice);
- Criação de uma nova rotina de menu no Protheus (FINA791), para apenas visualização das informações de Faturas (Não haverá opção de Inclusão, Alteração e Exclusão no Protheus);
- Criação de um adapter para tratar o recebimento da mensagem única de Faturas (FINI791);
- Criação de novo parâmetro para definição de Natureza dos títulos gerados no processo de faturas de hotel: MV_HTLNAFT;
Detalhes técnicos:
- A rotina de faturas de hotelaria, no Protheus, será apenas para visualização dos registros e estará divida em três partes, conforme proposto no Protótipo 01 - Tela de Faturas de Hotelaria. As três partes são: Cabeçalho da Fatura (tabela FO8), Notas (Tabela FO9) e Títulos a Receber. Essa rotina deverá ser codificada em MVC;
- O adapter (FINI791) deverá ser codificado seguindo o padrão de gravação MVC com os modelos de dados da rotina FINA791, ao invés de utilizar ExecAuto. Também deverá ser utilizado a classe mais atual para manipulação de XML, tXmlManager, ao invés de XMLParser;
- Para criação dos títulos a receber da fatura, na mensagem trafegará apenas os valores e data de vencimento de cada título. Portanto, o adapter deverá complementar a chave para inclusão do título via ExecAuto da rotina FINA040, seguindo os seguintes critérios:
- Prefixo: Pegar do parâmetro MV_HTLPREF;
- Número: Será o número da Fatura (tag Code);
- Parcela: Se houver apenas um título (na tag ListOfAccountReceivableInformation), poderá ficar em branco. Se houver mais de um título, então será um sequencial conforme o número de títulos. Ou seja, se houver três informações de títulos no XML, então haverá a parcela 01, 02 e 03, respectivamente.
- Tipo: Pegar do parâmetro MV_HTLFT, que por padrão terá o valor FT (Fatura).
- Natureza: Esse campo não faz parte da chave, mas o mesmo deverá ter seu valor definido através do parâmetro MV_HTLNAFT.
- Os títulos gerados no processo de faturas de hotel, deverão ser gravados com origem na rotina FINI791 (E1_ORIGEM = FINI791);
- Os títulos gravados no recebimento da mensagem de Fatura de Hotel, não terão seus IDs retornados na resposta do processamento dessa mensagem. O único InternalId que será retornado é o da própria fatura.
- Na visualização da tela deverá haver um grid com os títulos da fatura em questão. Para filtrar esses títulos, considerar a lógica de chave acima informada;
- O adapter possuirá apenas tratamentos para o recebimento da mensagem em questão, visto que o detentor da lógica de geração de faturas é o sistema de hotelaria (CMNet);
- Se uma fatura precisar ser alterada ou excluída, a mesma deverá ser cancelada e uma nova será incluída. Deverá ser enviado um novo numero de fatura.
- Criar uma função no adapter (FINI791) para encontrar a chave do registro de fatura de hotel no Protheus, à partir da chave externa recebida na mensagem.
- Criar uma função no adapter (FINI791) para criar o valor de InternalId com a chave da fatura no Protheus.
- Caso a tag HotelInvoiceCancellation esteja preenchida com '1' o sistema irá executar o processo de cancelamento de fatura, assim o sistema irá executar as seguintes operações:
- O sistema irá excluir os títulos utilizando a execauto da rotina FINA040.
- Caso todos os titulo tenham sido excluídos com sucesso, o sistema irá alterar o status da fatura como cancelado.
- Caso o sistema não permita a exclusão dos títulos, a mensagem irá retornar o erro e não irá cancelar a fatura.
Faturas com comissão descontada:
Existe também a possibilidade de uma fatura ser gerada para um cliente que também é um comissionado no processo em questão. Exemplo: Um hóspede compra o serviço de hospedagem em um hotel através de uma agência de viagens. O hóspede é cliente da agência e paga para a mesma. A agência, por sua vez, paga ao hotel e, portanto, é cliente do hotel. Contudo, pelo fato da agência ter vendido o serviço do hotel ao hóspede, o hotel pagará uma comissão a essa agência.
Visto esse cenário, se imaginarmos que essa agência tem um contrato com o hotel para geração de faturas, o hotel pode gerar uma fatura já com o valor descontado da comissão que ele pagaria para a agência. Exemplo: A agência deve ao hotel R$ 1.000,00 que foram gastos em serviços de hospedagem e deve pagar R$ 100,00 de comissão para essa agência pois o hóspede que está usufruindo dos serviços de hospedagem, os adquiriu através da agência. No final da estadia do hóspede o hotel ao invés de gerar uma fatura de R$ 1.000,00 e uma comissão a pagar de R$ 100,00, gera apenas uma fatura de R$ 900,00 (1000 -100) para o cliente (agência) pagar. Ou seja, desconta a comissão na fatura.
Nesse caso, o cálculo de impostos da comissão que está sendo descontada não deixa de existir e precisaremos ter esse controle no backoffice. Para isso, a ideia é trafegar na mensagem de faturas (tag SalesChargeDiscount) o valor de comissão que foi descontado na fatura. Com essa informação, será feito um tratamento no adapter de fatura (FINI791) para gerar um contas a pagar e baixar o mesmo, representando a comissão que foi descontada e gerando os tratamentos de impostos padrão do Protheus, com base nos dados da natureza e fornecedor utilizados para tal título a pagar. Para definição da natureza e da chave do título a pagar a ser gravado, o adapter deverá seguir as seguintes regras:
- Prefixo: Pegar do novo parâmetro MV_HTLPREC, que por padrão terá o valor "CDF" (Comissão descontada em Fatura);
- Número: Será o número da Fatura (tag Code);
- Parcela: Poderá ficar em branco.
- Tipo: Pegar do novo parâmetro MV_HTLTCDF que por padrão terá o valor DP (Duplicata).
- Natureza: Esse campo não faz parte da chave, mas o mesmo deverá ter seu valor definido através do parâmetro MV_HTLNCPF ou MV_HTLNCPJ.
Para definir a natureza, será necessário fazer um tratamento no adapter para ver se o fornecedor (tag CustomerVendorInternalId) é pessoa física ou pessoa jurídica. Caso seja pessoa física, a natureza será definida conforme o valor do parâmetro
MV_HTLNCPF. Caso seja pessoa jurídica, então o parâmetro que será utilizado é o MV_HTLNCPJ.
Detalhes da Mensagem (XSD):
Nome da Mensagem: HotelInvoice
Versão: 1.000
Tipo: Event
Estrutura:
TAG SUPERIOR | TAG | Obrigatória | Descrição |
BusinessContent | CompanyId | Não | Código da Empresa. |
BusinessContent | BranchId | Não | Código da Filial. |
BusinessContent | CompanyInternalId | Não | InternalId das informações da empresa. |
BusinessContent | InternalID | Não | Identificador único da fatura |
BusinessContent | Code | Não | Código da fatura |
BusinessContent | IssueDate | Não | Data de Emissão da fatura |
BusinessContent | CustomerVendorInternalId | Não | Identificador único do Cliente da fatura |
BusinessContent | Value | Não | Valor da Fatura |
BusinessContent | HotelInvoiceCancellation | Não | Indicação se é um cancelamento de fatura por padrão é 2 não cancelado. 1= Fatura Cancelada,2=Fatura não cancelada |
BusinessContent \ ListOfRetailSales\RetailSales | RetailSalesInternalId | Não | Identificador Único do RPS/Cupom Fiscal integrado com a mensagem RetailSales |
BusinessContent \ ListOfAccountReceivableInformation \ AccountReceivableInformation | Value | Não | Valor do Título a Receber |
BusinessContent \ ListOfAccountReceivableInformation \ AccountReceivableInformation | DueDate | Não | Data de Vencimento do Título a Receber |
ReturnContent | ListOfInternalId | Não | Lista de InternalIds gerados no cadastro |
Visto que quem possuí a regra de cálculo é o sistema de hotelaria, não será possível fazer o recálculo dos registro de comissão gerados por essa integração. Logo, deverá haver uma trava na rotina de Recalculo de Comissão (FINA440) para não permitir tal processo caso a origem da comissão seja integração (E3_ORIGEM = I). Também deverá haver uma trava para não permitir a alteração e exclusão de registros integrados através da rotina de manutenção de comissão (MATA490).
Comissões |
Nesta integração o detentor da regra de negócio para cálculo de comissões é o CMNet, que atende as regras especificas para a hotelaria. Portanto, o Protheus precisará estar preparado para receber essas comissões já calculadas. Para isso, será criada uma nova mensagem única: SalesCharge.
A rotina de Atualização de Comissões (MATA490) deverá ser alterada para trabalhar com mensagem única, ou seja, passará a ter uma IntegDef e será necessário criar o Adapter dessa rotina (MATI490). O Protheus terá tratamentos para recebimento e para envio também. Embora o envio, partindo do Protheus, não seja utilizado nessa integração com hotelaria, o adapter já ficará preparado para trabalhar com envio para quando se fizer necessário.
Ao receber as informações, o Protheus irá gravar a comissão (SE3) através da Execauto da rotina MATA490. Caso grave com sucesso, deverá também gravar o de/para na XXF, relacionando as chaves dos registros dos dois sistemas e deverá retornar um ListOfInternalId padrão de mensagens do tipo Event (cadastro). Para gravação da tabela XXF, deve-se utilizar a seguinte função de Framework: CFGA070Mnt.
Exemplo de retorno de ListOfInternalId:
<ListOfInternalId>
<InternalId>
<Name>SalesChargeInternalId</Name> <- Nome do InternalId
<Origin>000000001</Origin> <- Chave do registro gerado na origem da mensagem
<Destination>99|01|COM|TIT001|01|001|VEND01</Destination> <- Chave gerada no Protheus após gravação do registro
</InternalId>
</ListOfInternalId>
Exemplo de gravação de de/para na XXF:
CFGA070Mnt( "BEMATECH", "SE3", "E3_NUM", "000000001", "99|01|COM|TIT001|01|001|VEND01", .F. )
Após gravadas as informações da SE3, o processo de pagamento das comissões (geração do contas a pagar, a baixa do mesmo e tratativas de impostos) seguirá o fluxo padrão do backoffice, de forma manual conforme melhor determinado pelo cliente que utilizará a integração.
Detalhes técnicos:
- Toda comissão deve estar associada à um contas a receber. Porém, na hotelaria, a comissão pode nascer de um processo de fatura de hotel e não estará associado à um título a receber, mas sim à fatura em questão. Nesses casos, o número da fatura deverá trafegar na mensagem. Com essa informação, o adapter deverá buscar a fatura no Protheus e ver qual título foi gerado para a mesma. Então a chave do título encontrado será utilizado no registro de comissão. Caso a fatura tenha mais de um título gerado (fatura parcelada), associar a comissão ao primeiro título dessa fatura (título com a menor data de vencimento).
- Para toda comissão gravada através de mensagem única, gravar o campo E3_ORIGEM com o novo valor I, indicando integração (rotina MATI490).
IMPORTANTE: Esse novo valor deverá ser documentado na página do TDN:
http://tdn.totvs.com/pages/releaseview.action?pageId=184781116
- Codificar o adapter de forma atualizada, utilizando a classe tXmlManager ao invés de XmlParser.
- O Adapter deverá tratar os eventos de Inclusão, Alteração e Exclusão. Na inclusão e alteração, deverá retornar o ListOfinternalId na resposta. Na exclusão, deverá apagar o de/para na XXF e não deve retornar ListOfInternalId na resposta. Para saber a operação do cadastro, deve-se olhar a tag "Event", que por sua vez pode ter dois valores: "UPSERT" ou "DELETE". Se for delete, é uma operação de exclusão. Se for upsert, deve-se primeiramente buscar a chave externa (recebida na tag InternalID) no de/para do Protheus. Se encontrar algum registro, deve-se considerar que é uma operação de alteração. Do contrário, é um processo de inclusão.
Exemplo de exclusão de de/para na XXF:
CFGA070Mnt( "BEMATECH", "SE3", "E3_NUM", "000000001", "99|01|COM|TIT001|01|001|VEND01", .T. )
- Adicionar um tratamento para considerar a rotina MATI490 na função FA440Origem, no fonte FINA440. Para esse caso o retorno deverá ser "I".
- Criar uma função no adapter (MATI490) para encontrar a chave do registro de comissão no Protheus, à partir da chave externa recebida na mensagem.
- Criar uma função no adapter (MATI490) para criar o valor de InternalId com a chave da comissão no Protheus.
Detalhes da Mensagem (XSD):
Nome da Mensagem: SalesCharge
Versão: 1.000
Tipo: Event
Estrutura:
TAG SUPERIOR | TAG | Obrigatória | Descrição |
BusinessContent | CompanyId | Não | Código da Empresa. |
BusinessContent | BranchId | Não | Código da Filial. |
BusinessContent | CompanyInternalId | Não | InternalId das informações da empresa. |
BusinessContent | InternalID | Não | Identificador Único da Comissão |
BusinessContent | SellerInternalId | Não | InternalId do Vendedor |
BusinessContent | AccountReceivableDocumentInternalId | Não | InternalId do Título a Receber que originou a comissão |
BusinessContent | AccountReceivableDocumentPrefix | Não | Prefixo do Título a Receber que originou a comissão |
BusinessContent | AccountReceivableDocumentNumber | Não | Número do Título a Receber que originou a comissão |
BusinessContent | AccountReceivableDocumentParcel | Não | Parcela do Título a Receber que originou a comissão |
BusinessContent | AccountReceivableDocumentTypeCode | Não | Tipo do Título a Receber que originou a comissão |
BusinessContent | CustomerVendorInternalId | Não | Identificador único do Cliente do título a Receber que originou a comissão |
BusinessContent | CustomerVendorCode | Não | Código do Cliente do título a Receber que originou a comissão |
BusinessContent | CustomerVendorStore | Não | Loja do Cliente do título a Receber que originou a comissão |
BusinessContent | IssueDate | Não | Data de Emissão da Comissão |
BusinessContent | BaseValue | Não | Valor Base da Comissão |
BusinessContent | SalesChargePercentage | Não | Percentual de comissão sobre valor base |
BusinessContent | Value | Não | Valor da Comissão |
BusinessContent | DueDate | Não | Data de Vencimento da Comissão |
BusinessContent | CurrencyInternalId | Não | Identificador único da moeda da comissão |
BusinessContent | Currency | Não | Moeda da Comissão |
BusinessContent | HotelInvoiceInternalID | Não | InternalId da Fatura |
ReturnContent | ListOfInternalId | Não | Lista de InternalIds gerados no cadastro |
Produtos |
A mensagem de cadastro de produtos (Item) deverá ser alterada para poder receber as informações tributárias necessárias para o processo fiscal no protheus (sped, sintegra, transmissão de nfs-e). Para isso, uma nova versão da mensagem será criada (3.005), na qual serão adicionadas novas tags para trafegar tais informações. O adapter (MATI010) também deverá ser alterado para tratar o recebimento dessas informações.
Detalhes da Mensagem (Alteração de XSD):
Nome da Mensagem: Item
Versão: 3.005
Tipo: Event
Novas tags:
TAG SUPERIOR | TAG | Obrigatória | Descrição | Tipo |
BusinessContent \ FiscalInformation | PisRetaining | Não | Indica se retém PIS | Boolean |
BusinessContent \ FiscalInformation | PisAliquot | Não | Alíquota de PIS | Double |
BusinessContent \ FiscalInformation | CofinsRetaining | Não | Indica se retém COFINS | Boolean |
BusinessContent \ FiscalInformation | CofinsAliquot | Não | Alíquota de COFINS | Double |
BusinessContent \ FiscalInformation | CsllRetaining | Não | Indica se retém CSLL | Boolean |
BusinessContent \ FiscalInformation | CsllAliquot | Não | Alíquota de CSLL | Double |
BusinessContent \ FiscalInformation | IrrfIncidence | Não | Indica se tem incidência de IRRF | Boolean |
BusinessContent \ FiscalInformation | IssAliquot | Não | Alíquota de ISS | Double |
BusinessContent \ FiscalInformation | IssServiceCode | Não | Código de Serviço do ISS | String |
BusinessContent \ FiscalInformation | MunicipalTaxCode | Não | Código de Tributação Municipal | String |
Anexos:
XSD - Item_3_005
Exemplo - ExecAuto de Comissões
Tabelas Utilizadas
- SA1 – Clientes
- SA2 – Fornecedores
- SA3 – Vendedores
- SE1 – Títulos a receber
- SE3 – Comissão de Vendas
- AI0 – Complementos de Clientes
- FLY – RPS x NFe
- SF3 – Livros Fiscais
- SFT – Livro Fiscal por Item de NF
- CF8 – Demais Docs. Pis Cofins
- FO8 – Fatura Hotel
- FO9 – Fatura Hotel x Notas
- FOA - Fatura Hotel x Títulos
Protótipo de Tela
Protótipo 01 - Tela de Faturas de Hotelaria
Dicionário de Dados
Arquivo: SE1 – Títulos a receber
Campo | E1_CONHTL |
Tipo | C |
Tamanho | 32 |
Descrição | Número da Conta Hoteleira |
Título | Conta Hotel |
Picture | @! |
Obrigatório | Não |
Usado | Sim |
Browse | Não |
Help de Campo | Número utilizado para identificar a conta hoteleira à qual o título está associado. |
Campo | E1_TCONHTL |
Tipo | C |
Tamanho | 1 |
Descrição | Tipo da Conta - Hotelaria |
Título | Tipo Conta |
Valid | Pertence("1234") |
Inic. Padrão | "3" |
Lista Opções | 1=Evento;2=Grupo;3=Individual;4=Avulsa |
Obrigatório | Não |
Usado | Sim |
Browse | Não |
Help de Campo | Tipo da conta. Utilizado na integração com hotelaria. |
Arquivo: FLY – Controle de RPS e notas fiscais para envio
Índice | Chave |
01 | FLY_FILIAL + FLY_SERRPS + FLY_NUMRPS |
Campo | FLY_FILIAL |
Tipo | C |
Tamanho | 2 |
Descrição | Filial do Sistema |
Título | Filial |
Picture | @! |
Help de Campo | Filial do Sistema |
Grupo de campos | 033 |
Campo | FLY_SERRPS |
Tipo | C |
Tamanho | 3 |
Descrição | Série do RPS |
Título | Série do RPS |
Picture | @! |
Help de Campo | Série do registro provisório de serviços - RPS. |
Campo | FLY_NUMRPS |
Tipo | C |
Tamanho | 9 |
Descrição | Número do RPS |
Título | Num. do RPS |
Picture | @! |
Help de Campo | Número do recibo provisório de serviços - RPS. |
Campo | FLY_NUMFAT |
Tipo | C |
Tamanho | 9 |
Descrição | Número da nota fiscal |
Título | Num. NFe |
Picture | @! |
Help de Campo | Número da fatura eletrônica gerada para o RPS. |
Campo | FLY_TRANSM |
Tipo | C |
Tamanho | 1 |
Decimal | 0 |
Descrição | Transmitido |
Título | Transmitido |
Picture | @! |
Help de Campo | Indica se o registro foi enviado ou não: 0 - aguardando envio;1 – enviado/recebido. |
Arquivo: AI0 – Complementos de clientes
Índice |
Índice | Chave |
01 | AI0_FILIAL + AI0_CODCLI + AI0_LOJA |
Campo | AI0_FILIAL |
Tipo | C |
Tamanho | 2 |
Descrição | Filial Comp. de Clientes |
Título | Filial |
Picture | @! |
Help de Campo | Filial do Sistema |
Grupo de campos | 033 |
Campo | AI0_CODCLI |
Tipo | C |
Tamanho | 6 |
Descrição | Código do cliente |
Título | Cód Cliente |
Picture | @! |
Help de Campo | Código do cliente |
Campo | AI0_LOJA |
Tipo | C |
Tamanho | 2 |
Descrição | Loja do cliente |
Título | Loja Cliente |
Picture | @! |
Help de Campo | Loja do cliente |
Campo | AI0_STATUS |
Tipo | C |
Tamanho | 2 |
Descrição | Status do crédito |
Título | Status |
Picture | @! |
Help de Campo | Status do crédito do cliente |
Campo | AI0_SALDO |
Tipo | N |
Tamanho | 16 |
Decimal | 2 |
Usado | Não |
Descrição | Saldo do cliente |
Título | Saldo Cli |
Picture | @E 9,999,999,999,999.99 |
Help de Campo | Saldo do cliente obtido no ultimo processamento da avaliação de crédito |
Campo | AI0_SALDOSALDPR |
Tipo | N |
Tamanho | 16 |
Decimal | 2 |
Descrição | Saldo do clientecom provisórios |
Título | Saldo Clicom PR |
Picture | @E 9,999,999,999,999.99 |
Contexto | Real |
Visual | Visualizar |
Help de Campo | Saldo do cliente obtido no ultimo processamento da avaliação de crédito, considerando os valores de títulos provisórios. |
Campo | AI0_INTEG |
Tipo | C |
Tamanho | 1 |
Descrição | Registro integrado |
Título | Integrado |
Picture | @! |
Lista Opções | 1=Sim;2=Não |
Inicializador Padrão | ‘2’ |
Help de Campo | Indica se o registro não foi enviado ou está desatualizado no Sistema integrado. |
Campo | AI0_CTADT |
Tipo | C |
Tamanho | 20 |
Grupo de campos | 003 |
Descrição | Conta de Adiantamento |
Título | Conta Adiant |
Picture | @! |
Consulta Padrão | CT1 |
Valid | Vazio() .OR. Ctb105Cta |
Usado | Sim |
Obrigatório | Nao |
Browse | Nao |
Contexto | Real |
Propriedade | Alterar |
Help de Campo | Conta de adiantamento do cliente. Pode ser utilizada para contabilizar os adiantamentos que foram realizados para esse cliente.. |
Campo | AI0_CTEVEN | Campo | AI0_INTEG |
Tipo | C | ||
Tamanho1 | 20 | ||
Grupo de campos | 003 | ||
DescriçãoRegistro integrado | Conta de Adiantamentos de Evento | ||
TítuloIntegrado | Conta Evento | ||
Picture | @! | ||
Lista Opções | 1=Sim;2=Não | ||
Inicializador Padrão | ‘2’ | ||
Help de Campo | Indica se o registro não foi enviado ou está desatualizado no Sistema integrado. | ||
Consulta Padrão | CT1 | ||
Valid | Vazio() .OR. Ctb105Cta | ||
Usado | Sim | ||
Obrigatório | Nao | ||
Browse | Nao | ||
Contexto | Real | ||
Propriedade | Alterar | ||
Help de Campo | Conta de adiantamento do cliente para eventos de hotelaria. Pode ser utilizada para contabilizar os adiantamentos que foram realizados para esse cliente, em um evento de hotelaria. |
Arquivo: FO8 – Fatura de Hotel
Chave | Nome | Modo Filial | Modo Empresa | Modo Unidade | Pyme |
FO8 | Fatura de Hotel | Exclusivo | Exclusivo | Exclusivo | Sim |
Índice | FO8 |
Ordem | 1 |
Chave | FO8_FILIAL + FO8_NUM + FO8_CLI + FO8_LOJA |
Descrição | Num. Fatura + Cod. Cliente + Loja |
Mostra Pesq. | Sim |
Campo | FO8_FILIAL |
Tipo | Caracter |
Tamanho | 8 |
Decimal | 0 |
Título | Filial |
Descrição | Filial do Sistema |
Usado | Não |
Obrigatório | Não |
Browse | Não |
Grupo de Campos | 033 - Tamanho da Filial |
Help de Campo | Filial do Sistema |
Ordem | 01 |
Campo | FO8_NUM |
Tipo | Caracter |
Tamanho | 9 |
Decimal | 0 |
Formato | @! |
Título | Num. Fatura |
Descrição | Número da Fatura |
Usado | Sim |
Obrigatório | Sim |
Browse | Sim |
Contexto | Real |
Propriedade | Alterar |
Grupo de Campos | 018 - Documento de entrada/saída |
Help de Campo | Número da fatura de hotelaria. |
Ordem | 02 |
Campo | FO8_DATA |
Tipo | Data |
Tamanho | 8 |
Decimal | 0 |
Título | Data |
Descrição | Data da Fatura |
Usado | Sim |
Obrigatório | Sim |
Browse | Sim |
Contexto | Real |
Propriedade | Alterar |
Help de Campo | Data de emissão da fatura de hotelaria. |
Ordem | 03 |
Campo | FO8_CLI |
Tipo | Caracter |
Tamanho | 6 |
Decimal | 0 |
Formato | @! |
Título | Cod. Cliente |
Descrição | Código do Cliente. |
Usado | Sim |
Obrigatório | Sim |
Browse | Sim |
Val. Sistema | ExistCpo( "SA1", M->FO8_CLI ) |
Contexto | Real |
Propriedade | Alterar |
Grupo de Campos | 001 - Codigo Cliente/Fornecedor |
Help de Campo | Código do Cliente da Fatura. |
Ordem | 04 |
Campo | FO8_LOJA |
Tipo | Caracter |
Tamanho | 2 |
Decimal | 0 |
Formato | @! |
Título | Loja |
Descrição | Loja do Cliente. |
Usado | Sim |
Obrigatório | Sim |
Browse | Sim |
Val. Sistema | ExistCpo( "SA1", M->FO8_CLI + M->FO8_LOJA ) |
Contexto | Real |
Propriedade | Alterar |
Grupo de Campos | 002 - Loja Cliente/Fornecedor |
Help de Campo | Loja do Cliente da Fatura. |
Ordem | 05 |
Campo | FO8_NCLI |
Tipo | Caracter |
Tamanho | 40 |
Decimal | 0 |
Formato | @! |
Título | Desc. Client |
Descrição | Descrição do Cliente. |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Inic. Padrão | Iif(!INCLUI, Posicione("SA1", 1, FWxFilial("SA1") + FO8->FO8_CLI + FO8->FO8_LOJA, "A1_NOME"), "") |
Contexto | Virtual |
Propriedade | Visualizar |
Inic. Browse | Posicione("SA1", 1, FWxFilial("SA1") + FO8->FO8_CLI + FO8->FO8_LOJA, "A1_NOME") |
Help de Campo | Descrição do Cliente da Fatura. |
Ordem | 06 |
Campo | FO8_VALOR |
Tipo | Numérico |
Tamanho | 16 |
Decimal | 2 |
Formato | @E 9,999,999,999,999.99 |
Título | Valor |
Descrição | Valor da Fatura. |
Usado | Sim |
Obrigatório | Sim |
Browse | Sim |
Contexto | Real |
Propriedade | Alterar |
Help de Campo | Valor da Fatura. |
Ordem | 07 |
Campo | FO8_STATUS |
Tipo | Caracter |
Tamanho | 1 |
Decimal | 0 |
Formato | @! |
Título | Status |
Descrição | Status Fatura. |
Usado | Sim |
Obrigatório | Sim |
Browse | Sim |
Opções | 1=Ativa; 2=Cancelada |
Inic. Padrão | '1' |
Val. Sistema | Pertence (" 12") |
Contexto | Real |
Propriedade | Alterar |
Help de Campo | Status da fatura, indicando se a mesma está ativa ou cancelada. |
Ordem | 08 |
Arquivo: FO9 – Fatura Hotel x Notas
Chave | Nome | Modo | Modo Empresa | Modo Unidade | Pyme |
FO9 | Fatura Hotel x Notas | Exclusivo | Exclusivo | Exclusivo | Sim |
Índice | FO9 |
Ordem | 1 |
Chave | FO9_FILIAL + FO9_NUMFAT + FO9_CLIFAT + FO9_LOJFAT + FO9_SERIE + FO9_NUMDOC |
Descrição | Num. Fatura + Cod. Cliente + Loja + Série + Num. Doc. |
Mostra Pesq. | Sim |
Campo | FO9_FILIAL |
Tipo | Caracter |
Tamanho | 8 |
Decimal | 0 |
Título | Filial |
Descrição | Filial do Sistema |
Usado | Não |
Obrigatório | Não |
Browse | Não |
Grupo de Campos | 033 - Tamanho da Filial |
Help de Campo | Filial do Sistema |
Ordem | 01 |
Campo | FO9_NUMFAT |
Tipo | Caracter |
Tamanho | 9 |
Decimal | 0 |
Formato | @! |
Título | Num. Fatura |
Descrição | Número da Fatura |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Contexto | Real |
Propriedade | Alterar |
Grupo de Campos | 018 - Documento de entrada/saída |
Help de Campo | Número da fatura de hotelaria. |
Ordem | 02 |
Campo | FO9_CLIFAT |
Tipo | Caracter |
Tamanho | 6 |
Decimal | 0 |
Formato | @! |
Título | Cod. Cliente |
Descrição | Código do Cliente. |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Contexto | Real |
Propriedade | Alterar |
Grupo de Campos | 001 - Codigo Cliente/Fornecedor |
Help de Campo | Código do Cliente da Fatura. |
Ordem | 03 |
Campo | FO9_LOJFAT |
Tipo | Caracter |
Tamanho | 2 |
Decimal | 0 |
Formato | @! |
Título | Loja |
Descrição | Loja do Cliente. |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Contexto | Real |
Propriedade | Alterar |
Grupo de Campos | 002 - Loja Cliente/Fornecedor |
Help de Campo | Loja do Cliente da Fatura. |
Ordem | 04 |
Campo | FO9_ITEM |
Tipo | Caracter |
Tamanho | 4 |
Decimal | 0 |
Formato | @! |
Título | Item |
Descrição | Item da Fatura |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Contexto | Real |
Propriedade | Visualizar |
Help de Campo | Item da fatura de Hotel |
Ordem | 05 |
Campo | FO9_SERIE |
Tipo | Caracter |
Tamanho | 3 |
Decimal | 0 |
Formato | @! |
Título | Série |
Descrição | Série da nota |
Usado | Sim |
Obrigatório | Sim |
Browse | Não |
Contexto | Real |
Propriedade | Alterar |
Grupo de Campos | 094 - |
Help de Campo | Série da nota (RPS/Cupom) que está associada à fatura de hotel. |
Ordem | 06 |
Campo | FO9_NUMDOC |
Tipo | Caracter |
Tamanho | 9 |
Decimal | 0 |
Formato | @! |
Título | Num. Doc. |
Descrição | Número da nota |
Usado | Sim |
Obrigatório | Sim |
Browse | Não |
Contexto | Real |
Propriedade | Alterar |
Grupo de Campos | 018 - Documento de entrada/saída |
Help de Campo | Número da nota que está associada à fatura de hotel. |
Ordem | 07 |
Campo | FO9_DATA |
Tipo | Data |
Tamanho | 8 |
Decimal | 0 |
Título | Data Emissão |
Descrição | Data de Emissão. |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Inic. Padrão | Iif(!INCLUI, Posicione("SL1", 2, FWxFilial("SL1") + FO9->FO9_SERIE + FO9->FO9_NUMDOC, "L1_EMISNF"), CTOD('') ) |
Contexto | Virtual |
Propriedade | Visualizar |
Help de Campo | Data de emissão da nota associada à fatura de hotel. |
Ordem | 08 |
Campo | FO9_VALOR |
Tipo | Numérico |
Tamanho | 16 |
Decimal | 2 |
Formato | @E 9,999,999,999,999.99 |
Título | Valor |
Descrição | Valor da nota. |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Inic. Padrão | Iif(!INCLUI, Posicione("SL1", 2, FWxFilial("SL1") + FO9->FO9_SERIE + FO9->FO9_NUMDOC, "L1_VLRTOT"), 0 ) |
Contexto | Virtual |
Propriedade | Visualizar |
Help de Campo | Valor da nota associada à fatura. |
Ordem | 09 |
Arquivo: FOA – Fatura Hotel x Títulos
Chave | Nome | Modo | Modo Empresa | Modo Unidade | Pyme |
FOA | Fatura Hotel x Titulo | Exclusivo | Exclusivo | Exclusivo | Sim |
Índice | FOA |
Ordem | 1 |
Chave | FOA_FILIAL + FOA_NUMFAT + FOA_CLIFAT + FOA_LOJFAT + FOA_PREFIX + FOA_NUM + FOA_PARCEL + FOA_TIPO |
Descrição | Num. Fatura + Cod. Cliente + Loja + Prefixo + FOA_NUM+Parcela + Tipo |
Mostra Pesq. | Sim |
Campo | FOA_FILIAL |
Tipo | Caracter |
Tamanho | 8 |
Decimal | 0 |
Título | Filial |
Descrição | Filial do Sistema |
Usado | Não |
Obrigatório | Não |
Browse | Não |
Grupo de Campos | 033 - Tamanho da Filial |
Help de Campo | Filial do Sistema |
Ordem | 01 |
Campo | FOA_NUMFAT |
Tipo | Caracter |
Tamanho | 9 |
Decimal | 0 |
Formato | @! |
Título | Num. Fatura |
Descrição | Número da Fatura |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Contexto | Real |
Propriedade | Alterar |
Grupo de Campos | 018 - Documento de entrada/saída |
Help de Campo | Número da fatura de hotelaria. |
Ordem | 02 |
Campo | FOA_CLIFAT |
Tipo | Caracter |
Tamanho | 6 |
Decimal | 0 |
Formato | @! |
Título | Cod. Cliente |
Descrição | Código do Cliente. |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Contexto | Real |
Propriedade | Alterar |
Grupo de Campos | 001 - Codigo Cliente/Fornecedor |
Help de Campo | Código do Cliente da Fatura. |
Ordem | 03 |
Campo | FOA_LOJFAT |
Tipo | Caracter |
Tamanho | 2 |
Decimal | 0 |
Formato | @! |
Título | Loja |
Descrição | Loja do Cliente. |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Contexto | Real |
Propriedade | Alterar |
Grupo de Campos | 002 - Loja Cliente/Fornecedor |
Help de Campo | Loja do Cliente da Fatura. |
Ordem | 04 |
Campo | FOA_ITEM |
Tipo | Caracter |
Tamanho | 4 |
Decimal | 0 |
Título | Item |
Descrição | Item |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Contexto | Real |
Propriedade | Visualizar |
Help de Campo | Item do Título |
Ordem | 05 |
Campo | FOA_PREFIX |
Tipo | Caracter |
Tamanho | 3 |
Decimal | 0 |
Formato | @! |
Título | Prefixo |
Descrição | Prefixo do Titulo |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Contexto | Real |
Propriedade | Alterar |
Help de Campo | Prefixo do Titulo |
Ordem | 06 |
Campo | FOA_NUM |
Tipo | Caracter |
Tamanho | 9 |
Decimal | 0 |
Formato | @! |
Título | Numero |
Descrição | Numero do Titulo |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Contexto | Real |
Propriedade | Alterar |
Grupo de Campos | 018 - Documento de entrada/saída |
Help de Campo | Numero do Título |
Ordem | 07 |
Campo | FOA_PARCEL |
Tipo | Caracter |
Tamanho | 1 |
Decimal | 0 |
Formato | @! |
Título | Parcela |
Descrição | Parcela do Título |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Contexto | Real |
Propriedade | Alterar |
Grupo de Campos | 011 - Parcela |
Help de Campo | Parcela do título |
Ordem | 08 |
Campo | FOA_TIPO |
Tipo | Caracter |
Tamanho | 3 |
Decimal | 0 |
Formato | @! |
Título | Tipo |
Descrição | Tipo do titulo |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Contexto | Real |
Propriedade | Alterar |
Help de Campo | Tipo do titulo |
Ordem | 09 |
Campo | FOA_VALOR |
Tipo | Numérico |
Tamanho | 16 |
Decimal | 2 |
Formato | @E 9,999,999,999,999.99 |
Título | Vlr titulo |
Descrição | Valor do título |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Inic. Padrão | FIN791INI("E1_VALOR") |
Contexto | Virtual |
Propriedade | Visualizar |
Help de Campo | Valor do Titulo |
Ordem | 10 |
Campo | FOA_SALDO |
Tipo | Numérico |
Tamanho | 16 |
Decimal | 2 |
Formato | @E 9,999,999,999,999.99 |
Título | Saldo |
Descrição | Saldo do Titulo |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Inic. Padrão | FIN791INI("E1_SALDO") |
Contexto | Virtual |
Propriedade | Visualizar |
Help de Campo | Saldo do Titulo |
Ordem | 11 |
Campo | FOA_EMISS |
Tipo | Data |
Tamanho | 8 |
Decimal | 0 |
Título | Emissao |
Descrição | Emissao |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Inic. Padrão | FIN791INI("E1_EMISSAO") |
Contexto | Virtual |
Propriedade | Visualizar |
Help de Campo | Emissão do Titulo |
Ordem | 12 |
Campo | FOA_VENCTO |
Tipo | Data |
Tamanho | 8 |
Decimal | 0 |
Título | Vencimento |
Descrição | Vencimento |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Inic. Padrão | FIN791INI("E1_VENCTO") |
Contexto | Virtual |
Propriedade | Visualizar |
Help de Campo | Vencimento de Titulo |
Ordem | 13 |
Campo | FOA_VENCRE |
Tipo | Data |
Tamanho | 8 |
Decimal | 0 |
Título | Venc Real |
Descrição | Vencimento Real |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Inic. Padrão | FIN791INI("E1_VENCREA") |
Contexto | Virtual |
Propriedade | Visualizar |
Inic. Browse | FIN791INI("E1_VENCREA") |
Help de Campo | Vencimento Real |
Ordem | 14 |
Campo | FOA_TITFIL |
Tipo | Caracter |
Tamanho | 8 |
Decimal | 0 |
Título | Filial Ori |
Descrição | Filial de Origem |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Contexto | Real |
Propriedade | Alterar |
Grupo de Campos | 033 - Tamanho da Filial |
Ordem | 15 |
Tabela
Chave | Nome | Modo | Pyme |
FOB | Fatura Hotel x Comissao | Exclusivo | Sim |
Campos
Campo | FOB_FILIAL |
Tipo | Caracter |
Tamanho | 8 |
Decimal | 0 |
Título | Filial |
Descrição | Filial do Sistema |
Usado | Não |
Obrigatório | Não |
Browse | Não |
Grupo de Campos | 033 - Tamanho da Filial |
Ordem | 01 |
Campo | FOB_NUMFAT |
Tipo | Caracter |
Tamanho | 9 |
Decimal | 0 |
Formato | @! |
Título | Num. Fatura |
Descrição | Número da Fatura |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Contexto | Real |
Propriedade | Alterar |
Ordem | 02 |
Campo | FOB_CLIFAT |
Tipo | Caracter |
Tamanho | 6 |
Decimal | 0 |
Formato | @! |
Título | Cod. Cliente |
Descrição | Código do Cliente. |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Contexto | Real |
Propriedade | Alterar |
Grupo de Campos | 001 - Codigo Cliente/Fornecedor |
Ordem | 03 |
Campo | FOB_LOJFAT |
Tipo | Caracter |
Tamanho | 2 |
Decimal | 0 |
Formato | @! |
Título | Loja |
Descrição | Loja do Cliente. |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Contexto | Real |
Propriedade | Alterar |
Grupo de Campos | 002 - Loja Cliente/Fornecedor |
Ordem | 04 |
Campo | FOB_ITEM |
Tipo | Caracter |
Tamanho | 4 |
Decimal | 0 |
Título | Item |
Descrição | Item |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Contexto | Real |
Propriedade | Visualizar |
Ordem | 05 |
Campo | FOB_PREFIX |
Tipo | Caracter |
Tamanho | 3 |
Decimal | 0 |
Formato | @! |
Título | Prefixo |
Descrição | Prefixo do Titulo |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Contexto | Real |
Propriedade | Alterar |
Ordem | 06 |
Campo | FOB_NUM |
Tipo | Caracter |
Tamanho | 9 |
Decimal | 0 |
Formato | @! |
Título | Numero |
Descrição | Numero do Titulo |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Contexto | Real |
Propriedade | Alterar |
Grupo de Campos | 018 - Documento de entrada/saída |
Ordem | 07 |
Campo | FOB_PARCEL |
Tipo | Caracter |
Tamanho | 1 |
Decimal | 0 |
Formato | @! |
Título | Parcela |
Descrição | Parcela do Título |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Contexto | Real |
Propriedade | Alterar |
Grupo de Campos | 011 - Parcela |
Ordem | 08 |
Campo | FOB_TIPO |
Tipo | Caracter |
Tamanho | 3 |
Decimal | 0 |
Formato | @! |
Título | Tipo |
Descrição | Tipo do titulo |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Contexto | Real |
Propriedade | Alterar |
Ordem | 09 |
Campo | FOB_VALOR |
Tipo | Numérico |
Tamanho | 16 |
Decimal | 2 |
Formato | @E 9,999,999,999,999.99 |
Título | Vlr titulo |
Descrição | Valor do título |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Inic. Padrão | FIN791INI("E2_VALOR" , .T.) |
Contexto | Virtual |
Propriedade | Visualizar |
Ordem | 10 |
Campo | FOB_SALDO |
Tipo | Numérico |
Tamanho | 16 |
Decimal | 2 |
Formato | @E 9,999,999,999,999.99 |
Título | Saldo |
Descrição | Saldo do Titulo |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Inic. Padrão | FIN791INI("E2_SALDO", .T.) |
Contexto | Virtual |
Propriedade | Visualizar |
Ordem | 11 |
Campo | FOB_EMISS |
Tipo | Data |
Tamanho | 8 |
Decimal | 0 |
Título | Emissao |
Descrição | Emissao |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Inic. Padrão | FIN791INI("E2_EMISSAO", .T.) |
Contexto | Virtual |
Propriedade | Visualizar |
Ordem | 12 |
Campo | FOB_VENCTO |
Tipo | Data |
Tamanho | 8 |
Decimal | 0 |
Título | Vencimento |
Descrição | Vencimento |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Inic. Padrão | FIN791INI("E2_VENCTO", .T.) |
Contexto | Virtual |
Propriedade | Visualizar |
Ordem | 13 |
Campo | FOB_VENCRE |
Tipo | Data |
Tamanho | 8 |
Decimal | 0 |
Título | Venc Real |
Descrição | Vencimento Real |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Inic. Padrão | FIN791INI("E2_VENCREA", .T.) |
Contexto | Virtual |
Propriedade | Visualizar |
Ordem | 14 |
Campo | FOB_TITFIL |
Tipo | Caracter |
Tamanho | 8 |
Decimal | 0 |
Título | Filial Ori |
Descrição | Filial de Origem |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Contexto | Real |
Propriedade | Alterar |
Grupo de Campos | 033 - Tamanho da Filial |
Ordem | 15 |
Campo | FOB_FORCOM |
Tipo | Caracter |
Tamanho | 6 |
Decimal | 0 |
Formato | @! |
Título | Forne Comiss |
Descrição | Fornecedor Comissão |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Contexto | Real |
Propriedade | Alterar |
Grupo de Campos | 001 - Codigo Cliente/Fornecedor |
Ordem | 16 |
Campo | FOB_LOJCOM |
Tipo | Caracter |
Tamanho | 2 |
Decimal | 0 |
Formato | @! |
Título | Loja Comiss |
Descrição | Loja Comissão |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Contexto | Real |
Propriedade | Alterar |
Grupo de Campos | 002 - Loja Cliente/Fornecedor |
Ordem | 17 |
Índices
Índice | FOB |
Ordem | 1 |
Chave | FOB_FILIAL + FOB_NUMFAT + FOB_CLIFAT + FOB_LOJFAT + FOB_PREFIX + FOB_NUM + FOB_PARCEL + FOB_TIPO |
Descrição | Num. Fatura + Cod. Cliente + Loja + Prefixo + FOB_NUM+Parcela + Tipo |
Mostra Pesq. | Sim |
Arquivo: FOC – Fatura Hotel x NFe
Chave | Nome | Modo | Modo Empresa | Modo Unidade | Pyme |
FOC | Fatura Hotel x NFe | Exclusivo | Exclusivo | Exclusivo | Sim |
Índice | FOC |
Ordem | 1 |
Chave | FOC_FILIAL + FOC_NUMFAT + FOC_CLIFAT + FOC_LOJFAT + FOC_SERIE + FOC_NUMDOC |
Descrição | Num. Fatura + Cod. Cliente + Loja + Série + Num. Doc. |
Mostra Pesq. | Sim |
Campo | FOC_FILIAL |
Tipo | Caracter |
Tamanho | 8 |
Decimal | 0 |
Título | Filial |
Descrição | Filial do Sistema |
Usado | Não |
Obrigatório | Não |
Browse | Não |
Grupo de Campos | 033 - Tamanho da Filial |
Help de Campo | Filial do Sistema |
Ordem | 01 |
Campo | FOC_NUMFAT |
Tipo | Caracter |
Tamanho | 9 |
Decimal | 0 |
Formato | @! |
Título | Num. Fatura |
Descrição | Número da Fatura |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Contexto | Real |
Propriedade | Alterar |
Grupo de Campos | 018 - Documento de entrada/saída |
Help de Campo | Número da fatura de hotelaria. |
Ordem | 02 |
Campo | FOC_CLIFAT |
Tipo | Caracter |
Tamanho | 6 |
Decimal | 0 |
Formato | @! |
Título | Cod. Cliente |
Descrição | Código do Cliente. |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Contexto | Real |
Propriedade | Alterar |
Grupo de Campos | 001 - Codigo Cliente/Fornecedor |
Help de Campo | Código do Cliente da Fatura. |
Ordem | 03 |
Campo | FOC_LOJFAT |
Tipo | Caracter |
Tamanho | 2 |
Decimal | 0 |
Formato | @! |
Título | Loja |
Descrição | Loja do Cliente. |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Contexto | Real |
Propriedade | Alterar |
Grupo de Campos | 002 - Loja Cliente/Fornecedor |
Help de Campo | Loja do Cliente da Fatura. |
Ordem | 04 |
Campo | FOC_ITEM |
Tipo | Caracter |
Tamanho | 4 |
Decimal | 0 |
Formato | @! |
Título | Item |
Descrição | Item da Fatura |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Contexto | Real |
Propriedade | Visualizar |
Help de Campo | Item da fatura de Hotel |
Ordem | 05 |
Campo | FOC_SERIE |
Tipo | Caracter |
Tamanho | 3 |
Decimal | 0 |
Formato | @! |
Título | Série |
Descrição | Série da nota |
Usado | Sim |
Obrigatório | Sim |
Browse | Não |
Contexto | Real |
Propriedade | Alterar |
Grupo de Campos | 094 |
Help de Campo | Série da nota (RPS/Cupom) que está associada à fatura de hotel. |
Ordem | 06 |
Campo | FOC_NUMDOC |
Tipo | Caracter |
Tamanho | 9 |
Decimal | 0 |
Formato | @! |
Título | Num. Doc. |
Descrição | Número da nota |
Usado | Sim |
Obrigatório | Sim |
Browse | Não |
Contexto | Real |
Propriedade | Alterar |
Grupo de Campos | 018 - Documento de entrada/saída |
Help de Campo | Número da nota que está associada à fatura de hotel. |
Ordem | 07 |
Campo | FOC_DATA |
Tipo | Data |
Tamanho | 8 |
Decimal | 0 |
Título | Data Emissão |
Descrição | Data de Emissão. |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Inic. Padrão | Iif(!INCLUI, Posicione("SF2", 1, FWxFilial("SF2") + FOC->FOC_NUMDOC + FOC->FOC_SERIE, "F2_EMISSAO"), CTOD('') ) |
Contexto | Virtual |
Propriedade | Visualizar |
Help de Campo | Data de emissão da nota associada à fatura de hotel. |
Ordem | 08 |
Campo | FOC_VALOR |
Tipo | Numérico |
Tamanho | 16 |
Decimal | 2 |
Formato | @E 9,999,999,999,999.99 |
Título | Valor |
Descrição | Valor da nota. |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Inic. Padrão | Iif(!INCLUI, Posicione("SF2", 1, FWxFilial("SF2") + FOC->FOC_NUMDOC + FOC->FOC_SERIE, "F2_VALBRUT"), 0 ) |
Contexto | Virtual |
Propriedade | Visualizar |
Help de Campo | Valor da nota associada à fatura. |
Ordem | 09 |
· AI0_STATUS – Alterar o valor da propriedade “Visual” para “Visualizar”, ao invés de “Alterar”;
Parâmetros
Descrição | MV_HTLNACD |
Tipo | Caractere |
Conteúdo |
|
Descição | Indica a natureza que será utilizada para títulos a receber do tipo CD na integração com hotelaria. |
Descrição | MV_HTLNANC |
Tipo | Caractere |
Conteúdo |
|
Descição | Indica a natureza que será utilizada para títulos a receber do tipo NCC na integração com hotelaria. |
Descrição | MV_INTHTL |
Tipo | Lógico |
Conteúdo | .F. |
Descição | Indica a integração com produto de administração hoteleira. |
Descrição | MV_HTLNARA |
Tipo | Caractere |
Conteúdo |
|
Descição | Indica a natureza que será utilizada para títulos a receber do tipo RA na integração com hotelaria. |
Descrição | MV_HTLNAPR |
Tipo | Caractere |
Conteúdo |
|
Descição | Indica a natureza que será utilizada para títulos a receber do tipo PR na integração com hotelaria. |
Descrição | MV_HTLNACC |
Tipo | Caractere |
Conteúdo |
|
Descição | Indica a natureza que será utilizada para títulos a receber do tipo CC na integração com hotelaria. |
Descrição | MV_HTLPREF |
Tipo | Caractere |
Conteúdo |
|
Descição | Indica o prefixo que será utilizado para os títulos a receber na integração com hotelaria. |
Descrição | MV_HTLNAFT |
Tipo | Caractere |
Conteúdo |
|
Descrição | Indica a natureza que será utilizada para títulos a receber gerados no processo de faturas de hotel. |
Descrição | MV_HTLFT |
Tipo | Caractere |
Conteúdo | FT |
Descrição | Indica o tipo de título que será utilizado para títulos a receber gerados no processo de faturas de hotel. |
Descrição | MV_HTLNCPF |
Tipo | Caractere |
Conteúdo |
|
Descrição | Indica a natureza que será utilizada para títulos a pagar, referentes a comissões descontadas em faturas de hotelaria para fornecedor Pessoa Física. |
Descrição | MV_HTLNCPJ |
Tipo | Caractere |
Conteúdo |
|
Descrição | Indica a natureza que será utilizada para títulos a pagar, referentes a comissões descontadas em faturas de hotelaria para fornecedor Pessoa Jurídica. |
Descrição | MV_HTLPREC |
Tipo | Caractere |
Conteúdo | "CDF" |
Descrição | Indica o prefixo que será utilizado para títulos a pagar, referentes a comissões descontadas em faturas de hotelaria. |
Descrição | MV_HTLTCDF |
Tipo | Caractere |
Conteúdo | "DP" |
Descrição | Indica o tipo de título que será utilizado para títulos a pagar, referentes a comissões descontadas em faturas de hotelaria. |
Descrição | MV_HTLBCOM |
Tipo | Caractere |
Conteúdo |
|
Descrição | Banco das Comissões já descontadas da fatura de Hotel. Preencha Banco Agencia e Conta separados por / . Exemplo Banco/Agencia/Conta |
Descrição | MV_HTLNAMB |
Tipo | Caractere |
Conteúdo |
|
Descrição | Indica a natureza que será utilizada para movimentações bancárias no processo de devolução, em dinheiro, de adiantamentos realizados com cartão. |
Descrição | MV_HTLNADH |
Tipo | Caractere |
Conteúdo |
|
Descrição | Natureza que será utilizada para títulos a receber (dinheiro) quando um cupom fiscal (crédito quarto) for pago separado do RPS. Integração c/ hotelaria. |
Descrição | MV_HTLNAPF |
Tipo | Caractere |
Conteúdo |
|
Descrição | Indica a natureza que será utilizada para títulos a pagar, referentes a comissões para fornecedor Pessoa Física. |
Descrição | MV_HTLNAPJ |
Tipo | Caractere |
Conteúdo |
|
Descrição | Indica a natureza que será utilizada para títulos a pagar, referentes a comissões para fornecedor Pessoa Jurídica. |
Descrição | MV_HTLPNFE |
Tipo | Caractere |
Conteúdo |
|
Descrição | Prefixo utilizado nos títulos a receber referentes a NFe, na integração com hotelaria. |
Descrição | MV_HTLCTC |
Tipo | Caractere |
Conteúdo |
|
Descrição | Conta contábil (crédito) que será utilizada para a integração de lançamento contábil, na integração com hotelaria. |
Descrição | MV_HTLCTD |
Tipo | Caractere |
Conteúdo |
|
Descrição | Conta contábil (débito) que será utilizada para a integração de lançamento contábil, na integração com hotelaria. |
Descrição | MV_HTLCCC |
Tipo | Caractere |
Conteúdo |
|
Descrição | Centro de custo (crédito) que será utilizado para integração de lançamento contábil na integração com hotelaria |
Descrição | MV_HTLCCD |
Tipo | Caractere |
Conteúdo |
|
Descrição | Centro de custo (débito) que será utilizado para integração de lançamento contábil na integração com hotelaria |
Estrutura de Menu
Módulo | SigaFIN |
Aba | Cadastro |
Tipo | Tópico |
Descrição | Hotelaria |
Países | * |
Módulo | SigaFIN |
Aba | Cadastro |
Tipo | Item (do tópico hotelaria) |
Descrição | Fatura de hotel |
Programa | FINA791 |
Países | * |
Arquivos | FO8FO9FOASE1 |
Palavras-Chave | Hoteis,Hotelaria,Faturas,RPS,Cupons,Cupom,Receber,Financeiro |
Casos de Uso
UC 001 - Inclusão de Comissão vinculada à um título- Integração
Objetivo: Incluir registro de comissão (tabela SE3) vinculado à um contas a receber.
Pré-condição:
- Cadastro do adapter MATI490, para habilitar o recebimento da mensagem única SalesCharge (SigaCFG > Ambiente > Schedule > Adapter E.a.i.).
- Cadastro do de/para de empresa e filial utilizada na integração entre os sistemas Protheus e CMNet (SigaCFG > Ambiente > Schedule > Emp Filial mensagem única).
- Cadastro de Cliente integrado ao CMNet (UC 011);
- Cadastro de Título a Receber integrado ao CMNet (UC XXX);
- Cadastro de Vendedor integrado ao CMNet (UC XXX);
Inicializador:
- CMNet.
Fluxo Básico de Eventos:
1.0 Acessar o sistema CMNet e realizar o processo de geração de comissão vinculada à um movimento de contas a receber;
1.1 O sistema deverá se comunicar com o Protheus, enviando a mensagem única de comissões;
2.0 Verificar no Monitor EAI, do Protheus, se a mensagem foi recebida e processada com sucesso (SigaCFG > Ambiente > Schedule > Schedule > Monitor E.a.i.)..
2.1 Verificar na tela de Manutenção de Comissão se o registro foi gravado com sucesso (SigaFIN > Atualizações > Comissões > Manutenção das comissões)..
2.2 Verificar se o de/para foi gravado com sucesso, relacionando os códigos de ambos os sistemas na rotina De/Para de mensagem única (SigaCFG > Ambiente > Schedule > De/Para de mensagem única).
Fim do caso de uso
UC 002 - Inclusão de Comissão vinculada à Fatura de hotel - Integração
Objetivo: Incluir registro de comissão (tabela SE3) vinculado à uma Fatura de hotel.
Pré-condição:
- Cadastro do adapter MATI490, para habilitar o recebimento da mensagem única SalesCharge (SigaCFG > Ambiente > Schedule > Adapter E.a.i.).
- Cadastro do de/para de empresa e filial utilizada na integração entre os sistemas Protheus e CMNet (SigaCFG > Ambiente > Schedule > Emp Filial mensagem única).
- Cadastro de Cliente integrado ao CMNet (UC 011);
- Cadastro de Fatura de Hotel integrado ao CMNet (UC 008);
- Cadastro de Vendedor integrado ao CMNet (UC XXX);
Inicializador:
- CMNet.
Fluxo Básico de Eventos:
1.0 Acessar o sistema CMNet e realizar o processo de geração de comissão vinculada à uma fatura;
1.1 O sistema deverá se comunicar com o Protheus, enviando a mensagem única de comissões;
2.0 Verificar no Monitor EAI, do Protheus, se a mensagem foi recebida e processada com sucesso (SigaCFG > Ambiente > Schedule > Schedule > Monitor E.a.i.);
2.1 Verificar na tela de Manutenção de Comissão se o registro foi gravado com sucesso e se está vinculado a um título a receber (SigaFIN > Atualizações > Comissões > Manutenção das Comissões);
2.2 Verificar se o de/para foi gravado com sucesso, relacionando os códigos de ambos os sistemas na rotina De/Para de mensagem única (SigaCFG > Ambiente > Schedule > De/Para de mensagem única).
Fim do caso de uso
UC 003 - Alteração de Comissão - Integração
Objetivo: Alterar dados do registro de comissão já integrado.
Pré-condição:
- Execução do caso de uso UC 001 ou UC 002.
Inicializador:
- CMNet.
Fluxo Básico de Eventos:
1.0 Acessar o sistema CMNet e realizar o processo de alteração de comissão;
1.1 O sistema deverá se comunicar com o Protheus, enviando a mensagem única de comissões;
2.0 Verificar no Monitor EAI, do Protheus, se a mensagem foi recebida e processada com sucesso (SigaCFG > Ambiente > Schedule > Schedule > Monitor E.a.i.);
2.1 Verificar na tela de Manutenção de Comissão se as alterações do registro foram gravadas com sucesso (SigaFIN > Atualizações > Comissões > Manutenção das Comissões).
Fim do caso de uso
UC 004 - Alteração de Comissão Manualmente no backoffice
Objetivo: Validar bloqueio de alteração de dados do registro de comissão, já integrado, de forma manual no Protheus através da rotina de manutenção de comissões.
Pré-condição:
- Execução do caso de uso UC 001 ou UC 002.
Inicializador:
- Protheus Financeiro.
Fluxo Básico de Eventos:
1.0 Acessar a rotina de Manutenção de Comissões (SigaFIN > Atualizações > Comissões > Manutenção das Comissões);
1.1 Selecionar um registro de comissão que tenha sido gerado no CMNet e integrado ao Protheus;
1.2 Clicar em Alterar;
1.3 Deverá ser exibido um alerta informando que não será possível alterar esse registro, pois sua origem é externa ao sistema (integração).
Fim do caso de uso
UC 005 - Exclusão de Comissão - Integração
Objetivo: Excluir registro de comissão já integrado.
Pré-condição:
- Execução do caso de uso UC 001 ou UC 002.
Inicializador:
- CMNet.
Fluxo Básico de Eventos:
1.0 Acessar o sistema CMNet e realizar o processo de exclusão de comissão;
1.1 O sistema deverá se comunicar com o Protheus, enviando a mensagem única de comissões, com operação DELETE;
2.0 Verificar no Monitor EAI, do Protheus, se a mensagem foi recebida e processada com sucesso (SigaCFG > Ambiente > Schedule > Schedule > Monitor E.a.i.);
2.1 Verificar na tela de Manutenção de Comissão se o registro foi excluído com sucesso (SigaFIN > Atualizações > Comissões > Manutenção das Comissões).
Fim do caso de uso
UC 006 - Exclusão de Comissão Manualmente no backoffice
Objetivo: Validar bloqueio de exclusão de dados do registro de comissão, já integrado, de forma manual no Protheus através da rotina de manutenção de comissões.
Pré-condição:
- Execução do caso de uso UC 001 ou UC 002.
Inicializador:
- Protheus Financeiro.
Fluxo Básico de Eventos:
1.0 Acessar a rotina de Manutenção de Comissões (SigaFIN > Atualizações > Comissões > Manutenção das Comissões);
1.1 Selecionar um registro de comissão que tenha sido gerado no CMNet e integrado ao Protheus;
1.2 Clicar em Excluir;
1.3 Deverá ser exibido um alerta informando que não será possível excluir esse registro, pois sua origem é externa ao sistema (integração).
Fim do caso de uso
UC 007 - Recálculo de Comissão no backoffice
Objetivo: Validar bloqueio de recálculo dos registros de comissão, já integrados, através da rotina de recálculo de comissões do Protheus.
Pré-condição:
- Execução do caso de uso UC 001 ou UC 002.
Inicializador:
- Protheus Financeiro.
Fluxo Básico de Eventos:
1.0 Acessar a rotina de Recálculo de Comissões (SigaFIN > Miscelanea > Recalculos > Recálculo de Comissão);
1.1 Configurar os parâmetros da rotina com dados coerentes aos registros de comissão que foram integrados;
1.2 Executar o processo de recálculo;
1.3 Validar se não houve nenhuma alteração nos dados das comissões integradas, através da rotina de manutenção de comissões (SigaFIN > Atualizações > Comissões > Manutenção das Comissões).
Fim do caso de uso
UC 008 - Inclusão de Fatura de Hotel - Integração
Objetivo: Incluir registro de fatura de hotel (tabelas FO8, FO9 e SE1).
Pré-condição:
- Cadastro do adapter FINI791, para habilitar o recebimento da mensagem única HotelInvoice (SigaCFG > Ambiente > Schedule > Adapter E.a.i.);
- Cadastro de Cliente integrado ao CMNet (UC 011);
- Cadastro de RPS ou Cupom Fiscal integrado ao CMNet (UC XXX);
- Definição do prefixo dos títulos a receber, através do parâmetro MV_HTLPREF.
- Definição do tipo de título que será utilizado no processo de fatura de hotel, através do parâmetro MV_HTLFT.
- Definição da natureza financeira que será utilizada nos títulos a receber gerados no processo de fatura de hotel, através do parâmetro MV_HTLNAFT.
Inicializador:
- CMNet.
Fluxo Básico de Eventos:
1.0 Acessar o sistema CMNet e realizar o processo de geração de fatura;
1.1 O sistema deverá se comunicar com o Protheus, enviando a mensagem única de fatura de hotel (HotelInvoice);
2.0 Verificar no Monitor EAI, do Protheus, se a mensagem foi recebida e processada com sucesso (SigaCFG > Ambiente > Schedule > Schedule > Monitor E.a.i.);
2.1 Verificar na tela de Fatura de Hotel se o registro foi gravado com sucesso (SigaFIN > Atualizações > Hotelaria > Fatura de Hotel);
2.2 Verificar se o de/para foi gravado com sucesso, relacionando os códigos de ambos os sistemas na rotina De/Para de mensagem única (SigaCFG > Ambiente > Schedule > De/Para de mensagem única);
Fim do caso de uso
UC 009 - Cancelamento de Fatura de Hotel sem baixa de títulos - Integração
Objetivo: Cancelar registro de fatura de hotel (tabelas FO8, FO9 e SE1).
Pré-condição:
- Cadastro do adapter FINI791, para habilitar o recebimento da mensagem única HotelInvoice (SigaCFG > Ambiente > Schedule > Adapter E.a.i.);
- Inclusão de fatura de hotel (UC 008);
- Não ter nenhuma baixa em nenhum dos títulos a receber associados à fatura a ser cancelada.
Inicializador:
- CMNet.
Fluxo Básico de Eventos:
1.0 Acessar o sistema CMNet e realizar o processo de solicitação de cancelamento de fatura;
1.1 O sistema deverá se comunicar com o Protheus, enviando a mensagem única de cancelamento de fatura de hotel (HotelInvoiceCancellation);
2.0 Verificar no Monitor EAI, do Protheus, se a mensagem foi recebida e processada com sucesso (SigaCFG > Ambiente > Schedule > Schedule > Monitor E.a.i.);
2.1 Verificar na tela de Fatura de Hotel se o registro foi cancelado com sucesso (SigaFIN > Atualizações > Hotelaria > Fatura de Hotel);
3.0 Verificar no sistema CMNet se o registro foi cancelado com sucesso;
Fim do caso de uso
UC 010 - Cancelamento de Fatura de Hotel com baixa de títulos - Integração
Objetivo: Validar mensagem de erro, ao tentar cancelar registro de fatura de hotel que já tenha baixas de títulos (tabelas FO8, FO9 e SE1).
Pré-condição:
- Cadastro do adapter FINI791, para habilitar o recebimento da mensagem única HotelInvoice (SigaCFG > Ambiente > Schedule > Adapter E.a.i.);
- Inclusão de fatura de hotel (UC 008);
- Realizar baixa em algum dos títulos a receber associados à fatura a ser cancelada.
Inicializador:
- CMNet.
Fluxo Básico de Eventos:
1.0 Acessar o sistema CMNet e realizar o processo de solicitação de cancelamento de fatura;
1.1 O sistema deverá se comunicar com o Protheus, enviando a mensagem única de cancelamento de fatura de hotel (HotelInvoiceCancellation);
2.0 Verificar no Monitor EAI, do Protheus, se a mensagem foi recebida e processada com sucesso (SigaCFG > Ambiente > Schedule > Schedule > Monitor E.a.i.);
2.1 Verificar na tela de Fatura de Hotel se o registro não foi cancelado (SigaFIN > Atualizações > Hotelaria > Fatura de Hotel);
3.0 Verificar no sistema CMNet se a mensagem de erro de cancelamento foi recebida com sucesso e se o registro de fatura continua ativo, sem ser cancelado;
Fim do caso de uso
UC 011 - Cadastro de Cliente - Integração
Objetivo: Validar gravação de campo de conta contábil do cliente (Tabela SA1).
Pré-condição:
- Cadastro do adapter MATI030, para habilitar o recebimento da mensagem única CustomerVendor (SigaCFG > Ambiente > Schedule > Adapter E.a.i.);
- Habilitação da integração com hotelaria através do parâmetro MV_INTHTL;
Inicializador:
- CMNet.
Fluxo Básico de Eventos:
1.0 Acessar o sistema CMNet e realizar o processo de cadastro de cliente;
1.1 O sistema deverá se comunicar com o Protheus, enviando a mensagem única de clientes (CustomerVendor);
2.0 Verificar no Monitor EAI, do Protheus, se a mensagem foi recebida e processada com sucesso (SigaCFG > Ambiente > Schedule > Schedule > Monitor E.a.i.);
2.1 Verificar se o de/para foi gravado com sucesso, relacionando os códigos de ambos os sistemas na rotina De/Para de mensagem única (SigaCFG > Ambiente > Schedule > De/Para de mensagem única);
Fim do caso de uso
Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico. |
---|