Asellere/API de Frete — Parceiros

API de Frete para Parceiros

Integre cotações de frete da plataforma Asellere diretamente ao seu sistema. A API retorna opções de envio com prazo e preço para qualquer SKU cadastrado, usando os mesmos cálculos aplicados aos marketplaces.

Autenticado por API Key

Resposta em tempo real

Suporte a múltiplos SKUs

Prazo + preço por transportadora

Autenticação

Todas as requisições devem incluir sua API key no header Authorization. Solicite sua chave ao time Asellere — ela será exibida uma única vez no momento da criação.

Authorization: ApiKey asellere_a1b2c3d4e5f6...

Importante: Nunca exponha sua API key em código frontend ou repositórios públicos. Armazene-a em variáveis de ambiente ou cofre de segredos (ex: AWS Secrets Manager, Vault).

Endpoint

POSThttps://api.frmarketplace.com.br/api/v1/shipping/partner/quote

Content-Type: application/json

Request Body

Campo	Tipo	Obrigatório	Descrição
destinationZip	string	sim	CEP de destino (somente dígitos, 8 caracteres)
items	array	sim	Lista de itens para cotação (mínimo 1)
└ items[].sku	string	sim	SKU do produto cadastrado na plataforma
└ items[].quantity	integer	não	Quantidade (padrão: 1)

{
  "destinationZip": "01310100",
  "items": [
    { "sku": "PROD-ABC-123", "quantity": 2 },
    { "sku": "PROD-XYZ-456", "quantity": 1 }
  ]
}

Response — Sucesso 200 OK

Campo	Tipo	Descrição
quotes	array	Lista de opções de frete disponíveis
└ serviceCode	string	Código interno do serviço de entrega
└ serviceName	string	Nome do serviço (ex: "SEDEX", "PAC")
└ carrier	string	Nome da transportadora
└ priceBrl	number	Valor do frete em Reais (BRL)
└ deliveryDays	integer	Prazo estimado em dias úteis
error	string \| null	Mensagem de erro, se nenhuma cotação estiver disponível

{
  "quotes": [
    {
      "serviceCode": "SEDEX",
      "serviceName": "SEDEX",
      "carrier": "Correios",
      "priceBrl": 32.90,
      "deliveryDays": 3
    },
    {
      "serviceCode": "PAC",
      "serviceName": "PAC",
      "carrier": "Correios",
      "priceBrl": 18.50,
      "deliveryDays": 7
    }
  ],
  "error": null
}

Códigos de Erro

HTTP	Causa	Solução
401	API key ausente ou inválida	Verifique o header `Authorization: ApiKey ...`
401	API key expirada ou revogada	Solicite uma nova chave ao time Asellere
400	CEP inválido ou itens ausentes	Verifique o formato do CEP (8 dígitos) e a lista de items
404	SKU não encontrado na plataforma	Confirme que o SKU está ativo e cadastrado
503	Serviço de cotação indisponível	Tente novamente em alguns instantes

Formato do body de erro:

{ "error": "API key inválida ou expirada" }

Exemplos de Integração

cURL

curl -X POST https://api.frmarketplace.com.br/api/v1/shipping/partner/quote \
  -H "Authorization: ApiKey asellere_SEU_TOKEN_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "destinationZip": "01310100",
    "items": [{ "sku": "PROD-ABC-123", "quantity": 1 }]
  }'

JavaScript / Node.js

const response = await fetch(
  'https://api.frmarketplace.com.br/api/v1/shipping/partner/quote',
  {
    method: 'POST',
    headers: {
      'Authorization': 'ApiKey ' + process.env.ASELLERE_API_KEY,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      destinationZip: '01310100',
      items: [{ sku: 'PROD-ABC-123', quantity: 1 }],
    }),
  }
);

const data = await response.json();
// data.quotes[0].priceBrl, data.quotes[0].deliveryDays ...

Python

import os, requests

response = requests.post(
    'https://api.frmarketplace.com.br/api/v1/shipping/partner/quote',
    headers={
        'Authorization': 'ApiKey ' + os.environ['ASELLERE_API_KEY'],
        'Content-Type': 'application/json',
    },
    json={
        'destinationZip': '01310100',
        'items': [{'sku': 'PROD-ABC-123', 'quantity': 1}],
    },
)

data = response.json()
for quote in data['quotes']:
    print(f"{quote['carrier']} — R$ {quote['priceBrl']} / {quote['deliveryDays']} dias")

Limites e SLA

Itens por requisição

Até 10 SKUs

por chamada

Timeout recomendado

1 segundo

por requisição

Disponibilidade alvo

99,9%

mensal

frmarketplace@frmarketplace.com.br