Changelog
Back to All
Added

Novo campo "EAN" no payload da API de Alíquotas

2 days ago by Angela Santos

A partir de agora, o campo de código de barras (EAN) dos produtos passa a ser trafegado nativamente nas requisições, eliminando processos redundantes de consulta.

Implementamos esta melhoria focada em performance e eficiência operacional na nossa API de Alíquotas para facilitar cenários de uso com integrações parceiras, como por exemplo o Programas de Benefício em Medicamentos (PBM).

Como era antes:

Anteriormente, a API de Alíquotas trafegava apenas o Sku e o ProdutoVarianteId. Isso obrigava os sistemas integrados a realizarem consultas extras em outros endpoints de catálogo para conseguir correlacionar o produto ao seu respectivo código de barras (EAN). Esse fluxo gerava chamadas em cascata, criando gargalos no momento do checkout e aumentando desnecessariamente o consumo geral de APIs.

O que mudou?

Incluímos o campo EAN diretamente dentro do objeto de produtos no payload da API de cadastro de Alíquotas.

  • Endpoint atualizado: POST/aliquotas (mapeamento de cálculo de impostos).

  • Novo campo disponível: No array de Produtos, agora é possível receber o atributo "EAN": "string".

Com essa mudança, a informação do identificador universal (GTIN) flui de forma nativa e integrada, permitindo que regras de impostos e benefícios baseados em laboratórios ou indústrias farmacêuticas, por exemplo, sejam validadas instantaneamente.

Benefícios e Ganhos

  • Performance no Checkout: Redução drástica na latência final da compra, eliminando a necessidade de buscas paralelas para correlacionar produtos e códigos de barras.

  • Facilitação de Parcerias: Viabiliza a integração nativa e homologada com programas de descontos que utilizam obrigatoriamente o EAN como chave principal de validação, como por exemplo o Programa de Benefícios em Medicamentos da indústria farmacêutica.

  • Eficiência na Integração: Otimização do uso do barramento de APIs da loja, reduzindo o volume de requisições desnecessárias ao catálogo de produtos.

  • Confiabilidade da Operação: Garante que os descontos, regras fiscais ou benefícios de cashback sejam aplicados em tempo real, mitigando riscos de inconsistência por ausência de dados.