<!-- Generated from https://developers.superfrete.com/openapi.yaml (operationId: getServicesInfo). -->

# Consultar regras dos serviços

> `GET /api/v0/services/info` · Referência interativa: https://developers.superfrete.com/referencia#getServicesInfo

- **Method:** `GET`
- **Path:** `/api/v0/services/info`
- **Operation ID:** `getServicesInfo`
- **Tags:** Frete

Devolve as regras de cada serviço disponível para a conta, indexadas pelo código do serviço: `1` PAC, `2` SEDEX, `17` Mini Envios, `3` Jadlog e `31` Loggi. O `33` (J\&T) só aparece quando a J\&T está liberada para a conta.

Para os Correios, `restrictions` traz os limites de seguro (`insurance_value`, em reais) e da caixa (`formats.package`: peso em kg, largura, altura e comprimento em cm, e `sum`, a soma máxima dos lados). `requirements` lista os dados obrigatórios da etiqueta e `optionals` os serviços adicionais aceitos: `AR` (aviso de recebimento), `MP` (mão própria) e `VD` (valor declarado).

Para Jadlog, Loggi e J\&T, `restrictions` vem vazio. Os limites dessas transportadoras estão em [Cotar frete](https://developers.superfrete.com/referencia/md/calculateShipping.md).

## Effective servers

- `https://sandbox.superfrete.com`

  Sandbox (testes, etiquetas sem validade)
- `https://api.superfrete.com`

  Produção

## Authentication

- **bearerAuth**: HTTP bearer (`JWT`)

  Token de acesso da SuperFrete, no header `Authorization: Bearer {token}`.
  - **Integração da própria loja:** gere o token no painel, em **Integrações** ([produção](https://web.superfrete.com/#/integrations) ou [sandbox](https://sandbox.superfrete.com/#/integrations)).
  - **Plataforma que conecta várias contas:** obtenha um token por seller com o fluxo OAuth 2.0 ([`exchangeOAuthToken`](https://developers.superfrete.com/referencia/md/exchangeOAuthToken.md)).

  O token não expira e dá acesso a todas as rotas da API para a conta; não há escopos. Ele deixa de valer quando a integração é removida no painel. O token de sandbox só funciona no sandbox, e o de produção só em produção.

## Header parameters

- **`User-Agent` (required)**: `string`

  Nome da sua aplicação com um e-mail de contato técnico, no formato `Aplicação (email@exemplo.com)`. Hoje só [Listar pedidos](https://developers.superfrete.com/referencia/md/listOrders.md) recusa um valor fora desse formato, mas envie em todas as rotas.

  **Example:**

  ```json
  "MinhaLoja (dev@minhaloja.com.br)"
  ```

## Responses

### 200 Regras de cada serviço, indexadas pelo código.

**Content type:** `application/json`

`object`

**Additional properties:**

schema: `ServiceInfo`

- **`company`**: `object`
  - **`name`**: `string`
  - **`picture`**: `string`
- **`name`**: `string`
- **`optionals`**: `array`

  `AR` aviso de recebimento · `MP` mão própria · `VD` valor declarado. Só nos Correios.

  **Items:**

  `string`, possible values: `"AR", "MP", "VD"`
- **`range`**: `string`

  Abrangência. Sempre `interstate` (envios nacionais).
- **`requirements`**: `array`

  Dados obrigatórios na etiqueta. Só nos Correios.

  **Items:**

  `string`, possible values: `"names", "addresses"`
- **`restrictions`**: `object`

  Limites do serviço. Vazio para Jadlog, Loggi e J\&T.
  - **`formats`**: `object`
    - **`package`**: `object`
      - **`height`**: `object`, schema: `MinMax`
        - **`max`**: `number`
        - **`min`**: `number`
      - **`length`**: `object`, schema: `MinMax`

        *Schema `MinMax` is shown above.*
      - **`sum`**: `number`

        Soma máxima de altura, largura e comprimento, em cm.
      - **`weight`**: `object`, schema: `MinMax`

        *Schema `MinMax` is shown above.*
      - **`width`**: `object`, schema: `MinMax`

        *Schema `MinMax` is shown above.*
  - **`insurance_value`**: `object`, schema: `MinMax`

    *Schema `MinMax` is shown above.*
- **`type`**: `string`

**Example:**

```json
{
  "1": {
    "name": "PAC",
    "type": "express",
    "range": "interstate",
    "restrictions": {
      "insurance_value": {
        "min": 25.63,
        "max": 38057.59
      },
      "formats": {
        "package": {
          "weight": {
            "min": 0.3,
            "max": 30
          },
          "width": {
            "min": 16,
            "max": 150
          },
          "height": {
            "min": 4,
            "max": 150
          },
          "length": {
            "min": 24,
            "max": 150
          },
          "sum": 200
        }
      }
    },
    "requirements": [
      "names",
      "addresses"
    ],
    "optionals": [
      "AR",
      "MP",
      "VD"
    ],
    "company": {
      "name": "Correios",
      "picture": "https://firebasestorage.googleapis.com/v0/b/freight-calculator-8d6c1.appspot.com/o/images%2Ftransporters%2Flogo-correios-transporter.png?alt=media&token=8b0aa041-d5c6-4a46-9f06-d9b7e38e26d4"
    }
  },
  "2": {
    "name": "SEDEX",
    "type": "express",
    "range": "interstate",
    "restrictions": {
      "insurance_value": {
        "min": 25.63,
        "max": 38057.59
      },
      "formats": {
        "package": {
          "weight": {
            "min": 0.3,
            "max": 30
          },
          "width": {
            "min": 16,
            "max": 150
          },
          "height": {
            "min": 4,
            "max": 150
          },
          "length": {
            "min": 24,
            "max": 150
          },
          "sum": 200
        }
      }
    },
    "requirements": [
      "names",
      "addresses"
    ],
    "optionals": [
      "AR",
      "MP",
      "VD"
    ],
    "company": {
      "name": "Correios",
      "picture": "https://firebasestorage.googleapis.com/v0/b/freight-calculator-8d6c1.appspot.com/o/images%2Ftransporters%2Flogo-correios-transporter.png?alt=media&token=8b0aa041-d5c6-4a46-9f06-d9b7e38e26d4"
    }
  },
  "3": {
    "name": "Jadlog",
    "type": "express",
    "range": "interstate",
    "restrictions": {},
    "company": {
      "name": "Jadlog",
      "picture": "https://firebasestorage.googleapis.com/v0/b/freight-calculator-8d6c1.appspot.com/o/images%2Ftransporters%2Flogo-jadlog-transporter.png?alt=media&token=491fb210-ff10-4821-9c12-564f032ace8c"
    }
  },
  "17": {
    "name": "MiniEnvios",
    "type": "express",
    "range": "interstate",
    "restrictions": {
      "insurance_value": {
        "min": 12.25,
        "max": 104.62
      },
      "formats": {
        "package": {
          "weight": {
            "min": 0.0001,
            "max": 0.3
          },
          "width": {
            "min": 10,
            "max": 16
          },
          "height": {
            "min": 1,
            "max": 4
          },
          "length": {
            "min": 15,
            "max": 24
          },
          "sum": 200
        }
      }
    },
    "requirements": [
      "names",
      "addresses"
    ],
    "optionals": [
      "AR",
      "MP",
      "VD"
    ],
    "company": {
      "name": "Correios",
      "picture": "https://firebasestorage.googleapis.com/v0/b/freight-calculator-8d6c1.appspot.com/o/images%2Ftransporters%2Flogo-correios-transporter.png?alt=media&token=8b0aa041-d5c6-4a46-9f06-d9b7e38e26d4"
    }
  },
  "31": {
    "name": "Loggi",
    "type": "express",
    "range": "interstate",
    "restrictions": {},
    "company": {
      "name": "Loggi",
      "picture": "https://firebasestorage.googleapis.com/v0/b/freight-calculator-8d6c1.appspot.com/o/images%2Ftransporters%2Flogo-loggi-transporter.png?alt=media&token=a508ac0d-f191-413c-b3b1-e4a23b06c78e"
    }
  }
}
```

### 401 Token ausente, inválido, removido ou de outro ambiente.

**Content type:** `application/json`

schema: `Error`

Erro de regra de negócio ou de autenticação. `message` e `error` trazem o mesmo texto.

- **`error` (required)**: `string`

  Mesmo conteúdo de `message`, mantido por compatibilidade.
- **`message` (required)**: `string`

  Mensagem legível do erro.

**Example:**

```json
{
  "message": "Token inválida!",
  "error": "Token inválida!"
}
```

### 500 Erro interno. O corpo pode ser um objeto de erro ou só um texto JSON com a mensagem.

**Content type:** `application/json`

**One of:**

- *Schema `Error` is shown above.*
- `string`

**Example:**

```json
{
  "message": "",
  "error": ""
}
```

## Schemas

- `Error` — shown above.
- `ServiceInfo` — shown above.
- `MinMax` — shown above.