07 — Importação e integração
O QAS é completo sozinho. Esta seção define as portas: por onde entram e saem dados, para quem tem ERP ou outros sistemas.
1. Importação de planilha
- #IMP-01 Decidido · 03/10 Fornecedores e produtos por planilha. Excel (
.xlsx) e CSV Decidido · 05/10 - #IMP-02 Decidido · 03/10 Duas formas: o usuário indica qual coluna corresponde a cada campo, ou baixa um modelo pronto
- #IMP-03 Proposta Mapeamentos salvos para reuso (ex.: "exportação do ERP X")
- #IMP-04 Proposta Pré-visualização com erros por linha antes de gravar; opção de importar só as válidas
- #IMP-05 Proposta Reimportar atualiza em vez de duplicar. Chave: ID externo, quando houver; senão CNPJ (fornecedor nacional), nome + país (estrangeiro), referência + fabricante (produto)
- #IMP-06 Proposta Tratar o CSV brasileiro (
;, vírgula decimal, UTF-8/Latin-1) - #IMP-07 Proposta A importação é registrada: quem, quando, arquivo original guardado, inseridos, atualizados, rejeitados
- #IMP-08 Proposta Também importáveis: colaboradores e funções, instrumentos, questões de prova, vínculos função × POP
- #IMP-09 Proposta Alteração de campo crítico de fornecedor qualificado via importação segue Doc 04 FOR-44 (gera reavaliação)
2. Um só caminho de entrada
Proposta Tela, planilha e API passam pela mesma sequência:
receber → preparar (staging) → validar → aplicar | quarentena
- #INT-01 Registro inválido vindo de integração não se perde nem entra: vai para quarentena, visível para a qualidade
- #INT-02 Exclusão vinda de fora vira inativação
- #INT-03 A trilha mostra a origem de cada alteração (usuário, planilha X, integração Y)
3. Dono de cada dado
Proposta Quando houver integração, define-se por campo quem manda. Sugestão padrão:
| Entidade | Sistema externo manda em | QAS manda em |
|---|---|---|
| Fornecedor | Dados cadastrais e fiscais | Tipo, criticidade, dossiê, qualificação, status |
| Produto | Código, descrição comercial | Regime, número e situação ANVISA, titular, fabricante legal, dossiê |
| Colaborador | Admissão, cargo, filial, afastamento, desligamento (RH) | Funções da matriz, treinamentos, PIN |
| Empresa | CNPJ, IE, endereço | Regularidade (AFE, licenças, RT) |
Sem integração, o QAS manda em tudo.
4. API
- #API-01 Proposta Cadastro: criar/atualizar/inativar fornecedores, produtos, colaboradores, funções e empresas, com ID externo
(sistema, id)em cada entidade. CNPJ não serve como chave universal (fornecedor estrangeiro) - #API-02 Proposta Consultas de bloqueio:
- pode comprar (fornecedor)
- pode receber/vender (produto com regularização válida e fornecedor ok)
- pode usar (instrumento calibrado)
- #API-03 Proposta Cada consulta e a resposta dada ficam registradas: prova na auditoria que o ERP verificou o fornecedor antes do pedido
- #API-04 Proposta Bloquear ou só avisar é política do cliente; o QAS só responde
- #API-05 Proposta Feed de mudanças (
desde=<cursor>) para sistemas que não recebem chamadas de fora - #API-06
[Proposta · Fase 3]Webhooks assinados (ex.: fornecedor desqualificado, documento vigente, calibração vencida) - #API-07 Proposta Contrato publicado (OpenAPI), versionado, com ambiente de testes, chave por integração com escopo, idempotência em toda escrita
5. Dados operacionais do futuro
Proposta A Fase 2/3 vai precisar de recebimentos (NF de entrada), expedições (NF de saída, lote/série, cliente) e devoluções. Deixar o formato de entrada desenhado, aceitando três origens: API do ERP, planilha e XML de NF-e (toda empresa tem). Assim, a ação de campo funciona mesmo sem ERP integrado.