Lojas (unidades)

Liste e mantenha as lojas da sua rede, para separar clientes, vendas e relatórios por loja.

https://app.reton.com.br/api/v1Atualizado em 30 de setembro de 2026
Coleção do PostmanOpenAPI 3.1
Navegar na API

Se você tem mais de uma loja, cadastre cada uma com um codigo — o mesmo que o seu sistema usa (ex.: LJ01). Depois, basta mandar esse unidadeCodigo ao cadastrar um cliente ou resgatar um prêmio.

No Reton, loja é tecnicamente uma unidade — por isso o endereço é /unidades e o id começa com uni_. A quantidade de lojas depende do seu plano.

Os comandos desta página saem prontos para copiar. A chave fica só nesta aba — não é salva nem enviada.

Listar lojas

GET/api/v1/unidades

Todas as lojas ativas da conta.

Parâmetros da URL

  • incluirInativasboolean

    true para trazer também as desativadas.

    Padrão: false.

Requisição
curl "https://app.reton.com.br/api/v1/unidades" \  -H "X-API-Key: $RETON_API_KEY"
Resposta · 200 · Lojas
{  "success": true,  "data": {    "total": 1,    "unidades": [      {        "id": "uni_N98eudAvtndlbaM1",        "nome": "Loja Centro",        "codigo": "LJ01",        "endereco": "Rua das Flores, 120 — Centro",        "telefone": "1133334444",        "ativo": true,        "principal": false,        "criadoEm": "2026-09-30T14:51:44.508Z",        "atualizadoEm": "2026-09-30T14:51:44.782Z"      }    ]  },  "meta": {    "requestId": "req_V1StGXR8Z5jdHi6B"  }}

Cadastrar loja

POST/api/v1/unidades

Cria uma loja nova.

Corpo da requisição (JSON)

  • nomestringobrigatório

    Nome da loja. Não pode repetir.

    Até 200 caracteres.

  • codigostring

    O código da loja no seu sistema (ex.: LJ01).

    Até 50 caracteres.

  • enderecostring

    Endereço.

    Até 500 caracteres.

  • telefonestring

    Telefone.

    Até 20 caracteres.

  • principalboolean

    true para ela virar a loja principal da conta.

Erros que você deve tratar

  • 409 CONFLICTJá existe uma loja com esse nome.
  • 422 VALIDATION_ERRORO seu plano não permite mais lojas.
Requisição
curl -X POST "https://app.reton.com.br/api/v1/unidades" \  -H "X-API-Key: $RETON_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "nome": "Loja Centro",    "codigo": "LJ01",    "endereco": "Rua das Flores, 120 — Centro",    "telefone": "1133334444"  }'
Resposta · 201 · Criada
{  "success": true,  "data": {    "id": "uni_N98eudAvtndlbaM1",    "nome": "Loja Centro",    "codigo": "LJ01",    "endereco": "Rua das Flores, 120 — Centro",    "telefone": "1133334444",    "ativo": true,    "principal": false,    "criadoEm": "2026-09-30T14:51:44.508Z",    "atualizadoEm": "2026-09-30T14:51:44.782Z"  },  "meta": {    "requestId": "req_V1StGXR8Z5jdHi6B"  }}

Consultar loja

GET/api/v1/unidades/:id

Uma loja pelo id.

Parâmetros do caminho

  • idstringobrigatório

    O id da loja (uni_…).

Requisição
curl "https://app.reton.com.br/api/v1/unidades/uni_N98eudAvtndlbaM1" \  -H "X-API-Key: $RETON_API_KEY"
Resposta · 200 · Loja
{  "success": true,  "data": {    "id": "uni_N98eudAvtndlbaM1",    "nome": "Loja Centro",    "codigo": "LJ01",    "endereco": "Rua das Flores, 120 — Centro",    "telefone": "1133334444",    "ativo": true,    "principal": false,    "criadoEm": "2026-09-30T14:51:44.508Z",    "atualizadoEm": "2026-09-30T14:51:44.782Z"  },  "meta": {    "requestId": "req_V1StGXR8Z5jdHi6B"  }}
Resposta · 404 · Não encontrada
{  "success": false,  "error": {    "code": "NOT_FOUND",    "message": "Unidade não encontrada."  },  "meta": {    "requestId": "req_V1StGXR8Z5jdHi6B"  }}

Alterar loja

PATCH/api/v1/unidades/:id

Muda só os campos que você mandar.

Para apagar o código, o endereço ou o telefone, mande o campo com null.

Parâmetros do caminho

  • idstringobrigatório

    O id da loja (uni_…).

Corpo da requisição (JSON)

  • nomestring

    Novo nome.

    Até 200 caracteres.

  • codigostring

    Novo código (ou null).

    Até 50 caracteres.

  • enderecostring

    Novo endereço (ou null).

    Até 500 caracteres.

  • telefonestring

    Novo telefone (ou null).

    Até 20 caracteres.

Erros que você deve tratar

  • 404 NOT_FOUNDLoja não encontrada.
  • 409 CONFLICTJá existe outra loja com esse nome.
Requisição
curl -X PATCH "https://app.reton.com.br/api/v1/unidades/uni_N98eudAvtndlbaM1" \  -H "X-API-Key: $RETON_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "telefone": "1133334444"  }'
Resposta · 200 · Alterada
{  "success": true,  "data": {    "id": "uni_N98eudAvtndlbaM1",    "nome": "Loja Centro",    "codigo": "LJ01",    "endereco": "Rua das Flores, 120 — Centro",    "telefone": "1133334444",    "ativo": true,    "principal": false,    "criadoEm": "2026-09-30T14:51:44.508Z",    "atualizadoEm": "2026-09-30T14:51:44.782Z"  },  "meta": {    "requestId": "req_V1StGXR8Z5jdHi6B"  }}

Desativar loja

DELETE/api/v1/unidades/:id

Desativa a loja (não apaga o histórico dela).

A loja sai das listas, mas as vendas e os clientes dela continuam no Reton. Não é possível desativar a loja principal nem a única loja ativa.

Parâmetros do caminho

  • idstringobrigatório

    O id da loja (uni_…).

Erros que você deve tratar

  • 404 NOT_FOUNDLoja não encontrada.
  • 422 VALIDATION_ERRORÉ a loja principal ou a única ativa.
Requisição
curl -X DELETE "https://app.reton.com.br/api/v1/unidades/uni_N98eudAvtndlbaM1" \  -H "X-API-Key: $RETON_API_KEY"
Resposta · 200 · Desativada
{  "success": true,  "data": {    "ok": true,    "message": "Unidade desativada."  },  "meta": {    "requestId": "req_V1StGXR8Z5jdHi6B"  }}
Resposta · 422 · Única loja ativa
{  "success": false,  "error": {    "code": "VALIDATION_ERROR",    "message": "Não é possível desativar a única unidade ativa da empresa."  },  "meta": {    "requestId": "req_V1StGXR8Z5jdHi6B"  }}

Isso foi útil?

Ainda precisa de ajuda?

Não achou o que procurava? A gente responde de gente pra gente.

Falar com a gentesuporte@sac.reton.com.br