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

# Criar chamado na API v2 do SULTS

> Abre um chamado em nome de um solicitante, com a mensagem inicial em HTML. A direção define quem abre e quem atende: entre administradores (`ADMIN_TO_ADMIN`), da unidade para a administradora (`COMPANY_TO_ADMIN`) ou da administradora para a unidade (`ADMIN_TO_COMPANY`). Responsável, departamentos, assunto, unidade e prazo são opcionais. A resposta traz o código do chamado criado.



## OpenAPI

````yaml /api-reference/openapi-v2.json post /api/v2/chamados/ticket/add
openapi: 3.1.0
info:
  title: API do SULTS v2
  version: '2.0'
  description: >-
    A nova geração da API do SULTS, em migração módulo a módulo (Compras
    primeiro). Autenticação por token v2 no cabeçalho `Authorization`; tokens v1
    não funcionam aqui. Nas requisições com corpo, envie `Content-Type:
    application/json;charset=UTF-8`.
  contact:
    name: Suporte SULTS
    url: https://ajuda.sults.com.br
servers:
  - url: https://api.sults.com.br
security:
  - apiKeyAuth: []
tags:
  - name: Produtos
    description: >-
      Cadastro, preço, estoque, variações e variantes de produto no módulo de
      Compras da v2. A API do SULTS é REST sobre HTTPS e responde em JSON. Cada
      requisição leva o token no cabeçalho `Authorization`, enviado puro, sem o
      prefixo `Bearer`. O token é gerado por um administrador na plataforma, em
      Segurança > API > Gestão de Tokens v2. O limite é de 2 requisições por
      segundo, por IP.
  - name: Mix de produtos
    description: >-
      Sortimento de produtos por empresa. Disponível apenas quando o recurso de
      mix está habilitado na plataforma, em Comercial > Configuração > Mix de
      produto. A API do SULTS é REST sobre HTTPS e responde em JSON. Cada
      requisição leva o token no cabeçalho `Authorization`, enviado puro, sem o
      prefixo `Bearer`. O token é gerado por um administrador na plataforma, em
      Segurança > API > Gestão de Tokens v2. O limite é de 2 requisições por
      segundo, por IP.
  - name: Pedidos e etapas
    description: >-
      Pedidos de compra da v2 e o fluxo de etapas, que é configurável por
      operação. A API do SULTS é REST sobre HTTPS e responde em JSON. Cada
      requisição leva o token no cabeçalho `Authorization`, enviado puro, sem o
      prefixo `Bearer`. O token é gerado por um administrador na plataforma, em
      Segurança > API > Gestão de Tokens v2. O limite é de 2 requisições por
      segundo, por IP.
  - name: Comunicados
    description: >-
      Comunicados publicados na plataforma, com o público de cada um, a
      confirmação de leitura e o conteúdo publicado. A API do SULTS é REST sobre
      HTTPS e responde em JSON. Cada requisição leva o token no cabeçalho
      `Authorization`, enviado puro, sem o prefixo `Bearer`. O token é gerado
      por um administrador na plataforma, em Segurança > API > Gestão de Tokens
      v2. O limite é de 2 requisições por segundo, por IP.
  - name: Chamados
    description: >-
      Chamados da plataforma: abertura, timeline, interações, apoios, etiquetas,
      prazo e conclusão. A API do SULTS é REST sobre HTTPS e responde em JSON.
      Cada requisição leva o token no cabeçalho `Authorization`, enviado puro,
      sem o prefixo `Bearer`. O token é gerado por um administrador na
      plataforma, em Segurança > API > Gestão de Tokens v2. O limite é de 2
      requisições por segundo, por IP.
  - name: Checklist
    description: >-
      Avaliações de checklist com respostas, check-in e check-out, os modelos
      com seções e questões, e os planos de ação com a timeline. A API do SULTS
      é REST sobre HTTPS e responde em JSON. Cada requisição leva o token no
      cabeçalho `Authorization`, enviado puro, sem o prefixo `Bearer`. O token é
      gerado por um administrador na plataforma, em Segurança > API > Gestão de
      Tokens v2. O limite é de 2 requisições por segundo, por IP.
paths:
  /api/v2/chamados/ticket/add:
    post:
      tags:
        - Chamados
      summary: Criar chamado
      description: >-
        Abre um chamado em nome de um solicitante, com a mensagem inicial em
        HTML. A direção define quem abre e quem atende: entre administradores
        (`ADMIN_TO_ADMIN`), da unidade para a administradora
        (`COMPANY_TO_ADMIN`) ou da administradora para a unidade
        (`ADMIN_TO_COMPANY`). Responsável, departamentos, assunto, unidade e
        prazo são opcionais. A resposta traz o código do chamado criado.
      operationId: criarChamadoV2
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ChamadoV2Criacao'
            example:
              requesterUserId: 63
              subject: Forno combinado sem aquecer
              direction: COMPANY_TO_ADMIN
              companyId: 12
              messageHtml: >-
                <p>O forno da cozinha não passa de 80 graus desde a manhã de
                hoje.</p>
              assigneeUserId: 55
              inboundDepartmentId: 4
              categoryId: 23
              dueDate: '2026-10-07T21:00:00Z'
      responses:
        '200':
          description: Chamado criado.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IdRespostaV2'
              example:
                id: 4127
        '400':
          $ref: '#/components/responses/ErroValidacao'
        '401':
          $ref: '#/components/responses/TokenInvalido'
        '404':
          $ref: '#/components/responses/NaoEncontrado'
        '429':
          $ref: '#/components/responses/LimiteDeRequisicoes'
        5XX:
          $ref: '#/components/responses/ErroDoServidor'
