> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getjusto.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Editar horario del local

> Actualiza el horario del local: horario semanal, días cerrados y horarios especiales por fecha. Cada campo enviado reemplaza la lista guardada; los omitidos se conservan. Consulta el horario actual con GET /ecommerce/stores/{storeId}. Los cambios aplican de inmediato en la tienda y quedan registrados en el historial del local.



## OpenAPI

````yaml patch /ecommerce/stores/{storeId}/schedule
openapi: 3.1.0
info:
  title: Justo API
  version: 3.0.0
servers:
  - url: https://api.service.getjusto.com/v3
    description: Production server
security: []
paths:
  /ecommerce/stores/{storeId}/schedule:
    patch:
      summary: Update store schedule
      description: >-
        Actualiza el horario del local: horario semanal, días cerrados y
        horarios especiales por fecha. Cada campo enviado reemplaza la lista
        guardada; los omitidos se conservan. Consulta el horario actual con GET
        /ecommerce/stores/{storeId}. Los cambios aplican de inmediato en la
        tienda y quedan registrados en el historial del local.
      parameters:
        - in: path
          name: storeId
          required: true
          schema:
            type: string
          description: ID Justo o ID externo del local.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/apiStoreScheduleUpdateInput'
      responses:
        '200':
          description: The OpenAPI spec
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    $ref: '#/components/schemas/apiStore'
        '400':
          description: Errors
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: 'false'
                  error:
                    type: object
                    properties:
                      error:
                        type: string
                        example: error
                      message:
                        type: string
                        example: The request has an error
