A entidade Tabelas de Preço por Produto em Lote permite gerenciar o vínculo entre as Tabelas de Preço 🔗 e os Produtos 🔗 de múltiplos produtos com múltiplas tabelas de uma só vez no Mercos.
Um vínculo representa o preço de um produto em determinada tabela de preço. Cada produto pode ter um preço diferente para cada tabela de preço cadastrada. Esse endpoint permite que, na mesma requisição, sejam associados, alterados ou excluídos diversos vínculos de produtos com tabelas de preço.
Para alterar a tabela de preço padrão de um produto utilize o valor 0 para o campo tabela_id. Neste caso, como a alteração será realizada diretamente no produto, o valor do campo id na resposta da requisição será null (pois este campo se refere ao id do vínculo entre produto e tabela de preço, que não existe neste caso).
Como as tabelas do tipo Acréscimo e Desconto são calculadas automaticamente em cima dos produtos, apenas tabelas de preço do tipo Livre podem ser vinculadas a um produto. Caso seja enviado o ID de uma tabela de preço de outro tipo, o vínculo não será criado e um erro será retornado.
Importante:
- A quantidade máxima de registros enviados por requisição é 300.
- Caso aconteça algum erro, todos os envios serão cancelados e nenhum vínculo será criado, editado ou excluído.
Parâmetros de Envio (POST)
Esse endpoint requer um JSON com Lista de objetos no Body, em que cada objeto representa um vínculo de produto com tabela de preço.
| Campo | Tipo | Descrição |
|---|---|---|
| id (obrigatório) | Integer | ID do Vínculo do Produto com Tabela de Preço que será editado. Este deve ser o ID cadastrado no Mercos, e não o ID do seu Sistema. |
| preco (obrigatório) | Float | Preço do produto nesta tabela |
| tabela_id (obrigatório) | Integer | ID da Tabela de Preço. Este deve ser o ID cadastrado no Mercos, e não o ID do seu Sistema. Informar o valor 0 para alterar a tabela de preço padrão do produto |
| produto_id (obrigatório) | Integer | ID do Produto. Este deve ser o ID cadastrado no Mercos, e não o ID do seu Sistema. |
| divisao_id | Integer | Identificador da divisão dona do produto e da tabela de preço do vínculo. Disponível apenas nas contas de indústria com divisões. Opcional: quando não informado, o Mercos usa a divisão associada à integração |
Nas contas de indústria com divisões, itens do mesmo lote podem informar divisões diferentes: os vínculos
são processados na divisão de cada item, e a resposta (e os índices das mensagens de erro) preservam a ordem
de envio. O guia Indústrias com divisões explica o modelo completo.
Estrutura da resposta (POST)
Sucesso
Caso a requisição seja um sucesso a resposta retornará os IDs criados e editados, na mesma ordem que foram enviados, no body da requisição.
Erro
Caso a requisição encontre um ou mais erros, eles serão retornados informado campo e o tipo de erro, na mesma ordem que foram enviados, no body da requisição.