← Voltar para documentação

API Portal Seller Peixoto

Referência completa dos endpoints REST para integração.

Autenticação — OAuth 2.0 Client Credentials

Todas as chamadas exigem um access_token obtido via OAuth 2.0.

Sandbox

POST https://esbtst.peixoto.com.br/sgi-api/oauth/token

Produção

POST https://esb.peixoto.com.br/sgi-api/oauth/token

Exemplo

curl -X POST "https://esbtst.peixoto.com.br/sgi-api/oauth/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=seller_1042_hml_a1b2c3d4e5" \
  -d "client_secret=SEU_CLIENT_SECRET_HML"

Resposta

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "bearer",
  "expires_in": 86399,
  "scope": "read write",
  "codigoSeller": 1042,
  "ambiente": "HML"
}

Produtos

Cadastrar ou atualizar

POST /portal-seller/produtos/salvar/{codigoSeller}/{codigoUsuario}
curl -X POST "https://esbtst.peixoto.com.br/portal-seller/produtos/salvar/1042/1042" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "codigoProdutoSeller": "SKU-1001",
    "descricao": "DETERGENTE NEUTRO 500ML",
    "codigoNcmBase": "3402.20.00",
    "codigoBarrasEAN": "7891234567890",
    "codigoMarca": 15,
    "codigoMercadoria": 100,
    "codigoDepartamento": 5,
    "codigoCategoria": 12,
    "peso": 0.500,
    "altura": 20.00,
    "largura": 10.00,
    "comprimento": 10.00,
    "prazoValidade": 365,
    "quantidadeMinimaFracionada": 1
  }'

Consultar catálogo

GET /portal-seller/produtos/buscar?codigoPessoaSeller={codigoSeller}

Estoque

Atualizar quantidade

PUT /portal-seller/estoques/atualizar/{codigoProdutoPeixoto}/{quantidadeEstoque}
curl -X PUT "https://esbtst.peixoto.com.br/portal-seller/estoques/atualizar/998811/150" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json"

Consultar estoques

GET /portal-seller/estoques/buscar?codigoFornecedorSeller={codigoSeller}

Preços

Cadastrar ou atualizar

POST /portal-seller/precos/salvar
curl -X POST "https://esbtst.peixoto.com.br/portal-seller/precos/salvar" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "produto": { "codigo": 998811 },
    "estado": { "codigo": 13 },
    "valorPrecoBase": 49.90,
    "dataInicio": "2026-09-01T00:00:00.000Z",
    "dataFim": "2026-12-31T23:59:59.000Z"
  }'

Consultar

GET /portal-seller/precos/buscar?codigoSeller={codigoSeller}

Prazos de entrega

Cadastrar ou atualizar

POST /portal-seller/prazos/salvar/{codigoSeller}
curl -X POST "https://esbtst.peixoto.com.br/portal-seller/prazos/salvar/1042" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "estado": { "codigo": 13 },
    "cepInicio": "38400000",
    "cepFim": "38400999",
    "quantidadeDiasEntrega": 3,
    "dataInicio": "2026-08-25T00:00:00.000Z"
  }'

Consultar

GET /portal-seller/prazos/buscar?codigoSeller={codigoSeller}

Pedido mínimo

Cadastrar ou atualizar

POST /portal-seller/pedidoMinimo/salvar
curl -X POST "https://esbtst.peixoto.com.br/portal-seller/pedidoMinimo/salvar" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "id": {
      "fornecedor": { "codigoPessoa": 1042 },
      "estado": { "codigo": 13 }
    },
    "valor": 1500.00
  }'

Consultar

GET /portal-seller/pedidoMinimo/buscar?codigoSeller={codigoSeller}

Pedidos e faturamento

Registrar rastreio / status

POST /portal-seller/pedidos/registrarRastreio
curl -X POST "https://esbtst.peixoto.com.br/portal-seller/pedidos/registrarRastreio" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "numeroPedido": 554433,
    "codigoStatus": 3,
    "codigoRastreamento": "BR123456789XX",
    "nomeTransportadora": "LOGGI",
    "urlRastreamento": "https://rastreio.loggi.com/BR123456789XX"
  }'

Cancelar pedido

POST /portal-seller/pedidos/cancelarPedido
curl -X POST "https://esbtst.peixoto.com.br/portal-seller/pedidos/cancelarPedido" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "numeroPedido": 554433,
    "codigoMotivoCancelamento": 2,
    "observacao": "Item sem estoque no momento"
  }'

Consultar pedido

GET /portal-seller/pedidos/buscarPedidoPorCodigo/{numeroPedido}