components:
  schemas:
    ChamadoV2Criacao:
      type: object
      description: Dados para abrir um chamado.
      required:
        - requesterUserId
        - subject
        - direction
        - messageHtml
      properties:
        requesterUserId:
          type: integer
          description: Código do usuário solicitante.
          example: 63
        subject:
          type: string
          description: Título do chamado.
          example: Forno combinado sem aquecer
        direction:
          $ref: '#/components/schemas/DirecaoChamadoV2'
          description: Direção do chamado.
        messageHtml:
          type: string
          description: Mensagem inicial do chamado, em HTML.
          example: >-
            <p>O forno da cozinha não passa de 80 graus desde a manhã de
            hoje.</p>
        assigneeUserId:
          type: integer
          description: Código do usuário responsável.
          example: 55
        inboundDepartmentId:
          type: integer
          description: Código do departamento de destino.
          example: 4
        outboundDepartmentId:
          type: integer
          description: Código do departamento de envio.
          example: 7
        categoryId:
          type: integer
          description: Código do assunto.
          example: 23
        companyId:
          type: integer
          description: Código da unidade.
          example: 12
        dueDate:
          type: string
          format: date-time
          description: Prazo do chamado, em UTC ISO 8601.
          example: '2026-10-07T21:00:00Z'
    IdRespostaV2:
      type: object
      properties:
        id:
          type: integer
          description: Código do registro criado.
          example: 1
    DirecaoChamadoV2:
      type: string
      enum:
        - ADMIN_TO_ADMIN
        - COMPANY_TO_ADMIN
        - ADMIN_TO_COMPANY
      description: |-
        Direção do chamado: quem abre e quem atende.

        | Valor | Significado |
        | ----- | ----------- |
        | `ADMIN_TO_ADMIN` | Administrador para administrador |
        | `COMPANY_TO_ADMIN` | Unidade para administrador |
        | `ADMIN_TO_COMPANY` | Administrador para unidade |
      example: COMPANY_TO_ADMIN
    Erro:
      type: object
      description: >-
        Corpo padrão de erro da API. Não existe código de erro interno: decida a
        sua lógica pelo status HTTP e use a mensagem apenas para logs e
        diagnóstico.
      required:
        - error
      properties:
        error:
          type: string
          description: >-
            Mensagem legível, em português, descrevendo a falha. O texto pode
            mudar: nunca o use como condição de código.
          example: Campo supplierId não pode ser vazio ou nulo.
  responses:
    ErroValidacao:
      description: >-
        Erro de validação ou formato errado nos dados de entrada. A API aponta
        **um campo por vez**: corrija o campo indicado na mensagem, reenvie e
        repita até o 200.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Erro'
          example:
            error: Campo supplierId não pode ser vazio ou nulo.
    TokenInvalido:
      description: >-
        Token ausente ou inválido. Confira: copiado por completo, cabeçalho
        `Authorization` com o nome exato, valor sem o prefixo `Bearer` e gerado
        na **Gestão de Tokens v2** (tokens v1 não funcionam aqui). Sem retry
        automático. O corpo real é `{"error": "Acesso não autorizado."}`.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Erro'
          example:
            error: Acesso não autorizado.
    NaoEncontrado:
      description: >-
        Recurso inexistente, ou recurso condicionado desabilitado (por exemplo,
        endpoints de Mix sem o recurso de mix habilitado na operação). Reenviar
        sem corrigir devolve o mesmo erro.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Erro'
    LimiteDeRequisicoes:
      description: >-
        Limite de requisições excedido: **2 requisições por segundo, por IP**. A
        resposta é a página HTML padrão do servidor, não JSON, e não há o header
        `Retry-After`: trate pelo status 429, sem fazer parse do corpo, com
        espera crescente a partir de 1 segundo.
      content:
        text/html:
          schema:
            type: string
            description: >-
              Página HTML padrão do servidor. Não faça parse; decida pelo
              status.
    ErroDoServidor:
      description: >-
        Falha inesperada do servidor (raro). Repita com espera crescente;
        persistindo, acione o suporte com data, hora e endpoint.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Erro'
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        Token  gerado na Gestão de Tokens v2 do SULTS. Deve ser enviado no
        cabeçalho `Authorization` de todas as requisições.

````

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