API

A API do M3R é o mesmo backend do ERP (farmus-api), exposta em https://api.m3rin.com.br/api. Toda chamada respeita tenant, permissão e auditoria.

O que a API cobre

Não há um catálogo paralelo de “microserviços de marketing”. A API é a operação:

• cadastros (plataforma)
• compras e NF de entrada
• estoque, ATP e MRP
• pedidos e faturamento
• lotes, OP, recall e doação
• títulos e baixas
• fiscal / apuração
• Developer Platform (IPs, SDK)

Autenticação e isolamento

Sessão e refresh seguem o fluxo do ERP. Integrações server-to-server usam as credenciais do tenant — nunca um token global.

Qualquer consulta sem tenant / empresa é inválida. Extensões e jobs herdam o mesmo isolamento.

GET /api/developer/sdk/catalog
Authorization: Bearer <jwt-developer>

curl -H "Authorization: Bearer $TOKEN" \
  https://api.m3rin.com.br/api/developer/sdk/catalog

O catálogo devolve os códigos publicados e o que está wired neste core.

Developer Platform

Extensões TypeScript falam com o core via SDK (@m3r/sdk):

• eventos depois do commit (sales.order.created, fulfilled, …)
• pontos de interação síncronos (IP/PE) que podem negar ou aplicar patches
• tabelas e telas declarativas persistidas pelo core, renderizadas no ERP