Regras de negócio · Honda Takai
TAKAI VEICULOS LTDA · Recepção e aprovação de notas fiscais · Protótipo Fluig · setembro de 2026
1 · Visão geral
Hoje as aprovações de notas fiscais da Honda Takai correm fora do sistema, por e-mail e em controles paralelos. Depois de aprovada, a nota é redigitada na Linx. O protótipo leva essa esteira para o Fluig, com trilha de auditoria de cada decisão e sem redigitação. O faturamento de veículos, segundo fluxo apontado pela Honda Takai, é tratado em protótipo próprio.
| Processo | Formulário | Estados | Resumo |
| Recepção e aprovação de notas fiscais | FRM_RECEPCAO_NF | 10 | Lançamento com leitura automática da nota, validação do gestor, Compras, classificação contábil, lançamento na Linx e pagamento pelo Financeiro. |
2 · Glossário
| Linx | Sistema de gestão (DMS) da concessionária, onde ficam os títulos a pagar. Não expõe API. |
| Título | Lançamento a pagar gerado na Linx a partir da nota fiscal aprovada. |
| Despesa recorrente | Lançamento mensal, como a mensalidade de um serviço, que segue a mesma esteira de aprovação das compras. |
| Leitura automática (OCR) | Extração dos dados da nota a partir do XML ou PDF anexado, para conferência. Simulada no protótipo. |
3 · Atores e papéis
Todos os papéis usam o Fluig com login e senha. Não há portal público.
| Papel | Grupo Fluig | Atividades |
| Solicitante do setor | TAKAI_SOLICITANTES | 1 · Lançar nota fiscal · 8 · Corrigir ou cancelar nota |
| Gestor da área | por setor (MEC_GestorDoSetor) | 2 · Validar despesa |
| Compras | TAKAI_COMPRAS | 3 · Aprovar compra |
| Contabilidade | TAKAI_CONTABILIDADE | 4 · Conferir e classificar para lançamento · 6 · Tratar erro de integração com a Linx |
| Financeiro | TAKAI_FINANCEIRO | 7 · Aprovar e registrar pagamento |
| Sistema | — | 5 · Lançar título na Linx (automático) |
4 · Modelo de dados
FRM_RECEPCAO_NF
| Grupo | Campos |
| Nota fiscal | anexo_nf, nf_numero, nf_serie, nf_chave, nf_emissao, nf_vencimento, nf_valor_total |
| Fornecedor | fornecedor_razao, fornecedor_cnpj |
Itens (tabela filha itens_nf) | item_descricao, item_quantidade, item_valor |
| Origem | unidade (Blumenau, Brusque, Itajaí), setor, centro_custo, tipo_despesa (compra/recorrente), obs_solicitante |
| Classificação | conta_contabil, natureza |
| Linx | linx_titulo, linx_status, linx_mensagem, linx_data_lancamento, acao_erro_linx, linx_titulo_manual, obs_erro_linx |
| Pagamento | pgto_data, pgto_forma |
| Decisões | dec_gestor/just_gestor, dec_compras/just_compras, dec_contabilidade/just_contabilidade, dec_financeiro/just_financeiro, acao_correcao, motivo_cancelamento |
Histórico (tabela filha historico_aprovacoes) | hist_etapa, hist_usuario, hist_data, hist_decisao, hist_justificativa |
5 · Regras por fase
| Estado | Atividade | Regra |
| 1 | Lançar nota fiscal StartEvent_LancarNotaFiscal | Anexo XML/PDF obrigatório. A leitura automática preenche os dados da nota; o solicitante confere e corrige antes de enviar. O arquivo fica no GED. |
| 2 | Validar despesa Task_ValidarDespesa | O gestor do setor confirma que a despesa é devida. Aprovar segue para Compras (Gateway_DespesaDevida); reprovar devolve ao solicitante. |
| 3 | Aprovar compra Task_AprovarCompra | Compras aprova. Aprovar segue para a Contabilidade (Gateway_CompraAprovada); reprovar devolve ao solicitante. |
| 4 | Conferir e classificar para lançamento Task_ConferirClassificarLancamento | A Contabilidade informa conta contábil, natureza e revisa o centro de custo. Classificada, segue para o lançamento (Gateway_ClassificacaoConcluida); reprovar devolve ao solicitante. |
| 5 | Lançar título na Linx ServiceTask_LancarTituloLinx | Automático. Grava o número do título e segue para o Financeiro. Em caso de falha, o evento BoundaryError_LancamentoLinx leva ao tratamento de erro. |
| 6 | Tratar erro de integração com a Linx Task_TratarErroIntegracaoLinx | A Contabilidade vê a mensagem de erro e escolhe reprocessar (volta ao estado 5) ou registrar o lançamento manual, informando o número do título (Gateway_TratamentoErroLinx). |
| 7 | Aprovar e registrar pagamento Task_AprovarRegistrarPagamento | O Financeiro aprova e registra data e forma de pagamento (Gateway_PagamentoAprovado); reprovar devolve ao solicitante. |
| 8 | Corrigir ou cancelar nota Task_CorrigirOuCancelarNota | A justificativa da reprovação aparece em destaque. Reenviar volta à validação do gestor; cancelar exige motivo (Gateway_CorrigirOuCancelarNota). |
| 9 | Nota paga EndEvent_NotaPaga | Fim com a nota lançada e o pagamento registrado. |
| 10 | Nota cancelada EndEvent_NotaCancelada | Fim por cancelamento, com motivo. |
6 · Eventos e timers
- Timers: nenhum. A Honda Takai não citou prazo por etapa.
- Evento de erro:
BoundaryError_LancamentoLinx, preso a ServiceTask_LancarTituloLinx. Interrompe a tentativa e abre a tarefa de tratamento de erro, que pode reprocessar.
7 · Validações
- Toda reprovação exige justificativa.
- Anexo da nota obrigatório no estado 1; CNPJ do fornecedor com formato válido; valor total igual à soma dos itens (alerta de divergência para conferência).
- No estado 6, "Lançado manualmente" exige o número do título; no estado 7, aprovar exige data e forma de pagamento.
- Cancelamento exige motivo.
8 · Integrações
| Sistema | Direção | Mecanismo | Uso |
| Linx (ERP) | Fluig → Linx | Camada de integração própria (a Linx não expõe API), no modelo já usado com o Winthor. Simulada no protótipo. | Estado 5: lançamento do título a pagar |
| Leitura da nota (OCR) | Anexo → Fluig | Leitura do XML ou OCR do PDF. Simulada no protótipo. | Estado 1: pré-preenchimento para conferência |
9 · Notificações
Só por e-mail, com o aviso padrão de nova tarefa do Fluig, para o responsável de cada atividade. Na devolução ao solicitante, o e-mail leva a justificativa.
10 · Datasets Fluig
| Dataset | Uso | No protótipo |
ds_setores_gestores | Setor/centro de custo → gestor da área (estado 2) | Dados de exemplo |
ds_contas_contabeis | Lista de contas e naturezas para a classificação (estado 4) | Dados de exemplo |
11 · Permissões
- Cada atividade só é executada pelo grupo ou mecanismo indicado em "Atores e papéis".
- Os campos de cada etapa ficam editáveis só na própria etapa; os demais aparecem bloqueados para consulta.
- Os painéis de acompanhamento mostram as solicitações do setor do usuário. Contabilidade e Financeiro veem todas.
12 · Pendências pra fechar escopo
- a confirmar Sistema em que a Contabilidade lança a nota. O protótipo assume a Linx.
- a confirmar Alçadas por valor na nota fiscal. Hoje são três aprovações fixas.
- proposta Reprovação devolve ao solicitante, com justificativa. Regra proposta pela Mountain, a validar com a Honda Takai.
- a confirmar Fonte do vínculo setor/centro de custo → gestor da área.
- a confirmar Caminho de acesso aos dados da Linx para a camada de integração, a confirmar com a TOTVS. Define o esforço de integração no Works.
- a confirmar Volume mensal de notas e quantas unidades entram.
- proposta Checagem COAF na esteira de notas, assinatura eletrônica pelo TAE e caixa de e-mail monitorada como entrada de notas. Foram apresentadas antes ao ESN e ainda não foram pedidas pela Honda Takai.