Agora no Bluesoft ERP, é possível realizar a atualização de preços de venda de forma assíncrona via API.

Esta nova funcionalidade permite o envio de lotes de produtos para processamento em background, garantindo maior estabilidade na integração com sistemas externos.

Como Era o Processo Antes?

Anteriormente, os integradores utilizavam exclusivamente o endpoint síncrono /api/vendas/precos , porem esta rota permitia apenas o envio de produto a produto de forma separada, gerando um grande volume de requisições em paralelo.

Como Irá Funcionar a Partir de Agora?

Com a implementação da API v2, o fluxo de integração passa a ser dividido em duas etapas: o envio do lote e a consulta do status de processamento.

1. Envio do Lote (Criação da Requisição) Através do novo endpoint POST /api/v2/vendas/precos, o integrador envia um array de objetos contendo as atualizações de preço por loja ou por região.

  • Limite de quantidades: Cada requisição está limitada a no máximo 100 produtos.
  • Retorno Imediato: Ao receber o lote válido, a API retorna imediatamente um requestId único e o status 200 OK.

Exemplo de JSON:

{
    "data": [
        {
            "produtoKey": 61,
            "dataInicialAVigorar": "09/04/2026",
            "aplicarPrecoParaCaixa": true,
            "lojas": [
                {
                    "lojaKey": 900,
                    "precoVenda": 5.99
                }
            ],
            "regioes": []
        },
        {
            "produtoKey": 62,
            "dataInicialAVigorar": "09/04/2026",
            "aplicarPrecoParaCaixa": false,
            "lojas": [
                {
                    "lojaKey": 1,
                    "precoVenda": 2.97
                }
            ],
            "regioes": []
        }        
    ]
}

Exemplo de JSON:

{
    "data": [
        {
            "produtoKey": 64,
            "dataInicialAVigorar": "10/04/2026",
            "aplicarPrecoParaCaixa": true,
            "lojas": [],
            "regioes": [
                {
                    "regiaoKey": 1,
                    "precoVenda": 5.97
                }
            ]
        },
        {
            "produtoKey": 82,
            "dataInicialAVigorar": "11/04/2026",
            "aplicarPrecoParaCaixa": false,
            "lojas": [],
            "regioes": [
                {
                    "regiaoKey": 1,
                    "precoVenda": 2.97
                }
            ]
        }
    ]
}

2. Consulta do Status

Utilizando o requestId gerado, o integrador pode consultar o andamento do processamento através do endpoint:

GET /api/v2/vendas/precos/consultar-lote/{requestId}.

O retorno desta consulta detalhará o progresso e o resultado final:

  • Status Possíveis: RUNNING (em processamento), DONE (concluído com sucesso), CONCLUIDO_COM_ERROS ou FAILED.
  • Detalhamento de Erros: Caso ocorram falhas em itens específicos (ex: produto inexistente), o processamento dos demais itens válidos continua normalmente, e o array erros listará os problemas encontrados.

Observações Importantes!

  • Priorização Interna:
    O processamento interno do ERP (como a geração de resumos de preços) sempre terá prioridade sobre a fila de atualizações da API.
  • Permissões de Acesso:
    * Para o envio (POST): É necessário possuir as permissões:
    3149 (Alterar).
    3150 (Incluir).
    * Para a consulta (GET): É necessário possuir a nova permissão
    4047 (Consultar).
  • Retrocompatibilidade:
    O endpoint síncrono atual (/api/vendas/precos) continuará funcionando sem alterações para clientes que não desejarem migrar para o modelo assíncrono.

Para conhecer mais sobre como é a utilização dessa ferramenta, Clique aqui.

Para saber mais sobre a utilização das APIs do ERP, clique aqui.

Disponível a partir da versão r368.01