Recursos da API

• Criar pedidos não é possível via API. Pedidos são gerados exclusivamente pelos compradores no storefront da Sellit. A API permite apenas leitura e atualização de status de envio e reembolso.
• Reembolso parcial não está disponível. O endpoint POST /orders/{id}/refund executa sempre um reembolso total. O status partial_refunded pode aparecer em pedidos reembolsados pelo gateway diretamente, mas não é acionável via API.

Só name e price são obrigatórios. O tipo (typeId) assume Físico e a categoria (categoryId) assume Outros por padrão — você não precisa enviar esses campos internos da Sellit.

curl -X POST https://app.sellitbr.com/api/v1/products \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Camiseta Premium",
    "description": "100% algodão",
    "price": 99.90,
    "quantity": 50,
    "weight": 0.3,
    "width": 30, "height": 2, "length": 40
  }'

price em reais. weight em kg e width/height/length em cm (usados no cálculo de frete). Defaults: typeId = 2 (Físico), categoryId = 23 (Outros). Tipos: 1=Digital, 2=Físico, 3=Digital/Físico.

Na Sellit, um produto tem variações (ex.: Tamanho × Cor), e cada variação (combinação, ex.: P - AZUL) tem SKU, preço e estoque próprios. Se a sua plataforma trata cada variação como um produto-filho (modelo de ERP/marketplace), o mapeamento é feito pelo sku: o lojista (ou você) define o SKU de cada variação, e você sincroniza por ele.

# 1) Liste as variações e veja o SKU/preço/estoque de cada uma
curl https://app.sellitbr.com/api/v1/products/PROD_ID/variants \
  -H "Authorization: Bearer SEU_TOKEN"

# resposta
{ "data": [
  { "id": "vc_1", "combination": "P - AZUL", "sku": "CAM-P-AZ", "price": 99.9, "quantity": 12 },
  { "id": "vc_2", "combination": "M - AZUL", "sku": "CAM-M-AZ", "price": 99.9, "quantity": 7 }
] }

# 2) Sincronize estoque de uma variação pelo SKU (caso típico de ERP)
curl -X PATCH https://app.sellitbr.com/api/v1/products/PROD_ID/variants/CAM-P-AZ/stock \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "quantity": 20 }'

Todos os erros retornam um objeto JSON com um campo error descrevendo o problema:

{ "error": "Pedido não encontrado." }

Códigos de status e seus significados: