API da Movvio

A API da Movvio deixa seus sistemas lerem os pedidos e os dados da sua loja com uma chave de API.

Use a API para levar pedidos para o seu ERP, montar relatórios de BI ou automatizar rotinas, sem precisar de login de usuário. A v1 é somente leitura e foi feita para chamadas de servidor para servidor.

URL base#

Todas as requisições usam HTTPS e começam com:

https://api.movvio.com.br/v1

Cada chave pertence a uma loja só. Por isso os caminhos não levam o ID da loja: a API responde sempre com os dados da loja da chave.

Recursos#

Pedidos: GET /v1/orders e GET /v1/orders/{id}. Escopo orders:read.
Resumo de pedidos: GET /v1/orders/summary. Escopo orders:read.
Lojas: GET /v1/store. Escopo store:read.

Comece pelo Quickstart para fazer a primeira chamada em poucos minutos.

OpenAPI#

A especificação OpenAPI 3 da v1 fica em:

https://api.movvio.com.br/v1/openapi.json

Use o arquivo para gerar um cliente (SDK) na sua linguagem ou importar a API numa ferramenta como Postman ou Insomnia. Ele não exige chave e descreve só os endpoints, sem dados da loja.

Formato dos dados#

Respostas em JSON, com chaves em snake_case.
Valores em dinheiro vêm como string decimal com 2 casas ("129.90") ou null. Converta com um tipo decimal, não com ponto flutuante.
Datas e horas vêm em ISO 8601 UTC (2026-10-30T14:05:12.345Z). ordered_at é só a data, no formato YYYY-MM-DD.
Listas são paginadas por cursor. Veja Paginação.

Versionamento#

A versão faz parte do caminho (/v1). Mudanças que somam, como um campo novo, um parâmetro opcional novo ou um valor novo num enum, entram na v1 sem aviso de quebra. Remover um campo ou mudar o tipo dele só acontece numa nova versão (/v2).