API aberta e Swagger
Integre materiais e preços da sua marca com tokens pessoais que expiram e podem ser revogados.
Crie um token
Em Configurações → API aberta, escolha a marca ativa, nome, validade e permissões de leitura ou escrita para Materiais e Precificação. Copie o token exibido uma única vez.
Teste no Swagger
Abra https://api.metriplan.com/api-docs?lang=pt-BR, clique em Authorize e cole o token mpat_ (sem escrever Bearer). Expanda uma rota, preencha os campos e use Execute.
Liste materiais de uma pasta
GET /api/public/v1/materials aceita folder_path com o caminho lógico da pasta, por exemplo MATERIA_PRIMA\MDF\Duratex. A resposta inclui materiais descendentes e seus códigos de orçamento.
Atualize códigos e preços
PATCH /materials/{id}/budget-code define o código. GET /raw-materials/{moduleId}/variations mostra os SKUs disponíveis. PUT /variations/prices aceita até 100 códigos por chamada; use unit un para unidade ou m2 para metro quadrado, e price em BRL.
Proteja o acesso
Guarde o token como segredo no seu servidor. Ele fica limitado à marca, às permissões do usuário criador e aos escopos escolhidos. Revogue-o na mesma tela se não for mais necessário.