Skip to main content
A loja é o estabelecimento que origina os pedidos. Todo pedido é criado no contexto de uma loja, identificada pelo CNPJ em documentoEstabelecimento.

Gerenciamento pela API

As lojas podem ser cadastradas, consultadas, editadas e ativadas ou inativadas diretamente pela API de integração.

Rede e lojas

A rede define as condições comerciais

As lojas de um parceiro pertencem a uma rede, que concentra taxas, prazos e modelo de juros válidos para todas elas.A rede não é criada nem editada pela API — ela é configurada pelo time da Parcele+ no onboarding, junto com a primeira loja. A partir daí, você cadastra as demais lojas pela API.
A rede é identificada automaticamente pelo token de acesso. Você só enxerga e altera lojas da sua própria rede — um identificador de outra rede retorna 404.

Situação da loja

Ativa

Aceita novos pedidos e pode ser editada.

Inativa

Não aceita novos pedidos nem edição. Pedidos já em andamento seguem normalmente até o fim.

Inativar é reversível

Envie ativa: true no endpoint de situação para reativar. Lojas inativas continuam aparecendo na listagem, então você sempre recupera o identificador de uma loja que inativou.

Identificador da loja

Dois identificadores, usos diferentes

  • estabelecimentoId — devolvido no cadastro. Identifica a loja nos endpoints de consulta, edição, conta bancária e situação.
  • CNPJ — é o que você envia em documentoEstabelecimento ao criar um pedido.
Guarde o estabelecimentoId retornado no cadastro. Se perder, recupere pela listagem de lojas.