> ## 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.

# Listar lojas

> Retorna as lojas da rede do parceiro, como uma lista simples (sem paginação). Lojas inativas também são retornadas — use o filtro `ativa` para separar.



## OpenAPI

````yaml GET /v1/establishment/list
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/list:
    get:
      tags:
        - Loja
      summary: Listar lojas.
      description: >-
        Retorna as lojas da rede do parceiro, como uma lista simples (sem
        paginação). Lojas inativas também são retornadas — use o filtro `ativa`
        para separar.
      operationId: listEstablishments
      parameters:
        - name: nomeFantasia
          in: query
          description: >-
            Filtra pelo nome fantasia da loja. Busca parcial, sem diferenciar
            maiúsculas de minúsculas.
          required: false
          schema:
            type: string
          example: Loja Centro
        - name: ativa
          in: query
          description: >-
            Filtra pela situação da loja. Quando omitido, retorna ativas e
            inativas.
          required: false
          schema:
            type: boolean
          example: true
      responses:
        '200':
          description: Lojas retornadas com sucesso.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/EstablishmentIntegrationResponse'
              example:
                - estabelecimentoId: 9c0969d7-561e-4fae-88e7-790968fd1ddf
                  documento: '12345678000199'
                  razaoSocial: Loja Centro LTDA
                  nomeFantasia: Loja Centro
                  ativa: true
                  modeloDesembolso: 1
                  responsavel:
                    nome: Maria Souza
                    email: maria.souza@lojacentro.com.br
                    celular: '+5511999998888'
                  contaBancaria:
                    banco: '341'
                    agencia: '1234'
                    digitoAgencia: ''
                    conta: '56789'
                    digitoConta: '0'
                    tipoConta: 1
                  endereco:
                    rua: Av. Paulista
                    numero: '1578'
                    complemento: Loja 3
                    bairro: Bela Vista
                    cidade: São Paulo
                    estado: SP
                    cep: '01310100'
                    pais: Brasil
        '400':
          description: Dados inválidos.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails'
        '404':
          description: Parceiro ou rede não encontrada.
        '500':
          description: Internal Server Error
components:
  schemas:
    EstablishmentIntegrationResponse:
      type: object
      properties:
        estabelecimentoId:
          type: string
          format: uuid
        documento:
          type: string
          description: CNPJ da loja.
        razaoSocial:
          type: string
        nomeFantasia:
          type: string
        ativa:
          type: boolean
          description: Situação da loja. Uma loja inativa não aceita novos pedidos.
        modeloDesembolso:
          type: integer
          format: int32
          nullable: true
          description: '1: a rede recebe; 2: a própria loja recebe; 3: conta de terceiro.'
        responsavel:
          $ref: '#/components/schemas/EstablishmentOwnerIntegrationResponse'
        contaBancaria:
          allOf:
            - $ref: '#/components/schemas/EstablishmentBankAccountIntegrationResponse'
          nullable: true
          description: Ausente quando a loja não tem conta bancária cadastrada.
        endereco:
          allOf:
            - $ref: '#/components/schemas/EstablishmentAddressIntegrationResponse'
          nullable: true
          description: Ausente quando a loja não tem endereço cadastrado.
      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
    EstablishmentOwnerIntegrationResponse:
      type: object
      properties:
        nome:
          type: string
        email:
          type: string
        celular:
          type: string
      additionalProperties: false
    EstablishmentBankAccountIntegrationResponse:
      type: object
      properties:
        banco:
          type: string
        agencia:
          type: string
        digitoAgencia:
          type: string
        conta:
          type: string
        digitoConta:
          type: string
        tipoConta:
          type: integer
          format: int32
          nullable: true
          description: '1: Corrente; 2: Poupança; 3: Pagamento.'
        nomeTitular:
          type: string
          nullable: true
        documentoTitular:
          type: string
          nullable: true
      additionalProperties: false
    EstablishmentAddressIntegrationResponse:
      type: object
      properties:
        rua:
          type: string
          nullable: true
        cidade:
          type: string
          nullable: true
        estado:
          type: string
          nullable: true
        bairro:
          type: string
          nullable: true
        cep:
          type: string
          nullable: true
        pais:
          type: string
          nullable: true
        numero:
          type: string
          nullable: true
        complemento:
          type: string
          nullable: true
      additionalProperties: false
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Cabeçalho de autenticação Bearer no formato `Bearer <token>` onde
        `<token>` é seu TOKEN de autenticação

````