> ## Documentation Index
> Fetch the complete documentation index at: https://documentacao.parcelemais.com.br/llms.txt
> Use this file to discover all available pages before exploring further.
# Editar loja
> Atualiza os dados cadastrais da loja. O nome fantasia é obrigatório; o modelo de desembolso e o endereço são opcionais e, quando omitidos, mantêm o valor atual.
A razão social e o CNPJ não são editáveis pela API. A conta bancária tem endpoint próprio.
Atualiza os dados cadastrais da loja do parceiro identificado automaticamente pelo token de acesso.
## Campos editáveis
| Campo | Comportamento |
| ------------------ | ----------------------------------------------------------------------------------------------------------------- |
| `nomeFantasia` | **Obrigatório** — enviado em toda chamada. |
| `modeloDesembolso` | **Opcional** — quando omitido, mantém o modelo atual. |
| `endereco` | **Opcional** — quando omitido, mantém o endereço atual. Envie o endereço inteiro, não apenas os campos alterados. |
A razão social e o CNPJ são definidos no cadastro e não podem ser alterados. A conta bancária tem endpoint próprio, em [Alterar conta bancária da loja](/pages/establishments/bank-account).
Para mudar o desembolso para a própria loja (`2`), a loja precisa ter conta bancária cadastrada. Cadastre a conta antes, em [Alterar conta bancária da loja](/pages/establishments/bank-account).
Uma loja inativa não aceita edição. Reative a loja antes, em [Ativar ou inativar loja](/pages/establishments/status).
## OpenAPI
````yaml PUT /v1/establishment/{estabelecimentoId}
openapi: 3.0.1
info:
title: WebIntegration
description: Este documento descreve os endpoints disponíveis da API.
version: '1.0'
servers:
- url: https://api.parcelemais.com.br/integration
description: Servidor para o ambiente de produção
- url: https://api.staging.parcelemais.com.br/integration
description: Servidor para o ambiente de staging
security:
- bearerAuth: []
paths:
/v1/establishment/{estabelecimentoId}:
put:
tags:
- Loja
summary: Editar loja.
description: >
Atualiza os dados cadastrais da loja. O nome fantasia é obrigatório; o
modelo de desembolso e o endereço são opcionais e, quando omitidos,
mantêm o valor atual.
A razão social e o CNPJ não são editáveis pela API. A conta bancária tem
endpoint próprio.
operationId: updateEstablishment
parameters:
- $ref: '#/components/parameters/EstablishmentId'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateEstablishmentRequest'
example:
nomeFantasia: Loja Centro Matriz
modeloDesembolso: 2
endereco:
rua: Av. Paulista
numero: '1578'
complemento: Loja 3
bairro: Bela Vista
cidade: São Paulo
estado: SP
cep: '01310100'
responses:
'200':
description: Loja atualizada com sucesso.
'400':
description: Dados inválidos.
content:
application/json:
schema:
$ref: '#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails'
'404':
description: Loja não encontrada ou não pertence ao parceiro.
'409':
description: Loja ou rede inativa.
'500':
description: Internal Server Error
components:
parameters:
EstablishmentId:
name: estabelecimentoId
in: path
required: true
description: Identificador da loja, retornado no cadastro.
schema:
type: string
format: uuid
example: 9c0969d7-561e-4fae-88e7-790968fd1ddf
schemas:
UpdateEstablishmentRequest:
required:
- nomeFantasia
type: object
properties:
nomeFantasia:
type: string
description: Nome fantasia da loja.
modeloDesembolso:
type: integer
format: int32
nullable: true
enum:
- 1
- 2
- 3
description: >-
Quando omitido, mantém o modelo atual. 1: a rede recebe; 2: a
própria loja recebe; 3: conta de terceiro.
endereco:
allOf:
- $ref: '#/components/schemas/EstablishmentAddressRequest'
nullable: true
description: Quando omitido, mantém o endereço atual.
additionalProperties: false
Microsoft.AspNetCore.Mvc.ProblemDetails:
type: object
properties:
tipo:
type: string
nullable: true
titulo:
type: string
nullable: true
status:
type: integer
format: int32
nullable: true
detalhe:
type: string
nullable: true
instancia:
type: string
nullable: true
erros:
type: object
nullable: true
description: >-
Detalhamento por campo, presente quando o erro é de validação de
payload. Ausente (`null`) para erros de regra de negócio, que trazem
a explicação apenas em `detalhe`.
additionalProperties:
type: array
items:
type: string
correlationId:
type: string
nullable: true
description: >-
Identificador de correlação da requisição (ver cabeçalho
`CorrelationId`), útil para localizar logs ao abrir um chamado de
suporte.
example:
tipo: https://tools.ietf.org/html/rfc7231#section-6.5.1
titulo: Requisição inválida.
status: 400
detalhe: O campo 'cpf' é obrigatório.
instancia: /v1/order
erros:
cpf:
- O campo 'cpf' é obrigatório.
correlationId: 0HN7E4B8Q9K3D:00000001
EstablishmentAddressRequest:
required:
- rua
- numero
- bairro
- cidade
- estado
- cep
type: object
description: Endereço da loja.
properties:
rua:
type: string
description: Logradouro da loja.
numero:
type: string
description: Número do endereço.
complemento:
type: string
nullable: true
description: Complemento do endereço.
bairro:
type: string
description: Bairro da loja.
cidade:
type: string
description: Cidade da loja.
estado:
type: string
description: Unidade federativa, com duas letras.
example: SP
cep:
type: string
description: CEP da loja, somente números.
example: '01310100'
pais:
type: string
nullable: true
description: País da loja. Quando omitido, assume Brasil.
additionalProperties: false
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: >-
Cabeçalho de autenticação Bearer no formato `Bearer ` onde
`` é seu TOKEN de autenticação
````