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

# Criar produto



## OpenAPI

````yaml POST /product
openapi: 3.0.0
info:
  title: payera-api
  description: Documentação de endpoints e entidades da payera
  version: '1.0'
  contact: {}
servers:
  - url: https://api.rivoopay.com
security:
  - ApiKeyAuth: []
paths:
  /product:
    post:
      tags:
        - Product
      summary: Create a Product
      operationId: ProductController_createProduct
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateProductDTOWithoutCompanyId'
      responses:
        '201':
          description: Product created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductDTO'
components:
  schemas:
    CreateProductDTOWithoutCompanyId:
      type: object
      properties:
        name:
          type: string
          description: Product name
          example: Produto Bola
          maxLength: 255
        description:
          type: string
          description: Product description
          example: Produto muito bom para uso diário
        price:
          type: number
          description: Product price in cents (centavos)
          example: 1990
          minimum: 0
        sku:
          type: string
          description: Stock Keeping Unit - unique identifier for inventory management
          example: SKU-ABCD-123
          nullable: true
        imageUrl:
          type: string
          description: URL of the product image
          example: https://example.com/image.png
          format: uri
          nullable: true
        categories:
          type: array
          description: Product categories
          example:
            - Eletronicos e Tecnologia
            - Celulares e Smartphones
          items:
            type: string
            enum:
              - Jogos
              - Eletrônicos
              - Roupas
              - Acessórios
              - Casa e Decoração
              - Esportes
              - Brinquedos
              - UGC
              - Cursos
              - Serviços
              - Livros
              - E-books
              - Música
              - Filmes e Séries
              - Alimentos e Bebidas
              - SaaS
              - Outros
        needShipping:
          type: boolean
          description: Indicates if the product requires shipping
          example: false
          default: false
        status:
          type: string
          description: Product status
          example: ACTIVE
          enum:
            - ACTIVE
            - INACTIVE
          default: ACTIVE
        marketplaceStatus:
          type: string
          description: Marketplace status
          example: INACTIVE
          enum:
            - APPROVED
            - ANALYSIS
            - DECLINED
            - INACTIVE
          default: INACTIVE
        type:
          type: string
          enum:
            - ONE_TIME
            - RECURRING
        frequency:
          type: string
          enum:
            - WEEKLY
            - MONTHLY
            - SEMIANNUAL
            - ANNUAL
          description: Obrigatório quando type=RECURRING
        dayDue:
          type: number
          description: >-
            Prazo de pagamento em dias após a geração (1-7). Obrigatório quando
            RECURRING
          minimum: 1
          maximum: 7
        dayGenerateCharge:
          type: number
          description: Dia de geração da cobr (1-27). Obrigatório quando RECURRING
          minimum: 1
          maximum: 27
        pixAutomaticJourney:
          type: string
          enum:
            - ONLY_RECURRENCY
            - PAYMENT_ON_APPROVAL
        pixAutomaticRetryPolicy:
          type: string
          enum:
            - NON_PERMITED
            - THREE_RETRIES_7_DAYS
      required:
        - name
        - description
        - price
    ProductDTO:
      type: object
      properties:
        id:
          type: string
          description: Product identifier
          example: prod_01F4Z8Z5Y6X7W8V9U0T1S2R3Q4
          maxLength: 255
        name:
          type: string
          description: Product name
          example: Produto Bola
          maxLength: 255
        description:
          type: string
          description: Product description
          example: Produto muito bom para uso diário
        price:
          type: number
          description: Product price in cents (centavos)
          example: 1990
          minimum: 0
        needShipping:
          type: boolean
          description: Indicates if the product requires shipping
          example: false
          default: false
        sku:
          type: string
          description: Stock Keeping Unit - unique identifier for inventory management
          example: SKU-ABCD-123
          nullable: true
        imageUrl:
          type: string
          description: URL of the product image
          example: https://example.com/image.png
          format: uri
          nullable: true
        categories:
          type: array
          description: Product categories
          example:
            - Eletronicos e Tecnologia
            - Celulares e Smartphones
          items:
            type: string
            enum:
              - Jogos
              - Eletrônicos
              - Roupas
              - Acessórios
              - Casa e Decoração
              - Esportes
              - Brinquedos
              - UGC
              - Cursos
              - Serviços
              - Livros
              - E-books
              - Música
              - Filmes e Séries
              - Alimentos e Bebidas
              - SaaS
              - Outros
        companyId:
          type: string
          description: Company ID that owns this product
          example: f96a489c-8a4d-4c7b-a1f6-347acbd832df
          format: uuid
        status:
          type: string
          description: Product status
          example: ACTIVE
          enum:
            - ACTIVE
            - INACTIVE
          default: ACTIVE
        marketplaceStatus:
          type: string
          description: Marketplace status
          example: INACTIVE
          enum:
            - APPROVED
            - ANALYSIS
            - DECLINED
            - INACTIVE
          default: INACTIVE
        type:
          type: string
          enum:
            - ONE_TIME
            - RECURRING
        frequency:
          type: string
          enum:
            - WEEKLY
            - MONTHLY
            - SEMIANNUAL
            - ANNUAL
          description: Obrigatório quando type=RECURRING
        dayDue:
          type: number
          description: Prazo de pagamento em dias após a geração (1-7)
          minimum: 1
          maximum: 7
        dayGenerateCharge:
          type: number
          description: Dia de geração da cobr (1-28)
          minimum: 1
          maximum: 28
      required:
        - id
        - name
        - description
        - price
        - needShipping
        - companyId
        - status
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY

````