Contrato para um ERP externo (ou uma IA) enviar catálogo, estoque e preço ao Centriaa. Push unidirecional, autoritativo, endereçado por GUID canônico. Escolha por onde começar.
Todos os endpoints /api/v1/integration/* — interativo, com schemas e exemplos. Renderizado com Scalar.
Fluxos em prosa: autenticação (RTR), custódia de GUID, LWW por occurredAt, idempotência e catálogo de erros.
O contrato em JSON (OpenAPI 3.1), pronto para uma IA ou gerador de cliente consumir direto.
openapi.integration.json →POST /api/v1/integration/credentials devolve o 1º token longo — exibido só uma vez.POST /api/v1/integration/auth/refresh troca o token longo por um access JWT (48 h) + um novo token longo.Authorization: Bearer <access> nos endpoints de negócio (produtos, estoque, preço, auxiliares).occurredAt da origem — o Centriaa aplica Last-Write-Wins por esse timestamp.