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

# Subscribe Restock Notice

> Inscreve um e-mail para ser avisado quando o produto voltar ao estoque.
<Note>Só vale para produto esgotado (`stock.available` falso). Em produto com variações, envie o ID da variação: o estoque do pai é a soma das variações. O e-mail sai uma vez só, quando o estoque volta, e pedir de novo depois do aviso reabre a inscrição.</Note>
<Warning>A loja pode ter desligado o e-mail "Produto voltou ao estoque". Nesse caso a rota responde `422` e o seu front deve esconder o botão de aviso.</Warning>



## OpenAPI

````yaml /openapi/storefront-catalog.yaml post /webstore/package/{package-id}/restock-notice
openapi: 3.1.0
info:
  title: CentralCart Storefront API (Catálogo)
  version: 1.0.0
  description: >-
    Produtos, categorias e posts do blog da loja. Nenhum destes endpoints exige
    autenticação. A loja é resolvida pelo header `x-store-domain`.
servers:
  - url: https://api.centralcart.io/v1
    description: Produção
security: []
paths:
  /webstore/package/{package-id}/restock-notice:
    post:
      tags:
        - Catalogo
      summary: Subscribe Restock Notice
      description: >-
        Inscreve um e-mail para ser avisado quando o produto voltar ao estoque.

        <Note>Só vale para produto esgotado (`stock.available` falso). Em
        produto com variações, envie o ID da variação: o estoque do pai é a soma
        das variações. O e-mail sai uma vez só, quando o estoque volta, e pedir
        de novo depois do aviso reabre a inscrição.</Note>

        <Warning>A loja pode ter desligado o e-mail "Produto voltou ao estoque".
        Nesse caso a rota responde `422` e o seu front deve esconder o botão de
        aviso.</Warning>
      operationId: subscribeWebstoreRestockNotice
      parameters:
        - $ref: '#/components/parameters/StoreDomain'
        - name: package-id
          in: path
          required: true
          description: ID do produto ou da variação esgotada.
          schema:
            type: integer
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - email
              properties:
                email:
                  type: string
                  format: email
                  description: E-mail que vai receber o aviso.
            example:
              email: cliente@exemplo.com
      responses:
        '202':
          description: >-
            Inscrição registrada. Inscrever o mesmo e-mail duas vezes também
            responde `202`.
          content:
            application/json:
              schema:
                type: object
                properties:
                  subscribed:
                    type: boolean
              example:
                subscribed: true
        '400':
          description: E-mail inválido
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                errors:
                  - message: Email inválido.
        '404':
          description: Produto não encontrado, desativado ou fora da vitrine
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                errors:
                  - message: Produto não encontrado.
        '422':
          description: >-
            Produto com variações, produto ainda disponível ou aviso desligado
            na loja
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                variation_parent:
                  summary: Produto com variações
                  value:
                    errors:
                      - message: Escolha uma variação.
                in_stock:
                  summary: Produto disponível
                  value:
                    errors:
                      - message: Este produto já está disponível.
                disabled:
                  summary: Aviso desligado na loja
                  value:
                    errors:
                      - message: Aviso de reposição indisponível nesta loja.
        '429':
          description: Muitas inscrições do mesmo IP em pouco tempo
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                errors:
                  - message: Tente novamente em instantes.
      security: []
components:
  parameters:
    StoreDomain:
      name: x-store-domain
      in: header
      required: true
      description: 'Domínio da sua loja (ex: sualoja.centralcart.ai)'
      schema:
        type: string
  schemas:
    Error:
      type: object
      properties:
        errors:
          type: array
          items:
            type: object
            properties:
              message:
                type: string
              code:
                type: string
              ref:
                type: string

````

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