UC00099 - Integração Java/ECF
De Wiki Java - Interno
(Diferença entre revisões)
(→Fluxos de exceção) |
(→RN02 - Sincronização) |
||
| Linha 83: | Linha 83: | ||
Os cupons dos PDV´s importados para o ECF serão enviados para o Resulth WEB, e neste ponto será gerado o movimento de estoque dos itens de cada cupom utilizando a operação '''VENDA NO ECF IMPORTANDO PDV''' conforme regra de negócio [[#RN01 - Operações | RN01]]. | Os cupons dos PDV´s importados para o ECF serão enviados para o Resulth WEB, e neste ponto será gerado o movimento de estoque dos itens de cada cupom utilizando a operação '''VENDA NO ECF IMPORTANDO PDV''' conforme regra de negócio [[#RN01 - Operações | RN01]]. | ||
| − | |||
=== Vendas diretas e DAV´s importados === | === Vendas diretas e DAV´s importados === | ||
Edição das 08h05min de 10 de abril de 2015
Conteúdo |
Objetivo
Atores
- Usuário
Pré-requisitos
- Considerar documento Padrões de desenvolvimento.
Resultado esperado
Diagrama de classes
Fluxo de eventos
Fluxos principais
Fluxo 1:
Fluxos alternativos
Fluxo 1:
Fluxos de exceção
Fluxo 1: Usuário possui em uma determinada filial dois ou mais ECF´s cujas configurações estão diferentes uma da outra e inicializa o módulo ECF.
- Se nos parâmetros da filial as configurações de todos os ECF´s/PDV´s não forem exatamente iguais para a filial logada, será emitida ao usuário a seguinte mensagem de alerta: Para a filial XXX - XXXXXX existem um ou mais ECF´s cujas configurações diferem dos demais. É altamente recomendado que todos os ECF´s utilizem a mesma configuração. Onde X corresponde ao código e nome da filial.
- A mensagem será apenas um alerta e não impedirá o usuário de prosseguir com seu fluxo.
Regras de negócio
RN01 - Operações
No banco de dados padrão do Resulth WEB serão disponibilizadas as operações a serem utilizadas na interação com o ECF conforme segue abaixo:
- VENDA DIRETA NO ECF: Operação padrão do sistema para vendas realizadas diretamente no ECF que serão sincronizadas/enviadas para o Resulth WEB. Esta operação terá as seguintes características:
- Ativa = Sim
- Considera em vendas = Sim
- Considera em comissão = Sim
- Devolução de compras = Não
- Gera contabilidade = Não
- Gera estoque = Sim
- Gera financeiro = Sim
- Saída corresponde a uma NF feita manualmente = Não
- Nota fiscal de ajuste = Não utiliza
- Gera livros fiscais = Sim
- Permite bonificação = Não
- Calcula ICMS = Sim
- Calcula PIS = Sim
- Calcula COFINS = Sim
- Destacar/Informar ST manualmente = Não
- Calcula IPI/Destacar = Não
- VENDA NO ECF IMPORTANDO PDV: Operação padrão do sistema para vendas no ECF através da importação de PDV (não será utilizada na importação de DAV) que serão sincronizadas com o Resulth WEB. Esta operação terá as seguintes características:
- Ativa = Sim
- Considera em vendas = Não
- Considera em comissão = Não
- Devolução de compras = Não
- Gera contabilidade = Não
- Gera estoque = Sim
- Gera financeiro = Não
- Saída corresponde a uma NF feita manualmente = Não
- Nota fiscal de ajuste = Não utiliza
- Gera livros fiscais = Sim
- Permite bonificação = Não
- Calcula ICMS = Sim
- Calcula PIS = Sim
- Calcula COFINS = Sim
- Destacar/Informar ST manualmente = Não
- Calcula IPI/Destacar = Não
Para pedidos do tipo OS não será necessário ter uma operação padrão definida uma vez que as movimentações de estoque e geração do financeiro já foram realizados.
Em outras palavras, o cupom gerado para um pedido de OS não movimentará estoque nem gerará financeiro.
Pedidos do tipo DAV não podem movimentar estoque e nem gerar financeiro. Sendo assim, quando importados no ECF, as movimentações serão geradas quando o cupom for
sincronizado com o Resulth WEB a exemplo de como ocorre com a venda direta no ECF.
Operações padrão para integração com o ECF não podem ser alteradas ou excluídas pelo usuário.
RN02 - Sincronização
PDV´s importados para o ECF
Ao importar PDV´s para o ECF as seguintes regras devem ser observadas:
- PDV´s que já movimentaram estoque: Estes pedidos serão listados no ECF junto com os demais pedidos que ainda não movimentaram estoque, porém não poderão ser importados para emissão do cupom. Caso usuário informe diretamente o código ou selecione na filtragem um PDV que já movimentou estoque, o ECF abortará a importação do mesmo e emitirá ao usuário a seguinte mensagem de alerta: A emissão de cupom fiscal a partir da importação de um PDV é configurada por padrão para movimentar estoque e portanto o pedido selecionado não poderá ser importado, uma vez que ele já movimentou estoque de seus itens.
- Formas de pagamento: As formas de pagamento utilizadas no encerramento do cupom deverão ser compatíveis com as formas de pagamento do PDV importado. Para isto, quando um PDV for importado para o ECF, o sistema (ECF) deverá desabilitar todas as formas de pagamento e preencher automaticamente os valores de cada uma conforme as formas de pagamento utilizadas no PDV.
- Se o ECF estiver configurado para não importar serviço e um determinado PDV conter serviço(s), para esta importação em específico as regras acima deverão ser desconsideradas.
- Caso no PDV tenha sido utilizada a forma de pagamento financeira, ao preencher automaticamente as formas de pagamento no encerramento do cupom o sistema considerará o total financiado como dinheiro.
Os cupons dos PDV´s importados para o ECF serão enviados para o Resulth WEB, e neste ponto será gerado o movimento de estoque dos itens de cada cupom utilizando a operação VENDA NO ECF IMPORTANDO PDV conforme regra de negócio RN01.
Vendas diretas e DAV´s importados
Os cupons dos DAV´s importados e das vendas feitas diretamente no ECF serão enviados para o Resulth WEB, e neste ponto serão gerados os movimentos de estoque dos itens e também o financeiro de acordo com as formas de pagamento informadas em cada cupom utilizando a operação VENDA DIRETA NO ECF conforme regra de negócio RN01.
Antes de gerar o financeiro para os cupons sincronizados, o sistema deverá verificar nos parâmetros do PDV:
- Gerar movimento de caixa para as vendas? Se este parâmetro estiver marcado como Sim, com o subcaixa informado para centralizar vendas do PDV (logo à direita do parâmetro em questão) serão gerados movimentos de caixa para cada cupom com o subcaixa informado.
- Utiliza fechamento de caixa? Se este parâmetro estiver marcado como Sim, com o subcaixa do operador que emitiu os cupons serão gerados movimentos de caixa.
- Independente se Gerar movimento de caixa para as vendas? = Sim ou Utiliza fechamento de caixa? = Sim, ao gerar movimento de caixa será considerado:
- Se a opção Para todas as vendas estiver marcada como Sim, na conta caixa informada logo à sua direita será gerado o movimento de caixa com o valor total de cada cupom utilizando o subcaixa que centraliza as vendas do PDV ou o subcaixa do operador que emitiu os cupons.
- Caso uma ou mais formas de pagamento esteja(m) marcada(s) como Sim, na(s) conta(s) caixa informada(s) será(ão) gerado(s) movimento(s) de caixa com o(s) valor(es) da(s) respectiva(s) forma(s) de pagamento de cada cupom utilizando o subcaixa que centraliza as vendas do PDV ou o subcaixa do operador que emitiu os cupons. Se houver em um determinado cupom um forma de pagamento que está marcada nos parâmetros do PDV como Não e que não possui uma conta caixa informada, não será gerado movimento de caixa com o valor da mesma.
RN03 - Integração com controle de caixa/checkouts
Para vendas serem consideradas pelo controle de caixa, independente de sua origem, deverão ser observados:
- Caso de uso UC00066 - Abertura de caixa.
- Caso de uso UC00067 - Controle de caixa.
- Regra de negócio RN03 do caso de uso UC00064 - Parâmetros do PDV.
- Caso de uso UC00072 - Ponto de venda.
Importação de PDV e OS para o ECF
Pedidos do tipo 55 e 65 importados para o ECF serão considerados pela rotina de controle de caixa descartando a existência do cupom fiscal uma vez que a geração do financeiro só pode ser realizada pelo PDV. Em outras palavras, OS´s e PDV´s serão considerados pelo controle de caixa normalmente (se o PDV for configurado para tal) independente deles terem sido importados para o ECF ou não.
Se o PDV gera financeiro, movimento no subcaixa do operador que possui caixa aberto será gerado pelo Resulth WEB.
Importação de DAV e venda direta no ECF
Partindo do pré-suposto que o DAV não movimenta estoque nem gera financeiro, após importado para o ECF o mesmo será tratado como uma venda direta ao sincronizar seu cupom com o Resulth WEB. Para vendas diretas no ECF o movimento de estoque e a geração do financeiro serão realizados quando os respectivos cupons forem sincronizados com o Resulth WEB.
Antes de cada venda direta ou a importação de um DAV, o sistema (ECF) deverá:
- Verificar se o retaguarda (Resulth WEB) utiliza fechamento de caixa: Na aba Faturamento dos parâmetros do PDV deverá ser verificado o estado do parâmetro Utiliza fechamento de caixa?. Se o parâmetro em questão estiver como Não, os demais passos deverão ser ignorados e a venda direta ou importação do DAV procederá normalmente. Se o parâmetro estiver como Sim, executar os próximos passos.
- Verificar se o caixa do operador foi/está aberto: Para que um determinado operador consiga vender ou importar DAV no ECF é necessário que seu caixa esteja aberto no retaguarda (Resulth WEB). Caso o caixa do operador não esteja aberto o sistema (ECF) deverá abortar a venda ou importação do DAV e emitir ao usuário uma mensagem de alerta com a não conformidade.
- Caso não exista no retaguarda caixa aberto para o usuário/operador logado no ECF, exibir a mensagem: O sistema de retaguarda (Resulth WEB) está configurado para utilizar fechamento de caixa e não ha caixa aberto para o operador logado. Faça a abertura do caixa do operador em questão e tente novamente.
- Caso o caixa do usuário/operador já tenha sido fechado, exibir a mensagem: O caixa do operador logado já foi fechado e portanto o mesmo não poderá realizar vendas.
RN04 - NFC-e
Cabeçalho da NFC-e
| Atributo da classe DocumentoSaida extends DocumentoFiscal | TABELA BD ECF | CAMPO | OBSERVAÇÃO |
| filial | NFSAIDC | CODEMPRESA | Código da filial do ECF correspondente a uma filial do Resulth WEB |
| pessoa | NFSAIDC | CODCLIENTE | |
| numero | NFSAIDC | NUMNF | |
| dataEmissao | NFSAIDC | DT_EMISSAO | |
| serie | NFSAIDC | SERIE | |
| modeloNotaFiscal | -- | -- | Utilizar modelo 65, ou seja, NFC-e - Nota Fiscal Eletrônica ao Consumidor Final |
| especieNotaFiscal | -- | -- | Utilizar o modelo NFC-e, //Nota Fiscal Eletrônica ao Consumidor Final |
| observacaoLivrosFiscais | NFSAIDC | OBSLIVROFISCAL | |
| pagamento | -- | -- | Será gerado se no encerramento da NFC-e foi gerado contas a receber ou parcelas avulsas. |
| valorNF | NFSAIDC | TOTALNF | |
| observacao | NFSAIDC | OBSERVACAO | |
| numDocOrig | -- | -- | Armazena os documentos a receber gerados caso existam. |
| transportador | NFSAIDC | CODTRANSPT | |
| notaFiscalEletronica | -- | -- | |
| portalFiscalPrefeitura | -- | -- | |
| pagamentosRetencoes | -- | -- | |
| operacao | -- | -- | |
| itens | NFSAIDI | -- | Ver tabela Itens da NFC-e. |
| dataSaida | NFSAIDC | DATASAIDA | |
| horaSaida | NFSAIDC | HORASAIDA | |
| cancelada | NFSAIDC | CANCELADO | |
| notaManual | -- | -- | |
| dadoAdicionalNF | NFSAIDC | DADOSADIC | |
| pedidos | -- | -- | Utilizar o DoctoPedidoDevolucao gerado na sincronização do cupom do ECF para o Resulth WEB. |
| encerramento | -- | -- | Não gerar. O encerramento ficará na DoctoPedidoDevolucao. |
| notasRetencaoPisCofinsCsll | -- | -- | |
| pisCofinsCsllRetidoFonte | -- | -- | |
| idNotaAdevolver | -- | -- |
Itens da NFC-e
| Atributo da classe ItemNota | TABELA BD ECF | CAMPO | OBSERVAÇÃO |
| nota | -- | -- | Utilizar objeto gerado para o cabeçalho da NFC-e. |
| item | NFSAIDI | CODPROD | |
| grade | NFSAIDI | CODGRADE | Irrelevante, pois o webservice de sincronização irá devolver o ID do RrelacionamentoGrade. |
| sequencia | -- | -- | Gerado automaticamente para notas digitadas. |
| cfop | NFSAIDI | CFOP | |
| quantidade | NFSAIDI | QUANTIDADE | |
| quantidadeConvertida | -- | -- | |
| unidade | NFSAIDI | UNIDADESAIDA | |
| preco | NFSAIDI | PRECOUNIT | |
| precoConvertido | -- | -- | |
| iss | NFSAIDI | ALIQISS | Aplicar a alíquota de ISS sobre o total do item para obter o valor do imposto. |
| ipi | NFSAIDI |
|
|
| icm | NFSAIDI |
|
|
| st | NFSAIDI |
|
|
| stForaNF | -- | -- | |
| pis | NFSAIDI |
|
|
| cofins | NFSAIDI |
|
|
| aproveitamentoCredito | -- | -- | |
| descontoItem | NFSAIDI | DESCONTOVLR | |
| totalItem | NFSAIDI | QUANTIDADE * PRECOUNIT | |
| totalRateado | NFSAIDI | TOTALRATEADO | |
| cst | NFSAIDI | CODTRIBUT | |
| csosn | NFSAIDI | CODCSOSN | |
| rateio | -- | -- | |
| seriaisDigitados | CONTSER | ||
| lotesDigitados | -- | -- | |
| itensNotaEntradaSerial | -- | -- | |
| itensNotaEntradaLote | -- | -- | |
| complemento | -- | -- | |
| original | -- | -- | |
| itemBonificado | -- | -- |