> ## 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.

# API v2 do SULTS

> O que a API v2 do SULTS cobre hoje: os módulos de Compras, Comunicados, Chamados e Checklist, o token da gestão v2 e o que muda em relação à v1

export const Modulo = ({nome, href, icone, texto, situacao, metodos = []}) => <a className={"modulo-card" + (situacao === "Em migração" ? " modulo-card-migracao" : "")} href={href}>
    <span className="modulo-demo">
      <span className="modulo-icone" style={{
  backgroundImage: "url(/images/modulos/" + icone + ".svg)"
}} />
      {metodos.length > 0 && <span className="modulo-metodos">
          {metodos.map(([metodo, total]) => <span key={metodo} className={"modulo-metodo modulo-metodo-" + metodo.toLowerCase()}>
              {metodo} <b>{total}</b>
            </span>)}
        </span>}
    </span>
    <span className="modulo-corpo">
      <span className="modulo-nome">
        {nome}
        {situacao && <span className="modulo-situacao">{situacao}</span>}
      </span>
      <span className="modulo-texto">{texto}</span>
    </span>
  </a>;

export const Modulos = ({children}) => <div className="modulos-grade not-prose">{children}</div>;

<span className="badge-v2">API v2</span>

A v2 é a nova geração da API do SULTS. A migração acontece módulo a módulo, e o primeiro a chegar foi o de Compras.

<Note>
  Você está na documentação da **v2**. Os módulos que ainda não migraram continuam na [v1](/v1/introducao), que segue em produção e documentada por inteiro. Em dúvida, veja [Qual versão eu uso?](/geral/qual-versao-eu-uso).
</Note>

## O que já está disponível na API v2?

<Modulos>
  <Modulo nome="Compras" icone="compras" situacao="Disponível" href="/v2/api-reference/produtos/listar-produtos" metodos={[["GET", 11], ["POST", 2], ["PUT", 8], ["DEL", 1]]} texto="Produtos, preços, estoque, variações e variantes, mix de produtos, pedidos e etapas" />

  <Modulo nome="Comunicados" icone="comunicados" situacao="Disponível" href="/v2/api-reference/comunicados/listar-comunicados" metodos={[["GET", 3]]} texto="Comunicados publicados, o público de cada um com leitura e aceite, e o conteúdo com anexos" />

  <Modulo nome="Chamados" icone="chamados" situacao="Disponível" href="/v2/api-reference/chamados/listar-chamados" metodos={[["GET", 2], ["POST", 4], ["PUT", 2], ["DEL", 2]]} texto="Chamados com filtros de situação, direção e período, timeline, abertura, interações, apoios, etiquetas, prazo e conclusão" />

  <Modulo nome="Checklist" icone="checklist" situacao="Disponível" href="/v2/api-reference/checklist/listar-avaliacoes-de-checklist" metodos={[["GET", 9], ["POST", 1]]} texto="Avaliações com respostas, check-in e check-out, importação de avaliações, modelos com seções e questões, e planos de ação com a timeline" />

  <Modulo nome="Unidades" icone="unidades" situacao="Em migração" href="/v1/api-reference/unidades/listar-unidades" texto="Listar as unidades da rede e os colaboradores ativos" />

  <Modulo nome="Implantação" icone="implantacao" situacao="Em migração" href="/v1/api-reference/implantacao/listar-projetos-em-implantacao" texto="Listar projetos de implantação e as tarefas deles" />

  <Modulo nome="Projetos" icone="projetos" situacao="Em migração" href="/v1/api-reference/projetos/listar-projetos" texto="Listar projetos e as tarefas deles" />

  <Modulo nome="Expansão" icone="expansao" situacao="Em migração" href="/v1/api-reference/expansao/listar-negocios" texto="Listar negócios e a timeline, criar negócio" />
</Modulos>

São 45 endpoints, e a lista completa está na [Referência da API](/v2/api-reference/produtos/listar-produtos).

## O que muda da v1 para a v2?

Três diferenças aparecem já na primeira chamada:

**A base de URL é própria.** Os endpoints vivem em `https://api.sults.com.br/api/v2/`, com uma base por módulo (`/compras/`, `/comunicado/`, `/chamados/` e `/checklist/`) e caminhos padronizados por ação, como `/list`, `/add` e `/edit`.

**O token é outro.** A v2 usa a Gestão de Tokens v2, e o token é exibido uma única vez na criação. Tokens das duas versões não são intercambiáveis.

**A listagem não tem envelope.** A v1 devolve `data`, `start`, `limit` e `totalPage`. A v2 devolve o array direto e pagina por `page`.

Além disso, a v2 expõe o que a v1 nunca teve. Em Compras, preço e estoque em endpoints próprios e o fluxo de etapas de pedido. Em Chamados, interações, apoios, etiquetas e prazo, cada um com a sua chamada. Em Checklist, os modelos com seções e questões e a listagem de planos de ação com filtros.

## Sua jornada até a produção

<Steps>
  <Step title="Faça a primeira chamada">
    Gere o token da v2 e liste os produtos do catálogo em 5 minutos no [quickstart](/v2/quickstart).
  </Step>

  <Step title="Aprenda as convenções">
    Paginação por `page`, datas e formatos estão em [Convenções](/v2/convencoes).
  </Step>

  <Step title="Prepare a integração para falhas">
    Trate os erros desde o início, com o catálogo em [Erros](/v2/erros).
  </Step>

  <Step title="Monte o seu fluxo">
    Para manter o seu sistema atualizado, siga o padrão de varredura descrito em [Como manter os dados atualizados](/v2/convencoes#como-manter-os-dados-atualizados).
  </Step>
</Steps>

## Próximos passos

<CardGroup cols={2}>
  <Card title="Comece em 5 minutos" icon="rocket" href="/v2/quickstart">
    Do token à primeira resposta, com exemplos em cinco linguagens.
  </Card>

  <Card title="Referência da API" icon="code" href="/v2/api-reference/produtos/listar-produtos">
    Os 45 endpoints da v2, com playground para testar do navegador.
  </Card>
</CardGroup>


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