components:
  schemas:
    apiStoreScheduleUpdateInput:
      type: object
      description: >-
        Cambios al horario. Cada campo enviado reemplaza completo el valor
        guardado y los campos omitidos se conservan. Para agregar un día a
        closedDays o un bloque, envía la lista completa con los valores actuales
        más el nuevo. El cierre temporal se cambia en POST
        /ecommerce/stores/{storeId}/temporary-close.
      minProperties: 1
      additionalProperties: false
      properties:
        availableAtPeriods:
          type: boolean
          description: >-
            true para atender sólo en openPeriods y specialPeriods; false para
            atender todo el día.
        openPeriods:
          type: array
          description: >-
            Horario semanal completo. Un arreglo vacío elimina el horario
            semanal y el local queda abierto todo el día en los días sin horario
            especial. Para cerrar usa closedDays o POST
            /ecommerce/stores/{storeId}/temporary-close.
          items:
            $ref: '#/components/schemas/apiStoreSchedulePeriod'
        closedDays:
          type: array
          description: >-
            Lista completa de días cerrados. Un arreglo vacío elimina todos los
            días cerrados.
          items:
            type: string
            description: >-
              Día calendario en la zona horaria del local. Al escribir se acepta
              YYYY-MM-DD o una fecha ISO 8601; se guarda como el inicio de ese
              día en la zona horaria del local.
            example: '2026-12-25'
        specialPeriods:
          type: array
          description: Lista completa de horarios especiales. Un arreglo vacío los elimina.
          items:
            $ref: '#/components/schemas/apiStoreSpecialPeriod'
      example:
        availableAtPeriods: true
        openPeriods:
          - daysOfWeek:
              - 1
              - 2
              - 3
              - 4
              - 5
            fromMinute: 720
            toMinute: 1380
          - daysOfWeek:
              - 6
              - 7
            fromMinute: 720
            toMinute: 1440
        closedDays:
          - '2026-12-25'
          - '2027-01-01'
        specialPeriods:
          - days:
              - '2026-12-24'
              - '2026-12-31'
            fromMinute: 720
            toMinute: 1080
    apiStore:
      type: object
      description: Local de una marca.
      properties:
        _id:
          type: string
          description: ID Justo del local.
        websiteId:
          type: string
          description: ID de la marca a la que pertenece el local.
        name:
          type: string
          description: Nombre del local.
          example: Providencia
        acceptDelivery:
          type: boolean
          description: Indica si el local acepta pedidos con despacho.
        acceptServe:
          type: boolean
          description: Indica si el local acepta pedidos para servir en mesa.
        acceptGo:
          type: boolean
          description: Indica si el local acepta pedidos para retiro.
        currentPreparationDuration:
          type: number
          description: Tiempo actual de preparación en minutos.
        currentDeliveryDuration:
          type: number
          description: Tiempo actual estimado de despacho en minutos.
        phone:
          type: string
          description: Teléfono del local.
        address:
          $ref: '#/components/schemas/apiStoreAddress'
        externalId:
          type: string
          description: ID externo del local configurado por la marca.
        timezone:
          type: string
          description: Zona horaria IANA del local.
          example: America/Lima
        schedule:
          $ref: '#/components/schemas/apiStoreSchedule'
    apiStoreSchedulePeriod:
      type: object
      description: Bloque horario semanal de atención del local.
      required:
        - daysOfWeek
        - fromMinute
        - toMinute
      properties:
        daysOfWeek:
          type: array
          description: >-
            Días de la semana en que aplica el bloque: 1 es lunes y 7 es
            domingo.
          items:
            type: integer
            minimum: 1
            maximum: 7
          example:
            - 1
            - 2
            - 3
            - 4
            - 5
        fromMinute:
          type: integer
          minimum: 0
          maximum: 1440
          description: Minuto del día en que comienza el bloque. 600 son las 10:00.
        toMinute:
          type: integer
          minimum: 0
          maximum: 1440
          description: >-
            Minuto del día en que termina el bloque, mayor que fromMinute. 1440
            son las 24:00. Para un horario que cruza la medianoche usa dos
            bloques.
    apiStoreSpecialPeriod:
      type: object
      description: >-
        Horario especial para fechas concretas. En esas fechas reemplaza el
        horario semanal; si una fecha tiene varios bloques, el local atiende en
        todos ellos.
      required:
        - days
        - fromMinute
        - toMinute
      properties:
        days:
          type: array
          description: Fechas en que aplica el horario especial.
          items:
            type: string
            description: >-
              Día calendario en la zona horaria del local. Al escribir se acepta
              YYYY-MM-DD o una fecha ISO 8601; se guarda como el inicio de ese
              día en la zona horaria del local.
            example: '2026-12-25'
        fromMinute:
          type: integer
          minimum: 0
          maximum: 1440
          description: Minuto del día en que comienza el bloque.
        toMinute:
          type: integer
          minimum: 0
          maximum: 1440
          description: Minuto del día en que termina el bloque, mayor que fromMinute.
    apiStoreAddress:
      type: object
      description: Dirección del local.
      properties:
        _id:
          type: string
          description: ID de la dirección.
        placeId:
          type: string
          description: ID del lugar asociado a la dirección.
        address:
          type: string
          description: Dirección principal en formato legacy.
          example: Av. Apoquindo 3000
        addressLine2:
          type: string
          description: Departamento, oficina u otra información complementaria.
        addressSecondary:
          type: string
          description: Comuna, ciudad o referencia secundaria de la dirección.
        streetAddress:
          type: string
          description: Calle y número normalizados.
        extendedAddress:
          type: string
          description: Información complementaria normalizada.
        locality:
          type: string
          description: Comuna o localidad.
        region:
          type: string
          description: Región o estado.
        postalCode:
          type: string
          description: Código postal.
        countryCode:
          type: string
          description: Código de país ISO 3166-1 alpha-2.
        countryName:
          type: string
          description: Nombre del país.
        location:
          type: object
          description: Coordenadas geográficas del local.
          properties:
            lat:
              type: number
              description: Latitud.
              example: -33.4489
            lng:
              type: number
              description: Longitud.
              example: -70.6693
    apiStoreSchedule:
      type: object
      description: Horario de atención del local.
      properties:
        closedUntilDate:
          type: string
          example: '2020-01-01T00:00:00.000Z'
          format: date-time
          description: >-
            Fecha hasta la que el local está cerrado temporalmente. Si es null,
            no hay cierre temporal activo.
        availableAtPeriods:
          type: boolean
          description: >-
            Si es false, el local atiende todo el día y no se aplican
            openPeriods ni specialPeriods. Si es true, atiende sólo en esos
            bloques; si openPeriods está vacío, atiende todo el día en los días
            sin horario especial.
        openPeriods:
          type: array
          description: Bloques horarios semanales en que el local atiende.
          items:
            $ref: '#/components/schemas/apiStoreSchedulePeriod'
        specialPeriods:
          type: array
          description: Horarios especiales por fecha, como feriados con horario reducido.
          items:
            $ref: '#/components/schemas/apiStoreSpecialPeriod'
        closedDays:
          type: array
          description: >-
            Días completos en que el local está cerrado, guardados como el
            inicio del día en la zona horaria del local.
          items:
            type: string
            format: date-time
        timezone:
          type: string
          description: Zona horaria IANA usada para interpretar el horario.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.