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

# Cria calendário pré-populado com feriados nacionais (5 anos) do catálogo central. Se uf for informada, adiciona feriados estaduais daquela UF.



## OpenAPI

````yaml https://api.pre.pontua.tech/api/public/doc-json post /calendarios/from-template
openapi: 3.0.0
info:
  title: Pontua Public API
  description: >-
    API oficial da Pontua para integrações de clientes externos. Autentique com
    o token gerado no dashboard em **Configurações → API**. Envie o token no
    header `Authorization: Bearer <SEU_TOKEN>`.
  version: '1.0'
  contact: {}
servers: []
security: []
tags: []
paths:
  /calendarios/from-template:
    post:
      tags:
        - Calendário
      summary: >-
        Cria calendário pré-populado com feriados nacionais (5 anos) do catálogo
        central. Se uf for informada, adiciona feriados estaduais daquela UF.
      operationId: CalendariosController_CriarCalendarioFromTemplate
      parameters: []
      requestBody:
        required: true
        description: Nome do calendário e UF opcional (sigla 2 letras)
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CriarCalendarioFromTemplateDto'
      responses:
        '201':
          description: Calendário criado e populado com sucesso
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CalendarioDto'
        default:
          description: "\n\t\t\t400 - Bad Request: A solicitação não está no formato correto.\n\t\t\t401 - Unauthorized: A solicitação não foi autorizada. Verifique se o token de acesso é válido.\n\t\t\t403 - Forbidden: Acesso proibido! Requer um nível de permissão mais elevado.\n\t\t\t404 - Not Found: O recurso solicitado não foi encontrado.\n\t\t\t500 - Internal Server Error: Erro de execução no servidor!\n\t\t\t"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDto'
      deprecated: false
      security:
        - bearer: []
components:
  schemas:
    CriarCalendarioFromTemplateDto:
      type: object
      properties:
        descricao:
          type: string
          description: Nome do calendário (3 a 150 caracteres)
          example: Calendário Goiânia
        uf:
          type: string
          description: >-
            Sigla da UF (2 letras maiúsculas) pra adicionar feriados estaduais
            ao calendário. Omitir pra criar só com feriados nacionais.
          example: GO
        cidade:
          type: string
          description: >-
            Nome da cidade — usado apenas pra log/audit; backend não filtra por
            cidade no catálogo (filtro municipal usa `codigoIbge`).
          example: Goiânia
        codigoIbge:
          type: number
          description: >-
            Código IBGE de 7 dígitos da capital, pra incluir feriados MUNICIPAIS
            no calendário. Aceito apenas pras 27 capitais brasileiras (única
            cobertura do free tier FeriadosAPI). Backend valida silenciosamente
            — se IBGE não bate com nenhum registro `scope=MUNICIPAL` no
            catálogo, calendário criado sem municipais (não erro).
          example: 5208707
      required:
        - descricao
    CalendarioDto:
      type: object
      properties:
        calendarioId:
          type: string
          description: Identificador do calendário
          example: f8e0a0f5-4f4d-4b4f-9f8d-8f4d4f4d4f4d
        descricao:
          type: string
          description: Nome do calendário
          example: Calendário Unidade Goiânia
        colaboradores:
          type: number
          description: Número de colaboradores vinculados
          example: 7
      required:
        - calendarioId
        - descricao
        - colaboradores
    ErrorDto:
      type: object
      properties:
        service:
          type: string
          description: Rota solicitada
        method:
          type: string
          description: Método http
        message:
          description: Mensagem do erro
          oneOf:
            - type: string
              example: message erro
            - type: array
              items:
                type: string
                example:
                  - erro 1
                  - erro 2
      required:
        - service
        - method
        - message

````