Arquitetura sugerida
Portal publico para fornecedores responderem cotacoes sem expor o servidor local do cliente.
O sistema local continua gerando o relatorio e publica apenas os dados da cotacao para este portal. Cada fornecedor recebe um link unico com token e preenche os precos aqui.
1. Exportacao
O sistema local envia a cotacao para a API protegida com `x-api-key`.
2. Resposta do fornecedor
O fornecedor acessa `/q/:token`, preenche marca, preco e prazo, e envia.
3. Retorno
O sistema local consulta os resultados e importa a comparacao de volta.
API base
http://localhost:3011
Payload de integracao inicial
{
"externalId": "cotacao-2026-0001",
"clientName": "Cliente Exemplo",
"companyId": "1",
"companyName": "Empresa Matriz",
"reportName": "Relatorio de compras maio/2026",
"buyerName": "Administrador",
"buyerEmail": "compras@cliente.com",
"notes": "Responder ate as 18h do dia util seguinte.",
"currencyCode": "BRL",
"expiresAt": "2026-05-20T18:00:00.000Z",
"items": [
{
"productId": "1001",
"sku": "ABC-1001",
"productName": "Cafe 500g",
"groupName": "Mercearia",
"subgroupName": "Cafe",
"unit": "UN",
"requestedQuantity": 20,
"currentStock": 8,
"currentCost": 14.5,
"metadata": {
"companyName": "Empresa Matriz"
}
}
],
"suppliers": [
{
"supplierId": "200",
"supplierName": "Fornecedor Alfa",
"supplierEmail": "contato@fornecedor.com"
}
]
}