API MOB — Integração Cliente

Base: /api/v1 · Auth: Bearer JWT · IA: Gemini + Claude

Autenticação

POST /auth/login
{ "email": "...", "password": "..." }
→ { "access_token", "user": { "role", "tenant_id", ... } }

Documentos

  • GET /documents — listagem com filtros
  • POST /documents/upload — multipart (file, tipo, competência, fornecedor)
  • GET /documents/{id}/extraction — JSON extraído pela IA
  • POST /documents/{id}/approve · /reject

Workforce

  • GET /workforce?tenant_id= — visão gestor (vidas, IGC, ranking)
  • GET /workers?supplier_id= — quadro do fornecedor
  • GET /workers/summary?supplier_id= — resumo conformidade
  • POST /workers · DELETE /workers/{id}

KPIs

GET /kpis?tenant_id=&period= — IGC, pendências, atrasos, rejeições.

Dados enviados ao cliente (exemplos)

GET /workforce → {
  total_workers_active, total_conformes, total_pending,
  workforce_igc, supplier_ranking: [{ supplier_name, workforce_igc, ... }]
}

GET /documents/{id}/extraction → {
  provider: "gemini" | "claude",
  confidence_score, extracted_data, validation_results
}

Tempo de processamento

IA visão PDF nativa (Gemini + Claude): 8–20s por documento típico. Mercado tradicional (análise humana): horas a dias.

Documentação completa em docs/MOB-API-INTEGRACAO-CLIENTE.md · Swagger: localhost:8001/docs