Fulfillment Manager

Manual do Usuário e Documentação de Telas

Sistema de Gestão, Monitoramento e Integração de NF-e (Plugg.To / ERP)

1. Visão Geral do Sistema

O Sistema Fulfillment Manager é uma plataforma web desenvolvida para automatizar, monitorar e parametrizar o fluxo de dados fiscais entre o hub de e-commerce (Plugg.To) e o sistema de gestão empresarial (ERP). O sistema assegura o acompanhamento em tempo real das Notas Fiscais Eletrônicas, permitindo o envio em lote de chaves de acesso, reprocessamento de falhas e configuração de webhooks de notificação.

1.1. Estrutura de Navegação Superior

A barra de navegação global está acessível no topo de todas as telas e é composta pelos seguintes módulos:

• Dashboard: Painel consolidado contendo métricas gráficas de movimentação e tabela de status individual das integrações.

• Relatório: Módulo para extração e exportação de relatórios detalhados de notas e eventos de integração.

• Processamento em Lote: Interface para importação massiva de chaves de acesso de NF-e (até 1.000 chaves por lote).

• Reimportar Notas: Ferramenta para forçar a reimportação manual de notas específicas direto do hub (Este ponto ainda não está desenvolvido).

• Configurações da Integração: Painel de parametrização de endpoints de API externa, webhooks e chaves de autenticação (API Key / Headers).

2. Módulo Dashboard — Aba NF-e (Indicadores e Gráficos)

A aba NF-e do Dashboard fornece uma visão analítica do volume de documentos fiscais transacionados no período selecionado. Através dela, a equipe operacional consegue acompanhar o quantitativo de notas recebidas no painel Plugg.To e o respectivo envio para o ERP, divididas por tipo de operação fiscal.

Figura: Dashboard — Painel de Indicadores e Gráficos da Aba NF-e

2.1. Funcionalidades da Tela

• Filtros de Período: Campos Data Início e Data Fim com botão Filtrar, permitindo delimitar a janela temporal da análise.

• Notas recebidas no painel Plugg.To: Cards numéricos apresentando os totais de Vendas, Remessa Simbólica, Nota fiscal de entrada, Retornos Simbólicos, Retorno de entrada e Devolução.

• Notas enviadas para o ERP: Cards comparativos mostrando a quantidade efetivamente sincronizada e integrada ao sistema ERP para cada categoria fiscal.

• Consolidado Financeiro de Vendas: Exibição do acumulado de vendas normais e vendas com desconto.

• Vendas no Fulfillment & Gráfico Temporal: Métricas financeiras de produtos fulfillment (Mercado Livre) e gráfico de linha cobrindo a evolução do valor total das notas ao longo dos meses.

• Gráfico de Distribuição por Tipo: Gráfico de rosca detalhando a proporção percentual de integrações por categoria de nota fiscal.

3. Módulo Dashboard — Aba Integrações (Monitoramento de Status)

A aba Integrações possibilita a auditoria detalhada item a item de cada nota fiscal recebida e processada pela integração. Ela exibe o histórico exato com data, hora, tipo de transação, resultado do processo e opções para forçar o reenvio manual.

Figura: Dashboard — Tabela de Registros e Status da Aba Integrações

3.1. Filtros e Ações Principais

• Consulta por NF-e/Série: Permite a busca rápida inserindo o número da NF-e e o número da Série nos campos de texto superiores. 
• Botão Importar NF-e: Aciona a rotina de busca e importação direta da nota fiscal junto ao canal. 
• Paginação de Dados: Navegação inferior entre as páginas de registros (ex: páginas 1 a 10 e totalizadores de mais de 90.000 registros).

3.2. Estrutura da Tabela de Registros

📌 DICA DE OPERAÇÃO - REENVIO DE NOTIFICAÇÕES 
Utilize o botão 'Reenviar' quando a notificação inicial não for recebida no ERP por instabilidade temporária de rede ou indisponibilidade no endpoint externo. O reenvio regenera o payload HTTP. 

4. Módulo Processamento em Lote de NFe

A tela de Processamento em Lote permite o envio massivo de chaves de acesso de NF-e para consulta e sincronização sequencial. É indicada para situações de contingência ou atualização em lote de notas legadas.

Figura: Módulo de Processamento em Lote de Chaves de NF-e

4.1. Instruções e Regras de Preenchimento

• Cole as Chaves NF-e: Área de texto livre para inserção direta das chaves numéricas de acesso.

• Formatação Exigida: Cada chave de acesso deve conter exatamente 44 caracteres numéricos, informada obrigatoriamente uma chave por linha.

• Capacidade Máxima: O sistema aceita o envio de até 1.000 chaves de acesso por lote de processamento.

• Histórico de Lotes: Menu dropdown para seleção e visualização do status de execução de lotes submetidos anteriormente.

• Botão Processar Lote: Inicia a validação e inclusão da fila de processamento das chaves informadas.

📌 REQUISITO DE VALIDAÇÃO DE CHAVES 
Certifique-se de que não existem espaços, traços ou caracteres especiais nas chaves coladas. Chaves fora do padrão de 44 dígitos numéricos serão descartadas pela validação. 

📌 COMPORTAMENTO DO PROCESSAMENTO 
Quando o usuário não tiver url de notificação externa configurada, a renotificação das Nfs ocorre dentro da própria Plugg.to, para que sistemas conectados a api recebam a notificação. 

5. Módulo Configurações da Integração

Neste módulo são parametrizados os dados de integração técnica da API externa. É nesta tela que a equipe de TI ou administradores do sistema configuram o endereço do webhook que receberá as notificações de novas invoices do lado da Plugg.to, o endpoint configurado receberá o payload completo da invoice na api da plugg, disponível em https://developers.plugg.to/reference/get-one-invoice.

Essa configuração não é obrigatória, e quando ignorada, o sistema se comporta apenas como um dashboard analítico para os invoices recebidos.

Figura: Módulo de Configurações da Integração e Autenticação por Header

5.1. Campos de Parametrização Técnicas

• URL API Externa: Campo para inserção do endpoint HTTP/HTTPS de destino onde as notificações de eventos de NF-e serão entregues via POST.

• Autenticação: Tipo de autenticação aceito pela API externa (ex: API Key, Bearer Token, Basic Auth).

• Nome do Cabeçalho: Nome do header HTTP customizado a ser enviado na requisição (ex: apikey, X-Api-Key, Authorization).

• Chave: Valor do token/segredo de autenticação configurado na API externa.

• Botão Salvar dados de autenticação: Grava as configurações no banco de dados e ativa o uso das novas credenciais imediatamente.

📌 ATENÇÃO SEGURANÇA E CONECTIVIDADE 
A alteração dos dados de URL ou chave de header afeta imediatamente todos os envios futuros de notificações. Certifique-se de testar o endpoint antes de salvar a nova configuração.