Atualizar preços de itens em uma tabela

Autenticação: envie Authorization: Bearer <chave da API pública do Sensio>. Use a chave da sua empresa no Sensio.

Atualiza somente o campo price de 1 a 100 linhas que já pertencem à tabela de preços. A empresa é identificada pela chave de API autenticada. Itens omitidos e os demais campos permanecem intactos.

Identifique cada linha pelo par itemId e variationId. Omitir variationId equivale a null e seleciona o item sem variação. A combinação não pode se repetir no lote. IDs inválidos são rejeitados. A operação não inclui itens novos e não permite alterar tabelas removidas.

O lote é aplicado por inteiro: se uma linha for inválida, nenhuma alteração do lote será gravada. Linhas duplicadas na tabela ou alterações em uma linha selecionada durante o processamento geram 409. Após um conflito, consulte os preços atuais antes de tentar novamente. Cada requisição é atômica de forma independente; divida mais de 100 alterações em chamadas separadas.

O preço deve ser um número JSON finito maior ou igual a zero. Quando a empresa utiliza campos extras de tabelas de preços, o novo preço deve ser estritamente maior que o priceMin existente. Margem, custo, promoções, preço mínimo e configuração de atualização automática são preservados. Se autoUpdate estiver ativo, operações futuras do sistema poderão recalcular o preço pela margem configurada.

updatedCount conta apenas preços que efetivamente mudaram. Reenviar preços iguais retorna zero e não gera novas alterações de histórico nem sincronizações. A resposta contém somente o resumo do lote.

Alterações são auditadas e acionam as integrações configuradas com Mercos e Mercado Livre. Falhas posteriores de sincronização não desfazem os preços gravados.

A rota utiliza a autenticação e os limites de consumo existentes da API pública. O limite atual é de 25 requisições por minuto por empresa.

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros de Caminho

Parâmetros Header

Parâmetros Bodyapplication/jsonObrigatório

Examples

Atualizar um item sem variaçãoAtualizar um item e uma variação no mesmo lote

{
    "items": [
        {
            "itemId": "507f1f77bcf86cd799439011",
            "variationId": null,
            "price": 129.9
        }
    ]
}

Códigos de solicitação

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Respostas

🟢200OK

application/json

Lote aplicado. updatedCount informa quantas linhas tiveram o preço alterado; zero indica que os preços enviados já eram os atuais.

Bodyapplication/json

Examples

Dois preços alteradosPreços já estavam atualizados

{
    "success": true,
    "response": {
        "_id": "507f1f77bcf86cd799439010",
        "updatedCount": 2
    }
}

🟠400Pedido Inválido

🟠402

🟠403Proibido

🟠404Registo Não Encontrado

🟠409

🟠429

🔴500Erro do Servidor